safari-pilot 0.1.0

package/dist/engines/applescript.d.ts

@@ -0,0 +1,53 @@
+import { BaseEngine } from './engine.js';
+import type { Engine, EngineError, EngineResult } from '../types.js';
+export declare class AppleScriptEngine extends BaseEngine {
+    readonly name: Engine;
+    isAvailable(): Promise<boolean>;
+    execute(script: string, timeout?: number): Promise<EngineResult>;
+    /** Execute a raw AppleScript string directly (for testing/internal use). */
+    executeRaw(script: string, timeout?: number): Promise<string>;
+    /**
+     * Build an AppleScript that targets a tab by URL and executes JS inside it.
+     */
+    buildTabScript(url: string, jsCode: string): string;
+    /**
+     * Build an AppleScript that navigates to a URL (opens new document if needed).
+     */
+    buildNavigateScript(url: string): string;
+    /**
+     * Build an AppleScript that opens a new tab (optionally in a private window).
+     */
+    buildNewTabScript(url: string, privateWindow?: boolean): string;
+    /**
+     * Build an AppleScript that closes the tab matching a given URL.
+     */
+    buildCloseTabScript(url: string): string;
+    /**
+     * Build an AppleScript that lists all open tabs across all windows.
+     */
+    buildListTabsScript(): string;
+    /**
+     * Execute JavaScript in a tab identified by its current URL.
+     * Wraps the JS in a try/catch serialization harness so `return` works
+     * and results are properly JSON-serialized. Parses the wrapper on the
+     * way back so callers get the inner value directly.
+     */
+    executeJsInTab(tabUrl: string, jsCode: string, timeout?: number): Promise<EngineResult>;
+    /**
+     * Wrap a JS snippet in a try/catch serialization harness.
+     * Returns a single-line string safe for embedding in AppleScript do JavaScript.
+     */
+    wrapJavaScript(jsCode: string): string;
+    /**
+     * Parse the raw string returned by do JavaScript / osascript stdout.
+     * Handles JSON envelope, CSP/ShadowDOM signals, and bare string results.
+     */
+    parseJsResult(raw: string): EngineResult;
+    /**
+     * Parse an AppleScript error from stderr or error message text.
+     * Extracts OSA error codes via regex.
+     */
+    parseAppleScriptError(stderr: string): EngineError;
+    private classifyError;
+    private mapJsErrorName;
+}

package/dist/engines/applescript.js

@@ -0,0 +1,290 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { BaseEngine } from './engine.js';
+const execFileAsync = promisify(execFile);
+const MAX_BUFFER = 10 * 1024 * 1024; // 10 MB
+const DEFAULT_TIMEOUT_MS = 30_000;
+// AppleScript error codes from OSA and Safari
+const AS_ERROR_CODES = {
+    [-600]: { code: 'SAFARI_NOT_RUNNING', retryable: true },
+    [-609]: { code: 'SAFARI_CRASHED', retryable: true },
+    [-1743]: { code: 'PERMISSION_DENIED', retryable: false },
+    [-1728]: { code: 'ELEMENT_NOT_FOUND', retryable: true },
+};
+export class AppleScriptEngine extends BaseEngine {
+    name = 'applescript';
+    async isAvailable() {
+        try {
+            await execFileAsync('osascript', ['-e', 'tell application "Safari" to return name'], {
+                timeout: 5000,
+                maxBuffer: MAX_BUFFER,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async execute(script, timeout = DEFAULT_TIMEOUT_MS) {
+        const start = Date.now();
+        try {
+            const { stdout } = await execFileAsync('osascript', ['-e', script], {
+                timeout,
+                maxBuffer: MAX_BUFFER,
+            });
+            const raw = stdout.trim();
+            const result = this.parseJsResult(raw);
+            return { ...result, elapsed_ms: Date.now() - start };
+        }
+        catch (err) {
+            const elapsed = Date.now() - start;
+            const engineError = this.classifyError(err);
+            return { ok: false, error: engineError, elapsed_ms: elapsed };
+        }
+    }
+    /** Execute a raw AppleScript string directly (for testing/internal use). */
+    async executeRaw(script, timeout = DEFAULT_TIMEOUT_MS) {
+        const { stdout } = await execFileAsync('osascript', ['-e', script], {
+            timeout,
+            maxBuffer: MAX_BUFFER,
+        });
+        return stdout.trim();
+    }
+    // ── Script builders ─────────────────────────────────────────────────────────
+    /**
+     * Build an AppleScript that targets a tab by URL and executes JS inside it.
+     */
+    buildTabScript(url, jsCode) {
+        const escapedUrl = url.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        const escapedJs = jsCode.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `tell application "Safari"
+  set _result to ""
+  repeat with _window in every window
+    repeat with _tab in every tab of _window
+      if URL of _tab is "${escapedUrl}" then
+        set _result to do JavaScript "${escapedJs}" in _tab
+        return _result
+      end if
+    end repeat
+  end repeat
+  return _result
+end tell`;
+    }
+    /**
+     * Build an AppleScript that navigates to a URL (opens new document if needed).
+     */
+    buildNavigateScript(url) {
+        const escapedUrl = url.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `tell application "Safari"
+  if (count of windows) is 0 then
+    make new document with properties {URL:"${escapedUrl}"}
+  else
+    set URL of current tab of front window to "${escapedUrl}"
+  end if
+end tell`;
+    }
+    /**
+     * Build an AppleScript that opens a new tab (optionally in a private window).
+     */
+    buildNewTabScript(url, privateWindow = false) {
+        const escapedUrl = url.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        if (privateWindow) {
+            // Private windows require System Events menu click
+            return `tell application "Safari" to activate
+tell application "System Events"
+  tell process "Safari"
+    click menu item "New Private Window" of menu "File" of menu bar 1
+  end tell
+end tell
+tell application "Safari"
+  set URL of current tab of front window to "${escapedUrl}"
+end tell`;
+        }
+        return `tell application "Safari"
+  tell front window
+    set _tab to make new tab with properties {URL:"${escapedUrl}"}
+    set current tab to _tab
+  end tell
+end tell`;
+    }
+    /**
+     * Build an AppleScript that closes the tab matching a given URL.
+     */
+    buildCloseTabScript(url) {
+        const escapedUrl = url.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `tell application "Safari"
+  repeat with _window in every window
+    repeat with _tab in every tab of _window
+      if URL of _tab is "${escapedUrl}" then
+        close _tab
+        return true
+      end if
+    end repeat
+  end repeat
+  return false
+end tell`;
+    }
+    /**
+     * Build an AppleScript that lists all open tabs across all windows.
+     */
+    buildListTabsScript() {
+        return `tell application "Safari"
+  set _output to ""
+  repeat with _window in every window
+    repeat with _tab in every tab of _window
+      set _output to _output & (URL of _tab) & "\\t" & (name of _tab) & "\\n"
+    end repeat
+  end repeat
+  return _output
+end tell`;
+    }
+    /**
+     * Execute JavaScript in a tab identified by its current URL.
+     * Wraps the JS in a try/catch serialization harness so `return` works
+     * and results are properly JSON-serialized. Parses the wrapper on the
+     * way back so callers get the inner value directly.
+     */
+    async executeJsInTab(tabUrl, jsCode, timeout) {
+        const wrapped = this.wrapJavaScript(jsCode);
+        const script = this.buildTabScript(tabUrl, wrapped);
+        const result = await this.execute(script, timeout);
+        // Parse the JSON wrapper from wrapJavaScript
+        if (result.ok && result.value) {
+            const parsed = this.parseJsResult(result.value);
+            return { ...parsed, elapsed_ms: result.elapsed_ms };
+        }
+        return result;
+    }
+    // ── JS wrapping & result parsing ────────────────────────────────────────────
+    /**
+     * Wrap a JS snippet in a try/catch serialization harness.
+     * Returns a single-line string safe for embedding in AppleScript do JavaScript.
+     */
+    wrapJavaScript(jsCode) {
+        return `(function(){try{var __r=(function(){${jsCode}})();return JSON.stringify({ok:true,value:__r});}catch(e){return JSON.stringify({ok:false,error:{message:e.message,name:e.name}});}})()`;
+    }
+    /**
+     * Parse the raw string returned by do JavaScript / osascript stdout.
+     * Handles JSON envelope, CSP/ShadowDOM signals, and bare string results.
+     */
+    parseJsResult(raw) {
+        const start = Date.now();
+        // Detect CSP-blocked execution (Safari returns empty or specific error text)
+        if (raw === '' ||
+            raw.toLowerCase().includes('content security policy') ||
+            raw.toLowerCase().includes('blocked by csp')) {
+            if (raw === '' || raw.toLowerCase().includes('content security policy') || raw.toLowerCase().includes('blocked by csp')) {
+                // Only classify empty as CSP_BLOCKED if it looks like a blocked signal,
+                // but for the harness we rely on the structured envelope. Bare empty = CSP.
+                if (raw.toLowerCase().includes('content security policy') || raw.toLowerCase().includes('blocked by csp')) {
+                    return {
+                        ok: false,
+                        error: { code: 'CSP_BLOCKED', message: 'JavaScript execution blocked by Content Security Policy', retryable: false },
+                        elapsed_ms: Date.now() - start,
+                    };
+                }
+            }
+        }
+        // Detect shadow DOM closed signal
+        if (raw.toLowerCase().includes('shadow') && raw.toLowerCase().includes('closed')) {
+            return {
+                ok: false,
+                error: { code: 'SHADOW_DOM_CLOSED', message: 'Cannot access closed shadow root', retryable: false },
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        // Try to parse JSON envelope
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && 'ok' in parsed) {
+                if (parsed.ok) {
+                    const val = parsed.value;
+                    return {
+                        ok: true,
+                        value: val === undefined || val === null
+                            ? undefined
+                            : typeof val === 'string'
+                                ? val
+                                : JSON.stringify(val),
+                        elapsed_ms: Date.now() - start,
+                    };
+                }
+                else {
+                    const errName = parsed.error?.name ?? 'Error';
+                    const errMsg = parsed.error?.message ?? 'Unknown error';
+                    // Map known JS error names to engine codes
+                    const code = this.mapJsErrorName(errName);
+                    return {
+                        ok: false,
+                        error: { code, message: errMsg, retryable: false },
+                        elapsed_ms: Date.now() - start,
+                    };
+                }
+            }
+        }
+        catch {
+            // Not JSON — treat raw string as successful result
+        }
+        // Raw non-JSON string → treat as success value
+        return { ok: true, value: raw, elapsed_ms: Date.now() - start };
+    }
+    /**
+     * Parse an AppleScript error from stderr or error message text.
+     * Extracts OSA error codes via regex.
+     */
+    parseAppleScriptError(stderr) {
+        // AppleScript errors embed the code in parens: "... (-600)"
+        const match = stderr.match(/\((-?\d+)\)/);
+        if (match) {
+            const code = parseInt(match[1], 10);
+            const known = AS_ERROR_CODES[code];
+            if (known) {
+                return {
+                    code: known.code,
+                    message: stderr.trim(),
+                    retryable: known.retryable,
+                };
+            }
+        }
+        return {
+            code: 'APPLESCRIPT_ERROR',
+            message: stderr.trim() || 'Unknown AppleScript error',
+            retryable: false,
+        };
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    classifyError(err) {
+        if (err && typeof err === 'object') {
+            const e = err;
+            // Timeout / killed process
+            if (e.killed === true || e.signal === 'SIGTERM' || e.signal === 'SIGKILL') {
+                return { code: 'TIMEOUT', message: 'osascript process timed out', retryable: true };
+            }
+            // stderr contains AppleScript error code
+            if (e.stderr && typeof e.stderr === 'string' && e.stderr.length > 0) {
+                return this.parseAppleScriptError(e.stderr);
+            }
+            // message may contain the error text
+            if (e.message && typeof e.message === 'string') {
+                const asMatch = e.message.match(/\((-?\d+)\)/);
+                if (asMatch) {
+                    return this.parseAppleScriptError(e.message);
+                }
+            }
+        }
+        return {
+            code: 'UNKNOWN_ERROR',
+            message: err instanceof Error ? err.message : String(err),
+            retryable: false,
+        };
+    }
+    mapJsErrorName(name) {
+        switch (name) {
+            case 'SecurityError': return 'PERMISSION_DENIED';
+            case 'TypeError': return 'TYPE_ERROR';
+            case 'ReferenceError': return 'REFERENCE_ERROR';
+            default: return 'JS_ERROR';
+        }
+    }
+}
+//# sourceMappingURL=applescript.js.map

package/dist/engines/applescript.js.map

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

package/dist/engines/daemon.d.ts

@@ -0,0 +1,19 @@
+import { BaseEngine } from './engine.js';
+import type { Engine, EngineResult } from '../types.js';
+export declare class DaemonEngine extends BaseEngine {
+    readonly name: Engine;
+    private proc;
+    private pending;
+    private daemonPath;
+    private reconnectAttempted;
+    private shuttingDown;
+    constructor(daemonPath?: string);
+    isAvailable(): Promise<boolean>;
+    execute(script: string, timeout?: number): Promise<EngineResult>;
+    shutdown(): Promise<void>;
+    private ensureRunning;
+    private spawnDaemon;
+    private sendCommand;
+    private _dispatchResponse;
+    private _rejectAllPending;
+}

package/dist/engines/daemon.js

@@ -0,0 +1,187 @@
+import { spawn } from 'node:child_process';
+import { BaseEngine } from './engine.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+let _idCounter = 0;
+class DaemonTimeoutError extends Error {
+    constructor(method, timeout) {
+        super(`Daemon command "${method}" timed out after ${timeout}ms`);
+        this.name = 'DaemonTimeoutError';
+    }
+}
+function nextId() {
+    return `req-${Date.now()}-${++_idCounter}`;
+}
+export class DaemonEngine extends BaseEngine {
+    name = 'daemon';
+    proc = null;
+    pending = new Map();
+    daemonPath;
+    reconnectAttempted = false;
+    shuttingDown = false;
+    constructor(daemonPath) {
+        super();
+        this.daemonPath = daemonPath
+            ?? process.env['SAFARI_PILOT_DAEMON']
+            ?? './bin/SafariPilotd';
+    }
+    // ── Public interface ────────────────────────────────────────────────────────
+    async isAvailable() {
+        try {
+            await this.ensureRunning();
+            const response = await this.sendCommand('ping', {});
+            return response.ok === true && response.value === 'pong';
+        }
+        catch {
+            return false;
+        }
+    }
+    async execute(script, timeout = DEFAULT_TIMEOUT_MS) {
+        const start = Date.now();
+        try {
+            await this.ensureRunning();
+            const response = await this.sendCommand('execute', { script }, timeout);
+            if (response.ok) {
+                // Normalize: trim trailing whitespace (daemon may include trailing newline)
+                const value = response.value?.trimEnd();
+                return {
+                    ok: true,
+                    value,
+                    elapsed_ms: Date.now() - start,
+                };
+            }
+            return {
+                ok: false,
+                error: {
+                    code: response.error?.code ?? 'DAEMON_ERROR',
+                    message: response.error?.message ?? 'Daemon returned an error',
+                    retryable: true,
+                },
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // DaemonTimeoutError is a tagged subclass so we can identify it precisely
+            const isTimeout = err instanceof DaemonTimeoutError;
+            return {
+                ok: false,
+                error: {
+                    code: isTimeout ? 'TIMEOUT' : 'DAEMON_ERROR',
+                    message: msg,
+                    retryable: true,
+                },
+                elapsed_ms: Date.now() - start,
+            };
+        }
+    }
+    async shutdown() {
+        this.shuttingDown = true;
+        if (this.proc && !this.proc.killed) {
+            // Best-effort graceful shutdown command
+            try {
+                if (this.proc.stdin?.writable) {
+                    this.proc.stdin.write(JSON.stringify({ method: 'shutdown' }) + '\n');
+                }
+            }
+            catch {
+                // ignore write errors during shutdown
+            }
+            this.proc.kill('SIGTERM');
+        }
+        this._rejectAllPending(new Error('DaemonEngine is shutting down'));
+        this.proc = null;
+    }
+    // ── Private: process lifecycle ───────────────────────────────────────────
+    async ensureRunning() {
+        if (this.proc && !this.proc.killed) {
+            return;
+        }
+        this.spawnDaemon();
+    }
+    spawnDaemon() {
+        const proc = spawn(this.daemonPath, [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.proc = proc;
+        this.reconnectAttempted = false;
+        // Parse NDJSON lines from stdout using manual line buffering.
+        // Using raw `data` events (not readline) so the code works with both
+        // real Readable streams and the EventEmitter-based mocks used in tests.
+        let lineBuffer = '';
+        proc.stdout.on('data', (chunk) => {
+            lineBuffer += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+            let newlineIdx;
+            while ((newlineIdx = lineBuffer.indexOf('\n')) !== -1) {
+                const line = lineBuffer.slice(0, newlineIdx).trim();
+                lineBuffer = lineBuffer.slice(newlineIdx + 1);
+                if (!line)
+                    continue;
+                try {
+                    const msg = JSON.parse(line);
+                    this._dispatchResponse(msg);
+                }
+                catch {
+                    // Malformed JSON line — ignore
+                }
+            }
+        });
+        // Handle process exit: reject all pending requests
+        proc.on('exit', (code, signal) => {
+            if (this.shuttingDown)
+                return;
+            const reason = `Daemon exited with code=${code ?? 'null'} signal=${signal ?? 'none'}`;
+            this._rejectAllPending(new Error(reason));
+            // Auto-reconnect once
+            if (!this.reconnectAttempted) {
+                this.reconnectAttempted = true;
+                this.proc = null;
+                // Don't auto-spawn here — let the next ensureRunning() call do it
+                // to avoid infinite respawn loops
+            }
+            else {
+                this.proc = null;
+            }
+        });
+        proc.on('error', (err) => {
+            this._rejectAllPending(err);
+            this.proc = null;
+        });
+    }
+    // ── Private: request/response ────────────────────────────────────────────
+    sendCommand(method, params, timeout = DEFAULT_TIMEOUT_MS) {
+        const id = nextId();
+        const payload = JSON.stringify({ id, method, params }) + '\n';
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new DaemonTimeoutError(method, timeout));
+            }, timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            if (!this.proc || !this.proc.stdin?.writable) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(new Error('Daemon process is not running or stdin is closed'));
+                return;
+            }
+            this.proc.stdin.write(payload);
+        });
+    }
+    _dispatchResponse(msg) {
+        if (!msg.id)
+            return;
+        const pending = this.pending.get(msg.id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timer);
+        this.pending.delete(msg.id);
+        pending.resolve(msg);
+    }
+    _rejectAllPending(reason) {
+        for (const [id, req] of this.pending) {
+            clearTimeout(req.timer);
+            req.reject(reason);
+            this.pending.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/engines/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/engines/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,kBAAmB,SAAQ,KAAK;IACpC,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,mBAAmB,MAAM,qBAAqB,OAAO,IAAI,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,SAAS,MAAM;IACb,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC;AAeD,MAAM,OAAO,YAAa,SAAQ,UAAU;IACjC,IAAI,GAAW,QAAQ,CAAC;IAEzB,IAAI,GAAwB,IAAI,CAAC;IACjC,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IACjD,UAAU,CAAS;IACnB,kBAAkB,GAAG,KAAK,CAAC;IAC3B,YAAY,GAAG,KAAK,CAAC;IAE7B,YAAY,UAAmB;QAC7B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,UAAU;eACvB,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;eAClC,oBAAoB,CAAC;IAC5B,CAAC;IAED,+EAA+E;IAE/E,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACpD,OAAO,QAAQ,CAAC,EAAE,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,UAAkB,kBAAkB;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;YACxE,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,4EAA4E;gBAC5E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;gBACxC,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,KAAK;oBACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAC/B,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,IAAI,cAAc;oBAC5C,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,0BAA0B;oBAC9D,SAAS,EAAE,IAAI;iBAChB;gBACD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,0EAA0E;YAC1E,MAAM,SAAS,GAAG,GAAG,YAAY,kBAAkB,CAAC;YACpD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc;oBAC5C,OAAO,EAAE,GAAG;oBACZ,SAAS,EAAE,IAAI;iBAChB;gBACD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,wCAAwC;YACxC,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;YACxC,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAEO,WAAW;QACjB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE;YACtC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAEhC,8DAA8D;QAC9D,qEAAqE;QACrE,wEAAwE;QACxE,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YACjD,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,UAAkB,CAAC;YACvB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;gBAC9C,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;oBAC/C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,+BAA+B;gBACjC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,mDAAmD;QACnD,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,MAA6B,EAAE,EAAE;YACrE,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO;YAE9B,MAAM,MAAM,GAAG,2BAA2B,IAAI,IAAI,MAAM,WAAW,MAAM,IAAI,MAAM,EAAE,CAAC;YACtF,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAE1C,sBAAsB;YACtB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,kEAAkE;gBAClE,kCAAkC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC9B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAEpE,WAAW,CACjB,MAAc,EACd,MAA+B,EAC/B,UAAkB,kBAAkB;QAEpC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;QAE9D,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YAClD,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAEjD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC7C,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,GAAmB;QAC3C,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAEO,iBAAiB,CAAC,MAAa;QACrC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/engines/engine.d.ts

@@ -0,0 +1,15 @@
+import type { Engine, EngineResult } from '../types.js';
+export interface IEngine {
+    readonly name: Engine;
+    isAvailable(): Promise<boolean>;
+    execute(script: string, timeout?: number): Promise<EngineResult>;
+    shutdown(): Promise<void>;
+}
+export declare abstract class BaseEngine implements IEngine {
+    abstract readonly name: Engine;
+    abstract isAvailable(): Promise<boolean>;
+    abstract execute(script: string, timeout?: number): Promise<EngineResult>;
+    shutdown(): Promise<void>;
+    protected wrapScript(jsCode: string): string;
+    protected parseResult(raw: string): EngineResult;
+}

package/dist/engines/engine.js

@@ -0,0 +1,42 @@
+export class BaseEngine {
+    async shutdown() { }
+    wrapScript(jsCode) {
+        return `(() => {
+  try {
+    const __result = (() => { ${jsCode} })();
+    return JSON.stringify({ ok: true, value: __result });
+  } catch (e) {
+    return JSON.stringify({
+      ok: false,
+      error: { message: e.message, name: e.name, stack: e.stack }
+    });
+  }
+})()`;
+    }
+    parseResult(raw) {
+        const start = Date.now();
+        try {
+            const parsed = JSON.parse(raw);
+            return {
+                ok: parsed.ok,
+                value: parsed.ok
+                    ? typeof parsed.value === 'string'
+                        ? parsed.value
+                        : JSON.stringify(parsed.value)
+                    : undefined,
+                error: parsed.ok
+                    ? undefined
+                    : {
+                        code: parsed.error?.name || 'INTERNAL_ERROR',
+                        message: parsed.error?.message || 'Unknown error',
+                        retryable: false,
+                    },
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        catch {
+            return { ok: true, value: raw, elapsed_ms: Date.now() - start };
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engines/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/engines/engine.ts"],"names":[],"mappings":"AASA,MAAM,OAAgB,UAAU;IAK9B,KAAK,CAAC,QAAQ,KAAmB,CAAC;IAExB,UAAU,CAAC,MAAc;QACjC,OAAO;;gCAEqB,MAAM;;;;;;;;KAQjC,CAAC;IACJ,CAAC;IAES,WAAW,CAAC,GAAW;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,EAAE;oBACd,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;wBAChC,CAAC,CAAC,MAAM,CAAC,KAAK;wBACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;oBAChC,CAAC,CAAC,SAAS;gBACb,KAAK,EAAE,MAAM,CAAC,EAAE;oBACd,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,gBAAgB;wBAC5C,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe;wBACjD,SAAS,EAAE,KAAK;qBACjB;gBACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;CACF"}