@phnx-labs/agents-cli 1.22.94 → 1.22.96

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

@@ -1,10 +1,11 @@
 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 } from './types.js';
+import type { TargetFilter, PageOpenResult, ArcNativeProfileIdentity, FirefoxProfileIdentity } from './types.js';
+import { FirefoxBiDiClient } from './drivers/firefox.js';
 export type UploadMode = 'auto' | 'input' | 'drop' | 'chooser';
 export declare function resolveScreenshotOutputPath(outputPath: string | undefined, automaticPath: string): string;
 /**
@@ -95,7 +96,22 @@ interface ArcProfileConnection extends BaseProfileConnection {
     browserType: 'arc';
     arcProfile: ArcNativeProfileIdentity;
 }
-type ProfileConnection = CdpProfileConnection | ArcProfileConnection;
+/**
+ * A Firefox connection driven over WebDriver BiDi (PHNX-4043). No CDP socket:
+ * `bidi` is the live BiDi client, and `firefoxProfile` is the discovered
+ * profile identity. Task tab ids map to BiDi browsing-context ids.
+ */
+interface FirefoxProfileConnection extends BaseProfileConnection {
+    backend: 'bidi';
+    browserType: 'firefox';
+    bidi: FirefoxBiDiClient;
+    firefoxProfile: FirefoxProfileIdentity;
+    /** The BiDi session id from `session.new`. */
+    sessionId: string;
+    /** Absolute Firefox profile directory this connection is bound to. */
+    profileDir: string;
+}
+type ProfileConnection = CdpProfileConnection | ArcProfileConnection | FirefoxProfileConnection;
 /** Join error lines so callers get a next command, not a dead-end message. */
 export declare function actionable(...lines: string[]): string;
 /**
@@ -364,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;
@@ -714,6 +738,39 @@ export declare class BrowserService {
      * the original window and Space.
      */
     private closeArcNativeTabs;
+    /** The BiDi browsing-context id a task owns for `shortId`. */
+    private firefoxContext;
+    /** The context ids currently live in this Firefox (a killed tab drops out). */
+    private firefoxLiveContexts;
+    /**
+     * Same-task reopen for Firefox (mirrors {@link reopenOwnedTab}): the URL is
+     * already live in one of this task's own tabs → reload THAT tab in place and
+     * keep its id, rather than opening a duplicate. Borrowed tabs are excluded —
+     * Firefox never borrows, but the guard keeps parity. Returns the retained
+     * short id, or undefined when nothing matches.
+     */
+    private reopenOwnedFirefoxTab;
+    private navigateFirefox;
+    private evaluateFirefox;
+    private listFirefoxTaskTabs;
+    /**
+     * Close every non-borrowed tab a Firefox task owns. Never kills the Firefox
+     * process (that is `stopProfile`'s job) — a killed browser would take the
+     * user's other tabs with it. A tab already gone is skipped.
+     */
+    private closeFirefoxTabs;
+    /**
+     * Viewport-center coordinates of a selector-addressed element in a Firefox
+     * tab, scrolled into view first — the (x, y) `input.performActions` clicks.
+     * Throws when the element is gone or has zero size (off-screen / display:none).
+     */
+    private firefoxRefCoords;
+    /**
+     * Screenshot a Firefox tab over BiDi. Same output contract as the CDP path:
+     * `raw` is a pixel-faithful PNG; the default is JPEG iteratively downscaled
+     * under 100 KB so chat-injected screenshots stay token-cheap.
+     */
+    private screenshotFirefox;
     /** Connect a profile at `target`, register it under `key`, and arm downloads. */
     private openConnection;
     /**