@openacme/browser 0.4.0 → 0.5.0

package/dist/manager.d.ts

@@ -1,52 +1,56 @@
-import type { BrowserConfig, ClickCoordsParams, ClickParams, ConsoleMessagesParams, ConsoleMessagesResult, DialogResult, DragParams, EvaluateParams, EvaluateResult, FileUploadParams, FillFormParams, FillFormResult, HandleDialogParams, HoverParams, NavHistoryResult, NavigateParams, NavigateResult, PdfResult, PressKeyParams, ResizeParams, ResizeResult, SaveAsPdfParams, ScreenshotParams, ScreenshotResult, SelectOptionParams, SelectOptionResult, SnapshotParams, SnapshotResult, TabId, TabInfo, TypeParams, WaitForParams, ActionResult } from "./types.js";
+import type { BrowserProvider } from "./providers/base.js";
+import type { AgentBrowserOverrides } from "./types.js";
+import type { ActionResult, ClickCoordsParams, ClickParams, ConsoleMessagesParams, ConsoleMessagesResult, DialogResult, DragParams, EvaluateParams, EvaluateResult, FileUploadParams, FillFormParams, FillFormResult, HandleDialogParams, HoverParams, NavHistoryResult, NavigateParams, NavigateResult, PdfResult, PressKeyParams, ResizeParams, ResizeResult, SaveAsPdfParams, ScreenshotParams, ScreenshotResult, SelectOptionParams, SelectOptionResult, SnapshotParams, SnapshotResult, TabId, TabInfo, TypeParams, WaitForParams } from "./types.js";
 /**
- * Owns the single managed Chrome process for the OpenAcme workforce.
+ * Per-agent browser orchestrator. Each agent that calls a browser tool
+ * gets its own session — a separate Chrome process for the local provider,
+ * a separate cloud session for Browserbase / Browser-Use / Firecrawl.
+ * Sessions are lazy and acquired on first tool call.
  *
- * One Chrome under `<dataDir>/browser-profile/`; one shared default
- * `BrowserContext` so all agents share cookies / login state. Tabs are
- * partitioned per-agent: each agent gets its own `t1`, `t2`, ... alias
- * space. Cross-agent tab access is refused.
- *
- * Lazy: nothing happens until the first tool call. CDP disconnect on
- * sleep/wake is recovered transparently — `cachedBrowser` is invalidated
- * by the `disconnected` listener and re-established on next call.
+ * Why per-agent: shared cookies cascade bans across the workforce, and
+ * shared fingerprints get the whole org flagged on social-media-style
+ * sites. Each agent is a distinct persona; the runtime should reflect that.
  */
 export declare class BrowserManager {
-    private readonly userDataDir;
-    private readonly cfg;
-    private running;
-    private cachedBrowser;
-    private connectingPromise;
-    private launchingPromise;
-    private tabOwnership;
-    private agentTabs;
-    private activeTabByAgent;
-    private pageState;
+    private readonly provider;
+    private readonly resolveOverrides;
+    private readonly ensureOverrides;
+    private instances;
+    private connecting;
     constructor(opts: {
-        dataDir: string;
-        config: BrowserConfig;
+        provider: BrowserProvider;
+        /** Look up per-agent browser overrides at acquire time. AgentManager
+         *  supplies this with a closure over agentStore. Without it, providers
+         *  fall back to env vars / their own defaults. */
+        resolveOverrides?: (agentId: string) => AgentBrowserOverrides | undefined;
+        /** Lazy-provision a per-agent profile when the agent doesn't have one
+         *  yet for the active provider. Called once per first-acquire when the
+         *  resolved overrides are missing the provider-specific profile field.
+         *  Returns the updated overrides (which AgentManager should also
+         *  persist to the agent store, so the next acquire skips this). */
+        ensureOverrides?: (agentId: string, current: AgentBrowserOverrides | undefined) => Promise<AgentBrowserOverrides | undefined>;
     });
-    private ensureChrome;
-    private getBrowser;
-    private connectFresh;
-    private sharedContext;
-    private resetAllTabState;
+    get providerName(): string;
+    private getInstance;
+    private isInstanceAlive;
+    private connectFor;
+    private contextFor;
+    /** Release one agent's browser session. Idempotent. */
+    closeAgent(agentId: string): Promise<void>;
+    /** Release every agent and shut down the provider. */
     close(): Promise<void>;
     private observePage;
-    private agentTabsFor;
-    private assignTabAlias;
-    private trackPageForAgent;
-    private releaseTab;
-    private targetIdOf;
     /**
-     * Resolve the Page for `tabId` (or the active tab if omitted) and verify
-     * the agent owns it. Throws on missing tab / cross-agent access.
+     * Tab identity is the Page object itself — stable for the page's
+     * lifetime in Playwright. Avoids CDP-specific calls (`newCDPSession`)
+     * so Firefox-based backends (Camoufox) work the same as Chromium.
      */
+    private trackPage;
     private resolvePage;
-    private findPageByTargetId;
     /**
      * Run an action with one-shot reconnect on transient CDP disconnects.
-     * The action gets a fresh `page` resolution on retry.
+     * Drops the agent's instance + cloud session before retrying so we
+     * don't reuse a server-side session that the provider already killed.
      */
     private withReconnect;
     navigate(agentId: string, p: NavigateParams): Promise<NavigateResult>;
@@ -73,10 +77,6 @@ export declare class BrowserManager {
     selectOption(agentId: string, p: SelectOptionParams): Promise<SelectOptionResult>;
     fillForm(agentId: string, p: FillFormParams): Promise<FillFormResult>;
     fileUpload(agentId: string, p: FileUploadParams): Promise<ActionResult>;
-    /**
-     * Arm a one-shot dialog handler on the page. The handler resolves the
-     * NEXT dialog event with accept/dismiss + optional prompt text.
-     */
     handleDialog(agentId: string, p: HandleDialogParams): Promise<DialogResult>;
     resize(agentId: string, p: ResizeParams): Promise<ResizeResult>;
     navigateBack(agentId: string, p: {

package/dist/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"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"}