@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/commands/memory.js

@@ -1,9 +1,3 @@
-/**
- * `agents memory` — first-class knowledge/facts resource (not rules).
- *
- * Mirrors the skills surface at list / add / remove / view / sync scale.
- * Canonical storage: ~/.agents/memory/ (project > user > system layering).
- */
 import { withAliases } from '../lib/verbs.js';
 import chalk from 'chalk';
 import * as fs from 'fs';
@@ -13,7 +7,6 @@ import { ALL_AGENT_IDS } from '../lib/agents.js';
 import { listInstalledVersions, getVersionHomePath, } from '../lib/installations/versions.js';
 import { supports } from '../lib/capabilities.js';
 import { setHelpSections } from '../lib/help.js';
-/** Register the `agents memory` command tree. */
 export function registerMemoryCommands(program) {
     const memoryCmd = program
         .command('memory')

package/dist/commands/menubar.d.ts

@@ -1,10 +1,2 @@
-/**
- * `agents menubar` — manage the macOS menu-bar helper.
- *
- * The helper is a no-Dock status-bar app that surfaces running sessions, agents
- * needing input, and routines, and launches new sessions. It auto-installs on
- * upgrade (runMigration -> installMenubarLaunchAgentOnUpgrade) for every macOS
- * user; these commands are the manual override.
- */
 import type { Command } from 'commander';
 export declare function registerMenubarCommands(program: Command): void;

package/dist/commands/menubar.js

@@ -1,11 +1,3 @@
-/**
- * `agents menubar` — manage the macOS menu-bar helper.
- *
- * The helper is a no-Dock status-bar app that surfaces running sessions, agents
- * needing input, and routines, and launches new sessions. It auto-installs on
- * upgrade (runMigration -> installMenubarLaunchAgentOnUpgrade) for every macOS
- * user; these commands are the manual override.
- */
 import chalk from 'chalk';
 import { setHelpSections } from '../lib/help.js';
 import { enableMenubarService, disableMenubarService, getMenubarStatus, runMenubarSetup, buildMenubarDoctorReport, } from '../lib/menubar/install-menubar.js';
@@ -16,7 +8,6 @@ function notMac() {
     }
     return false;
 }
-/** Shared status readout — `status`, bare `menubar`, and `setup --check` all end here. */
 function printStatus(s, opts = {}) {
     const yn = (b) => (b ? chalk.green('yes') : chalk.gray('no'));
     console.log(chalk.bold('AGI Menu\n'));
@@ -35,8 +26,6 @@ function printStatus(s, opts = {}) {
         : chalk.yellow(`not fetched yet — the background sync downloads ${s.currentVersion}; \`agents menubar setup\` fetches it now`);
     console.log(`  bundle source      ${s.source ? chalk.gray(s.source) : pendingSource}`);
     console.log(`  disabled by user   ${yn(s.disabledByUser)}`);
-    // Two copies of the INSTALLED bundle is the duplicate the user sees as two
-    // agents marks in the menu bar. It used to read as a healthy `running: yes`.
     if (s.instances.length > 1) {
         console.log(chalk.yellow(`\n  ${s.instances.length} copies of AGI Menu are running — that is the duplicate menu-bar icon:`));
         for (const p of s.instances)
@@ -44,10 +33,6 @@ function printStatus(s, opts = {}) {
         console.log(chalk.gray('  Fix it with `agents menubar setup`.'));
     }
     if (s.foreignInstances.length > 0) {
-        // RegisterEventHotKey is first-come, so the helper that registered the
-        // chord first owns Cmd-Shift-V/O. A process list cannot say which that
-        // was — only that a rival exists — so report the conflict, not a winner.
-        // The loser has no other symptom: its chords simply never fire.
         const n = s.foreignInstances.length;
         console.log(chalk.yellow(`\n  ${n} other AGI Menu process${n === 1 ? '' : 'es'} running — ${n === 1 ? 'it' : 'they'} may hold Cmd-Shift-V/O instead of the installed one:`));
         for (const p of s.foreignInstances)
@@ -55,11 +40,6 @@ function printStatus(s, opts = {}) {
         console.log(chalk.gray('  End them with `agents menubar setup`.'));
     }
     if (s.stale) {
-        // Not "runs on next startup": the self-heal only reinstalls from the install
-        // that owns the helper, or from another one once the takeover cooldown has
-        // passed (mayInstallMenubarHelper) — so on a box with several agents-cli
-        // copies this can persist for a while. `setup` bypasses the gate and is the
-        // immediate fix.
         console.log(chalk.yellow('\n  Installed AGI Menu is stale — `agents menubar setup` updates it now.'));
     }
     else if (!s.serviceInstalled && !s.disabledByUser) {
@@ -112,9 +92,6 @@ export function registerMenubarCommands(program) {
     const menubar = program
         .command('menubar')
         .description('Manage AGI Menu (running sessions, agents awaiting input, routines)');
-    // `setup` is the one command that gets a machine to the intended state:
-    // exactly one status item, started at login. `enable` stays the narrow
-    // install+start; setup adds duplicate cleanup and verifies the end state.
     const setup = menubar
         .command('setup')
         .description('Configure AGI Menu end-to-end: one instance, started at login')
@@ -253,7 +230,6 @@ export function registerMenubarCommands(program) {
       anything this flags.
     `,
     });
-    // Bare `agents menubar` -> status.
     menubar.action(() => {
         const s = getMenubarStatus();
         if (s.platform !== 'darwin') {

package/dist/commands/message.d.ts

@@ -1,25 +1,2 @@
-/**
- * `agents message <target> <text>` — send a message to a running or parked agent.
- *
- * Delivery is routed by agent state (RUSH-1474):
- *   - running, between tool calls → mailbox spool (PreToolUse inject)
- *   - parked on AskUserQuestion with a tmux/iterm rail → keystroke inject
- *   - parked headless (no rail) → `agents run --resume <id> -- <answer>`
- *   - cloud task → provider.message()
- *
- * Cross-host is handled one layer up: `--device <h>` routes the whole command over
- * ssh via `REMOTE_PASSTHROUGH` (see src/lib/hosts/passthrough.ts), so the box is
- * written on the host that actually owns the agent. A caller who doesn't already
- * know the host (a detached `agents run --device <h> --no-follow` dispatch) is
- * still resolved automatically: a `target` matching no local/cloud session falls
- * through to the `~/.agents/.cache/hosts/` records `agents devices ps` reads
- * (RUSH-2366 follow-up — see decideHostTaskRoute in lib/mailbox-target.ts), and
- * the message is rerouted there.
- *
- * For local agents, the message is tied to the agent's current open feed block
- * (if any). The first answer to a block wins: a second concurrent answer is
- * rejected with the surface that already answered. Delivery receipts
- * (queued → consumed → continued) are surfaced in the feed store.
- */
 import type { Command } from 'commander';
 export declare function registerMessageCommand(program: Command): void;

package/dist/commands/message.js

@@ -15,27 +15,19 @@ import { verifyOperatorIdentity } from '../lib/operator.js';
 import { resolveAnswerRoute, resumeArgv, } from '../lib/answer-router.js';
 import { injectIntoTerminal } from '../lib/terminal/index.js';
 import { setHelpSections } from '../lib/help.js';
-/** Find the still-open block addressed to `mailboxId`, if any. */
 function findOpenBlockForMailbox(mailboxId) {
-    // Fast path: the mailbox id is usually the session id, so the block id is
-    // directly derivable. This avoids scanning the whole feed store.
     const direct = readBlock(blockIdForSession(mailboxId));
     if (direct && direct.mailboxId === mailboxId)
         return direct;
-    // Fallback: scan (agentId-based mailbox ids, rare).
     return listBlocks().find((b) => b.mailboxId === mailboxId);
 }
-/** Live session whose mailbox id equals `mailboxId`. */
 function findSessionForMailbox(mailboxId, sessions) {
     return sessions.find((s) => mailboxIdForActiveSession(s) === mailboxId);
 }
-/** Claim first-answer-wins on the open block; dies if already answered / unauthorized. */
 function claimBlockAnswer(block, opts) {
     if (!block)
         return;
     const operatorId = opts.as;
-    // High-consequence answers require env-proven identity (AGENTS_OPERATOR_ID),
-    // not merely a caller-supplied known --as id (RUSH-1619).
     const verified = verifyOperatorIdentity(operatorId);
     const claim = recordAnswer(block.blockId, {
         answeredBy: opts.from,
@@ -79,9 +71,7 @@ async function deliverViaInject(route, mailboxId) {
         die(`Internal error: inject route missing target/payload for ${mailboxId}.`);
     }
     const result = await injectIntoTerminal(route.inject, route.payload, {
-        // Digit selection and free text both need Enter to submit the TUI choice.
         enter: true,
-        // Digit+Enter as two writes is safer for Ink TUI.
         combined: false,
     });
     if (!result.ok) {
@@ -95,10 +85,6 @@ async function deliverViaResume(route, mailboxId) {
         die(`Internal error: resume route incomplete for ${mailboxId}.`);
     }
     const argv = resumeArgv(route);
-    // Relaunch the same agents CLI (via getAgentsInvocation, which resolves the
-    // real binary — not a bun /$bunfs virtual path under the compiled build) so
-    // version pins and wrappers stay consistent. Detach so the resume can take
-    // over a TTY when interactive; for feed answers we pass it non-interactively.
     const inv = getAgentsInvocation(argv);
     const child = spawn(inv.command, inv.args, {
         stdio: 'inherit',
@@ -114,19 +100,6 @@ async function deliverViaResume(route, mailboxId) {
     console.log(chalk.green(`Resumed ${mailboxId} with answer. `) +
         chalk.dim(route.reason));
 }
-/**
- * Reroute a message to a detached `agents run --device <host> --no-follow`
- * dispatch (RUSH-2366 follow-up). `getActiveSessions()` never sees these: the
- * live process is on the dispatch's host, not this machine, so the local
- * session resolver in `resolveMessageTarget` reports "no running agent" even
- * while `agents devices ps` shows the same dispatch running with a live remote
- * pid — the only recovery was kill-and-redispatch, losing all context.
- *
- * Re-spawns `agents message <remoteRef> <text> --device <host>` through
- * `getAgentsInvocation`, so it re-enters via the SAME `--device` REMOTE_PASSTHROUGH
- * choke point (`lib/hosts/passthrough.ts`) any explicit `--device` caller uses,
- * and resolves against the remote box's own active sessions.
- */
 async function deliverViaHostReroute(route, text, opts) {
     const argv = ['message', route.remoteRef, text, '--device', route.host];
     if (opts.from)
@@ -148,13 +121,6 @@ async function deliverViaHostReroute(route, text, opts) {
             `Tried: agents ${argv.join(' ')}`);
     }
 }
-/**
- * `message` is the agent-control plane (RUSH-2123): the answer/keystroke/
- * injected input a running agent consumes, never a notification a human reads.
- * Mirrors SHARED_NOTES in commands/send.ts so an agent reading either --help
- * sees the same three-plane map and doesn't reach for `message` when it means
- * `send`.
- */
 const CONTROL_PLANE_NOTES = `
   Planes (do not mix them up):
     message / sessions inject  - CONTROL a running agent (mailbox answer, terminal keystroke, or resume by runtime)
@@ -216,7 +182,6 @@ export function registerMessageCommand(program) {
                     if (route.kind === 'refuse') {
                         die(route.reason);
                     }
-                    // First-answer-wins for any path that closes an open block.
                     claimBlockAnswer(block, opts);
                     if (route.kind === 'mailbox') {
                         await deliverViaMailbox(res.id, text, block, { from: opts.from, ttlSeconds });
@@ -251,12 +216,6 @@ export function registerMessageCommand(program) {
                 return;
             }
             case 'none': {
-                // RUSH-2384: a live local process can still advertise `--session-id
-                // <target>` in its argv when getActiveSessions lost the row (empty
-                // by-pid registry, teams status flap, fold into a parent). Mailbox
-                // delivery only needs the id — prove liveness from the process table
-                // before giving up, so a mid-run agent is never unreachable while
-                // its pid is alive.
                 if (await isSessionIdLiveOnProcessTable(target)) {
                     try {
                         const block = findOpenBlockForMailbox(target);
@@ -282,15 +241,6 @@ export function registerMessageCommand(program) {
                     }
                     return;
                 }
-                // Not a local/cloud session — check whether it's a detached
-                // `--device ... --no-follow` dispatch, which `getActiveSessions()`
-                // never sees (its live process is on another host). Same records
-                // `agents devices ps` reads, so the two commands never disagree.
-                // Heal first, exactly as `agents devices stop`/`agents devices ps` do: a detached
-                // dispatch record never self-updates, so a finished run is still
-                // stamped `status:'running'` on disk. Without this we'd route a dead
-                // task through an SSH reroute that can only fail, instead of
-                // reporting it finished here.
                 const onDisk = resolveTaskRef(target);
                 const hostRoute = decideHostTaskRoute(onDisk ? reconcileRunningTasks([onDisk])[0] : null, target);
                 if (hostRoute.kind === 'reroute') {

package/dist/commands/mine.d.ts

@@ -1,30 +1,8 @@
-/**
- * `agents mine` helpers — white-label the CLI under your own name.
- *
- * `agents setup mine init <name>` mints a personally-named binary (e.g. `jack`) that
- * IS agents-cli: a pure pass-through shim on PATH that runs every `agents` verb
- * under the brand's name, with the brand's disabled commands and curated
- * resource profile applied. Manage verbs live under `agents setup mine`
- * (`list` / `toggle` / `remove`); the bare `agents setup mine` wizard is the
- * discoverable entry point (see setup-mine.ts).
- *
- * Storage: brand config in `meta.brands` (agents.yaml); the curated resource set
- * reuses the resource-profile engine — each brand owns a preset named
- * `mine-<name>` in `meta.profiles.presets`. See lib/brand.ts.
- */
 import type { Command } from 'commander';
-/**
- * Create (or re-mint) a brand. Shared by `setup mine init` and the `setup mine`
- * wizard. Writes the shim, the brand config, and an empty resource preset.
- */
 export declare function initBrand(name: string, opts?: {
     disabledCommands?: string[];
     force?: boolean;
 }): {
     pathWarning: boolean;
 };
-/**
- * Register brand manage verbs (`init`/`list`/`toggle`/`remove`) under a parent
- * Command — used by `agents setup mine`.
- */
 export declare function registerMineManageCommands(cmd: Command): void;

package/dist/commands/mine.js

@@ -3,22 +3,13 @@ import { validateBrandName, listBrands, getBrandConfig, upsertBrand, removeBrand
 import { createBrandShim, removeBrandShim, isShimsInPath } from '../lib/installations/shims.js';
 import { updateMeta } from '../lib/state.js';
 import { KNOWN_TOP_LEVEL_COMMANDS } from '../lib/startup/command-registry.js';
-/** Built-in top-level command names, for validating `--disable <cmd>`. */
 function knownCommandNames() {
     const names = new Set(KNOWN_TOP_LEVEL_COMMANDS);
-    // Inline aliases registered outside COMMAND_LOADERS (see src/index.ts).
     for (const n of ['perms', 'exec', 'jobs', 'cron', 'upgrade'])
         names.add(n);
     return names;
 }
-/**
- * Add/remove a `!name` exclusion on a preset's pattern list for one kind,
- * keeping `*` so everything not explicitly disabled stays enabled. Deletes the
- * key entirely once nothing but `*` remains, so a clean brand has an empty preset.
- */
 function applyResourceToggle(preset, kind, name, enable) {
-    // Cast to a plain string-bag: writing through the union-keyed `preset[kind]`
-    // collapses to `never` under strict TS, so index the bag instead.
     const bag = preset;
     const arr = [...(bag[kind] ?? [])];
     if (arr.length === 0)
@@ -38,7 +29,6 @@ function applyResourceToggle(preset, kind, name, enable) {
     else
         bag[kind] = arr;
 }
-/** Ensure the brand's preset exists in meta.profiles.presets and return a mutable copy path. */
 function ensurePresetExists(name) {
     const presetName = brandPresetName(name);
     updateMeta((meta) => {
@@ -50,7 +40,6 @@ function ensurePresetExists(name) {
         return { ...meta, profiles: { ...profiles, presets } };
     });
 }
-/** Mutate the brand's resource preset under lock. */
 function editPreset(name, fn) {
     const presetName = brandPresetName(name);
     updateMeta((meta) => {
@@ -62,10 +51,6 @@ function editPreset(name, fn) {
         return { ...meta, profiles: { ...profiles, presets } };
     });
 }
-/**
- * Create (or re-mint) a brand. Shared by `setup mine init` and the `setup mine`
- * wizard. Writes the shim, the brand config, and an empty resource preset.
- */
 export function initBrand(name, opts = {}) {
     const err = validateBrandName(name);
     if (err) {
@@ -101,10 +86,6 @@ function printMinted(name, pathWarning) {
         console.log(chalk.yellow(`  note: the shims dir isn't on your PATH yet — run 'agents setup' or open a new shell.`));
     }
 }
-/**
- * Register brand manage verbs (`init`/`list`/`toggle`/`remove`) under a parent
- * Command — used by `agents setup mine`.
- */
 export function registerMineManageCommands(cmd) {
     cmd
         .command('init <name>')
@@ -151,7 +132,6 @@ export function registerMineManageCommands(cmd) {
             console.error(chalk.red(`No brand named "${name}". Create it with 'agents setup mine init ${name}'.`));
             process.exit(1);
         }
-        // Built-in command toggles → brand.disabledCommands.
         const disabledSet = new Set(cfg.disabledCommands ?? []);
         const known = knownCommandNames();
         for (const c of options.disable ?? []) {
@@ -168,7 +148,6 @@ export function registerMineManageCommands(cmd) {
         else
             delete nextCfg.disabledCommands;
         upsertBrand(nextCfg);
-        // Resource toggles → the brand's profile preset.
         const resourceOps = [];
         for (const p of options.disablePlugin ?? [])
             resourceOps.push(['plugins', p, false]);

package/dist/commands/models.d.ts

@@ -1,12 +1,4 @@
-/**
- * Model catalog inspection command.
- *
- * Registers the hidden `agents models` command for listing models
- * supported by installed agent versions. Extracts model catalogs from
- * each agent's CLI bundle and displays IDs, aliases, and metadata.
- */
 import type { Command } from 'commander';
-/** Register the `agents models` command + its `tier` override subcommands. */
 export declare function registerModelsCommand(program: Command): void;
 export declare function formatModelSourceLine(kind: string, sourcePath: string, width?: number): string;
 export declare function formatModelAliasLines(parts: string[], width?: number): string[];

package/dist/commands/models.js

@@ -1,10 +1,3 @@
-/**
- * Model catalog inspection command.
- *
- * Registers the hidden `agents models` command for listing models
- * supported by installed agent versions. Extracts model catalogs from
- * each agent's CLI bundle and displays IDs, aliases, and metadata.
- */
 import chalk from 'chalk';
 import * as fs from 'fs';
 import { homeDir } from '../lib/platform/index.js';
@@ -19,13 +12,7 @@ import { wrapJoined } from './inspect.js';
 import { setHelpSections } from '../lib/help.js';
 import { formatRunDefaultEntry, listRunDefaults, parseRunDefaultSelector, setRunDefault, } from '../lib/run-defaults.js';
 const MODEL_CAPABLE_AGENTS = ['claude', 'codex', 'opencode', 'cursor', 'openclaw', 'antigravity', 'kimi', 'grok', 'droid'];
-/**
- * Agents that don't necessarily install under ~/.agents/versions (cursor ships
- * via a curl script). For these, fall back to the PATH binary and synthesize
- * a version label from the install path so cache keys stay stable.
- */
 const PATH_ONLY_AGENTS = new Set(['cursor']);
-/** Derive a version label from the PATH-installed binary location for agents without managed versions. */
 function fallbackPathVersion(agent) {
     const src = locateModelSource(agent, 'unresolved');
     if (!src)
@@ -35,12 +22,10 @@ function fallbackPathVersion(agent) {
         real = fs.realpathSync(src.path);
     }
     catch {
-        /* keep symlink path */
     }
     const m = real.match(/\/versions\/([^/]+)\//);
     return m ? m[1] : 'installed';
 }
-/** Register the `agents models` command + its `tier` override subcommands. */
 export function registerModelsCommand(program) {
     const models = program
         .command('models [agentSpec]')
@@ -77,10 +62,6 @@ export function registerModelsCommand(program) {
             console.log(chalk.gray('  Permission modes (--mode plan|edit|auto|skip): `agents modes <agent>`'));
         }
     });
-    // `models set` — the ergonomic setter for per-agent/version run defaults. It
-    // reads and writes the same store as `agents config set run.<agent@version>.*`
-    // (agents.yaml -> run.defaults), so the two stay consistent — `set` is just the
-    // short front door, nested here because `models` owns model/mode concerns.
     const set = models
         .command('set [selector]')
         .description('Set the default model/mode an agent version uses for `agents run`')
@@ -142,8 +123,6 @@ export function registerModelsCommand(program) {
       'agents run' always win over configured defaults.
     `,
     });
-    // Override subcommands. These WRITE agents.yaml so the user never hand-edits it;
-    // resolution is exact `<agent>@<version>` over `<agent>` over the auto guess.
     const tierDeprecation = chalk.yellow('Deprecation: `agents models tier` is replaced by `agents config set run.<agent@version>.tier.<tier>`.');
     const tier = models
         .command('tier')
@@ -192,7 +171,6 @@ export function registerModelsCommand(program) {
         }
     });
 }
-/** Resolve the agent spec into one or more (agent, version) pairs to inspect. */
 async function resolveTargets(agentSpec) {
     if (!agentSpec) {
         const targets = [];
@@ -205,8 +183,6 @@ async function resolveTargets(agentSpec) {
                 targets.push({ agent, version, isDefault: true });
             }
             else {
-                // Surface the gap instead of silently dropping the agent -- an
-                // uninstalled model-capable agent should tell the user how to add it.
                 console.error(chalk.gray(`${agentLabel(agent)}: not installed (run 'agents add ${agent}@latest')`));
             }
         }
@@ -244,18 +220,14 @@ async function resolveTargets(agentSpec) {
     }
     return [{ agent, version, isDefault: version === getGlobalDefault(agent) }];
 }
-/** Print the model catalog for a single agent version with optional cloud/reasoning details. */
 function printCatalog(agent, version, isDefault, options) {
     const tag = isDefault ? chalk.gray(' (default)') : '';
     const header = `${agentLabel(agent)} ${chalk.bold(version)}${tag}`;
     console.log(header);
-    // Cost tiers first -- the thing an orchestrating agent reads to pick a model.
     printTiers(agent, version);
     const src = locateModelSource(agent, version);
     if (!src) {
         if (agent === 'droid') {
-            // Droid has no extractable catalog (no models CLI/API/config); the curated
-            // tier map above is the whole surface.
             console.log(chalk.gray('  (Droid has no model list command; tiers are a curated, credit-multiplier map.)'));
             return;
         }
@@ -268,8 +240,6 @@ function printCatalog(agent, version, isDefault, options) {
         console.log(chalk.yellow(`  No models extracted from ${src.kind} at ${src.path}.`));
         return;
     }
-    // The tier map above is what an agent reads. Keep the raw catalog behind --all
-    // so `agents models` stays a scannable menu instead of a 30-id dump.
     if (!options.all) {
         console.log(chalk.gray(`  ${catalog.models.length} models · \`agents models ${agent} --all\` for the full list`));
         return;
@@ -312,7 +282,6 @@ function printCatalog(agent, version, isDefault, options) {
         }
     }
 }
-/** Rough blended $/Mtok label for a model id, or '' when unpriced. */
 function priceLabel(id) {
     const p = getModelPricing(id);
     if (!p)
@@ -320,7 +289,6 @@ function priceLabel(id) {
     const perM = (p.inputPerToken + p.outputPerToken) * 1e6;
     return chalk.gray(`  ~$${perM.toFixed(0)}/Mtok`);
 }
-/** Print the cheap/default/best/ultra tier map for an (agent, version). */
 function printTiers(agent, version) {
     const map = resolveTierMap(agent, version);
     if (!MODEL_TIERS.some((t) => map[t].model))
@@ -337,7 +305,6 @@ function printTiers(agent, version) {
     }
     console.log();
 }
-/** Abbreviate a path by replacing the home directory with ~. */
 function shortPath(p) {
     return p.replace(homeDir(), '~');
 }

package/dist/commands/modes.d.ts

@@ -1,12 +1,2 @@
-/**
- * `agents modes` — list the permission modes a harness accepts for
- * `agents run` / `agents teams add`.
- *
- * Mirror of `agents models`: humans and orchestrating agents read this before
- * picking `--mode plan|edit|auto|skip`. Modes are per-agent today (not version-
- * gated); `agent@version` is accepted so the configured run.defaults mode for
- * that version can be shown beside the catalog.
- */
 import type { Command } from 'commander';
-/** Register `agents modes [agent[@version]]`. */
 export declare function registerModesCommand(program: Command): void;

package/dist/commands/modes.js

@@ -1,20 +1,9 @@
-/**
- * `agents modes` — list the permission modes a harness accepts for
- * `agents run` / `agents teams add`.
- *
- * Mirror of `agents models`: humans and orchestrating agents read this before
- * picking `--mode plan|edit|auto|skip`. Modes are per-agent today (not version-
- * gated); `agent@version` is accepted so the configured run.defaults mode for
- * that version can be shown beside the catalog.
- */
 import chalk from 'chalk';
 import { AGENTS, ALL_AGENT_IDS, agentLabel, formatAgentError, resolveAgentName, } from '../lib/agents.js';
 import { formatModeFlags, getAgentModesCatalog, } from '../lib/agent-modes.js';
 import { setHelpSections } from '../lib/help.js';
 import { getGlobalDefault, listInstalledVersions, resolveVersion, resolveVersionAlias } from '../lib/installations/versions.js';
-/** Agents that show in the no-arg overview (skip hard-deprecated). */
 const MODE_AGENTS = ALL_AGENT_IDS.filter((id) => !AGENTS[id].deprecated?.hard);
-/** Register `agents modes [agent[@version]]`. */
 export function registerModesCommand(program) {
     const modes = program
         .command('modes [agentSpec]')
@@ -108,7 +97,6 @@ function resolveTargets(agentSpec) {
         }));
     }
     if (versionSpec) {
-        // resolveVersionAlias exits process if the concrete version is not installed.
         const version = resolveVersionAlias(agent, versionSpec) ?? null;
         return [{ agent, version, isDefault: version === getGlobalDefault(agent) }];
     }
@@ -139,7 +127,6 @@ function printCatalog(catalog, version, isDefault) {
         console.log(chalk.yellow('  headless plan: not supported (interactive plan still works)'));
     }
     for (const note of catalog.notes) {
-        // Keep the full-alias note quiet; surface degrades more visibly.
         if (note.startsWith("'full'"))
             continue;
         console.log(chalk.gray(`  note: ${note}`));

package/dist/commands/monitors.d.ts

@@ -1,11 +1,2 @@
-/**
- * Monitors — durable event-triggered watchers.
- *
- * Registers the `agents monitors` command tree: create, list, view, dry-run test,
- * edit, logs, fire history, pause/resume, (re)pin the owner device, and remove.
- * Mirrors `agents routines` (commands/routines.ts) and shares the same daemon +
- * dispatch engine underneath — a monitor is a routine whose trigger is a watched
- * source instead of a clock.
- */
 import type { Command } from 'commander';
 export declare function registerMonitorsCommands(program: Command): void;