@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/cli/command-registry.d.ts

@@ -1,28 +1,6 @@
-/**
- * Lazy command registry.
- *
- * The CLI entry point (src/index.ts) used to statically import every command
- * module and call its `registerXCommand(program)` on every invocation. That
- * loaded the entire command tree (~50 modules) before the first line of output,
- * dominating cold-start latency.
- *
- * This module maps each user-typed top-level command name to a thunk that
- * dynamically imports ONLY the module(s) that command needs. Fast commands
- * (`--version`, `view`, ...) now pay for just the one module they use; the full
- * tree is loaded only on the rare slow paths (unknown-command spellcheck, bare
- * help) via `registerAllEagerCommands` in src/index.ts.
- *
- * Parity is non-negotiable: the name -> loader map below mirrors exactly which
- * module registers which top-level command on `main`. Multi-command modules
- * (versions, packages) map several names to the same loader; `prune` needs BOTH
- * versions (which creates `prune <specs...>`) and prune.js (which attaches the
- * `cleanup` subcommand to it), in that order — see commands/prune.ts.
- */
 import { Command } from 'commander';
 export { KNOWN_TOP_LEVEL_COMMANDS, RETIRED_TOP_LEVEL_COMMANDS } from '../lib/startup/command-registry.js';
-/** A function that registers one or more commands onto the root program. */
 export type Registrar = (program: Command) => void;
-/** A thunk that dynamically imports a command module and returns its registrar. */
 export type ModuleLoader = () => Promise<Registrar>;
 export declare const loadVersions: ModuleLoader;
 export declare const loadUpdate: ModuleLoader;
@@ -32,43 +10,7 @@ export declare const loadDoctor: ModuleLoader;
 export declare const loadSessions: ModuleLoader;
 export declare const loadTeams: ModuleLoader;
 export declare const loadReminders: ModuleLoader;
-/**
- * Commands whose modules pull in the SQLite-backed session/cloud stack. They are
- * registered AFTER `applyGlobalHelpConventions` (mirroring main's order: help
- * conventions at module top-level, lazy registration just before parse), so they
- * inherit the root's custom help formatter rather than getting the per-command
- * recursive pass. Keeping that ordering preserves their `--help` output exactly.
- */
 export declare const LAZY_COMMAND_NAMES: ReadonlySet<string>;
-/**
- * User-typed top-level command name -> ordered list of module loaders to run.
- *
- * Most names map to a single loader. The exceptions encode real coupling on main:
- *  - `add`/`use`/`list`/`remove`/`rm`/`purge` all come from the versions module.
- *  - `registry`/`search`/`install`/`packages` all come from the packages module.
- *  - `trash` and `restore` are separate registrars in the trash module.
- *  - `prune` needs versions FIRST (it creates `prune <specs...>`) then prune.js
- *    (which finds that command and attaches the `cleanup` subcommand).
- *
- * Inline deprecated aliases (memory/perms/exec/jobs/cron) and the inline
- * `upgrade` command are NOT here — they are closures over entry-point state and
- * are handled directly in src/index.ts.
- */
 export declare const COMMAND_LOADERS: Record<string, ModuleLoader[]>;
-/**
- * Register every module in {@link COMMAND_LOADERS} onto one fresh program and
- * return it — the full public command tree, deduped by loader identity so a
- * loader mapped to several names (e.g. `add`/`use`/`list` -> versions) runs once.
- *
- * Off the hot path only: the command-index generator (`scripts/gen-command-index.ts`)
- * and the tests build the tree from this. Startup never calls it — src/index.ts
- * registers just the one requested command via `registerEagerForRequest`. The
- * inline aliases/tombstones ({@link INLINE_COMMAND_NAMES}) are NOT included: they
- * are closures over entry-point state that src/index.ts registers directly.
- */
 export declare function buildFullCommandTree(): Promise<Command>;
-/**
- * Register every module in {@link COMMAND_LOADERS} onto the given program.
- * Used by help paths that need the complete visible command tree.
- */
 export declare function registerAllCommands(program: Command): Promise<void>;

package/dist/cli/command-registry.js

@@ -1,31 +1,8 @@
-/**
- * Lazy command registry.
- *
- * The CLI entry point (src/index.ts) used to statically import every command
- * module and call its `registerXCommand(program)` on every invocation. That
- * loaded the entire command tree (~50 modules) before the first line of output,
- * dominating cold-start latency.
- *
- * This module maps each user-typed top-level command name to a thunk that
- * dynamically imports ONLY the module(s) that command needs. Fast commands
- * (`--version`, `view`, ...) now pay for just the one module they use; the full
- * tree is loaded only on the rare slow paths (unknown-command spellcheck, bare
- * help) via `registerAllEagerCommands` in src/index.ts.
- *
- * Parity is non-negotiable: the name -> loader map below mirrors exactly which
- * module registers which top-level command on `main`. Multi-command modules
- * (versions, packages) map several names to the same loader; `prune` needs BOTH
- * versions (which creates `prune <specs...>`) and prune.js (which attaches the
- * `cleanup` subcommand to it), in that order — see commands/prune.ts.
- */
 import { Command } from 'commander';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { configureRootCommand } from '../lib/startup/root-command.js';
 export { KNOWN_TOP_LEVEL_COMMANDS, RETIRED_TOP_LEVEL_COMMANDS } from '../lib/startup/command-registry.js';
-// One loader per command module. Each dynamically imports the module and hands
-// back its register function. Kept as named consts so src/index.ts can compose
-// them into the exact main-branch registration order for the slow path.
 const loadView = async () => (await import('../commands/view.js')).registerViewCommand;
 const loadInspect = async () => (await import('../commands/inspect.js')).registerInspectCommand;
 const loadFeedback = async () => (await import('../commands/feedback.js')).registerFeedbackCommand;
@@ -59,10 +36,6 @@ const loadRestore = async () => (await import('../commands/trash.js')).registerR
 export const loadDoctor = async () => (await import('../commands/doctor.js')).registerDoctorCommand;
 const loadRoute = async () => (await import('../commands/route.js')).registerRouteCommands;
 const loadHarness = async () => (await import('../commands/harness.js')).registerHarnessCommands;
-// PHNX-3989: `agents secrets` is a thin passthrough to the standalone
-// `secrets` CLI (secrets-passthrough.ts). The legacy in-repo engine and its
-// own command registrar are gone (Track D, tasks.md item 7) — the standalone
-// `@phnx-labs/secrets-cli` package is the only implementation.
 const loadSecrets = async () => (await import('../commands/secrets-passthrough.js')).registerSecretsCommands;
 const loadMenubar = async () => (await import('../commands/menubar.js')).registerMenubarCommands;
 const loadSync = async () => (await import('../commands/sync.js')).registerSyncCommand;
@@ -85,6 +58,7 @@ export const loadSessions = async () => (await import('../commands/sessions.js')
 export const loadTeams = async () => (await import('../commands/teams.js')).registerTeamsCommands;
 const loadCloud = async () => (await import('../commands/cloud.js')).registerCloudCommands;
 const loadMessage = async () => (await import('../commands/message.js')).registerMessageCommand;
+const loadPs = async () => (await import('../commands/ps.js')).registerPsCommand;
 const loadSend = async () => (await import('../commands/send.js')).registerSendCommand;
 const loadFeed = async () => (await import('../commands/feed.js')).registerFeedCommand;
 const loadMailboxes = async () => (await import('../commands/mailboxes.js')).registerMailboxesCommand;
@@ -95,34 +69,12 @@ const loadDaemon = async () => (await import('../commands/daemon.js')).registerD
 const loadAuth = async () => (await import('../commands/auth.js')).registerAuthCommand;
 const loadTraces = async () => (await import('../commands/traces.js')).registerTracesCommands;
 export const loadReminders = async () => (await import('../commands/reminders.js')).registerRemindersCommand;
-/**
- * Commands whose modules pull in the SQLite-backed session/cloud stack. They are
- * registered AFTER `applyGlobalHelpConventions` (mirroring main's order: help
- * conventions at module top-level, lazy registration just before parse), so they
- * inherit the root's custom help formatter rather than getting the per-command
- * recursive pass. Keeping that ordering preserves their `--help` output exactly.
- */
-// `roster` was a sessions --active alias — removed; use sessions --active.
 export const LAZY_COMMAND_NAMES = new Set([
     'sessions',
     'teams',
     'cloud',
     'message',
 ]);
-/**
- * User-typed top-level command name -> ordered list of module loaders to run.
- *
- * Most names map to a single loader. The exceptions encode real coupling on main:
- *  - `add`/`use`/`list`/`remove`/`rm`/`purge` all come from the versions module.
- *  - `registry`/`search`/`install`/`packages` all come from the packages module.
- *  - `trash` and `restore` are separate registrars in the trash module.
- *  - `prune` needs versions FIRST (it creates `prune <specs...>`) then prune.js
- *    (which finds that command and attaches the `cleanup` subcommand).
- *
- * Inline deprecated aliases (memory/perms/exec/jobs/cron) and the inline
- * `upgrade` command are NOT here — they are closures over entry-point state and
- * are handled directly in src/index.ts.
- */
 export const COMMAND_LOADERS = {
     accounts: [loadAccounts],
     view: [loadView],
@@ -156,9 +108,6 @@ export const COMMAND_LOADERS = {
     monitors: [loadMonitors],
     projects: [loadProjects],
     run: [loadRun],
-    // `_callback` is the machine-only agents:// deep-link verb; `open` is its
-    // hidden back-compat alias (OS handlers written by older CLIs call it). Both
-    // tokens must lazy-load the same module so either resolves. See commands/open.ts.
     _callback: [loadOpen],
     open: [loadOpen],
     fork: [loadFork],
@@ -178,8 +127,6 @@ export const COMMAND_LOADERS = {
     'refresh-rules': [loadRefreshRules],
     factory: [loadFactory],
     insights: [loadInsights],
-    // `agents trace` is a top-level alias of `agents sessions trace` (precedent:
-    // `agents insights` aliases `agents sessions insights`). One implementation.
     trace: [loadTrace],
     tmux: [loadTmux],
     watchdog: [loadWatchdog],
@@ -189,12 +136,7 @@ export const COMMAND_LOADERS = {
     events: [loadEvents],
     ssh: [loadSsh],
     devices: [loadSsh],
-    // `fleet` is a commander alias of `devices` (see commands/ssh.ts); list it so
-    // lazy registration loads the devices tree when the user types `agents fleet`.
     fleet: [loadSsh],
-    // `repos` is the canonical command name; `repo` remains a convenience alias
-    // (see commands/repo.ts). List both so lazy registration loads the tree
-    // whichever the user types.
     repos: [loadRepo],
     repo: [loadRepo],
     setup: [loadSetup],
@@ -204,6 +146,7 @@ export const COMMAND_LOADERS = {
     teams: [loadTeams],
     cloud: [loadCloud],
     message: [loadMessage],
+    ps: [loadPs],
     send: [loadSend],
     feed: [loadFeed],
     mailboxes: [loadMailboxes],
@@ -214,27 +157,12 @@ export const COMMAND_LOADERS = {
     auth: [loadAuth],
     traces: [loadTraces],
 };
-/**
- * Register every module in {@link COMMAND_LOADERS} onto one fresh program and
- * return it — the full public command tree, deduped by loader identity so a
- * loader mapped to several names (e.g. `add`/`use`/`list` -> versions) runs once.
- *
- * Off the hot path only: the command-index generator (`scripts/gen-command-index.ts`)
- * and the tests build the tree from this. Startup never calls it — src/index.ts
- * registers just the one requested command via `registerEagerForRequest`. The
- * inline aliases/tombstones ({@link INLINE_COMMAND_NAMES}) are NOT included: they
- * are closures over entry-point state that src/index.ts registers directly.
- */
 export async function buildFullCommandTree() {
     const packageJson = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf8'));
     const program = configureRootCommand(new Command(), 'agents', packageJson.version);
     await registerAllCommands(program);
     return program;
 }
-/**
- * Register every module in {@link COMMAND_LOADERS} onto the given program.
- * Used by help paths that need the complete visible command tree.
- */
 export async function registerAllCommands(program) {
     const done = new Set();
     for (const loaders of Object.values(COMMAND_LOADERS)) {

package/dist/commands/accounts.d.ts

@@ -6,17 +6,11 @@ export declare function parseBundleKey(raw: string): {
     bundle: string;
     key: string;
 };
-/** Compatibility export for tests/consumers; the canonical renderer is shared with view. */
 export declare function renderAccountList(native: NativeAccountCatalogRow[], providers?: ProviderAccountCatalogRow[], opts?: {
     harness?: AgentId;
     localDevice?: string;
 }): string;
-/** Named accounts that `accounts default` can pin for this harness. */
 export declare function listSwitchableAccounts(agent: AgentId): Promise<UnifiedAccount[]>;
-/**
- * Pin the per-harness default — the `accounts default` write path.
- * Provider accounts must authenticate the harness; native accounts must belong to it.
- */
 export declare function setDefaultAccount(agentRaw: string, name: string): {
     agent: AgentId;
     account: UnifiedAccount;
@@ -24,22 +18,11 @@ export declare function setDefaultAccount(agentRaw: string, name: string): {
 export declare function runAccountsDefault(harness: string, accountName: string | undefined, opts: {
     json: boolean;
 }): Promise<void>;
-/**
- * Parse a `logout` target into its parts (pure). Supports `<harness>`,
- * `<harness>@<label>`, `<harness>#<account>`, and a bare account name (no
- * harness). `#` binds tighter than `@` so a `<harness>#<label>` selector is
- * never mis-split on a `@` inside the selector.
- */
 export declare function parseLogoutTarget(target: string): {
     agentRaw: string;
     installationLabel?: string;
     identitySelector?: string;
 };
-/**
- * Resolve a `logout` target to the exact `(agent, installed label)` whose home
- * should be signed out — honoring a passed `@label` or `#account` selector
- * instead of always selecting the global default (PHNX-3940).
- */
 export declare function resolveLogoutTarget(target: string): Promise<{
     agent: AgentId;
     version: string;

package/dist/commands/accounts.js

@@ -21,11 +21,9 @@ import { acquireAuthOperationLock } from '../lib/accounts/auth-operation-lock.js
 import { isSecretsClientError, pushBundleToHost, readAndResolveBundleEnv, readBundle } from '../lib/secrets-client.js';
 import { getAccountProvider, listAccountProviders, providerAuthenticatesHarness } from '../lib/account-provider-registry.js';
 import { accountBindings, addAccount, assertUnambiguousNativeAccount, findAccount, findUnifiedAccount, inspectAccount, listNativeAccounts, nativeAccountHome, parseAccountSelector, readAccountRegistry, removeAccount, renameAccount, setAccountSecret } from '../lib/account-registry.js';
-/** Comma-joined list of harnesses `accounts add` can drive today. */
 function addSupportedList() {
     return supportedAddHarnesses().join(', ');
 }
-/** Shared result printer for `accounts add` / `accounts login`. */
 function printAddResult(result, json) {
     if (json) {
         console.log(JSON.stringify(result, null, 2));
@@ -52,7 +50,6 @@ function printAddResult(result, json) {
 function cleanCommandError(command, err) {
     command.error(err instanceof Error ? err.message : String(err), { exitCode: 1, code: 'accounts.error' });
 }
-/** Turn a thrown user-facing Error into commander's clean CLI error instead of Node's stack dump. */
 async function runAccountsAction(command, fn) {
     try {
         await fn();
@@ -69,13 +66,6 @@ export function parseBundleKey(raw) {
         throw new Error(`Expected bundle:key, got '${raw}'.`);
     return { bundle: raw.slice(0, colon), key: raw.slice(colon + 1) };
 }
-/**
- * Copy one value out of an `agents secrets` bundle for `--from-secrets`. The
- * standalone reports failures only as codes, so the bundle, the key, and the
- * repair are named here — and existence is checked first, because a
- * prompt-free (`agentOnly`) read of a bundle that does not exist reports
- * LOCKED rather than NOT_FOUND.
- */
 async function secretFromBundle(raw) {
     const { bundle, key } = parseBundleKey(raw);
     let vars;
@@ -102,7 +92,6 @@ async function secretFromBundle(raw) {
             `Unlock it first with 'agents secrets unlock ${bundle}', then retry.`);
     }
 }
-/** Interactive secret entry for add/set-key. Ctrl+C must not become accounts.error. */
 async function promptAccountSecret(message) {
     try {
         return await password({ message });
@@ -121,7 +110,7 @@ async function printAccounts(json, fleet = false, harnessRaw) {
     const catalog = await loadAccountCatalog();
     const note = secretsUnavailableNote(catalog);
     if (note)
-        console.error(chalk.yellow(note)); // stderr — never corrupts --json stdout
+        console.error(chalk.yellow(note));
     const native = harness ? catalog.native.filter((row) => row.agent === harness) : catalog.native;
     const providers = harness
         ? catalog.provider.filter((row) => row.harnesses.includes(harness))
@@ -144,7 +133,6 @@ async function printAccounts(json, fleet = false, harnessRaw) {
     }
     console.log(renderAccountRows(native, { providers, harness, localDevice: machineId() }));
 }
-/** Compatibility export for tests/consumers; the canonical renderer is shared with view. */
 export function renderAccountList(native, providers = [], opts = {}) {
     return renderAccountRows(native, { providers, localDevice: '', ...opts });
 }
@@ -158,7 +146,6 @@ function parseHarness(agentRaw) {
         throw new Error(`Unknown agent '${agentRaw}'.`);
     return agentRaw;
 }
-/** Every account (native + provider) registered/usable for this harness, oldest-first by name. */
 function accountsForHarness(agent) {
     const meta = readMeta();
     const native = listNativeAccounts(meta).filter(account => account.agent === agent);
@@ -167,19 +154,11 @@ function accountsForHarness(agent) {
         .map(account => ({ ...account, kind: 'provider' }));
     return [...native, ...providers].sort((a, b) => a.name.localeCompare(b.name));
 }
-/** Named accounts that `accounts default` can pin for this harness. */
 export async function listSwitchableAccounts(agent) {
     return accountsForHarness(agent);
 }
-/**
- * Pin the per-harness default — the `accounts default` write path.
- * Provider accounts must authenticate the harness; native accounts must belong to it.
- */
 export function setDefaultAccount(agentRaw, name) {
     const agent = parseHarness(agentRaw);
-    // Scope to the harness this default is FOR: a bare identity (`<email>`) matches
-    // every harness that identity is signed into, so an un-scoped lookup resolved
-    // the wrong row and then rejected it as "is a <other> login" just below.
     const account = findUnifiedAccount(name, readMeta(), undefined, agent);
     if (!account)
         throw new Error(`Unknown account '${name}'.`);
@@ -190,17 +169,9 @@ export function setDefaultAccount(agentRaw, name) {
         if (account.agent !== agent) {
             throw new Error(`Account '${account.name}' is a ${account.agent} login and cannot be the default for ${agent}.`);
         }
-        // Adopted harnesses isolate by slot + symlink, not a version home, so the
-        // nameable-by-version-home gate does not apply to `accounts default`.
         if (!isSymlinkAdoptedHarness(agent))
             assertNativeAccountNameable(account.agent);
     }
-    // Reference by NAME, not id: defaults sync fleet-wide with `agents repo push/pull`
-    // while account ids are minted per-device, so an id ref breaks on every other
-    // machine ("Unknown account '<uuid>'"). Names are the portable handle — the
-    // registry resolves both, and existing uuid entries still resolve.
-    // Repoint first: a written default whose symlink still points at another
-    // account is a wrong home that looks like success.
     if (account.kind === 'native')
         ensureAdoptedDefaultRepoint(agent, account, readMeta());
     updateMeta(meta => ({ ...meta, accounts: { ...meta.accounts, defaults: { ...meta.accounts?.defaults, [agent]: account.name } } }));
@@ -260,12 +231,6 @@ export async function runAccountsDefault(harness, accountName, opts) {
     const { account } = setDefaultAccount(agent, selected);
     console.log(chalk.green(`${agent} now uses account '${account.name}' unless --account overrides it.`));
 }
-/**
- * Parse a `logout` target into its parts (pure). Supports `<harness>`,
- * `<harness>@<label>`, `<harness>#<account>`, and a bare account name (no
- * harness). `#` binds tighter than `@` so a `<harness>#<label>` selector is
- * never mis-split on a `@` inside the selector.
- */
 export function parseLogoutTarget(target) {
     const hash = target.indexOf('#');
     if (hash > 0) {
@@ -281,7 +246,6 @@ export function parseLogoutTarget(target) {
     }
     return { agentRaw: target };
 }
-/** Explicit account logout must never fall back to another account's home. */
 async function resolveAccountHomeLabel(account) {
     const rows = await collectNativeHomeRows();
     const homes = rows
@@ -295,11 +259,6 @@ async function resolveAccountHomeLabel(account) {
     }
     return label;
 }
-/**
- * Resolve a `logout` target to the exact `(agent, installed label)` whose home
- * should be signed out — honoring a passed `@label` or `#account` selector
- * instead of always selecting the global default (PHNX-3940).
- */
 export async function resolveLogoutTarget(target) {
     const parsed = parseLogoutTarget(target);
     const meta = readMeta();
@@ -332,7 +291,6 @@ export async function resolveLogoutTarget(target) {
             throw new Error(`No installed version of ${agent}. Install one with: agents add ${agent}`);
         return { agent, version };
     }
-    // A bare, non-harness target may be a native account name.
     const account = findUnifiedAccount(target, meta);
     if (account?.kind === 'native') {
         return { agent: account.agent, version: await resolveAccountHomeLabel(account) };
@@ -377,7 +335,6 @@ agents accounts list --fleet`,
             const agent = resolveAgentName(target);
             const providerFlags = o.provider !== undefined || o.auth !== undefined || o.baseUrl !== undefined || o.fromSecrets !== undefined;
             if (agent) {
-                // Harness form: an account is a credential slot, not a bundle.
                 if (providerFlags) {
                     throw new Error(`'${target}' is a harness id — mixing the harness and provider forms is ambiguous. `
                         + `Harness form: agents accounts add ${agent} [name]. `
@@ -397,7 +354,6 @@ agents accounts list --fleet`,
                 printAddResult(result, json);
                 return;
             }
-            // Provider form (the pre-v2 `accounts add <name> --provider …`).
             if (o.apiKey !== undefined || o.perDevice || o.workerToken === false) {
                 throw new Error(`'${target}' is not a harness id — --api-key/--per-device/--no-worker-token belong to the harness form: agents accounts add <harness> [name].`);
             }
@@ -640,9 +596,6 @@ agents accounts rename codex#icloud cloud`,
                 throw new Error(`Account '${provider.name}' uses ${provider.auth}, not OAuth. Remove it with: agents accounts remove ${provider.name}`);
             }
             const { agent } = await resolveLogoutTarget(target);
-            // Acquire the per-harness auth-operation mutex before logout — a concurrent
-            // connect for the same harness could allocate and install into the same home
-            // while this logout is in-flight, leaving the home in an ambiguous state.
             const lock = acquireAuthOperationLock(agent);
             try {
                 const resolved = await resolveLogoutTarget(target);
@@ -652,10 +605,6 @@ agents accounts rename codex#icloud cloud`,
                 const { runNativeAccountCommand } = await import('../lib/installations/native-command.js');
                 const { getVersionHomePath } = await import('../lib/installations/versions.js');
                 const { buildExecEnv } = await import('../lib/exec.js');
-                // Pin the harness's own config-dir env (CLAUDE_CONFIG_DIR / CODEX_HOME) to
-                // the resolved home so `logout` signs out THAT account's home — not
-                // whichever the global default happens to be. HOME alone was insufficient
-                // for a config-dir-env harness, which is why a passed @label was ignored.
                 const env = buildExecEnv({ agent, version, configVersion: version, interactive: true, mode: 'auto', effort: 'auto', cwd: process.cwd() });
                 env.HOME = getVersionHomePath(agent, version);
                 lock.assertHeld();

package/dist/commands/alias.d.ts

@@ -1,14 +1,2 @@
-/**
- * `agents setup alias` -- create top-level shim binaries that expand to
- * `agents <subcommand>`. Nested under setup because the user is configuring
- * this machine's PATH shortcuts, not operating a separate noun (RUSH-2965).
- *
- * Generates executable scripts in ~/.agents/.cache/shims/ (already on PATH from
- * the standard agents-cli install). Running `teams` becomes equivalent to
- * `agents teams`. Aliases are tracked in ~/.agents/aliases.json so we can
- * list, regenerate, or remove them without scanning the shims directory
- * (which also holds agent CLI shims like claude/codex/gemini).
- */
 import type { Command } from 'commander';
-/** Register `agents setup alias` under the parent `setup` command. */
 export declare function registerAliasCommand(setupCmd: Command): void;

package/dist/commands/alias.js

@@ -8,11 +8,6 @@ import { setHelpSections } from '../lib/help.js';
 function aliasesFile() {
     return path.join(getUserAgentsDir(), 'aliases.json');
 }
-/**
- * Names that would clobber an agent CLI shim, the `agents` binary itself, or the
- * standalone `secrets` CLI (PHNX-3989): the shims dir sits first on PATH, so an
- * alias named `secrets` would shadow `@phnx-labs/secrets-cli` for every caller.
- */
 function reservedNames() {
     const reserved = new Set(['agents', 'secrets']);
     for (const id of ALL_AGENT_IDS)
@@ -55,7 +50,6 @@ function isAliasShim(filePath) {
         return false;
     }
 }
-/** Register `agents setup alias` under the parent `setup` command. */
 export function registerAliasCommand(setupCmd) {
     const cmd = setupCmd
         .command('alias')

package/dist/commands/apply.d.ts

@@ -1,18 +1,3 @@
-/**
- * `agents fleet apply` / `agents devices apply` — reconcile the whole fleet
- * to a declared profile: install agents-cli + agents and sync config. Native
- * harness logins remain device-local; portable provider credentials move only
- * through explicit `agents accounts sync`.
- *
- * The manifest is the `fleet:` block of any `-f` file (default `agents.yaml`).
- * Top-level `agents apply` is retired (RUSH-2981).
- */
 import { Command } from 'commander';
-/** padEnd on the visible width, ignoring chalk color codes. Exported for tests. */
 export declare function stripPad(s: string, width: number): string;
-/**
- * Canonical surface: `agents fleet apply` / `agents devices apply`.
- * Top-level `agents apply` is retired (RUSH-2981) — not a noun, already nested
- * here. Same reconcile engine, kept in lockstep via {@link configureApplyCommand}.
- */
 export declare function registerFleetApplyAlias(devicesCmd: Command): void;