@xopcai/xopc 0.0.368 → 0.0.369

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

@@ -1,7 +1,7 @@
 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">]>;
+    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">, import("@sinclair/typebox").TLiteral<"test">, import("@sinclair/typebox").TLiteral<"validate">]>;
     automationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     definition: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         id: import("@sinclair/typebox").TString;
@@ -32,6 +32,11 @@ declare const BrowserAutomationToolSchema: 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>;
             expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
                 urlIncludes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -46,6 +51,11 @@ declare const BrowserAutomationToolSchema: 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>;
             value: import("@sinclair/typebox").TString;
             submit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
@@ -56,12 +66,30 @@ declare const BrowserAutomationToolSchema: import("@sinclair/typebox").TObject<{
                 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<"check">;
+            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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
+            }>;
+            checked: import("@sinclair/typebox").TBoolean;
         }>, 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>;
             value: import("@sinclair/typebox").TString;
             expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
@@ -77,6 +105,11 @@ declare const BrowserAutomationToolSchema: 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>>;
             key: import("@sinclair/typebox").TString;
             expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
@@ -92,6 +125,11 @@ declare const BrowserAutomationToolSchema: 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>>;
             deltaY: import("@sinclair/typebox").TNumber;
             expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
@@ -109,11 +147,46 @@ declare const BrowserAutomationToolSchema: 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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
             }>>;
             timeoutMs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
         }>]>>;
+        successCriteria: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
+            }>>;
+            field: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>;
+            equals: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TBoolean]>>;
+            includes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>>>;
+        outputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+            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>;
+                testId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+                scope: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    role: import("@sinclair/typebox").TString;
+                    name: import("@sinclair/typebox").TString;
+                }>>;
+            }>>;
+            field: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>;
+        }>>>;
     }>>;
     inputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    revision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    expectedRevision: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
 }>;
 export declare function createBrowserAutomationTool(deps: {
     getBrowserAutomationService: () => BrowserAutomationService | undefined;

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

@@ -10,7 +10,12 @@ const ExpectationSchema = Type.Object({
 const TargetSchema = Type.Object({
 	role: Type.String(),
 	name: Type.Optional(Type.String()),
-	nameIncludes: Type.Optional(Type.String())
+	nameIncludes: Type.Optional(Type.String()),
+	testId: Type.Optional(Type.String()),
+	scope: Type.Optional(Type.Object({
+		role: Type.String(),
+		name: Type.String()
+	}, { additionalProperties: false }))
 }, { additionalProperties: false });
 const StepSchema = Type.Union([
 	Type.Object({
@@ -30,6 +35,11 @@ const StepSchema = Type.Union([
 		submit: Type.Optional(Type.Boolean()),
 		expect: Type.Optional(ExpectationSchema)
 	}, { additionalProperties: false }),
+	Type.Object({
+		action: Type.Literal("check"),
+		target: TargetSchema,
+		checked: Type.Boolean()
+	}, { additionalProperties: false }),
 	Type.Object({
 		action: Type.Literal("select"),
 		target: TargetSchema,
@@ -69,7 +79,9 @@ const BrowserAutomationToolSchema = Type.Object({
 		Type.Literal("enable"),
 		Type.Literal("disable"),
 		Type.Literal("delete"),
-		Type.Literal("run")
+		Type.Literal("run"),
+		Type.Literal("test"),
+		Type.Literal("validate")
 	]),
 	automationId: Type.Optional(Type.String()),
 	definition: Type.Optional(Type.Object({
@@ -103,9 +115,33 @@ const BrowserAutomationToolSchema = Type.Object({
 				Type.Boolean()
 			])))
 		}, { additionalProperties: false })),
-		steps: Type.Array(StepSchema)
+		steps: Type.Array(StepSchema),
+		successCriteria: Type.Optional(Type.Array(Type.Object({
+			target: Type.Optional(TargetSchema),
+			field: Type.Union([
+				"text",
+				"value",
+				"url",
+				"title",
+				"checked"
+			].map((field) => Type.Literal(field))),
+			equals: Type.Optional(Type.Union([Type.String(), Type.Boolean()])),
+			includes: Type.Optional(Type.String())
+		}, { additionalProperties: false }))),
+		outputs: Type.Optional(Type.Record(Type.String(), Type.Object({
+			target: Type.Optional(TargetSchema),
+			field: Type.Union([
+				"text",
+				"value",
+				"url",
+				"title",
+				"href"
+			].map((field) => Type.Literal(field)))
+		}, { additionalProperties: false })))
 	}, { additionalProperties: false })),
-	inputs: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
+	inputs: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+	revision: Type.Optional(Type.Integer({ minimum: 1 })),
+	expectedRevision: Type.Optional(Type.Integer({ minimum: 1 }))
 }, { additionalProperties: false });
 function createBrowserAutomationTool(deps) {
 	return {
@@ -123,10 +159,17 @@ function createBrowserAutomationTool(deps) {
 					automations
 				});
 			}
+			if (params.action === "validate") {
+				const parsed = service.validate(params.definition);
+				return output(parsed.success ? "Definition is valid; it has not been executed." : JSON.stringify(parsed.error.issues), { ok: parsed.success });
+			}
 			if (params.action === "save") {
 				if (!params.definition) return output("definition is required.", { ok: false });
 				try {
-					const automation = service.save({ definition: params.definition });
+					const automation = service.save({
+						definition: params.definition,
+						expectedRevision: params.expectedRevision
+					});
 					return output(`Saved browser automation: ${automation.definition.name}`, {
 						ok: true,
 						automation
@@ -167,7 +210,10 @@ function createBrowserAutomationTool(deps) {
 				});
 			}
 			try {
-				const run = await service.runAndWait(id, params.inputs ?? {}, signal);
+				const run = await service.runAndWait(id, params.inputs ?? {}, signal, {
+					revision: params.revision,
+					clientRequestId: _toolCallId
+				});
 				return output(run.status === "succeeded" ? `Browser automation ${id} completed.` : `Browser automation ${id} ${run.status}: ${run.error ?? "No details"}`, {
 					ok: run.status === "succeeded",
 					run

package/dist/src/automations/capabilities/write.d.ts

@@ -31,6 +31,7 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser_automation">;
         automationId: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
         inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
@@ -231,6 +232,7 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser_automation">;
         automationId: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
         inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{

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

@@ -48,6 +48,7 @@ export type AutomationAction = {
 } | {
     kind: 'browser_automation';
     automationId: string;
+    revision?: number;
     inputs?: Record<string, unknown>;
     timeoutSeconds?: number;
 } | {
@@ -342,8 +343,18 @@ export interface AutomationDeps {
     prepareAgentSession?: (input: PrepareAutomationAgentSessionInput) => Promise<void>;
     workflowRunService?: WorkflowRunServiceLike;
     browserAutomationService?: {
+        get(id: string): {
+            revision: number;
+            verified: boolean;
+        } | null;
+        versions(id: string): {
+            revision: number;
+            verified: boolean;
+        }[];
         runAndWait(automationId: string, inputs: Record<string, unknown>, signal?: AbortSignal, context?: {
             triggerEvent?: AutomationEvent;
+            revision?: number;
+            clientRequestId?: string;
         }): Promise<{
             id: string;
             status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';

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

@@ -61,6 +61,7 @@ export declare const AutomationActionSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"browser_automation">;
     automationId: z.ZodString;
+    revision: z.ZodOptional<z.ZodNumber>;
     inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>, z.ZodObject<{
@@ -281,6 +282,7 @@ export declare const AutomationSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser_automation">;
         automationId: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
         inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
@@ -480,6 +482,7 @@ export declare const CreateAutomationSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser_automation">;
         automationId: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
         inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
@@ -706,6 +709,7 @@ export declare const UpdateAutomationSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser_automation">;
         automationId: z.ZodString;
+        revision: z.ZodOptional<z.ZodNumber>;
         inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{

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

@@ -95,6 +95,7 @@ const AutomationActionSchema = z.discriminatedUnion("kind", [
 	z.object({
 		kind: z.literal("browser_automation"),
 		automationId: nonEmptyString.max(100),
+		revision: z.number().int().positive().optional(),
 		inputs: z.record(z.string(), z.unknown()).optional(),
 		timeoutSeconds: z.number().int().min(1).max(86400).optional()
 	}).strict(),

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

@@ -60,6 +60,7 @@ export declare function buildAutomationDraftResponse(draft: GeneratedAutomationD
         } | {
             kind: "browser_automation";
             automationId: string;
+            revision?: number;
             inputs?: Record<string, unknown>;
             timeoutSeconds?: number;
         } | {

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

@@ -77,7 +77,7 @@ var AutomationActionExecutor = class {
 			mode: "idempotent",
 			key: "run_id"
 		}, (input, action) => this.executeWorkflow(input.automation, action, input.run, input.signal, input.hooks, input.context));
-		this.register("browser_automation", { mode: "never" }, (input, action) => this.executeBrowserAutomation(input.automation, action, input.signal, input.hooks, input.context));
+		this.register("browser_automation", { mode: "never" }, (input, action) => this.executeBrowserAutomation(input.automation, action, input.signal, input.hooks, input.context, input.run.id));
 		this.register("task_command", {
 			mode: "idempotent",
 			key: "run_id"
@@ -186,7 +186,7 @@ var AutomationActionExecutor = class {
 			})).summary ?? "System action completed"
 		};
 	}
-	async executeBrowserAutomation(automation, action, signal, hooks, context) {
+	async executeBrowserAutomation(automation, action, signal, hooks, context, executionRunId) {
 		await hooks.onRunPatch?.({ currentPhase: "action" });
 		const safetyMode = automation.safety?.mode ?? "auto_apply";
 		if (safetyMode !== "auto_apply") return {
@@ -198,7 +198,15 @@ var AutomationActionExecutor = class {
 			status: "failed",
 			error: "Browser automation is not available"
 		};
-		const run = context.triggerEvent ? await service.runAndWait(action.automationId, action.inputs ?? {}, signal, { triggerEvent: context.triggerEvent }) : await service.runAndWait(action.automationId, action.inputs ?? {}, signal);
+		if (action.revision === void 0 || !service.versions(action.automationId).some((item) => item.revision === action.revision && item.verified)) return {
+			status: "failed",
+			error: "The scheduled browser automation version has not been verified."
+		};
+		const run = await service.runAndWait(action.automationId, action.inputs ?? {}, signal, {
+			revision: action.revision,
+			clientRequestId: `schedule:${executionRunId}:${action.revision}`,
+			...context.triggerEvent ? { triggerEvent: context.triggerEvent } : {}
+		});
 		if (run.status === "succeeded") return {
 			status: "succeeded",
 			summary: `Browser automation ${action.automationId} completed: ${JSON.stringify(run.result ?? null).slice(0, 3500)}`

package/dist/src/automations/service/automation-service.d.ts

@@ -31,6 +31,7 @@ export declare class AutomationService {
     /** SQLite-only creation; scheduling starts after the caller commits. */
     createAtomically(input: CreateAutomationInput): Automation;
     private applyCreate;
+    private pinBrowserVersion;
     list(options?: {
         projectId?: string;
     }): Promise<Automation[]>;

package/dist/src/automations/service/automation-service.js

@@ -114,12 +114,23 @@ var AutomationService = class {
 			createdAtMs: now,
 			updatedAtMs: now
 		});
+		this.pinBrowserVersion(automation);
 		if (getAutomation(automation.id)) throw new AutomationAlreadyExistsError(automation.id);
 		automation.updatedAtMs = Math.max(automation.updatedAtMs, (getDeletedAutomationRevision(automation.id) ?? -1) + 1);
 		automation.state.nextRunAtMs = computeNextAutomationRunAtMs(automation, now);
 		saveAutomation(automation);
 		return automation;
 	}
+	pinBrowserVersion(automation) {
+		if (automation.action.kind !== "browser_automation") return;
+		const browser = this.deps.browserAutomationService;
+		if (!browser) throw new Error("Browser automation service is unavailable.");
+		const action = automation.action;
+		const version = action.revision === void 0 ? browser.get(action.automationId) : browser.versions(action.automationId).find((item) => item.revision === action.revision);
+		if (!version) throw new Error("Browser automation version not found.");
+		if (automation.enabled && !version.verified) throw new Error("Run and verify this browser automation before scheduling it.");
+		action.revision = version.revision;
+	}
 	async list(options) {
 		return listAutomations(options);
 	}
@@ -154,6 +165,7 @@ var AutomationService = class {
 				...parsed.state ?? {}
 			}
 		});
+		this.pinBrowserVersion(next);
 		if ("enabled" in parsed || "trigger" in parsed) next.state.nextRunAtMs = computeNextAutomationRunAtMs(next, now);
 		saveAutomation(next);
 		return next;
@@ -559,7 +571,7 @@ var AutomationService = class {
 		let artifacts;
 		const triggerEvent = listAutomationRunEvents(run.id).map(readAutomationEventFromRunEvent).find((item) => item !== null);
 		try {
-			const maxAttempts = Math.max(1, (automation.reliability?.retryCount ?? 0) + 1);
+			const maxAttempts = automation.action.kind === "browser_automation" ? 1 : Math.max(1, (automation.reliability?.retryCount ?? 0) + 1);
 			let task;
 			for (let attempt = 1;; attempt += 1) {
 				run = {

package/dist/src/bootstrap/application-state.js

@@ -2,9 +2,9 @@ import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
 import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";
-import { migrateIdentityMarkdownToCatalog } from "../agent-catalog/migrations/identity-markdown-cutover.js";
 import { cutoverLegacyAgentConfig } from "../agent-catalog/migrations/legacy-config-cutover.js";
 import "../agent-catalog/index.js";
+import { migrateIdentityMarkdownToCatalog } from "../agent-catalog/migrations/identity-markdown-cutover.js";
 import { migrateCloudPublicModelsSync } from "../migrations/cloud-public-models.js";
 import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 //#region src/bootstrap/application-state.ts

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

@@ -2,6 +2,10 @@ import type { BrowserAutomation, BrowserAutomationRun, BrowserAutomationRunEvent
 export declare const listBrowserAutomations: () => BrowserAutomation[];
 export declare const getBrowserAutomation: (id: string) => BrowserAutomation | null;
 export declare function saveBrowserAutomation(value: BrowserAutomation): void;
+export declare function getBrowserAutomationVersion(id: string, revision: number): BrowserAutomation | null;
+export declare function listBrowserAutomationVersions(id: string): BrowserAutomation[];
+export declare function verifyBrowserAutomationRun(run: BrowserAutomationRun): void;
+export declare function findBrowserAutomationRunByRequest(requestId: string): BrowserAutomationRun | null;
 export declare const deleteBrowserAutomation: (id: string) => boolean;
 export declare function saveBrowserAutomationRun(value: BrowserAutomationRun): void;
 export declare const getBrowserAutomationRun: (id: string) => BrowserAutomationRun | null;

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

@@ -2,9 +2,10 @@ import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqli
 import { init_sqlite } from "../../storage/sqlite/index.js";
 //#region src/browser/automations/repository.ts
 init_sqlite();
-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 AUTOMATION_SELECT = "SELECT a.*, EXISTS(SELECT 1 FROM browser_automation_verifications v WHERE v.automation_id=a.automation_id AND v.revision=a.revision) AS verified FROM browser_automations a";
+const RUN_SELECT = "SELECT client_request_id, business_outcome, 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) => ({
+	verified: !!row.verified,
 	id: row.automation_id,
 	revision: row.revision,
 	status: row.status,
@@ -13,6 +14,8 @@ const parseAutomation = (row) => ({
 	updatedAtMs: row.updated_at_ms
 });
 const parseRun = (row) => ({
+	clientRequestId: row.client_request_id ?? void 0,
+	businessOutcome: row.business_outcome ?? void 0,
 	id: row.run_id,
 	automationId: row.automation_id,
 	automationRevision: row.automation_revision,
@@ -28,15 +31,33 @@ const parseRun = (row) => ({
 });
 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);
+	const row = getSqliteDatabase().prepare(`${AUTOMATION_SELECT} WHERE a.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));
+	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);
+		db.prepare("INSERT OR IGNORE INTO browser_automation_versions (automation_id, revision, definition_json, created_at_ms) VALUES (?, ?, ?, ?)").run(value.id, value.revision, JSON.stringify(value.definition), value.updatedAtMs);
+	});
+}
+function getBrowserAutomationVersion(id, revision) {
+	const row = getSqliteDatabase().prepare("SELECT v.*, a.status, a.created_at_ms, v.created_at_ms AS updated_at_ms, EXISTS(SELECT 1 FROM browser_automation_verifications p WHERE p.automation_id=v.automation_id AND p.revision=v.revision) AS verified FROM browser_automation_versions v JOIN browser_automations a USING(automation_id) WHERE v.automation_id=? AND v.revision=?").get(id, revision);
+	return row ? parseAutomation(row) : null;
+}
+function listBrowserAutomationVersions(id) {
+	return getSqliteDatabase().prepare("SELECT revision FROM browser_automation_versions WHERE automation_id=? ORDER BY revision DESC").all(id).map((row) => getBrowserAutomationVersion(id, row.revision));
+}
+function verifyBrowserAutomationRun(run) {
+	if (run.status !== "succeeded" || run.businessOutcome !== "verified") return;
+	runSqliteWriteTransaction((db) => db.prepare("INSERT INTO browser_automation_verifications (automation_id, revision, run_id, verified_at_ms) VALUES (?, ?, ?, ?) ON CONFLICT(automation_id, revision) DO UPDATE SET run_id=excluded.run_id, verified_at_ms=excluded.verified_at_ms").run(run.automationId, run.automationRevision, run.id, run.endedAtMs));
+}
+function findBrowserAutomationRunByRequest(requestId) {
+	const row = getSqliteDatabase().prepare(`${RUN_SELECT} WHERE client_request_id=?`).get(requestId);
+	return row ? parseRun(row) : null;
 }
 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));
+	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, client_request_id, business_outcome) 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, business_outcome=excluded.business_outcome").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, value.clientRequestId ?? null, value.businessOutcome ?? null));
 }
 const getBrowserAutomationRun = (id) => {
 	const row = getSqliteDatabase().prepare(`${RUN_SELECT} WHERE run_id = ?`).get(id);
@@ -58,4 +79,4 @@ const listBrowserAutomationRunEvents = (runId) => getSqliteDatabase().prepare("S
 	createdAtMs: row.created_at_ms
 }));
 //#endregion
-export { appendBrowserAutomationRunEvent, deleteBrowserAutomation, getBrowserAutomation, getBrowserAutomationRun, hasActiveBrowserAutomationRuns, listActiveBrowserAutomationRuns, listBrowserAutomationRunEvents, listBrowserAutomationRuns, listBrowserAutomations, nextBrowserAutomationRunEventSeq, saveBrowserAutomation, saveBrowserAutomationRun };
+export { appendBrowserAutomationRunEvent, deleteBrowserAutomation, findBrowserAutomationRunByRequest, getBrowserAutomation, getBrowserAutomationRun, getBrowserAutomationVersion, hasActiveBrowserAutomationRuns, listActiveBrowserAutomationRuns, listBrowserAutomationRunEvents, listBrowserAutomationRuns, listBrowserAutomationVersions, listBrowserAutomations, nextBrowserAutomationRunEventSeq, saveBrowserAutomation, saveBrowserAutomationRun, verifyBrowserAutomationRun };