@xopcai/xopc 0.0.251 → 0.0.253

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

@@ -7,7 +7,7 @@ import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/ses
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
-import { getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
 import { buildRuntimeEnvironment } from "../../runtime-tools/environment.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;
@@ -236,15 +215,25 @@ var AgentToolsFactory = class AgentToolsFactory {
 			createSessionStatusTool(),
 			createMemoryMaintenanceTool({ getConfig: () => this.deps.getConfig?.() }),
 			createToolManualTool(),
-			createClarifyTool({ resolveAskUser: () => {
+			createClarifyTool({ resolveAskUser: (toolCallId) => {
 				const req = this.deps.gatewayClarify?.requestClarification;
 				if (!req) return null;
 				const executionSession = getEmbeddedExecutionSession();
-				if (executionSession) return (r) => req(executionSession, r);
+				const runId = getEmbeddedExecutionRunId();
+				if (executionSession && runId) return (request) => req({
+					sessionKey: executionSession,
+					runId,
+					toolCallId
+				}, request);
 				const ctx = this.deps.getCurrentContext();
 				if (!ctx?.sessionKey) return null;
 				if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) return null;
-				return (r) => req(ctx.sessionKey, r);
+				if (!runId) return null;
+				return (request) => req({
+					sessionKey: ctx.sessionKey,
+					runId,
+					toolCallId
+				}, request);
 			} }),
 			createTodoTool({
 				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
@@ -376,7 +365,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 +378,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
 /**

package/dist/src/automations/domain/defaults.js

@@ -2,7 +2,7 @@
 const DEFAULT_AUTOMATION_TIMEOUT_SECONDS = 1800;
 const DEFAULT_BROWSER_AUTOMATION_TIMEOUT_SECONDS = 600;
 function defaultAutomationTimeoutSeconds(action) {
-	return action.kind === "browser_recipe" ? 600 : DEFAULT_AUTOMATION_TIMEOUT_SECONDS;
+	return action.kind === "browser_automation" ? 600 : DEFAULT_AUTOMATION_TIMEOUT_SECONDS;
 }
 function resolveAutomationTimeoutSeconds(action, reliability) {
 	return reliability?.executionTimeoutSeconds ?? ("timeoutSeconds" in action ? action.timeoutSeconds : void 0) ?? reliability?.timeoutSeconds ?? defaultAutomationTimeoutSeconds(action);

package/dist/src/automations/domain/types.d.ts

@@ -46,9 +46,9 @@ export type AutomationAction = {
     maxSubagents?: number;
     timeoutSeconds?: number;
 } | {
-    kind: 'browser_recipe';
-    recipeId: string;
-    args?: Record<string, unknown>;
+    kind: 'browser_automation';
+    automationId: string;
+    inputs?: Record<string, unknown>;
     timeoutSeconds?: number;
 } | {
     kind: 'task_command';
@@ -189,8 +189,8 @@ export interface AutomationDeps {
     getDefaultAgentId?: () => string;
     prepareAgentSession?: (input: PrepareAutomationAgentSessionInput) => Promise<void>;
     workflowRunService?: WorkflowRunServiceLike;
-    browserRecipeService?: {
-        runAndWait(recipeId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+    browserAutomationService?: {
+        runAndWait(automationId: string, inputs: Record<string, unknown>, signal?: AbortSignal): Promise<{
             id: string;
             status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
             result?: unknown;

package/dist/src/automations/domain/validation.d.ts

@@ -59,9 +59,9 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     maxSubagents: z.ZodOptional<z.ZodNumber>;
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"browser_recipe">;
-    recipeId: z.ZodString;
-    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    kind: z.ZodLiteral<"browser_automation">;
+    automationId: z.ZodString;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"task_command">;
@@ -117,9 +117,9 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         type: z.ZodLiteral<"add_wait">;
         wait: z.ZodObject<{
             kind: z.ZodEnum<{
+                approval: "approval";
                 dependency: "dependency";
                 user_input: "user_input";
-                approval: "approval";
                 external_event: "external_event";
                 scheduled_time: "scheduled_time";
                 retry_backoff: "retry_backoff";
@@ -236,9 +236,9 @@ export declare const AutomationSchema: z.ZodObject<{
         maxSubagents: z.ZodOptional<z.ZodNumber>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"browser_recipe">;
-        recipeId: z.ZodString;
-        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"browser_automation">;
+        automationId: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"task_command">;
@@ -294,9 +294,9 @@ export declare const AutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"add_wait">;
             wait: z.ZodObject<{
                 kind: z.ZodEnum<{
+                    approval: "approval";
                     dependency: "dependency";
                     user_input: "user_input";
-                    approval: "approval";
                     external_event: "external_event";
                     scheduled_time: "scheduled_time";
                     retry_backoff: "retry_backoff";
@@ -398,9 +398,9 @@ export declare const CreateAutomationSchema: z.ZodObject<{
         maxSubagents: z.ZodOptional<z.ZodNumber>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"browser_recipe">;
-        recipeId: z.ZodString;
-        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"browser_automation">;
+        automationId: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"task_command">;
@@ -456,9 +456,9 @@ export declare const CreateAutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"add_wait">;
             wait: z.ZodObject<{
                 kind: z.ZodEnum<{
+                    approval: "approval";
                     dependency: "dependency";
                     user_input: "user_input";
-                    approval: "approval";
                     external_event: "external_event";
                     scheduled_time: "scheduled_time";
                     retry_backoff: "retry_backoff";
@@ -587,9 +587,9 @@ export declare const UpdateAutomationSchema: z.ZodObject<{
         maxSubagents: z.ZodOptional<z.ZodNumber>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"browser_recipe">;
-        recipeId: z.ZodString;
-        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodLiteral<"browser_automation">;
+        automationId: z.ZodString;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"task_command">;
@@ -645,9 +645,9 @@ export declare const UpdateAutomationSchema: z.ZodObject<{
             type: z.ZodLiteral<"add_wait">;
             wait: z.ZodObject<{
                 kind: z.ZodEnum<{
+                    approval: "approval";
                     dependency: "dependency";
                     user_input: "user_input";
-                    approval: "approval";
                     external_event: "external_event";
                     scheduled_time: "scheduled_time";
                     retry_backoff: "retry_backoff";

package/dist/src/automations/domain/validation.js

@@ -83,9 +83,9 @@ const AutomationActionSchema = z.discriminatedUnion("kind", [
 		timeoutSeconds: z.number().int().min(1).max(86400).optional()
 	}).strict(),
 	z.object({
-		kind: z.literal("browser_recipe"),
-		recipeId: nonEmptyString.max(100),
-		args: z.record(z.string(), z.unknown()).optional(),
+		kind: z.literal("browser_automation"),
+		automationId: nonEmptyString.max(100),
+		inputs: z.record(z.string(), z.unknown()).optional(),
 		timeoutSeconds: z.number().int().min(1).max(86400).optional()
 	}).strict(),
 	z.object({

package/dist/src/automations/draft/automation-draft-validator.d.ts

@@ -37,9 +37,9 @@ export declare function buildAutomationDraftResponse(draft: GeneratedAutomationD
             maxSubagents?: number;
             timeoutSeconds?: number;
         } | {
-            kind: "browser_recipe";
-            recipeId: string;
-            args?: Record<string, unknown>;
+            kind: "browser_automation";
+            automationId: string;
+            inputs?: Record<string, unknown>;
             timeoutSeconds?: number;
         } | {
             kind: "task_command";
@@ -79,7 +79,7 @@ export declare function buildAutomationDraftResponse(draft: GeneratedAutomationD
             } | {
                 type: "add_wait";
                 wait: {
-                    kind: "dependency" | "user_input" | "approval" | "external_event" | "scheduled_time" | "retry_backoff" | "paused";
+                    kind: "approval" | "dependency" | "user_input" | "external_event" | "scheduled_time" | "retry_backoff" | "paused";
                     reason: string;
                     condition: Record<string, unknown>;
                     resumeAt?: number;

package/dist/src/automations/draft/automation-draft-validator.js

@@ -90,7 +90,7 @@ function summarizeTrigger(trigger) {
 }
 function summarizeAction(action) {
 	if (action.kind === "workflow") return `Starts workflow ${action.workflowId}.`;
-	if (action.kind === "browser_recipe") return `Runs browser automation ${action.recipeId}.`;
+	if (action.kind === "browser_automation") return `Runs browser automation ${action.automationId}.`;
 	if (action.kind === "task_command") return `Applies ${action.command?.type ?? "a command"} to task ${action.taskId}.`;
 	return action.agentId ? `Runs agent ${action.agentId}.` : "Runs the default agent.";
 }

package/dist/src/automations/service/action-executor.d.ts

@@ -4,7 +4,7 @@ export declare class AutomationActionExecutor {
     setDeps(deps: AutomationDeps): void;
     execute(automation: Automation, run: AutomationRun, signal: AbortSignal, hooks?: AutomationActionExecutionHooks): Promise<AutomationActionTask>;
     private executeWithoutTimeout;
-    private executeBrowserRecipe;
+    private executeBrowserAutomation;
     private executeAgent;
     private executeWorkflow;
 }

package/dist/src/automations/service/action-executor.js

@@ -105,7 +105,7 @@ var AutomationActionExecutor = class {
 			error: "Automation run was cancelled"
 		};
 		if (automation.action.kind === "workflow") return this.executeWorkflow(automation, automation.action, run, signal, hooks);
-		if (automation.action.kind === "browser_recipe") return this.executeBrowserRecipe(automation, automation.action, signal, hooks);
+		if (automation.action.kind === "browser_automation") return this.executeBrowserAutomation(automation, automation.action, signal, hooks);
 		if (automation.action.kind === "task_command") {
 			await hooks.onRunPatch?.({ currentPhase: "action" });
 			const execute = this.deps.executeTaskCommand;
@@ -128,26 +128,26 @@ var AutomationActionExecutor = class {
 		}
 		return this.executeAgent(automation, automation.action, run, signal, hooks, deadlineAtMs);
 	}
-	async executeBrowserRecipe(automation, action, signal, hooks) {
+	async executeBrowserAutomation(automation, action, signal, hooks) {
 		await hooks.onRunPatch?.({ currentPhase: "action" });
 		const safetyMode = automation.safety?.mode ?? "auto_apply";
 		if (safetyMode !== "auto_apply") return {
 			status: "succeeded",
-			summary: `${safetyMode === "suggest_only" ? "Suggest only" : "Ask before applying"}: Browser automation ${action.recipeId} was not run.`
+			summary: `${safetyMode === "suggest_only" ? "Suggest only" : "Ask before applying"}: Browser automation ${action.automationId} was not run.`
 		};
-		const service = this.deps.browserRecipeService;
+		const service = this.deps.browserAutomationService;
 		if (!service) return {
 			status: "failed",
 			error: "Browser automation is not available"
 		};
-		const run = await service.runAndWait(action.recipeId, action.args ?? {}, signal);
+		const run = await service.runAndWait(action.automationId, action.inputs ?? {}, signal);
 		if (run.status === "succeeded") return {
 			status: "succeeded",
-			summary: `Browser automation ${action.recipeId} completed: ${JSON.stringify(run.result ?? null).slice(0, 3500)}`
+			summary: `Browser automation ${action.automationId} completed: ${JSON.stringify(run.result ?? null).slice(0, 3500)}`
 		};
 		return {
 			status: run.status === "cancelled" ? "cancelled" : "failed",
-			error: run.error ?? `Browser automation ${action.recipeId} ${run.status}`
+			error: run.error ?? `Browser automation ${action.automationId} ${run.status}`
 		};
 	}
 	async executeAgent(automation, action, run, signal, hooks, deadlineAtMs) {

package/dist/src/browser/{recipes → automations}/index.d.ts

@@ -1,3 +1,4 @@
 export * from './types.js';
+export * from './schema.js';
 export * from './service.js';
 export * from './runtime-service.js';

package/dist/src/browser/automations/index.js

@@ -0,0 +1,4 @@
+import { BrowserAutomationDefinitionSchema } from "./schema.js";
+import { BrowserAutomationService } from "./service.js";
+import { createRuntimeBrowserAutomationService } from "./runtime-service.js";
+export { BrowserAutomationDefinitionSchema, BrowserAutomationService, createRuntimeBrowserAutomationService };

package/dist/src/browser/automations/repository.d.ts

@@ -0,0 +1,13 @@
+import type { BrowserAutomation, BrowserAutomationRun, BrowserAutomationRunEvent } from './types.js';
+export declare const listBrowserAutomations: () => BrowserAutomation[];
+export declare const getBrowserAutomation: (id: string) => BrowserAutomation | null;
+export declare function saveBrowserAutomation(value: BrowserAutomation): void;
+export declare const deleteBrowserAutomation: (id: string) => boolean;
+export declare function saveBrowserAutomationRun(value: BrowserAutomationRun): void;
+export declare const getBrowserAutomationRun: (id: string) => BrowserAutomationRun | null;
+export declare const listBrowserAutomationRuns: (automationId?: string) => BrowserAutomationRun[];
+export declare const listActiveBrowserAutomationRuns: () => BrowserAutomationRun[];
+export declare const hasActiveBrowserAutomationRuns: (automationId: string) => boolean;
+export declare const nextBrowserAutomationRunEventSeq: (runId: string) => number;
+export declare function appendBrowserAutomationRunEvent(value: BrowserAutomationRunEvent): void;
+export declare const listBrowserAutomationRunEvents: (runId: string) => BrowserAutomationRunEvent[];

package/dist/src/browser/automations/repository.js

@@ -0,0 +1,60 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import "../../storage/sqlite/index.js";
+//#region src/browser/automations/repository.ts
+const AUTOMATION_SELECT = "SELECT automation_id, revision, status, definition_json, created_at_ms, updated_at_ms FROM browser_automations";
+const RUN_SELECT = "SELECT run_id, automation_id, automation_revision, definition_json, status, inputs_json, result_json, error, created_at_ms, started_at_ms, ended_at_ms, duration_ms FROM browser_automation_runs";
+const parseAutomation = (row) => ({
+	id: row.automation_id,
+	revision: row.revision,
+	status: row.status,
+	definition: JSON.parse(row.definition_json),
+	createdAtMs: row.created_at_ms,
+	updatedAtMs: row.updated_at_ms
+});
+const parseRun = (row) => ({
+	id: row.run_id,
+	automationId: row.automation_id,
+	automationRevision: row.automation_revision,
+	definition: JSON.parse(row.definition_json),
+	status: row.status,
+	inputs: JSON.parse(row.inputs_json),
+	result: row.result_json ? JSON.parse(row.result_json) : void 0,
+	error: row.error ?? void 0,
+	createdAtMs: row.created_at_ms,
+	startedAtMs: row.started_at_ms ?? void 0,
+	endedAtMs: row.ended_at_ms ?? void 0,
+	durationMs: row.duration_ms ?? void 0
+});
+const listBrowserAutomations = () => getSqliteDatabase().prepare(`${AUTOMATION_SELECT} ORDER BY updated_at_ms DESC`).all().map(parseAutomation);
+const getBrowserAutomation = (id) => {
+	const row = getSqliteDatabase().prepare(`${AUTOMATION_SELECT} WHERE automation_id = ?`).get(id);
+	return row ? parseAutomation(row) : null;
+};
+function saveBrowserAutomation(value) {
+	runSqliteWriteTransaction((db) => db.prepare("INSERT INTO browser_automations (automation_id, revision, status, definition_json, created_at_ms, updated_at_ms) VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT(automation_id) DO UPDATE SET revision=excluded.revision, status=excluded.status, definition_json=excluded.definition_json, updated_at_ms=excluded.updated_at_ms").run(value.id, value.revision, value.status, JSON.stringify(value.definition), value.createdAtMs, value.updatedAtMs));
+}
+const deleteBrowserAutomation = (id) => runSqliteWriteTransaction((db) => db.prepare("DELETE FROM browser_automations WHERE automation_id = ?").run(id).changes > 0);
+function saveBrowserAutomationRun(value) {
+	runSqliteWriteTransaction((db) => db.prepare("INSERT INTO browser_automation_runs (run_id, automation_id, automation_revision, definition_json, status, inputs_json, result_json, error, created_at_ms, started_at_ms, ended_at_ms, duration_ms) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(run_id) DO UPDATE SET status=excluded.status, result_json=excluded.result_json, error=excluded.error, started_at_ms=excluded.started_at_ms, ended_at_ms=excluded.ended_at_ms, duration_ms=excluded.duration_ms").run(value.id, value.automationId, value.automationRevision, JSON.stringify(value.definition), value.status, JSON.stringify(value.inputs), value.result === void 0 ? null : JSON.stringify(value.result), value.error ?? null, value.createdAtMs, value.startedAtMs ?? null, value.endedAtMs ?? null, value.durationMs ?? null));
+}
+const getBrowserAutomationRun = (id) => {
+	const row = getSqliteDatabase().prepare(`${RUN_SELECT} WHERE run_id = ?`).get(id);
+	return row ? parseRun(row) : null;
+};
+const listBrowserAutomationRuns = (automationId) => (automationId ? getSqliteDatabase().prepare(`${RUN_SELECT} WHERE automation_id = ? ORDER BY created_at_ms DESC`).all(automationId) : getSqliteDatabase().prepare(`${RUN_SELECT} ORDER BY created_at_ms DESC`).all()).map(parseRun);
+const listActiveBrowserAutomationRuns = () => getSqliteDatabase().prepare(`${RUN_SELECT} WHERE status IN ('queued', 'running')`).all().map(parseRun);
+const hasActiveBrowserAutomationRuns = (automationId) => Boolean(getSqliteDatabase().prepare("SELECT 1 FROM browser_automation_runs WHERE automation_id = ? AND status IN ('queued', 'running') LIMIT 1").get(automationId));
+const nextBrowserAutomationRunEventSeq = (runId) => getSqliteDatabase().prepare("SELECT COALESCE(MAX(seq), 0) + 1 AS seq FROM browser_action_audit WHERE run_id = ?").get(runId).seq;
+function appendBrowserAutomationRunEvent(value) {
+	runSqliteWriteTransaction((db) => db.prepare("INSERT INTO browser_action_audit (event_id, run_id, seq, type, data_json, created_at_ms) VALUES (?, ?, ?, ?, ?, ?)").run(value.id, value.runId, value.seq, value.type, value.data === void 0 ? null : JSON.stringify(value.data), value.createdAtMs));
+}
+const listBrowserAutomationRunEvents = (runId) => getSqliteDatabase().prepare("SELECT event_id, run_id, seq, type, data_json, created_at_ms FROM browser_action_audit WHERE run_id = ? ORDER BY seq").all(runId).map((row) => ({
+	id: row.event_id,
+	runId: row.run_id,
+	seq: row.seq,
+	type: row.type,
+	data: row.data_json ? JSON.parse(row.data_json) : void 0,
+	createdAtMs: row.created_at_ms
+}));
+//#endregion
+export { appendBrowserAutomationRunEvent, deleteBrowserAutomation, getBrowserAutomation, getBrowserAutomationRun, hasActiveBrowserAutomationRuns, listActiveBrowserAutomationRuns, listBrowserAutomationRunEvents, listBrowserAutomationRuns, listBrowserAutomations, nextBrowserAutomationRunEventSeq, saveBrowserAutomation, saveBrowserAutomationRun };