pi-better-harness 0.10.0 → 0.12.0

package/node_modules/pi-better-subagents/README.md

@@ -43,6 +43,16 @@ uses `agents_catalog` to discover current role descriptions and delegates every
 nontrivial role-owned task, while the foreground coordinates, integrates, and
 verifies. See [usage notes](docs/usage.md#delegation-mode).
 
+`agents_catalog` shows each role's and named agent's default model and effort,
+such as `role developer "Developer" … default openai/gpt-6-sol@high`. Roles are
+listed and passed by short name (`role: "developer"`); the stored id
+`role.developer` also works, and named agents keep their full id
+(`agent: "agent.payments"`). To launch on that default, omit
+`model` and `thinking` on a role or agent spawn; name one only for a stated
+reason. When a launch's model or effort differs from the default, its launch
+line says so, for example
+`model openai/gpt-6-astra@high (role developer default openai/gpt-6-sol@high)`.
+
 ## When To Use
 
 Use this package for independent coding, review, research, or verification work that can finish later. Do not use it for steps that need immediate foreground interaction or user clarification.

package/node_modules/pi-better-subagents/agent-commands.ts

@@ -15,7 +15,9 @@ import {
     CATALOG_SCHEMA_VERSION,
     DiagnosticCodes,
     EFFORT_LEVELS,
+    canonicalRoleId,
     parseDefinition,
+    shortRoleName,
     type AgentDefinition,
     type Diagnostic,
     type InstructionMode,
@@ -52,9 +54,9 @@ const KNOWN_FLAGS = new Set(["role", "scope", "name", "id", "mode", "description
 const USAGE = [
     "/agents list",
     "/agents show <id>    (inspect is the same command)",
-    "/agents create [--role <role-id>] [--name <name>] [--scope user|project] [--mode add|replace] [--instructions <text>] [--model <provider/model>] [--effort <level>] [--tier <label>]",
+    "/agents create [--role <role>] [--name <name>] [--scope user|project] [--mode add|replace] [--instructions <text>] [--model <provider/model>] [--effort <level>] [--tier <label>]",
     "/agents reload",
-    "/agents import-codex <file.toml> [--scope user|project] [--role <role-id>]",
+    "/agents import-codex <file.toml> [--scope user|project] [--role <role>]",
     "Create and import write to the personal catalog unless --scope project is set.",
     "Import confirms one base role and replace mode. It does not scan .codex/agents.",
 ].join("\n");
@@ -263,14 +265,14 @@ async function runCreate(
     deps: AgentCommandDeps,
 ): Promise<AgentCommandResult> {
     if (parsed.positionals.length > 1) {
-        return result("error", "create", false, "create takes flags, not a bare role name. Use --role <role-id>. Nothing was written.");
+        return result("error", "create", false, "create takes flags, not a bare role name. Use --role <role>. Nothing was written.");
     }
     const scope = readScope(parsed.flags);
     if (scope.error) return result("error", "create", false, `${scope.error} Nothing was written.`);
     if (scope.value === "project" && !loc.projectTrusted) return untrusted("create");
     const snapshot = readCatalog(loc);
     const roles = catalogRoles(snapshot);
-    let roleIds = [...(parsed.flags.get("role") ?? [])];
+    let roleIds = (parsed.flags.get("role") ?? []).map(canonicalRoleId);
     if (roleIds.length > 1) {
         const decision = await resolveRoleAssignment(roleIds.map((roleId) => ({ roleId })), {
             hasUI: host.hasUI,
@@ -284,7 +286,7 @@ async function runCreate(
     let roleId = roleIds[0];
     if (!roleId) {
         if (!host.hasUI) {
-            return clarification("create", `create needs --role <role-id>. UI is unavailable, so no role was chosen. Roles: ${roles.map((role) => role.id).join(", ") || "none"}. Nothing was written.`);
+            return clarification("create", `create needs --role <role>. UI is unavailable, so no role was chosen. Roles: ${roles.map((role) => shortRoleName(role.id)).join(", ") || "none"}. Nothing was written.`);
         }
         if (roles.length === 0) return result("error", "create", false, "No roles are available to use as a base. Nothing was written.");
         const selected = await host.ui.select("Choose one base role", roles.map(roleOption));
@@ -292,7 +294,7 @@ async function runCreate(
         roleId = selected.split(" ")[0];
     }
     if (!roleId || !roles.some((role) => role.id === roleId)) {
-        return result("error", "create", false, `Unknown role ${roleId ?? ""}. Nothing was written. Use /agents list and pass one role id.`);
+        return result("error", "create", false, `Unknown role ${shortRoleName(roleId ?? "")}. Valid roles: ${roles.map((role) => shortRoleName(role.id)).join(", ") || "none"}. Nothing was written.`);
     }
     let name = parsed.flags.get("name")?.[0];
     if (!name?.trim()) {
@@ -407,7 +409,7 @@ async function runImport(
     const roles = catalogRoles(snapshot);
     if (roles.length === 0) return result("error", "import-codex", false, "No roles are available to use as the one base role. Nothing was imported.");
     const suggestion = suggestBaseRoles(`${document.name}\n${document.description}\n${document.developerInstructions}`, roles);
-    const requestedRoles = [...(parsed.flags.get("role") ?? [])];
+    const requestedRoles = (parsed.flags.get("role") ?? []).map(canonicalRoleId);
     if (requestedRoles.length > 1) {
         const decision = await resolveRoleAssignment(requestedRoles.map((roleId) => ({ roleId })), {
             hasUI: host.hasUI,
@@ -420,7 +422,7 @@ async function runImport(
     }
     let roleId = requestedRoles[0];
     if (roleId && !roles.some((role) => role.id === roleId)) {
-        return result("error", "import-codex", false, `Unknown role ${roleId}. Nothing was imported.`);
+        return result("error", "import-codex", false, `Unknown role ${shortRoleName(roleId)}. Valid roles: ${roles.map((role) => shortRoleName(role.id)).join(", ")}. Nothing was imported.`);
     }
     const sourceRef = codexSourceRef(resolved);
     const existingLookup = matchExisting(listScopeAgents(loc, scope.value).agents, document.proposedId, sourceRef);

package/node_modules/pi-better-subagents/agent-inspection.ts

@@ -8,7 +8,7 @@
  * and a catalog block stays not launchable even if enrichment disagrees.
  */
 import { inspectCatalog, listCatalog, type CatalogInspection } from "./catalog-resolver.ts";
-import { formatDiagnostic, type Diagnostic } from "./catalog-schema.ts";
+import { formatDiagnostic, shortRoleName, type Diagnostic } from "./catalog-schema.ts";
 import type { CatalogSnapshot } from "./catalog-store.ts";
 import { loadConfig, normalizeTools, SAFE_DEFAULT_TOOLS, type SubagentConfig } from "./config.ts";
 import { resolveExtensions } from "./extensions.ts";
@@ -80,6 +80,23 @@ export interface OperationField {
     inherited: boolean;
 }
 
+export interface DefinitionDefaults {
+    model: string | null;
+    effort: string | null;
+    /** Compact `model@effort` form, as shown in the catalog list and launch notes. */
+    label: string;
+}
+
+/** `model@effort`, `model`, or `effort <level>` when only an effort is set. Undefined when neither is set. */
+export function formatModelEffort(model: string | null | undefined, effort: string | null | undefined): string | undefined {
+    const m = typeof model === "string" && model.trim() !== "" ? model : undefined;
+    const e = typeof effort === "string" && effort.trim() !== "" ? effort : undefined;
+    if (m && e) return `${m}@${e}`;
+    if (m) return m;
+    if (e) return `effort ${e}`;
+    return undefined;
+}
+
 export interface OperationCapabilities {
     grantedByCatalog: false;
     sameAsLegacySpawn: true;
@@ -113,6 +130,8 @@ export interface OperationView {
     instructionMode?: string;
     instructions?: string;
     fields?: { model: OperationField; effort: OperationField; tier: OperationField };
+    /** The definition's own default model and effort (role default, or the agent's override or inherited value). Null when neither is set. */
+    defaults: DefinitionDefaults | null;
     requestedModel: string | null;
     requestedEffort: string | null;
     actualModel: string | null;
@@ -208,7 +227,7 @@ export function presentCatalog(snapshot: CatalogSnapshot, enrich?: LaunchEnriche
         "Definition validity is not launchability. Model availability is decided only by the injected resolver.",
         ...snapshot.diagnostics.map((diagnostic) => formatDiagnostic(diagnostic)),
         ...entries.flatMap((entry) => [
-            entry.text.split("\n")[0] ?? entry.id,
+            renderCatalogListLine(entry),
             `  description: ${JSON.stringify(entry.identity.description ?? "")}`,
         ]),
     ];
@@ -311,6 +330,7 @@ export function presentCatalogEntry(snapshot: CatalogSnapshot, id: string, enric
         instructionMode: inspection.instructionMode,
         instructions: inspection.instructions,
         fields,
+        defaults: definitionDefaults(fields),
         requestedModel: enrichment?.requestedModel ?? fields?.model.value ?? null,
         requestedEffort: enrichment?.requestedEffort ?? (fields?.effort.value ?? null),
         actualModel: enrichment?.actualModel ?? null,
@@ -341,16 +361,30 @@ export function presentCatalogEntry(snapshot: CatalogSnapshot, id: string, enric
     return view;
 }
 
-export function renderOperationView(view: OperationView): string {
-    const header = [
+function renderHeader(view: OperationView, shownId: string): string {
+    return [
         view.identity.kind ?? "missing",
-        view.id,
+        shownId,
         view.identity.name ? JSON.stringify(view.identity.name) : "unnamed",
         `scope=${view.identity.scope ?? "none"}`,
         `definitionValid=${yesNo(view.definitionValid)}`,
         `catalogLaunchable=${yesNo(view.catalogLaunchable)}`,
         `launchable=${view.launchable === null ? "unknown" : yesNo(view.launchable)}`,
+        ...(view.defaults ? [`default ${view.defaults.label}`] : []),
     ].join(" ");
+}
+
+/**
+ * One `agents_catalog` list line. A role shows its short name (`role developer
+ * "Developer" …`), which is what the `role` field accepts; a named agent keeps
+ * its full id. Inspect output and structured details keep the full id.
+ */
+export function renderCatalogListLine(view: OperationView): string {
+    return renderHeader(view, view.identity.kind === "role" ? shortRoleName(view.id) : view.id);
+}
+
+export function renderOperationView(view: OperationView): string {
+    const header = renderHeader(view, view.id);
     const lines = [
         header,
         `identity: id=${view.id} kind=${view.identity.kind ?? "unknown"} name=${JSON.stringify(view.identity.name ?? "")} description=${JSON.stringify(view.identity.description ?? "")}`,
@@ -397,6 +431,13 @@ export function renderOperationView(view: OperationView): string {
     return lines.join("\n");
 }
 
+function definitionDefaults(fields: OperationView["fields"]): DefinitionDefaults | null {
+    const model = fields?.model.value ?? null;
+    const effort = fields?.effort.value ?? null;
+    const label = formatModelEffort(model, effort);
+    return label ? { model, effort, label } : null;
+}
+
 function field(value: { value: string | null; source: OperationField["source"]; explicit: boolean }): OperationField {
     return {
         value: value.value,

package/node_modules/pi-better-subagents/agents-catalog-tool.ts

@@ -4,6 +4,7 @@
  * collected. This module does not write files.
  */
 import { presentCatalog, presentCatalogEntry, type LaunchEnricher } from "./agent-inspection.ts";
+import { canonicalCatalogId } from "./catalog-schema.ts";
 import { defaultUserRoot, loadCatalog } from "./catalog-store.ts";
 
 type TypeModule = {
@@ -37,19 +38,21 @@ export function agentsCatalogTool(Type: TypeModule, deps: DiscoveryDeps = {}) {
     return {
         name: "agents_catalog" as const,
         label: "Agents catalog",
-        description: "List or inspect role and named-agent definitions, including inheritance, diagnostics, restrictions, and whether launchability is actually known. This tool does not create, import, or edit definitions.",
+        description: "List or inspect role and named-agent definitions, including inheritance, default model and effort, diagnostics, restrictions, and whether launchability is actually known. This tool does not create, import, or edit definitions.",
         promptSnippet: "List and inspect catalog roles and named agents, including inheritance and whether launchability is known.",
         promptGuidelines: [
             "Use agents_catalog to discover roles and named agents before subagent_spawn. It is read-only.",
+            "Roles are listed by short name. Pass that name as role (role: \"developer\"). Pass a named agent by its full id (agent: \"agent.payments\").",
             "Do not treat a valid definition as launchable. definitionValid and catalogLaunchable do not select a model or start a child.",
             "A role name or instruction that says read-only is not enforcement. Unsupported execution restrictions stay blocking.",
             "Ask the user to run /agents create or /agents import-codex for writes. Those commands confirm role, scope, and import replacement.",
             "Launch with the existing subagent_spawn or batch tool. Pass one agent or one role, not both. Two roles for one run need the user to choose one or split the work.",
             "Put an authoritative model or effort on the structured invocation. Do not rely on copying a model name into the child prompt. Explicit invocation and workflow choices override definition defaults.",
+            "Each entry shows its default model@effort when set. Omit model and thinking on the spawn to use it; name one only for a stated reason.",
         ],
         parameters: Type.Object({
             action: Type.String({ description: "list or inspect. No other action is accepted." }),
-            id: Type.Optional(Type.String({ description: "Role or agent id for inspect. Display names and filenames are not ids." })),
+            id: Type.Optional(Type.String({ description: "What to inspect: a role's short name (developer) or a named agent's id (agent.payments). The prefixed role id (role.developer) also works. Display names and filenames are not ids." })),
         }),
         async execute(
             _toolCallId: string,
@@ -71,8 +74,8 @@ export function agentsCatalogTool(Type: TypeModule, deps: DiscoveryDeps = {}) {
                     details: { action, wrote: false, revision: listed.revision, entries: listed.entries, diagnostics: listed.diagnostics },
                 };
             }
-            if (!params.id?.trim()) return toolError("inspect needs an id. Call agents_catalog with action list to see ids. Nothing was written.");
-            const view = presentCatalogEntry(loadCatalog(host), params.id.trim(), deps.enrich);
+            if (!params.id?.trim()) return toolError("inspect needs a role name or agent id. Call agents_catalog with action list to see them. Nothing was written.");
+            const view = presentCatalogEntry(loadCatalog(host), canonicalCatalogId(params.id), deps.enrich);
             return {
                 content: [{ type: "text" as const, text: view.text }],
                 details: { action, wrote: false, view },

package/node_modules/pi-better-subagents/batch.mjs

@@ -215,8 +215,8 @@ export function formatBatchLaunchResponse({ batchId, batchName, launched, skippe
         lines.push(
             `Batch ${label} launched ${launched.length} subagent(s):`,
         );
-        for (const { name, id } of launched) {
-            lines.push(`• ${name} → ${id}`);
+        for (const { name, id, modelNote } of launched) {
+            lines.push(`• ${name} → ${id}${modelNote ? ` · ${modelNote}` : ""}`);
         }
     }
 

package/node_modules/pi-better-subagents/catalog-resolver.ts

@@ -8,6 +8,7 @@
 import {
     DiagnosticCodes,
     hasBlockingDiagnostic,
+    shortRoleName,
     type CatalogDefinition,
     type CatalogKind,
     type Diagnostic,
@@ -161,9 +162,12 @@ export function listCatalog(snapshot: CatalogSnapshot): CatalogListEntry[] {
 export function inspectCatalog(snapshot: CatalogSnapshot, id: string): CatalogInspection {
     const entry = findEntry(snapshot, id);
     if (!entry) {
+        const isAgent = id.trim().toLowerCase().startsWith("agent.");
         const diagnostic = blockedDiagnostic(
-            id.startsWith("agent.") ? DiagnosticCodes.unknownAgent : DiagnosticCodes.unknownRole,
-            `No catalog definition has id ${id}. Check the id, or reload after adding the file. Display names and filenames are not ids.`,
+            isAgent ? DiagnosticCodes.unknownAgent : DiagnosticCodes.unknownRole,
+            isAgent
+                ? `No catalog definition has id ${id}. Check the id, or reload after adding the file. Display names and filenames are not ids.`
+                : `No role named ${shortRoleName(id)}. ${validRolesSentence(snapshot)} Check the name, or reload after adding the file. Display names and filenames are not ids.`,
             id,
         );
         return {
@@ -212,7 +216,7 @@ function resolveRole(snapshot: CatalogSnapshot, roleId: string): Resolution {
         return {
             status: "not-found",
             launchable: false,
-            diagnostics: [blockedDiagnostic(DiagnosticCodes.unknownRole, `Unknown role ${roleId}. It was not launched.`, roleId)],
+            diagnostics: [blockedDiagnostic(DiagnosticCodes.unknownRole, `Unknown role ${shortRoleName(roleId)}. ${validRolesSentence(snapshot)} It was not launched.`, roleId)],
         };
     }
     if (entry.duplicate || !entry.definition || entry.definition.kind !== "role") {
@@ -393,6 +397,16 @@ function absentField<T>(): FieldValue<T> {
     return { value: null, source: "absent", explicit: false };
 }
 
+/** Valid short role names, for an unknown-role message. */
+function validRoleNames(snapshot: CatalogSnapshot): string[] {
+    return [...snapshot.roles.keys()].map(shortRoleName).sort();
+}
+
+function validRolesSentence(snapshot: CatalogSnapshot): string {
+    const names = validRoleNames(snapshot);
+    return names.length > 0 ? `Valid roles: ${names.join(", ")}.` : "No roles are defined.";
+}
+
 function findEntry(snapshot: CatalogSnapshot, id: string): CatalogEntry | undefined {
     return snapshot.roles.get(id) ?? snapshot.agents.get(id) ?? snapshot.blocked.find((entry) => entry.id === id);
 }

package/node_modules/pi-better-subagents/catalog-runtime.ts

@@ -4,7 +4,7 @@
  * `spawnSubagentRun`. This module does not grant tools, sandbox modes, or
  * extensions, and it does not read task prose for model choices.
  */
-import { describeDefaultLaunchCapabilities, LEGACY_CAPABILITY_CONTROLS, type LaunchEnricher, type LaunchEnrichment } from "./agent-inspection.ts";
+import { describeDefaultLaunchCapabilities, formatModelEffort, LEGACY_CAPABILITY_CONTROLS, type LaunchEnricher, type LaunchEnrichment } from "./agent-inspection.ts";
 import { resolveSelection, type EffectiveDefinition } from "./catalog-resolver.ts";
 import { defaultUserRoot, loadCatalog, type CatalogSnapshot } from "./catalog-store.ts";
 import { loadConfig, type SubagentConfig } from "./config.ts";
@@ -22,7 +22,7 @@ import {
 import { allocateCatalogLabel } from "./catalog-identity.ts";
 import { resolveRoleAssignment, type RoleAssignment } from "./role-assignment.ts";
 import { configureTierPolicy, DEFAULT_TIER_POLICY, type TierPolicy, type TierSpec } from "./tier-policy.ts";
-import type { Diagnostic, ThinkingLevel } from "./catalog-schema.ts";
+import { canonicalAgentId, canonicalRoleId, shortRoleName, type Diagnostic, type ThinkingLevel } from "./catalog-schema.ts";
 
 export interface CatalogHost {
     cwd: string;
@@ -252,6 +252,59 @@ export async function clarifyCatalogRequest(
     return { status: "resolved", jobs: ordered.map(stripBookkeeping) };
 }
 
+/**
+ * Launch-line note for a catalog run whose effective model or effort differs
+ * from the role or agent default. The wording names the cause, so a fallback
+ * or a capped effort is not mistaken for a caller override:
+ * - override: `model openai/gpt-6-astra@high (role developer default openai/gpt-6-sol@high)`
+ * - fallback: `model xai/grok-4.7@high (role developer default openai/gpt-6-sol@high unavailable; foreground fallback)`
+ * - capped effort: `model openai/gpt-6-sol@medium (role developer default openai/gpt-6-sol@high; effort capped at medium by the model)`
+ * Undefined for a non-catalog run, a definition with no default, or a launch
+ * that matches the default. Only the fields the definition sets are compared.
+ */
+export function catalogDefaultNote(
+    record: Pick<CatalogRunRecord, "kind" | "effective" | "modelSelection" | "effortSelection"> & { id?: string } | undefined,
+    model: string | undefined,
+    thinking: string | undefined,
+): string | undefined {
+    if (!record) return undefined;
+    const defaultModel = record.effective.model.value;
+    const defaultEffort = record.effective.effort.value;
+    const defaultLabel = formatModelEffort(defaultModel, defaultEffort);
+    if (!defaultLabel) return undefined;
+    const modelSource = record.modelSelection?.source;
+    const modelFallback = defaultModel !== null && modelSource !== undefined && FALLBACK_SOURCES.has(modelSource);
+    const modelDiffers = defaultModel !== null && (modelFallback || !sameModel(defaultModel, model, modelSource));
+    const effortCapped = defaultEffort !== null && record.effortSelection?.adjusted === true && (thinking ?? null) !== defaultEffort;
+    const effortDiffers = defaultEffort !== null && (thinking ?? null) !== defaultEffort;
+    if (!modelDiffers && !effortDiffers) return undefined;
+    const actual = formatModelEffort(model ?? "Pi default", thinking) ?? "Pi default";
+    // A role run names its short role (`role developer default …`); an agent run keeps `agent default …`.
+    const owner = record.kind === "role" && record.id ? `role ${shortRoleName(record.id)}` : record.kind;
+    const causes = [
+        modelFallback ? `${owner} default ${defaultLabel} unavailable; ${FALLBACK_LABELS[modelSource!] ?? modelSource} fallback` : `${owner} default ${defaultLabel}`,
+        ...(effortCapped ? [`effort capped at ${thinking ?? "the model default"} by the model`] : []),
+    ];
+    return `model ${actual} (${causes.join("; ")})`;
+}
+
+/** Model sources that mean the default could not be used, not that the caller chose another model. */
+const FALLBACK_SOURCES: ReadonlySet<string> = new Set(["tier-candidate", "foreground", "configured-default"]);
+const FALLBACK_LABELS: Record<string, string> = {
+    "tier-candidate": "same-tier",
+    foreground: "foreground",
+    "configured-default": "configured-default",
+};
+
+function sameModel(defaultModel: string, actual: string | undefined, source: string | undefined): boolean {
+    // The resolver launched the definition's own preference: same model, however it was spelled.
+    if (source === "role-default" || source === "agent-override") return true;
+    if (actual === undefined) return false;
+    if (defaultModel === actual) return true;
+    // A providerless default names the id; the resolved provider/id (the id may itself contain "/") still matches.
+    return !defaultModel.includes("/") ? actual.endsWith(`/${defaultModel}`) : false;
+}
+
 export async function prepareCatalogJob(snapshot: CatalogSnapshot, job: CatalogJobFields, host: CatalogHost): Promise<PreparedCatalogJob> {
     const agent = agentIdOf(job);
     const roles = roleIdsOf(job);
@@ -496,8 +549,7 @@ async function allocateDirectRoleLabel(input: { roleId: string; roleName: string
 }
 
 export function roleSlug(roleId: string): string {
-    const raw = roleId.startsWith("role.") ? roleId.slice("role.".length) : roleId;
-    return raw.trim().toLowerCase();
+    return shortRoleName(roleId).trim().toLowerCase();
 }
 
 function composePrompt(instructions: string, task: string): string {
@@ -507,7 +559,28 @@ function composePrompt(instructions: string, task: string): string {
 }
 
 function agentIdOf(job: { agent?: unknown }): string | undefined {
-    return typeof job.agent === "string" && job.agent.trim() !== "" ? job.agent.trim() : undefined;
+    return typeof job.agent === "string" && job.agent.trim() !== "" ? canonicalAgentId(job.agent) : undefined;
+}
+
+/**
+ * Error text for a selector that is present but blank (`role: "  "`,
+ * `agent: ""`, or an empty or blank role array). Absent or null means no
+ * selector and returns undefined. `where` names the field's owner, such as
+ * `shared` or `jobs[1]`.
+ */
+export function blankCatalogSelector(input: { agent?: unknown; role?: unknown } | undefined, where?: string): string | undefined {
+    if (!input) return undefined;
+    const field = (name: string) => (where ? `${where}.${name}` : name);
+    const blank = (value: unknown) => typeof value !== "string" || value.trim() === "";
+    if (input.agent !== undefined && input.agent !== null && blank(input.agent)) {
+        return `${field("agent")} is blank. Pass a named agent id such as agent.payments, or omit agent. No child was started.`;
+    }
+    const role = input.role;
+    if (role === undefined || role === null) return undefined;
+    if (Array.isArray(role) ? role.length === 0 || role.some(blank) : blank(role)) {
+        return `${field("role")} is blank. Pass a role name such as developer, or omit role. No child was started.`;
+    }
+    return undefined;
 }
 
 function roleIdsOf(job: { role?: unknown; roleIds?: unknown }): string[] {
@@ -518,8 +591,11 @@ function roleIdsOf(job: { role?: unknown; roleIds?: unknown }): string[] {
     const ids: string[] = [];
     for (const value of values) {
         if (typeof value !== "string") continue;
-        const trimmed = value.trim();
-        if (trimmed && !ids.includes(trimmed)) ids.push(trimmed);
+        // A bare name (`developer`) and the prefixed id (`role.developer`) are
+        // the same role. The canonical id always starts with `role.`, so a
+        // role field never reaches an `agent.*` named agent.
+        const id = canonicalRoleId(value);
+        if (id && !ids.includes(id)) ids.push(id);
     }
     return ids;
 }

package/node_modules/pi-better-subagents/catalog-schema.ts

@@ -252,6 +252,40 @@ export function kindForId(id: string): CatalogKind | undefined {
     return undefined;
 }
 
+/** Prefix every role id carries. Stored ids and files keep it; people type and read the short name. */
+export const ROLE_ID_PREFIX = "role.";
+
+/** Short, user-facing role name: `role.developer` becomes `developer`. Any other id is returned unchanged. */
+export function shortRoleName(id: string): string {
+    return id.startsWith(ROLE_ID_PREFIX) ? id.slice(ROLE_ID_PREFIX.length) : id;
+}
+
+/**
+ * Canonical role id for a value typed into a `role` field. Trimmed and
+ * lowercased; a bare name gains the `role.` prefix, so `Developer` becomes
+ * `role.developer`. The result always starts with `role.`, so a role field
+ * can never select an `agent.*` named agent.
+ */
+export function canonicalRoleId(value: string): string {
+    const trimmed = value.trim().toLowerCase();
+    if (trimmed === "") return trimmed;
+    return trimmed.startsWith(ROLE_ID_PREFIX) ? trimmed : `${ROLE_ID_PREFIX}${trimmed}`;
+}
+
+/** Canonical named-agent id: trimmed and lowercased, since ids are lowercase-only. */
+export function canonicalAgentId(value: string): string {
+    return value.trim().toLowerCase();
+}
+
+/**
+ * Canonical id for a field that takes either kind, such as `agents_catalog`
+ * inspect. An `agent.` id (any case) is lowercased; anything else is read as a role.
+ */
+export function canonicalCatalogId(value: string): string {
+    const lowered = value.trim().toLowerCase();
+    return lowered.startsWith("agent.") ? lowered : canonicalRoleId(lowered);
+}
+
 export function isPreferenceKey(value: string): value is PreferenceKey {
     return (PREFERENCE_KEYS as readonly string[]).includes(value);
 }

package/node_modules/pi-better-subagents/delegation.ts

@@ -15,7 +15,7 @@ export function delegationPrompt(mode: DelegationMode): string {
         case "manual":
             return "Delegation mode: manual. Do not proactively delegate work. Use subagents only when the user explicitly asks for delegation or an active workflow explicitly requires it. A structured plan or plan mode does not override this restriction; perform planned work in the foreground unless explicitly required otherwise.";
         case "coordinator":
-            return "Delegation mode: coordinator. The foreground coordinates, integrates, and verifies. Call agents_catalog to discover current available roles and inspect their descriptions. Delegate every nontrivial task covered by an available role according to its current description; do not assume bundled roles are unchanged. Keep orchestration, cross-role decisions, unowned or ambiguous work, integration, and final verification in the foreground. Inspect results and failures before concluding; do not poll for running children.";
+            return "Delegation mode: coordinator. The foreground coordinates, integrates, and verifies. Call agents_catalog to discover current available roles and inspect their descriptions. Pass a role to subagent_spawn by its short name, as listed (role: \"developer\"). Delegate every nontrivial task covered by an available role according to its current description; do not assume bundled roles are unchanged. Keep orchestration, cross-role decisions, unowned or ambiguous work, integration, and final verification in the foreground. Inspect results and failures before concluding; do not poll for running children.";
         case "adaptive":
             return "Delegation mode: adaptive. Delegate bounded, substantial independent work when a suitable subagent is available and useful; continue unblocked foreground work. Keep small, tightly coupled, or interactive work in the foreground. Inspect and integrate delegated results before final verification; do not poll.";
     }

package/node_modules/pi-better-subagents/docs/agent-catalog-lifecycle.md

@@ -6,6 +6,8 @@ Catalog launches use the existing `spawnSubagentRun` path. There is no second sc
 
 `subagent_spawn`, batch `shared`, and each batch job accept optional `agent`, `role`, and `alias`.
 
+- `role` takes a role's short name (`role: "developer"`). It is trimmed and case-insensitive, and the stored id (`role.developer`) also works. A bare name only ever selects a role, never an `agent.*` named agent. An unknown name fails and lists the valid role names. `agent` ids are trimmed and lowercased the same way.
+- A `role` or `agent` that is present but blank (`role: "  "`) is rejected before any launch. Only an absent field means no selector.
 - A per-job `agent` or `role` replaces the shared selector pair. It does not combine `shared.agent` with `job.role`.
 - `model` and `thinking` still merge per field. Per-job wins.
 - One agent or one role is a normal launch. Both, or more than one role id, asks the UI to choose one or split into separate runs.
@@ -28,7 +30,7 @@ The first `meta.json` write stores the launched `model` and `effort` plus a JSON
 
 A named agent displays its defined name. A direct role asks `allocateCatalogLabel({ roleId, roleName, alias })` when that module is present. `roleName` is the slug (`developer`), not `role.developer`. The label is allocated in the local run registry. An explicit `alias` (or the legacy `name` when `alias` is omitted) is the alias; collisions are the allocator's numeric suffix. Batch-generated `job-N` labels are not aliases.
 
-Navigator rows keep the display name, model, and effort. Details include the run id and, for catalog runs, the role id.
+Navigator rows keep the display name, model, and effort. Details include the run id and, for catalog runs, the short role name (`developer`). The full `roleId` stays in `meta.json`.
 
 ## Tier candidates
 

package/node_modules/pi-better-subagents/docs/agent-catalog-operations.md

@@ -52,6 +52,8 @@ Codex applies the agent file's model and `model_reasoning_effort` ahead of the c
 
 `agents_catalog` accepts `list` and `inspect` only. It uses the same inspection view as `/agents show`. It has no write path. Launch remains `subagent_spawn` or the batch tool, with at most one `agent` or `role` selector. Those selectors are lifecycle's wiring, not this tool.
 
+A list line names a role by its short name (`role developer "Developer" …`), the form the `role` field takes; the inspect header, `identity.id`, and the structured `id` keep the stored id `role.developer`. Named agents show their full `agent.<slug>` id in both. Each list line and the inspect header end with the definition's default model and effort when one is set, such as `default openai/gpt-6-sol@high`: a role's own default, or a named agent's override or inherited role default. The structured view carries the same value as `defaults: { model, effort, label }`, or `null` when neither is set. A spawn that omits `model` and `thinking` uses it. When a catalog launch's model or effort differs from it, the launch line (and each batch job line) adds a note such as `model openai/gpt-6-astra@high (role developer default openai/gpt-6-sol@high)`; a named agent's note reads `agent default …`. Only the fields the definition sets are compared. The note names the cause: a fallback from an unavailable default reads `(role developer default openai/gpt-6-sol@high unavailable; foreground fallback)` (or `same-tier` / `configured-default`), and an effort the model cannot run adds `effort capped at <level> by the model`.
+
 ## Lifecycle attachment
 
 ```ts

package/node_modules/pi-better-subagents/docs/agent-catalog.md

@@ -50,6 +50,8 @@ Look at payment edge cases before editing.
 | `name` | Display text. Changing it does not change `id`. |
 | Filename | Not an id. Discovery reads every `*.md` file in the scope directory, one level deep. |
 
+People type and read a role by its short name: `developer` is `role.developer`. The `role` field of `subagent_spawn` and `subagent_spawn_batch` and the `agents_catalog` inspect id accept it (trimmed, case-insensitive), and `agents_catalog` lists roles by it. The prefixed id is what files, `roleId`, and run metadata store, and it keeps working as input. Named agents keep their full `agent.<slug>` id everywhere.
+
 `kind` must match the id prefix. `roleIds`, `baseRoles`, `inherits`, and a list of roles are rejected. Agentier executable-role memberships are eligibility data, not extra inheritance parents, and are not accepted as additional `roleId`s.
 
 ## Portable preferences vs host controls
@@ -96,14 +98,14 @@ Model availability, same-tier fallback, and nearest-effort adjustment are not de
 
 ## Approved bundled roles
 
-| Id | Name | Model | Effort | Tier |
-| --- | --- | --- | --- | --- |
-| `role.researcher` | Researcher | `openai/gpt-6-sol` | medium | balanced |
-| `role.explorer` | Explorer | `openai/gpt-6-luna` | medium | efficient |
-| `role.product-manager` | Product Manager | `openai/gpt-6-sol` | medium | balanced |
-| `role.developer` | Developer | `openai/gpt-6-sol` | high | balanced |
-| `role.reviewer` | Reviewer | `openai/gpt-6-astra` | medium | frontier |
-| `role.architect` | Architect | `openai/gpt-6-astra` | high | frontier |
+| Role | Stored id | Name | Model | Effort | Tier |
+| --- | --- | --- | --- | --- | --- |
+| `researcher` | `role.researcher` | Researcher | `openai/gpt-6-sol` | medium | balanced |
+| `explorer` | `role.explorer` | Explorer | `openai/gpt-6-luna` | medium | efficient |
+| `product-manager` | `role.product-manager` | Product Manager | `openai/gpt-6-sol` | medium | balanced |
+| `developer` | `role.developer` | Developer | `openai/gpt-6-sol` | high | balanced |
+| `reviewer` | `role.reviewer` | Reviewer | `openai/gpt-6-astra` | medium | frontier |
+| `architect` | `role.architect` | Architect | `openai/gpt-6-astra` | high | frontier |
 
 Bundled descriptions are routing boundaries for coordinator mode. Researcher owns
 external and documentary evidence; Explorer maps repository code paths; Product

package/node_modules/pi-better-subagents/index.ts

@@ -147,10 +147,12 @@ import { createAgentOperations } from "./agent-operations.ts";
 import {
     clarifyCatalogRequest,
     createLaunchEnricher,
+    blankCatalogSelector,
     hasCatalogSelector,
     loadLaunchSnapshot,
     noteCatalogHost,
     prepareCatalogJob,
+    catalogDefaultNote,
     tiersForLaunch,
     type CatalogHost,
     type CatalogJobFields,
@@ -175,8 +177,9 @@ const projectConfigDirName = typeof (PiCodingAgent as { CONFIG_DIR_NAME?: unknow
     : ".pi";
 
 const CATALOG_GUIDELINES = [
+    "With an agent or role, omit model and thinking to launch on its default model and effort, which agents_catalog shows. Name a model or effort only for a stated reason, such as a task or workflow instruction, and never copy one from another role's runs.",
     "When a task, workflow, or skill instruction names a model or effort, translate that authoritative choice into the structured model and thinking arguments before spawning. The runtime does not parse prose, quoted model names, or comparisons, and copying a model into the child prompt does not change the launch.",
-    "Optional agent, role, and alias select a catalog definition. Pass one agent id or one role id. Pass an array of role ids when one run was given more than one role: that call asks to choose one or split, and without a UI choice it returns clarification-needed and starts no child. Naming both an agent and a role does the same. One job's choice does not change another job. A named agent displays its defined name. A direct role displays the label allocated from the local run registry. Calls without agent or role keep the existing name and model chain.",
+    "Optional agent, role, and alias select a catalog definition. Pass one named agent id (agent: \"agent.payments\") or one role by its short name (role: \"developer\"); the role.developer form also works. Pass an array of role names when one run was given more than one role: that call asks to choose one or split, and without a UI choice it returns clarification-needed and starts no child. Naming both an agent and a role does the same. One job's choice does not change another job. A named agent displays its defined name. A direct role displays the label allocated from the local run registry. Calls without agent or role keep the existing name and model chain.",
     "Catalog model and effort are resolved before the child starts. An unavailable explicit model or unsupported explicit effort does not launch and does not fall back. The catalog grants no tools, sandbox modes, extensions, or permissions.",
 ];
 
@@ -1423,8 +1426,8 @@ function timingSchemaFields() {
 
 /** String for one role, or an array when the caller assigns more than one. Arrays reach clarification instead of being rejected. */
 function catalogRoleSchema(purpose: string) {
-    const one = `One role id (role.<slug>) for this ${purpose}. Mutually exclusive with agent.`;
-    const many = `Two or more role ids for this ${purpose}. An array is ambiguous and asks to choose one role or split into separate runs. No child launches until that choice is made.`;
+    const one = `One role by short name (developer) for this ${purpose}; role.developer also works, case-insensitive. Mutually exclusive with agent.`;
+    const many = `Two or more role names for this ${purpose}. An array is ambiguous and asks to choose one role or split into separate runs. No child launches until that choice is made.`;
     return Type.Optional(Type.Union([
         Type.String({ description: one }),
         Type.Array(Type.String({ minLength: 1 }), { minItems: 1, description: many }),
@@ -1551,6 +1554,8 @@ export default function (pi: ExtensionAPI) {
         runtime: string;
         warn: string;
         sandboxDir?: string;
+        /** Set only when a catalog run's model or effort differs from its role or agent default. */
+        modelNote?: string;
     }> {
         assertThinkingLevel(p.thinking);
         const permissionPlan = resolveSubagentPermissions(pi, p.sandbox);
@@ -1766,7 +1771,8 @@ export default function (pi: ExtensionAPI) {
               `${resolution.unmapped.length > 1 ? "these tools" : "this tool"} will NOT exist in the child. ` +
               `Add a toolExtensions entry in config.json.\n`
             : "");
-        return { id, meta, spawned, runtime: runtime + (meta.timing ? `${formatTimingLimits(meta.timing, startedAt)}\n` : ""), warn, sandboxDir };
+        const modelNote = catalogDefaultNote(p.catalog, model, thinking);
+        return { id, meta, spawned, runtime: runtime + (meta.timing ? `${formatTimingLimits(meta.timing, startedAt)}\n` : ""), warn, sandboxDir, modelNote };
     }
 
     // ---- subagent_spawn -------------------------------------------------
@@ -1783,7 +1789,7 @@ export default function (pi: ExtensionAPI) {
             "After subagent_spawn, do NOT call subagent_output or subagent_result in a loop to wait for the result, and do NOT sleep. The run completes on its own and reports back on the next turn.",
             "Call subagent_result after a completion or attention callback, or when the user explicitly asks for the result. Use subagent_output only when the user explicitly asks how a run is progressing; never use either tool to poll.",
             ...SUBAGENT_ORCHESTRATION_GUIDELINES,
-            "The tools param is both the tool allowlist AND what determines which extensions load in the child (e.g. tools='read,bash,web_fetch' loads only the web-tools package). Ask for the tools the task needs and nothing more; clean:true gives a built-ins-only child. Pick a model with the model param (e.g. 'xai/grok-4.5@high'); providerless model patterns are resolved by Pi, while provider/model is deterministic and loads mapped provider extensions.",
+            "The tools param is both the tool allowlist AND what determines which extensions load in the child (e.g. tools='read,bash,web_fetch' loads only the web-tools package). Ask for the tools the task needs and nothing more; clean:true gives a built-ins-only child. Without an agent or role, pick a model with the model param (e.g. 'xai/grok-4.5@high'); providerless model patterns are resolved by Pi, while provider/model is deterministic and loads mapped provider extensions.",
             ...CATALOG_GUIDELINES,
             "By default the subagent is sandboxed. Human settings in /sandbox control file, credential-file, command, and network permissions; sandbox:false cannot override an enabled human profile. Without published settings, legacy write confinement applies. Set callback:false to finish quietly — then read the result on demand via subagent_result.",
             "Every run is timed by the harness: a soft deadline (default 30 min) steers the child to wrap up and wakes you once, the run is stopped after grace_minutes (reason deadline), a hard ceiling (default 90 min) stops it without grace (reason ceiling), and no progress for stuck_minutes (default 10) wakes you once (reason stuck). Set deadline_minutes/max_minutes/stuck_minutes to fit the task instead of writing a time limit into the prompt; do not stop a slow child that is still making progress.",
@@ -1795,8 +1801,8 @@ export default function (pi: ExtensionAPI) {
             agent: Type.Optional(Type.String({ description: "Named agent id (agent.<slug>). Mutually exclusive with role. The navigator shows the defined agent name." })),
             role: catalogRoleSchema("direct role launch"),
             alias: Type.Optional(Type.String({ description: "Per-run display alias for a direct role launch, such as checkout. Not a reusable agent. Colliding aliases gain a numeric suffix." })),
-            model: Type.Optional(Type.String({ description: "Pi model pattern, preferably provider/id, optionally suffixed with @effort (for example openai/gpt-5.5@high). Providerless patterns are resolved by Pi. Default: inherit foreground model. Put authoritative model choices here; do not rely on prompt text." })),
-            thinking: Type.Optional(Type.String({ description: "Reasoning effort for the child: off, minimal, low, medium, high, xhigh, or max (default: Pi/model default)." })),
+            model: Type.Optional(Type.String({ description: "Pi model pattern, preferably provider/id, optionally suffixed with @effort (for example openai/gpt-5.5@high). Providerless patterns are resolved by Pi. Omit to use the agent or role default; without one, inherit the foreground model. Put authoritative model choices here; do not rely on prompt text." })),
+            thinking: Type.Optional(Type.String({ description: "Reasoning effort for the child: off, minimal, low, medium, high, xhigh, or max. Omit to use the agent or role default; without one, the Pi/model default." })),
             tools: Type.Optional(Type.String({ description: "Tool allowlist: comma-separated names the child may use (e.g. 'read,bash,web_fetch'). This ALSO selects which extensions load — only packages backing a requested tool are loaded. Defaults to the configured safe set." })),
             exclude_tools: Type.Optional(Type.String({ description: "Comma-separated tool denylist, applied on top of the allowlist." })),
             clean: Type.Optional(Type.Boolean({ description: "Run a hermetic child with NO extensions at all (only built-ins: read, bash, edit, write). Default false — the extensions backing the requested tools load, so web_fetch and model auth (e.g. xai) work." })),
@@ -1813,6 +1819,9 @@ export default function (pi: ExtensionAPI) {
         async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
             const p = params as SpawnParams;
             if (p.prompt.trim() === "") throw new Error("prompt is empty.");
+            // A present-but-blank role or agent is a mistake, not a request for a catalog-free child.
+            const blankSelector = blankCatalogSelector(p);
+            if (blankSelector) throw new Error(blankSelector);
 
             const cfg = loadConfig();
             const maxConcurrent = cfg.maxConcurrent ?? DEFAULT_MAX_CONCURRENT;
@@ -1841,21 +1850,22 @@ export default function (pi: ExtensionAPI) {
                         throw new Error(`Choosing split needs ${catalog.jobs.length} subagent slots, but only one was free. Nothing was launched.`);
                     }
                     reserved += extra;
-                    const launched: { name?: string; id: string }[] = [];
+                    const launched: { name?: string; id: string; modelNote?: string }[] = [];
                     for (const job of catalog.jobs) {
-                        const { id } = await spawnSubagentRun(ctx, job);
+                        const { id, modelNote } = await spawnSubagentRun(ctx, job);
                         gate.commit(1);
                         reserved -= 1;
-                        launched.push({ name: job.name, id });
+                        launched.push({ name: job.name, id, modelNote });
                     }
-                    return text(launched.map((item) => `Subagent launched: ${item.name ? `${item.name} ` : ""}id=${item.id}.`).join("\n"));
+                    return text(launched.map((item) => `Subagent launched: ${item.name ? `${item.name} ` : ""}id=${item.id}.${item.modelNote ? ` ${item.modelNote}.` : ""}`).join("\n"));
                 }
                 Object.assign(p, catalog.jobs[0]);
-                const { id, spawned, runtime, warn, sandboxDir } = await spawnSubagentRun(ctx, p);
+                const { id, spawned, runtime, warn, sandboxDir, modelNote } = await spawnSubagentRun(ctx, p);
                 gate.commit(1);
                 reserved = 0;
                 return text(
                     `Subagent launched: ${p.name ? `${p.name} ` : ""}id=${id} (pid ${spawned.pid}).\n` +
+                    (modelNote ? `${modelNote[0]!.toUpperCase()}${modelNote.slice(1)}.\n` : "") +
                     (p.callback === false
                         ? `Running in the background; the foreground is free. It will finish quietly — read the result with subagent_result id=${id}.\n`
                         : `Running in the background; the foreground is free. Its result will be posted back here when it finishes.\n`) +
@@ -1898,7 +1908,7 @@ export default function (pi: ExtensionAPI) {
                 agent: Type.Optional(Type.String({ description: "Named agent id applied to jobs that do not select their own agent or role." })),
                 role: catalogRoleSchema("shared role selector"),
                 alias: Type.Optional(Type.String({ description: "Direct-role alias applied when a job does not set alias." })),
-                model: Type.Optional(Type.String({ description: "Pi model pattern, preferably provider/id, optionally suffixed with @effort (default: inherit foreground model). Put authoritative model choices here; prompt text is not parsed." })),
+                model: Type.Optional(Type.String({ description: "Pi model pattern, preferably provider/id, optionally suffixed with @effort. Omit to use the agent or role default; without one, inherit the foreground model. Put authoritative model choices here; prompt text is not parsed." })),
                 thinking: Type.Optional(Type.String({ description: "Reasoning effort applied to every job: off, minimal, low, medium, high, xhigh, or max." })),
                 tools: Type.Optional(Type.String({ description: "Tool allowlist applied to every job." })),
                 exclude_tools: Type.Optional(Type.String({ description: "Comma-separated tool denylist applied to every job." })),
@@ -1956,6 +1966,10 @@ export default function (pi: ExtensionAPI) {
             const gate = getSharedCapacityGate(countRunning);
 
             validateBatchPlan({ shared: p.shared, jobs: p.jobs, onCapacity: p.onCapacity, config: cfg });
+            // A present-but-blank role or agent rejects the whole batch before any launch.
+            const blankSelector = blankCatalogSelector(p.shared, "shared")
+                ?? p.jobs.map((job, index) => blankCatalogSelector(job, `jobs[${index}]`)).find(Boolean);
+            if (blankSelector) throw new Error(blankSelector);
 
             let catalogSnapshot: CatalogSnapshot | undefined;
             let catalogHost: CatalogHost | undefined;
@@ -1997,7 +2011,7 @@ export default function (pi: ExtensionAPI) {
 
             const names = assignBatchJobNames(p.jobs);
             const batchId = nextBatchId();
-            const launched: { name: string; id: string }[] = [];
+            const launched: { name: string; id: string; modelNote?: string }[] = [];
             const failed: { name: string; reason: string }[] = [];
             const skipped: { name: string }[] = [];
             // How many reject-mode reserved slots are still held (not yet committed/released).
@@ -2035,10 +2049,10 @@ export default function (pi: ExtensionAPI) {
                             name = prepared.assign.name;
                         }
                     }
-                    const { id } = await spawnSubagentRun(ctx, { ...merged, name }, { batchId, batchName: p.batchName });
+                    const { id, modelNote } = await spawnSubagentRun(ctx, { ...merged, name }, { batchId, batchName: p.batchName });
                     gate.commit(1);
                     if (!launchAvailable) reservedRemaining -= 1;
-                    launched.push({ name, id });
+                    launched.push({ name, id, ...(modelNote ? { modelNote } : {}) });
                 } catch (err) {
                     gate.release(1);
                     if (!launchAvailable) reservedRemaining -= 1;

package/node_modules/pi-better-subagents/navigator.mjs

@@ -399,7 +399,7 @@ export function buildNavigatorDetail(id, deps) {
     return {
         id: meta.id,
         name: meta.name,
-        role: meta.catalog?.roleId || meta.catalog?.roleName || undefined,
+        role: meta.catalog?.roleName || (meta.catalog?.roleId ? String(meta.catalog.roleId).replace(/^role\./, "") : undefined) || undefined,
         status,
         model: deps.shortModel(meta.model),
         effort: effortRaw ? String(effortRaw) : undefined,

package/node_modules/pi-better-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-subagents",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Pi extension for detached, sandboxed subagent runs that keep the foreground session free.",
   "license": "MIT",
   "type": "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-harness",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Pi extension bundle for a write sandbox, subagents, background tasks, SSH, goals, and structured plans.",
   "license": "MIT",
   "type": "module",
@@ -55,7 +55,7 @@
     "pi-better-plan": "0.5.0",
     "pi-better-sandbox": "0.7.1",
     "pi-better-ssh": "0.1.1",
-    "pi-better-subagents": "0.7.1",
+    "pi-better-subagents": "0.9.0",
     "smol-toml": "1.9.0",
     "yaml": "^2.9.1"
   },