@epsilon-asi/actors 0.0.22 → 0.0.32

package/dist/native/nut/NutNativeKeyboardDriver.d.ts

@@ -0,0 +1,8 @@
+import type { NativeKeyboardDriver } from '../drivers.js';
+export declare class NutNativeKeyboardDriver implements NativeKeyboardDriver {
+    type(text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    pressShortcut(keys: readonly string[]): Promise<void>;
+    private resolveKey;
+}
+//# sourceMappingURL=NutNativeKeyboardDriver.d.ts.map

package/dist/native/nut/NutNativeKeyboardDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeKeyboardDriver.d.ts","sourceRoot":"","sources":["../../../src/native/nut/NutNativeKeyboardDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAc1D,qBAAa,uBAAwB,YAAW,oBAAoB;IAC5D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,OAAO,CAAC,UAAU;CAGnB"}

package/dist/native/nut/NutNativeKeyboardDriver.js

@@ -0,0 +1,39 @@
+import { loadNut } from './loadNut.js';
+function keyName(key) {
+    const normalized = key.toLowerCase();
+    if (normalized === 'enter' || normalized === 'return')
+        return 'ENTER';
+    if (normalized === 'escape' || normalized === 'esc')
+        return 'ESCAPE';
+    if (normalized === 'meta' || normalized === 'command' || normalized === 'cmd')
+        return 'LEFT_META';
+    if (normalized === 'control' || normalized === 'ctrl')
+        return 'LEFT_CONTROL';
+    if (normalized === 'shift')
+        return 'LEFT_SHIFT';
+    if (normalized === 'alt' || normalized === 'option')
+        return 'LEFT_ALT';
+    return key.toUpperCase();
+}
+export class NutNativeKeyboardDriver {
+    async type(text) {
+        const nut = await loadNut();
+        await nut.keyboard.type(text);
+    }
+    async pressKey(key) {
+        const nut = await loadNut();
+        await nut.keyboard.pressKey(this.resolveKey(nut.Key, key));
+    }
+    async pressShortcut(keys) {
+        const nut = await loadNut();
+        const resolved = keys.map(key => this.resolveKey(nut.Key, key));
+        await nut.keyboard.pressKey(...resolved);
+        if (nut.keyboard.releaseKey !== undefined) {
+            await nut.keyboard.releaseKey(...resolved.slice().reverse());
+        }
+    }
+    resolveKey(keyMap, key) {
+        return keyMap?.[keyName(key)] ?? key;
+    }
+}
+//# sourceMappingURL=NutNativeKeyboardDriver.js.map

package/dist/native/nut/NutNativeKeyboardDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeKeyboardDriver.js","sourceRoot":"","sources":["../../../src/native/nut/NutNativeKeyboardDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IACtE,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IACrE,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC;IAClG,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,cAAc,CAAC;IAC7E,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IAChD,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC;IACvE,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAuB;QACzC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;QACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,MAA2C,EAAE,GAAW;QACzE,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;IACvC,CAAC;CACF"}

package/dist/native/nut/NutNativeMouseDriver.d.ts

@@ -0,0 +1,8 @@
+import type { NativeMouseDriver } from '../drivers.js';
+import type { NativeMouseButton, NativePoint } from '../types.js';
+export declare class NutNativeMouseDriver implements NativeMouseDriver {
+    getPosition(): Promise<NativePoint>;
+    move(point: NativePoint): Promise<void>;
+    click(button: NativeMouseButton): Promise<void>;
+}
+//# sourceMappingURL=NutNativeMouseDriver.d.ts.map

package/dist/native/nut/NutNativeMouseDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeMouseDriver.d.ts","sourceRoot":"","sources":["../../../src/native/nut/NutNativeMouseDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AASlE,qBAAa,oBAAqB,YAAW,iBAAiB;IACtD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKnC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtD"}

package/dist/native/nut/NutNativeMouseDriver.js

@@ -0,0 +1,24 @@
+import { loadNut } from './loadNut.js';
+function buttonName(button) {
+    if (button === 'left')
+        return 'LEFT';
+    if (button === 'right')
+        return 'RIGHT';
+    return 'MIDDLE';
+}
+export class NutNativeMouseDriver {
+    async getPosition() {
+        const nut = await loadNut();
+        return nut.mouse.getPosition();
+    }
+    async move(point) {
+        const nut = await loadNut();
+        await nut.mouse.move(nut.straightTo({ x: point.x, y: point.y }));
+    }
+    async click(button) {
+        const nut = await loadNut();
+        const nutButton = nut.Button?.[buttonName(button)] ?? button;
+        await nut.mouse.click(nutButton);
+    }
+}
+//# sourceMappingURL=NutNativeMouseDriver.js.map

package/dist/native/nut/NutNativeMouseDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeMouseDriver.js","sourceRoot":"","sources":["../../../src/native/nut/NutNativeMouseDriver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,SAAS,UAAU,CAAC,MAAyB;IAC3C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrC,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,oBAAoB;IAC/B,KAAK,CAAC,WAAW;QACf,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAyB;QACnC,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC;QAC7D,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/native/nut/NutNativeScreenDriver.d.ts

@@ -0,0 +1,6 @@
+import type { NativeScreenDriver } from '../drivers.js';
+export declare class NutNativeScreenDriver implements NativeScreenDriver {
+    width(): Promise<number>;
+    height(): Promise<number>;
+}
+//# sourceMappingURL=NutNativeScreenDriver.d.ts.map

package/dist/native/nut/NutNativeScreenDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeScreenDriver.d.ts","sourceRoot":"","sources":["../../../src/native/nut/NutNativeScreenDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,qBAAa,qBAAsB,YAAW,kBAAkB;IACxD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAIhC"}

package/dist/native/nut/NutNativeScreenDriver.js

@@ -0,0 +1,12 @@
+import { loadNut } from './loadNut.js';
+export class NutNativeScreenDriver {
+    async width() {
+        const nut = await loadNut();
+        return nut.screen.width();
+    }
+    async height() {
+        const nut = await loadNut();
+        return nut.screen.height();
+    }
+}
+//# sourceMappingURL=NutNativeScreenDriver.js.map

package/dist/native/nut/NutNativeScreenDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeScreenDriver.js","sourceRoot":"","sources":["../../../src/native/nut/NutNativeScreenDriver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,qBAAqB;IAChC,KAAK,CAAC,KAAK;QACT,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/native/nut/NutNativeWindowDriver.d.ts

@@ -0,0 +1,6 @@
+import type { NativeWindowDriver, NativeWindowHandle } from '../drivers.js';
+export declare class NutNativeWindowDriver implements NativeWindowDriver {
+    list(): Promise<NativeWindowHandle[]>;
+    active(): Promise<NativeWindowHandle | null>;
+}
+//# sourceMappingURL=NutNativeWindowDriver.d.ts.map

package/dist/native/nut/NutNativeWindowDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeWindowDriver.d.ts","sourceRoot":"","sources":["../../../src/native/nut/NutNativeWindowDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAgD5E,qBAAa,qBAAsB,YAAW,kBAAkB;IACxD,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAMrC,MAAM,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAKnD"}

package/dist/native/nut/NutNativeWindowDriver.js

@@ -0,0 +1,53 @@
+import { loadNut } from './loadNut.js';
+function toRegion(region) {
+    return {
+        x: region.left ?? region.x ?? 0,
+        y: region.top ?? region.y ?? 0,
+        width: region.width,
+        height: region.height
+    };
+}
+class NutNativeWindowHandle {
+    window;
+    constructor(window) {
+        this.window = window;
+    }
+    async info() {
+        const [title, region] = await Promise.all([
+            Promise.resolve(this.window.title),
+            Promise.resolve(this.window.region)
+        ]);
+        return {
+            title,
+            region: toRegion(region)
+        };
+    }
+    async focus() {
+        await this.window.focus();
+    }
+    async minimize() {
+        await this.window.minimize();
+    }
+    async restore() {
+        await this.window.restore();
+    }
+    async move(point) {
+        await this.window.move({ x: point.x, y: point.y });
+    }
+    async resize(size) {
+        await this.window.resize(size);
+    }
+}
+export class NutNativeWindowDriver {
+    async list() {
+        const nut = await loadNut();
+        const windows = await nut.getWindows();
+        return windows.map(window => new NutNativeWindowHandle(window));
+    }
+    async active() {
+        const nut = await loadNut();
+        const window = await nut.getActiveWindow();
+        return new NutNativeWindowHandle(window);
+    }
+}
+//# sourceMappingURL=NutNativeWindowDriver.js.map

package/dist/native/nut/NutNativeWindowDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NutNativeWindowDriver.js","sourceRoot":"","sources":["../../../src/native/nut/NutNativeWindowDriver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkC,MAAM,cAAc,CAAC;AAEvE,SAAS,QAAQ,CAAC,MAAiB;IACjC,OAAO;QACL,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC;QAC/B,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB;IACI;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD,KAAK,CAAC,IAAI;QACR,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAClC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QACH,OAAO;YACL,KAAK;YACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAgB;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAChC,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3C,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/native/nut/loadNut.d.ts

@@ -0,0 +1,58 @@
+export interface NutPoint {
+    x: number;
+    y: number;
+}
+export interface NutRegion {
+    left?: number;
+    top?: number;
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+}
+export interface NutWindow {
+    title: Promise<string> | string;
+    region: Promise<NutRegion> | NutRegion;
+    focus(): Promise<void>;
+    minimize(): Promise<void>;
+    restore(): Promise<void>;
+    move(point: NutPoint): Promise<void>;
+    resize(size: {
+        width: number;
+        height: number;
+    }): Promise<void>;
+}
+export interface NutModule {
+    mouse: {
+        getPosition(): Promise<NutPoint>;
+        move(path: unknown): Promise<void>;
+        click(button: unknown): Promise<void>;
+    };
+    keyboard: {
+        type(text: string): Promise<void>;
+        pressKey(...keys: unknown[]): Promise<void>;
+        releaseKey?(...keys: unknown[]): Promise<void>;
+    };
+    screen: {
+        width(): Promise<number>;
+        height(): Promise<number>;
+        find?(resource: unknown, options?: unknown): Promise<NutRegion>;
+        waitFor?(resource: unknown, timeoutMs?: number, intervalMs?: number): Promise<NutRegion>;
+        config?: {
+            confidence?: number;
+            resourceDirectory?: string;
+        };
+    };
+    getWindows(): Promise<NutWindow[]>;
+    getActiveWindow(): Promise<NutWindow>;
+    straightTo(point: NutPoint): unknown;
+    imageResource?(path: string): unknown;
+    Button?: Record<string, unknown>;
+    Key?: Record<string, unknown>;
+}
+export interface NlMatcherModule {
+    useNlMatcher(): void;
+}
+export declare function loadNut(): Promise<NutModule>;
+export declare function loadNlMatcher(): Promise<void>;
+//# sourceMappingURL=loadNut.d.ts.map

package/dist/native/nut/loadNut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadNut.d.ts","sourceRoot":"","sources":["../../../src/native/nut/loadNut.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE;QACL,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACvC,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAChD,CAAC;IACF,MAAM,EAAE;QACN,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACzF,MAAM,CAAC,EAAE;YACP,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,CAAC;IACF,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,IAAI,IAAI,CAAC;CACtB;AAKD,wBAAsB,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAQlD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CASnD"}

package/dist/native/nut/loadNut.js

@@ -0,0 +1,25 @@
+import { NativeDependencyError } from '../errors.js';
+const dynamicImport = new Function('specifier', 'return import(specifier)');
+let nutModulePromise = null;
+let nlMatcherLoaded = false;
+export async function loadNut() {
+    nutModulePromise ??= dynamicImport('@nut-tree/nut-js')
+        .then(module => module)
+        .catch(error => {
+        nutModulePromise = null;
+        throw new NativeDependencyError('@nut-tree/nut-js', error);
+    });
+    return nutModulePromise;
+}
+export async function loadNlMatcher() {
+    if (nlMatcherLoaded)
+        return;
+    const module = await dynamicImport('@nut-tree/nl-matcher')
+        .then(value => value)
+        .catch(error => {
+        throw new NativeDependencyError('@nut-tree/nl-matcher', error);
+    });
+    module.useNlMatcher();
+    nlMatcherLoaded = true;
+}
+//# sourceMappingURL=loadNut.js.map

package/dist/native/nut/loadNut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadNut.js","sourceRoot":"","sources":["../../../src/native/nut/loadNut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIrD,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAkB,CAAC;AA2D7F,IAAI,gBAAgB,GAA8B,IAAI,CAAC;AACvD,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,gBAAgB,KAAK,aAAa,CAAC,kBAAkB,CAAC;SACnD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAmB,CAAC;SACnC,KAAK,CAAC,KAAK,CAAC,EAAE;QACb,gBAAgB,GAAG,IAAI,CAAC;QACxB,MAAM,IAAI,qBAAqB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IACL,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,eAAe;QAAE,OAAO;IAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,sBAAsB,CAAC;SACvD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAwB,CAAC;SACvC,KAAK,CAAC,KAAK,CAAC,EAAE;QACb,MAAM,IAAI,qBAAqB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IACL,MAAM,CAAC,YAAY,EAAE,CAAC;IACtB,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC"}

package/dist/native/types.d.ts

@@ -0,0 +1,194 @@
+import type { BrowserSession } from '../browser/BrowserSession.js';
+import type { PageLike } from '../browser/PuppeteerLike.js';
+import type { RuntimeConfig } from '../browser/RuntimeConfig.js';
+import type { Logger } from '../logging/Logger.js';
+export type NativePlatform = 'macos';
+export type NativeMouseButton = 'left' | 'right' | 'middle';
+export type NativeFileDialogStrategy = 'auto' | 'applescript' | 'visual' | 'keyboard';
+export type NativeWindowControlStrategy = 'auto' | 'accessibility' | 'visual';
+export interface NativePoint {
+    x: number;
+    y: number;
+}
+export interface ScreenPoint extends NativePoint {
+}
+export interface BrowserPoint extends NativePoint {
+}
+export interface NativeSize {
+    width: number;
+    height: number;
+}
+export interface NativeRegion extends NativePoint, NativeSize {
+}
+export interface WaitOptions {
+    timeoutMs?: number;
+    intervalMs?: number;
+}
+export interface WindowMatcher {
+    appName?: string;
+    title?: string;
+    titleIncludes?: string;
+    titleRegex?: RegExp | string;
+    bundleId?: string;
+    role?: string;
+}
+export interface NativeWindowInfo {
+    id?: string | number;
+    title: string;
+    appName?: string;
+    bundleId?: string;
+    role?: string;
+    region: NativeRegion;
+    isFocused?: boolean;
+    isMinimized?: boolean;
+    isFullscreen?: boolean;
+}
+export interface EnsureWindowInViewOptions extends WaitOptions {
+    restore?: boolean;
+    focus?: boolean;
+    moveIntoPrimaryDisplay?: boolean;
+    minimumVisibleWidth?: number;
+    minimumVisibleHeight?: number;
+}
+export interface WindowButtonOptions extends WaitOptions {
+    strategy?: NativeWindowControlStrategy;
+    fullscreenButtonTemplate?: string;
+    searchRegionPaddingPx?: number;
+}
+export interface SelectFileOptions extends WaitOptions {
+    appName?: string;
+    dialogTitle?: string;
+    openButtonTemplate?: string;
+    inputFieldTemplate?: string;
+    strategy?: NativeFileDialogStrategy;
+    clickOpen?: boolean;
+}
+export interface NativeMouseMoveOptions {
+    precise?: boolean;
+    jitterPixels?: number;
+    minJitterPixels?: number;
+    moveSpeed?: number;
+    disableHumanPath?: boolean;
+}
+export interface NativeMouseClickOptions extends NativeMouseMoveOptions {
+    button?: NativeMouseButton;
+    delayBeforeClickMs?: number;
+    delayAfterMoveMs?: number;
+    regionPaddingPx?: number;
+}
+export interface NativeKeyboardTypeOptions {
+    delayMs?: number;
+}
+export interface NativeKeyboard {
+    type(text: string, options?: NativeKeyboardTypeOptions): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    pressShortcut(keys: readonly string[]): Promise<void>;
+}
+export interface NativeMouse {
+    moveTo(point: ScreenPoint, options?: NativeMouseMoveOptions): Promise<void>;
+    click(point: ScreenPoint, options?: NativeMouseClickOptions): Promise<void>;
+    clickRegion(region: NativeRegion, options?: NativeMouseClickOptions): Promise<void>;
+    clickBrowserPoint(page: PageLike, point: BrowserPoint, options?: NativeMouseClickOptions): Promise<void>;
+}
+export interface NativeTemplateRef {
+    name: string;
+    buffer?: Uint8Array;
+}
+export interface NativeImageSearchOptions extends WaitOptions {
+    searchRegion?: NativeRegion;
+    confidence?: number;
+}
+export interface NativeImageMatch {
+    region: NativeRegion;
+    confidence?: number;
+}
+export interface NativeImageFinder {
+    findTemplate(template: string | NativeTemplateRef, options?: NativeImageSearchOptions): Promise<NativeImageMatch | null>;
+    waitForTemplate(template: string | NativeTemplateRef, options?: NativeImageSearchOptions): Promise<NativeImageMatch>;
+}
+export interface NativeWindowService {
+    list(): Promise<NativeWindowInfo[]>;
+    find(matcher: WindowMatcher, options?: WaitOptions): Promise<NativeWindowInfo | null>;
+    waitFor(matcher: WindowMatcher, options?: WaitOptions): Promise<NativeWindowInfo>;
+    isOpen(matcher: WindowMatcher): Promise<boolean>;
+    focus(matcher: WindowMatcher): Promise<NativeWindowInfo>;
+    ensureInView(matcher: WindowMatcher, options?: EnsureWindowInViewOptions): Promise<NativeWindowInfo>;
+    setFullscreen(matcher: WindowMatcher, fullscreen: boolean, options?: WindowButtonOptions): Promise<void>;
+    toggleFullscreen(matcher: WindowMatcher, options?: WindowButtonOptions): Promise<void>;
+    minimize(matcher: WindowMatcher): Promise<void>;
+    restore(matcher: WindowMatcher): Promise<void>;
+}
+export interface NativeFileDialogService {
+    selectFile(filePath: string, options?: SelectFileOptions): Promise<void>;
+}
+export interface BrowserViewportSnapshot {
+    screenX: number;
+    screenY: number;
+    outerWidth: number;
+    outerHeight: number;
+    innerWidth: number;
+    innerHeight: number;
+    devicePixelRatio: number;
+}
+export interface CoordinateTransform {
+    offsetX: number;
+    offsetY: number;
+    scaleX: number;
+    scaleY: number;
+    calibratedAt: number;
+    viewport: Pick<BrowserViewportSnapshot, 'innerWidth' | 'innerHeight' | 'devicePixelRatio'>;
+    window?: NativeWindowInfo;
+}
+export interface CalibrationOptions extends WaitOptions {
+    markerSizePx?: number;
+    markerA?: BrowserPoint;
+    markerB?: BrowserPoint;
+    cacheTtlMs?: number;
+    windowMatcher?: WindowMatcher;
+}
+export interface CoordinateMapOptions {
+    page?: PageLike;
+    useCache?: boolean;
+}
+export interface NativeCoordinateMapper {
+    calibrate(page: PageLike, options?: CalibrationOptions): Promise<CoordinateTransform>;
+    browserToScreen(point: BrowserPoint, options?: CoordinateMapOptions): Promise<ScreenPoint>;
+    screenToBrowser(point: ScreenPoint, options?: CoordinateMapOptions): Promise<BrowserPoint>;
+    invalidate(): void;
+}
+export interface NativeActionContext {
+    automation: NativeAutomation;
+    logger: Logger;
+}
+export interface NativeAction<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description?: string;
+    run(context: NativeActionContext, input: TInput): Promise<TOutput>;
+}
+export interface NativeActionMetadata {
+    name: string;
+    description?: string;
+}
+export interface NativeActionRegistry {
+    register<TInput, TOutput>(action: NativeAction<TInput, TOutput>): this;
+    get<TInput = unknown, TOutput = unknown>(name: string): NativeAction<TInput, TOutput>;
+    run<TInput = unknown, TOutput = unknown>(name: string, input: TInput): Promise<TOutput>;
+    list(): NativeActionMetadata[];
+}
+export interface NativeAutomation {
+    windows: NativeWindowService;
+    fileDialogs: NativeFileDialogService;
+    mouse: NativeMouse;
+    keyboard: NativeKeyboard;
+    coordinates: NativeCoordinateMapper;
+    images: NativeImageFinder;
+    actions: NativeActionRegistry;
+}
+export interface NativeAutomationFactoryArgs {
+    session: BrowserSession;
+    page: PageLike;
+    config: RuntimeConfig;
+    logger: Logger;
+}
+export type NativeAutomationFactory = (args: NativeAutomationFactoryArgs) => NativeAutomation;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/native/types.js

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

package/dist/native/types.js.map

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

package/dist/native/utils/appleScriptEscape.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Escapes arbitrary text for use as an AppleScript string literal.
+ * AppleScript string literals are double-quoted and escape double quotes/backslashes.
+ */
+export declare function appleScriptString(value: string): string;
+export declare function appleScriptRegexLiteral(value: RegExp | string): string;
+//# sourceMappingURL=appleScriptEscape.d.ts.map

package/dist/native/utils/appleScriptEscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appleScriptEscape.d.ts","sourceRoot":"","sources":["../../../src/native/utils/appleScriptEscape.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtE"}

package/dist/native/utils/appleScriptEscape.js

@@ -0,0 +1,11 @@
+/**
+ * Escapes arbitrary text for use as an AppleScript string literal.
+ * AppleScript string literals are double-quoted and escape double quotes/backslashes.
+ */
+export function appleScriptString(value) {
+    return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+export function appleScriptRegexLiteral(value) {
+    return value instanceof RegExp ? value.source : value;
+}
+//# sourceMappingURL=appleScriptEscape.js.map

package/dist/native/utils/appleScriptEscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appleScriptEscape.js","sourceRoot":"","sources":["../../../src/native/utils/appleScriptEscape.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAsB;IAC5D,OAAO,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC"}

package/dist/native/utils/geometry.d.ts

@@ -0,0 +1,12 @@
+import type { NativePoint, NativeRegion } from '../types.js';
+export declare function centerOf(region: NativeRegion): NativePoint;
+export declare function normalizeRegion(region: NativeRegion): NativeRegion;
+export declare function isPointInsideRegion(point: NativePoint, region: NativeRegion): boolean;
+export declare function clampPointToRegion(point: NativePoint, region: NativeRegion): NativePoint;
+export declare function paddedRegion(region: NativeRegion, paddingPx: number): NativeRegion;
+export declare function intersects(a: NativeRegion, b: NativeRegion): boolean;
+export declare function intersection(a: NativeRegion, b: NativeRegion): NativeRegion;
+export declare function visibleEnough(region: NativeRegion, viewport: NativeRegion, minimumWidth: number, minimumHeight: number): boolean;
+export declare function randomPointInRegion(region: NativeRegion, random: () => number, paddingPx?: number): NativePoint;
+export declare function roundPoint(point: NativePoint): NativePoint;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/native/utils/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/native/utils/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAK1D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAOlE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAKrF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAKxF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CASlF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAKpE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAY3E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAIhI;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,MAAM,EAAE,SAAS,SAAI,GAAG,WAAW,CAU1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAK1D"}

package/dist/native/utils/geometry.js

@@ -0,0 +1,77 @@
+export function centerOf(region) {
+    return {
+        x: region.x + region.width / 2,
+        y: region.y + region.height / 2
+    };
+}
+export function normalizeRegion(region) {
+    return {
+        x: region.x,
+        y: region.y,
+        width: Math.max(0, region.width),
+        height: Math.max(0, region.height)
+    };
+}
+export function isPointInsideRegion(point, region) {
+    return point.x >= region.x
+        && point.x <= region.x + region.width
+        && point.y >= region.y
+        && point.y <= region.y + region.height;
+}
+export function clampPointToRegion(point, region) {
+    return {
+        x: Math.min(Math.max(point.x, region.x), region.x + region.width),
+        y: Math.min(Math.max(point.y, region.y), region.y + region.height)
+    };
+}
+export function paddedRegion(region, paddingPx) {
+    const x = region.x + paddingPx;
+    const y = region.y + paddingPx;
+    return normalizeRegion({
+        x,
+        y,
+        width: region.width - paddingPx * 2,
+        height: region.height - paddingPx * 2
+    });
+}
+export function intersects(a, b) {
+    return a.x < b.x + b.width
+        && a.x + a.width > b.x
+        && a.y < b.y + b.height
+        && a.y + a.height > b.y;
+}
+export function intersection(a, b) {
+    const x = Math.max(a.x, b.x);
+    const y = Math.max(a.y, b.y);
+    const right = Math.min(a.x + a.width, b.x + b.width);
+    const bottom = Math.min(a.y + a.height, b.y + b.height);
+    return normalizeRegion({
+        x,
+        y,
+        width: right - x,
+        height: bottom - y
+    });
+}
+export function visibleEnough(region, viewport, minimumWidth, minimumHeight) {
+    if (!intersects(region, viewport))
+        return false;
+    const visible = intersection(region, viewport);
+    return visible.width >= Math.min(region.width, minimumWidth) && visible.height >= Math.min(region.height, minimumHeight);
+}
+export function randomPointInRegion(region, random, paddingPx = 0) {
+    const safe = paddedRegion(region, paddingPx);
+    if (safe.width <= 0 || safe.height <= 0) {
+        return centerOf(region);
+    }
+    return {
+        x: safe.x + random() * safe.width,
+        y: safe.y + random() * safe.height
+    };
+}
+export function roundPoint(point) {
+    return {
+        x: Math.round(point.x),
+        y: Math.round(point.y)
+    };
+}
+//# sourceMappingURL=geometry.js.map