@dyyz1993/agent-browser 0.13.2 → 0.24.0

package/dist/flow/site-manager.js

@@ -0,0 +1,125 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'fs';
+import { join, resolve } from 'path';
+import yaml from 'js-yaml';
+import { parseYamlSiteFile, loadAllSites } from './yaml-parser.js';
+export class SiteManager {
+    sitesDirs;
+    constructor(sitesDirs) {
+        if (sitesDirs) {
+            this.sitesDirs = sitesDirs;
+        }
+        else {
+            this.sitesDirs = this.getDefaultDirs();
+        }
+    }
+    getDefaultDirs() {
+        const dirs = [];
+        const local = resolve(process.cwd(), 'sites');
+        if (existsSync(local))
+            dirs.push(local);
+        const home = resolve(process.env.HOME || process.env.USERPROFILE || '~', '.agent-browser', 'sites');
+        if (existsSync(home)) {
+            dirs.push(home);
+        }
+        else {
+            try {
+                mkdirSync(home, { recursive: true });
+                dirs.push(home);
+            }
+            catch { }
+        }
+        return dirs;
+    }
+    listSites() {
+        return loadAllSites();
+    }
+    getSite(name) {
+        const sites = this.listSites();
+        return sites.get(name) || null;
+    }
+    registerFromFile(filePath, name) {
+        const site = parseYamlSiteFile(filePath);
+        const targetDir = this.sitesDirs[0];
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+        }
+        const targetName = name || site.name;
+        const targetPath = join(targetDir, `${targetName}.yaml`);
+        const content = readFileSync(filePath, 'utf-8');
+        writeFileSync(targetPath, content, 'utf-8');
+        return { siteName: site.name, targetPath };
+    }
+    async registerFromUrl(url, name) {
+        const { fetch } = await import('undici');
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch site YAML from ${url}: ${response.status}`);
+        }
+        const content = await response.text();
+        const targetDir = this.sitesDirs[0] || '/tmp';
+        const tmpPath = join(targetDir, `_tmp_${Date.now()}.yaml`);
+        writeFileSync(tmpPath, content, 'utf-8');
+        let site;
+        try {
+            site = parseYamlSiteFile(tmpPath);
+        }
+        finally {
+            try {
+                unlinkSync(tmpPath);
+            }
+            catch { }
+        }
+        const finalTargetDir = this.sitesDirs[0];
+        if (!existsSync(finalTargetDir))
+            mkdirSync(finalTargetDir, { recursive: true });
+        const targetName = name || site.name;
+        const targetPath = join(finalTargetDir, `${targetName}.yaml`);
+        writeFileSync(targetPath, content, 'utf-8');
+        return { siteName: site.name, targetPath };
+    }
+    registerFromDefinition(site) {
+        const targetDir = this.sitesDirs[0];
+        if (!existsSync(targetDir))
+            mkdirSync(targetDir, { recursive: true });
+        const targetPath = join(targetDir, `${site.name}.yaml`);
+        const yamlContent = this.siteToYaml(site);
+        writeFileSync(targetPath, yamlContent, 'utf-8');
+        return { siteName: site.name, targetPath };
+    }
+    unregister(name) {
+        for (const dir of this.sitesDirs) {
+            const yamlPath = join(dir, `${name}.yaml`);
+            const ymlPath = join(dir, `${name}.yml`);
+            if (existsSync(yamlPath)) {
+                unlinkSync(yamlPath);
+                return true;
+            }
+            if (existsSync(ymlPath)) {
+                unlinkSync(ymlPath);
+                return true;
+            }
+        }
+        return false;
+    }
+    exists(name) {
+        for (const dir of this.sitesDirs) {
+            if (existsSync(join(dir, `${name}.yaml`)))
+                return true;
+            if (existsSync(join(dir, `${name}.yml`)))
+                return true;
+        }
+        return false;
+    }
+    siteToYaml(site) {
+        const yamlObj = {
+            site: {
+                name: site.name,
+                description: site.description,
+                baseUrl: site.baseUrl,
+            },
+            flows: site.flows,
+        };
+        return yaml.dump(yamlObj, { lineWidth: -1, noRefs: true });
+    }
+}
+//# sourceMappingURL=site-manager.js.map

package/dist/flow/site-manager.js.map

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

package/dist/flow/types.d.ts

@@ -0,0 +1,196 @@
+export type StepAction = 'navigate' | 'click' | 'fill' | 'press' | 'scroll' | 'snapshot' | 'screenshot' | 'eval' | 'wait' | 'extract' | 'paginate' | 'forEach' | 'condition' | 'scrollUntil' | 'clickPaginate' | 'forEachItem' | 'repeatWhile' | 'collectAll' | 'detectBlocking' | 'humanHelp' | 'waitForHuman' | 'autoRecover' | 'captureScript' | 'readCapture' | 'captureAPI' | 'readAPI' | 'interceptRoute' | 'removeRoute' | 'smartExtract' | 'formatOutput' | 'deduplicate';
+export interface BlockingCondition {
+    selector?: string;
+    jsExpression?: string;
+    hasDialog?: boolean;
+    urlPattern?: string;
+    textContains?: string;
+}
+export interface HumanIntervention {
+    message: string;
+    openViewer?: boolean;
+    screenshot?: boolean;
+    timeout?: number;
+    resolvedCondition?: BlockingCondition;
+    mode?: 'ask' | 'wait' | 'askAndWait';
+}
+export interface FlowParam {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'string[]';
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+}
+export interface ExtractField {
+    selector: string;
+    attribute?: string;
+}
+export interface LoopTermination {
+    maxIterations?: number;
+    noNewItemsCount?: number;
+    elementDisappears?: string;
+    elementDisabled?: string;
+    jsExpression?: string;
+}
+export interface FlowStep {
+    id: string;
+    action: StepAction;
+    selector?: string;
+    value?: string;
+    url?: string;
+    waitAfter?: string;
+    timeout?: number;
+    container?: string;
+    fields?: Record<string, string | ExtractField>;
+    outputVar?: string;
+    maxPages?: number | string;
+    nextSelector?: string;
+    strategy?: 'click' | 'url';
+    onEachPage?: FlowStep[];
+    sourceVar?: string;
+    subSteps?: FlowStep[];
+    condition?: string;
+    thenSteps?: FlowStep[];
+    elseSteps?: FlowStep[];
+    inFrame?: string;
+    termination?: LoopTermination;
+    scrollDirection?: 'down' | 'up';
+    scrollAmount?: number;
+    scrollContainer?: string;
+    extractOnEachScroll?: FlowStep;
+    waitForNavigation?: 'load' | 'networkidle' | 'domcontentloaded';
+    extractBeforeClick?: FlowStep;
+    itemSelector?: string;
+    itemSteps?: FlowStep[];
+    conditionJs?: string;
+    loopSteps?: FlowStep[];
+    dedupField?: string;
+    collectSteps?: FlowStep[];
+    blockingConditions?: BlockingCondition[];
+    intervention?: HumanIntervention;
+    checkInterval?: number;
+    resolveTimeout?: number;
+    onResolved?: FlowStep[];
+    onTimeout?: FlowStep[];
+    file?: string;
+    captureFilter?: string;
+    apiUrl?: string;
+    mockResponse?: string;
+    mockStatus?: number;
+    abortRequests?: boolean;
+    preset?: string;
+    outputFormat?: string;
+    pretty?: boolean;
+    smartExtractConfig?: {
+        container?: string;
+        fields?: Record<string, string | {
+            selector: string;
+            attribute?: string;
+        }>;
+        apiUrl?: string;
+        apiFilter?: string;
+        scriptFilter?: string;
+        preferLayer?: 'api' | 'script' | 'dom';
+        minResults?: number;
+    };
+    fallbackSelectors?: string[];
+    elementIdentity?: {
+        tagName: string;
+        textContent: string;
+        attributes: Record<string, string>;
+        classes: string[];
+        boundingRect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        parentSignature: string;
+    };
+    waitCondition?: 'url_change' | 'dom_stable';
+    waitUrlPattern?: string;
+    waitDomStableTimeout?: number;
+    retry?: {
+        maxAttempts: number;
+        delayMs: number;
+        strategy: 'fixed' | 'exponential';
+    };
+    checkpoint?: StateCheckpoint;
+    environment?: {
+        urlPattern?: string;
+        pageTitle?: string;
+        waitDomStable?: boolean;
+        domStableTimeout?: number;
+    };
+}
+export type HealingStrategy = 'fallback' | 'identity_text' | 'identity_attr' | 'identity_parent';
+export interface HealingConfig {
+    enabled?: boolean;
+    strategies?: HealingStrategy[];
+    maxAttempts?: number;
+    attemptDelayMs?: number;
+}
+export interface RetryConfig {
+    maxAttempts?: number;
+    delayMs?: number;
+    strategy?: 'fixed' | 'exponential';
+    backoffMultiplier?: number;
+}
+export interface FlowDefinition {
+    id: string;
+    description?: string;
+    params?: FlowParam[];
+    steps: FlowStep[];
+    output?: string[];
+    healing?: HealingConfig;
+    retry?: RetryConfig;
+}
+export interface SiteDefinition {
+    name: string;
+    description?: string;
+    baseUrl?: string;
+    flows: Record<string, FlowDefinition>;
+}
+export interface FlowContext {
+    variables: Record<string, unknown>;
+    params: Record<string, unknown>;
+    results: Record<string, unknown>;
+    pageCount: number;
+    currentPage: number;
+}
+export interface StateCheckpointElementCheck {
+    selector: string;
+    exists: boolean;
+    visible?: boolean;
+    textContent?: string;
+}
+export interface StateCheckpoint {
+    urlPattern?: string;
+    elementChecks?: StateCheckpointElementCheck[];
+    contentHash?: string;
+}
+export interface CheckpointResult {
+    stepId: string;
+    passed: boolean;
+    failures: string[];
+}
+export interface HealingLogEntry {
+    stepId: string;
+    originalSelector: string;
+    healedSelector: string;
+    strategy: string;
+}
+export interface FlowResult {
+    success: boolean;
+    site: string;
+    flow: string;
+    data: Record<string, unknown>;
+    errors: Array<{
+        step: string;
+        error: string;
+    }>;
+    duration: number;
+    healingLog?: HealingLogEntry[];
+    checkpointResults?: CheckpointResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flow/types.d.ts.map

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

package/dist/flow/types.js

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

package/dist/flow/types.js.map

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

package/dist/flow/yaml-parser.d.ts

@@ -0,0 +1,15 @@
+import type { SiteDefinition, FlowDefinition } from './types.js';
+export declare function parseYamlSiteFile(filePath: string): SiteDefinition;
+export declare function loadSitesFromDirectory(dirPath: string): Map<string, SiteDefinition>;
+export declare function getDefaultSitesDirs(): string[];
+export declare function loadAllSites(): Map<string, SiteDefinition>;
+export declare function findFlow(sites: Map<string, SiteDefinition>, siteFlowRef: string): {
+    site: SiteDefinition;
+    flowName: string;
+    flow: FlowDefinition;
+} | null;
+export declare function validateYamlFile(filePath: string): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=yaml-parser.d.ts.map

package/dist/flow/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/flow/yaml-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAOf,MAAM,YAAY,CAAC;AA+FpB,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA0BlE;AAmGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAqBnF;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAc9C;AAED,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAW1D;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAClC,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAmBzE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCvF"}

package/dist/flow/yaml-parser.js

@@ -0,0 +1,216 @@
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+import yaml from 'js-yaml';
+export function parseYamlSiteFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const parsed = yaml.load(content);
+    if (!parsed.site) {
+        throw new Error(`Invalid site YAML: missing "site" root key in ${filePath}`);
+    }
+    const site = parsed.site;
+    if (!site.name) {
+        throw new Error(`Invalid site YAML: missing "site.name" in ${filePath}`);
+    }
+    const flows = {};
+    if (parsed.flows) {
+        for (const [flowName, yamlFlow] of Object.entries(parsed.flows)) {
+            flows[flowName] = parseYamlFlow(flowName, yamlFlow);
+        }
+    }
+    return {
+        name: site.name,
+        description: site.description,
+        baseUrl: site.baseUrl,
+        flows,
+    };
+}
+function parseYamlFlow(name, yamlFlow) {
+    return {
+        id: name,
+        description: yamlFlow.description,
+        params: yamlFlow.params?.map(parseYamlParam),
+        steps: yamlFlow.steps?.map(parseYamlStep) || [],
+        output: yamlFlow.output,
+        healing: yamlFlow.healing,
+        retry: yamlFlow.retry,
+    };
+}
+function parseYamlParam(yamlParam) {
+    return {
+        name: yamlParam.name,
+        type: yamlParam.type || 'string',
+        required: yamlParam.required,
+        default: yamlParam.default,
+        description: yamlParam.description,
+    };
+}
+function parseYamlStep(yamlStep) {
+    const step = {
+        id: yamlStep.id,
+        action: yamlStep.action,
+    };
+    const simpleFields = [
+        'selector',
+        'value',
+        'url',
+        'waitAfter',
+        'timeout',
+        'inFrame',
+        'container',
+        'outputVar',
+        'nextSelector',
+        'strategy',
+        'maxPages',
+        'itemSelector',
+        'condition',
+        'conditionJs',
+        'apiUrl',
+        'captureFilter',
+        'file',
+        'mockResponse',
+        'mockStatus',
+        'abortRequests',
+        'scrollDirection',
+        'scrollAmount',
+        'scrollContainer',
+        'checkInterval',
+        'resolveTimeout',
+        'waitForNavigation',
+        'sourceVar',
+        'dedupField',
+    ];
+    for (const field of simpleFields) {
+        if (yamlStep[field] !== undefined) {
+            step[field] = yamlStep[field];
+        }
+    }
+    if (yamlStep.fields) {
+        step.fields = yamlStep.fields;
+    }
+    if (yamlStep.termination) {
+        step.termination = yamlStep.termination;
+    }
+    if (yamlStep.itemSteps)
+        step.itemSteps = yamlStep.itemSteps.map(parseYamlStep);
+    if (yamlStep.loopSteps)
+        step.loopSteps = yamlStep.loopSteps.map(parseYamlStep);
+    if (yamlStep.collectSteps)
+        step.collectSteps = yamlStep.collectSteps.map(parseYamlStep);
+    if (yamlStep.thenSteps)
+        step.thenSteps = yamlStep.thenSteps.map(parseYamlStep);
+    if (yamlStep.elseSteps)
+        step.elseSteps = yamlStep.elseSteps.map(parseYamlStep);
+    if (yamlStep.subSteps)
+        step.subSteps = yamlStep.subSteps.map(parseYamlStep);
+    if (yamlStep.extractOnEachScroll)
+        step.extractOnEachScroll = parseYamlStep(yamlStep.extractOnEachScroll);
+    if (yamlStep.extractBeforeClick)
+        step.extractBeforeClick = parseYamlStep(yamlStep.extractBeforeClick);
+    if (yamlStep.onResolved)
+        step.onResolved = yamlStep.onResolved.map(parseYamlStep);
+    if (yamlStep.onTimeout)
+        step.onTimeout = yamlStep.onTimeout.map(parseYamlStep);
+    if (yamlStep.blockingConditions) {
+        step.blockingConditions = yamlStep.blockingConditions;
+    }
+    if (yamlStep.intervention) {
+        step.intervention = yamlStep.intervention;
+    }
+    return step;
+}
+export function loadSitesFromDirectory(dirPath) {
+    const sites = new Map();
+    if (!existsSync(dirPath)) {
+        return sites;
+    }
+    const entries = readdirSync(dirPath);
+    for (const entry of entries) {
+        if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {
+            const filePath = join(dirPath, entry);
+            try {
+                const site = parseYamlSiteFile(filePath);
+                sites.set(site.name, site);
+            }
+            catch (e) {
+                console.warn(`Failed to parse site file ${filePath}: ${e}`);
+            }
+        }
+    }
+    return sites;
+}
+export function getDefaultSitesDirs() {
+    const dirs = [];
+    const localDir = resolve(process.cwd(), 'sites');
+    if (existsSync(localDir))
+        dirs.push(localDir);
+    const homeDir = resolve(process.env.HOME || process.env.USERPROFILE || '~', '.agent-browser', 'sites');
+    if (existsSync(homeDir))
+        dirs.push(homeDir);
+    return dirs;
+}
+export function loadAllSites() {
+    const allSites = new Map();
+    for (const dir of getDefaultSitesDirs()) {
+        const sites = loadSitesFromDirectory(dir);
+        for (const [name, site] of sites) {
+            allSites.set(name, site);
+        }
+    }
+    return allSites;
+}
+export function findFlow(sites, siteFlowRef) {
+    const dotIndex = siteFlowRef.indexOf('.');
+    if (dotIndex > 0) {
+        const siteName = siteFlowRef.substring(0, dotIndex);
+        const flowName = siteFlowRef.substring(dotIndex + 1);
+        const site = sites.get(siteName);
+        if (site && site.flows[flowName]) {
+            return { site, flowName, flow: site.flows[flowName] };
+        }
+    }
+    else {
+        for (const [, site] of sites) {
+            if (site.flows[siteFlowRef]) {
+                return { site, flowName: siteFlowRef, flow: site.flows[siteFlowRef] };
+            }
+        }
+    }
+    return null;
+}
+export function validateYamlFile(filePath) {
+    const errors = [];
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const parsed = yaml.load(content);
+        if (!parsed.site) {
+            errors.push('Missing "site" root key');
+            return { valid: false, errors };
+        }
+        if (!parsed.site.name) {
+            errors.push('Missing "site.name"');
+        }
+        if (!parsed.flows || Object.keys(parsed.flows).length === 0) {
+            errors.push('No flows defined');
+        }
+        else {
+            for (const [flowName, flow] of Object.entries(parsed.flows)) {
+                if (!flow.steps || flow.steps.length === 0) {
+                    errors.push(`Flow "${flowName}" has no steps`);
+                }
+                for (const step of flow.steps || []) {
+                    if (!step.id) {
+                        errors.push(`Flow "${flowName}" has a step without an id`);
+                    }
+                    if (!step.action) {
+                        errors.push(`Flow "${flowName}" step "${step.id || '?'}" has no action`);
+                    }
+                }
+            }
+        }
+    }
+    catch (e) {
+        errors.push(`YAML parse error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=yaml-parser.js.map

package/dist/flow/yaml-parser.js.map

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

package/dist/human-mouse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"human-mouse.d.ts","sourceRoot":"","sources":["../src/human-mouse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AA0JD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,iBAE3E;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,iBAK5E;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxE,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAanD"}
+{"version":3,"file":"human-mouse.d.ts","sourceRoot":"","sources":["../src/human-mouse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AA0JD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxE,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAanD"}

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAymCrE,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAwBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAI7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE5D"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AA8mCrE,MAAM,MAAM,WAAW,GACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAwBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAI7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE5D"}

package/dist/protocol.js

@@ -645,15 +645,6 @@ const inputTextSchema = z.object({
 const inputBlurSchema = z.object({
     type: z.literal('input_blur'),
 });
-// iOS-specific schemas
-const swipeSchema = baseCommandSchema.extend({
-    action: z.literal('swipe'),
-    direction: z.enum(['up', 'down', 'left', 'right']),
-    distance: z.number().positive().optional(),
-});
-const deviceListSchema = baseCommandSchema.extend({
-    action: z.literal('device_list'),
-});
 const viewerSchema = baseCommandSchema.extend({
     action: z.literal('viewer'),
 });
@@ -696,6 +687,18 @@ const historySchema = baseCommandSchema.extend({
     clear: z.boolean().optional(),
     filter: z.string().optional(),
 });
+const selectorForSchema = baseCommandSchema.extend({
+    action: z.literal('selector-for'),
+    target: z.string().min(1),
+});
+const selectorsOfSchema = baseCommandSchema.extend({
+    action: z.literal('selectors-of'),
+    target: z.string().min(1),
+});
+const validateSchema = baseCommandSchema.extend({
+    action: z.literal('validate'),
+    target: z.string().min(1),
+});
 const evaluateSchema = baseCommandSchema.extend({
     action: z.literal('evaluate'),
     script: z.string().min(1).optional(),
@@ -893,12 +896,13 @@ const commandSchema = z.discriminatedUnion('action', [
     inputMouseSchema,
     inputKeyboardSchema,
     inputTouchSchema,
-    swipeSchema,
-    deviceListSchema,
     viewerSchema,
     askSchema,
     configSchema,
     historySchema,
+    selectorForSchema,
+    selectorsOfSchema,
+    validateSchema,
 ]);
 /**
  * Parse a JSON string into a validated command