@xopcai/xopc 0.0.251 → 0.0.252

package/dist/src/agent/tools/browser-automation-tool.d.ts

@@ -0,0 +1,121 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { BrowserAutomationService } from '../../browser/automations/index.js';
+declare const BrowserAutomationToolSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"save">, import("@sinclair/typebox").TLiteral<"enable">, import("@sinclair/typebox").TLiteral<"disable">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"run">]>;
+    automationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    definition: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        name: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        allowedDomains: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        risk: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"read">, import("@sinclair/typebox").TLiteral<"draft">, import("@sinclair/typebox").TLiteral<"external_effect">, import("@sinclair/typebox").TLiteral<"destructive">, import("@sinclair/typebox").TLiteral<"sensitive">]>;
+        inputs: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+            type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"string">, import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"boolean">]>;
+            required: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            default: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean]>>;
+            description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            choices: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean]>>>;
+        }>>;
+        steps: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"navigate">;
+            url: import("@sinclair/typebox").TString;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"click">;
+            target: import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"fill">;
+            target: import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>;
+            value: import("@sinclair/typebox").TString;
+            submit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"select">;
+            target: import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>;
+            value: import("@sinclair/typebox").TString;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"press">;
+            target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>>;
+            key: import("@sinclair/typebox").TString;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"scroll">;
+            target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>>;
+            deltaY: import("@sinclair/typebox").TNumber;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                titleIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                textIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                state: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>>;
+            }>>;
+        }>, import("@sinclair/typebox").TObject<{
+            action: import("@sinclair/typebox").TLiteral<"wait">;
+            condition: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"page_idle">, import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"visible">, import("@sinclair/typebox").TLiteral<"hidden">]>;
+            value: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                role: import("@sinclair/typebox").TString;
+                name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                nameIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            }>>;
+            timeoutMs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        }>]>>;
+    }>>;
+    inputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export declare function createBrowserAutomationTool(deps: {
+    getBrowserAutomationService: () => BrowserAutomationService | undefined;
+}): AgentTool<typeof BrowserAutomationToolSchema, Record<string, unknown>>;
+export {};

package/dist/src/agent/tools/browser-automation-tool.js

@@ -0,0 +1,197 @@
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/browser-automation-tool.ts
+const ExpectationSchema = Type.Object({
+	urlIncludes: Type.Optional(Type.String()),
+	titleIncludes: Type.Optional(Type.String()),
+	textIncludes: Type.Optional(Type.String()),
+	ref: Type.Optional(Type.String()),
+	state: Type.Optional(Type.Union([Type.Literal("visible"), Type.Literal("hidden")]))
+}, { additionalProperties: false });
+const TargetSchema = Type.Object({
+	role: Type.String(),
+	name: Type.Optional(Type.String()),
+	nameIncludes: Type.Optional(Type.String())
+}, { additionalProperties: false });
+const StepSchema = Type.Union([
+	Type.Object({
+		action: Type.Literal("navigate"),
+		url: Type.String(),
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("click"),
+		target: TargetSchema,
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("fill"),
+		target: TargetSchema,
+		value: Type.String(),
+		submit: Type.Optional(Type.Boolean()),
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("select"),
+		target: TargetSchema,
+		value: Type.String(),
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("press"),
+		target: Type.Optional(TargetSchema),
+		key: Type.String(),
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("scroll"),
+		target: Type.Optional(TargetSchema),
+		deltaY: Type.Number(),
+		expect: Type.Optional(ExpectationSchema)
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("wait"),
+		condition: Type.Union([
+			Type.Literal("page_idle"),
+			Type.Literal("text"),
+			Type.Literal("visible"),
+			Type.Literal("hidden")
+		]),
+		value: Type.Optional(Type.String()),
+		target: Type.Optional(TargetSchema),
+		timeoutMs: Type.Optional(Type.Integer())
+	}, { additionalProperties: false })
+]);
+const BrowserAutomationToolSchema = Type.Object({
+	action: Type.Union([
+		Type.Literal("list"),
+		Type.Literal("get"),
+		Type.Literal("save"),
+		Type.Literal("enable"),
+		Type.Literal("disable"),
+		Type.Literal("delete"),
+		Type.Literal("run")
+	]),
+	automationId: Type.Optional(Type.String()),
+	definition: Type.Optional(Type.Object({
+		id: Type.String(),
+		name: Type.String(),
+		description: Type.Optional(Type.String()),
+		allowedDomains: Type.Array(Type.String()),
+		risk: Type.Union([
+			Type.Literal("read"),
+			Type.Literal("draft"),
+			Type.Literal("external_effect"),
+			Type.Literal("destructive"),
+			Type.Literal("sensitive")
+		]),
+		inputs: Type.Record(Type.String(), Type.Object({
+			type: Type.Union([
+				Type.Literal("string"),
+				Type.Literal("number"),
+				Type.Literal("boolean")
+			]),
+			required: Type.Optional(Type.Boolean()),
+			default: Type.Optional(Type.Union([
+				Type.String(),
+				Type.Number(),
+				Type.Boolean()
+			])),
+			description: Type.Optional(Type.String()),
+			choices: Type.Optional(Type.Array(Type.Union([
+				Type.String(),
+				Type.Number(),
+				Type.Boolean()
+			])))
+		}, { additionalProperties: false })),
+		steps: Type.Array(StepSchema)
+	}, { additionalProperties: false })),
+	inputs: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
+}, { additionalProperties: false });
+function createBrowserAutomationTool(deps) {
+	return {
+		name: "browser_automation",
+		label: "Browser Automation",
+		description: "Create and run strict JSON browser automations. Saved steps use semantic role/name targets and exact allowed domains; CSS, XPath, JavaScript, cookies, and network access are not supported.",
+		parameters: BrowserAutomationToolSchema,
+		async execute(_toolCallId, params, signal) {
+			const service = deps.getBrowserAutomationService();
+			if (!service) return output("Browser automation is unavailable.", { ok: false });
+			if (params.action === "list") {
+				const automations = service.list();
+				return output(automations.length ? automations.map((item) => `- ${item.id}: ${item.definition.name} (${item.status}, ${item.definition.risk})`).join("\n") : "No browser automations.", {
+					ok: true,
+					automations
+				});
+			}
+			if (params.action === "save") {
+				if (!params.definition) return output("definition is required.", { ok: false });
+				try {
+					const automation = service.save({ definition: params.definition });
+					return output(`Saved browser automation: ${automation.definition.name}`, {
+						ok: true,
+						automation
+					});
+				} catch (error) {
+					return output(`Could not save browser automation: ${message(error)}`, {
+						ok: false,
+						error: message(error)
+					});
+				}
+			}
+			const id = params.automationId?.trim();
+			if (!id) return output("automationId is required.", { ok: false });
+			const current = service.get(id);
+			if (params.action === "get") return current ? output(JSON.stringify(current.definition, null, 2), {
+				ok: true,
+				automation: current
+			}) : output(`Browser automation not found: ${id}`, { ok: false });
+			if (params.action === "enable" || params.action === "disable") {
+				if (!current) return output(`Browser automation not found: ${id}`, { ok: false });
+				const automation = service.save({
+					definition: current.definition,
+					expectedId: id,
+					status: params.action === "enable" ? "enabled" : "disabled"
+				});
+				return output(`${automation.definition.name} is ${automation.status}.`, {
+					ok: true,
+					automation
+				});
+			}
+			if (params.action === "delete") try {
+				const removed = service.remove(id);
+				return output(removed ? `Deleted browser automation: ${id}` : `Browser automation not found: ${id}`, { ok: removed });
+			} catch (error) {
+				return output(`Could not delete browser automation: ${message(error)}`, {
+					ok: false,
+					error: message(error)
+				});
+			}
+			try {
+				const run = await service.runAndWait(id, params.inputs ?? {}, signal);
+				return output(run.status === "succeeded" ? `Browser automation ${id} completed.` : `Browser automation ${id} ${run.status}: ${run.error ?? "No details"}`, {
+					ok: run.status === "succeeded",
+					run
+				});
+			} catch (error) {
+				return output(`Browser automation failed: ${message(error)}`, {
+					ok: false,
+					error: message(error)
+				});
+			}
+		}
+	};
+}
+function output(text, details) {
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		details
+	};
+}
+function message(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+export { createBrowserAutomationTool };

package/dist/src/agent/tools/factory.d.ts

@@ -18,7 +18,7 @@ import type { MemoryManager } from '../memory/manager.js';
 import type { SessionStore } from '../../session/store.js';
 import type { GatewayClarifyRequestFn } from './clarify-tool.js';
 import type { AutomationService } from '../../automations/index.js';
-import type { BrowserRecipeService } from '../../browser/recipes/index.js';
+import type { BrowserAutomationService } from '../../browser/automations/index.js';
 import type { NotesService } from '../../notes/index.js';
 import type { ProjectService } from '../../projects/index.js';
 import type { LocalAppService } from '../../local-apps/index.js';
@@ -54,7 +54,8 @@ export interface ToolFactoryDeps {
     };
     /** Gateway: enables the `automation` tool. */
     getAutomationService?: () => AutomationService | undefined;
-    getBrowserRecipeService?: () => BrowserRecipeService | undefined;
+    getBrowserAutomationService?: () => BrowserAutomationService | undefined;
+    emitBrowserEvent?: (type: string, payload: unknown) => void;
     /** Gateway: enables the `xopc_use` product-object tool. */
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
@@ -98,10 +99,8 @@ export interface CreateCoreToolsOptions {
 }
 export declare class AgentToolsFactory {
     private deps;
-    private browserManager;
-    /** One dialog/console supervisor per chat session (browser tab). */
-    private readonly browserTaskSupervisors;
-    /** Cached readiness probe — keyed by backend mode + extension host:port. */
+    private browserRuntime;
+    /** Cached readiness probe keyed by the active driver configuration. */
     private browserReadinessCache;
     constructor(deps: ToolFactoryDeps);
     private prepareRuntimeEnv;
@@ -109,9 +108,7 @@ export declare class AgentToolsFactory {
     private checkBrowserReadinessCached;
     /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */
     invalidateBrowserReadinessCache(): void;
-    private browserSupervisorForTask;
-    private acquireBrowserPage;
-    private ensureBrowserManager;
+    private ensureBrowserRuntime;
     /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */
     shutdownBrowser(): Promise<void>;
     /** Drop the tab for a session when its agent instance is removed. */

package/dist/src/agent/tools/factory.js

@@ -36,15 +36,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
-import { BrowserManager } from "../../browser/manager.js";
-import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
+import { createBrowserDriver } from "../../browser/drivers/create-driver.js";
 import { checkBrowserReadiness } from "../../browser/readiness.js";
-import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
 import "../../browser/index.js";
 import { createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
-import { createBrowserRecipeTool } from "./browser-recipe-tool.js";
+import { createBrowserAutomationTool } from "./browser-automation-tool.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
@@ -78,10 +77,8 @@ const CLARIFY_SUPPORTED_CHANNELS = new Set([
 	"cli"
 ]);
 var AgentToolsFactory = class AgentToolsFactory {
-	browserManager = null;
-	/** One dialog/console supervisor per chat session (browser tab). */
-	browserTaskSupervisors = /* @__PURE__ */ new Map();
-	/** Cached readiness probe — keyed by backend mode + extension host:port. */
+	browserRuntime = null;
+	/** Cached readiness probe keyed by the active driver configuration. */
 	browserReadinessCache = null;
 	constructor(deps) {
 		this.deps = deps;
@@ -99,13 +96,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		})).env;
 	};
 	browserReadinessKey() {
-		const cfg = this.deps.getConfig?.();
-		const backend = resolveBrowserBackendFromConfig(cfg);
-		const host = "127.0.0.1";
-		const port = 19820;
-		const cdpUrl = backend.mode === "cdp" ? backend.config.wsEndpoint : "";
-		const cloudKind = backend.mode === "cloud" ? backend.config.type : "";
-		return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;
+		return JSON.stringify(this.deps.getConfig?.()?.browser.driver ?? null);
 	}
 	async checkBrowserReadinessCached() {
 		const key = this.browserReadinessKey();
@@ -137,45 +128,33 @@ var AgentToolsFactory = class AgentToolsFactory {
 	invalidateBrowserReadinessCache() {
 		this.browserReadinessCache = null;
 	}
-	browserSupervisorForTask(taskId) {
-		let s = this.browserTaskSupervisors.get(taskId);
-		if (!s) {
-			s = new CdpSupervisor({
-				dialogPolicy: "auto_dismiss",
-				dialogTimeoutSeconds: 300
-			});
-			this.browserTaskSupervisors.set(taskId, s);
-		}
-		return s;
-	}
-	async acquireBrowserPage() {
-		const taskId = this.deps.getCurrentContext()?.sessionKey ?? "default";
-		const mgr = this.ensureBrowserManager();
-		await mgr.ensureConnected();
-		if (mgr.getExtensionProvider()) return null;
-		const page = await mgr.getPage(taskId);
-		this.browserSupervisorForTask(taskId).attach(page);
-		return page;
-	}
-	ensureBrowserManager() {
-		if (!this.browserManager) this.browserManager = new BrowserManager({
-			getHeadless: () => false,
-			getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.())
+	ensureBrowserRuntime() {
+		if (!this.browserRuntime) this.browserRuntime = new BrowserRuntime({
+			getConfig: () => {
+				const config = this.deps.getConfig?.();
+				if (!config) throw new Error("Browser configuration is unavailable");
+				return config.browser;
+			},
+			createDriver: async () => {
+				const config = this.deps.getConfig?.();
+				if (!config) throw new Error("Browser configuration is unavailable");
+				return createBrowserDriver(config.browser);
+			},
+			allowedUploadRoots: [this.deps.workspace],
+			emit: this.deps.emitBrowserEvent
 		});
-		return this.browserManager;
+		return this.browserRuntime;
 	}
 	/** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */
 	async shutdownBrowser() {
 		this.browserReadinessCache = null;
-		if (!this.browserManager) return;
-		await this.browserManager.shutdown();
-		this.browserManager = null;
-		this.browserTaskSupervisors.clear();
+		if (!this.browserRuntime) return;
+		await this.browserRuntime.shutdown();
+		this.browserRuntime = null;
 	}
 	/** Drop the tab for a session when its agent instance is removed. */
 	async closeBrowserPageForSession(sessionKey) {
-		this.browserTaskSupervisors.delete(sessionKey);
-		await this.browserManager?.closePage(sessionKey);
+		await this.browserRuntime?.closeTaskSession(sessionKey);
 	}
 	createCoreTools(options) {
 		const workspace = options?.workspace ?? this.deps.workspace;
@@ -376,7 +355,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 				canAccess: () => currentAccess().crossSessionHistory
 			})] : [],
 			...this.deps.getAutomationService ? [createAutomationTool({ getAutomationService: this.deps.getAutomationService })] : [],
-			...browserEnabled && this.deps.getBrowserRecipeService ? [createBrowserRecipeTool({ getBrowserRecipeService: this.deps.getBrowserRecipeService })] : [],
+			...browserEnabled && this.deps.getBrowserAutomationService ? [createBrowserAutomationTool({ getBrowserAutomationService: this.deps.getBrowserAutomationService })] : [],
 			...this.deps.getAutomationService || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.dispatchTaskEvents || this.deps.dispatchTaskRuns ? [createXopcUseTool({
 				getConfig: () => this.deps.getConfig?.(),
 				getCurrentAgentId: () => options.agentId,
@@ -389,15 +368,9 @@ var AgentToolsFactory = class AgentToolsFactory {
 				dispatchTaskRuns: this.deps.dispatchTaskRuns
 			})] : [],
 			...browserEnabled ? [createBrowserUseTool({
-				getManager: () => this.ensureBrowserManager(),
-				getPageForTask: () => this.acquireBrowserPage(),
+				getRuntime: () => this.ensureBrowserRuntime(),
 				getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? "default",
-				getConfig: () => this.deps.getConfig?.(),
-				getReadiness: () => this.checkBrowserReadinessCached(),
-				getSupervisor: () => this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? "default"),
-				notifyBrowserPageClosed: (taskId) => {
-					this.browserTaskSupervisors.delete(taskId);
-				}
+				getReadiness: () => this.checkBrowserReadinessCached()
 			})] : [],
 			...primary ? [createWorkflowTool({
 				catalog: createWorkflowCatalog(),

package/dist/src/agent/tools/index.d.ts

@@ -23,11 +23,11 @@ export { createUpdatePlanTool, type TurnPlanDetails, type TurnPlanStatus, type T
 export { createSessionStatusTool } from './session-status-tool.js';
 export { createMemoryMaintenanceTool, type MemoryMaintenanceToolDeps } from './memory-maintenance-tool.js';
 export { createClarifyTool, type ClarifyRequestPayload, type GatewayClarifyRequestFn, } from './clarify-tool.js';
-export { BrowserManager, assertBrowserUrlAllowed } from '../../browser/index.js';
+export { BrowserRuntime, assertBrowserUrlAllowed } from '../../browser/index.js';
 export { createDelegateTool, DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, } from './delegate-tool.js';
 export { createWorkflowTool, type WorkflowToolDeps, type WorkflowToolInput } from './workflow-tool.js';
 export { createAutomationTool, type AutomationToolDeps } from './automation-tool.js';
-export { createBrowserRecipeTool } from './browser-recipe-tool.js';
+export { createBrowserAutomationTool } from './browser-automation-tool.js';
 export { createXopcUseTool, type XopcUseToolDeps, type XopcUseToolInput } from './xopc-use-tool.js';
 export { createSkillsListTool, createSkillViewTool, type SkillsToolsDeps } from './skills-tools.js';
 export { createSkillManageTool, type SkillManageToolDeps } from './skill-manage-tool.js';

package/dist/src/agent/tools/index.js

@@ -25,14 +25,14 @@ import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createMemoryMaintenanceTool } from "./memory-maintenance-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
-import { BrowserManager } from "../../browser/manager.js";
 import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
+import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
 import "../../browser/index.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createWorkflowTool } from "./workflow-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
-import { createBrowserRecipeTool } from "./browser-recipe-tool.js";
+import { createBrowserAutomationTool } from "./browser-automation-tool.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
@@ -43,4 +43,4 @@ import { createDesktopPetTool } from "./desktop-pet-tool.js";
 import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextSearchTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextSearchTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/review-workspace.js

@@ -5,7 +5,7 @@ import { lstat, readFile, readlink, realpath } from "node:fs/promises";
 import { promisify } from "node:util";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/review-workspace.ts
-const exec$1 = promisify(execFile);
+const exec = promisify(execFile);
 function createReviewWorkspaceTool(workspace) {
 	return {
 		name: "review_workspace",
@@ -16,7 +16,7 @@ function createReviewWorkspaceTool(workspace) {
 		idempotent: true,
 		async execute(_id, _args, signal) {
 			let cwd = workspace;
-			const git = async (args) => (await exec$1("git", [
+			const git = async (args) => (await exec("git", [
 				"-c",
 				"core.fsmonitor=false",
 				...args

package/dist/src/ai-assist/text-assist.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions } from "../providers/model-call.js";
+import { getAssistantMessageErrorReason, stripCodeFences } from "../providers/model-response.js";
 //#region src/ai-assist/text-assist.ts
 init_providers();
 init_logger();

package/dist/src/auth/credentials.js

@@ -1,10 +1,10 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
-import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { getOAuthProviderDefinition, init_registry } from "./oauth/registry.js";
+import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { init_oauth_provider_lock, withOAuthProviderLock } from "./oauth-provider-lock.js";
 import { dirname, join } from "path";
 import { mkdir, readFile, readdir, rm } from "fs/promises";

package/dist/src/auth/oauth/xopc-cloud.js

@@ -1,4 +1,5 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { init_resolution, resolveConnectedPlatformEndpoint } from "../../platform/resolution.js";
 import { generatePKCE, init_pkce } from "./pkce.js";
 import { hostname } from "node:os";
 import { randomBytes } from "node:crypto";
@@ -6,7 +7,7 @@ import http from "node:http";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 //#region src/auth/oauth/xopc-cloud.ts
 function consoleUrl() {
-	return (process.env.XOPC_CONSOLE_URL ?? DEFAULT_CONSOLE_URL).replace(/\/+$/, "");
+	return (process.env.XOPC_CONSOLE_URL ?? resolveConnectedPlatformEndpoint("authorizationServer") ?? DEFAULT_CONSOLE_URL).replace(/\/+$/, "");
 }
 async function readJson(response) {
 	const body = await response.json().catch(() => null);
@@ -391,6 +392,7 @@ function createXopcOAuthProvider(options) {
 var CLIENT_ID, DEFAULT_CONSOLE_URL, MODEL_SERVICE_SCOPE, TUNNEL_REGISTRATION_SCOPE, HOSTED_SHARE_SCOPE, CALLBACK_PATH, AUTHORIZATION_TIMEOUT_MS, xopcCloudOAuthProvider, xopcTunnelOAuthProvider, xopcShareOAuthProvider;
 var init_xopc_cloud = __esmMin((() => {
 	init_pkce();
+	init_resolution();
 	CLIENT_ID = "xopc-native";
 	DEFAULT_CONSOLE_URL = "https://console.xopc.ai";
 	MODEL_SERVICE_SCOPE = "models:read models:invoke account:usage connectors:read connectors:manage connectors:execute offline_access";

package/dist/src/auth/profiles/store.js

@@ -1,5 +1,5 @@
-import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
 import { init_paths, resolveCredentialsDir } from "../../config/paths.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
 import path from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 //#region src/auth/profiles/store.ts

package/dist/src/auth/sync-provider-auth.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
-import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
+import { init_registry, isOAuthOnlyProvider } from "./oauth/registry.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**