free-computer-use 0.1.0

package/dist/actions/schema.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+const text = z.string().min(1).max(2000);
+export const SemanticTargetSchema = z.object({
+    role: text.optional(), name: text.optional(), label: text.optional(),
+    placeholder: text.optional(), testId: text.optional(), id: text.optional(),
+    attributeName: text.optional(), text: text.optional(), css: text.optional(),
+    frame: z.number().int().min(0).optional(),
+}).strict().refine(t => Object.keys(t).some(k => k !== 'frame'), 'Empty target');
+export const TargetSchema = z.union([text, SemanticTargetSchema]);
+export const ConditionSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('input_value_equals'), target: TargetSchema, value: z.string().max(10000) }).strict(),
+    z.object({ type: z.literal('extraction_created'), key: text.optional() }).strict(),
+    z.object({ type: z.literal('extraction_contains'), key: text.optional(), value: text }).strict(),
+    z.object({ type: z.literal('tab_count'), count: z.number().int().min(1).max(100) }).strict(),
+    z.object({ type: z.literal('extraction_count'), key: text.optional(), min: z.number().int().min(1).max(1000), max: z.number().int().min(1).max(1000).optional() }).strict(),
+    ...['element_exists', 'element_visible', 'element_not_visible', 'checkbox_checked', 'form_submitted']
+        .map(type => z.object({ type: z.literal(type), target: TargetSchema }).strict()),
+    ...['url_equals', 'url_contains', 'text_exists', 'text_disappeared', 'title_changed']
+        .map(type => z.object({ type: z.literal(type), value: text }).strict()),
+    z.object({ type: z.literal('network_response'), value: text, status: z.number().int().min(100).max(599).optional() }).strict(),
+    z.object({ type: z.literal('download_created'), value: text.optional() }).strict(),
+    z.object({ type: z.literal('page_changed'), value: text }).strict(),
+]);
+const meta = {
+    sensitive: z.boolean().optional(),
+    verify: z.array(ConditionSchema).max(12).optional(),
+    timeoutMs: z.number().int().min(100).max(30000).optional(),
+};
+export const ActionSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('switchTab'), index: z.number().int().min(0).max(100), ...meta }).strict(),
+    ...['click', 'doubleClick', 'hover', 'check', 'uncheck', 'submit']
+        .map(type => z.object({ type: z.literal(type), target: TargetSchema, ...meta }).strict()),
+    ...['fill', 'type', 'select', 'press']
+        .map(type => z.object({ type: z.literal(type), target: TargetSchema, value: z.string().max(10000), ...meta }).strict()),
+    ...['navigate', 'openTab']
+        .map(type => z.object({ type: z.literal(type), url: text, ...meta }).strict()),
+    z.object({ type: z.literal('upload'), target: TargetSchema, file: text, ...meta }).strict(),
+    z.object({ type: z.literal('download'), target: TargetSchema, filename: text.optional(), ...meta }).strict(),
+    z.object({ type: z.literal('extract'), target: TargetSchema.optional(), format: z.enum(['text', 'table', 'links', 'records']).default('text'), key: text.default('result'), match: text.optional(), limit: z.number().int().min(1).max(1000).optional(), fields: z.record(text, z.object({ css: text, attribute: z.enum(['text', 'href', 'src', 'value', 'title']).default('text') }).strict()).optional(), ...meta }).strict(),
+    z.object({ type: z.literal('wait'), condition: ConditionSchema, ...meta }).strict(),
+    z.object({ type: z.literal('scroll'), target: TargetSchema.optional(), direction: z.enum(['up', 'down']).default('down'), pixels: z.number().int().min(1).max(10000).default(600), ...meta }).strict(),
+    ...['closeTab', 'back', 'forward', 'reload']
+        .map(type => z.object({ type: z.literal(type), ...meta }).strict()),
+]);
+export const PlanSchema = z.object({
+    goal: text, steps: z.array(text).min(1).max(12),
+    actions: z.array(ActionSchema).min(1).max(80),
+    completion: z.array(ConditionSchema).min(1).max(12),
+    continue: z.boolean().default(false),
+}).strict();
+export const RepairSchema = z.object({
+    actions: z.array(ActionSchema).max(20),
+    replace: z.number().int().min(0).max(20).default(1),
+    completion: z.array(ConditionSchema).min(1).max(12).optional(),
+    continue: z.boolean().optional(),
+}).strict().refine(r => r.actions.length > 0 || !!r.completion, 'Repair needs actions or corrected completion conditions');
+export const validateAction = (value) => ActionSchema.parse(value);
+export const validatePlan = (value) => PlanSchema.parse(value);
+//# sourceMappingURL=schema.js.map

package/dist/actions/schema.js.map

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

package/dist/adapters/generic.d.ts

@@ -0,0 +1,14 @@
+import type { PageState } from '../browser/types.js';
+import { type Plan } from '../actions/schema.js';
+import type { VariableResolver } from '../profile/VariableResolver.js';
+export interface SiteAdapter {
+    name: string;
+    matches(url: URL): boolean;
+    plan(goal: string, state: PageState, variables: VariableResolver): Plan | undefined;
+}
+export declare function mapForm(state: PageState, variables: VariableResolver): {
+    field: import("../browser/types.js").PageElement;
+    key: string;
+    variable: string;
+}[];
+export declare const genericAdapter: SiteAdapter;

package/dist/adapters/generic.js

@@ -0,0 +1,33 @@
+import { PlanSchema } from '../actions/schema.js';
+const fieldAliases = { firstName: ['first name', 'given name'], lastName: ['last name', 'surname', 'family name'], email: ['email', 'email address'], phone: ['phone', 'phone number', 'telephone'], country: ['country'], city: ['city'], message: ['message'], experience: ['years of experience', 'experience'], name: ['name', 'full name'], password: ['password'] };
+export function mapForm(state, variables) {
+    const fields = state.elements.filter(e => ['input', 'textarea', 'select'].includes(e.tag) && e.type !== 'submit' && !e.disabled);
+    return fields.flatMap(field => {
+        const label = field.name.toLowerCase().replace(/\*/g, '').trim();
+        const key = Object.keys(variables.vault.profile).find(key => key.toLowerCase() === label || (fieldAliases[key] ?? []).includes(label));
+        if (key)
+            return [{ field, key, variable: `{{profile.${key}}}` }];
+        return [];
+    });
+}
+export const genericAdapter = {
+    name: 'generic-local', matches: () => true,
+    plan(goal, state, variables) {
+        // Deliberately narrow intent parsing: zero LLM calls for fully specified tasks.
+        if (/^(extract|read)( the)? table\.?$/i.test(goal) && state.tables.length === 1)
+            return PlanSchema.parse({ goal, steps: ['Extract visible table'], actions: [{ type: 'extract', target: { css: 'table' }, format: 'table', key: 'table' }], completion: [{ type: 'element_visible', target: { css: 'table' } }], continue: false });
+        if (/^fill( the)?( contact)? form using( my)? profile\.?$/i.test(goal)) {
+            const mappings = mapForm(state, variables);
+            const required = state.elements.filter(e => e.required && !e.disabled && !e.hasValue);
+            if (!mappings.length || required.some(e => !mappings.some(m => m.field.ref === e.ref)))
+                return;
+            const forms = new Set(mappings.map(m => m.field.form));
+            if (forms.size !== 1)
+                return;
+            return PlanSchema.parse({ goal, steps: ['Map profile aliases to form labels', 'Fill and verify locally'],
+                actions: mappings.map(m => ({ type: m.field.tag === 'select' ? 'select' : 'fill', target: m.field.selectors, value: m.variable })),
+                completion: mappings.map(m => ({ type: 'input_value_equals', target: m.field.selectors, value: m.variable })).slice(0, 12), continue: false });
+        }
+    },
+};
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAY,MAAM,sBAAsB,CAAC;AAG5D,MAAM,YAAY,GAAyB,EAAC,SAAS,EAAC,CAAC,YAAY,EAAC,YAAY,CAAC,EAAC,QAAQ,EAAC,CAAC,WAAW,EAAC,SAAS,EAAC,aAAa,CAAC,EAAC,KAAK,EAAC,CAAC,OAAO,EAAC,eAAe,CAAC,EAAC,KAAK,EAAC,CAAC,OAAO,EAAC,cAAc,EAAC,WAAW,CAAC,EAAC,OAAO,EAAC,CAAC,SAAS,CAAC,EAAC,IAAI,EAAC,CAAC,MAAM,CAAC,EAAC,OAAO,EAAC,CAAC,SAAS,CAAC,EAAC,UAAU,EAAC,CAAC,qBAAqB,EAAC,YAAY,CAAC,EAAC,IAAI,EAAC,CAAC,MAAM,EAAC,WAAW,CAAC,EAAC,QAAQ,EAAC,CAAC,UAAU,CAAC,EAAC,CAAC;AACnW,MAAM,UAAU,OAAO,CAAC,KAAe,EAAC,SAA0B;IAChE,MAAM,MAAM,GAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,OAAO,EAAC,UAAU,EAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAE,CAAC,CAAC,IAAI,KAAG,QAAQ,IAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAA,EAAE;QAC3B,MAAM,KAAK,GAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAA,EAAE,CAAA,GAAG,CAAC,WAAW,EAAE,KAAG,KAAK,IAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7H,IAAG,GAAG;YAAC,OAAM,CAAC,EAAC,KAAK,EAAC,GAAG,EAAC,QAAQ,EAAC,aAAa,GAAG,IAAI,EAAC,CAAC,CAAC;QACzD,OAAM,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AACD,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,IAAI,EAAC,eAAe,EAAC,OAAO,EAAC,GAAE,EAAE,CAAA,IAAI;IACrC,IAAI,CAAC,IAAI,EAAC,KAAK,EAAC,SAAS;QACvB,gFAAgF;QAChF,IAAG,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAE,KAAK,CAAC,MAAM,CAAC,MAAM,KAAG,CAAC;YAAC,OAAO,UAAU,CAAC,KAAK,CAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,uBAAuB,CAAC,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,SAAS,EAAC,MAAM,EAAC,EAAC,GAAG,EAAC,OAAO,EAAC,EAAC,MAAM,EAAC,OAAO,EAAC,GAAG,EAAC,OAAO,EAAC,CAAC,EAAC,UAAU,EAAC,CAAC,EAAC,IAAI,EAAC,iBAAiB,EAAC,MAAM,EAAC,EAAC,GAAG,EAAC,OAAO,EAAC,EAAC,CAAC,EAAC,QAAQ,EAAC,KAAK,EAAC,CAAC,CAAC;QAChS,IAAG,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC,CAAC;YACrE,MAAM,QAAQ,GAAC,OAAO,CAAC,KAAK,EAAC,SAAS,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,QAAQ,IAAE,CAAC,CAAC,CAAC,QAAQ,IAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC9E,IAAG,CAAC,QAAQ,CAAC,MAAM,IAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,KAAK,CAAC,GAAG,KAAG,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAC,OAAO;YACrF,MAAM,KAAK,GAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAAA,IAAG,KAAK,CAAC,IAAI,KAAG,CAAC;gBAAC,OAAO;YAC5E,OAAO,UAAU,CAAC,KAAK,CAAC,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,oCAAoC,EAAC,yBAAyB,CAAC;gBAClG,OAAO,EAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAG,QAAQ,CAAA,CAAC,CAAA,QAAQ,CAAA,CAAC,CAAA,MAAM,EAAC,MAAM,EAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAC,KAAK,EAAC,CAAC,CAAC,QAAQ,EAAC,CAAC,CAAC;gBAClH,UAAU,EAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,EAAC,IAAI,EAAC,oBAAoB,EAAC,MAAM,EAAC,CAAC,CAAC,KAAK,CAAC,SAAS,EAAC,KAAK,EAAC,CAAC,CAAC,QAAQ,EAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,EAAE,CAAC,EAAC,QAAQ,EAAC,KAAK,EAAC,CAAC,CAAC;QACrI,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/agent/Agent.d.ts

@@ -0,0 +1,69 @@
+import { EventEmitter } from 'node:events';
+import { type Plan, type Condition } from '../actions/schema.js';
+import { Executor } from '../actions/executor.js';
+import { Browser, type BrowserOptions } from '../browser/Browser.js';
+import { Observer } from '../browser/Observer.js';
+import type { PageState } from '../browser/types.js';
+import { Control } from './Control.js';
+import { TokenBudget } from './TokenBudget.js';
+import { VariableResolver, type Vault } from '../profile/VariableResolver.js';
+import { TraceStore, type Trace } from '../history/TraceStore.js';
+import { WorkflowEngine } from '../workflows/WorkflowEngine.js';
+import type { LLMProvider } from '../llm/LLMProvider.js';
+import { type SiteAdapter } from '../adapters/generic.js';
+import type { ConfirmationPolicy } from '../actions/policy.js';
+export interface AgentOptions {
+    browser?: BrowserOptions;
+    vault?: Vault;
+    store: TraceStore;
+    provider?: LLMProvider;
+    budget?: TokenBudget;
+    confirmation?: ConfirmationPolicy;
+    downloadDir?: string;
+    maxSteps?: number;
+    maxRepairs?: number;
+    maxRepeatedStates?: number;
+    maxNavigationLoops?: number;
+    useWorkflows?: boolean;
+    adapters?: SiteAdapter[];
+    completionCriteria?: Condition[];
+    mode?: 'normal' | 'ultra';
+}
+export interface AgentEvent {
+    phase: string;
+    message: string;
+    time: number;
+    data?: unknown;
+}
+export declare class Agent extends EventEmitter {
+    readonly options: AgentOptions;
+    readonly browser: Browser;
+    readonly observer: Observer;
+    readonly control: Control;
+    readonly variables: VariableResolver;
+    readonly executor: Executor;
+    readonly workflows: WorkflowEngine;
+    budget: TokenBudget;
+    state?: PageState;
+    trace?: Trace;
+    events: AgentEvent[];
+    active: boolean;
+    private cache;
+    private permittedSites;
+    private watchedContexts;
+    constructor(options: AgentOptions);
+    private authorizeSite;
+    get approvedSites(): string[];
+    revokeSite(value: string): void;
+    private watchLastPageClose;
+    event(phase: string, message: string, data?: unknown): void;
+    open(url: string): Promise<PageState>;
+    observe(): Promise<PageState>;
+    private context;
+    run(goal: string, url?: string, providedPlan?: Plan, allowProvider?: boolean): Promise<Trace>;
+    private providerCalls;
+    private safeTrace;
+    replay(trace: Trace, url?: string): Promise<Trace>;
+    prepareForNextRun(options?: Partial<Omit<AgentOptions, 'store'>>): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/agent/Agent.js

@@ -0,0 +1,375 @@
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { PlanSchema, RepairSchema } from '../actions/schema.js';
+import { Executor } from '../actions/executor.js';
+import { Browser, checkedHttpURL } from '../browser/Browser.js';
+import { SecurityBoundaryError } from '../browser/SecurityBoundaryError.js';
+import { Observer } from '../browser/Observer.js';
+import { diffPages } from '../browser/PageCompressor.js';
+import { Control } from './Control.js';
+import { TokenBudget } from './TokenBudget.js';
+import { VariableResolver } from '../profile/VariableResolver.js';
+import { WorkflowEngine } from '../workflows/WorkflowEngine.js';
+import { genericAdapter } from '../adapters/generic.js';
+import { goalCriteria } from './goalCriteria.js';
+export class Agent extends EventEmitter {
+    options;
+    browser;
+    observer = new Observer();
+    control = new Control();
+    variables;
+    executor;
+    workflows;
+    budget;
+    state;
+    trace;
+    events = [];
+    active = false;
+    cache = new Map();
+    permittedSites = new Set();
+    watchedContexts = new WeakSet();
+    constructor(options) {
+        super();
+        this.options = options;
+        this.variables = new VariableResolver(options.vault);
+        this.browser = new Browser({ ...options.browser, allowExternal: options.mode === 'ultra' || options.browser?.allowExternal, beforeNavigate: url => this.authorizeSite(url) });
+        this.budget = options.budget ?? new TokenBudget();
+        this.workflows = new WorkflowEngine(options.store);
+        this.executor = new Executor(this.browser, this.observer, this.variables, this.control, { confirmation: options.mode === 'ultra' ? 'never' : options.confirmation, downloadDir: options.downloadDir });
+        this.control.on('approval', data => this.event('HUMAN', 'Human confirmation required', data));
+        this.control.on('change', () => { if (this.control.stopped)
+            this.options.provider?.cancel?.(); });
+    }
+    async authorizeSite(value) {
+        const origin = new URL(value).origin;
+        const blocked = this.browser.options.blockedOrigins ??= [];
+        if (!blocked.includes(origin) && (this.options.mode === 'ultra' || this.permittedSites.has(origin))) {
+            this.permittedSites.add(origin);
+            return;
+        }
+        await this.control.confirm(`Allow browser access to ${origin}?`, { type: 'siteAccess', origin, scope: 'This browser session: inspect pages and perform the requested task', mode: 'normal' });
+        this.permittedSites.add(origin);
+        this.browser.options.blockedOrigins = blocked.filter(item => item !== origin);
+        const origins = this.browser.options.allowedOrigins ??= [];
+        if (!origins.includes(origin))
+            origins.push(origin);
+        this.event('PERMISSION', `Website approved: ${origin}`);
+    }
+    get approvedSites() { return [...this.permittedSites].sort(); }
+    revokeSite(value) {
+        const origin = checkedHttpURL(value).origin;
+        if (!this.permittedSites.delete(origin))
+            throw new Error('Website is not currently approved');
+        this.browser.options.allowedOrigins = (this.browser.options.allowedOrigins ?? []).filter(item => item !== origin);
+        const blocked = this.browser.options.blockedOrigins ??= [];
+        if (!blocked.includes(origin))
+            blocked.push(origin);
+        this.event('PERMISSION', `Website access revoked: ${origin}`);
+        if (this.active && this.browser.page && !this.browser.page.isClosed() && new URL(this.browser.page.url()).origin === origin)
+            this.control.stop();
+    }
+    watchLastPageClose() {
+        const context = this.browser.context;
+        if (this.watchedContexts.has(context))
+            return;
+        this.watchedContexts.add(context);
+        const watch = (page) => page.once('close', () => {
+            if (!this.active || this.control.stopped || page !== this.browser.page)
+                return;
+            this.control.stop();
+        });
+        context.pages().forEach(watch);
+        context.on('page', watch);
+    }
+    event(phase, message, data) {
+        const event = { phase, message: this.variables.redact(message), time: Date.now(), data: data === undefined ? undefined : JSON.parse(this.variables.redact(JSON.stringify(data))) };
+        this.events.push(event);
+        if (this.events.length > 500)
+            this.events.shift();
+        this.emit('event', event);
+    }
+    async open(url) { if (!this.browser.context)
+        await this.browser.launch(); await this.browser.navigate(url); return this.observe(); }
+    async observe() {
+        const state = await this.observer.inspect(this.browser.page);
+        this.state = state;
+        this.cache.set(state.hash, state);
+        if (this.cache.size > 30)
+            this.cache.delete(this.cache.keys().next().value);
+        const compressed = this.observer.compressor.compress(state);
+        this.event('OBSERVE', `DOM ${state.htmlBytes} bytes → ${compressed.bytes} bytes`, { url: state.url, title: state.title, hash: state.hash, reduction: compressed.reduction });
+        return state;
+    }
+    context(goal, state, completed, previous) {
+        const remaining = this.budget.limits.maxInputTokens === null ? Infinity : this.budget.limits.maxInputTokens - this.budget.input - this.budget.pendingInput;
+        const maxChars = Math.min(this.budget.tight ? 3000 : 9000, Math.max(1200, remaining - 9000));
+        const full = this.observer.compressor.compress(state, { goal, maxChars });
+        let page = full.text;
+        if (previous) {
+            const diff = JSON.stringify(diffPages(previous, state));
+            if (diff.length < page.length)
+                page = `PAGE DIFF\n${diff}`;
+        }
+        const structured = this.browser.extractions.filter(e => e.value !== null && typeof e.value === 'object').slice(-16).map(e => ({ key: e.key, preview: JSON.stringify(e.value).slice(0, 1400) }));
+        const priorText = this.browser.extractions.filter(e => typeof e.value === 'string').slice(-16).map(e => ({ key: e.key, preview: e.value.slice(-1800) }));
+        page += '\nOPEN TABS ' + JSON.stringify(this.browser.context.pages().map((p, index) => ({ index, url: p.url, active: p === this.browser.page }))) + '\nEXTRACTED EVIDENCE FROM PRIOR PAGES ' + this.variables.redact(JSON.stringify([...structured, ...priorText]));
+        return { goal: this.variables.redact(goal), page: this.variables.redact(page), aliases: this.variables.aliases(), completed: completed.slice(-12), allowedOrigins: this.browser.options.allowedOrigins ?? [], phase: 'current batch', trustedCompletionCriteria: [...this.options.completionCriteria ?? [], ...goalCriteria(goal)] };
+    }
+    async run(goal, url, providedPlan, allowProvider = true) {
+        if (this.active)
+            throw new Error('An agent task is already running');
+        if (this.control.stopped)
+            throw new Error('Create a new agent after stopping a task');
+        if (url)
+            checkedHttpURL(url, this.browser.page?.url());
+        this.active = true;
+        const startedAt = Date.now();
+        const callStart = this.providerCalls().length;
+        const provider = allowProvider ? this.options.provider : undefined;
+        const usageStart = this.budget.snapshot();
+        let initial, repairs = 0, cacheHits = 0, planCalls = 0;
+        const trace = { version: 1, id: `run-${new Date().toISOString().replace(/[:.]/g, '-')}-${randomUUID().slice(0, 6)}`, goal: this.variables.redact(goal), url: this.variables.redact(url ?? this.browser.page?.url() ?? ''), status: 'running', startedAt, durationMs: 0, plans: [], actions: [], completion: [], calls: [], metrics: {} };
+        this.trace = trace;
+        this.options.store.save(trace);
+        const repeated = new Map(), navigations = new Map(), completed = [];
+        let revision = this.control.revision, completionReplans = 0;
+        try {
+            if (!this.browser.context)
+                await this.browser.launch();
+            this.watchLastPageClose();
+            this.browser.extractions.length = 0;
+            this.browser.downloads.length = 0;
+            this.browser.formReceipts.length = 0;
+            if (url)
+                await this.browser.navigate(url);
+            initial = await this.observe();
+            trace.url = this.variables.redact(initial.url);
+            if (initial.warnings.some(w => w.includes('Human authentication'))) {
+                this.control.pause();
+                this.event('HUMAN', 'Take control to complete authentication/security checks, then resume');
+                await this.control.checkpoint();
+                initial = await this.observe();
+                revision = this.control.revision;
+            }
+            const learned = this.options.useWorkflows !== false && !providedPlan ? this.workflows.match(goal, initial) : undefined;
+            let plan = providedPlan ?? learned?.plan;
+            if (learned) {
+                cacheHits++;
+                this.event('CACHE', `Reusing learned workflow ${learned.id}`);
+            }
+            if (!plan)
+                for (const adapter of this.options.adapters ?? [genericAdapter]) {
+                    if (adapter.matches(new URL(initial.url))) {
+                        plan = adapter.plan(goal, initial, this.variables);
+                        if (plan) {
+                            this.event('LOCAL', `Deterministic strategy: ${adapter.name}`);
+                            break;
+                        }
+                    }
+                }
+            let previous;
+            while (true) {
+                await this.control.checkpoint();
+                if (!plan) {
+                    if (!provider)
+                        throw new Error('No matching local strategy/workflow; configure an LLM provider');
+                    this.event('PLAN', 'Requesting one action batch');
+                    planCalls++;
+                    plan = await provider.plan(this.context(goal, this.state, completed, previous));
+                }
+                const batchState = this.state;
+                plan = PlanSchema.parse(plan);
+                trace.plans.push(plan);
+                this.event('PLAN', 'Validated plan', plan);
+                this.trace = this.safeTrace(trace);
+                this.options.store.save(this.trace);
+                let actions = [...plan.actions];
+                let index = 0;
+                while (index < actions.length) {
+                    await this.control.checkpoint();
+                    if (revision !== this.control.revision) {
+                        await this.observe();
+                        revision = this.control.revision;
+                    }
+                    if (this.control.replacement) {
+                        plan = this.control.replacement;
+                        this.control.replacement = undefined;
+                        actions = [...plan.actions];
+                        index = 0;
+                        trace.plans.push(plan);
+                        await this.observe();
+                        this.event('HUMAN', 'Using edited plan', plan);
+                    }
+                    if (trace.actions.length >= (this.options.maxSteps ?? 120))
+                        throw new Error('Browser action limit reached');
+                    const before = this.state;
+                    const action = actions[index];
+                    if (this.options.mode !== 'ultra' && /\{\{(?:profile|files)\./.test(JSON.stringify(action)) && !/\b(profile|personal details|my details|credentials|resume|cv|local file)\b/i.test(goal))
+                        throw new Error('The user goal does not authorize access to local profile/file aliases');
+                    const key = before.hash + JSON.stringify(action);
+                    const count = (repeated.get(key) ?? 0) + 1;
+                    repeated.set(key, count);
+                    if (count > (this.options.maxRepeatedStates ?? 3))
+                        throw new Error('Repeated state/action loop detected');
+                    this.event('EXECUTE', `${action.type}${'target' in action ? ' ' + JSON.stringify(action.target) : ''}`, { index: index + 1, total: actions.length });
+                    const result = await this.executor.run(action);
+                    trace.actions.push(result);
+                    this.trace = this.safeTrace(trace);
+                    this.options.store.save(this.trace);
+                    const after = await this.observe();
+                    if (before.url !== after.url) {
+                        const loops = (navigations.get(after.url) ?? 0) + 1;
+                        navigations.set(after.url, loops);
+                        if (loops > (this.options.maxNavigationLoops ?? 3))
+                            throw new Error('Navigation loop detected');
+                    }
+                    if (result.success) {
+                        const descriptor = 'target' in result.action && typeof result.action.target === 'object' ? result.action.target : undefined;
+                        completed.push(this.variables.redact(JSON.stringify({ type: action.type, ...('url' in result.action ? { url: result.action.url } : {}), ...(descriptor ? { target: { role: descriptor.role, name: descriptor.name ?? descriptor.label ?? descriptor.id ?? descriptor.css } } : {}), ...('key' in result.action ? { key: result.action.key } : {}) })));
+                        index++;
+                        this.event('VERIFY', 'Action completed locally', { action: action.type, durationMs: result.durationMs, strategy: result.strategy });
+                        continue;
+                    }
+                    if (this.control.stopped || /rejected by human|stopped by human/.test(result.error ?? ''))
+                        throw new Error(result.error);
+                    if (result.uncertain) {
+                        await this.control.confirm('The previous action may already have happened. Approve a repair only after checking the browser.', result.action);
+                        await this.observe();
+                    }
+                    if (!provider || repairs >= (this.options.maxRepairs ?? 8))
+                        throw new Error(result.error ?? 'Repair limit reached');
+                    repairs++;
+                    this.event('REPAIR', 'Repairing only the failed portion', { failedAction: result.action, error: result.error });
+                    const context = this.context(goal, after, completed, before);
+                    if (repairs > 1)
+                        context.page += '\nACCESSIBILITY\n' + this.variables.redact(await this.observer.accessibility(this.browser.page));
+                    if (repairs > 2) {
+                        const scope = await this.browser.page.locator('form').count() === 1 ? 'form' : await this.browser.page.locator('main').count() === 1 ? 'main' : 'body';
+                        context.page += '\nTARGETED HTML\n' + this.variables.redact(await this.observer.fragment(this.browser.page, scope)).slice(0, 3000);
+                    }
+                    const repaired = RepairSchema.parse(await provider.repair({ ...context, failedAction: result.action, error: result.error ?? 'Action failed', remaining: actions.slice(index, index + 12) }));
+                    if (repaired.replace < 1 || !repaired.actions.length || repaired.replace > actions.length - index)
+                        throw new Error('Repair attempted to replace actions outside the pending batch');
+                    if (repaired.completion)
+                        plan.completion = repaired.completion;
+                    if (repaired.continue !== undefined)
+                        plan.continue = repaired.continue;
+                    actions.splice(index, repaired.replace, ...repaired.actions);
+                }
+                const criteria = () => [...plan.completion, ...(!plan.continue ? [...this.options.completionCriteria ?? [], ...goalCriteria(goal)] : [])];
+                let verification = await this.executor.verifier.check(criteria(), 4000, startedAt);
+                this.event('VERIFY', verification.success ? 'Batch completion verified' : 'Completion conditions failed', verification);
+                if (!verification.success) {
+                    if (provider && completionReplans < 3 && /\b(download|export)\b/i.test(goal) && verification.failed.some(item => item.type === 'download_created') && !actions.some(item => item.type === 'download') && actions.some(item => item.type === 'click' && typeof item.target === 'object' && /save|export/i.test(item.target.name ?? ''))) {
+                        completionReplans++;
+                        this.event('PLAN', 'Download still missing; observing controls revealed after the last action');
+                        previous = batchState;
+                        await this.observe();
+                        plan = undefined;
+                        continue;
+                    }
+                    if (!provider || repairs >= (this.options.maxRepairs ?? 8))
+                        throw new Error('Task completion could not be verified');
+                    repairs++;
+                    const after = await this.observe();
+                    this.event('REPAIR', 'Repairing failed completion conditions');
+                    const repaired = RepairSchema.parse(await provider.repair({ ...this.context(goal, after, completed), failedAction: { type: 'verification' }, error: 'Completion conditions failed; user-specified criteria cannot be weakened or removed', remaining: [], failedConditions: criteria() }));
+                    if (repaired.completion)
+                        plan.completion = repaired.completion;
+                    if (repaired.continue !== undefined)
+                        plan.continue = repaired.continue;
+                    if (repaired.actions.length) {
+                        plan = { ...plan, actions: repaired.actions };
+                        continue;
+                    }
+                    verification = await this.executor.verifier.check(criteria(), 3000, startedAt);
+                    if (!verification.success && repaired.continue) {
+                        previous = batchState;
+                        await this.observe();
+                        plan = undefined;
+                        continue;
+                    }
+                    if (!verification.success)
+                        throw new Error('Repaired task completion could not be verified');
+                }
+                if (plan.continue) {
+                    previous = batchState;
+                    await this.observe();
+                    plan = undefined;
+                    continue;
+                }
+                trace.completion = criteria().map(c => this.executor.semanticCondition(c));
+                trace.status = 'completed';
+                break;
+            }
+        }
+        catch (error) {
+            trace.status = this.control.stopped ? 'stopped' : 'failed';
+            if (error instanceof SecurityBoundaryError)
+                trace.failureKind = 'security';
+            trace.error = this.variables.redact(error instanceof Error ? error.message : 'Task failed');
+            this.control.stop();
+            this.event(trace.failureKind === 'security' ? 'BLOCKED' : 'ERROR', trace.error);
+        }
+        finally {
+            trace.durationMs = Date.now() - startedAt;
+            trace.calls = this.providerCalls().slice(callStart);
+            const usage = this.budget.snapshot(trace.actions.filter(a => a.success).length);
+            const actions = trace.actions.filter(a => a.success).length, calls = usage.llmCalls - usageStart.llmCalls;
+            trace.metrics = { durationMs: trace.durationMs, browserActions: actions, failedActions: trace.actions.filter(a => !a.success).length, llmCalls: calls, inputTokens: usage.inputTokens - usageStart.inputTokens, outputTokens: usage.outputTokens - usageStart.outputTokens,
+                estimatedCostUSD: usage.estimatedCostUSD === null ? null : usage.estimatedCostUSD - (usageStart.estimatedCostUSD ?? 0), actionsPerLLMCall: calls ? actions / calls : null, tokensPerAction: actions ? ((usage.inputTokens - usageStart.inputTokens) + (usage.outputTokens - usageStart.outputTokens)) / actions : null,
+                repairs, workflowCacheHits: cacheHits, pageCacheEntries: this.cache.size, planBatches: planCalls, compressionReduction: initial ? this.observer.compressor.compress(initial).reduction : null, selectorSuccessRate: trace.actions.filter(a => a.strategy).length ? trace.actions.filter(a => a.strategy && a.success).length / trace.actions.filter(a => a.strategy).length : null,
+                usageEstimated: trace.calls.some(c => c.usage.estimated), provider: this.options.provider?.name ?? 'none', mode: this.options.mode ?? 'normal', approvedSites: [...this.permittedSites] };
+            const safe = this.safeTrace(trace);
+            this.trace = safe;
+            this.options.store.save(safe);
+            this.active = false;
+            if (safe.status === 'completed' && initial) {
+                try {
+                    this.workflows.learn(safe, initial);
+                }
+                catch {
+                    this.event('CACHE', 'Task completed, but workflow could not be saved');
+                }
+            }
+            this.event(safe.status === 'completed' ? 'DONE' : 'STOP', `Task ${safe.status}`, safe.metrics);
+        }
+        return this.trace;
+    }
+    providerCalls() { return this.options.provider?.calls ?? []; }
+    safeTrace(trace) { return JSON.parse(this.variables.redact(JSON.stringify(trace))); }
+    async replay(trace, url) {
+        if (trace.status !== 'completed')
+            throw new Error('Only completed traces can be replayed; failed runs may contain incomplete side effects');
+        const plan = PlanSchema.parse({ goal: trace.goal, steps: ['Replay successful semantic actions'], actions: trace.actions.filter(a => a.success).map(a => a.action), completion: trace.completion, continue: false });
+        return this.run(trace.goal, url ?? trace.url, plan, false);
+    }
+    async prepareForNextRun(options = {}) {
+        if (this.active || this.control.pending)
+            throw new Error('Cannot prepare an active browser task for another run');
+        Object.assign(this.options, options);
+        this.control.reset();
+        if (Object.hasOwn(options, 'vault'))
+            this.variables.vault = options.vault ?? { profile: {}, files: {} };
+        if (options.budget)
+            this.budget = options.budget;
+        Object.assign(this.browser.options, options.browser);
+        this.browser.options.allowedOrigins = [...(options.browser?.allowedOrigins ?? [])];
+        this.browser.options.blockedOrigins = [...(options.browser?.blockedOrigins ?? [])];
+        this.browser.options.allowExternal = this.options.mode === 'ultra' || options.browser?.allowExternal === true;
+        this.executor.options.confirmation = this.options.mode === 'ultra' ? 'never' : this.options.confirmation;
+        this.executor.options.downloadDir = this.options.downloadDir;
+        this.state = undefined;
+        this.trace = undefined;
+        this.events = [];
+        this.cache.clear();
+        this.permittedSites.clear();
+        this.browser.downloads.length = 0;
+        this.browser.extractions.length = 0;
+        this.browser.responses.length = 0;
+        this.browser.formReceipts.length = 0;
+        await this.browser.prepareForNextRun();
+    }
+    async close() { this.control.stop(); await this.browser.close(); }
+}
+//# sourceMappingURL=Agent.js.map