@skillful-agents/agent-computer 0.0.3

package/dist/src/daemon.js

@@ -0,0 +1,180 @@
+import { spawn } from 'child_process';
+import { connect } from 'net';
+import { existsSync, readFileSync, unlinkSync, mkdirSync } from 'fs';
+import { AC_DIR, SOCKET_PATH, DAEMON_JSON_PATH, IS_NAMED_PIPE } from './platform/index.js';
+import { resolveBinary } from './platform/resolve.js';
+export class DaemonManager {
+    binaryPath;
+    constructor(binaryPath) {
+        this.binaryPath = binaryPath ?? resolveBinary();
+    }
+    async start() {
+        // Check if already running
+        const current = this.readDaemonInfo();
+        if (current && this.isProcessAlive(current.pid)) {
+            return this.buildStatus(current, true);
+        }
+        // Clean up stale files
+        this.cleanupStale();
+        // Spawn daemon
+        mkdirSync(AC_DIR, { recursive: true });
+        const proc = spawn(this.binaryPath, ['--daemon'], {
+            detached: true,
+            stdio: ['ignore', 'ignore', 'pipe'],
+        });
+        proc.unref();
+        // Wait for daemon to be ready
+        const start = Date.now();
+        if (IS_NAMED_PIPE) {
+            // Named pipes: wait for daemon.json to appear (pipe has no file)
+            while (Date.now() - start < 5000) {
+                if (existsSync(DAEMON_JSON_PATH)) {
+                    await sleep(50);
+                    break;
+                }
+                await sleep(50);
+            }
+            if (!existsSync(DAEMON_JSON_PATH)) {
+                throw new Error('Daemon failed to start: daemon.json not created within 5s');
+            }
+        }
+        else {
+            // Unix socket: wait for socket file to appear
+            while (Date.now() - start < 5000) {
+                if (existsSync(SOCKET_PATH)) {
+                    await sleep(50);
+                    break;
+                }
+                await sleep(50);
+            }
+            if (!existsSync(SOCKET_PATH)) {
+                throw new Error('Daemon failed to start: socket not created within 5s');
+            }
+        }
+        const info = this.readDaemonInfo();
+        if (!info) {
+            throw new Error('Daemon started but daemon.json not found');
+        }
+        return this.buildStatus(info, true);
+    }
+    async stop() {
+        const info = this.readDaemonInfo();
+        if (!info)
+            return;
+        if (this.isProcessAlive(info.pid)) {
+            // On Windows, SIGTERM is a hard kill — try graceful RPC shutdown first
+            if (IS_NAMED_PIPE) {
+                try {
+                    await this.sendShutdownRPC(info.socket);
+                }
+                catch { /* fall through to SIGTERM */ }
+            }
+            // Wait for process to exit (may already be gone from RPC shutdown)
+            let start = Date.now();
+            while (Date.now() - start < 3000) {
+                if (!this.isProcessAlive(info.pid))
+                    break;
+                await sleep(50);
+            }
+            // Send SIGTERM if still alive
+            if (this.isProcessAlive(info.pid)) {
+                try {
+                    process.kill(info.pid, 'SIGTERM');
+                }
+                catch { /* ok */ }
+                start = Date.now();
+                while (Date.now() - start < 3000) {
+                    if (!this.isProcessAlive(info.pid))
+                        break;
+                    await sleep(50);
+                }
+            }
+            // Force kill if still alive
+            if (this.isProcessAlive(info.pid)) {
+                try {
+                    process.kill(info.pid, 'SIGKILL');
+                }
+                catch { /* ok */ }
+            }
+        }
+        this.cleanupStale();
+    }
+    sendShutdownRPC(socketPath) {
+        return new Promise((resolve, reject) => {
+            const sock = connect({ path: socketPath });
+            const timeout = setTimeout(() => { sock.destroy(); reject(new Error('shutdown timeout')); }, 2000);
+            sock.on('connect', () => {
+                const req = JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'shutdown', params: {} }) + '\n';
+                sock.write(req, () => {
+                    clearTimeout(timeout);
+                    // Give daemon a moment to process before closing
+                    setTimeout(() => { sock.destroy(); resolve(); }, 100);
+                });
+            });
+            sock.on('error', (err) => { clearTimeout(timeout); reject(err); });
+        });
+    }
+    async status() {
+        const info = this.readDaemonInfo();
+        if (!info) {
+            return { running: false };
+        }
+        const alive = this.isProcessAlive(info.pid);
+        if (!alive) {
+            this.cleanupStale();
+            return { running: false };
+        }
+        return this.buildStatus(info, true);
+    }
+    async restart() {
+        await this.stop();
+        return this.start();
+    }
+    readDaemonInfo() {
+        try {
+            if (!existsSync(DAEMON_JSON_PATH))
+                return null;
+            const raw = readFileSync(DAEMON_JSON_PATH, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    isProcessAlive(pid) {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    cleanupStale() {
+        if (!IS_NAMED_PIPE) {
+            try {
+                unlinkSync(SOCKET_PATH);
+            }
+            catch { /* ok */ }
+        }
+        try {
+            unlinkSync(DAEMON_JSON_PATH);
+        }
+        catch { /* ok */ }
+    }
+    buildStatus(info, running) {
+        const startedAt = new Date(info.started_at);
+        const uptime = Date.now() - startedAt.getTime();
+        return {
+            running,
+            pid: info.pid,
+            socket: info.socket,
+            started_at: info.started_at,
+            uptime_ms: Math.max(0, uptime),
+        };
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=daemon.js.map

package/dist/src/daemon.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,39 @@
+export declare class ACError extends Error {
+    readonly code: number;
+    readonly exitCode: number;
+    readonly data?: Record<string, unknown> | undefined;
+    constructor(message: string, code: number, exitCode: number, data?: Record<string, unknown> | undefined);
+}
+export declare class ElementNotFoundError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class PermissionDeniedError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class TimeoutError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class AppNotFoundError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class WindowNotFoundError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class InvalidRefError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class OCRFallbackFailedError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class InvalidRequestError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class MethodNotFoundError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare class InvalidParamsError extends ACError {
+    constructor(message: string, data?: Record<string, unknown>);
+}
+export declare function errorFromCode(code: number, message: string, data?: Record<string, unknown>): ACError;
+export declare function exitCodeFromErrorCode(code: number): number;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAQ,SAAQ,KAAK;aAGd,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;aAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAH9C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKjD;AAED,qBAAa,oBAAqB,SAAQ,OAAO;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,qBAAsB,SAAQ,OAAO;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,YAAa,SAAQ,OAAO;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,gBAAiB,SAAQ,OAAO;gBAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,sBAAuB,SAAQ,OAAO;gBACrC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAGD,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAED,qBAAa,kBAAmB,SAAQ,OAAO;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI5D;AAgBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAMpG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1D"}

package/dist/src/errors.js

@@ -0,0 +1,103 @@
+export class ACError extends Error {
+    code;
+    exitCode;
+    data;
+    constructor(message, code, exitCode, data) {
+        super(message);
+        this.code = code;
+        this.exitCode = exitCode;
+        this.data = data;
+        this.name = 'ACError';
+    }
+}
+export class ElementNotFoundError extends ACError {
+    constructor(message, data) {
+        super(message, -32001, 1, data);
+        this.name = 'ELEMENT_NOT_FOUND';
+    }
+}
+export class PermissionDeniedError extends ACError {
+    constructor(message, data) {
+        super(message, -32002, 2, data);
+        this.name = 'PERMISSION_DENIED';
+    }
+}
+export class TimeoutError extends ACError {
+    constructor(message, data) {
+        super(message, -32003, 3, data);
+        this.name = 'TIMEOUT';
+    }
+}
+export class AppNotFoundError extends ACError {
+    constructor(message, data) {
+        super(message, -32004, 4, data);
+        this.name = 'APP_NOT_FOUND';
+    }
+}
+export class WindowNotFoundError extends ACError {
+    constructor(message, data) {
+        super(message, -32005, 5, data);
+        this.name = 'WINDOW_NOT_FOUND';
+    }
+}
+export class InvalidRefError extends ACError {
+    constructor(message, data) {
+        super(message, -32006, 6, data);
+        this.name = 'INVALID_REF';
+    }
+}
+export class OCRFallbackFailedError extends ACError {
+    constructor(message, data) {
+        super(message, -32007, 7, data);
+        this.name = 'OCR_FALLBACK_FAILED';
+    }
+}
+// JSON-RPC standard errors
+export class InvalidRequestError extends ACError {
+    constructor(message, data) {
+        super(message, -32600, 126, data);
+        this.name = 'INVALID_REQUEST';
+    }
+}
+export class MethodNotFoundError extends ACError {
+    constructor(message, data) {
+        super(message, -32601, 126, data);
+        this.name = 'METHOD_NOT_FOUND';
+    }
+}
+export class InvalidParamsError extends ACError {
+    constructor(message, data) {
+        super(message, -32602, 126, data);
+        this.name = 'INVALID_PARAMS';
+    }
+}
+// Error code → error class mapping
+const ERROR_MAP = {
+    [-32001]: ElementNotFoundError,
+    [-32002]: PermissionDeniedError,
+    [-32003]: TimeoutError,
+    [-32004]: AppNotFoundError,
+    [-32005]: WindowNotFoundError,
+    [-32006]: InvalidRefError,
+    [-32007]: OCRFallbackFailedError,
+    [-32600]: InvalidRequestError,
+    [-32601]: MethodNotFoundError,
+    [-32602]: InvalidParamsError,
+};
+export function errorFromCode(code, message, data) {
+    const ErrorClass = ERROR_MAP[code];
+    if (ErrorClass) {
+        return new ErrorClass(message, data);
+    }
+    return new ACError(message, code, 126, data);
+}
+export function exitCodeFromErrorCode(code) {
+    const instance = ERROR_MAP[code];
+    if (instance) {
+        // Create a temporary instance to get the exit code
+        const temp = new instance('');
+        return temp.exitCode;
+    }
+    return 126;
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,8 @@
+export type { Element, Snapshot, WindowInfo, ScreenshotResult, RecordingStatus, DialogInfo, AppInfo, StatusInfo, PermissionsInfo, DoctorResult, DisplayInfo, Ref, RefPrefix, NormalizedRole, } from './types.js';
+export { parseRef, isValidRef, refToRole, REF_PREFIXES } from './refs.js';
+export { ACError, ElementNotFoundError, PermissionDeniedError, TimeoutError } from './errors.js';
+export { Bridge, type BridgeOptions } from './bridge.js';
+export { AC } from './sdk.js';
+export { CDPClient, CDPConnection, CDPAXTree, CDPInteractions } from './cdp/index.js';
+export type { CDPTarget, CDPAXNode, CDPNodeRef, CDPSnapshotOptions, CDPSnapshotResult } from './cdp/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,GAAG,EACH,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAG9B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,8 @@
+// @skillful-agents/ac — TypeScript SDK for macOS desktop automation
+export { parseRef, isValidRef, refToRole, REF_PREFIXES } from './refs.js';
+export { ACError, ElementNotFoundError, PermissionDeniedError, TimeoutError } from './errors.js';
+export { Bridge } from './bridge.js';
+export { AC } from './sdk.js';
+// CDP support
+export { CDPClient, CDPConnection, CDPAXTree, CDPInteractions } from './cdp/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAmBpE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/platform/index.d.ts

@@ -0,0 +1,6 @@
+export declare const AC_DIR: string;
+export declare const DAEMON_JSON_PATH: string;
+export declare const SNAPSHOTS_DIR: string;
+export declare const SOCKET_PATH: string;
+export declare const IS_NAMED_PIPE: boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,QAAyB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,QAA8B,CAAC;AAC5D,eAAO,MAAM,aAAa,QAA4B,CAAC;AAIvD,eAAO,MAAM,WAAW,QAEO,CAAC;AAGhC,eAAO,MAAM,aAAa,SAAiB,CAAC"}

package/dist/src/platform/index.js

@@ -0,0 +1,14 @@
+import { join } from 'path';
+import { homedir, platform } from 'os';
+const os = platform();
+export const AC_DIR = join(homedir(), '.ac');
+export const DAEMON_JSON_PATH = join(AC_DIR, 'daemon.json');
+export const SNAPSHOTS_DIR = join(AC_DIR, 'snapshots');
+// macOS: Unix domain socket file on disk
+// Windows: Named pipe (kernel object, no file on disk)
+export const SOCKET_PATH = os === 'win32'
+    ? '\\\\.\\pipe\\ac-daemon'
+    : join(AC_DIR, 'daemon.sock');
+// Named pipes don't exist as files — connection-based detection needed
+export const IS_NAMED_PIPE = os === 'win32';
+//# sourceMappingURL=index.js.map

package/dist/src/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEvC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;AAEtB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEvD,yCAAyC;AACzC,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,KAAK,OAAO;IACvC,CAAC,CAAC,wBAAwB;IAC1B,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEhC,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,KAAK,OAAO,CAAC"}

package/dist/src/platform/resolve.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveBinary(): string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/src/platform/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/platform/resolve.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,IAAI,MAAM,CAsDtC"}

package/dist/src/platform/resolve.js

@@ -0,0 +1,54 @@
+import { platform, arch } from 'os';
+import { join, dirname } from 'path';
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export function resolveBinary() {
+    const os = platform();
+    const cpu = arch();
+    if (os !== 'darwin' && os !== 'win32') {
+        throw new Error(`Unsupported platform: ${os}. agent-computer supports macOS and Windows.`);
+    }
+    const ext = os === 'win32' ? '.exe' : '';
+    const key = `${os}-${cpu === 'arm64' ? 'arm64' : 'x64'}`;
+    // Bundled platform-specific binary (npm package)
+    const bundledPath = join(__dirname, '..', '..', 'bin', `ac-core-${key}${ext}`);
+    if (existsSync(bundledPath)) {
+        return bundledPath;
+    }
+    if (os === 'darwin') {
+        // Development: locally-built Swift binary (release)
+        const devBinaryPath = join(__dirname, '..', '..', 'native', 'macos', '.build', 'release', 'ac-core');
+        if (existsSync(devBinaryPath))
+            return devBinaryPath;
+        // Development: Swift debug build
+        const debugBinaryPath = join(__dirname, '..', '..', 'native', 'macos', '.build', 'debug', 'ac-core');
+        if (existsSync(debugBinaryPath))
+            return debugBinaryPath;
+    }
+    if (os === 'win32') {
+        const rid = cpu === 'arm64' ? 'win-arm64' : 'win-x64';
+        const tfms = ['net9.0-windows', 'net9.0'];
+        const base = join(__dirname, '..', '..', 'native', 'windows', 'ACCore', 'bin');
+        for (const tfm of tfms) {
+            // Development: self-contained release publish
+            const publishPath = join(base, 'Release', tfm, rid, 'publish', 'ac-core.exe');
+            if (existsSync(publishPath))
+                return publishPath;
+            // Development: release build (framework-dependent)
+            const releasePath = join(base, 'Release', tfm, 'ac-core.exe');
+            if (existsSync(releasePath))
+                return releasePath;
+            // Development: debug build (framework-dependent)
+            const debugPath = join(base, 'Debug', tfm, 'ac-core.exe');
+            if (existsSync(debugPath))
+                return debugPath;
+        }
+    }
+    const buildHint = os === 'win32'
+        ? 'cd native/windows && dotnet build'
+        : 'cd native/macos && swift build -c release';
+    throw new Error(`Native binary not found for ${key}. ` +
+        `Build from source: ${buildHint}`);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/src/platform/resolve.js.map

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

package/dist/src/refs.d.ts

@@ -0,0 +1,12 @@
+import type { NormalizedRole } from './types.js';
+export declare const REF_PREFIXES: Record<string, NormalizedRole>;
+export declare function roleToPrefix(role: string): string;
+export interface ParsedRef {
+    prefix: string;
+    role: NormalizedRole;
+    id: number;
+}
+export declare function parseRef(input: string): ParsedRef;
+export declare function isValidRef(input: string): boolean;
+export declare function refToRole(prefix: string): NormalizedRole | undefined;
+//# sourceMappingURL=refs.d.ts.map

package/dist/src/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAiC5D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAGvD,CAAC;AAaF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAQD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CA0BjD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEpE"}

package/dist/src/refs.js

@@ -0,0 +1,85 @@
+// Single-letter prefix → role mapping
+const SINGLE_LETTER_PREFIXES = {
+    b: 'button',
+    t: 'textfield',
+    l: 'link',
+    m: 'menuitem',
+    c: 'checkbox',
+    r: 'radio',
+    s: 'slider',
+    d: 'dropdown',
+    i: 'image',
+    g: 'group',
+    w: 'window',
+    x: 'table',
+    o: 'row',
+    a: 'tab',
+    e: 'generic',
+};
+// Two-letter prefix → role mapping (for less common roles)
+const TWO_LETTER_PREFIXES = {
+    cb: 'combobox',
+    sa: 'scrollarea',
+    st: 'stepper',
+    sp: 'splitgroup',
+    tl: 'timeline',
+    pg: 'progress',
+    tv: 'treeview',
+    wb: 'webarea',
+};
+export const REF_PREFIXES = {
+    ...SINGLE_LETTER_PREFIXES,
+    ...TWO_LETTER_PREFIXES,
+};
+// Reverse mapping: role → prefix
+const ROLE_TO_PREFIX = {};
+for (const [prefix, role] of Object.entries(REF_PREFIXES)) {
+    // Prefer shorter prefix if role already mapped
+    if (!ROLE_TO_PREFIX[role] || prefix.length < ROLE_TO_PREFIX[role].length) {
+        ROLE_TO_PREFIX[role] = prefix;
+    }
+}
+// textfield and textarea both map to 't' — textarea gets 't' by convention
+ROLE_TO_PREFIX['textarea'] = 't';
+export function roleToPrefix(role) {
+    return ROLE_TO_PREFIX[role] ?? 'e';
+}
+const ALL_PREFIXES = new Set(Object.keys(REF_PREFIXES));
+// Ref pattern: @<prefix><positive integer>
+// Try two-letter prefix first, then single-letter
+const REF_REGEX = /^@([a-z]{1,2})([1-9]\d*)$/;
+export function parseRef(input) {
+    const match = REF_REGEX.exec(input);
+    if (!match) {
+        throw new Error(`Invalid ref format: "${input}". Expected @<prefix><number> (e.g., @b1, @cb3)`);
+    }
+    const rawPrefix = match[1];
+    const id = parseInt(match[2], 10);
+    // Try two-letter prefix first (e.g., "@cb1" → prefix "cb", not "c" with "b1")
+    if (rawPrefix.length === 2 && ALL_PREFIXES.has(rawPrefix)) {
+        return { prefix: rawPrefix, role: REF_PREFIXES[rawPrefix], id };
+    }
+    // Try single-letter prefix
+    if (rawPrefix.length === 1 && ALL_PREFIXES.has(rawPrefix)) {
+        return { prefix: rawPrefix, role: REF_PREFIXES[rawPrefix], id };
+    }
+    // Two-letter prefix but only first letter is valid (e.g., "@bx1" is not valid)
+    if (rawPrefix.length === 2) {
+        // Check if first letter alone is a valid prefix — if so, reject because the second char is part of the number parsing issue
+        throw new Error(`Invalid ref prefix: "${rawPrefix}" in "${input}". Valid prefixes: ${[...ALL_PREFIXES].sort().join(', ')}`);
+    }
+    throw new Error(`Unknown ref prefix: "${rawPrefix}" in "${input}". Valid prefixes: ${[...ALL_PREFIXES].sort().join(', ')}`);
+}
+export function isValidRef(input) {
+    try {
+        parseRef(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function refToRole(prefix) {
+    return REF_PREFIXES[prefix];
+}
+//# sourceMappingURL=refs.js.map

package/dist/src/refs.js.map

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