@esso0428/pi-subagents 0.17.5 → 0.17.7

package/dist/settings.d.ts

@@ -1,6 +1,28 @@
-import type { JoinMode, WidgetMode } from "./types.js";
+import type { AgentMentionMode, JoinMode, ViewerMarkdownMode, WidgetMode } from "./types.js";
 export interface SubagentsSettings {
     maxConcurrent?: number;
+    /**
+     * Max concurrent FOREGROUND (blocking) agents — `0` = unlimited, the default,
+     * which preserves the behaviour that has always applied: nothing bounded
+     * foreground work, and pi dispatches a message's tool calls through
+     * `Promise.all`, so an unqualified fan-out of blocking `Agent` calls runs all
+     * at once. Set it to bound that (#253 — on local models, parallel agents
+     * thrash the prompt cache).
+     *
+     * Deliberately independent of `maxConcurrent` rather than folded into it: a
+     * foreground agent blocks the parent anyway, so charging it to the background
+     * pool would let a saturated pool starve the main session of work it could
+     * have done itself.
+     *
+     * Bounds only spawns a caller is blocking on inline. Nested children are
+     * exempt — their parent is blocked awaiting them, so queueing a child behind
+     * its own parent would deadlock — and so are detached spawns from
+     * cross-extension RPC or `@handle` mentions, which block nobody and are
+     * documented to start immediately. Foreground `resume` is also outside the
+     * pool: it reuses an existing session and never reaches the spawn path, so
+     * several blocking resumes in one message can still exceed the limit.
+     */
+    maxConcurrentForeground?: number;
     /**
      * 0 = unlimited — the extension's single source of truth for that convention:
      * `normalizeMaxTurns()` in agent-runner.ts treats 0 → `undefined`, and the
@@ -9,6 +31,23 @@ export interface SubagentsSettings {
     defaultMaxTurns?: number;
     graceTurns?: number;
     defaultJoinMode?: JoinMode;
+    /**
+     * Whether a top-level `Agent` spawn that doesn't say runs detached.
+     * Defaults to `true`, following Claude Code, where the agent backgrounds
+     * unless the caller passes `run_in_background: false`. Set `false` to restore
+     * the previous behaviour, where an unqualified spawn blocked the turn and
+     * returned its result inline.
+     *
+     * Top-level only. Nested spawns (a subagent spawning its own) always default
+     * to foreground regardless of this setting — see `nested-tools.ts`, where a
+     * detached child would be killed by `abortOwnedChildren` when its parent
+     * settles, with no notification path to deliver its result.
+     *
+     * An explicit `run_in_background` on the call, or in the agent file's
+     * frontmatter, overrides this in both directions; the setting only decides
+     * what "unspecified" means.
+     */
+    backgroundByDefault?: boolean;
     /**
      * Master switch for the schedule subagent feature. Defaults to `true`.
      * When `false`: the `Agent` tool's `schedule` param + its guideline are
@@ -40,6 +79,18 @@ export interface SubagentsSettings {
      * against. Defaults to false: subagents may use any model.
      */
     scopeModels?: boolean;
+    /**
+     * When true, an unreadable or unparseable agent `.md` aborts extension load
+     * instead of being skipped with a warning — pi exits, naming the file.
+     *
+     * Startup only, by design. Mid-session reloads (one per `Agent` call) keep
+     * warning: a bad edit at 3pm should not kill the session on the next
+     * unrelated spawn, where the failure would look disconnected from its cause.
+     * For a checked-in `.pi/agents/`, failing at startup is the point — the
+     * alternative is running a *different* agent than the file names.
+     * Defaults to false.
+     */
+    strictAgentFiles?: boolean;
     /**
      * When true, the three built-in default agents (general-purpose, Explore, Plan)
      * are not registered at startup. User-defined agents from project/global custom
@@ -58,6 +109,40 @@ export interface SubagentsSettings {
      * next pi session.
      */
     toolDescriptionMode?: ToolDescriptionMode;
+    /**
+     * Whether the Claude Code-style FleetView (the navigable main+subagents list
+     * rendered below the editor) is shown. Defaults to `true`. Pure-UI: when off,
+     * the list never registers and the global key handler never captures input.
+     */
+    fleetView?: boolean;
+    /**
+     * Whether `@handle message` typed at the prompt is routed to that subagent
+     * instead of the main model, and whether `@` offers running agents alongside
+     * pi's file completion. Defaults to `model`. Applied live.
+     *
+     *   - `model`: mentioning an agent that is not running asks the main model to
+     *     spawn it with the `Agent` tool, Claude Code's behaviour. Costs a turn,
+     *     and the model writes the agent's prompt rather than your text being it.
+     *   - `direct`: that agent is started here instead, with the typed message as
+     *     its prompt and no main-model turn spent.
+     *   - `off`: the input hook falls straight through and the stacked
+     *     autocomplete provider delegates everything back to pi's built-in one.
+     *
+     * Messaging a running agent and resuming a finished one are direct in both
+     * `model` and `direct`. The legacy booleans are still accepted: `true` reads
+     * as `model`, `false` as `off`.
+     */
+    agentMentions?: AgentMentionMode;
+    /**
+     * Whether subagents persist their pi session by default, so `@handle` can
+     * reopen an agent's conversation long after its in-memory record is gone.
+     * Defaults to `true`. Per-agent `persist_session:` frontmatter overrides it
+     * in both directions. Turning it off restores the previous behaviour, where
+     * a handle stops resolving roughly ten minutes after the agent finishes and
+     * mentioning it starts a fresh run instead. Persisted sessions also appear
+     * nested under the spawning session in pi's `/resume`.
+     */
+    rememberAgents?: boolean;
     /**
      * Display mode for the persistent above-editor agent widget:
      *   - `all`: show every agent (foreground + background).
@@ -65,7 +150,7 @@ export interface SubagentsSettings {
      *     Agent tool result, so the widget would otherwise double-render them
      *     (#118); everything else (background, queued, scheduled, RPC) stays.
      *   - `off`: hide the widget entirely.
-     * Defaults to `all`. Pure-UI and applied live (toggling refreshes the
+     * Defaults to `background`. Pure-UI and applied live (toggling refreshes the
      * widget).
      */
     widgetMode?: WidgetMode;
@@ -80,20 +165,161 @@ export interface SubagentsSettings {
      * (`isolation: worktree`), or memory files.
      */
     outputTranscript?: boolean;
+    /**
+     * Whether `isolation: "worktree"` may create a worktree at all. Defaults to
+     * `true`. Set `false` on a repo where worktrees are too slow or too large to
+     * be worth it (#184): a requested worktree is then dropped and the agent runs
+     * in the main checkout.
+     *
+     * The drop is deliberately silent — there is no per-result note, because the
+     * setting exists for projects whose model asks for a worktree on every call,
+     * where a note would be noise on every result. What keeps the orchestrator
+     * from claiming a `pi-agent-*` branch anyway is that it is never told the
+     * capability exists: `isolationParam` (invocation-config.ts) drops the field
+     * from both tool schemas, and `isolationGuideline` (index.ts) drops the
+     * matching prose from the full and compact descriptions — a custom one opts
+     * in via the `{{isolationGuideline}}` placeholder. Anything that
+     * reintroduces the prose has to reintroduce a note with it.
+     *
+     * Deliberately a downgrade rather than an error. The fail-loud rule covers
+     * worktrees that *cannot* be created; this is the user declining one, and
+     * throwing would reject exactly the calls that the `isolation: "off"` value
+     * exists to tolerate. Enforced below the tool boundary, so it also covers the
+     * scheduler and the unvalidated cross-extension RPC path.
+     */
+    worktreeIsolation?: boolean;
+    /**
+     * Master switch for scripted workflows. Defaults to `true`.
+     *
+     * Off is not a soft hide: the `SubagentWorkflow` tool is never registered, so
+     * the model is not told it exists and cannot call it, the `/agents`
+     * Workflows entry is hidden, and `--subagents-workflow-file` is refused.
+     *
+     * Absent is not the same as `true`. Unset means *auto*: on, but yielding to
+     * another extension that already offers a workflow tool, because two
+     * orchestrators in one tool spec is a worse default than none — the model
+     * has to guess which to call, and pays for both descriptions to find out.
+     * Setting it explicitly pins the answer in both directions: `true` keeps
+     * ours whatever else is loaded, `false` is off regardless. See
+     * `resolveWorkflowCollisions` in index.ts.
+     *
+     * Read once at extension init, before registration, so flipping it in
+     * `/agents → Settings` takes effect on the next pi session — the same
+     * contract `schedulingEnabled` has, and for the same reason: a tool spec is
+     * fixed once pi has it.
+     */
+    workflowsEnabled?: boolean;
+    /**
+     * Hard ceiling on nested subagent delegation, counted from the main session:
+     * main = 0, its subagents = 1, their children = 2. Defaults to `2`; `0` or `1`
+     * disables nesting project-wide. Read when a subagent session is built, so a
+     * change applies to agents started after it.
+     */
+    maxSubagentDepth?: number;
+    /**
+     * Agent type substituted when a caller-supplied `subagent_type` doesn't
+     * resolve to exactly one enabled agent (unknown, disabled, or ambiguous by
+     * case). Omitted keeps the historical `general-purpose` fallback; a type name
+     * routes those calls to that agent instead; `"none"` disables the fallback so
+     * dispatch fails closed with an error naming the available types.
+     *
+     * The boolean `false` is accepted as a spelling of `"none"`, because a boolean
+     * would otherwise be dropped as the wrong type and silently leave the
+     * PERMISSIVE default in place while the author believes strict dispatch is on
+     * — the wrong direction to fail for this setting. Every other value is an
+     * agent name, so a mistaken `"off"` fails loudly at dispatch rather than
+     * meaning one thing here and another in the resolver.
+     */
+    fallbackSubagent?: string;
+    /**
+     * Whether this extension's tool results carry a `usage` field, so subagent
+     * spend reaches the parent session's own accounting. Defaults to `false`.
+     *
+     * Subagents run in their own pi sessions, so by default the parent's footer,
+     * statusline and `/cost` show only what the main model spent — a session that
+     * delegated most of its work reads as nearly free. Pi folds
+     * `toolResult.usage` into `getSessionStats()`, so attaching it makes those
+     * surfaces count subagents too, under `/cost`'s "Tools/summaries" bucket.
+     *
+     * Off by default because it changes numbers the user may already be tracking
+     * (a statusline reading session cost will step up), not because the numbers
+     * are wrong.
+     *
+     * Three properties of what gets reported:
+     *   - Tokens exclude `cacheRead`, for the reason in `usage.ts` — the parent's
+     *     token total therefore rises by billed tokens only.
+     *   - Cost is pi's own per-message `usage.cost.total`; we price nothing, and
+     *     a model pi has no rates for contributes 0.
+     *   - The context-window percentage is untouched. Pi derives it from assistant
+     *     messages alone (`getContextUsage`), so a delegating session's context
+     *     does not appear to fill up faster.
+     */
+    reportUsage?: boolean;
+    /**
+     * Whether the subagent surfaces show an estimated dollar cost next to their
+     * token counts (widget, FleetView, conversation viewer, foreground results,
+     * completion notifications). Defaults to `false`. Applied live.
+     *
+     * Rendered as `~$0.0042` — the tilde marks it as pi's reported estimate
+     * rather than a billed figure, and it is omitted entirely when the model has
+     * no pricing data, so a local model shows tokens and no dollars.
+     *
+     * Independent of `reportUsage`: this one is what a human reads, that one is
+     * what the parent session counts.
+     */
+    showCost?: boolean;
+    /**
+     * Whether the widget's running rows name the model driving each agent and the
+     * thinking level it is running at.
+     *
+     * Off by default, unlike the tool result and the conversation viewer, which
+     * show the pair unconditionally: those have a line to themselves, while the
+     * widget row already carries the description, turns, tool uses, tokens and
+     * elapsed time, and every character it gains is one the description loses on a
+     * narrow terminal.
+     */
+    showModel?: boolean;
+    /**
+     * How much of the conversation viewer's transcript renders as Markdown.
+     * Defaults to `assistant`. Applied live — the viewer's `m` key cycles this
+     * same setting, so a choice made in the overlay persists like one made in
+     * `/agents → Settings`.
+     *
+     * Scoped rather than all-or-nothing because the two kinds of content have
+     * different contracts: assistant text is authored as Markdown, while a tool
+     * result is whatever bytes the tool produced. Rendering the latter as
+     * Markdown is lossy in ways that look like the tool misbehaved — see
+     * `ViewerMarkdownMode` for the specific rewrites — so `all` is opt-in.
+     */
+    viewerMarkdown?: ViewerMarkdownMode;
 }
 export type ToolDescriptionMode = "full" | "compact" | "custom";
 /** Setter hooks used by applySettings to wire persisted values into in-memory state. */
 export interface SettingsAppliers {
     setMaxConcurrent: (n: number) => void;
+    setMaxConcurrentForeground: (n: number) => void;
     setDefaultMaxTurns: (n: number) => void;
     setGraceTurns: (n: number) => void;
     setDefaultJoinMode: (mode: JoinMode) => void;
+    setBackgroundByDefault: (b: boolean) => void;
     setSchedulingEnabled: (b: boolean) => void;
     setScopeModels: (enabled: boolean) => void;
+    setStrictAgentFiles: (b: boolean) => void;
     setDisableDefaultAgents: (b: boolean) => void;
     setToolDescriptionMode: (mode: ToolDescriptionMode) => void;
+    setFleetView: (b: boolean) => void;
+    setAgentMentions: (mode: AgentMentionMode) => void;
+    setRememberAgents: (b: boolean) => void;
     setWidgetMode: (mode: WidgetMode) => void;
     setOutputTranscript: (b: boolean) => void;
+    setWorktreeIsolation: (b: boolean) => void;
+    setWorkflowsEnabled: (b: boolean) => void;
+    setMaxSubagentDepth: (n: number) => void;
+    setFallbackSubagent: (v: string | undefined) => void;
+    setReportUsage: (b: boolean) => void;
+    setShowCost: (b: boolean) => void;
+    setShowModel: (b: boolean) => void;
+    setViewerMarkdown: (mode: ViewerMarkdownMode) => void;
 }
 /** Emit callback — a subset of `pi.events.emit` to keep helpers testable. */
 export type SettingsEmit = (event: string, payload: unknown) => void;

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhE,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,kBAAkB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC7C,oBAAoB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,uBAAuB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,sBAAsB,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,aAAa,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,mBAAmB,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C;AAED,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAuFrE,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,iBAAiB,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CASvF;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,YAAY,EAClB,GAAG,GAAE,MAAsB,GAC1B,iBAAiB,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,GAAG,GAAE,MAAsB,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAIhD"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/settings.js

@@ -4,15 +4,19 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { NO_FALLBACK } from "./agent-types.js";
 const VALID_JOIN_MODES = new Set(["async", "group", "smart"]);
 const VALID_TOOL_DESCRIPTION_MODES = new Set(["full", "compact", "custom"]);
 const VALID_WIDGET_MODES = new Set(["all", "background", "off"]);
+const VALID_VIEWER_MARKDOWN_MODES = new Set(["off", "assistant", "all"]);
+const VALID_AGENT_MENTION_MODES = new Set(["model", "direct", "off"]);
 // Sanity ceilings — prevent hand-edited configs from asking for values that
 // make no operational sense (e.g. 1e6 concurrent subagents). Permissive enough
 // that any realistic power-user setting passes through.
 const MAX_CONCURRENT_CEILING = 1024;
 const MAX_TURNS_CEILING = 10_000;
 const GRACE_TURNS_CEILING = 1_000;
+const SUBAGENT_DEPTH_CEILING = 16;
 /** Drop fields that don't match the expected shape. Silent — garbage becomes absent. */
 function sanitize(raw) {
     if (!raw || typeof raw !== "object")
@@ -24,6 +28,13 @@ function sanitize(raw) {
         r.maxConcurrent <= MAX_CONCURRENT_CEILING) {
         out.maxConcurrent = r.maxConcurrent;
     }
+    // Floor 0, not 1 like maxConcurrent above: 0 is the documented "unlimited"
+    // value and the default, so dropping it would silently be unrepresentable.
+    if (Number.isInteger(r.maxConcurrentForeground) &&
+        r.maxConcurrentForeground >= 0 &&
+        r.maxConcurrentForeground <= MAX_CONCURRENT_CEILING) {
+        out.maxConcurrentForeground = r.maxConcurrentForeground;
+    }
     if (Number.isInteger(r.defaultMaxTurns) &&
         r.defaultMaxTurns >= 0 &&
         r.defaultMaxTurns <= MAX_TURNS_CEILING) {
@@ -34,27 +45,81 @@ function sanitize(raw) {
         r.graceTurns <= GRACE_TURNS_CEILING) {
         out.graceTurns = r.graceTurns;
     }
+    if (Number.isInteger(r.maxSubagentDepth) &&
+        r.maxSubagentDepth >= 0 &&
+        r.maxSubagentDepth <= SUBAGENT_DEPTH_CEILING) {
+        out.maxSubagentDepth = r.maxSubagentDepth;
+    }
     if (typeof r.defaultJoinMode === "string" && VALID_JOIN_MODES.has(r.defaultJoinMode)) {
         out.defaultJoinMode = r.defaultJoinMode;
     }
+    if (typeof r.backgroundByDefault === "boolean") {
+        out.backgroundByDefault = r.backgroundByDefault;
+    }
     if (typeof r.schedulingEnabled === "boolean") {
         out.schedulingEnabled = r.schedulingEnabled;
     }
     if (typeof r.scopeModels === "boolean") {
         out.scopeModels = r.scopeModels;
     }
+    if (typeof r.strictAgentFiles === "boolean") {
+        out.strictAgentFiles = r.strictAgentFiles;
+    }
     if (typeof r.disableDefaultAgents === "boolean") {
         out.disableDefaultAgents = r.disableDefaultAgents;
     }
     if (typeof r.toolDescriptionMode === "string" && VALID_TOOL_DESCRIPTION_MODES.has(r.toolDescriptionMode)) {
         out.toolDescriptionMode = r.toolDescriptionMode;
     }
+    if (typeof r.fleetView === "boolean") {
+        out.fleetView = r.fleetView;
+    }
+    // Was a boolean before the `model` mode existed. A hand-written or
+    // previously-written `true` means "on", which is now the default `model`.
+    if (typeof r.agentMentions === "boolean") {
+        out.agentMentions = r.agentMentions ? "model" : "off";
+    }
+    else if (typeof r.agentMentions === "string" && VALID_AGENT_MENTION_MODES.has(r.agentMentions)) {
+        out.agentMentions = r.agentMentions;
+    }
+    if (typeof r.rememberAgents === "boolean") {
+        out.rememberAgents = r.rememberAgents;
+    }
     if (typeof r.widgetMode === "string" && VALID_WIDGET_MODES.has(r.widgetMode)) {
         out.widgetMode = r.widgetMode;
     }
     if (typeof r.outputTranscript === "boolean") {
         out.outputTranscript = r.outputTranscript;
     }
+    if (typeof r.worktreeIsolation === "boolean") {
+        out.worktreeIsolation = r.worktreeIsolation;
+    }
+    if (typeof r.reportUsage === "boolean") {
+        out.reportUsage = r.reportUsage;
+    }
+    if (typeof r.showCost === "boolean") {
+        out.showCost = r.showCost;
+    }
+    if (typeof r.showModel === "boolean") {
+        out.showModel = r.showModel;
+    }
+    if (typeof r.viewerMarkdown === "string" && VALID_VIEWER_MARKDOWN_MODES.has(r.viewerMarkdown)) {
+        out.viewerMarkdown = r.viewerMarkdown;
+    }
+    if (typeof r.workflowsEnabled === "boolean") {
+        out.workflowsEnabled = r.workflowsEnabled;
+    }
+    if (r.fallbackSubagent === false) {
+        // The only non-string spelling worth accepting: a boolean would otherwise be
+        // dropped, silently leaving the PERMISSIVE default in place. Every string is
+        // an agent name except the `none` sentinel, which the resolver recognizes —
+        // so a mistaken "off" fails loudly at dispatch instead of meaning something
+        // different here than it does there.
+        out.fallbackSubagent = NO_FALLBACK;
+    }
+    else if (typeof r.fallbackSubagent === "string" && r.fallbackSubagent.trim()) {
+        out.fallbackSubagent = r.fallbackSubagent.trim();
+    }
     return out;
 }
 function globalPath() {
@@ -104,24 +169,53 @@ export function saveSettings(s, cwd = process.cwd()) {
 export function applySettings(s, appliers) {
     if (typeof s.maxConcurrent === "number")
         appliers.setMaxConcurrent(s.maxConcurrent);
+    if (typeof s.maxConcurrentForeground === "number") {
+        appliers.setMaxConcurrentForeground(s.maxConcurrentForeground);
+    }
     if (typeof s.defaultMaxTurns === "number")
         appliers.setDefaultMaxTurns(s.defaultMaxTurns);
     if (typeof s.graceTurns === "number")
         appliers.setGraceTurns(s.graceTurns);
+    if (typeof s.maxSubagentDepth === "number")
+        appliers.setMaxSubagentDepth(s.maxSubagentDepth);
+    if (typeof s.fallbackSubagent === "string")
+        appliers.setFallbackSubagent(s.fallbackSubagent);
     if (s.defaultJoinMode)
         appliers.setDefaultJoinMode(s.defaultJoinMode);
+    if (typeof s.backgroundByDefault === "boolean")
+        appliers.setBackgroundByDefault(s.backgroundByDefault);
     if (typeof s.schedulingEnabled === "boolean")
         appliers.setSchedulingEnabled(s.schedulingEnabled);
     if (typeof s.scopeModels === "boolean")
         appliers.setScopeModels(s.scopeModels);
+    if (typeof s.strictAgentFiles === "boolean")
+        appliers.setStrictAgentFiles(s.strictAgentFiles);
     if (typeof s.disableDefaultAgents === "boolean")
         appliers.setDisableDefaultAgents(s.disableDefaultAgents);
     if (s.toolDescriptionMode)
         appliers.setToolDescriptionMode(s.toolDescriptionMode);
+    if (typeof s.fleetView === "boolean")
+        appliers.setFleetView(s.fleetView);
+    if (s.agentMentions)
+        appliers.setAgentMentions(s.agentMentions);
+    if (typeof s.rememberAgents === "boolean")
+        appliers.setRememberAgents(s.rememberAgents);
     if (s.widgetMode)
         appliers.setWidgetMode(s.widgetMode);
     if (typeof s.outputTranscript === "boolean")
         appliers.setOutputTranscript(s.outputTranscript);
+    if (typeof s.worktreeIsolation === "boolean")
+        appliers.setWorktreeIsolation(s.worktreeIsolation);
+    if (typeof s.reportUsage === "boolean")
+        appliers.setReportUsage(s.reportUsage);
+    if (typeof s.showCost === "boolean")
+        appliers.setShowCost(s.showCost);
+    if (typeof s.showModel === "boolean")
+        appliers.setShowModel(s.showModel);
+    if (s.viewerMarkdown)
+        appliers.setViewerMarkdown(s.viewerMarkdown);
+    if (typeof s.workflowsEnabled === "boolean")
+        appliers.setWorkflowsEnabled(s.workflowsEnabled);
 }
 /**
  * Format the user-facing toast for a settings mutation. Pure function —

package/dist/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/status-note.d.ts

@@ -1,6 +1,13 @@
 /**
- * status-note.ts — Parenthetical status note appended to agent result text.
+ * status-note.ts — Honest framing for an agent result: the parenthetical status
+ * note for a non-normal outcome, and the salvaged partial output of a failure.
+ *
+ * Lives here rather than in an index.ts closure because both entry points need
+ * it — the top-level tools and the nested delegation tools, which can't import
+ * from index.ts (that is the extension entry, and it already reaches these tools
+ * through agent-runner).
  */
+import type { AgentRecord } from "./types.js";
 /**
  * Explicit parenthetical note for a non-normal terminal outcome, so the parent
  * agent can't mistake partial output for a completed result. Empty string for a
@@ -11,4 +18,45 @@
  * from a budget cutoff.
  */
 export declare function getStatusNote(status: string): string;
+/**
+ * Foreground variant of `getStatusNote`. A foreground caller is in a different
+ * position from a background one, so it needs different text:
+ *
+ *   - It already holds the agent's ENTIRE output inline, whereas the background
+ *     notification carries a 500-char preview. So only here can we truthfully
+ *     say there is nothing more to fetch — which is the whole point, because
+ *   - it has no agent id. The id travels in the tool result's renderer
+ *     `details`, which is never serialized to the model. A parent that reads
+ *     "output may be partial" as "truncated, go retrieve the rest" therefore
+ *     has nothing valid to call `get_subagent_result` with, and will invent an
+ *     id (#174).
+ *
+ * Only the lead clause varies between the three, and each variation carries
+ * information: `wrapped up` vs `aborted` tells the parent whether the output is
+ * a considered final answer or a fragment, and `stopped` shouts because a human
+ * intervening outranks everything else in the string. Only `steered` hedges on
+ * completion — it was told to wrap up and did, so it may well have finished at
+ * the limit; an aborted run blew through its grace turns while still working,
+ * and `stopped` can only fire on a running agent, so neither ever delivered a
+ * final answer. Identical confidence gets identical wording: phrasing one fact
+ * two ways invites a hunt for a distinction that isn't there.
+ *
+ * Every clause is a statement about state, never an instruction to act, and
+ * `get_subagent_result` is never named — naming the tool we steer away from only
+ * raises its salience. Two instructions were tried here and cut: "re-spawn with
+ * a higher max_turns" (pushes a fresh multi-minute run to save one wasted tool
+ * call) and, on `stopped`, "ask before restarting it" (restates the lead, and
+ * presumes someone is present to ask — false under `pi -p`, in scheduled jobs,
+ * and in any background-driven run). Nothing here can measure whether wording
+ * improves parent behavior, so removing a false cue (which cannot induce new
+ * behavior) and adding an instruction (which can) are not equally safe bets.
+ * Don't add either back without a way to measure it.
+ */
+export declare function getForegroundOutcomeNote(status: string): string;
+/**
+ * Salvaged partial output of a failed run, as a labeled suffix for the error
+ * surfaces (or "" if the run produced nothing). `record.result` is bounded to
+ * the run's own turns, so this is never a stale earlier answer (#144).
+ */
+export declare function partialOutputSuffix(record: AgentRecord): string;
 //# sourceMappingURL=status-note.d.ts.map

package/dist/status-note.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-note.d.ts","sourceRoot":"","sources":["../src/status-note.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWpD"}
+{"version":3,"file":"status-note.d.ts","sourceRoot":"","sources":["../src/status-note.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG/D"}

package/dist/status-note.js

@@ -1,5 +1,11 @@
 /**
- * status-note.ts — Parenthetical status note appended to agent result text.
+ * status-note.ts — Honest framing for an agent result: the parenthetical status
+ * note for a non-normal outcome, and the salvaged partial output of a failure.
+ *
+ * Lives here rather than in an index.ts closure because both entry points need
+ * it — the top-level tools and the nested delegation tools, which can't import
+ * from index.ts (that is the extension entry, and it already reaches these tools
+ * through agent-runner).
  */
 /**
  * Explicit parenthetical note for a non-normal terminal outcome, so the parent
@@ -22,4 +28,59 @@ export function getStatusNote(status) {
             return "";
     }
 }
+/**
+ * Foreground variant of `getStatusNote`. A foreground caller is in a different
+ * position from a background one, so it needs different text:
+ *
+ *   - It already holds the agent's ENTIRE output inline, whereas the background
+ *     notification carries a 500-char preview. So only here can we truthfully
+ *     say there is nothing more to fetch — which is the whole point, because
+ *   - it has no agent id. The id travels in the tool result's renderer
+ *     `details`, which is never serialized to the model. A parent that reads
+ *     "output may be partial" as "truncated, go retrieve the rest" therefore
+ *     has nothing valid to call `get_subagent_result` with, and will invent an
+ *     id (#174).
+ *
+ * Only the lead clause varies between the three, and each variation carries
+ * information: `wrapped up` vs `aborted` tells the parent whether the output is
+ * a considered final answer or a fragment, and `stopped` shouts because a human
+ * intervening outranks everything else in the string. Only `steered` hedges on
+ * completion — it was told to wrap up and did, so it may well have finished at
+ * the limit; an aborted run blew through its grace turns while still working,
+ * and `stopped` can only fire on a running agent, so neither ever delivered a
+ * final answer. Identical confidence gets identical wording: phrasing one fact
+ * two ways invites a hunt for a distinction that isn't there.
+ *
+ * Every clause is a statement about state, never an instruction to act, and
+ * `get_subagent_result` is never named — naming the tool we steer away from only
+ * raises its salience. Two instructions were tried here and cut: "re-spawn with
+ * a higher max_turns" (pushes a fresh multi-minute run to save one wasted tool
+ * call) and, on `stopped`, "ask before restarting it" (restates the lead, and
+ * presumes someone is present to ask — false under `pi -p`, in scheduled jobs,
+ * and in any background-driven run). Nothing here can measure whether wording
+ * improves parent behavior, so removing a false cue (which cannot induce new
+ * behavior) and adding an instruction (which can) are not equally safe bets.
+ * Don't add either back without a way to measure it.
+ */
+export function getForegroundOutcomeNote(status) {
+    switch (status) {
+        case "stopped":
+            return " (STOPPED BY THE USER — everything the agent produced is above; the task is unfinished)";
+        case "aborted":
+            return " (aborted at the turn limit — everything the agent produced is above; the task is unfinished)";
+        case "steered":
+            return " (wrapped up at the turn limit — everything the agent produced is above; the task may be unfinished)";
+        default:
+            return "";
+    }
+}
+/**
+ * Salvaged partial output of a failed run, as a labeled suffix for the error
+ * surfaces (or "" if the run produced nothing). `record.result` is bounded to
+ * the run's own turns, so this is never a stale earlier answer (#144).
+ */
+export function partialOutputSuffix(record) {
+    const partial = record.result?.trim();
+    return partial ? `\n\nPartial output before the failure:\n${partial}` : "";
+}
 //# sourceMappingURL=status-note.js.map

package/dist/status-note.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-note.js","sourceRoot":"","sources":["../src/status-note.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,yFAAyF,CAAC;QACnG,KAAK,SAAS;YACZ,OAAO,6EAA6E,CAAC;QACvF,KAAK,SAAS;YACZ,OAAO,yDAAyD,CAAC;QACnE;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"status-note.js","sourceRoot":"","sources":["../src/status-note.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,yFAAyF,CAAC;QACnG,KAAK,SAAS;YACZ,OAAO,6EAA6E,CAAC;QACvF,KAAK,SAAS;YACZ,OAAO,yDAAyD,CAAC;QACnE;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,yFAAyF,CAAC;QACnG,KAAK,SAAS;YACZ,OAAO,+FAA+F,CAAC;QACzG,KAAK,SAAS;YACZ,OAAO,sGAAsG,CAAC;QAChH;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,OAAO,OAAO,CAAC,CAAC,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}