@phnx-labs/agents-cli 1.22.41 → 1.22.42

package/dist/commands/run-account-picker.js

@@ -124,6 +124,87 @@ export function buildRunAccountChoices(candidates, globalDefault) {
         signInRequired: row.signInRequired,
     }));
 }
+function switchRowStatus(row) {
+    if (!row.candidate) {
+        return {
+            status: row.kind === 'provider' ? 'credential' : 'named',
+            limits: 'limits unavailable',
+            ready: true,
+        };
+    }
+    const readiness = readinessFromCandidate(row.candidate);
+    const authReason = readiness.ready ? null : readiness.reason;
+    const status = authReason === 'revoked'
+        ? 'needs re-login'
+        : authReason === 'signed_out'
+            ? 'logged out'
+            : authReason === 'rate_limited'
+                ? 'rate limited'
+                : authReason === 'out_of_credits'
+                    ? 'out of credits'
+                    : 'logged in';
+    const limits = authReason === 'revoked'
+        ? 'needs re-authentication'
+        : authReason === 'signed_out'
+            ? 'signed out'
+            : formatAccountLimits(row.candidate);
+    return { status, limits, ready: readiness.ready };
+}
+/**
+ * Aligned picker rows for `accounts switch`. Same columns as the run picker
+ * (identity, status, limits) but the value is the named account to set-default.
+ * Rows stay selectable: setting a default is not a launch.
+ */
+export function buildSwitchAccountChoices(rows) {
+    const rendered = rows.map((row) => {
+        const { status, limits, ready } = switchRowStatus(row);
+        const account = row.current ? `${row.accountName} (default)` : row.accountName;
+        const kind = row.kind === 'provider' ? `provider · ${row.detail}` : `native · ${row.detail}`;
+        return { account, kind, status, limits, ready, value: row.accountName };
+    });
+    const accountWidth = Math.max(0, ...rendered.map((row) => row.account.length));
+    const kindWidth = Math.max(0, ...rendered.map((row) => row.kind.length));
+    const statusWidth = Math.max(0, ...rendered.map((row) => row.status.length));
+    return rendered.map((row) => ({
+        name: [
+            row.account.padEnd(accountWidth),
+            row.kind.padEnd(kindWidth),
+            row.status.padEnd(statusWidth),
+            row.limits,
+        ].join('  '),
+        value: row.value,
+        ready: row.ready,
+        signInRequired: false,
+    }));
+}
+/**
+ * Prompt for the named account that becomes this harness's default.
+ * A cancelled picker writes nothing.
+ */
+export async function pickSwitchAccount(agent, rows) {
+    if (!isInteractiveTerminal()) {
+        requireInteractiveSelection(`Selecting a ${agentLabel(agent)} account`, [
+            `agents accounts switch ${agent} <account>`,
+            `agents accounts set-default ${agent} <account>`,
+        ]);
+    }
+    if (rows.length === 0) {
+        throw new Error(`No named accounts for ${agent}. Add one with 'agents accounts add <name> --provider <p>' or 'agents accounts name ${agent}@<version> <name>'.`);
+    }
+    const choices = buildSwitchAccountChoices(rows).map(({ ready: _ready, signInRequired: _signInRequired, ...choice }) => choice);
+    try {
+        return await select({
+            message: `Select the default ${agentLabel(agent)} account:`,
+            choices,
+            loop: false,
+        });
+    }
+    catch (err) {
+        if (isPromptCancelled(err))
+            return null;
+        throw err;
+    }
+}
 /**
  * Whether a zero-healthy run may recover by launching for a login, or must keep
  * failing loud. Three inputs, all of which have to hold:

package/dist/commands/sessions-picker-factory.d.ts

@@ -0,0 +1,40 @@
+/** Flag subset both twins share for the interactive-routing gate. */
+export interface SessionsPickerGateOpts {
+    interactive?: boolean;
+    json?: boolean;
+    /** Present only on the browser twin; computer never sets it. */
+    open?: string | boolean;
+}
+export interface SessionsPickerCommandSpec<TRow, TOpts extends SessionsPickerGateOpts> {
+    /**
+     * Browser requires `opts.open === undefined` so `--open` (bare or with a
+     * selector) falls through to the flat printer. Computer has no `--open`.
+     */
+    requireOpenUndefined?: boolean;
+    runFlat: (opts: TOpts) => void;
+    buildRows: (opts: TOpts) => TRow[];
+    emptyMessage: (opts: TOpts) => string;
+    message: string;
+    matches: (row: TRow, query: string) => boolean;
+    labelFor: (row: TRow) => string;
+    buildPreview: (row: TRow) => string;
+    emptyFilterMessage: string;
+    enterHint: string;
+    onOpen: (row: TRow) => void | Promise<void>;
+}
+export interface SessionsPickerCommand<TOpts extends SessionsPickerGateOpts> {
+    shouldOpen: (opts: TOpts, isTTY: boolean) => boolean;
+    run: (opts: TOpts) => Promise<void>;
+}
+export declare function shouldOpenInteractiveSessions(opts: SessionsPickerGateOpts, isTTY: boolean, requireOpenUndefined?: boolean): boolean;
+export declare function browseSessionsUntilQuit<TRow>(spec: {
+    message: string;
+    rows: TRow[];
+    matches: (row: TRow, query: string) => boolean;
+    labelFor: (row: TRow) => string;
+    buildPreview: (row: TRow) => string;
+    emptyFilterMessage: string;
+    enterHint: string;
+    onOpen: (row: TRow) => void | Promise<void>;
+}): Promise<void>;
+export declare function createSessionsPickerCommand<TRow, TOpts extends SessionsPickerGateOpts>(spec: SessionsPickerCommandSpec<TRow, TOpts>): SessionsPickerCommand<TOpts>;

package/dist/commands/sessions-picker-factory.js

@@ -0,0 +1,67 @@
+/**
+ * Shared interactive-routing + browse loop for the task-first session
+ * pickers (`browser-sessions-picker.ts`, `computer-sessions-picker.ts`).
+ *
+ * Each twin keeps its own row formatter, matcher, and enter-handler; this
+ * factory owns the TTY/`--json`/`--no-interactive` (and optional `--open`)
+ * gate, the empty-list message, and the cancel-aware `itemPicker` loop.
+ */
+import { itemPicker } from '../lib/picker.js';
+import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
+export function shouldOpenInteractiveSessions(opts, isTTY, requireOpenUndefined = false) {
+    return (opts.interactive !== false &&
+        !opts.json &&
+        (!requireOpenUndefined || opts.open === undefined) &&
+        isTTY);
+}
+export async function browseSessionsUntilQuit(spec) {
+    for (;;) {
+        let picked;
+        try {
+            picked = await itemPicker({
+                message: spec.message,
+                items: spec.rows,
+                filter: (query) => (query.trim() ? spec.rows.filter((r) => spec.matches(r, query)) : spec.rows),
+                labelFor: spec.labelFor,
+                buildPreview: spec.buildPreview,
+                emptyMessage: spec.emptyFilterMessage,
+                enterHint: spec.enterHint,
+            });
+        }
+        catch (err) {
+            if (isPromptCancelled(err))
+                return;
+            throw err;
+        }
+        if (!picked)
+            return;
+        await spec.onOpen(picked.item);
+    }
+}
+export function createSessionsPickerCommand(spec) {
+    const shouldOpen = (opts, isTTY) => shouldOpenInteractiveSessions(opts, isTTY, spec.requireOpenUndefined === true);
+    return {
+        shouldOpen,
+        run: async (opts) => {
+            if (!shouldOpen(opts, isInteractiveTerminal())) {
+                spec.runFlat(opts);
+                return;
+            }
+            const rows = spec.buildRows(opts);
+            if (rows.length === 0) {
+                console.log(spec.emptyMessage(opts));
+                return;
+            }
+            await browseSessionsUntilQuit({
+                message: spec.message,
+                rows,
+                matches: spec.matches,
+                labelFor: spec.labelFor,
+                buildPreview: spec.buildPreview,
+                emptyFilterMessage: spec.emptyFilterMessage,
+                enterHint: spec.enterHint,
+                onOpen: spec.onOpen,
+            });
+        },
+    };
+}

package/dist/commands/setup-browser.js

@@ -10,7 +10,7 @@
 import chalk from 'chalk';
 import { setConfigValue } from '../lib/device-config.js';
 import { findFirstInstalledBrowser, listInstalledBrowsers } from '../lib/browser/chrome.js';
-import { DEFAULT_BROWSER_PROFILE_NAME, createProfile, findFreeProfilePort, getConfiguredDefaultProfileName, getProfile, } from '../lib/browser/profiles.js';
+import { DEFAULT_BROWSER_PROFILE_NAME, getAutoDetectedProfile, createProfile, findFreeProfilePort, getConfiguredDefaultProfileName, } from '../lib/browser/profiles.js';
 import { DEFAULT_VIEWPORT } from '../lib/browser/devices.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 import { defaultBrowserChoice } from './setup-preferences.js';
@@ -29,9 +29,9 @@ export async function runBrowserWizard() {
             console.error(chalk.red('No supported browser found.\n') + chalk.dim(INSTALL_HINT));
             return false;
         }
-        const existing = await getProfile(DEFAULT_BROWSER_PROFILE_NAME);
+        const existing = await getAutoDetectedProfile();
         if (existing) {
-            console.log(chalk.dim(`Browser profile "${DEFAULT_BROWSER_PROFILE_NAME}" already exists.`));
+            console.log(chalk.dim(`Browser profile "${existing.name}" already exists.`));
             return true;
         }
         const created = await createAutoDefault();
@@ -46,7 +46,7 @@ export async function runBrowserWizard() {
     }
     const { confirm, select } = await import('@inquirer/prompts');
     // If a default profile already exists, this is a reconfigure.
-    const existing = await getProfile(DEFAULT_BROWSER_PROFILE_NAME);
+    const existing = await getAutoDetectedProfile();
     if (existing) {
         console.log(chalk.dim(`Browser profile "${existing.name}" already exists (${existing.browser}${existing.binary ? ` · ${existing.binary}` : ''}).`));
         const change = await confirm({ message: 'Re-create it (e.g. to pin a different browser)?', default: false });

package/dist/commands/setup-mine.js

@@ -11,7 +11,7 @@
 import chalk from 'chalk';
 import { initBrand, registerMineManageCommands } from './mine.js';
 import { validateBrandName, getBrandConfig } from '../lib/brand.js';
-import { isShimsInPath } from '../lib/shims.js';
+import { isShimsInPath } from '../lib/installations/shims.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 /**
  * Optional/heavier top-level commands a brand commonly turns off. Kept short so

package/dist/commands/setup-preferences.js

@@ -14,7 +14,7 @@
  */
 import chalk from 'chalk';
 import { listInstalledBrowsers } from '../lib/browser/chrome.js';
-import { DEFAULT_BROWSER_PROFILE_NAME, createProfile, findFreeProfilePort, getConfiguredDefaultProfileName, getProfile, } from '../lib/browser/profiles.js';
+import { DEFAULT_BROWSER_PROFILE_NAME, getAutoDetectedProfile, createProfile, findFreeProfilePort, getConfiguredDefaultProfileName, } from '../lib/browser/profiles.js';
 import { DEFAULT_VIEWPORT } from '../lib/browser/devices.js';
 import { getConfigValue, setConfigValue } from '../lib/device-config.js';
 import { loadDevices } from '../lib/devices/registry.js';
@@ -88,7 +88,7 @@ export async function maybePickBrowserProfile() {
         return false;
     if (getConfiguredDefaultProfileName())
         return false;
-    if (await getProfile(DEFAULT_BROWSER_PROFILE_NAME))
+    if (await getAutoDetectedProfile())
         return false;
     const installed = listInstalledBrowsers();
     if (installed.length === 0)

package/dist/commands/setup.js

@@ -16,7 +16,7 @@ import { isGitRepo, cloneIntoExisting, pullRepo } from '../lib/git.js';
 import { isPromptCancelled, isInteractiveTerminal } from './utils.js';
 import { AGENTS, agentConfigDirName, getUnmanagedAgentInstalls, countSessionFiles, agentLabel } from '../lib/agents.js';
 import { setGlobalDefault } from '../lib/installations/versions.js';
-import { ensureShimCurrent, switchHomeFileSymlinks, isShimsInPath, addShimsToPath, getPathSetupInstructions, assertIsolationBoundary } from '../lib/shims.js';
+import { ensureShimCurrent, switchHomeFileSymlinks, isShimsInPath, addShimsToPath, getPathSetupInstructions, assertIsolationBoundary } from '../lib/installations/shims.js';
 import { setHelpSections } from '../lib/help.js';
 import { registerSetupBrowserCommand, runBrowserWizard } from './setup-browser.js';
 import { registerSetupComputerCommand, runComputerWizard } from './setup-computer.js';
@@ -26,7 +26,7 @@ import { registerSetupSecretsCommand } from './setup-secrets.js';
 import { registerSetupFleetCommand } from './setup-fleet.js';
 import { registerSetupWatchdogCommand, runWatchdogSetupWizard } from './setup-watchdog.js';
 import { runPreferencesStep } from './setup-preferences.js';
-import { getConfiguredDefaultProfileName, getProfile, isProfileLaunchableHere, DEFAULT_BROWSER_PROFILE_NAME } from '../lib/browser/profiles.js';
+import { getConfiguredDefaultProfileName, getProfile, getAutoDetectedProfile, isProfileLaunchableHere } from '../lib/browser/profiles.js';
 import { listInstalledBrowsers } from '../lib/browser/chrome.js';
 import { probeComputerTrust } from './computer.js';
 import { readShareConfig } from '../lib/share/config.js';
@@ -265,7 +265,9 @@ export async function ensureInitialized(program) {
 }
 export async function getSetupStatus() {
     const configuredBrowserProfile = getConfiguredDefaultProfileName();
-    const browserProfile = await getProfile(configuredBrowserProfile ?? DEFAULT_BROWSER_PROFILE_NAME);
+    const browserProfile = configuredBrowserProfile
+        ? await getProfile(configuredBrowserProfile)
+        : await getAutoDetectedProfile();
     const browserReady = browserProfile !== null && isProfileLaunchableHere(browserProfile);
     const installedBrowsers = listInstalledBrowsers();
     const computerState = process.platform === 'darwin' ? (await probeComputerTrust() ? 'ready' : 'missing') : 'n/a';

package/dist/commands/sync.js

@@ -36,7 +36,7 @@ import { resolveSyncPassphraseFromEnv } from '../lib/secrets/sync-passphrase.js'
 import { agentLabel, resolveAgentName, MANAGED_AGENT_IDS, isAgentHardDeprecated, hardDeprecationError } from '../lib/agents.js';
 import { isVersionInstalled, syncResourcesToVersion, parseAgentSpec, resolveVersion, resolveVersionAlias, listInstalledVersions, getAvailableResources, getActuallySyncedResources, getProjectOnlyResources, getNewResources, hasNewResources, promptResourceSelection, promptNewResourceSelection, buildSelection, mergeRepoScopedSelections, listRepoNames, getVersionHomePath, } from '../lib/installations/versions.js';
 import { capableAgents } from '../lib/capabilities.js';
-import { parseHookManifest, registerHooksToSettings } from '../lib/hooks.js';
+import { parseHookManifest, registerHooksToSettings } from '../lib/hooks/install.js';
 import { compileRulesForProject } from '../lib/rules/compile.js';
 import { runLaunchSync } from '../lib/project-launch.js';
 import { formatKeptProjectResources } from '../lib/project-resources.js';

package/dist/commands/versions.js

@@ -11,7 +11,7 @@ import { resolveConfiguredModel, formatAgentIdentity } from '../lib/models.js';
 import { readManifest, writeManifest, createDefaultManifest } from '../lib/manifest.js';
 import { installVersion, removeVersion, listInstalledVersions, isVersionInstalled, isLatestInstalled, isOldestInstalled, getGlobalDefault, setGlobalDefault, markVersionIsolated, setIsolatedDefault, isVersionIsolated, getVersionHomePath, getVersionDir, syncResourcesToVersion, parseAgentSpec, promptResourceSelection, promptNewResourceSelection, getAvailableResources, getActuallySyncedResources, getNewResources, getProjectOnlyResources, hasNewResources, printTrashFooter, } from '../lib/installations/versions.js';
 import { carryForwardSettings } from '../lib/settings-manifest.js';
-import { createShim, createVersionedAlias, supportsIsolatedInstall, isIsolationProtected, CONFIG_ENV_ISOLATED_AGENTS, removeShim, shimExists, getShimsDir, getShimPath, getPathShadowingExecutable, isShimsInPath, getPathSetupInstructions, addShimsToPath, switchConfigSymlink, switchHomeFileSymlinks, } from '../lib/shims.js';
+import { createShim, createVersionedAlias, supportsIsolatedInstall, isIsolationProtected, CONFIG_ENV_ISOLATED_AGENTS, removeShim, shimExists, getShimsDir, getShimPath, getPathShadowingExecutable, isShimsInPath, getPathSetupInstructions, addShimsToPath, switchConfigSymlink, switchHomeFileSymlinks, } from '../lib/installations/shims.js';
 import { isInteractiveTerminal, isPromptCancelled, requireInteractiveSelection } from './utils.js';
 import { tryAutoPull } from '../lib/git.js';
 import { getAgentsDir, getTrashVersionsDir } from '../lib/state.js';

package/dist/commands/view.js

@@ -11,7 +11,7 @@ import { authCacheKey, formatCheckedAge, readAuthHealthCache } from '../lib/auth
 import { agentReportsUsage, deriveUsageStatusFromSnapshot, formatUsageSection, formatUsageSummary, formatUsageStatusBadge, getUsageInfoForIdentity, getUsageInfoByIdentity, getUsageLookupKey, isUsageHeadlessScopeError, } from '../lib/accounting/usage.js';
 import { readManifest } from '../lib/manifest.js';
 import { listInstalledVersions, listInstalledVersionDirs, getGlobalDefault, getVersionHomePath, getVersionDir, removeVersion, printTrashFooter, reconcileStaleLatestForAgent, isGlobalBinaryAgent, getLiveVersion, isVersionIsolated, getIsolatedDefault, } from '../lib/installations/versions.js';
-import { ensureVersionedAliasCurrent, removeShim, } from '../lib/shims.js';
+import { ensureVersionedAliasCurrent, removeShim, } from '../lib/installations/shims.js';
 import { getAgentResources } from '../lib/resources.js';
 import { renderMergedResources } from '../lib/merged-resources.js';
 import { resolveVersionFilter, AgentSpecError } from '../lib/agent-spec/index.js';

package/dist/lib/account-capabilities.d.ts

@@ -24,6 +24,16 @@ export declare const NATIVE_ACCOUNT_CAPABILITIES: Record<AgentId, NativeAccountC
 export declare function nativeAccountCapability(agent: AgentId): NativeAccountCapability;
 /** Whether a harness's native login can be named/attached (supported or conditional). */
 export declare function nativeAccountNameable(agent: AgentId): boolean;
+/** Harnesses whose native login is fully nameable/attachable today. */
+export declare function supportedNativeHarnesses(): AgentId[];
+/**
+ * Named reason to refuse native name/attach, or null when the harness is
+ * nameable. Provider-credential `accounts add` is a different path and MUST
+ * not consult this — that surface is supported for every registered provider.
+ */
+export declare function nativeAccountNamingRefusal(agent: AgentId): string | null;
+/** Fail loud on the native name/attach path for an unsupported harness. */
+export declare function assertNativeAccountNameable(agent: AgentId): void;
 /**
  * The single identity key used at `accounts name`, attach, exec validation,
  * view, and inventory. Prefer the harness's stable `accountKey`. For an

package/dist/lib/account-capabilities.js

@@ -42,6 +42,40 @@ export function nativeAccountNameable(agent) {
     const cap = NATIVE_ACCOUNT_CAPABILITIES[agent];
     return (cap.status === 'supported' || cap.status === 'conditional') && cap.scope !== 'unsupported';
 }
+/** Harnesses whose native login is fully nameable/attachable today. */
+export function supportedNativeHarnesses() {
+    return Object.entries(NATIVE_ACCOUNT_CAPABILITIES)
+        .filter(([, cap]) => cap.status === 'supported')
+        .map(([id]) => id)
+        .sort();
+}
+/**
+ * Named reason to refuse native name/attach, or null when the harness is
+ * nameable. Provider-credential `accounts add` is a different path and MUST
+ * not consult this — that surface is supported for every registered provider.
+ */
+export function nativeAccountNamingRefusal(agent) {
+    if (nativeAccountNameable(agent))
+        return null;
+    const cap = NATIVE_ACCOUNT_CAPABILITIES[agent];
+    const suffix = `Supported today: ${supportedNativeHarnesses().join(', ')}.`;
+    if (cap.scope === 'device') {
+        return `${agent} accounts can't be isolated by agents-cli yet (device-scoped login). ${suffix}`;
+    }
+    if (agent === 'cursor') {
+        return `${agent} accounts can't be isolated by agents-cli yet (multi-account isolation unresolved). ${suffix}`;
+    }
+    if (cap.status === 'discovery-only') {
+        return `${agent} native accounts are discovery-only; agents-cli cannot name or attach this login. ${suffix}`;
+    }
+    return `${agent} accounts can't be named by agents-cli yet. ${suffix}`;
+}
+/** Fail loud on the native name/attach path for an unsupported harness. */
+export function assertNativeAccountNameable(agent) {
+    const reason = nativeAccountNamingRefusal(agent);
+    if (reason)
+        throw new Error(reason);
+}
 /**
  * The single identity key used at `accounts name`, attach, exec validation,
  * view, and inventory. Prefer the harness's stable `accountKey`. For an