@phnx-labs/agents-cli 1.22.93 → 1.22.95

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

@@ -4,7 +4,8 @@ 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 ReapOptions } from './hygiene.js';
 import { type RefOpts, type RefNode } from './refs.js';
-import type { TargetFilter, PageOpenResult } 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;
 /**
@@ -46,8 +47,7 @@ export declare function pickWindowTarget<T extends {
 export declare function parseSinceUntil(s: string): Date;
 export declare function readNewestMatchingRemoteFileCommand(dir: string, prefix: string, tailLines: number): string;
 export declare function readNewestMatchingFile(dir: string, prefix: string, tailLines: number): string;
-interface ProfileConnection {
-    cdp: CDPClient;
+interface BaseProfileConnection {
     port: number;
     pid: number;
     electron?: boolean;
@@ -86,6 +86,32 @@ interface ProfileConnection {
      */
     cleanup?: () => void;
 }
+interface CdpProfileConnection extends BaseProfileConnection {
+    /** Omitted only by legacy/in-process callers; absence means the CDP path. */
+    backend?: 'cdp';
+    cdp: CDPClient;
+}
+interface ArcProfileConnection extends BaseProfileConnection {
+    backend: 'arc-native';
+    browserType: 'arc';
+    arcProfile: ArcNativeProfileIdentity;
+}
+/**
+ * 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;
 /**
@@ -178,6 +204,8 @@ export interface StartResult {
      */
     firstOpen?: PageOpenResult;
 }
+export declare function arcCreateMarker(): string;
+export declare function isArcCreateMarker(url: string): boolean;
 export declare class BrowserService {
     private static readonly SOURCE_PREFIX;
     /**
@@ -613,6 +641,7 @@ export declare class BrowserService {
      * a minute, well inside the 30-minute idle window.
      */
     private touchTask;
+    private prepareTask;
     private findTask;
     /**
      * Soft-attach to an already-running browser for a runtime dir.
@@ -680,6 +709,60 @@ export declare class BrowserService {
      * browser started before the key collapse is not abandoned.
      */
     private reuseProfileConnection;
+    /**
+     * Bind a task to the profile's Space in the visible Arc window that holds it.
+     * The Space is the profile (PHNX-2399); only its live window id is looked up.
+     */
+    private resolveArcSpace;
+    private requireArcTask;
+    private reconcileArcCreateIntents;
+    private createArcOwnedTab;
+    private navigateArcNative;
+    /**
+     * Execute JavaScript in a native Arc tab. Sync JS only, isolated world —
+     * async/promise evaluation fails honestly with an AppleScript error.
+     */
+    private evaluateArcNative;
+    private listArcTaskTabs;
+    /**
+     * Close native Arc tabs owned by a task. Only closes tabs the task created
+     * (not borrowed ones). Never kills Arc. Identifies tabs only by stable ids in
+     * 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;
     /**