free-computer-use 0.1.0

package/dist/browser/Observer.d.ts

@@ -0,0 +1,12 @@
+import type { Page } from 'playwright';
+import { DomExtractor } from './DomExtractor.js';
+import { SelectorEngine } from './SelectorEngine.js';
+import { PageCompressor } from './PageCompressor.js';
+export declare class Observer {
+    readonly extractor: DomExtractor;
+    readonly selectors: SelectorEngine;
+    readonly compressor: PageCompressor;
+    inspect(page: Page, region?: string): Promise<import("./types.js").PageState>;
+    accessibility(page: Page, region?: string): Promise<string>;
+    fragment(page: Page, selector: string): Promise<string>;
+}

package/dist/browser/Observer.js

@@ -0,0 +1,31 @@
+import { DomExtractor } from './DomExtractor.js';
+import { SelectorEngine } from './SelectorEngine.js';
+import { PageCompressor } from './PageCompressor.js';
+export class Observer {
+    extractor = new DomExtractor();
+    selectors = new SelectorEngine();
+    compressor = new PageCompressor();
+    async inspect(page, region) {
+        const state = await this.extractor.extract(page, region);
+        this.selectors.remember(state.elements);
+        return state;
+    }
+    async accessibility(page, region) {
+        return (await (region ? page.locator(region) : page.locator('body')).ariaSnapshot()).slice(0, 10000);
+    }
+    async fragment(page, selector) {
+        return page.locator(selector).evaluate(el => {
+            const clone = el.cloneNode(true);
+            clone.querySelectorAll('script,style,svg').forEach(node => node.remove());
+            for (const node of [clone, ...clone.querySelectorAll('*')]) {
+                for (const a of [...node.attributes])
+                    if (!['id', 'role', 'name', 'type', 'aria-label', 'aria-labelledby', 'placeholder', 'required', 'disabled', 'checked', 'data-testid', 'data-fcu-ref'].includes(a.name))
+                        node.removeAttribute(a.name);
+                if (node.matches('textarea'))
+                    node.textContent = '[local value omitted]';
+            }
+            return clone.outerHTML.slice(0, 8000);
+        });
+    }
+}
+//# sourceMappingURL=Observer.js.map

package/dist/browser/Observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observer.js","sourceRoot":"","sources":["../../src/browser/Observer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,MAAM,OAAO,QAAQ;IACV,SAAS,GAAC,IAAI,YAAY,EAAE,CAAC;IAC7B,SAAS,GAAC,IAAI,cAAc,EAAE,CAAC;IAC/B,UAAU,GAAC,IAAI,cAAc,EAAE,CAAC;IACzC,KAAK,CAAC,OAAO,CAAC,IAAS,EAAC,MAAc;QACpC,MAAM,KAAK,GAAC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,IAAS,EAAC,MAAc;QAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA,CAAC,CAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA,CAAC,CAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAC,KAAK,CAAC,CAAC;IAClG,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,IAAS,EAAC,QAAe;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAA,EAAE;YACzC,MAAM,KAAK,GAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAY,CAAC;YAC1C,KAAK,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA,EAAE,CAAA,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,KAAI,MAAM,IAAI,IAAI,CAAC,KAAK,EAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACzD,KAAI,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;oBAAE,IAAG,CAAC,CAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,YAAY,EAAC,iBAAiB,EAAC,aAAa,EAAC,UAAU,EAAC,UAAU,EAAC,SAAS,EAAC,aAAa,EAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC9N,IAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;oBAAC,IAAI,CAAC,WAAW,GAAC,uBAAuB,CAAC;YACvE,CAAC;YACD,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/browser/PageCompressor.d.ts

@@ -0,0 +1,47 @@
+import type { PageState } from './types.js';
+export declare const similarity: (a: string, b: string) => number;
+export interface Compression {
+    text: string;
+    bytes: number;
+    rawBytes: number;
+    reduction: number;
+    truncated: boolean;
+}
+export declare class PageCompressor {
+    compress(state: PageState, options?: {
+        goal?: string;
+        maxChars?: number;
+        level?: 1 | 2 | 3;
+        region?: string;
+    }): Compression;
+}
+export declare function diffPages(previous: PageState, current: PageState): {
+    url: string;
+    title: string;
+    hash: string;
+    removed: string[];
+    added: {
+        ref: string;
+        role: string;
+        name: string;
+        type: string | undefined;
+        required: boolean | undefined;
+        options: string[] | undefined;
+    }[];
+    changed: {
+        ref: string;
+        role: string;
+        name: string;
+        type: string | undefined;
+        required: boolean | undefined;
+        options: string[] | undefined;
+        hasValue: boolean | undefined;
+        checked: boolean | undefined;
+        error: string | undefined;
+    }[];
+    headings: string[];
+    text: string | undefined;
+    tables: string[][][] | undefined;
+    dialogs: string[] | undefined;
+    warnings: string[];
+};

package/dist/browser/PageCompressor.js

@@ -0,0 +1,62 @@
+export const similarity = (a, b) => {
+    const tokens = (s) => new Set(s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').split(' ').filter(word => word && !['the', 'this', 'a', 'and', 'of', 'to', 'in', 'on', 'for', 'with', 'my', 'using', 'from', 'at', 'an', 'then', 'is', 'it', 'me'].includes(word)));
+    const aa = tokens(a), bb = tokens(b);
+    if (!aa.size || !bb.size)
+        return 0;
+    return [...aa].filter(x => bb.has(x)).length / new Set([...aa, ...bb]).size;
+};
+export class PageCompressor {
+    compress(state, options = {}) {
+        const max = options.maxChars ?? 12000;
+        const brief = (e) => `[${e.ref}] ${e.role} ${JSON.stringify(e.name)}${e.href ? ` href=${JSON.stringify(e.href)}` : ''}${e.selectors.id ? ` id=${JSON.stringify(e.selectors.id)}` : ''}${e.type ? ` type=${e.type}` : ''}${e.required ? ' required' : ''}${e.disabled ? ' disabled' : ''}${e.form ? ` form=${JSON.stringify(e.form)}` : ''}${e.hasValue ? ' populated' : ''}${e.checked ? ' checked' : ''}${e.error ? ` error=${JSON.stringify(e.error)}` : ''}${e.options ? ` options=${JSON.stringify(e.options)}` : ''}`;
+        const elements = state.elements.filter(e => !options.region || e.region === options.region || e.form === options.region);
+        const ranked = options.goal ? [...elements].sort((a, b) => similarity(options.goal, [b.name, b.form, b.role].join(' ')) - similarity(options.goal, [a.name, a.form, a.role].join(' '))) : elements;
+        const lines = [`PAGE ${state.title}`, `URL ${state.url}`, `STATE ${state.hash}`, `HEADINGS ${state.headings.join(' | ')}`, `WARNINGS ${state.warnings.join(' | ')}`];
+        if (options.level !== 1) {
+            // Reserve space for document data even when navigation contains hundreds
+            // of links. Reading tasks must not lose all facts behind the nav list.
+            const controlBudget = Math.max(300, Math.floor(max * .45));
+            let used = 0, retained = 0;
+            lines.push('INTERACTIVE');
+            for (const element of ranked) {
+                const line = brief(element);
+                if (used + line.length + 1 > controlBudget)
+                    continue;
+                lines.push(line);
+                used += line.length + 1;
+                retained++;
+            }
+            if (retained < ranked.length)
+                lines.push(`[${ranked.length - retained} controls omitted]`);
+            if (state.dialogs.length)
+                lines.push('DIALOGS', ...state.dialogs);
+            if (state.tables.length)
+                lines.push('TABLES', JSON.stringify(state.tables).slice(0, Math.floor(max * .2)));
+        }
+        else
+            lines.push(`INTERACTIVE COUNT ${elements.length}`, `REGIONS ${[...new Set(elements.map(e => e.region).filter(Boolean))].join(' | ')}`);
+        lines.push('VISIBLE TEXT', state.text);
+        const full = lines.join('\n');
+        const truncated = full.length > max || state.truncated;
+        const text = full.length > max ? full.slice(0, Math.max(0, max - 55)) + '\n[TRUNCATED: request a region or more context]' : full;
+        const bytes = Buffer.byteLength(text);
+        return { text, bytes, rawBytes: state.htmlBytes, reduction: state.htmlBytes ? 1 - bytes / state.htmlBytes : 0, truncated };
+    }
+}
+export function diffPages(previous, current) {
+    const signature = (e) => JSON.stringify([e.role, e.name, e.required, e.disabled, e.hasValue, e.checked, e.error, e.options]);
+    const old = new Map(previous.elements.map(e => [e.ref, e]));
+    const fresh = new Map(current.elements.map(e => [e.ref, e]));
+    return {
+        url: current.url, title: current.title, hash: current.hash,
+        removed: previous.elements.filter(e => !fresh.has(e.ref)).map(e => e.ref),
+        added: current.elements.filter(e => !old.has(e.ref)).map(e => ({ ref: e.ref, role: e.role, name: e.name, type: e.type, required: e.required, options: e.options })),
+        changed: current.elements.filter(e => old.has(e.ref) && signature(old.get(e.ref)) !== signature(e)).map(e => ({ ref: e.ref, role: e.role, name: e.name, type: e.type, required: e.required, options: e.options, hasValue: e.hasValue, checked: e.checked, error: e.error })),
+        headings: current.headings.filter(h => !previous.headings.includes(h)),
+        text: current.text === previous.text ? undefined : current.text,
+        tables: JSON.stringify(current.tables) === JSON.stringify(previous.tables) ? undefined : current.tables,
+        dialogs: JSON.stringify(current.dialogs) === JSON.stringify(previous.dialogs) ? undefined : current.dialogs,
+        warnings: current.warnings,
+    };
+}
+//# sourceMappingURL=PageCompressor.js.map

package/dist/browser/PageCompressor.js.map

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

package/dist/browser/SecurityBoundaryError.d.ts

@@ -0,0 +1,3 @@
+export declare class SecurityBoundaryError extends Error {
+    constructor(message: string);
+}

package/dist/browser/SecurityBoundaryError.js

@@ -0,0 +1,4 @@
+export class SecurityBoundaryError extends Error {
+    constructor(message) { super(message); this.name = 'SecurityBoundaryError'; }
+}
+//# sourceMappingURL=SecurityBoundaryError.js.map

package/dist/browser/SecurityBoundaryError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecurityBoundaryError.js","sourceRoot":"","sources":["../../src/browser/SecurityBoundaryError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAc,IAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA,IAAI,CAAC,IAAI,GAAC,uBAAuB,CAAC,CAAA,CAAC;CAC/E"}

package/dist/browser/SelectorEngine.d.ts

@@ -0,0 +1,18 @@
+import type { Locator, Page, Frame } from 'playwright';
+import type { Target, SemanticTarget } from '../actions/schema.js';
+import type { PageElement } from './types.js';
+export declare const selectorRanks: readonly ['role', 'label', 'placeholder', 'testId', 'id', 'attributeName', 'text', 'css', 'path'];
+export declare class SelectorEngine {
+    private registry;
+    remember(elements: PageElement[]): void;
+    descriptor(target: Target): SemanticTarget;
+    element(target: Target): PageElement | undefined;
+    candidates(root: Page | Frame, t: SemanticTarget): {
+        strategy: string;
+        locator: Locator;
+    }[];
+    resolve(page: Page, target: Target, timeoutMs?: number, allowMany?: boolean): Promise<{
+        locator: Locator;
+        strategy: string;
+    }>;
+}

package/dist/browser/SelectorEngine.js

@@ -0,0 +1,72 @@
+const attr = (value) => JSON.stringify(value);
+export const selectorRanks = ['role', 'label', 'placeholder', 'testId', 'id', 'attributeName', 'text', 'css', 'path'];
+export class SelectorEngine {
+    registry = new Map();
+    remember(elements) { for (const element of elements)
+        this.registry.set(element.ref, element); while (this.registry.size > 5000)
+        this.registry.delete(this.registry.keys().next().value); }
+    descriptor(target) {
+        if (typeof target !== 'string')
+            return target;
+        if (target.startsWith('css:'))
+            return { css: target.slice(4) };
+        const el = this.registry.get(target);
+        if (!el)
+            throw new Error(`Unknown semantic reference ${target}`);
+        return { ...el.selectors };
+    }
+    element(target) { return typeof target === 'string' ? this.registry.get(target) : undefined; }
+    candidates(root, t) {
+        const list = [];
+        if (t.role)
+            list.push({ strategy: 'role', locator: root.getByRole(t.role, t.name ? { name: t.name, exact: true } : {}) });
+        if (t.label)
+            list.push({ strategy: 'label', locator: root.getByLabel(t.label, { exact: true }) });
+        else if (t.name && ['textbox', 'combobox', 'spinbutton', 'upload'].includes(t.role ?? ''))
+            list.push({ strategy: 'label', locator: root.getByLabel(t.name, { exact: true }) });
+        if (t.placeholder)
+            list.push({ strategy: 'placeholder', locator: root.getByPlaceholder(t.placeholder, { exact: true }) });
+        if (t.testId)
+            list.push({ strategy: 'testId', locator: root.getByTestId(t.testId) });
+        if (t.id)
+            list.push({ strategy: 'id', locator: root.locator(`[id=${attr(t.id)}]`) });
+        if (t.attributeName)
+            list.push({ strategy: 'attributeName', locator: root.locator(`[name=${attr(t.attributeName)}]`) });
+        if (t.text)
+            list.push({ strategy: 'text', locator: root.getByText(t.text, { exact: true }) });
+        if (t.css)
+            list.push({ strategy: 'css', locator: root.locator(t.css) });
+        // Native disclosure summaries are clickable controls, but Chromium does not
+        // expose them through Playwright's button role. Preserve exact-name matching.
+        if (t.role === 'button' && t.name)
+            list.push({ strategy: 'disclosure', locator: root.locator('summary').and(root.getByText(t.name, { exact: true })) });
+        if (t.role === 'button' && /^(next( step)?|continue|proceed|advance)$/i.test(t.name ?? ''))
+            list.push({ strategy: 'local-synonym', locator: root.getByRole('button', { name: /^(next( step)?|continue|proceed|advance)$/i }) });
+        return list;
+    }
+    async resolve(page, target, timeoutMs = 4000, allowMany = false) {
+        const t = this.descriptor(target), observed = this.element(target);
+        const root = page.frames()[t.frame ?? 0];
+        if (!root)
+            throw new Error('Target frame no longer exists');
+        const deadline = Date.now() + timeoutMs;
+        do {
+            for (const candidate of this.candidates(root, t)) {
+                const count = await candidate.locator.count();
+                if (count === 1 || allowMany && count > 1)
+                    return candidate;
+            }
+            if (observed) {
+                const ref = root.locator(`[data-fcu-ref=${attr(observed.ref)}]`);
+                if (await ref.count() === 1)
+                    return { locator: ref, strategy: 'reference' };
+                const path = root.locator(observed.path);
+                if (await path.count() === 1 && await path.evaluate((el, name) => (el.getAttribute('aria-label') || el.textContent || '').replace(/\s+/g, ' ').trim() === name, observed.name))
+                    return { locator: path, strategy: 'path' };
+            }
+            await page.waitForTimeout(70);
+        } while (Date.now() < deadline);
+        throw new Error(`Target missing or ambiguous: ${typeof target === 'string' ? target : JSON.stringify(target)}`);
+    }
+}
+//# sourceMappingURL=SelectorEngine.js.map

package/dist/browser/SelectorEngine.js.map

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

package/dist/browser/types.d.ts

@@ -0,0 +1,38 @@
+import type { SemanticTarget } from '../actions/schema.js';
+export interface PageElement {
+    ref: string;
+    tag: string;
+    role: string;
+    name: string;
+    label?: string;
+    type?: string;
+    required?: boolean;
+    disabled?: boolean;
+    hasValue?: boolean;
+    checked?: boolean;
+    options?: string[];
+    error?: string;
+    form?: string;
+    frame: number;
+    selectors: SemanticTarget;
+    path: string;
+    region?: string;
+    href?: string;
+}
+export interface PageState {
+    url: string;
+    title: string;
+    headings: string[];
+    text: string;
+    elements: PageElement[];
+    tables: string[][][];
+    dialogs: string[];
+    htmlBytes: number;
+    hash: string;
+    warnings: string[];
+    frames: {
+        index: number;
+        url: string;
+    }[];
+    truncated: boolean;
+}

package/dist/browser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":""}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { join, resolve } from 'node:path';
+import { readFile, mkdir } from 'node:fs/promises';
+import { Agent } from '../agent/Agent.js';
+import { TraceStore } from '../history/TraceStore.js';
+import { ProfileStore } from '../profile/ProfileStore.js';
+import { VariableResolver } from '../profile/VariableResolver.js';
+import { WorkflowEngine } from '../workflows/WorkflowEngine.js';
+import { Browser } from '../browser/Browser.js';
+import { FlashProvider } from '../llm/FlashProvider.js';
+import { CodexSubscriptionProvider } from '../llm/CodexSubscriptionProvider.js';
+import { ClaudeSubscriptionProvider } from '../llm/ClaudeSubscriptionProvider.js';
+import { ensureDataDirectory, loadEnvironment, runtimeConfig } from '../config.js';
+import { z } from 'zod';
+const packageManifest = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8'));
+loadEnvironment();
+const program = new Command().name('agent').description('DOM-first browser automation: plan once, execute locally.').version(packageManifest.version);
+const policySchema = z.enum(['sensitive', 'always', 'never']);
+function runFlags(command) { return command.option('--headed', 'Show Chromium').option('--debug', 'Log all observe/plan/execute/verify/repair events').option('--profile <file>', 'Use a local profile JSON file').option('--allow-origin <url>', 'Allow another exact origin', (value, old) => [...old, new URL(value).origin], []).option('--allow-external', 'Allow browser requests outside the origin allowlist').option('--confirmation <policy>', 'sensitive | always | never', 'sensitive').option('--no-workflows', 'Skip learned workflow lookup').option('--max-steps <n>', 'Maximum browser actions', '120').option('--max-repairs <n>', 'Maximum model repairs', '3').option('--ephemeral', 'Do not reuse saved browser cookies/session').option('--expect-text <text>', 'Trusted final text criterion the model cannot weaken').option('--expect-url <part>', 'Trusted final URL substring the model cannot weaken').option('--ultra', 'Explicit Ultra mode: skip website and sensitive-action approvals'); }
+async function makeAgent(url, options) {
+    const config = runtimeConfig();
+    ensureDataDirectory(config.dataDir);
+    const store = new TraceStore(join(config.dataDir, 'history.sqlite'));
+    try {
+        const vault = await new ProfileStore(options.profile ? resolve(options.profile) : join(config.dataDir, 'profile.json')).load();
+        const agent = new Agent({ store, provider: config.provider, budget: config.budget, vault, useWorkflows: options.workflows,
+            mode: options.ultra ? 'ultra' : 'normal',
+            confirmation: policySchema.parse(options.confirmation ?? 'sensitive'), downloadDir: join(config.dataDir, 'downloads'),
+            completionCriteria: [...(options.expectText ? [{ type: 'text_exists', value: options.expectText }] : []), ...(options.expectUrl ? [{ type: 'url_contains', value: options.expectUrl }] : [])],
+            maxSteps: z.coerce.number().int().positive().parse(options.maxSteps ?? 120), maxRepairs: z.coerce.number().int().nonnegative().parse(options.maxRepairs ?? 8),
+            browser: { headless: !options.headed, profileDir: options.ephemeral ? undefined : join(config.dataDir, 'browser'), allowedOrigins: [new URL(url).origin, ...options.allowOrigin ?? []], allowExternal: options.allowExternal } });
+        return { agent, store };
+    }
+    catch (error) {
+        store.close();
+        throw error;
+    }
+}
+function showTrace(trace) {
+    console.log(`\n${trace.status.toUpperCase()} ${trace.id}`);
+    for (const result of trace.actions)
+        if (result.success && result.data)
+            console.log(JSON.stringify(result.data, null, 2));
+    console.log(JSON.stringify(trace.metrics, null, 2));
+    if (trace.error)
+        console.error(trace.error);
+    if (trace.status !== 'completed')
+        process.exitCode = 1;
+}
+function connectEvents(agent, debug, rl) {
+    agent.on('event', event => { if (debug || ['PLAN', 'REPAIR', 'HUMAN', 'ERROR', 'DONE', 'CACHE', 'LOCAL'].includes(event.phase))
+        console.log(`[${event.phase}] ${event.message}`); });
+    agent.control.on('approval', async (pending) => {
+        if (!stdin.isTTY) {
+            console.error('Human approval needs a terminal or the local UI; action rejected.');
+            agent.control.reject();
+            return;
+        }
+        const reader = rl ?? createInterface({ input: stdin, output: stdout }), cancellation = new AbortController();
+        const onChange = () => { if (agent.control.stopped || agent.control.pending !== pending)
+            cancellation.abort(); };
+        agent.control.on('change', onChange);
+        try {
+            while (agent.control.pending === pending && !agent.control.stopped) {
+                const answer = (await reader.question(`${pending.reason}\n${JSON.stringify(pending.action)}\nApprove? [y/N] `, { signal: cancellation.signal })).trim();
+                if (answer === ':stop') {
+                    agent.control.stop();
+                    break;
+                }
+                if (answer === ':pause') {
+                    agent.control.pause();
+                    continue;
+                }
+                if (answer === ':resume') {
+                    agent.control.resume();
+                    continue;
+                }
+                if (agent.control.pending !== pending || agent.control.stopped)
+                    break;
+                if (/^(y|yes|:approve)$/i.test(answer))
+                    agent.control.approve();
+                else
+                    agent.control.reject();
+                break;
+            }
+        }
+        catch {
+            if (agent.control.pending === pending && !agent.control.stopped)
+                agent.control.reject();
+        }
+        finally {
+            agent.control.off('change', onChange);
+            if (!rl)
+                reader.close();
+        }
+    });
+}
+async function interactive(url, options = {}) {
+    if (!stdin.isTTY)
+        throw new Error('Interactive mode requires a terminal. Use agent run or agent ui.');
+    const reader = createInterface({ input: stdin, output: stdout });
+    const start = url ?? await reader.question('Starting URL: ');
+    const { agent, store } = await makeAgent(start, { ...options, headed: true }).catch(error => { reader.close(); throw error; });
+    connectEvents(agent, !!options.debug, reader);
+    try {
+        await agent.open(start);
+        console.log(`FreeComputerUse · ${agent.options.provider?.name ?? 'local workflows only'}\nCommands: :pause :resume :approve :reject :stop :inspect :quit`);
+        while (true) {
+            const goal = (await reader.question('> ')).trim();
+            if (!goal)
+                continue;
+            if (goal === ':quit')
+                break;
+            if (goal === ':inspect') {
+                console.log(agent.variables.redact(agent.observer.compressor.compress(await agent.observe()).text));
+                continue;
+            }
+            if (goal.startsWith(':')) {
+                console.log('Control commands are available while a task runs, or in the local UI.');
+                continue;
+            }
+            // Read input while the run is active so humans can take/return control.
+            const handler = (line) => { if (agent.control.pending)
+                return; const control = line.trim(); if (control === ':pause')
+                agent.control.pause(); if (control === ':resume')
+                agent.control.resume(); if (control === ':stop')
+                agent.control.stop(); };
+            reader.on('line', handler);
+            try {
+                showTrace(await agent.run(goal));
+            }
+            finally {
+                reader.off('line', handler);
+            }
+            if (agent.control.stopped)
+                break;
+        }
+    }
+    finally {
+        reader.close();
+        await agent.close();
+        store.close();
+    }
+}
+runFlags(program.command('run <goal> <url>').description('Run a natural language browser task')).action(async (goal, url, options) => {
+    const { agent, store } = await makeAgent(url, options);
+    connectEvents(agent, !!options.debug);
+    const interrupt = () => agent.control.stop();
+    process.once('SIGINT', interrupt);
+    try {
+        showTrace(await agent.run(goal, url));
+    }
+    finally {
+        process.off('SIGINT', interrupt);
+        await agent.close();
+        store.close();
+    }
+});
+runFlags(program.command('open <url>').description('Open a persistent browser and enter tasks')).action(interactive);
+program.command('inspect <url>').option('--region <region>', 'Form id, tag or accessible region name').option('--level <n>', '1 overview, 2 controls, 3 component', '2').option('--screenshot <file>', 'Explicit local screenshot fallback').option('--accessibility', 'Show accessibility snapshot').option('--ultra', 'Skip the website access prompt').action(async (url, options) => {
+    const store = new TraceStore(':memory:'), agent = new Agent({ store, mode: options.ultra ? 'ultra' : 'normal', browser: { allowedOrigins: [new URL(url).origin] } });
+    connectEvents(agent, false);
+    try {
+        const state = await agent.open(url);
+        const scoped = options.region ? await agent.observer.inspect(agent.browser.page, options.region) : state;
+        console.log(agent.variables.redact(options.accessibility ? await agent.observer.accessibility(agent.browser.page) : agent.observer.compressor.compress(scoped, { level: z.coerce.number().int().min(1).max(3).parse(options.level) }).text));
+        if (options.screenshot) {
+            const file = resolve(options.screenshot);
+            await mkdir(join(file, '..'), { recursive: true });
+            await agent.browser.page.screenshot({ path: file });
+            console.log(`Saved local screenshot: ${file}`);
+        }
+    }
+    finally {
+        await agent.close();
+        store.close();
+    }
+});
+runFlags(program.command('replay <id>').option('--url <url>', 'Override starting URL')).action(async (id, options) => {
+    const config = runtimeConfig();
+    ensureDataDirectory(config.dataDir);
+    const lookup = new TraceStore(join(config.dataDir, 'history.sqlite'));
+    const trace = lookup.get(id);
+    lookup.close();
+    if (!trace)
+        throw new Error('Run not found');
+    const { agent, store } = await makeAgent(options.url ?? trace.url, options);
+    connectEvents(agent, !!options.debug);
+    try {
+        showTrace(await agent.replay(trace, options.url));
+    }
+    finally {
+        await agent.close();
+        store.close();
+    }
+});
+program.command('history').option('--limit <n>', 'Maximum rows', '30').action(options => { const config = runtimeConfig(); ensureDataDirectory(config.dataDir); const store = new TraceStore(join(config.dataDir, 'history.sqlite')); try {
+    console.log(new VariableResolver().redact(JSON.stringify(store.history(z.coerce.number().int().min(1).max(1000).parse(options.limit)), null, 2)));
+}
+finally {
+    store.close();
+} });
+program.command('workflows').option('--show <id>', 'Show a learned semantic workflow').action(options => { const config = runtimeConfig(); ensureDataDirectory(config.dataDir); const store = new TraceStore(join(config.dataDir, 'history.sqlite')); try {
+    const workflows = new WorkflowEngine(store);
+    console.log(JSON.stringify(options.show ? workflows.get(options.show) ?? 'Not found' : workflows.list(), null, 2));
+}
+finally {
+    store.close();
+} });
+program.command('config').option('--profile <file>', 'Import a profile/files JSON into the local vault').action(async (options) => {
+    const config = runtimeConfig();
+    ensureDataDirectory(config.dataDir);
+    const profile = new ProfileStore(join(config.dataDir, 'profile.json'));
+    if (options.profile) {
+        await profile.save(JSON.parse(await readFile(resolve(options.profile), 'utf8')));
+        console.log('Local profile imported (mode 0600).');
+    }
+    const vault = await profile.load();
+    console.log(JSON.stringify({ dataDir: config.dataDir, model: config.provider?.name ?? 'not configured', apiKeyConfigured: !!process.env.LLM_API_KEY, budget: config.budget.limits, profileAliases: Object.keys(vault.profile), fileAliases: Object.keys(vault.files) }, null, 2));
+});
+program.command('doctor').option('--api', 'Validate provider credentials or subscription login').action(async (options) => {
+    const config = runtimeConfig();
+    console.log(`Node ${process.version}; model ${config.provider?.name ?? 'not configured'}; data ${config.dataDir}`);
+    const browser = new Browser();
+    try {
+        await browser.launch();
+        console.log('Browser launch: passed');
+    }
+    finally {
+        await browser.close();
+    }
+    if (options.api) {
+        if (!config.provider)
+            throw new Error('No model provider configured; set LLM_API_KEY or sign in with a supported CLI subscription');
+        if (config.provider instanceof CodexSubscriptionProvider) {
+            const version = await config.provider.checkLogin();
+            console.log(`Codex ChatGPT login: passed (CLI ${version})`);
+            return;
+        }
+        if (config.provider instanceof ClaudeSubscriptionProvider) {
+            const version = await config.provider.checkLogin();
+            console.log(`Claude subscription login: passed (CLI ${version})`);
+            return;
+        }
+        if (config.provider instanceof FlashProvider) {
+            const anthropic = config.provider.config.protocol === 'anthropic';
+            const response = await fetch(config.provider.config.baseURL.replace(/\/$/, '') + '/models', { headers: anthropic ? { 'x-api-key': config.provider.config.key, 'anthropic-version': '2023-06-01' } : { Authorization: `Bearer ${config.provider.config.key}` }, signal: AbortSignal.timeout(15000), redirect: 'error' });
+            if (!response.ok)
+                throw new Error(`Provider models HTTP ${response.status}`);
+            const data = await response.json();
+            console.log('Provider models:', data.data?.map(m => m.id).join(', '));
+            if (!data.data?.some(m => m.id === config.provider.name))
+                throw new Error('Configured model is not advertised by this provider');
+        }
+    }
+});
+program.command('ui').option('--port <n>', 'Loopback web UI port', '4318').option('--headed', 'Show Chromium alongside preview').action(async (options) => {
+    const { startServer } = await import('../server/index.js');
+    await startServer({ port: z.coerce.number().int().min(0).max(65535).parse(options.port), headed: !!options.headed });
+});
+program.command('mcp').description('Start the local MCP server over stdio').action(async () => {
+    const { serveStdio } = await import('@modelcontextprotocol/server/stdio');
+    const { createMcpRuntime } = await import('../mcp/index.js');
+    const runtime = createMcpRuntime(), handle = serveStdio(runtime.createServer);
+    let closing = false;
+    const shutdown = () => { if (closing)
+        return; closing = true; void handle.close().finally(() => runtime.close()); };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    stdin.once('end', shutdown);
+});
+program.action(() => interactive());
+try {
+    await program.parseAsync();
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : 'Command failed';
+    console.error(message.replace(/sk-[a-zA-Z0-9_-]{16,}/g, '[redacted key]'));
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map