@phnx-labs/agents-cli 1.22.113 → 1.22.115

package/dist/commands/detach-core.d.ts

@@ -18,7 +18,7 @@ export declare const BACKGROUND_NUDGE: string;
  */
 export declare function buildBackgroundArgv(agent: string, sessionId: string, cwd?: string): string[];
 /** What to do with a resolved session, given which machine we're on. */
-export type DetachTarget = {
+type DetachTarget = {
     kind: 'local';
     sessionId: string;
 } | {
@@ -44,3 +44,4 @@ export declare function resolveDetachTarget(s: ActiveSession, self: string): Det
 export declare function resolveOne(activeById: Map<string, ActiveSession>, id: string): ActiveSession | {
     error: string;
 };
+export {};

package/dist/commands/detach.d.ts

@@ -13,6 +13,3 @@ export declare function registerDetachCommand(program: Command): void;
  * socket; it is a parameter only so a test can drive an isolated tmux server.
  */
 export declare function stopInteractive(s: ActiveSession, socket?: string): Promise<void>;
-export declare function detachAction(id: string, opts?: {
-    local?: boolean;
-}): Promise<void>;

package/dist/commands/detach.js

@@ -2,7 +2,7 @@
  * `agents sessions detach <id>` — send a live agent session to the background:
  * stop its interactive process and continue it headless, unattended, so it drives
  * its task to completion without holding a terminal. Bring it back with
- * `agents sessions attach`. A sibling of `sessions focus`/`resume` on the session
+ * `agents sessions resume`. A sibling of `sessions focus` on the session
  * lifecycle axis.
  *
  * Agent-agnostic and version-pinned by construction: it re-invokes
@@ -18,7 +18,7 @@ import { gatherLiveTargets } from './go.js';
 import { killSession } from '../lib/tmux/index.js';
 import { getDefaultSocketPath } from '../lib/tmux/paths.js';
 import { getAgentsInvocation } from '../lib/daemon/daemon.js';
-import { captureProcessStartTime } from '../lib/pty-server.js';
+import { captureProcessStartTime } from '../lib/platform/process.js';
 import { writeDetachRecord } from '../lib/session/detached.js';
 import { getLogsDir } from '../lib/state.js';
 import { runOnPeer } from '../lib/session/remote-list.js';
@@ -122,7 +122,7 @@ function spawnHeadless(command, args, logFile) {
         });
     });
 }
-export async function detachAction(id, opts = {}) {
+async function detachAction(id, opts = {}) {
     const { self, activeById } = await gatherLiveTargets(!!opts.local, { includeCloud: true, selector: id });
     const resolved = resolveOne(activeById, id);
     if ('error' in resolved) {

package/dist/commands/doctor.d.ts

@@ -18,9 +18,8 @@
  * Read-only always: doctor diagnoses, it never mutates. To fix the gaps it
  * finds — install missing resources, repair Claude-invalid plugin manifests,
  * refresh stale plugins, reconcile drift, repair hook runtime shims — run
- * `agents sync <agent>@all` (the one fixer, a superset of the old `doctor
- * --fix`). Run `agents prune cleanup` to act on orphan readouts. `--fix` is a
- * deprecated no-op that now errors with a pointer to `agents sync`.
+ * `agents sync <agent>@all` (the one fixer). Run `agents prune cleanup` to act
+ * on orphan readouts.
  */
 import type { Command } from 'commander';
 import { type FleetInventory } from '../lib/devices/fleet-divergence.js';

package/dist/commands/doctor.js

@@ -1251,7 +1251,6 @@ export function registerDoctorCommand(program) {
         .description('Diagnose CLI availability, sync status, and resource divergence (optionally for a specific agent[@version]).')
         .option('--json', 'Output machine-readable JSON')
         .option('--diff', 'In target mode, include unified diffs for divergent files')
-        .option('--fix', '(deprecated) doctor is diagnose-only — this errors with a pointer to `agents sync`, the one fixer')
         .option('--kind <kinds>', 'Restrict to comma-separated resource kinds (commands,skills,hooks,rules,mcp,permissions,subagents,plugins,workflows,memory)')
         .option('--cwd <path>', 'Resolution cwd for project layer detection (default: process.cwd())')
         .option('--adopt <agent>', "Take over the agent's native launcher that shadows the shim (symlink it to the version-managed shim; reversible with --release)")
@@ -1381,16 +1380,6 @@ export function registerDoctorCommand(program) {
             }
             return;
         }
-        // `doctor --fix` moved to `agents sync` — doctor is diagnose-only now.
-        // Keep the flag for one release as a signpost: it never heals, it points at
-        // the one fixer and exits non-zero so scripts and muscle memory get a clear
-        // redirect instead of a silent no-op.
-        if (opts.fix) {
-            const where = target ? `agents sync ${target}` : 'agents sync <agent>@all';
-            console.error(chalk.yellow('`agents doctor --fix` has moved to `agents sync`.'));
-            console.error(chalk.gray(`  doctor now only diagnoses. To fix, run: ${where}`));
-            process.exit(1);
-        }
         if (!target) {
             // Singleflight + short-TTL cache for the bare `doctor --json` overview.
             // This overview probes every host CLI, every agent's sign-in, and every

package/dist/commands/events.d.ts

@@ -42,13 +42,11 @@ export interface EventsOptions {
     limit?: string;
     json?: boolean;
     follow?: boolean;
-    /** @deprecated Prefer --include ops / --exclude activity */
-    audit?: boolean;
     include?: string;
     exclude?: string;
 }
 /** Add the one canonical event-reader option surface to a command or alias. */
-export declare function addEventsReadOptions(command: Command, includeAuditFlag?: boolean): Command;
+export declare function addEventsReadOptions(command: Command): Command;
 /** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
 export declare function runEventsCommand(options: EventsOptions, forceAudit?: boolean): Promise<void>;
 /** Shared by `events stats` and the `logs stats` alias. */

package/dist/commands/events.js

@@ -195,7 +195,7 @@ function registerEmitSubcommand(events) {
     });
 }
 /** Add the one canonical event-reader option surface to a command or alias. */
-export function addEventsReadOptions(command, includeAuditFlag = true) {
+export function addEventsReadOptions(command) {
     command
         .option('--include <families>', `Only these families (comma-sep): ${EVENT_FAMILIES.join(', ')}`)
         .option('--exclude <families>', `Drop these families (comma-sep): ${EVENT_FAMILIES.join(', ')}`)
@@ -211,9 +211,6 @@ export function addEventsReadOptions(command, includeAuditFlag = true) {
         .option('--limit <n>', 'Max records to show; 0 for no cap (default 50)', '50')
         .option('--json', 'Output raw records as JSON')
         .option('-f, --follow', "Tail today's operational log live");
-    if (includeAuditFlag) {
-        command.option('--audit', 'Deprecated: operational events only — prefer --include ops or --exclude activity');
-    }
     return command;
 }
 /** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
@@ -242,11 +239,11 @@ export async function runEventsCommand(options, forceAudit = false) {
         process.exitCode = 2;
         return;
     }
-    // --audit / forceAudit = ops-only when no family flags. Families own the
-    // source selection via applyFamilies — never override includeActivity after.
+    // forceAudit (`events audit` / `logs`) = ops-only when no family flags. Families
+    // own the source selection via applyFamilies — never override includeActivity after.
     const includeActivity = (includeFamilies !== undefined || excludeFamilies !== undefined)
         ? true
-        : !(forceAudit || options.audit);
+        : !forceAudit;
     const fetched = readUnifiedEvents({
         startDate,
         eventTypes: options.event && options.event.length ? options.event : undefined,

package/dist/commands/exec.d.ts

@@ -53,7 +53,6 @@ interface ExecCommandActionOptions {
      * @deprecated Hidden alias for `--device auto`. Resolved before host dispatch.
      * Remove after one release.
      */
-    smart?: boolean;
     acp?: boolean;
     yes?: boolean;
     loop?: boolean;

package/dist/commands/exec.js

@@ -660,8 +660,6 @@ export function registerRunCommand(program) {
     // `--on` and `--computer` are hidden aliases of `--device` — same behavior.
     runCmd.addOption(new Option('--on <name>', 'Alias of --device.').hideHelp());
     runCmd.addOption(new Option('--computer <name>', 'Alias of --device.').hideHelp());
-    // Deprecated one-release alias: `agents run … --smart` → treat as `--device auto`.
-    runCmd.addOption(new Option('--smart', 'Deprecated: use --device auto (affinity host pick).').hideHelp());
     // Internal: the `--device` dispatch forwards this so the REMOTE run prints its
     // resolved session id as a one-line stdout sentinel (hosts/session-marker.ts),
     // letting the launcher relate the remote-created session back to itself for
@@ -1226,7 +1224,7 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
         const defaultPlacement = bareInteractiveRunDefaultsToDeviceAuto(options, { prompt, devicePickerRequested }, { tty: isInteractiveTerminal(), json: options.json });
         if (defaultPlacement)
             options.device = 'auto';
-        // --device auto (and deprecated --smart): live fleet pick.
+        // --device auto: live fleet pick.
         // Harness is always the agent the user typed — never auto-picked.
         // Placement failure propagates; an automatic request never becomes local.
         {
@@ -1252,9 +1250,6 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
                 console.error(chalk.gray(`Run here instead: agents run ${runBaseAgentName} --device ${machineId()}`));
                 process.exit(1);
             }
-            if (!options.quiet && result.deprecationSmart) {
-                process.stderr.write(chalk.yellow('[agents] --smart is deprecated; use --device auto\n'));
-            }
             if (!options.quiet && result.banner) {
                 const { hostLabel, deviceHint, acctNote } = result.banner;
                 process.stderr.write(chalk.gray(`[agents] device=auto → ${hostLabel}` +
@@ -2064,7 +2059,7 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
             import('../lib/run-defaults.js'),
             import('../lib/mcp.js'),
             import('../lib/capabilities.js'),
-            import('../lib/share/config.js'),
+            import('../lib/share-runtime.js'),
         ]);
         bootMark('run-deps:imported');
         const isValidAgent = (agent) => ALL_AGENT_IDS.includes(agent);

package/dist/commands/feed-watch.js

@@ -1,10 +1,51 @@
-import { machineId } from '../lib/machine-id.js';
 import { setHelpSections } from '../lib/help.js';
-import { watchFleetFeed, watchLocalFeed } from '../lib/feed/watch.js';
+import { streamFeedFromHub, waitForHub } from '../lib/feed/hub-server.js';
+import { ensureDaemonStarted } from '../lib/daemon/daemon.js';
+/**
+ * Attach to the daemon's shared collector, starting the daemon if it is not up.
+ *
+ * There is deliberately no in-process fallback: running `watchFleetFeed` here
+ * would give this reader its own ssh child per peer, which is exactly the
+ * per-caller fan-out the hub exists to collapse (see `lib/feed/hub.ts`). So a
+ * missing hub is answered by starting its owner and WAITING for it.
+ *
+ * The wait is what makes that honest. `ensureDaemonStarted()` returns once the
+ * process is spawned, long before it has loaded its services and bound the
+ * socket, so retrying immediately raced the bind and reported a daemon that was
+ * about to be perfectly healthy as unavailable. The final error is the one from
+ * the last real attempt, not the first.
+ */
+async function attachToHub(signal, emit, scope) {
+    try {
+        await streamFeedFromHub({ signal, emit, scope });
+        return;
+    }
+    catch (first) {
+        if (signal.aborted)
+            return;
+        ensureDaemonStarted();
+        if (!await waitForHub()) {
+            throw new Error(`the shared feed stream did not come up: ${first.message}\n`
+                + 'Next: agents daemon status, then agents daemon services enable feed-stream');
+        }
+        try {
+            await streamFeedFromHub({ signal, emit, scope });
+        }
+        catch (second) {
+            throw new Error(`the shared feed stream is unavailable: ${second.message}\n`
+                + 'Next: agents daemon status, then agents daemon services enable feed-stream');
+        }
+    }
+}
 export function registerFeedWatchCommand(parent) {
-    const command = parent.command('watch').description('Stream the canonical agent, attention, and activity projection as NDJSON')
+    const command = parent.command('watch').description('Stream the canonical agent, attention, tool, and activity projection as NDJSON')
         .option('--json', 'Emit versioned NDJSON envelopes').option('--local', 'Watch only this machine');
-    setHelpSections(command, { examples: `agents feed watch --json\nagents feed watch --json --local`, notes: 'Order by streamId + sequence. Unavailable scopes retain their last rows until reset on reconnect.' });
+    setHelpSections(command, {
+        examples: `agents feed watch --json\nagents feed watch --json --local`,
+        notes: 'Order by streamId + sequence. Unavailable scopes retain their last rows until reset on reconnect. '
+            + 'The fleet stream is served by the daemon\'s shared collector, so several readers cost one connection per peer; '
+            + '--local is the per-machine stream the collector itself subscribes to over ssh.',
+    });
     command.action(async (_opts, invoked) => {
         const opts = invoked.optsWithGlobals();
         if (!opts.json)
@@ -15,10 +56,13 @@ export function registerFeedWatchCommand(parent) {
         process.once('SIGINT', stop);
         process.once('SIGTERM', stop);
         try {
-            if (opts.local)
-                await watchLocalFeed({ scope: machineId(), signal: controller.signal, emit });
-            else
-                await watchFleetFeed({ signal: controller.signal, emit });
+            // BOTH scopes go through the daemon's shared collectors. `--local` used to
+            // run its own `watchLocalFeed`, so every observing box's ssh subscription
+            // built a separate activity cursor set, tool watcher and setup subscription
+            // on the SAME peer. The local collector is a distinct hub from the fleet one
+            // (`feed-stream-service.ts`) and its watcher dials no peer at all, so a
+            // local reader can never trigger a fan-out, recursively or otherwise.
+            await attachToHub(controller.signal, emit, opts.local ? 'local' : 'fleet');
         }
         finally {
             process.off('SIGINT', stop);

package/dist/commands/feed.d.ts

@@ -21,7 +21,6 @@ import { type OutcomeGroup, type SessionOutcomeHint } from '../lib/feed-outcome.
 import { filterBlocksForFeed } from '../lib/ask-classifier.js';
 import { type FeedSessionSignal } from '../lib/feed-ranking.js';
 export declare const FEED_POST_HELP = "\nExamples:\n  # Title (subject) + body. Phone broadcasts put title first, body after a\n  # blank line, then a \"Sent from agent/session on host\" footer.\n  agents feed post --title \"CHANGELOG pushed\" \"Watching CI and mac-mini E2E\"\n  agents feed post --title \"Cover ready\" \"render at ./out/cover.png\" --attach ./out/cover.png\n  agents feed post --title \"Ready for review\" \"PR opened, waiting on prix-cloud\" --json\n\n  # Worth interrupting someone over - reaches sinks gated on minLevel: important:\n  agents feed post --title \"npm token expired\" \"Cannot publish the release\" --level important\n\n  # Also raise a local desktop banner on THIS machine (same notifier as run\n  # --notify), on top of any configured broadcast - useful when you are at the box:\n  agents feed post --title \"Build green\" \"all checks passed\" --notify\n\n  # Stuck: opens a needs-you block and always broadcasts at important:\n  agents feed post --title \"Force-push denied\" \"git-guard blocked PR #1749\" --blocked\n  agents feed post --title \"Publish or wait?\" \"npm publish now or after review\" --blocked --option publish --option wait\n  agents feed post --title \"Delete preview env?\" \"stale preview still running\" --blocked --default \"leave it\"\n\n  # Exhaust self-serve FIRST. A block is for what you genuinely cannot do:\n  # a credential only the user holds, a decision only they can make, an\n  # approval only they can give. Not \"should I do the obvious next step?\".\n\n  # Outside a run, pass the session explicitly:\n  agents feed post --title \"Manual note\" \"context for the next agent\" --session 00998b0e-2d15-4d2f-a58b-974a886c9b47\n\nIdentity (session, agent, host, runtime, pid, launchId) is stamped automatically\nand rides the phone footer of feed.broadcast {message}. Domain facts (tickets,\nPRs) are not CLI flags - the ticket is joined from the session index at post\ntime. No em-dashes in title/body - they are scrubbed on the way out.\n\nConfigure where a post is mirrored under feed.broadcast in agents.yaml - see\ndocs/observability.md. A channel sink may set message: with placeholders such\nas {message} and {ticket}; a missing placeholder skips that sink. A milestone is always recorded, but it does not text\nthe owner when the sink has minLevel: important. Add --level important for a\nphone-worthy successful update. Use --blocked only when work cannot continue.\nThe owner destination comes from humans.yaml; do not duplicate it in agents.yaml.\n";
-export declare const FEED_NO_FANOUT_ENV = "AGENTS_FEED_LOCAL";
 /** Right-hand masthead summary: `N blocks · M agents`. */
 export declare function formatFeedMastheadRight(blocks: OpenBlock[]): string;
 /** Reply hint matching the shared fleet-comms reply line. */
@@ -29,7 +28,7 @@ export declare function formatFeedReplyHint(mailboxId: string): string;
 export declare function parseRemoteFeed(stdout: string, machine: string): OpenBlock[];
 /** Merge local and remote rows, keeping the first copy of a host/session block. */
 export declare function mergeFeedBlocks(...groups: OpenBlock[][]): OpenBlock[];
-export type FeedControlAction = 'pause' | 'kill';
+type FeedControlAction = 'pause' | 'kill';
 export declare function controlFeedSession(action: FeedControlAction, target: string, signals: FeedSessionSignal[]): Promise<string>;
 export declare function shouldIncludeLocalFeed(hosts: string[] | undefined, self: string): boolean;
 export declare function remoteFeedHostsToDial(hosts: string[] | undefined, self: string): string[] | undefined;
@@ -85,6 +84,7 @@ export declare function loadSessionMetasForFeedEnrichment<T>(load: () => Promise
 }>;
 export declare function registerFeedCommand(program: Command): void;
 /** Feed view selector (RUSH-2015): decisions, progress, or both. */
-export type FeedFilter = 'needs' | 'updates' | 'all';
+type FeedFilter = 'needs' | 'updates' | 'all';
 /** Normalize a raw --filter value; unknown/empty falls back to the default. */
 export declare function resolveFeedFilter(raw: string | undefined): FeedFilter;
+export {};

package/dist/commands/feed.js

@@ -65,7 +65,7 @@ the owner when the sink has minLevel: important. Add --level important for a
 phone-worthy successful update. Use --blocked only when work cannot continue.
 The owner destination comes from humans.yaml; do not duplicate it in agents.yaml.
 `;
-export const FEED_NO_FANOUT_ENV = 'AGENTS_FEED_LOCAL';
+const FEED_NO_FANOUT_ENV = 'AGENTS_FEED_LOCAL';
 /** Right-hand masthead summary: `N blocks · M agents`. */
 export function formatFeedMastheadRight(blocks) {
     const agents = new Set(blocks.map((b) => b.mailboxId)).size;

package/dist/commands/focus.d.ts

@@ -20,7 +20,7 @@ export { looksLikeTmuxAlias, resolveTmuxAliasState, shouldAttachLocalTmuxAliasBe
 import { type LiveStatusFilter } from './sessions.js';
 import { openSurfaces, type Backend } from '../lib/terminal/index.js';
 /** Options for `sessions focus` — device scope + the `--active` live-state filters. */
-export interface FocusOptions {
+interface FocusOptions {
     /**
      * Resolve the target from the launcher's AGENT_LAUNCH_ID instead of a session
      * id (RUSH-3125).
@@ -123,7 +123,7 @@ export declare function focusSelectedSession(meta: SessionMeta, active: ActiveSe
  *    running); never a silent drop.
  *  - `skip` — not resumable AND no rail: reported, not dropped.
  */
-export type FocusSurfacePlan = {
+type FocusSurfacePlan = {
     kind: 'attach';
     command: string[];
     note: string;
@@ -152,9 +152,9 @@ export declare function tmuxAttachScript(mux: {
  */
 export declare function planFocusSurface(s: ActiveSession, self: string, resumeCommandFor: (s: ActiveSession) => string[] | null, rail?: AttachRailLiveness): FocusSurfacePlan;
 /** The engine seam — real `openSurfaces`, overridable in tests to assert the tab requests. */
-export type OpenSurfacesFn = typeof openSurfaces;
+type OpenSurfacesFn = typeof openSurfaces;
 /** Test seams for `openFocusTabs`: inject the engine boundary + force a backend. */
-export interface OpenFocusTabsDeps {
+interface OpenFocusTabsDeps {
     open?: OpenSurfacesFn;
     /** Skip `resolveBackend` (which needs a live terminal) when set — tests pass 'tmux'. */
     backend?: Backend | 'inplace';

package/dist/commands/focus.js

@@ -136,7 +136,7 @@ export function registerFocusCommand(program) {
       # Resolve latest on yosemite-s0, then pick from that version's sessions
       agents sessions focus claude@latest --device yosemite-s0
 
-      # Attach only — refuse if nothing is joinable (old sessions go)
+      # Attach only — refuse if nothing is joinable
       agents sessions focus a1b2c3d4 --attach-only
 
       # Pick from live sessions on this machine only

package/dist/commands/go.d.ts

@@ -1,23 +1,6 @@
-/**
- * `agents sessions go [id]` — DEPRECATED alias for `agents sessions focus --attach-only`.
- *
- * `go` was "attach or refuse" (never fork/resume). `focus --attach-only` is exactly
- * that behavior, so `go` now prints a deprecation notice and delegates to `focusAction`.
- *
- * This file still owns the shared reach engine that `focus` imports:
- *   - `gatherLiveTargets` / `pickLiveTarget` / `buildLivePool` — live-session discovery + picker
- *   - `jumpTo` — the side-effecting jump: attach the already-running terminal
- *       local tmux    -> attach (switch-client when already inside tmux)
- *       local Ghostty -> focus its tab (Cmd+<n> via System Events; tab # from ghostty-tabs)
- *       remote tmux   -> ssh -tt + tmux attach (pane->session resolved on the remote)
- *       otherwise     -> hand off to the `UnreachableFallback` (attach-only refuses; focus resumes)
- *   - `refuseFallback` — the attach-only fallback (remote -> login shell; local -> refuse)
- */
-import type { Command } from 'commander';
 import { type ActiveSession } from '../lib/session/active.js';
 import type { SessionMeta } from '../lib/session/types.js';
 import { type LiveStatusFilter } from './sessions.js';
-export declare function registerGoCommand(program: Command): void;
 /**
  * Scope a live-session pool by device and live status. Pure so the `focus`
  * device/status filters are unit-testable without touching the sweep. `hosts`

package/dist/commands/go.js

@@ -1,10 +1,6 @@
 /**
- * `agents sessions go [id]` — DEPRECATED alias for `agents sessions focus --attach-only`.
- *
- * `go` was "attach or refuse" (never fork/resume). `focus --attach-only` is exactly
- * that behavior, so `go` now prints a deprecation notice and delegates to `focusAction`.
- *
- * This file still owns the shared reach engine that `focus` imports:
+ * The shared live-session reach engine that `sessions focus` / `resume --attach-only`
+ * import ("attach or refuse", never fork/resume):
  *   - `gatherLiveTargets` / `pickLiveTarget` / `buildLivePool` — live-session discovery + picker
  *   - `jumpTo` — the side-effecting jump: attach the already-running terminal
  *       local tmux    -> attach (switch-client when already inside tmux)
@@ -26,7 +22,6 @@ import { dedupeByMachineSession, mergeLocalFirst, pickSessionInteractive, matche
 import { buildPreview } from './sessions-picker.js';
 import { multiItemPicker } from '../lib/picker.js';
 import { isPromptCancelled } from './utils.js';
-import { focusAction } from './focus.js';
 import { machineId } from '../lib/session/sync/config.js';
 import { attachTmux, runTmux } from '../lib/tmux/binary.js';
 import { ensureSessionHookRepaired, paneExitStatus, teardownIfAgentExited } from '../lib/tmux/session.js';
@@ -36,18 +31,6 @@ import { connectionEndedNotice } from '../lib/hosts/reconnect.js';
 import { enumerateGhosttyTabs, assignGhosttyTabs } from '../lib/session/ghostty-tabs.js';
 import { addressabilityRecoveryHint } from '../lib/terminal/resolve.js';
 const execFileAsync = promisify(execFile);
-export function registerGoCommand(program) {
-    program
-        .command('go', { hidden: true })
-        .argument('[id]', 'Short/full session id to jump to; omit for an interactive picker')
-        .option('--local', 'Only this machine (skip the cross-host sweep)')
-        .description('Deprecated — use `agents sessions resume --attach-only` instead.')
-        .action(async (id, opts) => {
-        console.warn(chalk.yellow('`agents sessions go` is deprecated — use `agents sessions resume --attach-only` instead:'));
-        console.warn(chalk.gray(`  agents sessions resume ${id ?? '<id>'} --attach-only`));
-        await focusAction(id, { local: opts.local, attachOnly: true });
-    });
-}
 /**
  * Scope a live-session pool by device and live status. Pure so the `focus`
  * device/status filters are unit-testable without touching the sweep. `hosts`

package/dist/commands/harness-hooks.d.ts

@@ -18,13 +18,6 @@
 import type { AgentId } from '../lib/types.js';
 import { type ModelInfo } from '../lib/models.js';
 import { type WizardHooks, type WizardIO, type WizardChoice } from './harness-wizard.js';
-/**
- * The installed version whose model catalog to read for a host. The wizard has
- * no version in hand for a fresh create, so it reads the host's default (or its
- * sole installed) version — the same version a bare `agents run <host>` uses.
- * Null when the host has no installed version to probe (→ free-text model).
- */
-export declare function catalogVersionFor(host: AgentId): string | null;
 /**
  * Build the model `select` choices from a catalog. Pure, so the labelling +
  * escape-hatch rows are unit-tested with no catalog probe. Every list ends with

package/dist/commands/harness-hooks.js

@@ -29,7 +29,7 @@ const KEEP_MODEL = '__keep_model__';
  * sole installed) version — the same version a bare `agents run <host>` uses.
  * Null when the host has no installed version to probe (→ free-text model).
  */
-export function catalogVersionFor(host) {
+function catalogVersionFor(host) {
     return getGlobalDefault(host) || listInstalledVersions(host)[0] || null;
 }
 /**

package/dist/commands/harness-wizard.d.ts

@@ -132,13 +132,13 @@ export interface HarnessEditable {
     fallback: boolean;
 }
 /** One field's editability plus, when disabled, the one-line reason to surface. */
-export interface EditableField {
+interface EditableField {
     enabled: boolean;
     /** Set only when `enabled` is false — the greyed field's stated reason. */
     reason?: string;
 }
 /** Per-host editability with a reason attached to every disabled field. */
-export interface HarnessEditability {
+interface HarnessEditability {
     model: EditableField;
     baseUrl: EditableField;
     auth: EditableField;

package/dist/commands/harness.d.ts

@@ -12,7 +12,7 @@
  */
 import type { Command } from 'commander';
 import { type AddProfileOptions } from './profiles.js';
-import { type Profile, type ForkProfileOptions } from '../lib/profiles.js';
+import { type Profile } from '../lib/profiles.js';
 import { type HarnessDraft } from './harness-wizard.js';
 /**
  * Print one custom harness. Shared by `agents harness view <name>` and by
@@ -62,12 +62,6 @@ export interface EditOptions {
  * copy a model from.
  */
 export declare function buildFork(source: string, name: string, opts: ForkOptions): Profile;
-/** Map `agents harness edit` flags onto {@link ForkProfileOptions} — the same
- * override shape `editProfile`/`forkProfile` apply. `--version ''` (unpin) is
- * handled by the caller ({@link buildEdit}), not here: `forkProfile`'s own
- * ternary treats an empty string as "no override" and would otherwise inherit
- * the source's version instead of clearing it. */
-export declare function buildEditOverrides(opts: EditOptions): ForkProfileOptions;
 /** True when at least one recognized edit flag was given. */
 export declare function hasEditFlags(opts: EditOptions): boolean;
 /**
@@ -85,7 +79,7 @@ export declare function forkNeedsWizard(source: string | undefined, name: string
  * fallback instead of being routed into the wizard. */
 export declare function addNeedsWizard(name: string | undefined, opts: AddProfileOptions): boolean;
 /** Whether the pre-save connection test runs, or must be asked for on a TTY. */
-export type ConnectionTestGate = 'on' | 'off' | 'ask';
+type ConnectionTestGate = 'on' | 'off' | 'ask';
 /**
  * Resolve the tri-state connection-test gate (RUSH-2221), pure so the branching
  * is unit-tested with no prompt or spawn. `--test` forces it on, `--no-test`
@@ -106,3 +100,4 @@ export declare function connectionTestGate(testFlag: boolean | undefined, intera
  */
 export declare function draftToEditOptions(draft: HarnessDraft, original: Profile): EditOptions;
 export declare function registerHarnessCommands(program: Command): void;
+export {};

package/dist/commands/harness.js

@@ -122,7 +122,7 @@ function authEnvKeyForHostOrThrow(host) {
  * handled by the caller ({@link buildEdit}), not here: `forkProfile`'s own
  * ternary treats an empty string as "no override" and would otherwise inherit
  * the source's version instead of clearing it. */
-export function buildEditOverrides(opts) {
+function buildEditOverrides(opts) {
     const overrides = {};
     if (opts.model !== undefined)
         overrides.model = opts.model;

package/dist/commands/inspect.d.ts

@@ -62,7 +62,6 @@ export interface InspectOptions {
     routine?: string;
 }
 export declare function registerInspectCommand(program: Command): void;
-export declare function inspectAction(target: string, options: InspectOptions): Promise<void>;
 export interface RepoTarget {
     /** Display label: 'user' | 'system' | 'project', an extra-repo alias, or a path-derived name. */
     label: string;
@@ -134,7 +133,7 @@ export declare function pathSize(p: string): {
     files: number;
 };
 /** Human byte size: "84 KB", "3.1 MB". */
-export interface ManifestSummary {
+interface ManifestSummary {
     /** `run.<agent>.strategy` pairs from agents.yaml. */
     strategies: Array<{
         agent: string;
@@ -148,7 +147,7 @@ export interface ManifestSummary {
 }
 /** Parse the repo's own agents.yaml into the version pins + run strategies it declares. */
 export declare function repoManifestSummary(root: string): ManifestSummary | null;
-export interface RepoGitInfo {
+interface RepoGitInfo {
     branch: string;
     dirty: number;
     dirtyFiles: string[];

package/dist/commands/inspect.js

@@ -139,7 +139,7 @@ export function registerInspectCommand(program) {
     });
 }
 // ─── Main dispatcher ─────────────────────────────────────────────────────────
-export async function inspectAction(target, options) {
+async function inspectAction(target, options) {
     const agentKey = target.split('@')[0].toLowerCase();
     if (!(agentKey in AGENTS)) {
         const repo = resolveRepoTarget(target);

package/dist/commands/logs.js

@@ -263,7 +263,7 @@ export function registerLogsCommand(program) {
         .action((id, opts) => runLogs(id, opts));
     addEventsReadOptions(logsCmd
         .command('audit')
-        .description('Alias for `agents events --audit`'), false)
+        .description('Alias for `agents events audit`'))
         .addHelpText('after', `
 Examples:
   agents logs audit                          Recent activity across everything