@phnx-labs/agents-cli 1.22.21 → 1.22.23

package/dist/lib/picker.js

@@ -17,12 +17,47 @@ import chalk from 'chalk';
 import { stripVTControlCharacters } from 'node:util';
 const DEFAULT_TERMINAL_ROWS = 24;
 const DEFAULT_TERMINAL_WIDTH = 80;
+/**
+ * Rows the detail preview is guaranteed when it is open and a row is selected.
+ * The list page is capped so this floor always fits the viewport — without it a
+ * long list (PICKER_RECENT_COUNT = 15) consumes the whole default 24-row
+ * terminal, `availablePreviewRows` goes <= 0, and the preview silently collapses
+ * to empty (RUSH-2198).
+ */
+export const PREVIEW_MIN_ROWS = 6;
+/** Floor for the visible list page, so a short terminal still shows a few rows. */
+export const PICKER_MIN_LIST_ROWS = 3;
 function terminalWidth() {
     return Math.max(1, process.stdout.columns || DEFAULT_TERMINAL_WIDTH);
 }
 function terminalRows() {
     return Math.max(1, process.stdout.rows || DEFAULT_TERMINAL_ROWS);
 }
+/**
+ * Cap the visible list page so an open preview keeps a guaranteed floor of rows.
+ *
+ * The picker renders header + list page + separator + preview + help. When the
+ * requested page size (e.g. 15) is large enough to fill the terminal on its own,
+ * the preview has no room left and collapses. This reserves
+ * {@link PREVIEW_MIN_ROWS} (plus its separator) for the preview and hands the
+ * list whatever remains, never below {@link PICKER_MIN_LIST_ROWS}.
+ *
+ * `chromeRows` counts the fixed non-list, non-preview lines (header, subtitle,
+ * help, any flash). `linesAbovePrompt` counts lines the caller printed above the
+ * Inquirer prompt that have scrolled the viewport but the picker cannot measure —
+ * today the session picker passes the hidden-session footer; subtracting it keeps
+ * that notice on screen alongside the preview. (The fleet browser folds its
+ * unreachable-peer warning into the header instead, so it needs no reserve here.)
+ */
+export function pickerPageSize(opts) {
+    const previewMinRows = opts.previewMinRows ?? PREVIEW_MIN_ROWS;
+    const minListRows = opts.minListRows ?? PICKER_MIN_LIST_ROWS;
+    const linesAbove = Math.max(0, opts.linesAbovePrompt ?? 0);
+    // The separator line rides with the preview only when it is open.
+    const previewReserve = opts.previewOpen ? previewMinRows + 1 : 0;
+    const budget = opts.terminalRows - linesAbove - opts.chromeRows - previewReserve;
+    return Math.max(minListRows, Math.min(opts.requestedPageSize, budget));
+}
 function renderedRows(text, width) {
     const normalizedWidth = Math.max(1, width);
     return text.split('\n').reduce((rows, line) => {
@@ -157,6 +192,17 @@ export function itemPicker(config) {
             : '(type to filter)';
         const searchStr = searchTerm ? chalk.cyan(searchTerm) : chalk.gray(placeholder);
         const header = [prefix, message, searchStr].filter(Boolean).join(' ');
+        // Cap the list page so an open preview keeps a guaranteed floor of rows.
+        // chrome = header + optional subtitle + help; the preview separator is
+        // reserved inside pickerPageSize.
+        const chromeRows = 1 + (cfg.subtitle ? 1 : 0) + 1;
+        const effectivePageSize = pickerPageSize({
+            requestedPageSize: cfg.pageSize ?? 10,
+            terminalRows: terminalRows(),
+            chromeRows,
+            previewOpen: previewOpen && Boolean(cfg.buildPreview),
+            linesAbovePrompt: cfg.linesAbovePrompt,
+        });
         const page = usePagination({
             items: results,
             active,
@@ -167,7 +213,7 @@ export function itemPicker(config) {
                 const row = isActive ? chalk.bold(item.label) : item.label;
                 return `${cursor} ${row}`;
             },
-            pageSize: cfg.pageSize ?? 10,
+            pageSize: effectivePageSize,
             loop: false,
         });
         const enter = cfg.enterHint ?? 'select';
@@ -188,7 +234,7 @@ export function itemPicker(config) {
                 renderedRows(parts.slice(1).join('\n'), width) +
                 renderedRows(separator, width) +
                 renderedRows(help, width);
-            const availablePreviewRows = terminalRows() - fixedRows;
+            const availablePreviewRows = terminalRows() - Math.max(0, cfg.linesAbovePrompt ?? 0) - fixedRows;
             const preview = limitPreviewHeight(cfg.buildPreview(selected.value), availablePreviewRows, width);
             if (preview) {
                 parts.push(separator);
@@ -283,6 +329,17 @@ export function multiItemPicker(config) {
         const placeholder = '(type to filter · space to toggle · enter to resume)';
         const searchStr = searchTerm ? chalk.cyan(searchTerm) : chalk.gray(placeholder);
         const header = [prefix, message, searchStr].filter(Boolean).join(' ');
+        // Cap the list page so an open preview keeps a guaranteed floor of rows.
+        // chrome = header + help; the preview separator is reserved inside
+        // pickerPageSize.
+        const chromeRows = 2;
+        const effectivePageSize = pickerPageSize({
+            requestedPageSize: cfg.pageSize ?? 10,
+            terminalRows: terminalRows(),
+            chromeRows,
+            previewOpen: previewOpen && Boolean(cfg.buildPreview),
+            linesAbovePrompt: cfg.linesAbovePrompt,
+        });
         const page = usePagination({
             items: results,
             active,
@@ -295,7 +352,7 @@ export function multiItemPicker(config) {
                 const row = isActive ? chalk.bold(item.label) : item.label;
                 return `${cursor} ${box} ${row}`;
             },
-            pageSize: cfg.pageSize ?? 10,
+            pageSize: effectivePageSize,
             loop: false,
         });
         const enter = cfg.enterHint ?? 'resume';
@@ -312,7 +369,7 @@ export function multiItemPicker(config) {
                 renderedRows(parts.slice(1).join('\n'), width) +
                 renderedRows(separator, width) +
                 renderedRows(help, width);
-            const availablePreviewRows = terminalRows() - fixedRows;
+            const availablePreviewRows = terminalRows() - Math.max(0, cfg.linesAbovePrompt ?? 0) - fixedRows;
             const preview = limitPreviewHeight(cfg.buildPreview(selected.value), availablePreviewRows, width);
             if (preview) {
                 parts.push(separator);
@@ -553,6 +610,18 @@ export function dynamicPicker(config) {
             headerBits.push(chalk.cyan('/' + query));
         }
         const header = headerBits.filter(Boolean).join(' ');
+        // Cap the list page so an open preview keeps a guaranteed floor of rows.
+        // chrome = header + help + optional flash line; the preview separator is
+        // reserved inside pickerPageSize. Only the loaded list steals viewport, so
+        // skip the cap while the loading placeholder is showing.
+        const chromeRows = 2 + (flash ? renderedRows(flash, terminalWidth()) : 0);
+        const effectivePageSize = pickerPageSize({
+            requestedPageSize: cfg.pageSize ?? 12,
+            terminalRows: terminalRows(),
+            chromeRows,
+            previewOpen: previewOpen && Boolean(cfg.buildPreview) && !loading,
+            linesAbovePrompt: cfg.linesAbovePrompt,
+        });
         const page = usePagination({
             items: results,
             active,
@@ -563,7 +632,7 @@ export function dynamicPicker(config) {
                 const row = isActive ? chalk.bold(item.label) : item.label;
                 return `${cursor} ${row}`;
             },
-            pageSize: cfg.pageSize ?? 12,
+            pageSize: effectivePageSize,
             loop: false,
         });
         const help = chalk.gray(cfg.helpFor
@@ -590,7 +659,7 @@ export function dynamicPicker(config) {
                 renderedRows(separator, width) +
                 renderedRows(help, width) +
                 flashRows;
-            const availablePreviewRows = terminalRows() - fixedRows;
+            const availablePreviewRows = terminalRows() - Math.max(0, cfg.linesAbovePrompt ?? 0) - fixedRows;
             const preview = limitPreviewHeight(cfg.buildPreview(selected.value), availablePreviewRows, width);
             if (preview) {
                 parts.push(separator);

package/dist/lib/plugin-marketplace.js

@@ -121,6 +121,11 @@ function dirExists(p) {
 }
 // ─── Per-version paths ────────────────────────────────────────────────────────
 function pluginsRootForVersion(agent, versionHome) {
+    // Muse Code keeps its plugin store under XDG data (`~/.local/share/muse/plugins`),
+    // not under the config dir. Under HOME isolation the version home is $HOME.
+    if (agent === 'muse') {
+        return path.join(versionHome, '.local', 'share', 'muse', 'plugins');
+    }
     return path.join(versionHome, agentConfigDirName(agent), 'plugins');
 }
 export function marketplaceRoot(specOrName, agent, versionHome) {
@@ -678,6 +683,10 @@ export function addPluginToSettings(pluginName, marketplaceName, agent, versionH
             settings = {};
         }
     }
+    // Muse refuses to start without schema_version: 1.
+    if (agent === 'muse' && settings.schema_version === undefined) {
+        settings.schema_version = 1;
+    }
     if (!settings.enabledPlugins || typeof settings.enabledPlugins !== 'object') {
         settings.enabledPlugins = {};
     }

package/dist/lib/pricing/prices.json

@@ -1,153 +1,180 @@
 {
-    "version": "2026-08-03",
+    "version": "2026-08-05",
     "models": {
         "claude-opus-4": {
+            "inputPerToken": 5e-06,
+            "outputPerToken": 2.5e-05,
+            "cacheReadPerToken": 5e-07,
+            "cacheWritePerToken": 6.25e-06
+        },
+        "claude-sonnet-4": {
+            "inputPerToken": 3e-06,
+            "outputPerToken": 1.5e-05,
+            "cacheReadPerToken": 3e-07,
+            "cacheWritePerToken": 3.75e-06
+        },
+        "claude-haiku-4": {
+            "inputPerToken": 1e-06,
+            "outputPerToken": 5e-06,
+            "cacheReadPerToken": 1e-07,
+            "cacheWritePerToken": 1.25e-06
+        },
+        "claude-opus-5": {
             "inputPerToken": 0.000005,
             "outputPerToken": 0.000025,
             "cacheReadPerToken": 0.0000005,
             "cacheWritePerToken": 0.00000625
         },
-        "claude-sonnet-4": {
-            "inputPerToken": 0.000003,
-            "outputPerToken": 0.000015,
-            "cacheReadPerToken": 0.0000003,
-            "cacheWritePerToken": 0.00000375
-        },
-        "claude-haiku-4": {
-            "inputPerToken": 0.000001,
-            "outputPerToken": 0.000005,
-            "cacheReadPerToken": 0.0000001,
-            "cacheWritePerToken": 0.00000125
+        "claude-sonnet-5": {
+            "inputPerToken": 0.000002,
+            "outputPerToken": 0.00001,
+            "cacheReadPerToken": 0.0000002,
+            "cacheWritePerToken": 0.0000025
         },
         "claude-fable-5": {
-            "inputPerToken": 0.00001,
-            "outputPerToken": 0.00005,
-            "cacheReadPerToken": 0.000001,
-            "cacheWritePerToken": 0.0000125
+            "inputPerToken": 1e-05,
+            "outputPerToken": 5e-05,
+            "cacheReadPerToken": 1e-06,
+            "cacheWritePerToken": 1.25e-05
         },
         "claude-mythos-5": {
-            "inputPerToken": 0.00001,
-            "outputPerToken": 0.00005,
-            "cacheReadPerToken": 0.000001,
-            "cacheWritePerToken": 0.0000125
+            "inputPerToken": 1e-05,
+            "outputPerToken": 5e-05,
+            "cacheReadPerToken": 1e-06,
+            "cacheWritePerToken": 1.25e-05
         },
         "claude-3-5-sonnet": {
-            "inputPerToken": 0.000003,
-            "outputPerToken": 0.000015,
-            "cacheReadPerToken": 0.0000003,
-            "cacheWritePerToken": 0.00000375
+            "inputPerToken": 3e-06,
+            "outputPerToken": 1.5e-05,
+            "cacheReadPerToken": 3e-07,
+            "cacheWritePerToken": 3.75e-06
         },
         "claude-3-5-haiku": {
-            "inputPerToken": 0.0000008,
-            "outputPerToken": 0.000004,
-            "cacheReadPerToken": 0.00000008,
-            "cacheWritePerToken": 0.000001
+            "inputPerToken": 8e-07,
+            "outputPerToken": 4e-06,
+            "cacheReadPerToken": 8e-08,
+            "cacheWritePerToken": 1e-06
         },
         "claude-3-opus": {
-            "inputPerToken": 0.000015,
-            "outputPerToken": 0.000075,
-            "cacheReadPerToken": 0.0000015,
-            "cacheWritePerToken": 0.00001875
+            "inputPerToken": 1.5e-05,
+            "outputPerToken": 7.5e-05,
+            "cacheReadPerToken": 1.5e-06,
+            "cacheWritePerToken": 1.875e-05
         },
         "gpt-5.6-sol": {
-            "inputPerToken": 0.000005,
-            "outputPerToken": 0.00003,
-            "cacheReadPerToken": 0.0000005
+            "inputPerToken": 5e-06,
+            "outputPerToken": 3e-05,
+            "cacheReadPerToken": 5e-07
         },
         "gpt-5.6-terra": {
-            "inputPerToken": 0.0000025,
-            "outputPerToken": 0.000015,
-            "cacheReadPerToken": 0.00000025
+            "inputPerToken": 2.5e-06,
+            "outputPerToken": 1.5e-05,
+            "cacheReadPerToken": 2.5e-07
         },
         "gpt-5.6-luna": {
-            "inputPerToken": 0.000001,
-            "outputPerToken": 0.000006,
-            "cacheReadPerToken": 0.0000001
+            "inputPerToken": 1e-06,
+            "outputPerToken": 6e-06,
+            "cacheReadPerToken": 1e-07
         },
         "gpt-5.5": {
-            "inputPerToken": 0.000005,
-            "outputPerToken": 0.00003,
-            "cacheReadPerToken": 0.0000005
+            "inputPerToken": 5e-06,
+            "outputPerToken": 3e-05,
+            "cacheReadPerToken": 5e-07
         },
         "gpt-5.4": {
-            "inputPerToken": 0.0000025,
-            "outputPerToken": 0.000015,
-            "cacheReadPerToken": 0.00000025
+            "inputPerToken": 2.5e-06,
+            "outputPerToken": 1.5e-05,
+            "cacheReadPerToken": 2.5e-07
         },
         "gpt-5.4-mini": {
-            "inputPerToken": 0.00000075,
-            "outputPerToken": 0.0000045,
-            "cacheReadPerToken": 0.000000075
+            "inputPerToken": 7.5e-07,
+            "outputPerToken": 4.5e-06,
+            "cacheReadPerToken": 7.5e-08
         },
         "gpt-5.4-nano": {
-            "inputPerToken": 0.0000002,
-            "outputPerToken": 0.00000125,
-            "cacheReadPerToken": 0.00000002
+            "inputPerToken": 2e-07,
+            "outputPerToken": 1.25e-06,
+            "cacheReadPerToken": 2e-08
         },
         "gpt-5": {
-            "inputPerToken": 0.00000125,
-            "outputPerToken": 0.00001,
-            "cacheReadPerToken": 0.000000125
+            "inputPerToken": 1.25e-06,
+            "outputPerToken": 1e-05,
+            "cacheReadPerToken": 1.25e-07
         },
         "gpt-4.1": {
-            "inputPerToken": 0.000002,
-            "outputPerToken": 0.000008,
-            "cacheReadPerToken": 0.0000005
+            "inputPerToken": 2e-06,
+            "outputPerToken": 8e-06,
+            "cacheReadPerToken": 5e-07
         },
         "gpt-4.1-mini": {
-            "inputPerToken": 0.0000004,
-            "outputPerToken": 0.0000016,
-            "cacheReadPerToken": 0.0000001
+            "inputPerToken": 4e-07,
+            "outputPerToken": 1.6e-06,
+            "cacheReadPerToken": 1e-07
         },
         "gpt-4.1-nano": {
-            "inputPerToken": 0.0000001,
-            "outputPerToken": 0.0000004,
-            "cacheReadPerToken": 0.000000025
+            "inputPerToken": 1e-07,
+            "outputPerToken": 4e-07,
+            "cacheReadPerToken": 2.5e-08
         },
         "gpt-4o": {
-            "inputPerToken": 0.0000025,
-            "outputPerToken": 0.00001,
-            "cacheReadPerToken": 0.00000125
+            "inputPerToken": 2.5e-06,
+            "outputPerToken": 1e-05,
+            "cacheReadPerToken": 1.25e-06
         },
         "gpt-4o-mini": {
-            "inputPerToken": 0.00000015,
-            "outputPerToken": 0.0000006,
-            "cacheReadPerToken": 0.000000075
+            "inputPerToken": 1.5e-07,
+            "outputPerToken": 6e-07,
+            "cacheReadPerToken": 7.5e-08
         },
         "o3": {
-            "inputPerToken": 0.000002,
-            "outputPerToken": 0.000008,
-            "cacheReadPerToken": 0.0000005
+            "inputPerToken": 2e-06,
+            "outputPerToken": 8e-06,
+            "cacheReadPerToken": 5e-07
         },
         "o4-mini": {
-            "inputPerToken": 0.0000011,
-            "outputPerToken": 0.0000044,
-            "cacheReadPerToken": 0.000000275
+            "inputPerToken": 1.1e-06,
+            "outputPerToken": 4.4e-06,
+            "cacheReadPerToken": 2.75e-07
         },
         "gemini-2.5-pro": {
-            "inputPerToken": 0.00000125,
-            "outputPerToken": 0.00001,
-            "cacheReadPerToken": 0.0000003125
+            "inputPerToken": 1.25e-06,
+            "outputPerToken": 1e-05,
+            "cacheReadPerToken": 3.125e-07
         },
         "gemini-2.5-flash": {
-            "inputPerToken": 0.0000003,
-            "outputPerToken": 0.0000025,
-            "cacheReadPerToken": 0.000000075
+            "inputPerToken": 3e-07,
+            "outputPerToken": 2.5e-06,
+            "cacheReadPerToken": 7.5e-08
         },
         "gemini-2.5-flash-lite": {
-            "inputPerToken": 0.0000001,
-            "outputPerToken": 0.0000004,
-            "cacheReadPerToken": 0.000000025
+            "inputPerToken": 1e-07,
+            "outputPerToken": 4e-07,
+            "cacheReadPerToken": 2.5e-08
         },
         "gemini-1.5-pro": {
-            "inputPerToken": 0.00000125,
-            "outputPerToken": 0.000005,
-            "cacheReadPerToken": 0.0000003125
+            "inputPerToken": 1.25e-06,
+            "outputPerToken": 5e-06,
+            "cacheReadPerToken": 3.125e-07
         },
         "gemini-1.5-flash": {
-            "inputPerToken": 0.000000075,
-            "outputPerToken": 0.0000003,
-            "cacheReadPerToken": 0.00000001875
+            "inputPerToken": 7.5e-08,
+            "outputPerToken": 3e-07,
+            "cacheReadPerToken": 1.875e-08
+        },
+        "muse-spark-1.2": {
+            "inputPerToken": 1.25e-06,
+            "outputPerToken": 4.25e-06,
+            "cacheReadPerToken": 1.5e-07
+        },
+        "muse-spark-1.1": {
+            "inputPerToken": 1.25e-06,
+            "outputPerToken": 4.25e-06,
+            "cacheReadPerToken": 1.5e-07
+        },
+        "muse-spark-1.2-contributor": {
+            "inputPerToken": 1e-07,
+            "outputPerToken": 2e-07,
+            "cacheReadPerToken": 2e-09
         }
     }
 }

package/dist/lib/pricing/table.js

@@ -5,6 +5,19 @@
  * and is imported with a `type: json` attribute so it survives `tsc` emit AND
  * Node ESM's import-attribute requirement at runtime (the package is ESM).
  *
+ * ## Keeping it current
+ *
+ * A model missing from `prices.json` prices to NOTHING — `getModelPricing` returns
+ * null and the session contributes $0, silently. That is how 478 `claude-opus-5`
+ * sessions read as free: matching is dash-bounded, so `claude-opus-5` cannot fall back
+ * to the `claude-opus-4` entry. When a new model ships, add it here in the same change.
+ *
+ * **Dated rate: Claude Sonnet 5 is priced at its introductory $2/$10 per MTok, which
+ * ends 2026-08-31.** From 2026-09-01 the standard rate is $3/$15 (cache write $3.75,
+ * cache read $0.30). This table has no notion of an effective date — every row is a
+ * single current rate — so that entry MUST be updated then, or Sonnet 5 spend will
+ * read ~33% low. Source: https://platform.claude.com/docs/en/about-claude/pricing
+ *
  * `getModelPricing` is prefix/suffix-tolerant: real model identifiers carry
  * vendor prefixes (`us.anthropic.`), version dashes (`claude-opus-4-8`), and
  * date suffixes (`-20250514`), none of which appear in the canonical keys. We

package/dist/lib/remote-agents-json.d.ts

@@ -12,6 +12,34 @@ export interface RemoteAgentsJsonOptions<T> {
     quiet?: boolean;
     /** Per-peer deadline. Long-running maintenance commands override 12 seconds. */
     timeoutMs?: number;
+    /**
+     * Opt-in early-exit for a globally-unique lookup (a full session UUID). When a
+     * peer returns an item that satisfies {@link isDefinitive}, the fan-out
+     * resolves immediately and SIGTERMs every still-outstanding peer instead of
+     * waiting for the slowest one to hit {@link REMOTE_TIMEOUT_MS}.
+     *
+     * OMITTED BY DEFAULT — tool-search, program-count, and the default session
+     * listing keep the all-settle behavior (ambiguity, or a label/prefix conflict,
+     * is only known once every peer has answered). Only the full-UUID resolve path
+     * opts in, since only a UUID guarantees the first hit is the only hit.
+     */
+    earlyExit?: {
+        isDefinitive: (item: T, machine: string) => boolean;
+    };
+}
+/**
+ * The SSH boundary as a swappable dependency so the fan-out logic is testable
+ * without a live tailnet. Production wires this to the real {@link sshCapture}.
+ */
+export type SshCaptureFn = (target: string, remoteCmd: string, opts: {
+    timeoutMs: number;
+    signal?: AbortSignal;
+}) => Promise<{
+    code: number | null;
+    stdout: string;
+}>;
+export interface GatherRemoteAgentsJsonDeps {
+    capture?: SshCaptureFn;
 }
 export interface RemoteAgentsJsonParseResult<T> {
     items: T[];
@@ -35,4 +63,4 @@ export declare function parseRemoteAgentsJsonPayload<T>(stdout: string, machine:
 /** Build the command one peer runs, with a guard that prevents recursive fan-out. */
 export declare function remoteAgentsJsonCommand(args: string[], noFanoutEnv: string, os?: string): string;
 /** Query explicit hosts, or every registered online peer when hosts is omitted. */
-export declare function gatherRemoteAgentsJson<T>(options: RemoteAgentsJsonOptions<T>): Promise<RemoteAgentsJsonResult<T>>;
+export declare function gatherRemoteAgentsJson<T>(options: RemoteAgentsJsonOptions<T>, deps?: GatherRemoteAgentsJsonDeps): Promise<RemoteAgentsJsonResult<T>>;

package/dist/lib/remote-agents-json.js

@@ -7,6 +7,7 @@
  * healthy results from the rest of the fleet.
  */
 import { spawn } from 'child_process';
+import { setMaxListeners } from 'node:events';
 import chalk from 'chalk';
 import { SSH_OPTS, controlOpts, assertValidSshTarget, shellQuote } from './ssh-exec.js';
 import { sshTargetFor } from './devices/connect.js';
@@ -32,9 +33,13 @@ export function remoteAgentsJsonCommand(args, noFanoutEnv, os) {
     const inner = `${noFanoutEnv}=1 agents ${args.map(shellQuote).join(' ')}`;
     return `bash -lc ${shellQuote(inner)}`;
 }
-function sshCapture(target, remoteCmd, timeoutMs) {
+const sshCapture = (target, remoteCmd, { timeoutMs, signal }) => {
     assertValidSshTarget(target);
     return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve({ code: null, stdout: '' });
+            return;
+        }
         const args = [...SSH_OPTS, ...controlOpts(), target, remoteCmd];
         const child = spawn('ssh', args, { stdio: ['ignore', 'pipe', 'ignore'] });
         let stdout = '';
@@ -44,19 +49,25 @@ function sshCapture(target, remoteCmd, timeoutMs) {
                 return;
             settled = true;
             clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
             resolve({ code, stdout });
         };
         const timer = setTimeout(() => {
             child.kill('SIGKILL');
             done(null);
         }, timeoutMs);
+        // A definitive hit on a fast peer cancels the rest: SIGTERM the child so an
+        // unreachable peer is not left running to its full timeout.
+        const onAbort = () => { child.kill('SIGTERM'); done(null); };
+        signal?.addEventListener('abort', onAbort, { once: true });
         child.stdout.on('data', (data) => { stdout += data.toString(); });
         child.on('error', () => done(null));
         child.on('close', (code) => done(code));
     });
-}
+};
 /** Query explicit hosts, or every registered online peer when hosts is omitted. */
-export async function gatherRemoteAgentsJson(options) {
+export async function gatherRemoteAgentsJson(options, deps = {}) {
+    const capture = deps.capture ?? sshCapture;
     const self = machineId();
     const targets = [];
     if (options.hosts && options.hosts.length > 0) {
@@ -100,24 +111,50 @@ export async function gatherRemoteAgentsJson(options) {
     }
     const skipped = [];
     const parseFailed = [];
+    // The controller exists ONLY for early-exit: the first definitive hit aborts
+    // every still-outstanding peer. When earlyExit is not requested there is no
+    // controller and no per-peer abort listener, so the default path is a plain
+    // all-settle Promise.all, byte-identical to before (tool-search, program-count).
+    const controller = options.earlyExit ? new AbortController() : undefined;
+    // A fleet can hold more peers than Node's default 10-listener cap; each peer's
+    // capture adds one abort listener, so lift the cap to avoid a spurious warning.
+    if (controller)
+        setMaxListeners(targets.length + 1, controller.signal);
+    let earlyResolved = false;
     const results = await Promise.all(targets.map(async (target) => {
         const command = remoteAgentsJsonCommand(options.args, options.noFanoutEnv, target.os);
-        const result = await sshCapture(target.target, command, options.timeoutMs ?? REMOTE_TIMEOUT_MS);
+        const result = await capture(target.target, command, {
+            timeoutMs: options.timeoutMs ?? REMOTE_TIMEOUT_MS,
+            signal: controller?.signal,
+        });
+        // A peer we deliberately cancelled is neither a hit nor a failure — it never
+        // got to answer, so it must not pollute skipped/parseFailed (which drive the
+        // "unreachable" listing and the fail-closed partial-resolution gate).
+        const cancelled = controller?.signal.aborted ?? false;
         if (result.code !== 0) {
-            skipped.push(target.name);
-            if (!options.quiet) {
-                process.stderr.write(chalk.gray(`  ${target.name}: unreachable or no agents CLI — skipped\n`));
+            if (!cancelled) {
+                skipped.push(target.name);
+                if (!options.quiet) {
+                    process.stderr.write(chalk.gray(`  ${target.name}: unreachable or no agents CLI — skipped\n`));
+                }
             }
             return [];
         }
         const parsed = parseRemoteAgentsJsonPayload(result.stdout, target.machine, options.parse);
         if (parsed.parseFailed) {
-            parseFailed.push(target.name);
-            if (!options.quiet) {
-                process.stderr.write(chalk.gray(`  ${target.name}: unreachable or no agents CLI — skipped\n`));
+            if (!cancelled) {
+                parseFailed.push(target.name);
+                if (!options.quiet) {
+                    process.stderr.write(chalk.gray(`  ${target.name}: unreachable or no agents CLI — skipped\n`));
+                }
             }
             return [];
         }
+        if (controller && options.earlyExit && !earlyResolved
+            && parsed.items.some((item) => options.earlyExit.isDefinitive(item, target.machine))) {
+            earlyResolved = true;
+            controller.abort(); // SIGTERM the remaining peers; they settle fast below.
+        }
         return parsed.items;
     }));
     return { items: results.flat(), deviceCount: targets.length, skipped, parseFailed, discoveryFailed: false };

package/dist/lib/resources/mcp.js

@@ -127,6 +127,8 @@ export function getMcpConfigPath(agent, versionHome) {
         case 'pi':
             // omp reads user-scope MCP from ~/.omp/agent/.mcp.json (Claude schema).
             return path.join(versionHome, '.omp', 'agent', '.mcp.json');
+        case 'muse':
+            return path.join(versionHome, '.config', 'muse', 'settings.json');
         default:
             return null;
     }

package/dist/lib/resources/permissions.js

@@ -81,6 +81,9 @@ function getAgentConfigPath(agent, versionHome) {
             return path.join(versionHome, '.hermes', 'config.yaml');
         case 'goose':
             return path.join(versionHome, '.config', 'goose', 'permission.yaml');
+        case 'muse':
+            // Muse approval defaults live in settings.json; no separate permissions file.
+            return path.join(versionHome, '.config', 'muse', 'settings.json');
         default:
             return null;
     }

package/dist/lib/resources/types.d.ts

@@ -5,7 +5,8 @@
  * - Union: All resources from all layers are combined
  * - Override on name conflict: Higher layer wins (project > user > system)
  */
-export type AgentId = 'claude' | 'codex' | 'gemini' | 'cursor' | 'opencode' | 'openclaw' | 'copilot' | 'kiro' | 'goose' | 'antigravity' | 'grok' | 'kimi' | 'droid' | 'hermes' | 'pi';
+import type { AgentId } from '../types.js';
+export type { AgentId };
 /** Resource origin. Precedence (highest first): project > user > plugin > system. */
 export type Layer = 'system' | 'user' | 'project' | 'plugin';
 export type ResourceKind = 'command' | 'hook' | 'skill' | 'rule' | 'mcp' | 'permission' | 'subagent' | 'workflow' | 'memory';