@phnx-labs/agents-cli 1.22.95 → 1.22.97

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.22.97
+
+- `agents browser --help` and the `agents setup browser` install hint no longer claim Firefox is unsupported: they now state Chromium-family over CDP, Arc natively, and Firefox over WebDriver BiDi (Safari stays unsupported). `tabs --all` gains a help example and rows in the Arc and Firefox capability tables.
+
+- **`agents browser tabs --all` shows every tab open in the profile browser, yours included (PHNX-4043).** Until now `tabs` listed only the task's own tabs, so an agent sharing an Arc Space, a Comet store, or a Firefox profile with you could not see what else was open. `--all` lists every top-level tab: OWNER names the agents-cli task that owns it, or `you` for a tab no task owns; `*` still marks the task's current tab. Read-only on every backend (Chromium `Target.getTargets`, the Arc Space's tabs, Firefox `browsingContext.getTree`). Source: `cli/src/lib/browser/service.ts` `profileTabs`, `cli/src/commands/browser.ts`.
+
 ## 1.22.95
 
 - **Firefox automation over WebDriver BiDi (PHNX-4043).** `agents browser` now drives

package/dist/commands/browser.js

@@ -329,6 +329,9 @@ export function registerBrowserCommand(program) {
       agents browser navigate https://example.com
       agents browser screenshot
 
+      # Every tab open in the profile browser, yours next to the task's (OWNER column)
+      agents browser tabs --all
+
       # Keep one process and browser-service socket warm for repeated actions
       agents browser stream --task "$AGENTS_BROWSER_TASK"
 
@@ -358,9 +361,10 @@ export function registerBrowserCommand(program) {
       Most agent workflows should use the 'browser' skill instead of raw subcommands.
       The skill wraps profile selection, snapshotting, and tunneling.
 
-      Browser support: Chromium-family only (Chrome, Comet, Chromium, Brave, Edge, Arc).
-      Safari and Firefox are not supported — they don't speak the Chrome DevTools
-      Protocol the way agents browser expects. On Windows, Edge is the default
+      Browser support: Chromium-family over the Chrome DevTools Protocol (Chrome,
+      Comet, Chromium, Brave, Edge), Arc natively (one profile per Space), and
+      Firefox over WebDriver BiDi (one profile per profiles.ini entry; Firefox 129+
+      dropped CDP). Safari is not supported. On Windows, Edge is the default
       because it's preinstalled. On macOS and Linux, Chrome is preferred when
       installed; otherwise the first Chromium-family binary on disk wins.
     `,
@@ -2235,15 +2239,17 @@ function registerTaskCommands(browser) {
     });
     browser
         .command('tabs')
-        .description('List tabs open for the current task')
+        .description('List tabs open for the current task; --all shows every tab open in the profile browser, yours included')
         .option(TASK_OPTION_FLAG, TASK_OPTION_DESC)
         .option(DEVICE_ON_PAGE_VERB_FLAG, DEVICE_ON_PAGE_VERB_DESC)
+        .option('--all', "Every tab open in the profile browser, not only this task's: OWNER names the owning task, or \"you\" for a tab no task owns")
         .option('--json', 'Output machine-readable JSON')
         .action(async (opts) => {
         const task = resolveTaskName(opts);
         const response = await sendIPCRequest({
             action: 'tab-list',
             task,
+            ...(opts.all ? { all: true } : {}),
         });
         if (!response.ok) {
             if (opts.json) {
@@ -2262,6 +2268,16 @@ function registerTaskCommands(browser) {
             console.log('No tabs open');
             return;
         }
+        if (opts.all) {
+            console.log('TAB'.padEnd(12) + 'OWNER'.padEnd(18) + 'URL');
+            console.log('-'.repeat(88));
+            for (const t of response.tabs) {
+                const owner = t.task ?? 'you';
+                const current = t.current ? ' *' : '';
+                console.log(t.id.slice(0, 11).padEnd(12) + owner.slice(0, 17).padEnd(18) + t.url.slice(0, 55) + current);
+            }
+            return;
+        }
         console.log('TAB'.padEnd(12) + 'URL');
         console.log('-'.repeat(70));
         for (const t of response.tabs) {

package/dist/commands/setup-browser.js

@@ -15,7 +15,8 @@ import { DEFAULT_VIEWPORT } from '../lib/browser/devices.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
 import { defaultBrowserChoice } from './setup-preferences.js';
 const INSTALL_HINT = 'Install one of: Google Chrome, Brave, Microsoft Edge, Chromium, Comet, or Arc, then re-run `agents setup browser`.\n' +
-    '(Safari and Firefox are not supported — agents browser drives over the Chrome DevTools Protocol.)';
+    '(This wizard picks a Chromium-family browser. An installed Firefox is not auto-picked here; its profiles are ' +
+    'discovered from profiles.ini and selected with `agents browser use firefox-<name>`. Safari is not supported.)';
 /**
  * Interactive browser setup. Returns true if a usable default profile exists
  * afterwards, false if none exists / the user backed out. Non-interactively it

package/dist/lib/browser/chrome.js

@@ -187,9 +187,10 @@ export function findBrowserPath(browserType, customBinary) {
     throw new Error(`Browser "${browserType}" not found. Install it first.`);
 }
 // Per-platform Chromium-family priority list for "no --profile" auto-pick.
-// Order is: most-likely-installed-and-stable first. Safari and Firefox are
-// intentionally excluded — they don't speak the Chrome DevTools Protocol the
-// way cdp.ts expects, so they'd need separate drivers.
+// Order is: most-likely-installed-and-stable first. Firefox is intentionally
+// absent: it has its own WebDriver BiDi driver (drivers/firefox.ts) and its
+// profiles come from profiles.ini discovery, never from this binary pick.
+// Safari has no driver at all.
 const DEFAULT_BROWSER_PRIORITY = {
     // macOS: Chrome leads (>70% of dev machines), then the rest of the family.
     // Arc is last: it's in maintenance mode and needs a blank tab to drive, so it

package/dist/lib/browser/ipc.js

@@ -935,6 +935,10 @@ export class BrowserIPCServer {
                 if (!request.task) {
                     return { ok: false, error: 'Task required' };
                 }
+                if (request.all) {
+                    const tabs = await this.service.profileTabs(request.task);
+                    return { ok: true, tabs: tabs.map(t => ({ id: t.id, url: t.url, title: t.title, current: t.current, task: t.task })) };
+                }
                 const tabs = await this.service.tabList(request.task);
                 // Carry `current` through — it is the one field a caller needs to show
                 // which tab URL-less verbs act on, and dropping it here left `agents

package/dist/lib/browser/service.d.ts

@@ -1,7 +1,7 @@
 import { CDPClient } from './cdp.js';
 import { type DeviceProbe } from './resolve-target.js';
 import { type ResolvedDomainSkill } from './domain-skills.js';
-import { type Task, type TabInfo, type ProfileStatus, type BrowserType, type HistoricalTask, type ReapResult, type ProfileName, type ConnectionKey } from './types.js';
+import { type Task, type TabInfo, type ProfileTabInfo, type ProfileStatus, type BrowserType, type HistoricalTask, type ReapResult, type ProfileName, type ConnectionKey } from './types.js';
 import { type ReapOptions } from './hygiene.js';
 import { type RefOpts, type RefNode } from './refs.js';
 import type { TargetFilter, PageOpenResult, ArcNativeProfileIdentity, FirefoxProfileIdentity } from './types.js';
@@ -380,6 +380,14 @@ export declare class BrowserService {
         title: string;
         current: boolean;
     }>>;
+    /**
+     * Every top-level tab open in the task's profile browser, the owner's tabs
+     * included (`agents browser tabs --all`). Read-only: nothing is focused,
+     * navigated, or closed. A tab an agents-cli task owns carries that task's
+     * name and short id (so it can be addressed); any other tab carries the
+     * browser's own id and no task. Same rows on every backend.
+     */
+    profileTabs(taskId: string): Promise<ProfileTabInfo[]>;
     private resolveTabHint;
     private resolveCurrentTab;
     private getCdpTargetId;

package/dist/lib/browser/service.js

@@ -1242,6 +1242,64 @@ export class BrowserService {
         }
         return tabs;
     }
+    /**
+     * Every top-level tab open in the task's profile browser, the owner's tabs
+     * included (`agents browser tabs --all`). Read-only: nothing is focused,
+     * navigated, or closed. A tab an agents-cli task owns carries that task's
+     * name and short id (so it can be addressed); any other tab carries the
+     * browser's own id and no task. Same rows on every backend.
+     */
+    async profileTabs(taskId) {
+        const { conn, task } = await this.findTask(taskId);
+        const owners = new Map();
+        for (const [, owner] of conn.tasks) {
+            const entries = conn.backend === 'arc-native'
+                ? Object.entries(owner.arcNative?.tabs ?? {}).map(([shortId, ref]) => [shortId, ref.tabId])
+                : Object.entries(owner.tabs);
+            for (const [shortId, nativeId] of entries)
+                owners.set(nativeId, { owner, shortId });
+        }
+        const row = (nativeId, url, title) => {
+            const owned = owners.get(nativeId);
+            if (!owned)
+                return { id: nativeId, url, title };
+            return {
+                id: owned.shortId,
+                url,
+                title,
+                task: owned.owner.name,
+                current: owned.owner === task && owned.shortId === task.currentTabId,
+            };
+        };
+        if (conn.backend === 'arc-native') {
+            const native = this.requireArcTask(task);
+            const space = (await enumerateArcSpaces()).find((candidate) => candidate.windowId === native.windowId && candidate.spaceId === native.spaceId);
+            if (!space) {
+                throw new Error(`Arc Space "${native.spaceTitle}" is not open in its original window (${native.windowId}); ` +
+                    'open it in Arc and retry.');
+            }
+            return space.tabs.map((tab) => row(tab.tabId, tab.url, tab.title));
+        }
+        if (conn.backend === 'bidi') {
+            const rows = [];
+            for (const context of await bidiTopLevelContexts(conn.bidi)) {
+                let title = '';
+                try {
+                    title = String(await bidiEvaluate(conn.bidi, context.context, 'document.title'));
+                }
+                catch {
+                    /* about: pages or a mid-navigation context — url is enough */
+                }
+                rows.push(row(context.context, context.url, title));
+            }
+            return rows;
+        }
+        requireCdp(conn, 'enumerate');
+        const { targetInfos } = (await conn.cdp.send('Target.getTargets'));
+        return targetInfos
+            .filter((target) => target.type === 'page')
+            .map((target) => row(target.targetId, target.url, target.title));
+    }
     async resolveTabHint(conn, task, hint) {
         // Exact match
         if (task.tabs[hint])

package/dist/lib/browser/types.d.ts

@@ -327,6 +327,20 @@ export interface TabInfo {
     /** Whether this is the task's current tab (the one URL-less verbs act on). */
     current?: boolean;
 }
+/**
+ * One row of `agents browser tabs --all`: a top-level tab open in the profile's
+ * browser. Owned by an agents-cli task → `task` names it and `id` is that
+ * task's short tab id; otherwise (the owner's own tab, or a tab from another
+ * tool) `task` is absent and `id` is the browser's own tab id.
+ */
+export interface ProfileTabInfo {
+    id: string;
+    url: string;
+    title: string;
+    task?: string;
+    /** The queried task's current tab. */
+    current?: boolean;
+}
 export interface ProfileStatus {
     /**
      * The BARE profile name — what the user passed to `--profile` and what
@@ -360,6 +374,7 @@ export interface TaskStatus {
         url: string;
         title?: string;
         current?: boolean;
+        task?: string;
     }>;
 }
 export interface HistoricalTask {
@@ -395,6 +410,8 @@ export interface IPCRequest {
     action: IPCAction;
     task?: string;
     taskName?: string;
+    /** tab-list: every tab open in the profile browser, not only the task's own. */
+    all?: boolean;
     profile?: string;
     url?: string;
     tabId?: string;
@@ -543,7 +560,8 @@ export interface IPCResponse {
      */
     reused?: boolean;
     windowTargetId?: string;
-    tabs?: TabInfo[];
+    /** `tab-list` rows; `task` is absent for a tab no agents-cli task owns (`--all`). */
+    tabs?: ProfileTabInfo[];
     profiles?: ProfileStatus[];
     history?: HistoricalTask[];
     /** `gc`: what the abandoned-task reaper closed (or would close under dryRun). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.22.95",
+  "version": "1.22.97",
   "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",