@phnx-labs/agents-cli 1.22.94 → 1.22.96

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

@@ -1,16 +1,19 @@
 import type { ArcNativeTabRef } from './drivers/arc.js';
 export type { ArcNativeTabRef } from './drivers/arc.js';
-export type BrowserType = 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'custom';
+export type BrowserType = 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'firefox' | 'custom';
 /**
  * The transport backend a live browser connection uses (PHNX-2399).
  *   - `cdp` — Chrome DevTools Protocol (the existing path for all Chromium-family browsers).
  *   - `arc-native` — Apple Events via `osascript` (the native Arc path, no CDP port required).
+ *   - `bidi` — WebDriver BiDi over a WebSocket (Firefox, PHNX-4043; Firefox 129+
+ *     ships no CDP at all).
  *
  * Load-bearing: every action method on `BrowserService` that calls `conn.cdp.send()`
  * must check `conn.backend` and route to the native driver instead when it is
- * `arc-native`. Unsupported native verbs throw `ArcNativeCapabilityError`.
+ * `arc-native` or `bidi`. Unsupported verbs throw `ArcNativeCapabilityError` /
+ * `FirefoxCapabilityError`.
  */
-export type BackendKind = 'cdp' | 'arc-native';
+export type BackendKind = 'cdp' | 'arc-native' | 'bidi';
 /**
  * Stable native identity carried by an Arc profile declaration (PHNX-2399).
  * One agents-cli profile is one Arc Space: the Space already carries its Arc
@@ -176,6 +179,8 @@ export interface BrowserProfile {
      * `resolveProfileDataDir(profile)` rather than reading directly.
      */
     userDataDir?: string;
+    /** Chromium profile directory inside `userDataDir` for a discovered native profile (PHNX-4042). */
+    profileDirectory?: string;
     chrome?: ChromeOptions;
     secrets?: string;
     viewport?: {
@@ -190,6 +195,26 @@ export interface BrowserProfile {
     logHost?: string;
     /** Native Arc identity. Present only for an `arc-native:` profile. */
     arc?: ArcNativeProfileIdentity;
+    /**
+     * The Firefox profile this agents-cli profile is pinned to (PHNX-4043).
+     * Present only for a `bidi:` profile discovered from `profiles.ini`; the
+     * directory itself is {@link userDataDir}, which is what Firefox is launched
+     * with (`--profile <dir>`).
+     */
+    firefox?: FirefoxProfileIdentity;
+}
+/**
+ * Stable identity of a Firefox profile discovered from `profiles.ini` (PHNX-4043).
+ * One agents-cli profile is one Firefox profile: it already carries the cookies
+ * and logins, so agents never learn a second concept.
+ */
+export interface FirefoxProfileIdentity {
+    /** The `Name=` of the `[ProfileN]` section. Display + slug source only. */
+    profileName: string;
+    /** The `profiles.ini` the entry was read from. Display only. */
+    iniPath: string;
+    /** Whether `profiles.ini` marks the entry `Default=1`. Display only. */
+    isDefault: boolean;
 }
 /** Parsed form of `BrowserProfile.targetFilter`. */
 export interface TargetFilter {
@@ -205,6 +230,10 @@ export interface ChromeOptions {
         x?: number;
         y?: number;
     };
+    /** The browser's own user-data dir; set only for a discovered native profile (PHNX-4042). */
+    userDataDir?: string;
+    /** Chromium profile directory inside `userDataDir` (`Default`, `Profile 1`, ...). */
+    profileDirectory?: string;
 }
 export interface Task {
     id: string;
@@ -298,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
@@ -331,6 +374,7 @@ export interface TaskStatus {
         url: string;
         title?: string;
         current?: boolean;
+        task?: string;
     }>;
 }
 export interface HistoricalTask {
@@ -366,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;
@@ -514,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/dist/lib/daemon/usage-sync-service.js

@@ -32,6 +32,18 @@ export class UsageSyncService extends BasePeriodicService {
         const { consumeUsageSnapshotsFromSharedStore, publishUsageSnapshotToSharedStore } = await import('../accounting/usage-sync.js');
         const { consumeSessionMirrorFromSharedStore, publishSessionMirrorToSharedStore } = await import('../session/mirror.js');
         // Publish every owned field BEFORE the single git exchange so they ride one commit.
+        // Discovered native browser profiles (Arc Spaces, Comet profiles) go into this
+        // device's declaration first, so every other box lists them with WHERE=<here>
+        // and routes a `--profile` for one of them to this machine (PHNX-4042).
+        const { publishDiscoveredProfiles } = await import('../browser/profiles.js');
+        const profiles = await publishDiscoveredProfiles().catch((error) => ({
+            published: [],
+            errors: { publish: error instanceof Error ? error.message : String(error) },
+        }));
+        if (profiles.published.length > 0)
+            ctx.log('INFO', `browser-profiles: published ${profiles.published.join(', ')} to this device's declaration`);
+        for (const [browser, message] of Object.entries(profiles.errors))
+            ctx.log('WARN', `browser-profiles: ${browser}: ${message}`);
         const published = await publishUsageSnapshotToSharedStore();
         if (published.changed)
             ctx.log('INFO', `usage-sync: published usage snapshot to ${published.path}`);

package/dist/lib/open-url.js

@@ -135,6 +135,12 @@ export async function resolveViewer(opts = {}) {
         console.error(`[viewer] "${resolved}" is Arc, which cannot open a new viewer tab — using the OS browser.`);
         return 'os';
     }
+    if (profile.browser === 'firefox') {
+        // agents drives Firefox headless over BiDi for its own read-back; a page a
+        // human is meant to read goes to the visible OS browser, not the headless one.
+        console.error(`[viewer] "${resolved}" is a headless-automation Firefox profile — using the OS browser.`);
+        return 'os';
+    }
     if (!isProfileLaunchableHere(profile)) {
         console.error(`[viewer] "${resolved}" cannot launch on this machine — using the OS browser.`);
         return 'os';

package/dist/lib/types.d.ts

@@ -1245,7 +1245,7 @@ export interface HostEntry {
 /** Browser profile definition stored in agents.yaml. */
 export interface BrowserProfileConfig {
     description?: string;
-    browser: 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'custom';
+    browser: 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'firefox' | 'custom';
     binary?: string;
     electron?: boolean;
     /**
@@ -1290,6 +1290,12 @@ export interface BrowserProfileConfig {
      * ownership guard compares a running instance against to reject a port-squatter.
      */
     userDataDir?: string;
+    /**
+     * Chromium profile directory inside {@link userDataDir} (`Default`,
+     * `Profile 1`, ...) for a profile discovered from the browser's own store
+     * (PHNX-4042). Launch passes it as `--profile-directory`.
+     */
+    profileDirectory?: string;
     chrome?: {
         headless?: boolean;
         args?: string[];
@@ -1310,6 +1316,12 @@ export interface BrowserProfileConfig {
         spaceId: string;
         spaceTitle: string;
     };
+    /** The `profiles.ini` entry a discovered Firefox profile is pinned to (PHNX-4043); the dir is `userDataDir`. */
+    firefox?: {
+        profileName: string;
+        iniPath: string;
+        isDefault: boolean;
+    };
 }
 /** Options controlling which agents and resources are synced during `agents sync` / `agents use`. */
 export interface SyncOptions {

package/package.json

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