@phnx-labs/agents-cli 1.22.74 → 1.22.76

package/dist/lib/teams/scheduler.d.ts

@@ -45,6 +45,8 @@ export interface PlacementTeam {
  * is never second-guessed.
  */
 export interface PlacementOptions {
+    /** Worker pool used when the team does not declare an explicit device pool. */
+    defaultDevices?: string[];
     maxConcurrent?: Record<string, number>;
     /**
      * Live per-device signals (RUSH-2002). When present, the many-device pick
@@ -144,8 +146,8 @@ export declare function classifyExclusions(devices: string[], roster: RosterEntr
  */
 export declare function pickBestDevice(devices: string[], roster: RosterEntry[], opts?: PlacementOptions): string;
 /**
- * Resolve where a teammate runs. Returns `{ device: null }` for a local run
- * (no pin, no pool, or the chosen device is the local machine) and
+ * Resolve where a teammate runs. Returns `{ device: null }` only when the
+ * explicitly/default-selected device is the local machine, and
  * `{ device: <name> }` for a remote placement. See the cascade in the module
  * header. Throws {@link NoViableDeviceError} when a required pool has no viable
  * host — the caller surfaces it at `teams start` rather than falling back local.

package/dist/lib/teams/scheduler.js

@@ -9,7 +9,7 @@
  *   1. teammate has an explicit `--device` pin      → that device
  *   2. else the team pool has exactly one device     → that device (whole team)
  *   3. else the team pool has many devices           → best-viable pick
- *   4. else (no pin, no pool)                         → null == run local
+ *   4. else (no pin, no pool)                         → active worker pool
  *
  * Step 3 is cap-, health-, and harness-aware (RUSH-2002). When the caller
  * supplies live {@link DevicePlacementSignal}s (probed reachability, headroom,
@@ -294,8 +294,8 @@ export function pickBestDevice(devices, roster, opts) {
     })[0];
 }
 /**
- * Resolve where a teammate runs. Returns `{ device: null }` for a local run
- * (no pin, no pool, or the chosen device is the local machine) and
+ * Resolve where a teammate runs. Returns `{ device: null }` only when the
+ * explicitly/default-selected device is the local machine, and
  * `{ device: <name> }` for a remote placement. See the cascade in the module
  * header. Throws {@link NoViableDeviceError} when a required pool has no viable
  * host — the caller surfaces it at `teams start` rather than falling back local.
@@ -306,10 +306,10 @@ export function resolvePlacement(team, explicitDevice, roster, opts) {
     if (explicitDevice) {
         return { device: isLocalDevice(explicitDevice) ? null : explicitDevice };
     }
-    const pool = team.devices ?? [];
-    // 4. No pool → local, exactly like today.
+    const pool = team.devices?.length ? team.devices : (opts?.defaultDevices ?? []);
+    // An omitted pool means automatic worker placement, never implicit local.
     if (pool.length === 0)
-        return { device: null };
+        throw new NoViableDeviceError([], opts?.agentLabel);
     // 2. Pool of one → the whole team runs there. Respect the choice for
     //    load/cap/reachability, but still fail loud when the agent is provably
     //    NOT installed there — running it would be futile.

package/dist/lib/tmux/session.d.ts

@@ -25,6 +25,8 @@ export declare const AGENTS_TMUX_HISTORY_LIMIT = 20000;
  * these defaults, silently. Same shape as AGENT_HOOK_SCHEMA below.
  */
 export declare const AGENTS_TMUX_CONFIG_SCHEMA = 1;
+/** Source one user config without tmux's quiet flag, preserving path bytes. */
+export declare function userConfigSourceLine(value: string): string;
 /** Provenance written alongside each live tmux session. */
 export interface SessionMeta {
     name: string;

package/dist/lib/tmux/session.js

@@ -55,6 +55,10 @@ let startupConfigSequence = 0;
 function tmuxConfigArgument(value) {
     return `"${value.replace(/([\\"$])/g, '\\$1')}"`;
 }
+/** Source one user config without tmux's quiet flag, preserving path bytes. */
+export function userConfigSourceLine(value) {
+    return `source-file ${tmuxConfigArgument(value)}`;
+}
 /**
  * tmux loads `-f` instead of its normal user config, so put agents-cli's
  * defaults first and explicitly source the first user config tmux would have
@@ -90,7 +94,9 @@ function writeStartupConfig(env) {
         'bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-selection-no-clear',
     ];
     for (const userConfig of userConfigs) {
-        lines.push(`source-file -q ${tmuxConfigArgument(userConfig)}`);
+        // Do not suppress parse/read failures: a broken user config must fail the
+        // launch visibly instead of producing a silently half-configured server.
+        lines.push(userConfigSourceLine(userConfig));
     }
     fs.writeFileSync(startupConfig, `${lines.join('\n')}\n`, { mode: 0o600 });
     return startupConfig;

package/dist/lib/types.d.ts

@@ -1204,6 +1204,26 @@ export interface BrowserProfileConfig {
     }>;
     /** Preset name to use when `--endpoint` is not passed to `start`. */
     defaultEndpoint?: string;
+    /**
+     * How `agents browser` obtains a live browser for this profile (PHNX-3967):
+     *   - `launch` (default when absent): agents-cli spawns the browser itself
+     *     under a managed `--user-data-dir` when nothing is serving CDP on the port.
+     *   - `attach-only`: agents-cli NEVER spawns a rival window. It attaches to a
+     *     browser the user (or a one-time command) already started with remote
+     *     debugging, and fails loud with a relaunch hint when none is there. This
+     *     is how "enforce one window" is expressed — Arc is inherently attach-only,
+     *     and a canonical signed-in Comet uses it so agents can't spawn a second,
+     *     logged-out instance. Pairs with a durable {@link userDataDir}.
+     */
+    launchPolicy?: 'attach-only' | 'launch';
+    /**
+     * Absolute durable `--user-data-dir` for this profile's browser (PHNX-3967).
+     * When absent, an attach-only profile resolves a default durable dir outside
+     * `~/.agents/.cache` (`getBrowserDurableDir()`), so a one-time sign-in survives
+     * quit+relaunch and `profiles remove`'s cache sweep. Also the value the
+     * ownership guard compares a running instance against to reject a port-squatter.
+     */
+    userDataDir?: string;
     chrome?: {
         headless?: boolean;
         args?: string[];

package/dist/lib/verbs.d.ts

@@ -0,0 +1,23 @@
+import type { Command } from 'commander';
+/**
+ * The ONE place that defines the CLI's standard short-form verb aliases.
+ *
+ * These are the canonical short forms an agent or user reaches for on a
+ * command group's CRUD verbs — `ls` for `list`, `rm` for `remove`, and so on.
+ * They are NOT cross-verb synonyms (`info`/`install`/`create`); those are
+ * per-command back-compat aliases owned by the individual commands.
+ *
+ * Apply them with {@link withAliases} so every group stays in lockstep instead
+ * of each command hand-rolling its own `.alias('rm')`.
+ */
+export declare const CANONICAL_ALIASES: {
+    readonly list: readonly ["ls"];
+    readonly view: readonly ["show"];
+    readonly add: readonly [];
+    readonly remove: readonly ["rm"];
+    readonly rename: readonly ["mv"];
+    readonly edit: readonly [];
+};
+export type CanonicalVerb = keyof typeof CANONICAL_ALIASES;
+/** Apply the standard aliases for `verb` to an already-created subcommand, returning it. */
+export declare function withAliases(cmd: Command, verb: CanonicalVerb): Command;

package/dist/lib/verbs.js

@@ -0,0 +1,24 @@
+/**
+ * The ONE place that defines the CLI's standard short-form verb aliases.
+ *
+ * These are the canonical short forms an agent or user reaches for on a
+ * command group's CRUD verbs — `ls` for `list`, `rm` for `remove`, and so on.
+ * They are NOT cross-verb synonyms (`info`/`install`/`create`); those are
+ * per-command back-compat aliases owned by the individual commands.
+ *
+ * Apply them with {@link withAliases} so every group stays in lockstep instead
+ * of each command hand-rolling its own `.alias('rm')`.
+ */
+export const CANONICAL_ALIASES = {
+    list: ['ls'],
+    view: ['show'],
+    add: [],
+    remove: ['rm'],
+    rename: ['mv'],
+    edit: [],
+};
+/** Apply the standard aliases for `verb` to an already-created subcommand, returning it. */
+export function withAliases(cmd, verb) {
+    const aliases = CANONICAL_ALIASES[verb];
+    return aliases.length ? cmd.aliases([...aliases]) : cmd;
+}

package/dist/lib/view-types.d.ts

@@ -23,12 +23,16 @@ export interface ViewJsonVersion {
     launchable: boolean;
     /** Live cached authentication verdict for this installed version. */
     authVerdict: AuthVerdict | null;
+    /** Epoch milliseconds when authVerdict was last checked, or null if absent. */
+    authCheckedAt: number | null;
     email: string | null;
     accountId?: string | null;
     organizationType?: string | null;
     organizationName?: string | null;
     plan: string | null;
     usageStatus: 'available' | 'rate_limited' | 'out_of_credits' | null;
+    /** ISO timestamp of the usage snapshot behind usageStatus, or null if absent. */
+    usageCapturedAt: string | null;
     overageCredits?: {
         amount: number;
         currency: string;

package/dist/lib/watchdog/rotate.d.ts

@@ -166,7 +166,7 @@ export declare function isWatchdogRotateEnabled(): boolean;
  * Persist `watchdog.rotate: on|off`. Called by the `agents watchdog rotate
  * on|off` subcommand (commands/watchdog.ts) — the rotate-only switch the
  * Factory migration uses so a user who opted out of autoRotate keeps nudging
- * (rather than `agents watchdog off`, which disables the whole watchdog here).
+ * (rather than `agents watchdog disable`, which disables the whole watchdog here).
  */
 export declare function setWatchdogRotateEnabled(on: boolean): void;
 export interface RotateGateResult {

package/dist/lib/watchdog/rotate.js

@@ -291,7 +291,7 @@ export function isWatchdogRotateEnabled() {
  * Persist `watchdog.rotate: on|off`. Called by the `agents watchdog rotate
  * on|off` subcommand (commands/watchdog.ts) — the rotate-only switch the
  * Factory migration uses so a user who opted out of autoRotate keeps nudging
- * (rather than `agents watchdog off`, which disables the whole watchdog here).
+ * (rather than `agents watchdog disable`, which disables the whole watchdog here).
  */
 export function setWatchdogRotateEnabled(on) {
     const meta = readMeta();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.22.74",
+  "version": "1.22.76",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",