@xopcai/xopc 0.0.250 → 0.0.252

package/dist/src/agent/tools/browser/tool/schemas.js

@@ -1,21 +1,151 @@
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/browser/tool/schemas.ts
-/**
-* BrowserUseSchema — Typebox schema for the unified `browser_use` AgentTool.
-*/
-const BrowserUseOptionsSchema = Type.Object({
-	timeout: Type.Optional(Type.Number({ description: "Action timeout override (ms)." })),
-	headless: Type.Optional(Type.Boolean({ description: "Override headless mode for this call." }))
-});
-const BrowserUseSchema = Type.Object({
-	mode: Type.Union([
-		Type.Literal("command"),
-		Type.Literal("inspect"),
+const ApprovalId = Type.Optional(Type.String({ description: "One-time local-owner approval id for this exact action." }));
+const SessionId = Type.Optional(Type.String({ description: "Browser session id returned by the previous observation." }));
+const Revision = Type.Number({ description: "Observation revision used to resolve element refs." });
+const Ref = Type.String({ description: "Ephemeral element ref from the latest observation." });
+const Expectation = Type.Optional(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 }));
+function action(name, properties) {
+	return Type.Object({
+		action: Type.Literal(name),
+		sessionId: SessionId,
+		approvalId: ApprovalId,
+		...properties
+	}, { additionalProperties: false });
+}
+const Observe = action("observe", { visual: Type.Optional(Type.Union([
+	Type.Literal("never"),
+	Type.Literal("auto"),
+	Type.Literal("always")
+])) });
+const Navigate = action("navigate", {
+	url: Type.String({ minLength: 1 }),
+	expect: Expectation
+});
+const Click = action("click", {
+	revision: Revision,
+	ref: Ref,
+	expect: Expectation
+});
+const Fill = action("fill", {
+	revision: Revision,
+	ref: Ref,
+	value: Type.String(),
+	submit: Type.Optional(Type.Boolean()),
+	expect: Expectation
+});
+const Select = action("select", {
+	revision: Revision,
+	ref: Ref,
+	value: Type.String(),
+	expect: Expectation
+});
+const Press = action("press", {
+	revision: Revision,
+	ref: Type.Optional(Ref),
+	key: Type.String({ minLength: 1 }),
+	expect: Expectation
+});
+const Scroll = action("scroll", {
+	revision: Revision,
+	ref: Type.Optional(Ref),
+	deltaY: Type.Number(),
+	expect: Expectation
+});
+const Wait = action("wait", {
+	revision: Revision,
+	condition: Type.Union([
+		Type.Literal("page_idle"),
+		Type.Literal("text"),
+		Type.Literal("visible"),
+		Type.Literal("hidden")
+	]),
+	value: Type.Optional(Type.String()),
+	ref: Type.Optional(Ref),
+	timeoutMs: Type.Optional(Type.Number({
+		minimum: 100,
+		maximum: 12e4
+	}))
+});
+const Upload = action("upload", {
+	revision: Revision,
+	ref: Ref,
+	paths: Type.Array(Type.String({ minLength: 1 }), {
+		minItems: 1,
+		maxItems: 20
+	}),
+	expect: Expectation
+});
+const Tabs = action("tabs", {
+	operation: Type.Union([
+		Type.Literal("list"),
+		Type.Literal("create"),
+		Type.Literal("activate"),
 		Type.Literal("close")
-	], { description: "Execution mode." }),
-	command: Type.Optional(Type.String({ description: "Browser action name (command mode). E.g. open, click, type, screenshot." })),
-	args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Action arguments (command mode)." })),
-	options: Type.Optional(BrowserUseOptionsSchema)
+	]),
+	tabId: Type.Optional(Type.String()),
+	url: Type.Optional(Type.String())
+});
+const SequenceStep = Type.Union([
+	Type.Object({
+		action: Type.Literal("click"),
+		ref: Ref,
+		expect: Expectation
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("fill"),
+		ref: Ref,
+		value: Type.String(),
+		submit: Type.Optional(Type.Boolean()),
+		expect: Expectation
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("select"),
+		ref: Ref,
+		value: Type.String(),
+		expect: Expectation
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("press"),
+		ref: Type.Optional(Ref),
+		key: Type.String(),
+		expect: Expectation
+	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("scroll"),
+		ref: Type.Optional(Ref),
+		deltaY: Type.Number(),
+		expect: Expectation
+	}, { additionalProperties: false })
+]);
+const Sequence = action("sequence", {
+	revision: Revision,
+	steps: Type.Array(SequenceStep, {
+		minItems: 1,
+		maxItems: 10
+	}),
+	expect: Expectation
 });
+const Close = action("close", {});
+const BrowserUseSchema = Type.Union([
+	Observe,
+	Navigate,
+	Click,
+	Fill,
+	Select,
+	Press,
+	Scroll,
+	Wait,
+	Upload,
+	Tabs,
+	Sequence,
+	Close
+]);
 //#endregion
-export { BrowserUseOptionsSchema, BrowserUseSchema };
+export { BrowserUseSchema };

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. */