@hoilab/ada-cli 0.84.21 → 0.85.0

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":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AACzD,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AACxD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,mBAAmB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,iBAAiB,CAAC;IAC9D,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,IAAI,GAAG,mBAAmB,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,IAAI,GAAG,UAAU,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AACtG,KAAK,sBAAsB,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAClF,KAAK,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AACvD,KAAK,wBAAwB,GAAG;IAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GACtD,CACG;IACA,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,wBAAwB,CAAC;CACxF,GACD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,wBAAwB,CAAA;CAAE,GAC1E;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,wBAAwB,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,wBAAwB,CAAA;CAAE,GAC7E;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,wBAAwB,CAAA;CAAE,GAC7F;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,wBAAwB,CAAA;CAAE,GAChF;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAC3D,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACvC,mGAAmG;IACnG,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,YAAY,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnF,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACrE,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC9F,OAAO,CACN,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,GAAG,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnH,gFAAgF;IAChF,QAAQ,CAAC,CACR,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,QAAQ,CACP,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,OAAO,CACN,IAAI,EAAE,sBAAsB,EAC5B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,mBAAmB,CAClB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;CACpB","sourcesContent":["import type { ExtensionContext } from \"../../../extensions/types.ts\";\nimport type { LookResponse } from \"../outline.ts\";\nimport type { PermissionStatus } from \"../permissions.ts\";\n\nexport type PlatformName = \"macos\" | \"windows\" | \"linux\";\nexport type NativeInputDelivery = \"hid\" | \"pid\";\nexport type ActOutcome = \"worked\" | \"didnt\" | \"unknown\";\n/**\n * Best-effort presentation hint for a root. The seam guarantees only the\n * `window` vs transient distinction; specific transient kinds are display hints\n * and must never drive behavior in shared code. Platforms that need precise\n * distinctions internally should use native signals.\n */\nexport type PlatformRootKind = \"window\" | \"menu\" | \"sheet\" | \"popover\" | \"dialog\";\n\nexport interface PlatformDiagnostics {\n\tprotocolVersion: number;\n\tarchitectureVersion?: number;\n\tinvariants?: string[];\n\tpid: number;\n\tparentPid?: number;\n\tparentAppName?: string;\n\tparentBundleId?: string;\n\tparentPath?: string;\n\texecutablePath?: string;\n\tos?: string;\n\tarch?: string;\n\taccessibility?: boolean;\n\tscreenRecording?: boolean;\n}\n\nexport interface PlatformReadyState {\n\tpermissionStatus?: PermissionStatus;\n\tlastPermissionCheckAt: number;\n\thelperDiagnostics?: PlatformDiagnostics;\n}\n\nexport interface PlatformRootQuery {\n\tpid?: number;\n\ttitle?: string;\n}\n\nexport interface PlatformApp {\n\tappName: string;\n\tbundleId?: string;\n\tpid: number;\n\tisFrontmost?: boolean;\n}\n\nexport interface FramePoints {\n\tx: number;\n\ty: number;\n\tw: number;\n\th: number;\n}\n\nexport interface PlatformRoot {\n\tkind: PlatformRootKind;\n\trootRef?: string;\n\twindowRef?: string;\n\twindowId?: number;\n\tpid?: number;\n\tappName?: string;\n\tbundleId?: string;\n\ttitle: string;\n\trole?: string;\n\tsubrole?: string;\n\tzOrder: number;\n\tframePoints: FramePoints;\n\tscaleFactor: number;\n\tisOnscreen: boolean;\n\tisFocused: boolean;\n\tisMinimized: boolean;\n\t/** Best-effort; platforms without a main-window concept may mirror `isFocused`. */\n\tisMain: boolean;\n\t/** Platform-reported modality fact, including platform-specific modal/dialog/sheet signals. */\n\tisModal: boolean;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface PlatformFrontmostResult {\n\tappName: string;\n\tbundleId?: string;\n\tpid: number;\n\twindowTitle?: string;\n\twindowId?: number;\n\trootRef?: string;\n}\n\nexport interface PlatformFocusWindowResult {\n\tfocused: boolean;\n\talreadyFocused?: boolean;\n\treason?: string;\n}\n\nexport interface HelperActPerformed {\n\tgrounding?: \"description\" | \"coordinates\" | \"keyboard-events\";\n\t/** `ax` means the platform accessibility API (AX on macOS, UIA on Windows). */\n\tdelivery?: \"ax\" | NativeInputDelivery;\n\trefound?: boolean;\n\t/** Free-form diagnostic naming the platform's delta mechanism. */\n\tdeltaSource?: string;\n\tselectionGrounding?: \"ax\" | \"keyboard\";\n\ttransaction?: boolean;\n\tactionCount?: number;\n\tactivated?: boolean;\n\traised?: boolean;\n\tfocused?: boolean;\n}\n\nexport interface PlatformRootDelta {\n\tchange: \"appeared\" | \"closed\" | \"focused\";\n\tkind: string;\n\tref?: string;\n\ttitle?: string;\n\tpid: number;\n\tisModal?: boolean;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface HelperActResult {\n\toutcome: ActOutcome;\n\tperformed?: HelperActPerformed;\n\tevidence?: Record<string, unknown>;\n\terror?: { code?: string; message?: string; whatIsThere?: unknown };\n\trootDelta?: PlatformRootDelta[];\n\tsteps?: HelperActResult[];\n\tstoppedAt?: number;\n}\n\nexport interface PlatformTarget {\n\tpid?: number;\n\twindowId?: number;\n\trootRef?: string;\n}\n\nexport interface PlatformObserveRequest {\n\ttarget: PlatformTarget;\n\t/** Existing immutable look whose untouched refs/coordinate geometry survive a scoped refresh. */\n\tbaseLookId?: string;\n\treadText: \"auto\" | \"always\" | \"never\";\n\tscopeRef?: string;\n\tmaxDimension?: number;\n\tincludeImage?: boolean;\n}\n\nexport type PlatformActTarget = { ref: string } | { x: number; y: number } | { focus: PlatformPoint };\ntype PlatformDeliveryPolicy = \"ax_only\" | \"background\" | \"default\" | \"foreground\";\ntype PlatformMouseButton = \"left\" | \"right\" | \"middle\";\ntype PlatformActDeliveryParam = { delivery?: NativeInputDelivery };\nexport type PlatformPoint = { x: number; y: number };\n\nexport interface PlatformActRequestBase {\n\tlookId: string;\n\tpid?: number;\n\ttarget: PlatformActTarget;\n\tpolicy: PlatformDeliveryPolicy;\n}\n\nexport type PlatformActRequest = PlatformActRequestBase &\n\t(\n\t\t| {\n\t\t\t\taction: \"press\" | \"click\";\n\t\t\t\tparams: { button?: PlatformMouseButton; clickCount?: number } & PlatformActDeliveryParam;\n\t\t  }\n\t\t| { action: \"setText\"; params: { text: string } & PlatformActDeliveryParam }\n\t\t| { action: \"typeText\"; params: { text: string } & PlatformActDeliveryParam }\n\t\t| { action: \"keypress\"; params: { keys: string[] } & PlatformActDeliveryParam }\n\t\t| { action: \"scroll\"; params: { scrollX: number; scrollY: number } & PlatformActDeliveryParam }\n\t\t| { action: \"drag\"; params: { path: PlatformPoint[] } & PlatformActDeliveryParam }\n\t\t| { action: \"moveMouse\"; params: PlatformActDeliveryParam }\n\t);\n\nexport interface PlatformReadTextRequest {\n\t/** Observation that owns the element ref. Native backends must not resolve across observations. */\n\tlookId: string;\n\telementRef: string;\n\toffset: number;\n\tlimit: number;\n}\n\nexport interface PlatformReadTextResponse {\n\ttext: string;\n\toffset: number;\n\tlimit: number;\n\ttotalChars: number;\n\thasMore: boolean;\n}\n\nexport interface PlatformWaitForRequest extends PlatformTarget {\n\tlookId?: string;\n\ttext?: string;\n\trole?: string;\n\tvalue?: string;\n\tscopeRef?: string;\n\tscopeExact?: boolean;\n\tgone: boolean;\n\ttimeoutMs: number;\n}\n\nexport interface PlatformWaitForResponse {\n\tfound: boolean;\n\tgone?: boolean;\n\ttimedOut?: boolean;\n\tnodeCount?: number;\n}\n\nexport interface ComputerUsePlatformBackend {\n\tname: PlatformName;\n\t/** Release process-local resources when the Pi session is torn down. */\n\tshutdown?(): void | Promise<void>;\n\tensureReady(ctx: ExtensionContext, state: PlatformReadyState, signal?: AbortSignal): Promise<PlatformReadyState>;\n\tlistApps(signal?: AbortSignal): Promise<PlatformApp[]>;\n\tlistRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]>;\n\tgetFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult>;\n\tfocusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult>;\n\tobserve(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse>;\n\tact(request: PlatformActRequest, options?: { timeoutMs?: number; signal?: AbortSignal }): Promise<HelperActResult>;\n\t/** Execute one-resource actions with one root baseline and one final settle. */\n\tactBatch?(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult>;\n\treadText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse>;\n\twaitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse>;\n\tisBrowserApp(appName: string, bundleId?: string): boolean;\n\tisChromeFamilyApp(appName: string, bundleId?: string): boolean;\n\topenBrowserLocation(\n\t\ttarget: { appName: string; bundleId?: string },\n\t\turl: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<boolean>;\n}\n"]}

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":"","sourcesContent":["import type { ExtensionContext } from \"../../../extensions/types.ts\";\nimport type { LookResponse } from \"../outline.ts\";\nimport type { PermissionStatus } from \"../permissions.ts\";\n\nexport type PlatformName = \"macos\" | \"windows\" | \"linux\";\nexport type NativeInputDelivery = \"hid\" | \"pid\";\nexport type ActOutcome = \"worked\" | \"didnt\" | \"unknown\";\n/**\n * Best-effort presentation hint for a root. The seam guarantees only the\n * `window` vs transient distinction; specific transient kinds are display hints\n * and must never drive behavior in shared code. Platforms that need precise\n * distinctions internally should use native signals.\n */\nexport type PlatformRootKind = \"window\" | \"menu\" | \"sheet\" | \"popover\" | \"dialog\";\n\nexport interface PlatformDiagnostics {\n\tprotocolVersion: number;\n\tarchitectureVersion?: number;\n\tinvariants?: string[];\n\tpid: number;\n\tparentPid?: number;\n\tparentAppName?: string;\n\tparentBundleId?: string;\n\tparentPath?: string;\n\texecutablePath?: string;\n\tos?: string;\n\tarch?: string;\n\taccessibility?: boolean;\n\tscreenRecording?: boolean;\n}\n\nexport interface PlatformReadyState {\n\tpermissionStatus?: PermissionStatus;\n\tlastPermissionCheckAt: number;\n\thelperDiagnostics?: PlatformDiagnostics;\n}\n\nexport interface PlatformRootQuery {\n\tpid?: number;\n\ttitle?: string;\n}\n\nexport interface PlatformApp {\n\tappName: string;\n\tbundleId?: string;\n\tpid: number;\n\tisFrontmost?: boolean;\n}\n\nexport interface FramePoints {\n\tx: number;\n\ty: number;\n\tw: number;\n\th: number;\n}\n\nexport interface PlatformRoot {\n\tkind: PlatformRootKind;\n\trootRef?: string;\n\twindowRef?: string;\n\twindowId?: number;\n\tpid?: number;\n\tappName?: string;\n\tbundleId?: string;\n\ttitle: string;\n\trole?: string;\n\tsubrole?: string;\n\tzOrder: number;\n\tframePoints: FramePoints;\n\tscaleFactor: number;\n\tisOnscreen: boolean;\n\tisFocused: boolean;\n\tisMinimized: boolean;\n\t/** Best-effort; platforms without a main-window concept may mirror `isFocused`. */\n\tisMain: boolean;\n\t/** Platform-reported modality fact, including platform-specific modal/dialog/sheet signals. */\n\tisModal: boolean;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface PlatformFrontmostResult {\n\tappName: string;\n\tbundleId?: string;\n\tpid: number;\n\twindowTitle?: string;\n\twindowId?: number;\n\trootRef?: string;\n}\n\nexport interface PlatformFocusWindowResult {\n\tfocused: boolean;\n\talreadyFocused?: boolean;\n\treason?: string;\n}\n\nexport interface HelperActPerformed {\n\tgrounding?: \"description\" | \"coordinates\" | \"keyboard-events\";\n\t/** `ax` means the platform accessibility API (AX on macOS, UIA on Windows). */\n\tdelivery?: \"ax\" | NativeInputDelivery;\n\trefound?: boolean;\n\t/** Free-form diagnostic naming the platform's delta mechanism. */\n\tdeltaSource?: string;\n\tselectionGrounding?: \"ax\" | \"keyboard\";\n\ttransaction?: boolean;\n\tactionCount?: number;\n\tactivated?: boolean;\n\traised?: boolean;\n\tfocused?: boolean;\n}\n\nexport interface PlatformRootDelta {\n\tchange: \"appeared\" | \"closed\" | \"focused\";\n\tkind: string;\n\tref?: string;\n\ttitle?: string;\n\tpid: number;\n\tisModal?: boolean;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface HelperActResult {\n\toutcome: ActOutcome;\n\tperformed?: HelperActPerformed;\n\tevidence?: Record<string, unknown>;\n\terror?: { code?: string; message?: string; whatIsThere?: unknown };\n\trootDelta?: PlatformRootDelta[];\n\tsteps?: HelperActResult[];\n\tstoppedAt?: number;\n}\n\nexport interface PlatformTarget {\n\tpid?: number;\n\twindowId?: number;\n\trootRef?: string;\n}\n\nexport interface PlatformObserveRequest {\n\ttarget: PlatformTarget;\n\t/** Existing immutable look whose untouched refs/coordinate geometry survive a scoped refresh. */\n\tbaseLookId?: string;\n\treadText: \"auto\" | \"always\" | \"never\";\n\tscopeRef?: string;\n\tmaxDimension?: number;\n\tincludeImage?: boolean;\n}\n\nexport type PlatformActTarget = { ref: string } | { x: number; y: number } | { focus: PlatformPoint };\ntype PlatformDeliveryPolicy = \"ax_only\" | \"background\" | \"default\" | \"foreground\";\ntype PlatformMouseButton = \"left\" | \"right\" | \"middle\";\ntype PlatformActDeliveryParam = { delivery?: NativeInputDelivery };\nexport type PlatformPoint = { x: number; y: number };\n\nexport interface PlatformActRequestBase {\n\tlookId: string;\n\tpid?: number;\n\ttarget: PlatformActTarget;\n\tpolicy: PlatformDeliveryPolicy;\n}\n\nexport type PlatformActRequest = PlatformActRequestBase &\n\t(\n\t\t| {\n\t\t\t\taction: \"press\" | \"click\";\n\t\t\t\tparams: { button?: PlatformMouseButton; clickCount?: number } & PlatformActDeliveryParam;\n\t\t  }\n\t\t| { action: \"setText\"; params: { text: string } & PlatformActDeliveryParam }\n\t\t| { action: \"typeText\"; params: { text: string } & PlatformActDeliveryParam }\n\t\t| { action: \"keypress\"; params: { keys: string[] } & PlatformActDeliveryParam }\n\t\t| { action: \"scroll\"; params: { scrollX: number; scrollY: number } & PlatformActDeliveryParam }\n\t\t| { action: \"drag\"; params: { path: PlatformPoint[] } & PlatformActDeliveryParam }\n\t\t| { action: \"moveMouse\"; params: PlatformActDeliveryParam }\n\t);\n\nexport interface PlatformReadTextRequest {\n\t/** Observation that owns the element ref. Native backends must not resolve across observations. */\n\tlookId: string;\n\telementRef: string;\n\toffset: number;\n\tlimit: number;\n}\n\nexport interface PlatformReadTextResponse {\n\ttext: string;\n\toffset: number;\n\tlimit: number;\n\ttotalChars: number;\n\thasMore: boolean;\n}\n\nexport interface PlatformWaitForRequest extends PlatformTarget {\n\tlookId?: string;\n\ttext?: string;\n\trole?: string;\n\tvalue?: string;\n\tscopeRef?: string;\n\tscopeExact?: boolean;\n\tgone: boolean;\n\ttimeoutMs: number;\n}\n\nexport interface PlatformWaitForResponse {\n\tfound: boolean;\n\tgone?: boolean;\n\ttimedOut?: boolean;\n\tnodeCount?: number;\n}\n\nexport interface ComputerUsePlatformBackend {\n\tname: PlatformName;\n\t/** Release process-local resources when the Pi session is torn down. */\n\tshutdown?(): void | Promise<void>;\n\tensureReady(ctx: ExtensionContext, state: PlatformReadyState, signal?: AbortSignal): Promise<PlatformReadyState>;\n\tlistApps(signal?: AbortSignal): Promise<PlatformApp[]>;\n\tlistRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]>;\n\tgetFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult>;\n\tfocusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult>;\n\tobserve(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse>;\n\tact(request: PlatformActRequest, options?: { timeoutMs?: number; signal?: AbortSignal }): Promise<HelperActResult>;\n\t/** Execute one-resource actions with one root baseline and one final settle. */\n\tactBatch?(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult>;\n\treadText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse>;\n\twaitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse>;\n\tisBrowserApp(appName: string, bundleId?: string): boolean;\n\tisChromeFamilyApp(appName: string, bundleId?: string): boolean;\n\topenBrowserLocation(\n\t\ttarget: { appName: string; bundleId?: string },\n\t\turl: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<boolean>;\n}\n"]}

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","sourcesContent":["import { type LookResponse, parseLookResponse } from \"../../outline.ts\";\nimport { assertPlatformArchitecture } from \"../architecture.ts\";\nimport { toBoolean, toFiniteNumber, toOptionalString } from \"../coerce.ts\";\nimport type {\n\tComputerUsePlatformBackend,\n\tFramePoints,\n\tHelperActResult,\n\tPlatformActRequest,\n\tPlatformApp,\n\tPlatformFocusWindowResult,\n\tPlatformFrontmostResult,\n\tPlatformObserveRequest,\n\tPlatformReadTextRequest,\n\tPlatformReadTextResponse,\n\tPlatformReadyState,\n\tPlatformRoot,\n\tPlatformRootKind,\n\tPlatformRootQuery,\n\tPlatformTarget,\n\tPlatformWaitForRequest,\n\tPlatformWaitForResponse,\n} from \"../types.ts\";\nimport { WINDOWS_HELPER_PROTOCOL_VERSION, windowsHelper } from \"./helper.ts\";\n\nfunction normalizedProcessName(appName: string): string {\n\treturn appName.toLowerCase().replace(/\\.exe$/i, \"\");\n}\n\nfunction classifyBrowser(appName: string): false | \"chrome\" | \"edge\" | \"brave\" | \"firefox\" | \"vivaldi\" | \"opera\" {\n\tswitch (normalizedProcessName(appName)) {\n\t\tcase \"chrome\":\n\t\tcase \"chromium\":\n\t\t\treturn \"chrome\";\n\t\tcase \"msedge\":\n\t\tcase \"edge\":\n\t\t\treturn \"edge\";\n\t\tcase \"brave\":\n\t\tcase \"brave-browser\":\n\t\t\treturn \"brave\";\n\t\tcase \"firefox\":\n\t\t\treturn \"firefox\";\n\t\tcase \"vivaldi\":\n\t\t\treturn \"vivaldi\";\n\t\tcase \"opera\":\n\t\tcase \"opera_gx\":\n\t\t\treturn \"opera\";\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\nfunction parseFramePoints(raw: unknown): FramePoints {\n\tconst frame = (raw as any)?.framePoints ?? (raw as any)?.bounds ?? {};\n\treturn {\n\t\tx: toFiniteNumber(frame.x, 0),\n\t\ty: toFiniteNumber(frame.y, 0),\n\t\tw: Math.max(1, toFiniteNumber(frame.w ?? frame.width, 1)),\n\t\th: Math.max(1, toFiniteNumber(frame.h ?? frame.height, 1)),\n\t};\n}\n\nfunction parseRootKind(raw: unknown): PlatformRootKind {\n\treturn raw === \"menu\" || raw === \"dialog\" || raw === \"popover\" || raw === \"window\" ? raw : \"window\";\n}\n\nfunction parseRoots(result: unknown): PlatformRoot[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.roots;\n\tif (!Array.isArray(array)) return [];\n\treturn array.map((raw: any, index): PlatformRoot => {\n\t\treturn {\n\t\t\tkind: parseRootKind(raw?.kind),\n\t\t\trootRef: toOptionalString(raw?.rootRef ?? raw?.windowRef ?? raw?.ref),\n\t\t\twindowRef: toOptionalString(raw?.windowRef ?? raw?.rootRef ?? raw?.ref),\n\t\t\twindowId: Number.isFinite(raw?.windowId) ? Math.trunc(raw.windowId) : undefined,\n\t\t\tpid: Number.isFinite(raw?.pid) ? Math.trunc(raw.pid) : undefined,\n\t\t\tappName: toOptionalString(raw?.appName ?? raw?.processName),\n\t\t\tbundleId: toOptionalString(raw?.bundleId),\n\t\t\ttitle: toOptionalString(raw?.title) ?? \"\",\n\t\t\trole: toOptionalString(raw?.role),\n\t\t\tsubrole: toOptionalString(raw?.subrole),\n\t\t\tzOrder: Math.trunc(toFiniteNumber(raw?.zOrder, index)),\n\t\t\tframePoints: parseFramePoints(raw),\n\t\t\tscaleFactor: Math.max(1, toFiniteNumber(raw?.scaleFactor, 1)),\n\t\t\tisOnscreen: raw?.isOnscreen === undefined ? true : toBoolean(raw?.isOnscreen),\n\t\t\tisFocused: toBoolean(raw?.isFocused),\n\t\t\tisMinimized: toBoolean(raw?.isMinimized),\n\t\t\tisMain: toBoolean(raw?.isMain ?? raw?.isFocused),\n\t\t\tisModal: toBoolean(raw?.isModal),\n\t\t\tmetadata: raw?.metadata,\n\t\t};\n\t});\n}\n\nfunction appsFromRoots(roots: PlatformRoot[]): PlatformApp[] {\n\tconst seen = new Set<number>();\n\treturn roots.flatMap((root) => {\n\t\tif (!root.pid || seen.has(root.pid)) return [];\n\t\tseen.add(root.pid);\n\t\treturn [\n\t\t\t{ appName: root.appName ?? \"Unknown\", bundleId: root.bundleId, pid: root.pid, isFrontmost: root.isFocused },\n\t\t];\n\t});\n}\n\nfunction helperAction(request: PlatformActRequest): Record<string, unknown> {\n\tif (!(\"focus\" in request.target)) return { ...request };\n\treturn { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };\n}\n\nasync function ensureReady(\n\t_ctx: unknown,\n\tstate: PlatformReadyState,\n\tsignal?: AbortSignal,\n): Promise<PlatformReadyState> {\n\tawait windowsHelper.ensureInstalled(signal);\n\tconst diagnostics = await windowsHelper.command<any>(\"diagnostics\", {}, { signal, timeoutMs: 5_000 });\n\tif (diagnostics?.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {\n\t\tthrow new Error(\n\t\t\t`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${diagnostics?.protocolVersion ?? \"unknown\"}. Restart Pi to use the installed helper.`,\n\t\t);\n\t}\n\tassertPlatformArchitecture(\"Windows\", diagnostics);\n\treturn { ...state, lastPermissionCheckAt: Date.now(), helperDiagnostics: diagnostics };\n}\n\nexport const windowsBackend: ComputerUsePlatformBackend = {\n\tname: \"windows\",\n\tshutdown(): void {\n\t\twindowsHelper.dispose();\n\t},\n\tensureReady,\n\tasync listApps(signal?: AbortSignal): Promise<PlatformApp[]> {\n\t\treturn appsFromRoots(parseRoots(await windowsHelper.command(\"listRoots\", {}, { signal })));\n\t},\n\tasync listRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]> {\n\t\tconst roots = parseRoots(\n\t\t\tawait windowsHelper.command(\"listRoots\", Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid!) } : {}, {\n\t\t\t\tsignal,\n\t\t\t}),\n\t\t);\n\t\tconst title = query.title?.trim().toLowerCase();\n\t\treturn title ? roots.filter((root) => root.title.trim().toLowerCase().includes(title)) : roots;\n\t},\n\tasync getFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult> {\n\t\tconst roots = parseRoots(await windowsHelper.command(\"listRoots\", {}, { signal }));\n\t\tconst focused = roots.find((root) => root.isFocused) ?? roots[0];\n\t\tif (!focused?.pid) throw new Error(\"No frontmost window was available.\");\n\t\treturn {\n\t\t\tappName: focused.appName ?? \"Unknown\",\n\t\t\tbundleId: focused.bundleId,\n\t\t\tpid: focused.pid,\n\t\t\twindowTitle: focused.title,\n\t\t\twindowId: focused.windowId,\n\t\t\trootRef: focused.rootRef,\n\t\t};\n\t},\n\tasync focusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult> {\n\t\treturn await windowsHelper.command<PlatformFocusWindowResult>(\"focusWindow\", { ...target }, { signal });\n\t},\n\tasync observe(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse> {\n\t\treturn parseLookResponse(\n\t\t\tawait windowsHelper.command(\n\t\t\t\t\"look\",\n\t\t\t\t{\n\t\t\t\t\t...request.target,\n\t\t\t\t\tbaseLookId: request.baseLookId,\n\t\t\t\t\tmaxDimension: request.maxDimension,\n\t\t\t\t\treadText: request.readText,\n\t\t\t\t\tscopeRef: request.scopeRef,\n\t\t\t\t\tincludeImage: request.includeImage,\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t\t);\n\t},\n\tasync act(\n\t\trequest: PlatformActRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await windowsHelper.command<HelperActResult>(\"act\", helperAction(request), options);\n\t},\n\tasync actBatch(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await windowsHelper.command<HelperActResult>(\"actBatch\", { actions: requests.map(helperAction) }, options);\n\t},\n\tasync readText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse> {\n\t\treturn await windowsHelper.command(\"uiaReadText\", { ...args }, options);\n\t},\n\tasync waitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse> {\n\t\treturn await windowsHelper.command(\"uiaWaitFor\", { ...args }, options);\n\t},\n\tisBrowserApp(appName: string): boolean {\n\t\treturn classifyBrowser(appName) !== false;\n\t},\n\tisChromeFamilyApp(appName: string): boolean {\n\t\treturn (\n\t\t\tclassifyBrowser(appName) === \"chrome\" ||\n\t\t\tclassifyBrowser(appName) === \"edge\" ||\n\t\t\tclassifyBrowser(appName) === \"brave\"\n\t\t);\n\t},\n\tasync openBrowserLocation(\n\t\ttarget: { appName: string; bundleId?: string },\n\t\turl: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<boolean> {\n\t\tawait windowsHelper.command(\"openBrowserLocation\", { ...target, url }, { signal, timeoutMs: 10_000 });\n\t\treturn true;\n\t},\n};\n"]}

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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","sourcesContent":["import { type LookResponse, parseLookResponse } from \"../../outline.ts\";\nimport { assertPlatformArchitecture } from \"../architecture.ts\";\nimport { toBoolean, toFiniteNumber, toOptionalString } from \"../coerce.ts\";\nimport type {\n\tComputerUsePlatformBackend,\n\tFramePoints,\n\tHelperActResult,\n\tPlatformActRequest,\n\tPlatformApp,\n\tPlatformFocusWindowResult,\n\tPlatformFrontmostResult,\n\tPlatformObserveRequest,\n\tPlatformReadTextRequest,\n\tPlatformReadTextResponse,\n\tPlatformReadyState,\n\tPlatformRoot,\n\tPlatformRootKind,\n\tPlatformRootQuery,\n\tPlatformTarget,\n\tPlatformWaitForRequest,\n\tPlatformWaitForResponse,\n} from \"../types.ts\";\nimport { WINDOWS_HELPER_PROTOCOL_VERSION, windowsHelper } from \"./helper.ts\";\n\nfunction normalizedProcessName(appName: string): string {\n\treturn appName.toLowerCase().replace(/\\.exe$/i, \"\");\n}\n\nfunction classifyBrowser(appName: string): false | \"chrome\" | \"edge\" | \"brave\" | \"firefox\" | \"vivaldi\" | \"opera\" {\n\tswitch (normalizedProcessName(appName)) {\n\t\tcase \"chrome\":\n\t\tcase \"chromium\":\n\t\t\treturn \"chrome\";\n\t\tcase \"msedge\":\n\t\tcase \"edge\":\n\t\t\treturn \"edge\";\n\t\tcase \"brave\":\n\t\tcase \"brave-browser\":\n\t\t\treturn \"brave\";\n\t\tcase \"firefox\":\n\t\t\treturn \"firefox\";\n\t\tcase \"vivaldi\":\n\t\t\treturn \"vivaldi\";\n\t\tcase \"opera\":\n\t\tcase \"opera_gx\":\n\t\t\treturn \"opera\";\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\nfunction parseFramePoints(raw: unknown): FramePoints {\n\tconst frame = (raw as any)?.framePoints ?? (raw as any)?.bounds ?? {};\n\treturn {\n\t\tx: toFiniteNumber(frame.x, 0),\n\t\ty: toFiniteNumber(frame.y, 0),\n\t\tw: Math.max(1, toFiniteNumber(frame.w ?? frame.width, 1)),\n\t\th: Math.max(1, toFiniteNumber(frame.h ?? frame.height, 1)),\n\t};\n}\n\nfunction parseRootKind(raw: unknown): PlatformRootKind {\n\treturn raw === \"menu\" || raw === \"dialog\" || raw === \"popover\" || raw === \"window\" ? raw : \"window\";\n}\n\nfunction parseRoots(result: unknown): PlatformRoot[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.roots;\n\tif (!Array.isArray(array)) return [];\n\treturn array.map((raw: any, index): PlatformRoot => {\n\t\treturn {\n\t\t\tkind: parseRootKind(raw?.kind),\n\t\t\trootRef: toOptionalString(raw?.rootRef ?? raw?.windowRef ?? raw?.ref),\n\t\t\twindowRef: toOptionalString(raw?.windowRef ?? raw?.rootRef ?? raw?.ref),\n\t\t\twindowId: Number.isFinite(raw?.windowId) ? Math.trunc(raw.windowId) : undefined,\n\t\t\tpid: Number.isFinite(raw?.pid) ? Math.trunc(raw.pid) : undefined,\n\t\t\tappName: toOptionalString(raw?.appName ?? raw?.processName),\n\t\t\tbundleId: toOptionalString(raw?.bundleId),\n\t\t\ttitle: toOptionalString(raw?.title) ?? \"\",\n\t\t\trole: toOptionalString(raw?.role),\n\t\t\tsubrole: toOptionalString(raw?.subrole),\n\t\t\tzOrder: Math.trunc(toFiniteNumber(raw?.zOrder, index)),\n\t\t\tframePoints: parseFramePoints(raw),\n\t\t\tscaleFactor: Math.max(1, toFiniteNumber(raw?.scaleFactor, 1)),\n\t\t\tisOnscreen: raw?.isOnscreen === undefined ? true : toBoolean(raw?.isOnscreen),\n\t\t\tisFocused: toBoolean(raw?.isFocused),\n\t\t\tisMinimized: toBoolean(raw?.isMinimized),\n\t\t\tisMain: toBoolean(raw?.isMain ?? raw?.isFocused),\n\t\t\tisModal: toBoolean(raw?.isModal),\n\t\t\tmetadata: raw?.metadata,\n\t\t};\n\t});\n}\n\nfunction appsFromRoots(roots: PlatformRoot[]): PlatformApp[] {\n\tconst seen = new Set<number>();\n\treturn roots.flatMap((root) => {\n\t\tif (!root.pid || seen.has(root.pid)) return [];\n\t\tseen.add(root.pid);\n\t\treturn [\n\t\t\t{ appName: root.appName ?? \"Unknown\", bundleId: root.bundleId, pid: root.pid, isFrontmost: root.isFocused },\n\t\t];\n\t});\n}\n\nfunction helperAction(request: PlatformActRequest): Record<string, unknown> {\n\tif (!(\"focus\" in request.target)) return { ...request };\n\treturn { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };\n}\n\nasync function ensureReady(\n\t_ctx: unknown,\n\tstate: PlatformReadyState,\n\tsignal?: AbortSignal,\n): Promise<PlatformReadyState> {\n\tawait windowsHelper.ensureInstalled(signal);\n\tconst diagnostics = await windowsHelper.command<any>(\"diagnostics\", {}, { signal, timeoutMs: 5_000 });\n\tif (diagnostics?.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {\n\t\tthrow new Error(\n\t\t\t`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${diagnostics?.protocolVersion ?? \"unknown\"}. Restart Pi to use the installed helper.`,\n\t\t);\n\t}\n\tassertPlatformArchitecture(\"Windows\", diagnostics);\n\treturn { ...state, lastPermissionCheckAt: Date.now(), helperDiagnostics: diagnostics };\n}\n\nexport const windowsBackend: ComputerUsePlatformBackend = {\n\tname: \"windows\",\n\tshutdown(): void {\n\t\twindowsHelper.dispose();\n\t},\n\tensureReady,\n\tasync listApps(signal?: AbortSignal): Promise<PlatformApp[]> {\n\t\treturn appsFromRoots(parseRoots(await windowsHelper.command(\"listRoots\", {}, { signal })));\n\t},\n\tasync listRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]> {\n\t\tconst roots = parseRoots(\n\t\t\tawait windowsHelper.command(\"listRoots\", Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid!) } : {}, {\n\t\t\t\tsignal,\n\t\t\t}),\n\t\t);\n\t\tconst title = query.title?.trim().toLowerCase();\n\t\treturn title ? roots.filter((root) => root.title.trim().toLowerCase().includes(title)) : roots;\n\t},\n\tasync getFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult> {\n\t\tconst roots = parseRoots(await windowsHelper.command(\"listRoots\", {}, { signal }));\n\t\tconst focused = roots.find((root) => root.isFocused) ?? roots[0];\n\t\tif (!focused?.pid) throw new Error(\"No frontmost window was available.\");\n\t\treturn {\n\t\t\tappName: focused.appName ?? \"Unknown\",\n\t\t\tbundleId: focused.bundleId,\n\t\t\tpid: focused.pid,\n\t\t\twindowTitle: focused.title,\n\t\t\twindowId: focused.windowId,\n\t\t\trootRef: focused.rootRef,\n\t\t};\n\t},\n\tasync focusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult> {\n\t\treturn await windowsHelper.command<PlatformFocusWindowResult>(\"focusWindow\", { ...target }, { signal });\n\t},\n\tasync observe(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse> {\n\t\treturn parseLookResponse(\n\t\t\tawait windowsHelper.command(\n\t\t\t\t\"look\",\n\t\t\t\t{\n\t\t\t\t\t...request.target,\n\t\t\t\t\tbaseLookId: request.baseLookId,\n\t\t\t\t\tmaxDimension: request.maxDimension,\n\t\t\t\t\treadText: request.readText,\n\t\t\t\t\tscopeRef: request.scopeRef,\n\t\t\t\t\tincludeImage: request.includeImage,\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t\t);\n\t},\n\tasync act(\n\t\trequest: PlatformActRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await windowsHelper.command<HelperActResult>(\"act\", helperAction(request), options);\n\t},\n\tasync actBatch(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await windowsHelper.command<HelperActResult>(\"actBatch\", { actions: requests.map(helperAction) }, options);\n\t},\n\tasync readText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse> {\n\t\treturn await windowsHelper.command(\"uiaReadText\", { ...args }, options);\n\t},\n\tasync waitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse> {\n\t\treturn await windowsHelper.command(\"uiaWaitFor\", { ...args }, options);\n\t},\n\tisBrowserApp(appName: string): boolean {\n\t\treturn classifyBrowser(appName) !== false;\n\t},\n\tisChromeFamilyApp(appName: string): boolean {\n\t\treturn (\n\t\t\tclassifyBrowser(appName) === \"chrome\" ||\n\t\t\tclassifyBrowser(appName) === \"edge\" ||\n\t\t\tclassifyBrowser(appName) === \"brave\"\n\t\t);\n\t},\n\tasync openBrowserLocation(\n\t\ttarget: { appName: string; bundleId?: string },\n\t\turl: string,\n\t\tsignal?: AbortSignal,\n\t): Promise<boolean> {\n\t\tawait windowsHelper.command(\"openBrowserLocation\", { ...target, url }, { signal, timeoutMs: 10_000 });\n\t\treturn true;\n\t},\n};\n"]}

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,CAiBd;IAEK,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAazD;YAEa,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,CAoBZ;CACD;AAED,eAAO,MAAM,aAAa,qBAA4B,CAAC","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\");\nconst SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, \"scripts\", \"setup-helper.mjs\");\nconst HELPER_SETUP_TIMEOUT_MS = 60_000;\nconst COMMAND_TIMEOUT_MS = 15_000;\n\nexport const WINDOWS_HELPER_PROTOCOL_VERSION = 4;\nexport const WINDOWS_HELPER_PATH =\n\tprocess.env.ADA_COMPUTER_USE_WINDOWS_HELPER_PATH ||\n\tpath.join(os.homedir(), \".pi\", \"agent\", \"helpers\", \"ada-computer-use\", \"windows-bridge.exe\");\n\ninterface Pending<T> {\n\tresolve(value: T): void;\n\treject(error: Error): void;\n\ttimer: NodeJS.Timeout;\n}\n\nasync function isExecutable(filePath: string): Promise<boolean> {\n\ttry {\n\t\tawait access(filePath, fsConstants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function runProcess(\n\tcommand: string,\n\targs: string[],\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\tenv?: NodeJS.ProcessEnv,\n): Promise<void> {\n\tif (signal?.aborted) throw new Error(\"Operation aborted.\");\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, { stdio: [\"ignore\", \"pipe\", \"pipe\"], env });\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t};\n\t\tconst timer = setTimeout(() => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(\" \")}`));\n\t\t}, timeoutMs);\n\t\tconst onAbort = () => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t};\n\t\tchild.stdout.on(\"data\", (chunk) => {\n\t\t\tstdout += String(chunk);\n\t\t});\n\t\tchild.stderr.on(\"data\", (chunk) => {\n\t\t\tstderr += String(chunk);\n\t\t});\n\t\tchild.on(\"error\", (error) => {\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t});\n\t\tchild.on(\"close\", (code) => {\n\t\t\tcleanup();\n\t\t\tif (code === 0) return resolve();\n\t\t\tconst output = [stderr.trim(), stdout.trim()].filter(Boolean).join(\"\\n\");\n\t\t\treject(new Error(`Command failed (${code}): ${command} ${args.join(\" \")}\\n${output}`.trim()));\n\t\t});\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\nexport class WindowsHelperClient {\n\tprivate installChecked = false;\n\tprivate child?: ChildProcessWithoutNullStreams;\n\tprivate buffer = \"\";\n\tprivate pending = new Map<string, Pending<unknown>>();\n\n\tdispose(): void {\n\t\tconst error = new Error(\"Windows helper closed because the Pi session ended.\");\n\t\tfor (const pending of this.pending.values()) {\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.reject(error);\n\t\t}\n\t\tthis.pending.clear();\n\t\tthis.buffer = \"\";\n\n\t\tconst child = this.child;\n\t\tthis.child = undefined;\n\t\tif (!child) return;\n\t\tchild.stdin.destroy();\n\t\tchild.stdout.destroy();\n\t\tchild.stderr.destroy();\n\t\tchild.kill(\"SIGTERM\");\n\t\tchild.unref();\n\t}\n\n\tasync ensureInstalled(signal?: AbortSignal): Promise<void> {\n\t\tif ((await isExecutable(WINDOWS_HELPER_PATH)) && this.installChecked) return;\n\t\t// Re-enter Electron and Bun standalone hosts as their JavaScript runtimes.\n\t\tawait runProcess(\n\t\t\tprocess.execPath,\n\t\t\t[SETUP_HELPER_SCRIPT, \"--platform\", \"windows\", \"--runtime\"],\n\t\t\tHELPER_SETUP_TIMEOUT_MS,\n\t\t\tsignal,\n\t\t\t{ ...process.env, ELECTRON_RUN_AS_NODE: \"1\", BUN_BE_BUN: \"1\" },\n\t\t);\n\t\tthis.installChecked = true;\n\t\tif (!(await isExecutable(WINDOWS_HELPER_PATH)))\n\t\t\tthrow new Error(`Failed to install Windows helper at ${WINDOWS_HELPER_PATH}.`);\n\t}\n\n\tprivate async process(signal?: AbortSignal): Promise<ChildProcessWithoutNullStreams> {\n\t\tawait this.ensureInstalled(signal);\n\t\tif (this.child && this.child.exitCode === null && !this.child.killed) return this.child;\n\t\tconst child = spawn(WINDOWS_HELPER_PATH, [], { stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n\t\tchild.stdout.setEncoding(\"utf8\");\n\t\tchild.stderr.setEncoding(\"utf8\");\n\t\tchild.stdin.setDefaultEncoding(\"utf8\");\n\t\tchild.stdout.on(\"data\", (chunk: string) => this.onStdout(chunk));\n\t\tchild.on(\"exit\", () => {\n\t\t\tif (this.child === child) this.child = undefined;\n\t\t});\n\t\tchild.on(\"error\", () => {\n\t\t\tif (this.child === child) this.child = undefined;\n\t\t});\n\t\tthis.child = child;\n\t\tthis.buffer = \"\";\n\t\treturn child;\n\t}\n\n\tprivate onStdout(chunk: string): void {\n\t\tthis.buffer += chunk;\n\t\tfor (;;) {\n\t\t\tconst newline = this.buffer.indexOf(\"\\n\");\n\t\t\tif (newline < 0) return;\n\t\t\tconst line = this.buffer.slice(0, newline).trim();\n\t\t\tthis.buffer = this.buffer.slice(newline + 1);\n\t\t\tif (!line) continue;\n\t\t\tlet parsed: any;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(line);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst pending = this.pending.get(parsed.id);\n\t\t\tif (!pending) continue;\n\t\t\tthis.pending.delete(parsed.id);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tif (parsed.protocolVersion !== WINDOWS_HELPER_PROTOCOL_VERSION) {\n\t\t\t\tpending.reject(\n\t\t\t\t\tnew Error(\n\t\t\t\t\t\t`Windows helper protocol mismatch: expected ${WINDOWS_HELPER_PROTOCOL_VERSION}, got ${parsed.protocolVersion ?? \"unknown\"}. Restart Pi to use the installed helper.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t} else if (parsed.ok === true) {\n\t\t\t\tpending.resolve(parsed.result);\n\t\t\t} else {\n\t\t\t\tconst error = new Error(parsed.error?.message ?? \"Windows helper command failed.\") as Error & {\n\t\t\t\t\tcode?: string;\n\t\t\t\t};\n\t\t\t\terror.code = parsed.error?.code;\n\t\t\t\tpending.reject(error);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync command<T>(\n\t\tcmd: string,\n\t\targs: Record<string, unknown> = {},\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<T> {\n\t\tconst child = await this.process(options?.signal);\n\t\tconst id = randomUUID();\n\t\tconst timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;\n\t\treturn await new Promise<T>((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\treject(new Error(`Helper command '${cmd}' timed out after ${timeoutMs}ms.`));\n\t\t\t}, timeoutMs);\n\t\t\tthis.pending.set(id, { resolve: resolve as (value: unknown) => void, reject, timer });\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ protocolVersion: WINDOWS_HELPER_PROTOCOL_VERSION, id, cmd, args })}\\n`,\n\t\t\t\t(error) => {\n\t\t\t\t\tif (!error) return;\n\t\t\t\t\tthis.pending.delete(id);\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n}\n\nexport const windowsHelper = new WindowsHelperClient();\n"]}