@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/computer/motor/platform/types.d.ts

@@ -0,0 +1,263 @@
+import type { ExtensionContext } from "../../../extensions/types.ts";
+import type { LookResponse } from "../outline.ts";
+import type { PermissionStatus } from "../permissions.ts";
+export type PlatformName = "macos" | "windows" | "linux";
+export type NativeInputDelivery = "hid" | "pid";
+export type ActOutcome = "worked" | "didnt" | "unknown";
+/**
+ * Best-effort presentation hint for a root. The seam guarantees only the
+ * `window` vs transient distinction; specific transient kinds are display hints
+ * and must never drive behavior in shared code. Platforms that need precise
+ * distinctions internally should use native signals.
+ */
+export type PlatformRootKind = "window" | "menu" | "sheet" | "popover" | "dialog";
+export interface PlatformDiagnostics {
+    protocolVersion: number;
+    architectureVersion?: number;
+    invariants?: string[];
+    pid: number;
+    parentPid?: number;
+    parentAppName?: string;
+    parentBundleId?: string;
+    parentPath?: string;
+    executablePath?: string;
+    os?: string;
+    arch?: string;
+    accessibility?: boolean;
+    screenRecording?: boolean;
+}
+export interface PlatformReadyState {
+    permissionStatus?: PermissionStatus;
+    lastPermissionCheckAt: number;
+    helperDiagnostics?: PlatformDiagnostics;
+}
+export interface PlatformRootQuery {
+    pid?: number;
+    title?: string;
+}
+export interface PlatformApp {
+    appName: string;
+    bundleId?: string;
+    pid: number;
+    isFrontmost?: boolean;
+}
+export interface FramePoints {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface PlatformRoot {
+    kind: PlatformRootKind;
+    rootRef?: string;
+    windowRef?: string;
+    windowId?: number;
+    pid?: number;
+    appName?: string;
+    bundleId?: string;
+    title: string;
+    role?: string;
+    subrole?: string;
+    zOrder: number;
+    framePoints: FramePoints;
+    scaleFactor: number;
+    isOnscreen: boolean;
+    isFocused: boolean;
+    isMinimized: boolean;
+    /** Best-effort; platforms without a main-window concept may mirror `isFocused`. */
+    isMain: boolean;
+    /** Platform-reported modality fact, including platform-specific modal/dialog/sheet signals. */
+    isModal: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface PlatformFrontmostResult {
+    appName: string;
+    bundleId?: string;
+    pid: number;
+    windowTitle?: string;
+    windowId?: number;
+    rootRef?: string;
+}
+export interface PlatformFocusWindowResult {
+    focused: boolean;
+    alreadyFocused?: boolean;
+    reason?: string;
+}
+export interface HelperActPerformed {
+    grounding?: "description" | "coordinates" | "keyboard-events";
+    /** `ax` means the platform accessibility API (AX on macOS, UIA on Windows). */
+    delivery?: "ax" | NativeInputDelivery;
+    refound?: boolean;
+    /** Free-form diagnostic naming the platform's delta mechanism. */
+    deltaSource?: string;
+    selectionGrounding?: "ax" | "keyboard";
+    transaction?: boolean;
+    actionCount?: number;
+    activated?: boolean;
+    raised?: boolean;
+    focused?: boolean;
+}
+export interface PlatformRootDelta {
+    change: "appeared" | "closed" | "focused";
+    kind: string;
+    ref?: string;
+    title?: string;
+    pid: number;
+    isModal?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface HelperActResult {
+    outcome: ActOutcome;
+    performed?: HelperActPerformed;
+    evidence?: Record<string, unknown>;
+    error?: {
+        code?: string;
+        message?: string;
+        whatIsThere?: unknown;
+    };
+    rootDelta?: PlatformRootDelta[];
+    steps?: HelperActResult[];
+    stoppedAt?: number;
+}
+export interface PlatformTarget {
+    pid?: number;
+    windowId?: number;
+    rootRef?: string;
+}
+export interface PlatformObserveRequest {
+    target: PlatformTarget;
+    /** Existing immutable look whose untouched refs/coordinate geometry survive a scoped refresh. */
+    baseLookId?: string;
+    readText: "auto" | "always" | "never";
+    scopeRef?: string;
+    maxDimension?: number;
+    includeImage?: boolean;
+}
+export type PlatformActTarget = {
+    ref: string;
+} | {
+    x: number;
+    y: number;
+} | {
+    focus: PlatformPoint;
+};
+type PlatformDeliveryPolicy = "ax_only" | "background" | "default" | "foreground";
+type PlatformMouseButton = "left" | "right" | "middle";
+type PlatformActDeliveryParam = {
+    delivery?: NativeInputDelivery;
+};
+export type PlatformPoint = {
+    x: number;
+    y: number;
+};
+export interface PlatformActRequestBase {
+    lookId: string;
+    pid?: number;
+    target: PlatformActTarget;
+    policy: PlatformDeliveryPolicy;
+}
+export type PlatformActRequest = PlatformActRequestBase & ({
+    action: "press" | "click";
+    params: {
+        button?: PlatformMouseButton;
+        clickCount?: number;
+    } & PlatformActDeliveryParam;
+} | {
+    action: "setText";
+    params: {
+        text: string;
+    } & PlatformActDeliveryParam;
+} | {
+    action: "typeText";
+    params: {
+        text: string;
+    } & PlatformActDeliveryParam;
+} | {
+    action: "keypress";
+    params: {
+        keys: string[];
+    } & PlatformActDeliveryParam;
+} | {
+    action: "scroll";
+    params: {
+        scrollX: number;
+        scrollY: number;
+    } & PlatformActDeliveryParam;
+} | {
+    action: "drag";
+    params: {
+        path: PlatformPoint[];
+    } & PlatformActDeliveryParam;
+} | {
+    action: "moveMouse";
+    params: PlatformActDeliveryParam;
+});
+export interface PlatformReadTextRequest {
+    /** Observation that owns the element ref. Native backends must not resolve across observations. */
+    lookId: string;
+    elementRef: string;
+    offset: number;
+    limit: number;
+}
+export interface PlatformReadTextResponse {
+    text: string;
+    offset: number;
+    limit: number;
+    totalChars: number;
+    hasMore: boolean;
+}
+export interface PlatformWaitForRequest extends PlatformTarget {
+    lookId?: string;
+    text?: string;
+    role?: string;
+    value?: string;
+    scopeRef?: string;
+    scopeExact?: boolean;
+    gone: boolean;
+    timeoutMs: number;
+}
+export interface PlatformWaitForResponse {
+    found: boolean;
+    gone?: boolean;
+    timedOut?: boolean;
+    nodeCount?: number;
+}
+export interface ComputerUsePlatformBackend {
+    name: PlatformName;
+    /** Release process-local resources when the Pi session is torn down. */
+    shutdown?(): void | Promise<void>;
+    ensureReady(ctx: ExtensionContext, state: PlatformReadyState, signal?: AbortSignal): Promise<PlatformReadyState>;
+    listApps(signal?: AbortSignal): Promise<PlatformApp[]>;
+    listRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]>;
+    getFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult>;
+    focusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult>;
+    observe(request: PlatformObserveRequest, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<LookResponse>;
+    act(request: PlatformActRequest, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<HelperActResult>;
+    /** Execute one-resource actions with one root baseline and one final settle. */
+    actBatch?(requests: PlatformActRequest[], options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<HelperActResult>;
+    readText(args: PlatformReadTextRequest, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<PlatformReadTextResponse>;
+    waitFor(args: PlatformWaitForRequest, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<PlatformWaitForResponse>;
+    isBrowserApp(appName: string, bundleId?: string): boolean;
+    isChromeFamilyApp(appName: string, bundleId?: string): boolean;
+    openBrowserLocation(target: {
+        appName: string;
+        bundleId?: string;
+    }, url: string, signal?: AbortSignal): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/computer/motor/platform/types.d.ts.map

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

package/dist/core/computer/motor/platform/types.js

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

package/dist/core/computer/motor/platform/types.js.map

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

package/dist/core/computer/motor/platform/windows/backend.d.ts

@@ -0,0 +1,3 @@
+import type { ComputerUsePlatformBackend } from "../types.ts";
+export declare const windowsBackend: ComputerUsePlatformBackend;
+//# sourceMappingURL=backend.d.ts.map

package/dist/core/computer/motor/platform/windows/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/windows/backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,0BAA0B,EAiB1B,MAAM,aAAa,CAAC;AAwGrB,eAAO,MAAM,cAAc,EAAE,0BA+F5B,CAAC"}

package/dist/core/computer/motor/platform/windows/backend.js

@@ -0,0 +1,163 @@
+import { parseLookResponse } from "../../outline.js";
+import { assertPlatformArchitecture } from "../architecture.js";
+import { toBoolean, toFiniteNumber, toOptionalString } from "../coerce.js";
+import { WINDOWS_HELPER_PROTOCOL_VERSION, windowsHelper } from "./helper.js";
+function normalizedProcessName(appName) {
+    return appName.toLowerCase().replace(/\.exe$/i, "");
+}
+function classifyBrowser(appName) {
+    switch (normalizedProcessName(appName)) {
+        case "chrome":
+        case "chromium":
+            return "chrome";
+        case "msedge":
+        case "edge":
+            return "edge";
+        case "brave":
+        case "brave-browser":
+            return "brave";
+        case "firefox":
+            return "firefox";
+        case "vivaldi":
+            return "vivaldi";
+        case "opera":
+        case "opera_gx":
+            return "opera";
+        default:
+            return false;
+    }
+}
+function parseFramePoints(raw) {
+    const frame = raw?.framePoints ?? raw?.bounds ?? {};
+    return {
+        x: toFiniteNumber(frame.x, 0),
+        y: toFiniteNumber(frame.y, 0),
+        w: Math.max(1, toFiniteNumber(frame.w ?? frame.width, 1)),
+        h: Math.max(1, toFiniteNumber(frame.h ?? frame.height, 1)),
+    };
+}
+function parseRootKind(raw) {
+    return raw === "menu" || raw === "dialog" || raw === "popover" || raw === "window" ? raw : "window";
+}
+function parseRoots(result) {
+    const array = Array.isArray(result) ? result : result?.roots;
+    if (!Array.isArray(array))
+        return [];
+    return array.map((raw, index) => {
+        return {
+            kind: parseRootKind(raw?.kind),
+            rootRef: toOptionalString(raw?.rootRef ?? raw?.windowRef ?? raw?.ref),
+            windowRef: toOptionalString(raw?.windowRef ?? raw?.rootRef ?? raw?.ref),
+            windowId: Number.isFinite(raw?.windowId) ? Math.trunc(raw.windowId) : undefined,
+            pid: Number.isFinite(raw?.pid) ? Math.trunc(raw.pid) : undefined,
+            appName: toOptionalString(raw?.appName ?? raw?.processName),
+            bundleId: toOptionalString(raw?.bundleId),
+            title: toOptionalString(raw?.title) ?? "",
+            role: toOptionalString(raw?.role),
+            subrole: toOptionalString(raw?.subrole),
+            zOrder: Math.trunc(toFiniteNumber(raw?.zOrder, index)),
+            framePoints: parseFramePoints(raw),
+            scaleFactor: Math.max(1, toFiniteNumber(raw?.scaleFactor, 1)),
+            isOnscreen: raw?.isOnscreen === undefined ? true : toBoolean(raw?.isOnscreen),
+            isFocused: toBoolean(raw?.isFocused),
+            isMinimized: toBoolean(raw?.isMinimized),
+            isMain: toBoolean(raw?.isMain ?? raw?.isFocused),
+            isModal: toBoolean(raw?.isModal),
+            metadata: raw?.metadata,
+        };
+    });
+}
+function appsFromRoots(roots) {
+    const seen = new Set();
+    return roots.flatMap((root) => {
+        if (!root.pid || seen.has(root.pid))
+            return [];
+        seen.add(root.pid);
+        return [
+            { appName: root.appName ?? "Unknown", bundleId: root.bundleId, pid: root.pid, isFrontmost: root.isFocused },
+        ];
+    });
+}
+function helperAction(request) {
+    if (!("focus" in request.target))
+        return { ...request };
+    return { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };
+}
+async function ensureReady(_ctx, state, signal) {
+    await windowsHelper.ensureInstalled(signal);
+    const diagnostics = await windowsHelper.command("diagnostics", {}, { signal, timeoutMs: 5_000 });
+    if (diagnostics?.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {
+        throw new Error(`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${diagnostics?.protocolVersion ?? "unknown"}. Restart Pi to use the installed helper.`);
+    }
+    assertPlatformArchitecture("Windows", diagnostics);
+    return { ...state, lastPermissionCheckAt: Date.now(), helperDiagnostics: diagnostics };
+}
+export const windowsBackend = {
+    name: "windows",
+    shutdown() {
+        windowsHelper.dispose();
+    },
+    ensureReady,
+    async listApps(signal) {
+        return appsFromRoots(parseRoots(await windowsHelper.command("listRoots", {}, { signal })));
+    },
+    async listRoots(query, signal) {
+        const roots = parseRoots(await windowsHelper.command("listRoots", Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid) } : {}, {
+            signal,
+        }));
+        const title = query.title?.trim().toLowerCase();
+        return title ? roots.filter((root) => root.title.trim().toLowerCase().includes(title)) : roots;
+    },
+    async getFrontmost(signal) {
+        const roots = parseRoots(await windowsHelper.command("listRoots", {}, { signal }));
+        const focused = roots.find((root) => root.isFocused) ?? roots[0];
+        if (!focused?.pid)
+            throw new Error("No frontmost window was available.");
+        return {
+            appName: focused.appName ?? "Unknown",
+            bundleId: focused.bundleId,
+            pid: focused.pid,
+            windowTitle: focused.title,
+            windowId: focused.windowId,
+            rootRef: focused.rootRef,
+        };
+    },
+    async focusWindow(target, signal) {
+        return await windowsHelper.command("focusWindow", { ...target }, { signal });
+    },
+    async observe(request, options) {
+        return parseLookResponse(await windowsHelper.command("look", {
+            ...request.target,
+            baseLookId: request.baseLookId,
+            maxDimension: request.maxDimension,
+            readText: request.readText,
+            scopeRef: request.scopeRef,
+            includeImage: request.includeImage,
+        }, options));
+    },
+    async act(request, options) {
+        return await windowsHelper.command("act", helperAction(request), options);
+    },
+    async actBatch(requests, options) {
+        return await windowsHelper.command("actBatch", { actions: requests.map(helperAction) }, options);
+    },
+    async readText(args, options) {
+        return await windowsHelper.command("uiaReadText", { ...args }, options);
+    },
+    async waitFor(args, options) {
+        return await windowsHelper.command("uiaWaitFor", { ...args }, options);
+    },
+    isBrowserApp(appName) {
+        return classifyBrowser(appName) !== false;
+    },
+    isChromeFamilyApp(appName) {
+        return (classifyBrowser(appName) === "chrome" ||
+            classifyBrowser(appName) === "edge" ||
+            classifyBrowser(appName) === "brave");
+    },
+    async openBrowserLocation(target, url, signal) {
+        await windowsHelper.command("openBrowserLocation", { ...target, url }, { signal, timeoutMs: 10_000 });
+        return true;
+    },
+};
+//# sourceMappingURL=backend.js.map

package/dist/core/computer/motor/platform/windows/backend.js.map

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

package/dist/core/computer/motor/platform/windows/helper.d.ts

@@ -0,0 +1,18 @@
+export declare const WINDOWS_HELPER_PROTOCOL_VERSION = 4;
+export declare const WINDOWS_HELPER_PATH: string;
+export declare class WindowsHelperClient {
+    private installChecked;
+    private child?;
+    private buffer;
+    private pending;
+    dispose(): void;
+    ensureInstalled(signal?: AbortSignal): Promise<void>;
+    private process;
+    private onStdout;
+    command<T>(cmd: string, args?: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<T>;
+}
+export declare const windowsHelper: WindowsHelperClient;
+//# sourceMappingURL=helper.d.ts.map

package/dist/core/computer/motor/platform/windows/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/windows/helper.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,mBAAmB,QAE6D,CAAC;AA+D9F,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAuC;IAEtD,OAAO,IAAI,IAAI;IAmBT,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAe5C,OAAO;IAmBrB,OAAO,CAAC,QAAQ;IAoCV,OAAO,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,CAAC,CAAC;CAqBb;AAED,eAAO,MAAM,aAAa,qBAA4B,CAAC"}

package/dist/core/computer/motor/platform/windows/helper.js

@@ -0,0 +1,174 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { access } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+const SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, "scripts", "setup-helper.mjs");
+const HELPER_SETUP_TIMEOUT_MS = 60_000;
+const COMMAND_TIMEOUT_MS = 15_000;
+export const WINDOWS_HELPER_PROTOCOL_VERSION = 4;
+export const WINDOWS_HELPER_PATH = process.env.ADA_COMPUTER_USE_WINDOWS_HELPER_PATH ||
+    path.join(os.homedir(), ".pi", "agent", "helpers", "ada-computer-use", "windows-bridge.exe");
+async function isExecutable(filePath) {
+    try {
+        await access(filePath, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runProcess(command, args, timeoutMs, signal, env) {
+    if (signal?.aborted)
+        throw new Error("Operation aborted.");
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"], env });
+        let stdout = "";
+        let stderr = "";
+        const cleanup = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+        };
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            cleanup();
+            reject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(" ")}`));
+        }, timeoutMs);
+        const onAbort = () => {
+            child.kill("SIGTERM");
+            cleanup();
+            reject(new Error("Operation aborted."));
+        };
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", (error) => {
+            cleanup();
+            reject(error);
+        });
+        child.on("close", (code) => {
+            cleanup();
+            if (code === 0)
+                return resolve();
+            const output = [stderr.trim(), stdout.trim()].filter(Boolean).join("\n");
+            reject(new Error(`Command failed (${code}): ${command} ${args.join(" ")}\n${output}`.trim()));
+        });
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export class WindowsHelperClient {
+    installChecked = false;
+    child;
+    buffer = "";
+    pending = new Map();
+    dispose() {
+        const error = new Error("Windows helper closed because the Pi session ended.");
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+        this.buffer = "";
+        const child = this.child;
+        this.child = undefined;
+        if (!child)
+            return;
+        child.stdin.destroy();
+        child.stdout.destroy();
+        child.stderr.destroy();
+        child.kill("SIGTERM");
+        child.unref();
+    }
+    async ensureInstalled(signal) {
+        if ((await isExecutable(WINDOWS_HELPER_PATH)) && this.installChecked)
+            return;
+        // Re-enter Electron and Bun standalone hosts as their JavaScript runtimes.
+        await runProcess(process.execPath, [SETUP_HELPER_SCRIPT, "--platform", "windows", "--runtime"], HELPER_SETUP_TIMEOUT_MS, signal, { ...process.env, ELECTRON_RUN_AS_NODE: "1", BUN_BE_BUN: "1" });
+        this.installChecked = true;
+        if (!(await isExecutable(WINDOWS_HELPER_PATH)))
+            throw new Error(`Failed to install Windows helper at ${WINDOWS_HELPER_PATH}.`);
+    }
+    async process(signal) {
+        await this.ensureInstalled(signal);
+        if (this.child && this.child.exitCode === null && !this.child.killed)
+            return this.child;
+        const child = spawn(WINDOWS_HELPER_PATH, [], { stdio: ["pipe", "pipe", "pipe"] });
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdin.setDefaultEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.onStdout(chunk));
+        child.on("exit", () => {
+            if (this.child === child)
+                this.child = undefined;
+        });
+        child.on("error", () => {
+            if (this.child === child)
+                this.child = undefined;
+        });
+        this.child = child;
+        this.buffer = "";
+        return child;
+    }
+    onStdout(chunk) {
+        this.buffer += chunk;
+        for (;;) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline < 0)
+                return;
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line)
+                continue;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const pending = this.pending.get(parsed.id);
+            if (!pending)
+                continue;
+            this.pending.delete(parsed.id);
+            clearTimeout(pending.timer);
+            if (parsed.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {
+                pending.reject(new Error(`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${parsed.protocolVersion ?? "unknown"}. Restart Pi to use the installed helper.`));
+            }
+            else if (parsed.ok === true) {
+                pending.resolve(parsed.result);
+            }
+            else {
+                const error = new Error(parsed.error?.message ?? "Windows helper command failed.");
+                error.code = parsed.error?.code;
+                pending.reject(error);
+            }
+        }
+    }
+    async command(cmd, args = {}, options) {
+        const child = await this.process(options?.signal);
+        const id = randomUUID();
+        const timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Helper command '${cmd}' timed out after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            child.stdin.write(`${JSON.stringify({ protocolVersion: WINDOWS_HELPER_PROTOCOL_VERSION, id, cmd, args })}\n`, (error) => {
+                if (!error)
+                    return;
+                this.pending.delete(id);
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+}
+export const windowsHelper = new WindowsHelperClient();
+//# sourceMappingURL=helper.js.map