@phnx-labs/agents-cli 1.22.93 → 1.22.95

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

@@ -1,4 +1,56 @@
-export type BrowserType = 'chrome' | 'comet' | 'chromium' | 'brave' | 'edge' | 'arc' | 'custom';
+import type { ArcNativeTabRef } from './drivers/arc.js';
+export type { ArcNativeTabRef } from './drivers/arc.js';
+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` or `bidi`. Unsupported verbs throw `ArcNativeCapabilityError` /
+ * `FirefoxCapabilityError`.
+ */
+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
+ * profile (cookies, logins), so agents never learn a second "space" concept.
+ */
+export interface ArcNativeProfileIdentity {
+    /** Arc's profile directory basename the Space belongs to. Authoritative id. */
+    profileId: string;
+    /** Display-only Arc profile name from Local State. Never used for addressing. */
+    profileName: string;
+    /** Stable Space id used for every native operation. */
+    spaceId: string;
+    /** Display-only Space title. */
+    spaceTitle: string;
+}
+/** A crash-safe native create intent persisted before Arc is asked to mutate. */
+export interface ArcNativeCreateIntent {
+    tabId: string;
+    markerUrl: string;
+    targetUrl: string;
+    createdAt: number;
+    /** Active tab before creation, restored only if the owned tab stayed active. */
+    previousTabId?: string;
+    /** Written immediately after the driver returns, before final navigation. */
+    ref?: ArcNativeTabRef;
+}
+/** Durable Arc state owned by one browser task. */
+export interface ArcNativeTaskState {
+    profileId: string;
+    /** Original Arc window id. A tab moved elsewhere is never adopted. */
+    windowId: string;
+    spaceId: string;
+    /** Display-only snapshot for status output. */
+    spaceTitle: string;
+    tabs: Record<string, ArcNativeTabRef>;
+    createIntents?: Record<string, ArcNativeCreateIntent>;
+}
 /**
  * The user-facing name of a profile — what `agents browser profiles list`
  * prints and what `--profile <name>` takes. ALWAYS bare: it never carries an
@@ -127,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?: {
@@ -139,6 +193,28 @@ export interface BrowserProfile {
     logDir?: string;
     /** Optional SSH host where logDir lives, e.g. "user@remote-host". */
     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 {
@@ -154,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;
@@ -176,11 +256,12 @@ export interface Task {
      * {@link parseConnectionKey} to get the user-facing name out of it.
      */
     profile: ConnectionKey;
+    /** shortId -> CDP target id, or native tab id mirrored from arcNative.tabs. */
     tabs: Record<string, string>;
     /**
      * Tabs this task DRIVES but did not create, by shortId — a tab that already
      * existed in the browser and was reused because the browser cannot open new
-     * ones (Arc: `Target.createTarget` crashes it, #2778/#2786). Every close path
+     * ones (legacy CDP Arc is one example). Every close path
      * skips these: the task never opened the tab, so closing it on `done` would
      * take away something that was there first. Same rule `adoptTabShowing`
      * states for unowned pages, kept when reuse is unavoidable rather than
@@ -235,6 +316,8 @@ export interface Task {
      * it. See RefSnapshot / RefDescriptor.
      */
     refDescriptors?: Record<string, import('./refs.js').RefSnapshot>;
+    /** Durable stable native ids and crash-intent ledger for an Arc task. */
+    arcNative?: ArcNativeTaskState;
 }
 export interface TabInfo {
     id: string;

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[];
@@ -1303,6 +1309,19 @@ export interface BrowserProfileConfig {
     logDir?: string;
     /** Optional SSH host where logDir lives, e.g. "user@remote-host". */
     logHost?: string;
+    /** Stable native identity for an Arc Space profile; display names are never addresses. */
+    arc?: {
+        profileId: string;
+        profileName: string;
+        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.93",
+  "version": "1.22.95",
   "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",