@phnx-labs/agents-cli 1.22.39 → 1.22.41

package/dist/commands/setup-fleet.js

@@ -10,6 +10,7 @@ import { spawnSync } from 'node:child_process';
 import { getCliLaunch } from '../lib/cli-entry.js';
 import { loadDevices } from '../lib/devices/registry.js';
 import { runDeviceSync } from '../lib/devices/sync.js';
+import { setDeviceDiscoveryStatus } from '../lib/devices/discovery-policy.js';
 import { tailscaleStatusJson } from '../lib/devices/tailscale.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 import { maybePickInteractiveHost } from './setup-preferences.js';
@@ -107,6 +108,8 @@ async function syncDevices(opts) {
         console.error(chalk.red(`Tailscale discovery failed: ${res.reason ?? 'unknown error'}`));
         return false;
     }
+    for (const name of res.syncedNames)
+        setDeviceDiscoveryStatus(name, 'approved');
     const extra = res.pending.length ? chalk.gray(` (${res.pending.length} new)`) : '';
     console.log(chalk.green(`Synced ${res.synced} device${res.synced === 1 ? '' : 's'} from Tailscale${extra}.`));
     return true;

package/dist/commands/setup-mine.d.ts

@@ -2,10 +2,11 @@
  * `agents setup mine` — interactive wizard to white-label the CLI under your own
  * name. Pick a name, choose which features to turn off, and get a personally-
  * named binary (e.g. `jack`) that runs every agents verb as yours. Delegates the
- * actual minting to `initBrand` (see mine.ts); the `agents mine` group manages
- * brands afterward.
+ * actual minting to `initBrand` (see mine.ts). Manage verbs (init/list/toggle/
+ * remove) live under the same `setup mine` command.
  *
  * Idempotent: re-running for an existing brand offers to re-mint it.
+ * Bare `agents setup mine` (no subcommand) runs the wizard.
  */
 import type { Command } from 'commander';
 /**
@@ -14,5 +15,8 @@ import type { Command } from 'commander';
  * relies on that.
  */
 export declare function runMineWizard(): Promise<boolean>;
-/** Register `agents setup mine` under the parent `setup` command. */
+/**
+ * Register `agents setup mine` under the parent `setup` command.
+ * Bare invocation runs the wizard; init/list/toggle/remove manage brands.
+ */
 export declare function registerSetupMineCommand(setupCmd: Command): void;

package/dist/commands/setup-mine.js

@@ -2,20 +2,21 @@
  * `agents setup mine` — interactive wizard to white-label the CLI under your own
  * name. Pick a name, choose which features to turn off, and get a personally-
  * named binary (e.g. `jack`) that runs every agents verb as yours. Delegates the
- * actual minting to `initBrand` (see mine.ts); the `agents mine` group manages
- * brands afterward.
+ * actual minting to `initBrand` (see mine.ts). Manage verbs (init/list/toggle/
+ * remove) live under the same `setup mine` command.
  *
  * Idempotent: re-running for an existing brand offers to re-mint it.
+ * Bare `agents setup mine` (no subcommand) runs the wizard.
  */
 import chalk from 'chalk';
-import { initBrand } from './mine.js';
+import { initBrand, registerMineManageCommands } from './mine.js';
 import { validateBrandName, getBrandConfig } from '../lib/brand.js';
 import { isShimsInPath } from '../lib/shims.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 /**
  * Optional/heavier top-level commands a brand commonly turns off. Kept short so
  * the checkbox is scannable — anything can still be toggled later with
- * `agents mine toggle <name> --disable <cmd>`.
+ * `agents setup mine toggle <name> --disable <cmd>`.
  */
 const DISABLEABLE_FEATURES = [
     { name: 'teams', hint: 'coordinate multiple agents on shared work' },
@@ -34,7 +35,7 @@ const DISABLEABLE_FEATURES = [
 export async function runMineWizard() {
     if (!isInteractiveTerminal()) {
         console.log(chalk.dim('Non-interactive shell. Create a brand directly, e.g.:\n') +
-            chalk.cyan('  agents mine init jack --disable teams cloud'));
+            chalk.cyan('  agents setup mine init jack --disable teams cloud'));
         return false;
     }
     const { input, checkbox, confirm } = await import('@inquirer/prompts');
@@ -79,14 +80,17 @@ function printNextSteps(name, pathWarning) {
     console.log(chalk.bold('\nTry it:'));
     console.log('  ' + chalk.cyan(`${name} --help`) + chalk.dim(`         # your CLI, your name`));
     console.log('  ' + chalk.cyan(`${name} run claude "hello"`));
-    console.log(chalk.dim(`  Manage it later:  agents mine toggle ${name} --disable <cmd>   ·   agents mine list`));
+    console.log(chalk.dim(`  Manage it later:  agents setup mine toggle ${name} --disable <cmd>   ·   agents setup mine list`));
     if (pathWarning) {
         console.log(chalk.yellow(`\n  note: the shims dir isn't on your PATH yet — run 'agents setup' or open a new shell.`));
     }
 }
-/** Register `agents setup mine` under the parent `setup` command. */
+/**
+ * Register `agents setup mine` under the parent `setup` command.
+ * Bare invocation runs the wizard; init/list/toggle/remove manage brands.
+ */
 export function registerSetupMineCommand(setupCmd) {
-    setupCmd
+    const mineCmd = setupCmd
         .command('mine')
         .description('White-label the CLI — mint your own personally-named binary (e.g. `jack`).')
         .action(async () => {
@@ -102,4 +106,5 @@ export function registerSetupMineCommand(setupCmd) {
             process.exitCode = 1;
         }
     });
+    registerMineManageCommands(mineCmd);
 }

package/dist/commands/setup-preferences.js

@@ -115,10 +115,10 @@ export async function maybePickBrowserProfile() {
         viewport: { width: DEFAULT_VIEWPORT.width, height: DEFAULT_VIEWPORT.height },
     };
     await createProfile(profile);
-    // The same key `agents browser profiles set-default` writes (device-local).
+    // The same key `agents browser use` writes (device-local).
     setConfigValue('browser.profile', profile.name);
     console.log(chalk.green(`Browser: '${chosen.browserType}'`) +
-        chalk.dim(` — profile "${profile.name}" is this machine's default (agents browser profiles set-default to change).`));
+        chalk.dim(` — profile "${profile.name}" is this machine's default (agents browser use to change).`));
     return true;
 }
 /**

package/dist/commands/setup-secrets.js

@@ -69,7 +69,7 @@ function printBackendNotes(backend) {
         console.log(chalk.gray('backend: file — encrypted at rest; headless reads need no passphrase by default, via a machine-local key at ~/.agents/.secrets-key/passphrase.'));
     }
     else {
-        console.log(chalk.gray('backend: vault — synced ~/.agents/vault.age storage; unlock it with agents login.'));
+        console.log(chalk.gray('backend: vault — synced ~/.agents/vault.age storage; unlock it with `agents secrets vault unlock`.'));
     }
 }
 function runAgentsSubcommand(args) {
@@ -138,7 +138,7 @@ async function resolveInteractiveChoices(opts) {
         choices: [
             { name: 'keychain — local OS keychain; reads may ask for Touch ID/device password', value: 'keychain' },
             { name: 'file — passphrase-encrypted file store for headless machines', value: 'file' },
-            { name: 'vault — synced ~/.agents/vault.age file; requires agents login', value: 'vault' },
+            { name: 'vault — synced ~/.agents/vault.age file; requires `agents secrets vault unlock`', value: 'vault' },
         ],
     });
     const policy = opts.policy ? parsePolicy(opts.policy) : await select({

package/dist/commands/setup-watchdog.js

@@ -10,7 +10,7 @@ export async function runWatchdogSetupWizard() {
     const devices = [...new Set([...Object.keys(registry), machineId()].map(normalizeHost))].sort();
     const enabled = new Set(devices.filter((device) => getConfigValue('watchdog.enabled', { device }).value === true));
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        requireInteractiveSelection('watchdog devices', ['agents watchdog on', 'agents watchdog on --host <device>']);
+        requireInteractiveSelection('watchdog devices', ['agents watchdog on', 'agents watchdog on --device <device>']);
     }
     try {
         const { checkbox } = await import('@inquirer/prompts');
@@ -25,7 +25,7 @@ export async function runWatchdogSetupWizard() {
                 setConfigValue('watchdog.enabled', on);
                 continue;
             }
-            const launch = getCliLaunch(['watchdog', on ? 'on' : 'off', '--host', device]);
+            const launch = getCliLaunch(['watchdog', on ? 'on' : 'off', '--device', device]);
             const result = spawnSync(launch.command, launch.args, { stdio: 'inherit', env: process.env });
             if ((result.status ?? 1) !== 0)
                 throw new Error(`Could not configure watchdog on ${device}`);

package/dist/commands/setup.js

@@ -15,7 +15,7 @@ import { getAgentsDir, getVersionsDir, ensureAgentsDir } from '../lib/state.js';
 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/versions.js';
+import { setGlobalDefault } from '../lib/installations/versions.js';
 import { ensureShimCurrent, switchHomeFileSymlinks, isShimsInPath, addShimsToPath, getPathSetupInstructions, assertIsolationBoundary } from '../lib/shims.js';
 import { setHelpSections } from '../lib/help.js';
 import { registerSetupBrowserCommand, runBrowserWizard } from './setup-browser.js';
@@ -137,7 +137,7 @@ export async function runSetup(program, options = {}) {
             : (await import('../lib/device-config.js')).isDaemonEnabled();
         if (enabled) {
             const start = options.startDaemonFn
-                ?? (await import('../lib/daemon.js')).startDaemon;
+                ?? (await import('../lib/daemon/daemon.js')).startDaemon;
             const started = start();
             if (started.method !== 'already-running' && started.pid) {
                 console.log(chalk.gray(`Started the always-on agents daemon (pid ${started.pid}).`));
@@ -150,6 +150,11 @@ export async function runSetup(program, options = {}) {
     // resolve to ok:false), so this can never block setup.
     const { runDeviceSync } = await import('../lib/devices/sync.js');
     const dev = await runDeviceSync({ soft: true });
+    if (dev.ok) {
+        const { setDeviceDiscoveryStatus } = await import('../lib/devices/discovery-policy.js');
+        for (const name of dev.syncedNames)
+            setDeviceDiscoveryStatus(name, 'approved');
+    }
     if (dev.ok && dev.synced > 0) {
         console.log(chalk.gray(`Discovered ${dev.synced} device${dev.synced === 1 ? '' : 's'} on your tailnet (agents devices list).`));
     }

package/dist/commands/share.d.ts

@@ -21,6 +21,24 @@ export interface ShareListItem {
     publishedAt: string;
     /** ISO auto-expire timestamp, or null for a permanent share. */
     expiresAt: string | null;
+    /** Human display title (explicit `--label` or auto-derived), or null for a
+     * share published before this field existed. */
+    label: string | null;
+    /** Harness/agent name that published this (`AGENTS_AGENT_NAME`), or null. */
+    agent: string | null;
+    /** Session id that published this, or null. */
+    session: string | null;
+    /** Hostname the publish ran from, or null. */
+    host: string | null;
+    /** git repo name at publish time, or null (published outside a git repo, or
+     * before this field existed). */
+    repo: string | null;
+    /** Count of retained prior versions under this slug (see `share revisions`). */
+    revisionCount: number;
+    /** Arbitrary `--meta key=value` entries attached at publish time (RUSH-2683)
+     * — everything that isn't a reserved provenance/label key. `{}` when none
+     * were set, or when the deployed Worker predates this field. */
+    meta: Record<string, string>;
 }
 export interface ShareListResult {
     /** The namespace listed. */
@@ -48,11 +66,58 @@ export declare function runShareList(opts?: {
     githubUser?: string;
     config?: ShareConfig;
     fetchListing?: ListingFetchFn;
+    /** Only shares published by this agent/harness (case-insensitive, exact). */
+    agent?: string;
+    /** Only shares published from this session id (exact). */
+    session?: string;
+    /** Only shares whose label contains this text (case-insensitive substring). */
+    label?: string;
 }): Promise<ShareListResult>;
 export declare function formatShareList(result: ShareListResult, json?: boolean): string;
+/** One retained prior version of a slug, as reported by the Worker's
+ * `?revisions=json` route. */
+export interface ShareRevisionItem {
+    /** R2 object key, `<user>/<slug>/rev-<ts>-<rand>`. */
+    key: string;
+    url: string;
+    size: number;
+    contentType: string | null;
+    /** ISO timestamp this version was replaced (when the copy was made). */
+    uploadedAt: string;
+    expiresAt: string | null;
+    label: string | null;
+    agent: string | null;
+    session: string | null;
+    host: string | null;
+    repo: string | null;
+    /** Arbitrary `--meta key=value` entries attached at publish time (RUSH-2683)
+     * — everything that isn't a reserved provenance/label key. `{}` when none
+     * were set, or when the deployed Worker predates this field. */
+    meta: Record<string, string>;
+}
+export interface ShareRevisionsResult {
+    /** The canonical `<user>/<slug>` key these are revisions of. */
+    key: string;
+    count: number;
+    revisions: ShareRevisionItem[];
+}
+/** Parse the Worker's `?revisions=json` payload, failing loud (with the same
+ * outdated-template hint as {@link parseShareListing}) on an unexpected shape. */
+export declare function parseShareRevisions(key: string, body: string): ShareRevisionsResult;
+/** Fetch and parse the retained prior versions of one published slug. `target`
+ * accepts the same three forms as `agents unshare` (a full URL, `<user>/<slug>`,
+ * or a bare slug resolved against the caller's own namespace) — reuses
+ * {@link resolveDeleteTarget} rather than re-deriving the key. */
+export declare function runShareRevisions(target: string, opts?: {
+    githubUser?: string;
+    config?: ShareConfig;
+    fetchListing?: ListingFetchFn;
+}): Promise<ShareRevisionsResult>;
+export declare function formatShareRevisions(result: ShareRevisionsResult, json?: boolean): string;
 export declare function formatShareDeleteResult(result: DeleteShareResult, json?: boolean): string;
 interface ShareDeleteCliOpts {
     keepCover?: boolean;
+    keepRevisions?: boolean;
     ifExists?: boolean;
     githubUser?: string;
     json?: boolean;