@phnx-labs/agents-cli 1.22.34 → 1.22.37

package/dist/commands/projects.js

@@ -21,7 +21,7 @@ import { getActiveSessions } from '../lib/session/active.js';
 import { gatherRemoteActive } from '../lib/session/remote-active.js';
 import { gatherRemoteAgentsJson } from '../lib/remote-agents-json.js';
 import { formatFleetSummary, formatFleetWorkspaces, parseRemoteProbe, probeProjectWorkspaces, workspaceTargetsForDef, workspaceWarnings, } from '../lib/project-probe.js';
-import { listProjectDefs, loadProjectDef, writeProjectDef, removeProjectDef, projectDefPath, isSafeProjectName, validateProjectDef, } from '../lib/projects.js';
+import { listProjectDefs, loadProjectDef, writeProjectDef, removeProjectDef, projectDefPath, isSafeProjectName, validateProjectDef, projectNameForCwd, } from '../lib/projects.js';
 import { rollupSessionsByProject, withDefaultMachine, isDeadStatus, formatDeadSummary, liveDeadSplit, enrichProjectSignals, formatProjectMembersByHost, formatProjectWarnings, } from '../lib/project-status.js';
 import { fetchLinearProjectCounts } from '../lib/linear-project-counts.js';
 import { listLinearProjects, pickLinearProject } from '../lib/linear-projects.js';
@@ -33,6 +33,18 @@ import { buildLinearImportCandidates, validateImportOpts, } from '../lib/project
 export const PROJECTS_NO_FANOUT_ENV = 'AGENTS_PROJECTS_LOCAL';
 /** Max peers named in the skipped note before the rest collapse to `+N`. */
 const SKIPPED_NAME_LIMIT = 4;
+/**
+ * Render `agents projects for-cwd`'s output for a resolved (or absent)
+ * project name — `--json` always prints `{"name": ...}` even on no match, so
+ * a scripted caller can distinguish "ran and found nothing" from a crash;
+ * the plain-text form prints nothing on no match. Returns '' when nothing
+ * should be printed.
+ */
+export function formatForCwdOutput(name, json) {
+    if (json)
+        return JSON.stringify({ name: name ?? null });
+    return name ?? '';
+}
 /**
  * One compact trailing note for peers that didn't answer the `--fleet`
  * fan-out — unreachable, running an agents-cli too old to carry `projects
@@ -88,6 +100,34 @@ export function originSlug(cwd) {
         return undefined;
     }
 }
+/**
+ * Turn a `--dir` / `--add-dir` value into a `repos[]` row.
+ *
+ * The slug comes from the DIRECTORY'S OWN origin remote, never from its path:
+ * a checkout at `~/src/github.com/muqsitnawaz/agents-cli` whose origin is
+ * `phnx-labs/agents-cli` must record the remote it actually pushes to. Pass
+ * `slugOverride` for a directory with no origin (a vendored tree, a fresh
+ * `git init`).
+ *
+ * The stored `path` is left for `writeProjectDef` to normalize home-relative,
+ * so the same definition re-roots on every machine.
+ */
+export function projectRepoFromDir(dir, slugOverride) {
+    const abs = path.resolve(expandLocalHome(dir));
+    if (!fs.existsSync(abs))
+        return { ok: false, error: `No such directory: ${abs}` };
+    if (!fs.statSync(abs).isDirectory())
+        return { ok: false, error: `Not a directory: ${abs}` };
+    const slug = slugOverride ?? originSlug(abs);
+    if (!slug) {
+        return {
+            ok: false,
+            error: `${abs} has no origin remote, so its slug cannot be inferred.\n` +
+                `  Name it explicitly: --add-dir ${dir} --slug <owner/repo>`,
+        };
+    }
+    return { ok: true, repo: { slug, path: toHomeRelative(abs) } };
+}
 /**
  * List the workspace's Linear projects and plan their import, binding each to a
  * local checkout under the configured projects root when the names match
@@ -411,9 +451,12 @@ export function registerProjectsCommands(program) {
         examples: `
       agents projects import --from-linear  # the projects you actually track
       agents projects add rush --repo phnx-labs/rush --path apps/web
+      agents projects add rush --root ~/src/rush --dir ~/src/rush-infra  # bind another dir
+      agents projects set rush --add-dir ~/.agents/.system  # bind one more
+      agents projects set rush --rm-dir ~/src/rush-infra    # unbind it again
       agents projects list                 # definitions only (no session scan)
       agents projects list --with-agents   # opt-in local active counts
-      agents projects list --json          # machine-readable defs (Factory uses this)
+      agents projects list --json          # machine-readable defs (AGI EXT uses this)
       echo '{...}' | agents projects save --json  # create/update one def from stdin
       agents projects rm rush --json       # machine-readable delete
       agents projects status              # every project, across the whole fleet
@@ -425,8 +468,14 @@ export function registerProjectsCommands(program) {
     `,
         notes: `
       Definitions are hand-editable YAML in ~/.agents/projects/ and sync across
-      machines with 'agents push/pull'. Factory reads and writes only through
-      these commands — never ~/.agents/factory/projects.json.
+      machines with 'agents repo push user' / 'agents repo pull user'. AGI EXT
+      reads and writes only through these commands — never
+      ~/.agents/factory/projects.json.
+
+      A project may bind several directories ('--dir' / '--add-dir'). The cwd an
+      agent lands in is 'defaultPath' (else 'root') — set it with --root/--path,
+      not with --dir. Every bound directory other than that cwd rides along as
+      an --add-dir grant (Claude, Codex, Cursor, Kimi, Grok consume it; others ignore).
     `,
     });
     // ---- list ----
@@ -465,6 +514,17 @@ export function registerProjectsCommands(program) {
             console.log(`  ${chalk.bold(row.name.padEnd(w.name))} ${chalk.dim(row.path.padEnd(w.path))} ${chalk.cyan(row.repo.padEnd(w.repo))}${agentsSuffix}`);
         }
     });
+    // ---- for-cwd ----
+    projects
+        .command('for-cwd [cwd]')
+        .description('Resolve a directory to its defined project name (root or a repos[].path/subpath match). Defaults to the current directory.')
+        .option('--json', 'Machine-readable output: {"name": string | null}')
+        .action((cwdArg, opts) => {
+        const name = projectNameForCwd(cwdArg ?? process.cwd(), listProjectDefs());
+        const out = formatForCwdOutput(name, !!opts.json);
+        if (out)
+            console.log(out);
+    });
     // ---- add ----
     projects
         .command('add <name>')
@@ -472,6 +532,7 @@ export function registerProjectsCommands(program) {
         .option('--root <path>', 'Repo / monorepo root (defaults to the current git repo root)')
         .option('--path <subdir>', 'Default cwd for agents (a monorepo subdir)')
         .option('--repo <owner/repo>', 'Primary GitHub slug (defaults to the origin remote)')
+        .option('--dir <path...>', 'A directory this project binds; slug read from its origin. Repeatable')
         .option('--context <path:purpose...>', 'A described starting point; repeatable')
         .option('--goal <objective:measure...>', 'An outcome the project serves; repeatable')
         .option('--linear <url-or-id>', 'Linear project URL or id')
@@ -502,6 +563,18 @@ export function registerProjectsCommands(program) {
             def.defaultPath = `${root.replace(/\/$/, '')}/${opts.path.replace(/^\//, '')}`;
         if (repo)
             def.repo = repo;
+        if (opts.dir?.length) {
+            const repos = [];
+            for (const d of opts.dir) {
+                const r = projectRepoFromDir(d);
+                if (!r.ok) {
+                    console.error(chalk.red(r.error));
+                    process.exit(1);
+                }
+                repos.push(r.repo);
+            }
+            def.repos = repos;
+        }
         if (opts.context?.length)
             def.contexts = opts.context.map(parseContextFlag);
         if (opts.goal?.length)
@@ -513,6 +586,8 @@ export function registerProjectsCommands(program) {
         console.log(chalk.green(`Defined project "${name}"`));
         console.log(chalk.gray(`  ${target}`));
         console.log(chalk.gray(`  root ${def.root}${def.repo ? `  ·  repo ${def.repo}` : ''}`));
+        for (const r of def.repos ?? [])
+            console.log(chalk.gray(`  dir  ${r.path}  ·  ${r.slug}`));
     });
     /** Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
      *  deduped device filter; undefined when neither was given (= whole fleet). */
@@ -748,6 +823,9 @@ export function registerProjectsCommands(program) {
         .option('--path <subdir>', 'Default cwd for agents (a monorepo subdir)')
         .option('--description <text>', 'One-line description shown on the card')
         .option('--goal <objective:measure...>', 'Replace the goals this project serves; repeatable')
+        .option('--add-dir <path>', 'Bind another directory to this project; repeatable', (val, prev) => [...prev, val], [])
+        .option('--rm-dir <path>', 'Unbind a directory from this project; repeatable', (val, prev) => [...prev, val], [])
+        .option('--slug <owner/repo>', 'Slug for a single --add-dir whose origin cannot be read')
         .action((name, opts) => {
         const def = loadProjectDef(name);
         if (!def) {
@@ -755,10 +833,17 @@ export function registerProjectsCommands(program) {
             process.exit(1);
         }
         const fields = ['repo', 'root', 'path', 'description'].filter((k) => opts[k] !== undefined);
-        if (fields.length === 0 && !opts.goal?.length) {
+        const dirWork = opts.addDir.length > 0 || opts.rmDir.length > 0;
+        if (fields.length === 0 && !opts.goal?.length && !dirWork) {
             console.error(chalk.red('Nothing to set. Pass a field, e.g. --repo <owner/repo>.'));
             process.exit(1);
         }
+        // One --slug cannot name two directories. Refuse rather than guess which
+        // --add-dir it was meant for.
+        if (opts.slug && opts.addDir.length !== 1) {
+            console.error(chalk.red('--slug names a single --add-dir; pass exactly one --add-dir with it.'));
+            process.exit(1);
+        }
         // Load, mutate the named fields, write back — the `link` pattern. NEVER
         // the `add --force` pattern, which rebuilds the def from flags alone and
         // silently drops linear/contexts/integrations that were not re-passed.
@@ -784,12 +869,47 @@ export function registerProjectsCommands(program) {
             }
             def.defaultPath = `${base}/${opts.path.replace(/^\//, '')}`;
         }
+        // --rm-dir before --add-dir, so re-pointing one directory in a single
+        // command (`--rm-dir old --add-dir new`) does what it reads like.
+        const removed = [];
+        for (const d of opts.rmDir) {
+            const target = path.resolve(expandLocalHome(d));
+            const before = def.repos?.length ?? 0;
+            def.repos = (def.repos ?? []).filter((r) => !r.path || path.resolve(expandLocalHome(r.path)) !== target);
+            if ((def.repos.length ?? 0) === before) {
+                console.error(chalk.red(`"${def.name}" does not bind ${target} — nothing to remove.`));
+                process.exit(1);
+            }
+            removed.push(target);
+        }
+        const added = [];
+        for (const d of opts.addDir) {
+            const r = projectRepoFromDir(d, opts.slug);
+            if (!r.ok) {
+                console.error(chalk.red(r.error));
+                process.exit(1);
+            }
+            const target = path.resolve(expandLocalHome(r.repo.path));
+            const dup = (def.repos ?? []).some((x) => x.path && path.resolve(expandLocalHome(x.path)) === target);
+            if (dup) {
+                console.error(chalk.red(`"${def.name}" already binds ${target}.`));
+                process.exit(1);
+            }
+            def.repos = [...(def.repos ?? []), r.repo];
+            added.push(r.repo);
+        }
+        if (def.repos?.length === 0)
+            delete def.repos;
         writeProjectDef(def);
         console.log(chalk.green(`Updated ${def.name}`));
         for (const f of fields)
             console.log(chalk.gray(`  ${f}  ${f === 'path' ? def.defaultPath : def[f]}`));
         if (opts.goal?.length)
             console.log(chalk.gray(`  goals  ${def.goals?.map((g) => g.objective).join(' · ')}`));
+        for (const r of removed)
+            console.log(chalk.gray(`  - dir  ${toHomeRelative(r)}`));
+        for (const r of added)
+            console.log(chalk.gray(`  + dir  ${r.path}  ·  ${r.slug}`));
     });
     // ---- link ----
     projects

package/dist/commands/reconnect.js

@@ -81,11 +81,17 @@ export async function reconnectAction(id) {
     await focusAction(recent.id, {});
 }
 export function registerReconnectCommand(program) {
+    // Deprecated: superseded by `agents sessions resume`, which does the same
+    // attach-else-recover and additionally takes a tmux alias. Hidden + warned +
+    // functional for one release. Bare `reconnect` targeted the most recent
+    // session in this directory; that default now lives on `resume`'s picker.
     const cmd = program
-        .command('reconnect')
+        .command('reconnect', { hidden: true })
         .argument('[session-id]', 'Session id/prefix to reconnect (default: the most recent session started here)')
-        .description('Re-enter a dropped agent terminal: attach the live pane if it survived, else resume the session')
+        .description('Deprecated — use `agents sessions resume` instead.')
         .action(async (id) => {
+        console.warn(chalk.yellow('`agents reconnect` is deprecated — use `agents sessions resume` instead:'));
+        console.warn(chalk.gray(`  agents sessions resume${id ? ` ${id}` : ''}`));
         await reconnectAction(id);
     });
     setHelpSections(cmd, {
@@ -103,7 +109,7 @@ export function registerReconnectCommand(program) {
       - Best-effort recovery: a living remote tmux pane is JOINED (a second client, no fork); a dropped one is RESUMED on its origin device (a copy if it was mid-run, a /continue if idle).
       - With no id, targets the most recent session started from this directory (the terminal that most likely just dropped), not the full fleet picker. Falls back to the most recent session anywhere when this directory has none.
       - This is the manual companion to the automatic reconnect that runs during a live 'agents run --device <box>' when the network blinks; use it after that gave up or the terminal tab closed.
-      - Related: 'agents sessions focus' (attach/recover with a picker) and 'agents sessions resume' (multi-select history -> tabs).
+      - Deprecated: use 'agents sessions resume' — it attaches a live pane, foregrounds a headless session, or recovers an ended one.
     `,
     });
 }

package/dist/commands/repo.js

@@ -29,7 +29,7 @@ function resolveRepoPath(target) {
     return path.join(HOME, `.agents-${trimmed}`);
 }
 import { applyExtraAliasToVersions, ensureAgentsDir, getExtraRepoDir, getSystemAgentsDir, getUserAgentsDir, readMeta, resolveExtraRepoDir, updateMeta, } from '../lib/state.js';
-import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, getRemoteUrl, sameGitRemote, displayHomePath, } from '../lib/git.js';
+import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, getRemoteUrl, sameGitRemote, displayHomePath, syncRepoGit, } from '../lib/git.js';
 import { DEFAULT_SYSTEM_REPO } from '../lib/types.js';
 import { ALL_AGENT_IDS, isAgentName, resolveAgentName } from '../lib/agents.js';
 import { refresh } from '../lib/refresh.js';
@@ -1089,6 +1089,47 @@ export function registerRepoCommands(program) {
             }
         }
     });
+    // agents repo sync <name> — git-level sync for a single DotAgents repo.
+    // Replaces the git portion of the old `agents sync <repo>` verb.
+    // Semantics: system is pull-only (push: false); user and enabled extras push.
+    repoCmd
+        .command('sync <alias>')
+        .description('Git-sync a repo: pull (and push for user/extras). Aliases: "system", "user", or a registered extra.')
+        .addHelpText('after', `
+Examples:
+  # Pull the system repo (read-only mirror)
+  agents repo sync system
+
+  # Pull and push the user repo
+  agents repo sync user
+
+  # Sync a registered extra
+  agents repo sync work
+`)
+        .action(async (alias) => {
+        const targets = collectRepoTargets(alias);
+        if (!targets) {
+            process.exitCode = 1;
+            return;
+        }
+        for (const t of targets) {
+            if (!fs.existsSync(t.dir) || !isGitRepo(t.dir)) {
+                console.log(chalk.yellow(`  ${t.alias}: not a git repo, skipping`));
+                continue;
+            }
+            const push = t.alias !== 'system';
+            const spinner = ora(`Syncing ${formatRepoTarget(t.alias, t.dir)}...`).start();
+            const result = await syncRepoGit(t.dir, { push });
+            if (result.success) {
+                const pushed = result.pushed ? ' (pushed)' : '';
+                spinner.succeed(`${formatRepoTarget(t.alias, t.dir)}: ${result.commit}${pushed}`);
+            }
+            else {
+                spinner.fail(`${formatRepoTarget(t.alias, t.dir)}: ${result.error}`);
+                process.exitCode = 1;
+            }
+        }
+    });
     // Deprecated: superseded by `agents sync`. `agents sync --local` runs the same
     // reconcile stage (sync-umbrella.ts calls this exact `refresh()`), and `agents
     // sync <agent>` targets one agent — with the added reach `refresh` lacks

package/dist/commands/resource-view.d.ts

@@ -35,6 +35,23 @@ export interface ResourceViewOptions {
     filterVersion?: string;
     /** Emit machine-readable JSON instead of the picker/table (for agents/scripts). */
     json?: boolean;
+    /**
+     * Show the "Synced" column. Default true — the central-storage commands all
+     * answer "which agent versions have this?". `agents inspect <repo>` does not:
+     * there the repo IS the source, and empty `targets` would render the
+     * misleading "no installed versions". Set false to drop the column entirely.
+     */
+    showSync?: boolean;
+    /**
+     * Cap for the Name column. Defaults to NAME_CAP (22), which suits the
+     * central-storage commands. Kinds whose rows have no description — hooks are
+     * all script names and no prose — want a wider cap, otherwise four pairs of
+     * `00-agent-verify-work-complete…` truncate to the same string while the
+     * empty Description column wastes the rest of the terminal.
+     */
+    nameCap?: number;
+    /** Per-row OSC-8 link target, keyed by row name; makes names clickable. */
+    linkFor?: (row: ResourceRow) => string | undefined;
 }
 /** Display a resource list: interactive picker in TTY mode, plain table otherwise. */
 export declare function showResourceList(opts: ResourceViewOptions): Promise<void>;

package/dist/commands/resource-view.js

@@ -7,11 +7,15 @@
  * filtering, and paging.
  */
 import chalk from 'chalk';
-import { truncate, padVisible } from '../lib/format.js';
+import { truncate, padVisible, termLink } from '../lib/format.js';
 import { agentLabel } from '../lib/agents.js';
 import { itemPicker } from '../lib/picker.js';
 import { isInteractiveTerminal, isPromptCancelled, printWithPager } from './utils.js';
 import { terminalWidth, truncateToWidth, padToWidth, stringWidth, stripAnsi } from '../lib/session/width.js';
+/** Whether the Synced column renders for this view. */
+function syncEnabled(opts) {
+    return opts.showSync !== false;
+}
 /** Display a resource list: interactive picker in TTY mode, plain table otherwise. */
 export async function showResourceList(opts) {
     if (opts.json) {
@@ -74,7 +78,12 @@ function filterRows(rows, query) {
 }
 /** Row label rendered inside the picker list. */
 function formatPickerRow(row, opts) {
-    const name = chalk.cyan(padVisible(row.name, 22));
+    // Link here, not in the wide table: that renders only when stdout is NOT a
+    // TTY, and termLink is a no-op off-TTY — so a link there could never appear.
+    // The picker is the TTY path, which is where the pre-picker list had one.
+    const linkTarget = opts.linkFor?.(row);
+    const padded = chalk.cyan(padVisible(row.name, opts.nameCap ?? 22));
+    const name = linkTarget ? termLink(padded, linkTarget) : padded;
     const extra = opts.extraLabel
         ? chalk.gray(padVisible(row.extra ?? '-', 10))
         : '';
@@ -82,6 +91,10 @@ function formatPickerRow(row, opts) {
         ? chalk.gray(padVisible(row.extra2 ?? '-', 16))
         : '';
     const descRaw = row.description ? truncate(row.description, 40) : '';
+    if (!syncEnabled(opts)) {
+        // No sync column: give the reclaimed width back to the description.
+        return `${name} ${extra}${extra2}${chalk.gray(row.description ? truncate(row.description, 84) : '')}`;
+    }
     const desc = padVisible(chalk.gray(descRaw), 42);
     const sync = formatSyncSummary(row.targets, opts);
     return `${name} ${extra}${extra2}${desc} ${sync}`;
@@ -100,7 +113,9 @@ export function resourceLayout(cols, o) {
     const extraW = o.hasExtra ? 10 : 0;
     const extra2W = o.hasExtra2 ? 16 : 0;
     // Cap Sync so a long "missing on …" tail can't starve the description.
-    const syncW = Math.min(o.syncW, Math.max(14, Math.floor(cols * 0.32)));
+    // syncW 0 means the caller dropped the column — keep it 0 rather than
+    // floor it to 14, which would reserve width for a column we never draw.
+    const syncW = o.syncW === 0 ? 0 : Math.min(o.syncW, Math.max(14, Math.floor(cols * 0.32)));
     const fixed = o.nameW + 1 + (extraW ? extraW + 1 : 0) + (extra2W ? extra2W + 1 : 0) + 1 + syncW;
     const descW = cols - fixed;
     return {
@@ -116,8 +131,10 @@ export function resourceLayout(cols, o) {
 function printResourceTable(opts) {
     const cols = terminalWidth();
     const syncStrings = opts.rows.map((r) => formatSyncSummary(r.targets, opts));
-    const nameW = Math.min(NAME_CAP, Math.max('Name'.length, ...opts.rows.map((r) => stringWidth(r.name))));
-    const syncMax = Math.max('Synced'.length, ...syncStrings.map((s) => stringWidth(s)));
+    const nameW = Math.min(opts.nameCap ?? NAME_CAP, Math.max('Name'.length, ...opts.rows.map((r) => stringWidth(r.name))));
+    const syncMax = syncEnabled(opts)
+        ? Math.max('Synced'.length, ...syncStrings.map((s) => stringWidth(s)))
+        : 0;
     const layout = resourceLayout(cols, {
         hasExtra: Boolean(opts.extraLabel),
         hasExtra2: Boolean(opts.extra2Label),
@@ -153,28 +170,33 @@ function renderResourceWideTable(opts, L, syncStrings) {
     if (L.extra2W)
         headerParts.push(cell(opts.extra2Label ?? '', L.extra2W, chalk.bold));
     headerParts.push(cell('Description', L.descW, chalk.bold));
-    headerParts.push(chalk.bold('Synced'));
-    console.log(headerParts.join(' '));
-    const contentW = L.nameW + 1 + (L.extraW ? L.extraW + 1 : 0) + (L.extra2W ? L.extra2W + 1 : 0) + L.descW + 1 + L.syncW;
+    if (L.syncW)
+        headerParts.push(chalk.bold('Synced'));
+    console.log(headerParts.join(' ').trimEnd());
+    const contentW = L.nameW + 1 + (L.extraW ? L.extraW + 1 : 0) + (L.extra2W ? L.extra2W + 1 : 0) + L.descW + (L.syncW ? 1 + L.syncW : 0);
     console.log(chalk.gray('─'.repeat(Math.min(contentW, terminalWidth()))));
     opts.rows.forEach((row, i) => {
+        // No link here: this path renders only when stdout is not a TTY, where
+        // termLink is a no-op. The picker (formatPickerRow) carries the link.
         const parts = [cell(row.name, L.nameW, chalk.cyan)];
         if (L.extraW)
             parts.push(cell(row.extra ?? '-', L.extraW));
         if (L.extra2W)
             parts.push(cell(row.extra2 ?? '-', L.extra2W));
         parts.push(cell(row.description ?? '-', L.descW, chalk.gray));
-        let sync = syncStrings[i] ?? '';
-        if (stringWidth(sync) > L.syncW)
-            sync = chalk.gray(truncateToWidth(sync, L.syncW));
-        parts.push(sync);
-        console.log(parts.join(' '));
+        if (L.syncW) {
+            let sync = syncStrings[i] ?? '';
+            if (stringWidth(sync) > L.syncW)
+                sync = chalk.gray(truncateToWidth(sync, L.syncW));
+            parts.push(sync);
+        }
+        console.log(parts.join(' ').trimEnd());
     });
 }
 /** Stacked cards for narrow terminals: name + meta on one line, description below. */
 function renderResourceCards(opts, cols, syncStrings) {
     opts.rows.forEach((row, i) => {
-        const meta = [row.extra, row.extra2, stripAnsi(syncStrings[i] ?? '')]
+        const meta = [row.extra, row.extra2, syncEnabled(opts) ? stripAnsi(syncStrings[i] ?? '') : '']
             .filter((s) => Boolean(s && s.trim()))
             .join(' · ');
         const metaBudget = Math.max(8, cols - stringWidth(row.name) - 2);

package/dist/commands/resume.js

@@ -59,8 +59,15 @@ export function registerResumeCommand(program) {
         const pinnedHere = consumeResumePinned() || !!options.here;
         const outcome = await resolveSessionMetadataValue(sessionId.trim());
         if (outcome.kind === 'partial') {
-            console.error(chalk.red(`Could not resolve session while these devices were unavailable: ${outcome.failedPeers.join(', ')}`));
-            process.exitCode = 2;
+            // RUSH-2492: an unreachable peer is a warning, not a hard failure. The
+            // resolver already resolves an id found on the reachable fleet (SES-9a),
+            // so reaching here means the session was not found on any device we COULD
+            // reach — it may live on an unreachable peer, which we could not check.
+            const offline = outcome.failedPeers;
+            console.error(chalk.yellow(`Warning: ${offline.length} device(s) unreachable, not checked: ${offline.join(', ')}`));
+            console.error(chalk.red(`No session matching "${sessionId}" on any reachable device (${offline.length} unreachable, not checked).`));
+            console.error(chalk.gray('  If it lives on an offline box, wake it (agents devices) or run there: agents ssh <device>'));
+            process.exitCode = 1;
             return;
         }
         if (outcome.kind === 'not-found') {

package/dist/commands/routines.d.ts

@@ -46,8 +46,6 @@ export declare function groupRoutineJobsByDevice(jobs: JobConfig[], registry: De
  */
 export declare function groupRoutineJobsByProject(jobs: JobConfig[], knownProjectNames: Set<string>): RoutineListGroup[];
 export declare function buildRunsJson(runs: RunMeta[]): Record<string, unknown>[];
-/** Build the exact structured routine rows shared by `routines list --json`
- * and the one-process AGI Menu snapshot. */
 export declare function buildRoutineListJson(): Record<string, unknown>[];
 /** Register the `agents routines` command tree. */
 export declare function registerRoutinesCommands(program: Command): void;