@phnx-labs/agents-cli 1.22.35 → 1.22.38

package/dist/commands/lease.d.ts

@@ -1,7 +1,7 @@
 /**
- * `agents lease` — manage the disposable cloud boxes used by `agents run --lease`.
+ * `agents devices lease` — manage the disposable cloud boxes used by `agents run --lease`.
  *
- * Today: `agents lease gc`, which stops expired + idle "orphan" boxes that are
+ * Today: `agents devices lease gc`, which stops expired + idle "orphan" boxes that are
  * holding a provider's server quota (the cause of the `server_limit` 403 a new
  * lease hits). Reaping is conservative: only boxes whose lease has expired AND
  * that have been untouched for a safety window are eligible (see `isReapSafe`),
@@ -25,7 +25,7 @@ export declare function boxStatus(box: CrabboxBox): string;
  * freshest box (an untouched `lastTouchedAt` sorts last).
  */
 export declare function reusableBoxes(boxes: CrabboxBox[], nowSecs: number): CrabboxBox[];
-/** One aligned row for the reuse picker / `agents lease list`. */
+/** One aligned row for the reuse picker / `agents devices lease list`. */
 export declare function formatBoxRow(box: CrabboxBox, nowSecs: number): string;
 /** Validate a Hetzner token against the live API. Exported for unit tests (fetch injectable). */
 export declare function validateHetznerToken(token: string, fetchImpl?: typeof fetch): Promise<'valid' | 'invalid' | 'unreachable'>;
@@ -39,4 +39,4 @@ export declare function validateHetznerToken(token: string, fetchImpl?: typeof f
 export declare function runLeaseSetup(opts?: {
     provider?: string;
 }): Promise<boolean>;
-export declare function registerLeaseCommand(program: Command): void;
+export declare function registerLeaseCommand(devicesCommand: Command): void;

package/dist/commands/lease.js

@@ -1,7 +1,7 @@
 /**
- * `agents lease` — manage the disposable cloud boxes used by `agents run --lease`.
+ * `agents devices lease` — manage the disposable cloud boxes used by `agents run --lease`.
  *
- * Today: `agents lease gc`, which stops expired + idle "orphan" boxes that are
+ * Today: `agents devices lease gc`, which stops expired + idle "orphan" boxes that are
  * holding a provider's server quota (the cause of the `server_limit` 403 a new
  * lease hits). Reaping is conservative: only boxes whose lease has expired AND
  * that have been untouched for a safety window are eligible (see `isReapSafe`),
@@ -64,7 +64,7 @@ export function reusableBoxes(boxes, nowSecs) {
         .filter((b) => b.ready && (b.expiresAt === null || b.expiresAt > nowSecs))
         .sort((a, b) => (b.lastTouchedAt ?? 0) - (a.lastTouchedAt ?? 0));
 }
-/** One aligned row for the reuse picker / `agents lease list`. */
+/** One aligned row for the reuse picker / `agents devices lease list`. */
 export function formatBoxRow(box, nowSecs) {
     const slug = box.slug.padEnd(16);
     const cls = (box.class ?? '?').padEnd(10);
@@ -201,8 +201,8 @@ export async function runLeaseSetup(opts = {}) {
         throw e;
     }
 }
-export function registerLeaseCommand(program) {
-    const lease = program
+export function registerLeaseCommand(devicesCommand) {
+    const lease = devicesCommand
         .command('lease')
         .description('Manage the disposable cloud boxes used by `agents run --lease`.');
     lease
@@ -241,7 +241,7 @@ export function registerLeaseCommand(program) {
         console.log(chalk.bold(`Warm boxes (${boxes.length})`));
         for (const b of boxes)
             console.log('  ' + formatBoxRow(b, nowSecs));
-        console.log(chalk.gray('  Reuse: agents run <agent> "…" --box <slug>   ·   Stop: agents lease stop <slug>'));
+        console.log(chalk.gray('  Reuse: agents run <agent> "…" --box <slug>   ·   Stop: agents devices lease stop <slug>'));
     });
     lease
         .command('stop <slug>')

package/dist/commands/login.js

@@ -107,17 +107,4 @@ export function registerLoginCommands(program) {
         clearVaultKey();
         console.log(chalk.green('Logged out. Synced secrets are locked.'));
     });
-    program
-        .command('whoami')
-        .description('Show synced-secrets login status')
-        .action(() => {
-        const session = getVaultSession();
-        if (!session.loggedIn) {
-            console.log(chalk.yellow('Not logged in.'));
-            console.log(chalk.gray(`File: ${vaultPath()}${vaultExists() ? '' : ' (not created)'}`));
-            return;
-        }
-        console.log(chalk.green(`Logged in (${formatRemaining(session.expiresAt)} remaining).`));
-        console.log(chalk.gray(`File: ${vaultPath()}`));
-    });
 }

package/dist/commands/logs.d.ts

@@ -17,8 +17,8 @@
  * id, `--host`/`--agent`/`--version` filter a merged candidate list; one match is
  * shown, several open the fuzzy picker (or, non-TTY, print the list).
  *
- * Additive: `agents hosts logs` and `agents sessions tail` are unchanged and share
- * the same underlying helpers (showHostTaskLog / streamSessionTail).
+ * Additive: `agents devices ps`/`stop` and `agents sessions tail` are unchanged and
+ * share the same underlying helpers (showHostTaskLog / streamSessionTail).
  */
 import type { Command } from 'commander';
 /** Register the top-level `agents logs` command. */

package/dist/commands/logs.js

@@ -17,8 +17,8 @@
  * id, `--host`/`--agent`/`--version` filter a merged candidate list; one match is
  * shown, several open the fuzzy picker (or, non-TTY, print the list).
  *
- * Additive: `agents hosts logs` and `agents sessions tail` are unchanged and share
- * the same underlying helpers (showHostTaskLog / streamSessionTail).
+ * Additive: `agents devices ps`/`stop` and `agents sessions tail` are unchanged and
+ * share the same underlying helpers (showHostTaskLog / streamSessionTail).
  */
 import chalk from 'chalk';
 import { discoverSessions, resolveSessionById } from '../lib/session/discover.js';

package/dist/commands/mcp.js

@@ -564,9 +564,11 @@ Examples:
         }
         console.log();
     });
+    // Deprecated: superseded by `agents sync --mcp`. Kept as a warned, functional
+    // alias so old muscle-memory and scripts don't break.
     mcpCmd
-        .command('register [name]')
-        .description('Apply MCP servers from manifest to agent config files')
+        .command('register [name]', { hidden: true })
+        .description('Deprecated — use `agents sync --mcp` instead.')
         .option('-a, --agents <list>', 'Override manifest targets: claude, codex@0.116.0')
         .option('-y, --yes', 'Auto-install any missing agent versions without prompting')
         .addHelpText('after', `
@@ -581,6 +583,9 @@ Examples:
   agents mcp register --agents codex@0.116.0
 `)
         .action(async (name, options) => {
+        console.warn(chalk.yellow('`agents mcp register` is deprecated — use `agents sync --mcp` instead:'));
+        console.warn(chalk.gray('  all servers:     agents sync --mcp'));
+        console.warn(chalk.gray('  specific server: agents sync --mcp <name>'));
         const localPath = getUserAgentsDir();
         const manifest = readManifest(localPath);
         if (!manifest?.mcp) {

package/dist/commands/memory.js

@@ -111,11 +111,16 @@ export function registerMemoryCommands(program) {
         console.log(chalk.dim(`# ${fact.name}  [${fact.layer}]  ${fact.path}`));
         console.log(fs.readFileSync(fact.path, 'utf-8'));
     });
+    // Deprecated: superseded by `agents sync --memory`. Kept as a warned, functional
+    // alias so old muscle-memory and scripts don't break.
     memoryCmd
-        .command('sync [agent]')
-        .description('Copy canonical memory into capable agent version homes')
+        .command('sync [agent]', { hidden: true })
+        .description('Deprecated — use `agents sync --memory` instead.')
         .option('-a, --agent <agent>', 'Limit to one agent (or agent@version)')
         .action(async (agentArg, options) => {
+        console.warn(chalk.yellow('`agents memory sync` is deprecated — use `agents sync --memory` instead:'));
+        console.warn(chalk.gray('  all agents:  agents sync --memory'));
+        console.warn(chalk.gray('  one agent:   agents sync --memory <agent>'));
         ensureUserMemoryDir();
         const input = agentArg || options.agent;
         if (input) {

package/dist/commands/message.d.ts

@@ -12,7 +12,7 @@
  * 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 hosts ps` reads
+ * 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.
  *

package/dist/commands/message.js

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { spawn } from 'child_process';
 import { die } from '../lib/format.js';
 import { parseDuration } from '../lib/hooks/cache.js';
-import { getActiveSessions } from '../lib/session/active.js';
+import { getActiveSessions, isSessionIdLiveOnProcessTable } from '../lib/session/active.js';
 import { getTaskById, updateTaskStatus } from '../lib/cloud/store.js';
 import { resolveProvider } from '../lib/cloud/registry.js';
 import { mailboxDir, enqueue } from '../lib/mailbox.js';
@@ -119,7 +119,7 @@ async function deliverViaResume(route, mailboxId) {
  * 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 hosts ps` shows the same dispatch running with a live remote
+ * 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> --host <host>` through
@@ -251,11 +251,42 @@ 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);
+                        const route = resolveAnswerRoute({
+                            mailboxId: target,
+                            answer: text,
+                            block,
+                            session: null,
+                        });
+                        if (route.kind === 'refuse')
+                            die(route.reason);
+                        claimBlockAnswer(block, opts);
+                        if (route.kind === 'mailbox') {
+                            await deliverViaMailbox(target, text, block, { from: opts.from, ttlSeconds });
+                            return;
+                        }
+                        die(`Live process carries --session-id ${target} but needs a ${route.kind} rail ` +
+                            `that is unavailable without an active-session row. Retry after the session ` +
+                            `reappears in \`agents sessions --active\`, or inject into its terminal directly.`);
+                    }
+                    catch (err) {
+                        die(err.message);
+                    }
+                    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 hosts ps` reads, so the two commands never disagree.
-                // Heal first, exactly as `hosts stop`/`hosts ps` do: a detached
+                // `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
@@ -269,9 +300,9 @@ export function registerMessageCommand(program) {
                 if (hostRoute.kind === 'finished') {
                     die(`Task '${target}' on host '${hostRoute.host}' already ${hostRoute.status}` +
                         (hostRoute.exitCode !== undefined ? ` (exit ${hostRoute.exitCode})` : '') +
-                        `. Nothing to message. View its output: \`agents hosts logs ${target}\`.`);
+                        `. Nothing to message. View its output: \`agents logs ${target}\`.`);
                 }
-                die(`No running agent or cloud task matches "${target}". List targets with \`agents sessions --active\` or \`agents hosts ps\`.`);
+                die(`No running agent or cloud task matches "${target}". List targets with \`agents sessions --active\` or \`agents devices ps\`.`);
             }
         }
     });

package/dist/commands/models.js

@@ -16,6 +16,8 @@ import { setTierOverride, clearTierOverride, listTierOverrides } from '../lib/mo
 import { getModelPricing } from '../lib/pricing/index.js';
 import { terminalWidth, truncateToWidth, stringWidth } from '../lib/session/width.js';
 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', 'pi'];
 /**
  * Agents that don't necessarily install under ~/.agents/versions (cursor ships
@@ -75,8 +77,74 @@ 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`')
+        .option('--model <model>', 'Default model or model alias, forwarded via --model')
+        .option('--mode <mode>', "Default mode: plan, edit, auto, skip. 'full' accepted as alias for skip.")
+        .action((selector, options) => {
+        try {
+            const hasFlags = options.model !== undefined || options.mode !== undefined;
+            if (!selector) {
+                if (hasFlags) {
+                    throw new Error('Selector is required when passing --model/--mode. Example: agents models set claude@2.1.220 --model opus-5');
+                }
+                const entries = listRunDefaults();
+                if (entries.length === 0) {
+                    console.log(chalk.gray('No agent defaults configured.'));
+                    console.log(chalk.gray('Set one with: agents models set claude@2.1.220 --model opus-5'));
+                    return;
+                }
+                console.log(chalk.bold('Agent Defaults\n'));
+                for (const entry of entries) {
+                    console.log(`  ${formatRunDefaultEntry(entry)}`);
+                }
+                return;
+            }
+            if (!hasFlags) {
+                const parsed = parseRunDefaultSelector(selector);
+                const entry = listRunDefaults().find((e) => e.selector === parsed.selector);
+                if (!entry || (!entry.defaults.mode && !entry.defaults.model)) {
+                    console.log(chalk.gray(`No default set for ${parsed.selector}.`));
+                    console.log(chalk.gray(`Set one with: agents models set ${selector} --model <model>`));
+                    return;
+                }
+                console.log(`  ${formatRunDefaultEntry(entry)}`);
+                return;
+            }
+            const entry = setRunDefault(selector, {
+                ...(options.mode !== undefined ? { mode: options.mode } : {}),
+                ...(options.model !== undefined ? { model: options.model } : {}),
+            });
+            console.log(chalk.green('Set default:'));
+            console.log(`  ${formatRunDefaultEntry(entry)}`);
+        }
+        catch (err) {
+            console.error(chalk.red(err.message));
+            process.exit(1);
+        }
+    });
+    setHelpSections(set, {
+        examples: `
+      agents models set claude@2.1.220 --model opus-5
+      agents models set 'claude:*' --mode auto --model opus
+      agents models set claude@2.1.220
+      agents models set
+    `,
+        notes: `
+      Selectors use <agent>@<version> or <agent>:<version>; * matches all versions.
+      Exact selectors override wildcard selectors field by field.
+      Writes the same store as 'agents config set run.<agent@version>.*'. Explicit flags on
+      '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')
         .description('Override which model a cost tier resolves to (per harness, or per agent@version).');
@@ -85,6 +153,7 @@ export function registerModelsCommand(program) {
         .description('Pin a tier to a model. selector: <agent> or <agent>@<version> (e.g. kimi, kimi@0.19.2).')
         .action((selector, tierName, model) => {
         try {
+            console.warn(tierDeprecation);
             const entry = setTierOverride(selector, tierName, model);
             console.log(chalk.green(`✓ ${entry.selector}  ${chalk.cyan(tierName.toLowerCase())} → ${chalk.bold(model)}`));
         }
@@ -98,6 +167,7 @@ export function registerModelsCommand(program) {
         .description('Clear one tier (or all tiers) back to the auto guess.')
         .action((selector, tierName) => {
         try {
+            console.warn(tierDeprecation);
             const changed = clearTierOverride(selector, tierName);
             console.log(changed ? chalk.green(`✓ cleared ${selector}${tierName ? ` ${tierName}` : ''}`) : chalk.gray('nothing to clear'));
         }
@@ -110,6 +180,7 @@ export function registerModelsCommand(program) {
         .command('list')
         .description('List all configured tier overrides.')
         .action(() => {
+        console.warn(tierDeprecation);
         const entries = listTierOverrides();
         if (entries.length === 0) {
             console.log(chalk.gray('No tier overrides — every tier uses the auto guess. Set one with `agents models tier set`.'));

package/dist/commands/monitors.d.ts

@@ -8,5 +8,4 @@
  * source instead of a clock.
  */
 import type { Command } from 'commander';
-/** Register the `agents monitors` command tree. */
 export declare function registerMonitorsCommands(program: Command): void;