@phnx-labs/agents-cli 1.22.112 → 1.22.114

package/dist/lib/device-config.js

@@ -39,6 +39,7 @@ import { atomicWriteFileSync } from './fs-atomic.js';
 import { machineId } from './machine-id.js';
 import { assertValidDeviceName, assertRegistrableDeviceName } from './devices/registry.js';
 import { migrateDeviceConfigStores } from './devices/config-migration.js';
+import { parseAddress } from './address.js';
 import { isAgentId } from './types.js';
 const DEVICE_PLATFORMS = ['windows', 'linux', 'macos', 'unknown'];
 const SSH_AUTH_METHODS = ['key', 'password'];
@@ -46,6 +47,16 @@ const SSH_AUTH_METHODS = ['key', 'password'];
 const DEVICE_ROLES = ['worker', 'personal', 'desktop'];
 /** Which devices automatic placement may pick — see the `auto.pool` key below. */
 const AUTO_POOL_MODES = ['workers', 'all'];
+/**
+ * A device's physical form factor (`formFactor` key) — a factual hardware fact
+ * the menu bar shows as an icon. Set explicitly per device (no inference from
+ * platform, no hardcoded device names). `unknown` is the effective default.
+ */
+const DEVICE_FORM_FACTORS = ['laptop', 'desktop', 'server', 'unknown'];
+/** A validate() that accepts only one of `allowed` — the enum-string keys reuse it. */
+function oneOf(name, allowed) {
+    return (v) => (allowed.includes(v) ? null : `${name} must be one of ${allowed.join(' | ')}.`);
+}
 export const CONFIG_KEYS = [
     {
         name: 'interactive.host',
@@ -133,6 +144,28 @@ export const CONFIG_KEYS = [
         type: 'string',
         description: 'Browser profile `agents browser start` resolves to without --profile (set via `agents browser use`).',
     },
+    {
+        name: 'computer.host',
+        yamlKey: 'computerHost',
+        scope: 'device',
+        visibility: 'shared',
+        type: 'string',
+        description: 'The --host address (PHNX-4090) `agents computer --device <name>` forwards to the standalone engine: ' +
+            'ssh://[user@]host[:port], vnc://host[:port], or tcp://host:port. Unset falls back to the fleet ssh ' +
+            'identity (ssh://user@host resolved against the device registry).',
+        validate: (v) => {
+            try {
+                const addr = parseAddress(v);
+                if (addr.scheme !== 'ssh' && addr.scheme !== 'vnc' && addr.scheme !== 'tcp') {
+                    return `computer.host speaks ssh://, vnc:// and tcp:// only (got ${addr.scheme}://).`;
+                }
+                return null;
+            }
+            catch (err) {
+                return err?.message ?? String(err);
+            }
+        },
+    },
     {
         name: 'browser.device',
         yamlKey: 'defaultBrowserDevice',
@@ -344,6 +377,134 @@ export const CONFIG_KEYS = [
         defaultValue: false,
         description: 'Boost this device in `--device auto` ranking (default off) — picked ahead of load-equal peers when eligible.',
     },
+    {
+        name: 'formFactor',
+        yamlKey: 'formFactor',
+        scope: 'device',
+        visibility: 'shared',
+        type: 'string',
+        defaultValue: 'unknown',
+        description: "This device's physical form factor, a factual hardware fact the menu bar renders as an icon: " +
+            'laptop, desktop, server, or unknown. Synced fleet-wide (any box may set it for any device). Set it ' +
+            'explicitly — never inferred from the OS platform. Unset reads as `unknown`.',
+        validate: oneOf('formFactor', DEVICE_FORM_FACTORS),
+    },
+    // ─── AGI Menu preferences (PHNX-3999) ──────────────────────────────────────
+    // User-scope so one value syncs fleet-wide via `agents repo push/pull` and the
+    // native menu reads it from `agents config list --json`. Names mirror the Swift
+    // MenuPreferences local-cache keys. `config list` OMITS an unset key, so the
+    // native app falls back to its own known defaults — the defaults documented
+    // here match those, they are not substituted on read.
+    {
+        name: 'menubar.menu.defaultProject',
+        yamlKey: 'menubarMenuDefaultProject',
+        scope: 'user',
+        type: 'string',
+        description: 'AGI Menu: the project name the menu opens focused on. Unset = no default project.',
+    },
+    {
+        name: 'menubar.menu.workingRowsShown',
+        yamlKey: 'menubarMenuWorkingRowsShown',
+        scope: 'user',
+        type: 'int',
+        defaultValue: 3,
+        description: 'AGI Menu: how many working (in-progress) rows to show per group — 2, 3, or 4.',
+        validate: (v) => ([2, 3, 4].includes(v) ? null : 'menubar.menu.workingRowsShown must be 2, 3, or 4.'),
+    },
+    {
+        name: 'menubar.menu.showPreviews',
+        yamlKey: 'menubarMenuShowPreviews',
+        scope: 'user',
+        type: 'bool',
+        defaultValue: true,
+        description: 'AGI Menu: show the session preview line under each row.',
+    },
+    {
+        name: 'menubar.menu.projectPriorityFilter',
+        yamlKey: 'menubarMenuProjectPriorityFilter',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'all',
+        description: 'AGI Menu: minimum project priority shown — all, urgent, high, or medium.',
+        validate: oneOf('menubar.menu.projectPriorityFilter', ['all', 'urgent', 'high', 'medium']),
+    },
+    {
+        name: 'menubar.menu.hideCompletedMilestones',
+        yamlKey: 'menubarMenuHideCompletedMilestones',
+        scope: 'user',
+        type: 'bool',
+        defaultValue: true,
+        description: 'AGI Menu: hide milestones that are fully complete.',
+    },
+    {
+        name: 'menubar.menu.bannerWhenNeedsYou',
+        yamlKey: 'menubarMenuBannerWhenNeedsYou',
+        scope: 'user',
+        type: 'bool',
+        defaultValue: true,
+        description: 'AGI Menu: show a top banner when a session needs the operator.',
+    },
+    {
+        name: 'menubar.menu.includeOtherDeviceRequests',
+        yamlKey: 'menubarMenuIncludeOtherDeviceRequests',
+        scope: 'user',
+        type: 'bool',
+        defaultValue: true,
+        description: 'AGI Menu: include needs-you requests from sessions on OTHER fleet devices.',
+    },
+    {
+        name: 'menubar.menu.groupBy',
+        yamlKey: 'menubarMenuGroupBy',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'project',
+        description: 'AGI Menu: primary grouping of rows — none, project, agent, or device.',
+        validate: oneOf('menubar.menu.groupBy', ['none', 'project', 'agent', 'device']),
+    },
+    {
+        name: 'menubar.menu.thenBy',
+        yamlKey: 'menubarMenuThenBy',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'none',
+        description: 'AGI Menu: secondary grouping within each group — none, project, agent, or device.',
+        validate: oneOf('menubar.menu.thenBy', ['none', 'project', 'agent', 'device']),
+    },
+    {
+        name: 'menubar.menu.projectScope',
+        yamlKey: 'menubarMenuProjectScope',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'cycle',
+        description: 'AGI Menu: which project issues to show — the current cycle only, or all.',
+        validate: oneOf('menubar.menu.projectScope', ['cycle', 'all']),
+    },
+    {
+        name: 'menubar.menu.projectSort',
+        yamlKey: 'menubarMenuProjectSort',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'updated',
+        description: 'AGI Menu: how projects are ordered — updated, priority, or name.',
+        validate: oneOf('menubar.menu.projectSort', ['updated', 'priority', 'name']),
+    },
+    {
+        name: 'menubar.menu.ticketSort',
+        yamlKey: 'menubarMenuTicketSort',
+        scope: 'user',
+        type: 'string',
+        defaultValue: 'priority',
+        description: 'AGI Menu: how tickets within a project are ordered — priority, updated, or title.',
+        validate: oneOf('menubar.menu.ticketSort', ['priority', 'updated', 'title']),
+    },
+    {
+        name: 'menubar.menu.showPullRequests',
+        yamlKey: 'menubarMenuShowPullRequests',
+        scope: 'user',
+        type: 'bool',
+        defaultValue: true,
+        description: 'AGI Menu: show the open pull requests section for each project.',
+    },
 ];
 /** Look up a key spec by CLI dotted name, or throw listing the known keys. */
 /**
@@ -377,7 +538,7 @@ export function configKeySpec(name) {
     return spec;
 }
 /** Throw when `value` does not match the key's declared type or validation. */
-function assertValidValue(spec, value) {
+export function assertValidValue(spec, value) {
     switch (spec.type) {
         case 'string':
             if (typeof value !== 'string' || value.length === 0) {
@@ -413,7 +574,7 @@ let migrationDone = false;
  * same gate bootstrap's runMigration uses (tests pin it so a fork never folds
  * the developer's real ~/.agents as a side effect).
  */
-export function ensureDeviceConfigMigrated() {
+function ensureDeviceConfigMigrated() {
     if (migrationDone || process.env.AGENTS_SKIP_MIGRATION === '1')
         return;
     try {
@@ -499,7 +660,7 @@ function writeDeviceDoc(device, doc) {
     atomicWriteFileSync(p, META_HEADER + yaml.stringify(doc));
 }
 /** The fleet-defaults config layer (central `fleet.defaults.config`; {} when unset). */
-export function readFleetConfigDefaults() {
+function readFleetConfigDefaults() {
     const config = readMeta().fleet?.defaults?.config;
     return config && typeof config === 'object' && !Array.isArray(config) ? config : {};
 }
@@ -609,11 +770,6 @@ export function listConfig(opts) {
         : CONFIG_KEYS;
     return visible.map((spec) => getConfigValue(spec.name, opts));
 }
-/** List user-scope config keys with their values. Used to show inherited settings
- * in per-device views without implying those keys are device-local. */
-export function listUserConfig() {
-    return CONFIG_KEYS.filter((spec) => spec.scope === 'user').map((spec) => getConfigValue(spec.name));
-}
 // ─── Writes ───────────────────────────────────────────────────────────────────
 /** The fleet manifest for a defaults write: `devices` materializes as an
  * explicit empty map (NOT 'all') so `agents apply` targets nothing until the

package/dist/lib/devices/connect.d.ts

@@ -91,7 +91,7 @@ export declare function markFleetRemote(cmd: string[], device: Pick<DeviceProfil
  */
 export declare function buildInteractiveShellCommand(device: DeviceProfile, mirrorCwd: string | undefined): string | undefined;
 /** Host-key posture for {@link buildSshInvocation}. */
-export interface SshHostKeyOptions {
+interface SshHostKeyOptions {
     /**
      * True when the device's host key is already pinned in the managed
      * known_hosts store — connections then verify with `StrictHostKeyChecking=yes`
@@ -162,3 +162,4 @@ export declare function buildAskpassShimBody(launch?: {
  * protocol back into the CLI, which then resolves the bundle.
  */
 export declare function writeAskpassShim(): string;
+export {};

package/dist/lib/devices/discovery-policy.d.ts

@@ -1,5 +1,5 @@
-export type DeviceDiscoveryStatus = 'approved' | 'ignored';
-export interface DeviceDiscoveryReconcileResult {
+type DeviceDiscoveryStatus = 'approved' | 'ignored';
+interface DeviceDiscoveryReconcileResult {
     approved: string[];
     ignored: string[];
     registered: string[];
@@ -40,3 +40,4 @@ export declare function loadDeviceDiscoveryPolicies(): Map<string, DeviceDiscove
 export declare function reconcileDeviceDiscoveryPolicies(): Promise<DeviceDiscoveryReconcileResult>;
 /** Complete reconciliation from real `tailscale status --json` output. */
 export declare function registerApprovedDevicesFromTailscale(json: string, approved: string[], ignored: string[], missing: string[]): Promise<DeviceDiscoveryReconcileResult>;
+export {};

package/dist/lib/devices/doctor-findings.js

@@ -244,7 +244,7 @@ export function remediationFor(finding) {
         case 'content-drift':
         case 'stale':
             // doctor diagnoses; `agents sync` fixes (the superset of the old
-            // `doctor --fix`). A bare `agents sync <agent>` hits only the default
+            // `agents sync`). A bare `agents sync <agent>` hits only the default
             // version, so an agent-only row collapsed across versions must ask for
             // @all to reach every one it covers.
             if (agent && version)

package/dist/lib/devices/doctor-overview-cache.d.ts

@@ -1,7 +1,7 @@
 /** Serve a cached snapshot without recomputing while it is younger than this. */
 export declare const DOCTOR_OVERVIEW_FRESH_MS = 90000;
 /** Injectable IO + clock so tests exercise the real fs at a temp dir, no mocks. */
-export interface DoctorOverviewCacheDeps {
+interface DoctorOverviewCacheDeps {
     /** Cache directory (default: the real `~/.agents/.cache`). */
     dir?: string;
     /** Clock (default: {@link Date.now}). */
@@ -29,7 +29,7 @@ export declare function invalidateDoctorOverviewCache(deps?: DoctorOverviewCache
  *    the way out. Call `release()` in a `finally` so a compute that throws still
  *    frees the lock promptly (idempotent).
  */
-export interface OverviewGate {
+interface OverviewGate {
     cached: string | null;
     release?: () => void;
 }
@@ -50,3 +50,4 @@ export declare function enterDoctorOverviewGate(opts?: {
     forceRefresh?: boolean;
     freshMs?: number;
 }, deps?: DoctorOverviewCacheDeps): Promise<OverviewGate>;
+export {};

package/dist/lib/devices/fleet-divergence.d.ts

@@ -111,7 +111,7 @@ export interface FleetDivergence {
     /** Human-readable one-liner, ready for the warnings list. */
     message: string;
 }
-export interface FleetDivergenceReport {
+interface FleetDivergenceReport {
     /** Name of the device used as the comparison baseline (the local machine). */
     baseline: string;
     divergences: FleetDivergence[];
@@ -132,3 +132,4 @@ export interface FleetDivergenceReport {
  * JSON output — and the tests — are stable.
  */
 export declare function compareFleetInventories(devices: DeviceInventory[], baselineName: string): FleetDivergenceReport;
+export {};

package/dist/lib/devices/fleet.d.ts

@@ -10,8 +10,6 @@
 import type { DeviceProfile, DeviceRegistry } from './registry.js';
 import type { DeviceStats } from './health.js';
 export type FleetSkipReason = 'offline' | 'no-address';
-/** npm dist-tags / semver pins only — rejects shell metacharacters. */
-export declare const FLEET_VERSION_RE: RegExp;
 export interface FleetTarget {
     device: DeviceProfile;
     /** When set, this device is not reached (skip with reason). */
@@ -112,7 +110,7 @@ export declare function runLocalCommand(cmd: string[], opts?: {
  * cannot inject shell metacharacters into the remote command line.
  */
 export declare function upgradeCommand(version?: string): string[];
-export interface RunFleetOptions {
+interface RunFleetOptions {
     /**
      * Name of THIS machine. Its target runs the command **locally** (no ssh) — a
      * box can't reliably ssh to itself and doesn't need to. Omit to ssh every
@@ -132,7 +130,7 @@ export interface RunFleetOptions {
  * recorded as `failed` so one bad device never aborts the rest.
  */
 export declare function runFleet(targets: FleetTarget[], cmd: string[], opts?: RunFleetOptions): FleetRunResult[];
-export interface FanOutDeviceOptions {
+interface FanOutDeviceOptions {
     /**
      * Per-device deadline in milliseconds. When set, any probe that does not
      * settle within this window is abandoned via `Promise.race` against a
@@ -149,3 +147,4 @@ export interface FanOutDeviceOptions {
 }
 /** Run one async probe per device in parallel, preserving input order. */
 export declare function fanOutDevices<T, Target extends FanOutDeviceTarget = FanOutDeviceTarget>(targets: Target[], probe: (target: Target) => Promise<T>, opts?: FanOutDeviceOptions): Promise<FanOutDeviceResult<T>[]>;
+export {};

package/dist/lib/devices/fleet.js

@@ -11,7 +11,7 @@ import { spawnSync } from 'child_process';
 import { isSelfHost } from './self-host.js';
 import { buildSshInvocation, sshTargetFor, writeAskpassShim } from './connect.js';
 /** npm dist-tags / semver pins only — rejects shell metacharacters. */
-export const FLEET_VERSION_RE = /^[A-Za-z0-9._-]+$/;
+const FLEET_VERSION_RE = /^[A-Za-z0-9._-]+$/;
 /**
  * Classify each registered device for a fleet operation.
  *

package/dist/lib/devices/harness-inventory.d.ts

@@ -51,7 +51,7 @@ export interface HostHarnessResult {
     skipped?: string;
 }
 /** An account collapsed across the installs on one host that share it. */
-export interface AccountGroup {
+interface AccountGroup {
     /** Account display label, or null for the signed-out bucket. */
     account: string | null;
     /** Distinct agent ids using this account, sorted. */
@@ -130,7 +130,7 @@ export declare function renderHarnessMatrix(results: HostHarnessResult[]): strin
  * account (installs sharing it collapsed), showing which harnesses use it. Pure.
  */
 export declare function renderAccountsMatrix(results: HostHarnessResult[]): string[];
-export interface AccountFleetMatrixRow {
+interface AccountFleetMatrixRow {
     harness: AgentId;
     name: string | null;
     identityLabel: string;
@@ -147,3 +147,4 @@ export interface AccountFleetMatrixRow {
 export declare function renderAccountFleetMatrix(rows: AccountFleetMatrixRow[], opts?: {
     uncoveredDevices?: string[];
 }): string[];
+export {};

package/dist/lib/devices/health-report.d.ts

@@ -52,7 +52,7 @@ export interface FleetHealthRow {
      *  Undefined when no row has been published for the host yet. */
     agents?: FleetAgentCounts;
 }
-export interface FleetWarning {
+interface FleetWarning {
     kind: 'unreachable' | 'drift' | 'cli' | 'version-skew' | 'divergence';
     devices: string[];
     message: string;
@@ -82,7 +82,7 @@ export declare function freshnessFooter(rows: FleetHealthRow[], now?: number): s
 export declare function shortVersion(version: string | null | undefined): string;
 /** OS bucket label for grouping. Anything unrecognized falls under "Other". */
 export declare function platformGroupLabel(platform: string | undefined): 'macOS' | 'Linux' | 'Windows' | 'Other';
-export interface FleetAttentionItem {
+interface FleetAttentionItem {
     /** Leading mark: `○` offline, `⚠` config/CLI/version issue. */
     glyph: 'offline' | 'warn';
     subject: string;
@@ -106,3 +106,4 @@ export declare function renderFleetSummary(report: FleetHealthReport, opts?: {
     self?: string;
     now?: number;
 }): string[];
+export {};

package/dist/lib/devices/health.d.ts

@@ -49,13 +49,6 @@ export declare function probeBudgetMs(device: DeviceProfile): number;
 export declare const WIN_PROBE_TIMEOUT_MS = 6000;
 /** One-shot remote snapshot: load, memory, core count, then root filesystem. */
 export declare const PROBE_SNIPPET = "uptime; echo ---AGSTAT---; (vm_stat 2>/dev/null || cat /proc/meminfo 2>/dev/null); echo ---AGSTAT---; (nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null); echo ---AGSTAT---; df -Pk / 2>/dev/null | tail -1";
-/** Windows equivalent, one labeled line via CIM. PowerShell 5.1-safe: no `||`
- * chaining, plain string concatenation. `LoadPercentage` is $null on some
- * hosts/VMs, which concatenates to an empty field — the parser treats that as
- * "no load signal" and headroom falls back to memory pressure alone.
- * wrapRemoteCommand base64-encodes this for powershell-shell devices, so the
- * quoting survives ssh intact. */
-export declare const WIN_PROBE_SNIPPET = "$os = Get-CimInstance Win32_OperatingSystem; $cpu = (Get-CimInstance Win32_Processor | Measure-Object -Property LoadPercentage -Average).Average; $disk = Get-CimInstance Win32_LogicalDisk -Filter \"DeviceID='C:'\"; Write-Output ('AGWINSTAT load=' + $cpu + ' freeKb=' + $os.FreePhysicalMemory + ' totalKb=' + $os.TotalVisibleMemorySize + ' ncpu=' + $env:NUMBER_OF_PROCESSORS + ' diskFreeKb=' + ($disk.FreeSpace / 1KB) + ' diskTotalKb=' + ($disk.Size / 1KB))";
 export declare function localProbeInvocation(platform: NodeJS.Platform): {
     file: string;
     args: string[];
@@ -114,7 +107,7 @@ export declare function parseProbeOutput(host: string, stdout: string, fetchedAt
  * (e.g. CIM unavailable) keeps `reachable: true` — ssh answered — with no
  * numbers, mirroring how garbage POSIX output degrades. */
 export declare function parseWinProbeOutput(host: string, stdout: string, fetchedAt: number): DeviceStats;
-export interface FleetCapacity {
+interface FleetCapacity {
     reachable: number;
     cores: number;
     memTotalBytes: number;

package/dist/lib/devices/health.js

@@ -63,7 +63,7 @@ export const PROBE_SNIPPET = `uptime; echo ${SEP}; (vm_stat 2>/dev/null || cat /
  * "no load signal" and headroom falls back to memory pressure alone.
  * wrapRemoteCommand base64-encodes this for powershell-shell devices, so the
  * quoting survives ssh intact. */
-export const WIN_PROBE_SNIPPET = `$os = Get-CimInstance Win32_OperatingSystem; $cpu = (Get-CimInstance Win32_Processor | Measure-Object -Property LoadPercentage -Average).Average; $disk = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID='C:'"; Write-Output ('AGWINSTAT load=' + $cpu + ' freeKb=' + $os.FreePhysicalMemory + ' totalKb=' + $os.TotalVisibleMemorySize + ' ncpu=' + $env:NUMBER_OF_PROCESSORS + ' diskFreeKb=' + ($disk.FreeSpace / 1KB) + ' diskTotalKb=' + ($disk.Size / 1KB))`;
+const WIN_PROBE_SNIPPET = `$os = Get-CimInstance Win32_OperatingSystem; $cpu = (Get-CimInstance Win32_Processor | Measure-Object -Property LoadPercentage -Average).Average; $disk = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID='C:'"; Write-Output ('AGWINSTAT load=' + $cpu + ' freeKb=' + $os.FreePhysicalMemory + ' totalKb=' + $os.TotalVisibleMemorySize + ' ncpu=' + $env:NUMBER_OF_PROCESSORS + ' diskFreeKb=' + ($disk.FreeSpace / 1KB) + ' diskTotalKb=' + ($disk.Size / 1KB))`;
 export function localProbeInvocation(platform) {
     return platform === 'win32'
         ? { file: 'powershell', args: ['-NoProfile', '-Command', WIN_PROBE_SNIPPET] }

package/dist/lib/devices/interactive-host.d.ts

@@ -1,5 +1,3 @@
-/** The reserved `--device` value meaning the box the human is at. */
-export declare const INTERACTIVE_DEVICE_SENTINEL = "interactive";
 /** True when a host flag value is the interactive sentinel. */
 export declare function isDeviceInteractive(value: string | undefined | null): boolean;
 /**

package/dist/lib/devices/interactive-host.js

@@ -19,7 +19,7 @@
 import { getConfigValue } from '../device-config.js';
 import { RESERVED_DEVICE_NAMES } from './registry.js';
 /** The reserved `--device` value meaning the box the human is at. */
-export const INTERACTIVE_DEVICE_SENTINEL = 'interactive';
+const INTERACTIVE_DEVICE_SENTINEL = 'interactive';
 /** True when a host flag value is the interactive sentinel. */
 export function isDeviceInteractive(value) {
     return typeof value === 'string' && value.trim().toLowerCase() === INTERACTIVE_DEVICE_SENTINEL;

package/dist/lib/devices/known-hosts.d.ts

@@ -3,8 +3,6 @@ import type { DeviceProfile } from './registry.js';
 export declare function managedKnownHostsPath(): string;
 /** Ensure the parent directory of the managed store exists (mode 0700). */
 export declare function ensureManagedKnownHostsDir(file?: string): void;
-/** Read the managed store, or '' when it does not exist yet. */
-export declare function readManagedKnownHosts(file?: string): string;
 /**
  * True if `host` has at least one pinned key line in `content`. Pure (content
  * in) so the match logic is unit-testable without touching disk. Matching is
@@ -44,7 +42,7 @@ export declare function hostKeyCheckingOpts(pinned: boolean, file?: string): str
  * contract is unit-testable without spawning ssh-keyscan.
  */
 export declare function newKnownHostsLines(existing: string, scanned: string): string[];
-export interface PinResult {
+interface PinResult {
     /** True if the host is pinned in the managed store after this call. */
     pinned: boolean;
     /** How many new key lines were appended. */
@@ -58,20 +56,4 @@ export interface PinResult {
  * network (the spawn stays in `pinHostKey`).
  */
 export declare function recordScannedKeys(host: string, scanned: string, file?: string): PinResult;
-/**
- * `ssh-keyscan` a host at a trusted moment and append any new key lines to the
- * managed store, idempotently. This is the explicit pin path; the implicit one
- * is a normal `accept-new` connection whose learned key lands in the same store.
- * Returns whether the host is pinned afterward.
- *
- * Host-name-agnostic: it scans whatever address it is handed, so it also pins a
- * host `agents ssh` can't reach — notably a bare `~/.ssh/config` `Host` alias,
- * which is not a registered device. The `--copy-creds` gate (commands/exec.ts)
- * calls this for exactly that case so the credential copy is usable for
- * ssh-config-alias hosts (RUSH-1767).
- */
-export declare function pinHostKey(host: string, opts?: {
-    file?: string;
-    timeoutMs?: number;
-    port?: number;
-}): PinResult;
+export {};

package/dist/lib/devices/known-hosts.js

@@ -32,7 +32,7 @@ export function ensureManagedKnownHostsDir(file = managedKnownHostsPath()) {
     fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
 }
 /** Read the managed store, or '' when it does not exist yet. */
-export function readManagedKnownHosts(file = managedKnownHostsPath()) {
+function readManagedKnownHosts(file = managedKnownHostsPath()) {
     try {
         return fs.readFileSync(file, 'utf-8');
     }
@@ -135,7 +135,7 @@ export function recordScannedKeys(host, scanned, file = managedKnownHostsPath())
  * calls this for exactly that case so the credential copy is usable for
  * ssh-config-alias hosts (RUSH-1767).
  */
-export function pinHostKey(host, opts = {}) {
+function pinHostKey(host, opts = {}) {
     // Same injection guard as sshExec: a host starting with `-` (or carrying shell
     // metacharacters) must never reach ssh-keyscan as a bare argv where it could
     // be parsed as a flag.

package/dist/lib/devices/pool.d.ts

@@ -30,7 +30,7 @@
  * ranker ({@link autoLaunchPreferredSet}, applied by `pickBestDevice`).
  */
 import { type AutoLaunchPreference, type AutoPoolMode, type ConfiguredDeviceRole } from '../device-config.js';
-export interface AutoPoolOptions {
+interface AutoPoolOptions {
     /** Pool mode; defaults to the configured `auto.pool`. */
     mode?: AutoPoolMode;
     /** Configured roles by device name; defaults to the fleet-shared block. */
@@ -77,3 +77,4 @@ export declare function listWorkerDevices(opts?: Pick<AutoPoolOptions, 'roles'>)
  * callers can append it unconditionally.
  */
 export declare function describeAutoPool(opts?: AutoPoolOptions): string;
+export {};

package/dist/lib/devices/resolve-target.d.ts

@@ -3,14 +3,14 @@ import { type DeviceProfile } from './registry.js';
 export { splitUserHost };
 /** A dialable peer: the ssh target, the machine id used to tag its rows, a
  * display name, and the OS family that picks the remote shell dialect. */
-export interface ResolvedSshTarget {
+interface ResolvedSshTarget {
     target: string;
     machine: string;
     name: string;
     os?: string;
     extraSshArgs?: string[];
 }
-export interface ResolvedExplicitTargetSet {
+interface ResolvedExplicitTargetSet {
     targets: ResolvedSshTarget[];
     unresolved: string[];
 }

package/dist/lib/devices/rollout-verify.d.ts

@@ -43,7 +43,7 @@ import { runLocalCommand, runOnDevice, type FleetRunResult, type FleetTarget } f
  * falling back to the unresolved path where `readlink -f` is unavailable.
  */
 export declare function rolloutVerifyCommand(): string[];
-export interface RolloutProbe {
+interface RolloutProbe {
     /** Path the box's own `agents` resolves to, symlinks followed. */
     resolvedPath?: string;
     /** Version that resolved copy reports. */
@@ -81,7 +81,7 @@ export declare function isRolloutSuccess(verdict: RolloutVerdict): boolean;
 export declare function resolveRolloutTarget(explicitVersion: string | undefined, probes: RolloutProbe[]): string | undefined;
 /** Classify one box's probe against the rollout target. */
 export declare function classifyRolloutVerification(probe: RolloutProbe, targetVersion: string | undefined): RolloutVerification;
-export interface VerifyFleetRolloutOptions {
+interface VerifyFleetRolloutOptions {
     /** Name of THIS machine; its target is probed locally, mirroring `runFleet`. */
     self?: string;
     /** Injectable ssh runner (tests). */
@@ -99,3 +99,4 @@ export interface VerifyFleetRolloutOptions {
  * "we could not check" and "it is upgraded" are different answers.
  */
 export declare function verifyFleetRollout(targets: FleetTarget[], results: FleetRunResult[], explicitVersion: string | undefined, opts?: VerifyFleetRolloutOptions): Map<string, RolloutVerification>;
+export {};

package/dist/lib/devices/stats-cache.d.ts

@@ -42,7 +42,7 @@ export declare function writeStatsCache(entries: Record<string, DeviceStats>): v
 export declare function removeStatsCacheEntry(name: string): void;
 /** Immutable cache pruning primitive, exported for lifecycle regression tests. */
 export declare function pruneStatsCache(entries: Record<string, DeviceStats>, name: string): Record<string, DeviceStats>;
-export interface FleetStatsResult {
+interface FleetStatsResult {
     /** name → stats for every requested device (cache-served + freshly probed). */
     stats: Map<string, DeviceStats>;
     /** Oldest `fetchedAt` among the returned rows, or null when empty. Drives the
@@ -51,7 +51,7 @@ export interface FleetStatsResult {
     /** True when at least one row was served from cache rather than probed this call. */
     servedFromCache: boolean;
 }
-export interface LoadFleetStatsOptions {
+interface LoadFleetStatsOptions {
     /** Skip the cache and live-probe every device (the `--refresh`/`--live` path). */
     forceRefresh?: boolean;
     /** Device name of THIS machine — always probed locally (no ssh), never cached-served. */
@@ -70,3 +70,4 @@ export interface LoadFleetStatsOptions {
  * `reachable: false` row exactly as the live probe does.
  */
 export declare function loadFleetStats(devices: DeviceProfile[], opts?: LoadFleetStatsOptions): Promise<FleetStatsResult>;
+export {};

package/dist/lib/devices/sync.d.ts

@@ -34,8 +34,8 @@ export declare function withDefaultUser(input: DeviceInput, prevUser: string | u
  *   through the menu-bar "NEW DEVICES → Register / Ignore" gate instead of
  *   silently landing in the registry.
  */
-export type DeviceSyncMode = 'bootstrap' | 'refresh';
-export interface DeviceSyncResult {
+type DeviceSyncMode = 'bootstrap' | 'refresh';
+interface DeviceSyncResult {
     /** False when discovery could not run (e.g. tailscale absent) in soft mode. */
     ok: boolean;
     /** Number of tailscale nodes upserted into the registry. */
@@ -89,7 +89,7 @@ export declare function runDeviceSync(opts?: {
     soft?: boolean;
     mode?: DeviceSyncMode;
 }): Promise<DeviceSyncResult>;
-export interface EnsureDevicesResult {
+interface EnsureDevicesResult {
     /** Names newly resolved from Tailscale and upserted into the registry. */
     registered: string[];
     /** Names that could not be resolved (not on the tailnet / tailscale absent). */
@@ -102,7 +102,7 @@ export interface EnsureDevicesResult {
  * registered names need nothing. Pure so the bootstrap's filter matrix is
  * unit-testable without a tailnet or registry writes.
  */
-export interface WantedPartition {
+interface WantedPartition {
     toRegister: string[];
     unresolved: string[];
 }
@@ -127,10 +127,11 @@ export declare function ensureDevicesRegistered(wantedNames: string[]): Promise<
  * => remove from the registry if it was there, and ignore it so auto-sync never
  * re-adds it.
  */
-export interface DeviceReconciliation {
+interface DeviceReconciliation {
     toRegister: string[];
     toUnignore: string[];
     toRemove: string[];
     toIgnore: string[];
 }
 export declare function planDeviceReconciliation(allNames: Iterable<string>, keep: Iterable<string>, registered: Iterable<string>, ignored: Iterable<string>): DeviceReconciliation;
+export {};