@phnx-labs/agents-cli 1.22.22 → 1.22.24

package/dist/lib/menubar/install-menubar.js

@@ -468,6 +468,115 @@ export function disableMenubarService() {
     }
     catch { /* best effort */ }
 }
+/**
+ * Which install is allowed to (re)install the shared helper.
+ *
+ * The helper lives at ONE path in Application Support, but any number of
+ * agents-cli copies can be present on a box and every one of them runs the
+ * startup self-heal. The version stamp and the plist's baked `AGENTS_ENTRY` each
+ * record whichever copy acted last, so without an ownership rule every copy
+ * reads the others' marks as drift and recopies the bundle over them. Recopying
+ * replaces the executable under the live helper and kills it; launchd
+ * `KeepAlive` restarts it; the next copy repeats it. Measured on one box: a new
+ * pid every 5-15s, 578 launches in the helper's log, a status item that never
+ * stayed visible, and `agents menubar status` still reporting `running: yes`
+ * because a pid always existed (#2109).
+ *
+ * There is deliberately NO content comparison here. Comparing the shipped helper
+ * against the installed one cannot distinguish "real upgrade" from "another
+ * install's copy": the helper is rebuilt, re-signed and re-notarized on every
+ * release (`menubar/scripts/build.sh` via `release.sh`), so consecutive releases
+ * ship byte-different bundles from identical Swift source — 1.22.20/21/22 all
+ * have the same 2876288-byte executable and three different sha256s AND three
+ * different CDHashes. Any digest gate therefore reports "changed" for exactly
+ * the skew case it was meant to exempt.
+ *
+ * So ownership decides instead: the plist's `AGENTS_ENTRY` names the owner, and
+ * only the owner may reinstall. A non-owner takes over only once the recorded
+ * owner is gone from disk, which is what makes the rule converge — a dead
+ * install cannot hold the helper hostage, and a live one cannot be fought over.
+ * A same-install upgrade keeps its entry path, so `npm update` still installs
+ * the new helper normally. Pure so the truth table is unit-testable.
+ */
+export function mayInstallMenubarHelper(opts) {
+    // Repairs are never gated: a missing binary or a broken signing identity leaves
+    // the menu bar dead or re-prompting for Accessibility, and no other install can
+    // be "fighting" for a bundle that isn't there. Blocking these behind ownership
+    // is what turned the first version of this gate into a silent stuck state.
+    if (opts.helperExecMissing || opts.needsDevIdHeal)
+        return true;
+    // Can't resolve which install we are (a dev/tsx run) — never churn the plist.
+    if (!opts.activeEntry)
+        return false;
+    // No owner recorded yet (fresh or pre-`AGENTS_ENTRY` plist) — adopt it.
+    if (!opts.plistEntry)
+        return true;
+    if (opts.plistEntry === opts.activeEntry)
+        return true; // we are the owner
+    if (!opts.ownerEntryExists)
+        return true; // the recorded owner is gone
+    // A foreign install while the owner still exists. Refusing outright bounds the
+    // loop but strands the user when the recorded owner is a stale copy that simply
+    // still sits on disk (an old nvm node dir) while their daily driver upgrades:
+    // that install would never heal again. So it may take over, but only once per
+    // cooldown — which turns an every-invocation storm into at most one restart per
+    // cooldown while keeping every install able to make progress.
+    //
+    // Except an ad-hoc/dev-signed copy, which never seizes a healthy helper on a
+    // timer. `scripts/install.sh` deliberately puts a dev build beside the npm
+    // global, and its bundle cannot be notarized; letting it win the timed takeover
+    // would recopy an ad-hoc bundle over a good Developer-ID one, and Gatekeeper
+    // then rejects the result as "damaged" and AppKit crashes at launch (RUSH-2134)
+    // — trading a cosmetic loop for a broken menu bar. It can still take over when
+    // the owner is genuinely gone (above), which is the case that must not deadlock.
+    if (!opts.sourceIsDeveloperId)
+        return false;
+    return opts.msSinceLastHeal === null || opts.msSinceLastHeal >= opts.cooldownMs;
+}
+/**
+ * How long a non-owner install waits before it may take the helper over. Long
+ * enough that a multi-install box restarts the helper at most once an hour
+ * instead of every few seconds; short enough that a user who switched installs
+ * gets their upgrade without hunting for `agents menubar setup`.
+ */
+const MENUBAR_TAKEOVER_COOLDOWN_MS = 60 * 60 * 1000;
+/** Timestamp of the last self-heal reinstall, next to the version stamp. */
+function lastHealMarkerPath() {
+    return path.join(installDir(), '.menubar-last-heal');
+}
+function msSinceLastMenubarHeal() {
+    try {
+        const t = Number(fs.readFileSync(lastHealMarkerPath(), 'utf-8').trim());
+        if (!Number.isFinite(t))
+            return null;
+        return Math.max(0, Date.now() - t);
+    }
+    catch {
+        return null;
+    }
+}
+function stampMenubarHeal() {
+    try {
+        fs.mkdirSync(installDir(), { recursive: true });
+        fs.writeFileSync(lastHealMarkerPath(), String(Date.now()));
+    }
+    catch { /* best effort */ }
+}
+/** Whether this install may (re)install the helper (see `mayInstallMenubarHelper`). */
+function mayHealMenubar(needsDevIdHeal) {
+    const plistEntry = readPlistEnvValue('AGENTS_ENTRY');
+    const src = sourceAppPath();
+    return mayInstallMenubarHelper({
+        plistEntry,
+        activeEntry: resolveCliEntry(),
+        ownerEntryExists: Boolean(plistEntry) && fs.existsSync(plistEntry),
+        helperExecMissing: !fs.existsSync(installedExecutablePath()),
+        needsDevIdHeal,
+        msSinceLastHeal: msSinceLastMenubarHeal(),
+        cooldownMs: MENUBAR_TAKEOVER_COOLDOWN_MS,
+        sourceIsDeveloperId: Boolean(src) && hasDeveloperIdSignature(src),
+    });
+}
 /**
  * Startup self-heal, run on every darwin CLI invocation (see src/index.ts).
  * No-ops cheaply (a couple of existsSync + a tiny file read) unless work is
@@ -478,8 +587,10 @@ export function disableMenubarService() {
  *
  * Without the staleness re-enable, `npm update` refreshed the CLI but left the
  * menu bar running the previous release's helper binary on a possibly-stale
- * plist. No-ops if: not darwin, the user opted out, or no helper bundle ships.
- * Best-effort — never throws into startup.
+ * plist. Everything past the ownership gate is unchanged; the gate is what stops
+ * coexisting installs reinstalling over each other forever (#2109). No-ops if:
+ * not darwin, the user opted out, or no helper bundle ships. Best-effort — never
+ * throws into startup.
  */
 export function installMenubarLaunchAgentOnUpgrade() {
     try {
@@ -495,12 +606,23 @@ export function installMenubarLaunchAgentOnUpgrade() {
         }
         // Re-enable (recopy helper + rewrite plist) when the version drifted OR the
         // plist's baked interpreter/entry no longer point at the install now running
-        // `agents` — the dual-install skew a version bump alone can't catch — OR the
+        // `agents` — e.g. the owner moved between node interpreters — OR the
         // installed copy is still ad-hoc while the shipped source is Developer ID
         // (older heal path; Accessibility re-prompts until the identity is restored).
-        if (menubarSetupStale() || menubarSetupNeedsRepoint() || installedNeedsDevIdHeal()) {
-            enableMenubarService({ clearOptOut: false });
-        }
+        const needsDevIdHeal = installedNeedsDevIdHeal();
+        if (!(menubarSetupStale() || menubarSetupNeedsRepoint() || needsDevIdHeal))
+            return;
+        // ...but a copy that does not own the helper only gets to act on that drift
+        // once per cooldown. Without the gate every coexisting install recopies the
+        // bundle on every invocation, killing the live helper on a loop (#2109).
+        if (!mayHealMenubar(needsDevIdHeal))
+            return;
+        // Stamp only a heal that actually happened. `enableMenubarService` returns
+        // false without installing when the bundle fails the Gatekeeper check, and
+        // stamping first would spend the shared cooldown on a no-op — locking every
+        // non-owner out for another hour while nothing had been fixed.
+        if (enableMenubarService({ clearOptOut: false }))
+            stampMenubarHeal();
     }
     catch {
         /* never block startup on the menu bar */

package/dist/lib/models.d.ts

@@ -97,11 +97,6 @@ export declare function parseGrokModelsStdout(stdout: string): {
     models: ModelInfo[];
     aliases: Record<string, string>;
 };
-/**
- * Build (or load from cache) the model catalog for a specific (agent, version).
- * Cache is keyed on source-file mtime (binary or js module), so re-extracts
- * automatically when the user upgrades or reinstalls a version.
- */
 export declare function getModelCatalog(agent: AgentId, version: string): ModelCatalog | null;
 /** The result of resolving a user-supplied model string against the catalog. */
 export interface ResolvedModel {

package/dist/lib/models.js

@@ -246,6 +246,16 @@ export function locateModelSource(agent, version) {
             return { path: pathBin, kind: 'cli' };
         return null;
     }
+    if (agent === 'muse') {
+        // Muse Code is a self-updating native binary on PATH. It has no catalog
+        // CLI; the published model IDs are fixed by Meta Model API docs. Point at
+        // the binary so the cache key moves with upgrades, and extract a static
+        // catalog in getModelCatalog.
+        const pathBin = findOnPath('muse');
+        if (pathBin)
+            return { path: pathBin, kind: 'cli' };
+        return null;
+    }
     return null;
 }
 /** Real Grok binaries are ~100MB+; failed-download stubs are tens of bytes. */
@@ -973,6 +983,36 @@ function extractPiCatalog(binaryPath) {
  * Cache is keyed on source-file mtime (binary or js module), so re-extracts
  * automatically when the user upgrades or reinstalls a version.
  */
+/**
+ * Static Muse Spark catalog. Meta Model API publishes these IDs; Muse Code
+ * has no `muse models` command. Default is muse-spark-1.2 (docs + first-run).
+ * Source: https://dev.meta.ai/docs/pricing-rate-limits and muse-code overview.
+ */
+function extractMuseCatalog() {
+    const models = [
+        {
+            id: 'muse-spark-1.2',
+            displayName: 'Muse Spark 1.2',
+            isDefault: true,
+        },
+        {
+            id: 'muse-spark-1.1',
+            displayName: 'Muse Spark 1.1',
+        },
+        {
+            id: 'muse-spark-1.2-contributor',
+            displayName: 'Muse Spark 1.2 Contributor',
+        },
+    ];
+    const aliases = {
+        spark: 'muse-spark-1.2',
+        'spark-1.2': 'muse-spark-1.2',
+        'spark-1.1': 'muse-spark-1.1',
+        contributor: 'muse-spark-1.2-contributor',
+        default: 'muse-spark-1.2',
+    };
+    return { models, aliases };
+}
 export function getModelCatalog(agent, version) {
     const src = locateModelSource(agent, version);
     if (!src)
@@ -1027,6 +1067,8 @@ export function getModelCatalog(agent, version) {
             ({ models, aliases } = extractGrokCatalog(src.path));
         else if (agent === 'pi')
             ({ models, aliases } = extractPiCatalog(src.path));
+        else if (agent === 'muse')
+            ({ models, aliases } = extractMuseCatalog());
     }
     // Attach per-token pricing where the offline table knows the model, so the
     // catalog carries $/token for the tier display and budgeting. Subscription /
@@ -1237,5 +1279,11 @@ export function buildReasoningFlags(agent, level) {
         const grokLevel = (normalized === 'xhigh' || normalized === 'max') ? 'high' : normalized;
         return ['--reasoning-effort', grokLevel];
     }
+    if (agent === 'muse') {
+        // Muse Code: `--reasoning-effort none|minimal|low|medium|high|xhigh|ultra`.
+        // Map our unified `max` to Muse's `ultra` (client-side multi-agent aggression).
+        const museLevel = normalized === 'max' ? 'ultra' : normalized;
+        return ['--reasoning-effort', museLevel];
+    }
     return [];
 }

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/refresh.d.ts

@@ -17,6 +17,11 @@ export interface RefreshOptions {
     skipPrompts?: boolean;
     /** Skip CLI version install/upgrade from agents.yaml. */
     skipClis?: boolean;
+    /**
+     * Suppress human progress lines on stdout. Required for machine consumers
+     * (`agents sync --json` / fleet fan-out) so stdout stays a single JSON object.
+     */
+    quiet?: boolean;
 }
 /**
  * Re-materialize local state from declared configuration: install CLI versions,