@trycua/cua-driver 0.34.1 → 0.35.4

package/dist/daemon.d.ts

@@ -0,0 +1,14 @@
+export interface Availability {
+    isAvailable(): boolean;
+}
+export interface CreateDriverHooks {
+    platform?: NodeJS.Platform;
+    appInstalled?: () => boolean;
+    launch?: () => boolean;
+    timeoutMs?: number;
+    sleep?: (ms: number) => void;
+    warn?: (message: string) => void;
+}
+/** Reset the one-time warning (tests only). */
+export declare function resetDaemonWarning(): void;
+export declare function createDriver<T extends Availability>(connect: () => T, createEmbedded: () => T, embedded: boolean, claudeCodeCompatibility: boolean, hooks?: CreateDriverHooks): T;

package/dist/daemon.js

@@ -0,0 +1,59 @@
+/**
+ * macOS daemon preference for `CuaDriver.create()`.
+ *
+ * An embedded (in-process) runtime on macOS has no AppKit host, so the agent
+ * cursor overlay cannot be drawn and permissions are attributed to the host
+ * process. The daemon (CuaDriver.app running `serve`) draws the cursor and owns
+ * the TCC grants, so on macOS `create()` connects to it, starting it through
+ * LaunchServices when the app is installed. No native dependency, so it is
+ * testable without the staged library.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+const APP_NAME = "CuaDriver";
+const APP_PATH = `/Applications/${APP_NAME}.app`;
+const EMBEDDED_ENV = "CUA_DRIVER_EMBEDDED";
+let warned = false;
+/** Reset the one-time warning (tests only). */
+export function resetDaemonWarning() {
+    warned = false;
+}
+function launchApp() {
+    const result = spawnSync("/usr/bin/open", ["-n", "-g", "-a", APP_NAME, "--args", "serve"], { stdio: "ignore" });
+    return result.status === 0;
+}
+function blockingSleep(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+export function createDriver(connect, createEmbedded, embedded, claudeCodeCompatibility, hooks = {}) {
+    const platform = hooks.platform ?? process.platform;
+    if (embedded ||
+        claudeCodeCompatibility ||
+        platform !== "darwin" ||
+        process.env[EMBEDDED_ENV] === "1") {
+        return createEmbedded();
+    }
+    const driver = connect();
+    if (driver.isAvailable())
+        return driver;
+    const installed = (hooks.appInstalled ?? (() => existsSync(APP_PATH)))();
+    if (installed && (hooks.launch ?? launchApp)()) {
+        const sleep = hooks.sleep ?? blockingSleep;
+        const deadline = Date.now() + (hooks.timeoutMs ?? 15_000);
+        while (Date.now() < deadline) {
+            if (driver.isAvailable())
+                return driver;
+            sleep(250);
+        }
+    }
+    if (!warned) {
+        warned = true;
+        const message = "CuaDriver.create() is using the in-process runtime, which cannot draw " +
+            "the agent cursor on macOS and attributes permissions to this process. " +
+            "Install CuaDriver.app and run `cua-driver serve` (or call " +
+            "CuaDriver.connect()) to get the agent cursor, or pass " +
+            "{ embedded: true } to silence this warning.";
+        (hooks.warn ?? ((m) => process.emitWarning(m)))(message);
+    }
+    return createEmbedded();
+}

package/dist/index.d.ts

@@ -1,2 +1,22 @@
+/**
+ * Rust-backed SDK for Cua Driver client applications.
+ *
+ * Agents should configure `cua-driver mcp` through their runtime's existing
+ * MCP client instead of importing a language MCP facade.
+ */
+import { CuaDriver as NativeCuaDriver, type CuaDriverLike, type DriverOptions } from "./native/cua_driver_sdk.js";
+/**
+ * Options for `CuaDriver.create()`. `embedded: true` forces the in-process
+ * runtime on macOS, where `create()` otherwise prefers the CuaDriver.app
+ * daemon so the agent cursor overlay and the app's permissions work.
+ */
+export type CreateOptions = DriverOptions & {
+    embedded?: boolean;
+};
+declare const CuaDriver: typeof NativeCuaDriver & {
+    create(options?: CreateOptions): CuaDriverLike;
+};
+type CuaDriver = NativeCuaDriver;
 export * from "./native/index.js";
+export { CuaDriver };
 export { default } from "./native/index.js";

package/dist/index.js

@@ -4,16 +4,22 @@
  * Agents should configure `cua-driver mcp` through their runtime's existing
  * MCP client instead of importing a language MCP facade.
  */
-import { CuaDriver, SdkClientKind } from "./native/cua_driver_sdk.js";
+import { CuaDriver as NativeCuaDriver, SdkClientKind, } from "./native/cua_driver_sdk.js";
+import { createDriver } from "./daemon.js";
+const CuaDriver = NativeCuaDriver;
 // The same native library backs Python and TypeScript. The package root tags
 // both the canonical same-process constructor and the temporary daemon
 // compatibility constructor with the importing runtime.
-CuaDriver.create = (options) => CuaDriver.createWithClientKind(options, SdkClientKind.Typescript);
-CuaDriver.createConfigured = (options) => CuaDriver.createConfiguredWithClientKind(options, SdkClientKind.Typescript);
-CuaDriver.createConfiguredWithAuthorizationHost = (options, host) => CuaDriver.createConfiguredWithAuthorizationHostAndClientKind(options, host, SdkClientKind.Typescript);
-CuaDriver.createConfiguredWithActivityObserver = (options, observer) => CuaDriver.createConfiguredWithActivityObserverAndClientKind(options, observer, SdkClientKind.Typescript);
-CuaDriver.createConfiguredWithHostIntegrations = (options, host, observer) => CuaDriver.createConfiguredWithHostIntegrationsAndClientKind(options, host, observer, SdkClientKind.Typescript);
-CuaDriver.createPrivateWorker = (options) => CuaDriver.createPrivateWorkerWithClientKind(options, SdkClientKind.Typescript);
-CuaDriver.connect = (socketPath) => CuaDriver.connectWithClientKind(socketPath, SdkClientKind.Typescript);
+NativeCuaDriver.create = (options) => {
+    const { embedded, ...driverOptions } = options ?? {};
+    return createDriver(() => NativeCuaDriver.connectWithClientKind(undefined, SdkClientKind.Typescript), () => NativeCuaDriver.createWithClientKind(options === undefined ? undefined : driverOptions, SdkClientKind.Typescript), embedded === true, driverOptions.claudeCodeCompatibility === true);
+};
+NativeCuaDriver.createConfigured = (options) => NativeCuaDriver.createConfiguredWithClientKind(options, SdkClientKind.Typescript);
+NativeCuaDriver.createConfiguredWithAuthorizationHost = (options, host) => NativeCuaDriver.createConfiguredWithAuthorizationHostAndClientKind(options, host, SdkClientKind.Typescript);
+NativeCuaDriver.createConfiguredWithActivityObserver = (options, observer) => NativeCuaDriver.createConfiguredWithActivityObserverAndClientKind(options, observer, SdkClientKind.Typescript);
+NativeCuaDriver.createConfiguredWithHostIntegrations = (options, host, observer) => NativeCuaDriver.createConfiguredWithHostIntegrationsAndClientKind(options, host, observer, SdkClientKind.Typescript);
+NativeCuaDriver.createPrivateWorker = (options) => NativeCuaDriver.createPrivateWorkerWithClientKind(options, SdkClientKind.Typescript);
+NativeCuaDriver.connect = (socketPath) => NativeCuaDriver.connectWithClientKind(socketPath, SdkClientKind.Typescript);
 export * from "./native/index.js";
+export { CuaDriver };
 export { default } from "./native/index.js";

package/dist/native/cua_driver_contract.d.ts

@@ -500,30 +500,38 @@ export declare const ClipboardWriteOutput: Readonly<{
     defaults: () => Partial<ClipboardWriteOutput>;
 }>;
 /**
- * Per-effect overrides for the agent cursor. Unset fields are omitted on the wire, so they
- * keep their current setting.
+ * One cursor effect: `on`, `off`, or `default` (the style's own setting).
+ */
+export declare enum CursorEffectSetting {
+    On = 0,
+    Off = 1,
+    Default = 2
+}
+/**
+ * Per-effect overrides for the agent cursor. An omitted field keeps the current setting.
+ * `on` and `off` set it; `default` restores the style default.
  */
 export type CursorMotionEffects = {
     /**
      * Short fading trail behind the cursor.
      */
-    trail?: boolean;
+    trail?: CursorEffectSetting | boolean;
     /**
      * Soft glow around the cursor that grows with speed.
      */
-    glow?: boolean;
+    glow?: CursorEffectSetting | boolean;
     /**
      * Target glow when the `magnetic` style locks on.
      */
-    magnet?: boolean;
+    magnet?: CursorEffectSetting | boolean;
     /**
      * Ring that expands from the hotspot on click.
      */
-    ripple?: boolean;
+    ripple?: CursorEffectSetting | boolean;
     /**
      * Brief scale-down of the cursor on click.
      */
-    squish?: boolean;
+    squish?: CursorEffectSetting | boolean;
 };
 /**
  * Generated factory for {@link CursorMotionEffects} record objects.
@@ -562,7 +570,11 @@ export declare enum CursorMotionStyle {
 export declare enum CursorMotionTiming {
     Native = 0,
     Fitts = 1,
-    Fixed = 2
+    Fixed = 2,
+    Relaxed = 3,
+    Steady = 4,
+    Calm = 5,
+    Deliberate = 6
 }
 export type CursorMotionOutput = {
     startHandle: number;
@@ -611,13 +623,15 @@ export type CursorMotionSelection = {
      */
     style?: CursorMotionStyle;
     /**
+     * `steady` (default) keeps the style's timing but makes every move take at least 600 ms,
+     * with a gentler ease; `relaxed` and `calm` do the same with a 450 or 750 ms floor.
      * `native` uses the style's own timing; `fitts` scales the move time with distance and
-     * target size; `fixed` uses glide_duration_ms (1430 ms when 0).
+     * target size; `deliberate` is a slower Fitts curve (450..1300 ms); `fixed` uses
+     * glide_duration_ms (1430 ms when 0).
      */
     timing?: CursorMotionTiming;
     /**
-     * Turn single effects on or off. An omitted effect keeps its current setting; null
-     * restores the style's default.
+     * Turn effects on or off. Omit a field to keep it; `"default"` restores the style default.
      */
     effects?: CursorMotionEffects;
     /**
@@ -647,7 +661,8 @@ export type CursorMotionSelection = {
     spring?: number;
     /**
      * Move duration in milliseconds for `fixed` timing (1430 ms when 0, the default). A
-     * nonzero value with `native` timing also fixes the duration. Clamped to 0..5000.
+     * nonzero value with `native` or the default `steady` timing also fixes the duration.
+     * Clamped to 0..5000.
      */
     glideDurationMs?: number;
     /**
@@ -1026,13 +1041,31 @@ export type GetWindowStateInput = {
      * partial tree flagged `truncated` rather than failing.
      */
     timeoutMs?: number;
+    /**
+     * Tree representation to return: `markdown` (default), `elements`, or
+     * `both`.
+     */
+    treeFormat?: string;
+    /**
+     * Return only what changed since this earlier `snapshot_id`.
+     */
+    since?: string;
+    /**
+     * Include `_note` and the full `background_input` report.
+     */
+    verbose?: boolean;
+    /**
+     * Restore the previous full response (both representations, all
+     * metadata, platform walk limits).
+     */
+    fullOutput?: boolean;
 };
 /**
  * Generated factory for {@link GetWindowStateInput} record objects.
  */
 export declare const GetWindowStateInput: Readonly<{
-    create: (partial: Partial<GetWindowStateInput> & Required<Omit<GetWindowStateInput, "session" | "screenshotOutFile" | "maxImageDimension" | "query" | "includeAccessibilityTree" | "includeScreenshot" | "maxElements" | "maxDepth" | "maxDimension" | "timeoutMs">>) => GetWindowStateInput;
-    new: (partial: Partial<GetWindowStateInput> & Required<Omit<GetWindowStateInput, "session" | "screenshotOutFile" | "maxImageDimension" | "query" | "includeAccessibilityTree" | "includeScreenshot" | "maxElements" | "maxDepth" | "maxDimension" | "timeoutMs">>) => GetWindowStateInput;
+    create: (partial: Partial<GetWindowStateInput> & Required<Omit<GetWindowStateInput, "session" | "screenshotOutFile" | "maxImageDimension" | "query" | "includeAccessibilityTree" | "includeScreenshot" | "maxElements" | "maxDepth" | "maxDimension" | "timeoutMs" | "treeFormat" | "since" | "verbose" | "fullOutput">>) => GetWindowStateInput;
+    new: (partial: Partial<GetWindowStateInput> & Required<Omit<GetWindowStateInput, "session" | "screenshotOutFile" | "maxImageDimension" | "query" | "includeAccessibilityTree" | "includeScreenshot" | "maxElements" | "maxDepth" | "maxDimension" | "timeoutMs" | "treeFormat" | "since" | "verbose" | "fullOutput">>) => GetWindowStateInput;
     defaults: () => Partial<GetWindowStateInput>;
 }>;
 export type HotkeyInput = {
@@ -1881,13 +1914,15 @@ export type SetAgentCursorMotionInput = {
      */
     style?: CursorMotionStyle;
     /**
+     * `steady` (default) keeps the style's timing but makes every move take at least 600 ms,
+     * with a gentler ease; `relaxed` and `calm` do the same with a 450 or 750 ms floor.
      * `native` uses the style's own timing; `fitts` scales the move time with distance and
-     * target size; `fixed` uses glide_duration_ms (1430 ms when 0).
+     * target size; `deliberate` is a slower Fitts curve (450..1300 ms); `fixed` uses
+     * glide_duration_ms (1430 ms when 0).
      */
     timing?: CursorMotionTiming;
     /**
-     * Turn single effects on or off. An omitted effect keeps its current setting; null
-     * restores the style's default.
+     * Turn effects on or off. Omit a field to keep it; `"default"` restores the style default.
      */
     effects?: CursorMotionEffects;
     /**
@@ -1917,7 +1952,8 @@ export type SetAgentCursorMotionInput = {
     spring?: number;
     /**
      * Move duration in milliseconds for `fixed` timing (1430 ms when 0, the default). A
-     * nonzero value with `native` timing also fixes the duration. Clamped to 0..5000.
+     * nonzero value with `native` or the default `steady` timing also fixes the duration.
+     * Clamped to 0..5000.
      */
     glideDurationMs?: number;
     /**
@@ -2276,6 +2312,29 @@ export type WindowStateOutput = {
     degradedReason?: string;
     truncated?: boolean;
     truncationReason?: string;
+    /**
+     * Plain-language line saying the tree was cut at `max_elements` and how
+     * to read more.
+     */
+    truncationHint?: string;
+    /**
+     * Which representation this response carries.
+     */
+    treeFormat?: string;
+    /**
+     * The `since` snapshot_id the caller asked to diff against.
+     */
+    since?: string;
+    /**
+     * `diff`, `no_change`, or the reason a full read was returned instead
+     * (`unknown_snapshot`, `other_window`, `view_changed`, `too_much_changed`,
+     * `diff_too_large`, `no_snapshot`).
+     */
+    sinceStatus?: string;
+    /**
+     * Added/changed/removed rows against `since`, one per line.
+     */
+    treeDiff?: string;
     screenshotWidth?: number;
     screenshotHeight?: number;
     screenshotScale?: number;
@@ -2292,8 +2351,8 @@ export type WindowStateOutput = {
  * Generated factory for {@link WindowStateOutput} record objects.
  */
 export declare const WindowStateOutput: Readonly<{
-    create: (partial: Partial<WindowStateOutput> & Required<Omit<WindowStateOutput, "appName" | "snapshotId" | "windowTitle" | "treeMarkdown" | "elements" | "elementCount" | "totalElementCount" | "returnedElementCount" | "filteredElementCount" | "elementsComplete" | "degraded" | "degradedReason" | "truncated" | "truncationReason" | "screenshotWidth" | "screenshotHeight" | "screenshotScale" | "screenshotMimeType" | "screenshotFilePath" | "screenshotFrameValid" | "windowBounds">>) => WindowStateOutput;
-    new: (partial: Partial<WindowStateOutput> & Required<Omit<WindowStateOutput, "appName" | "snapshotId" | "windowTitle" | "treeMarkdown" | "elements" | "elementCount" | "totalElementCount" | "returnedElementCount" | "filteredElementCount" | "elementsComplete" | "degraded" | "degradedReason" | "truncated" | "truncationReason" | "screenshotWidth" | "screenshotHeight" | "screenshotScale" | "screenshotMimeType" | "screenshotFilePath" | "screenshotFrameValid" | "windowBounds">>) => WindowStateOutput;
+    create: (partial: Partial<WindowStateOutput> & Required<Omit<WindowStateOutput, "treeFormat" | "since" | "appName" | "snapshotId" | "windowTitle" | "treeMarkdown" | "elements" | "elementCount" | "totalElementCount" | "returnedElementCount" | "filteredElementCount" | "elementsComplete" | "degraded" | "degradedReason" | "truncated" | "truncationReason" | "truncationHint" | "sinceStatus" | "treeDiff" | "screenshotWidth" | "screenshotHeight" | "screenshotScale" | "screenshotMimeType" | "screenshotFilePath" | "screenshotFrameValid" | "windowBounds">>) => WindowStateOutput;
+    new: (partial: Partial<WindowStateOutput> & Required<Omit<WindowStateOutput, "treeFormat" | "since" | "appName" | "snapshotId" | "windowTitle" | "treeMarkdown" | "elements" | "elementCount" | "totalElementCount" | "returnedElementCount" | "filteredElementCount" | "elementsComplete" | "degraded" | "degradedReason" | "truncated" | "truncationReason" | "truncationHint" | "sinceStatus" | "treeDiff" | "screenshotWidth" | "screenshotHeight" | "screenshotScale" | "screenshotMimeType" | "screenshotFilePath" | "screenshotFrameValid" | "windowBounds">>) => WindowStateOutput;
     defaults: () => Partial<WindowStateOutput>;
 }>;
 export declare enum Platform {
@@ -2476,6 +2535,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): CursorAction;
             lower(value: CursorAction, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeCursorEffectSetting: {
+            read(from: RustBuffer): boolean | CursorEffectSetting;
+            write(value: boolean | CursorEffectSetting, into: RustBuffer): void;
+            allocationSize(value: boolean | CursorEffectSetting): number;
+            lift(value: UniffiByteArray): boolean | CursorEffectSetting;
+            lower(value: boolean | CursorEffectSetting, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeCursorMotionEffects: {
             read(from: RustBuffer): CursorMotionEffects;
             write(value: CursorMotionEffects, into: RustBuffer): void;

package/dist/native/cua_driver_contract.js

@@ -1032,6 +1032,42 @@ const FfiConverterTypeClipboardWriteOutput = (() => {
     ;
     return new FFIConverter();
 })();
+/**
+ * One cursor effect: `on`, `off`, or `default` (the style's own setting).
+ */
+export var CursorEffectSetting;
+(function (CursorEffectSetting) {
+    CursorEffectSetting[CursorEffectSetting["On"] = 0] = "On";
+    CursorEffectSetting[CursorEffectSetting["Off"] = 1] = "Off";
+    CursorEffectSetting[CursorEffectSetting["Default"] = 2] = "Default";
+})(CursorEffectSetting || (CursorEffectSetting = {}));
+const FfiConverterTypeCursorEffectSetting = (() => {
+    const ordinalConverter = FfiConverterInt32;
+    class FFIConverter extends AbstractFfiConverterByteArray {
+        read(from) {
+            switch (ordinalConverter.read(from)) {
+                case 1: return CursorEffectSetting.On;
+                case 2: return CursorEffectSetting.Off;
+                case 3: return CursorEffectSetting.Default;
+                default: throw new UniffiInternalError.UnexpectedEnumCase();
+            }
+        }
+        write(value, into) {
+            if (typeof value === "boolean")
+                value = value ? CursorEffectSetting.On : CursorEffectSetting.Off;
+            switch (value) {
+                case CursorEffectSetting.On: return ordinalConverter.write(1, into);
+                case CursorEffectSetting.Off: return ordinalConverter.write(2, into);
+                case CursorEffectSetting.Default: return ordinalConverter.write(3, into);
+                default: throw new UniffiInternalError.UnexpectedEnumCase();
+            }
+        }
+        allocationSize(value) {
+            return ordinalConverter.allocationSize(0);
+        }
+    }
+    return new FFIConverter();
+})();
 /**
  * Generated factory for {@link CursorMotionEffects} record objects.
  */
@@ -1050,26 +1086,26 @@ const FfiConverterTypeCursorMotionEffects = (() => {
     class FFIConverter extends AbstractFfiConverterByteArray {
         read(from) {
             return {
-                trail: FfiConverterOptionalBoolean.read(from),
-                glow: FfiConverterOptionalBoolean.read(from),
-                magnet: FfiConverterOptionalBoolean.read(from),
-                ripple: FfiConverterOptionalBoolean.read(from),
-                squish: FfiConverterOptionalBoolean.read(from)
+                trail: FfiConverterOptionalTypeCursorEffectSetting.read(from),
+                glow: FfiConverterOptionalTypeCursorEffectSetting.read(from),
+                magnet: FfiConverterOptionalTypeCursorEffectSetting.read(from),
+                ripple: FfiConverterOptionalTypeCursorEffectSetting.read(from),
+                squish: FfiConverterOptionalTypeCursorEffectSetting.read(from)
             };
         }
         write(value, into) {
-            FfiConverterOptionalBoolean.write(value.trail, into);
-            FfiConverterOptionalBoolean.write(value.glow, into);
-            FfiConverterOptionalBoolean.write(value.magnet, into);
-            FfiConverterOptionalBoolean.write(value.ripple, into);
-            FfiConverterOptionalBoolean.write(value.squish, into);
+            FfiConverterOptionalTypeCursorEffectSetting.write(value.trail, into);
+            FfiConverterOptionalTypeCursorEffectSetting.write(value.glow, into);
+            FfiConverterOptionalTypeCursorEffectSetting.write(value.magnet, into);
+            FfiConverterOptionalTypeCursorEffectSetting.write(value.ripple, into);
+            FfiConverterOptionalTypeCursorEffectSetting.write(value.squish, into);
         }
         allocationSize(value) {
-            return FfiConverterOptionalBoolean.allocationSize(value.trail) +
-                FfiConverterOptionalBoolean.allocationSize(value.glow) +
-                FfiConverterOptionalBoolean.allocationSize(value.magnet) +
-                FfiConverterOptionalBoolean.allocationSize(value.ripple) +
-                FfiConverterOptionalBoolean.allocationSize(value.squish);
+            return FfiConverterOptionalTypeCursorEffectSetting.allocationSize(value.trail) +
+                FfiConverterOptionalTypeCursorEffectSetting.allocationSize(value.glow) +
+                FfiConverterOptionalTypeCursorEffectSetting.allocationSize(value.magnet) +
+                FfiConverterOptionalTypeCursorEffectSetting.allocationSize(value.ripple) +
+                FfiConverterOptionalTypeCursorEffectSetting.allocationSize(value.squish);
         }
     }
     ;
@@ -1162,6 +1198,10 @@ export var CursorMotionTiming;
     CursorMotionTiming[CursorMotionTiming["Native"] = 0] = "Native";
     CursorMotionTiming[CursorMotionTiming["Fitts"] = 1] = "Fitts";
     CursorMotionTiming[CursorMotionTiming["Fixed"] = 2] = "Fixed";
+    CursorMotionTiming[CursorMotionTiming["Relaxed"] = 3] = "Relaxed";
+    CursorMotionTiming[CursorMotionTiming["Steady"] = 4] = "Steady";
+    CursorMotionTiming[CursorMotionTiming["Calm"] = 5] = "Calm";
+    CursorMotionTiming[CursorMotionTiming["Deliberate"] = 6] = "Deliberate";
 })(CursorMotionTiming || (CursorMotionTiming = {}));
 const FfiConverterTypeCursorMotionTiming = (() => {
     const ordinalConverter = FfiConverterInt32;
@@ -1171,6 +1211,10 @@ const FfiConverterTypeCursorMotionTiming = (() => {
                 case 1: return CursorMotionTiming.Native;
                 case 2: return CursorMotionTiming.Fitts;
                 case 3: return CursorMotionTiming.Fixed;
+                case 4: return CursorMotionTiming.Relaxed;
+                case 5: return CursorMotionTiming.Steady;
+                case 6: return CursorMotionTiming.Calm;
+                case 7: return CursorMotionTiming.Deliberate;
                 default: throw new UniffiInternalError.UnexpectedEnumCase();
             }
         }
@@ -1179,6 +1223,10 @@ const FfiConverterTypeCursorMotionTiming = (() => {
                 case CursorMotionTiming.Native: return ordinalConverter.write(1, into);
                 case CursorMotionTiming.Fitts: return ordinalConverter.write(2, into);
                 case CursorMotionTiming.Fixed: return ordinalConverter.write(3, into);
+                case CursorMotionTiming.Relaxed: return ordinalConverter.write(4, into);
+                case CursorMotionTiming.Steady: return ordinalConverter.write(5, into);
+                case CursorMotionTiming.Calm: return ordinalConverter.write(6, into);
+                case CursorMotionTiming.Deliberate: return ordinalConverter.write(7, into);
             }
         }
         allocationSize(value) {
@@ -2144,7 +2192,11 @@ const FfiConverterTypeGetSessionStateInput = (() => {
  */
 export const GetWindowStateInput = (() => {
     const defaults = () => ({
-        timeoutMs: undefined
+        timeoutMs: undefined,
+        treeFormat: undefined,
+        since: undefined,
+        verbose: undefined,
+        fullOutput: undefined
     });
     const create = (() => {
         return uniffiCreateRecord(defaults);
@@ -2170,7 +2222,11 @@ const FfiConverterTypeGetWindowStateInput = (() => {
                 maxDepth: FfiConverterOptionalUInt32.read(from),
                 maxDimension: FfiConverterOptionalUInt32.read(from),
                 maxImageDimension: FfiConverterOptionalUInt32.read(from),
-                timeoutMs: FfiConverterOptionalUInt32.read(from)
+                timeoutMs: FfiConverterOptionalUInt32.read(from),
+                treeFormat: FfiConverterOptionalString.read(from),
+                since: FfiConverterOptionalString.read(from),
+                verbose: FfiConverterOptionalBoolean.read(from),
+                fullOutput: FfiConverterOptionalBoolean.read(from)
             };
         }
         write(value, into) {
@@ -2186,6 +2242,10 @@ const FfiConverterTypeGetWindowStateInput = (() => {
             FfiConverterOptionalUInt32.write(value.maxDimension, into);
             FfiConverterOptionalUInt32.write(value.maxImageDimension, into);
             FfiConverterOptionalUInt32.write(value.timeoutMs, into);
+            FfiConverterOptionalString.write(value.treeFormat, into);
+            FfiConverterOptionalString.write(value.since, into);
+            FfiConverterOptionalBoolean.write(value.verbose, into);
+            FfiConverterOptionalBoolean.write(value.fullOutput, into);
         }
         allocationSize(value) {
             return FfiConverterUInt32.allocationSize(value.pid) +
@@ -2199,7 +2259,11 @@ const FfiConverterTypeGetWindowStateInput = (() => {
                 FfiConverterOptionalUInt32.allocationSize(value.maxDepth) +
                 FfiConverterOptionalUInt32.allocationSize(value.maxDimension) +
                 FfiConverterOptionalUInt32.allocationSize(value.maxImageDimension) +
-                FfiConverterOptionalUInt32.allocationSize(value.timeoutMs);
+                FfiConverterOptionalUInt32.allocationSize(value.timeoutMs) +
+                FfiConverterOptionalString.allocationSize(value.treeFormat) +
+                FfiConverterOptionalString.allocationSize(value.since) +
+                FfiConverterOptionalBoolean.allocationSize(value.verbose) +
+                FfiConverterOptionalBoolean.allocationSize(value.fullOutput);
         }
     }
     ;
@@ -4672,6 +4736,11 @@ const FfiConverterTypeWindowStateOutput = (() => {
                 degradedReason: FfiConverterOptionalString.read(from),
                 truncated: FfiConverterOptionalBoolean.read(from),
                 truncationReason: FfiConverterOptionalString.read(from),
+                truncationHint: FfiConverterOptionalString.read(from),
+                treeFormat: FfiConverterOptionalString.read(from),
+                since: FfiConverterOptionalString.read(from),
+                sinceStatus: FfiConverterOptionalString.read(from),
+                treeDiff: FfiConverterOptionalString.read(from),
                 screenshotWidth: FfiConverterOptionalUInt32.read(from),
                 screenshotHeight: FfiConverterOptionalUInt32.read(from),
                 screenshotScale: FfiConverterOptionalFloat64.read(from),
@@ -4699,6 +4768,11 @@ const FfiConverterTypeWindowStateOutput = (() => {
             FfiConverterOptionalString.write(value.degradedReason, into);
             FfiConverterOptionalBoolean.write(value.truncated, into);
             FfiConverterOptionalString.write(value.truncationReason, into);
+            FfiConverterOptionalString.write(value.truncationHint, into);
+            FfiConverterOptionalString.write(value.treeFormat, into);
+            FfiConverterOptionalString.write(value.since, into);
+            FfiConverterOptionalString.write(value.sinceStatus, into);
+            FfiConverterOptionalString.write(value.treeDiff, into);
             FfiConverterOptionalUInt32.write(value.screenshotWidth, into);
             FfiConverterOptionalUInt32.write(value.screenshotHeight, into);
             FfiConverterOptionalFloat64.write(value.screenshotScale, into);
@@ -4725,6 +4799,11 @@ const FfiConverterTypeWindowStateOutput = (() => {
                 FfiConverterOptionalString.allocationSize(value.degradedReason) +
                 FfiConverterOptionalBoolean.allocationSize(value.truncated) +
                 FfiConverterOptionalString.allocationSize(value.truncationReason) +
+                FfiConverterOptionalString.allocationSize(value.truncationHint) +
+                FfiConverterOptionalString.allocationSize(value.treeFormat) +
+                FfiConverterOptionalString.allocationSize(value.since) +
+                FfiConverterOptionalString.allocationSize(value.sinceStatus) +
+                FfiConverterOptionalString.allocationSize(value.treeDiff) +
                 FfiConverterOptionalUInt32.allocationSize(value.screenshotWidth) +
                 FfiConverterOptionalUInt32.allocationSize(value.screenshotHeight) +
                 FfiConverterOptionalFloat64.allocationSize(value.screenshotScale) +
@@ -4788,8 +4867,8 @@ const FfiConverterOptionalFloat64 = new FfiConverterOptional(FfiConverterFloat64
 const FfiConverterOptionalTypeClickButton = new FfiConverterOptional(FfiConverterTypeClickButton);
 // FfiConverter for Array<string>
 const FfiConverterSequenceString = new FfiConverterArray(FfiConverterString);
-// FfiConverter for boolean | undefined
-const FfiConverterOptionalBoolean = new FfiConverterOptional(FfiConverterBool);
+// FfiConverter for CursorEffectSetting | undefined
+const FfiConverterOptionalTypeCursorEffectSetting = new FfiConverterOptional(FfiConverterTypeCursorEffectSetting);
 // FfiConverter for CursorMotionStyle | undefined
 const FfiConverterOptionalTypeCursorMotionStyle = new FfiConverterOptional(FfiConverterTypeCursorMotionStyle);
 // FfiConverter for CursorMotionTiming | undefined
@@ -4806,6 +4885,8 @@ const FfiConverterOptionalTypeDesktopScope = new FfiConverterOptional(FfiConvert
 const FfiConverterOptionalUInt64 = new FfiConverterOptional(FfiConverterUInt64);
 // FfiConverter for Array<string> | undefined
 const FfiConverterOptionalSequenceString = new FfiConverterOptional(FfiConverterSequenceString);
+// FfiConverter for boolean | undefined
+const FfiConverterOptionalBoolean = new FfiConverterOptional(FfiConverterBool);
 // FfiConverter for CursorPointOutput | undefined
 const FfiConverterOptionalTypeCursorPointOutput = new FfiConverterOptional(FfiConverterTypeCursorPointOutput);
 // FfiConverter for Array<AppInfo>
@@ -4907,6 +4988,7 @@ export default Object.freeze({
         FfiConverterTypeClipboardWriteInput,
         FfiConverterTypeClipboardWriteOutput,
         FfiConverterTypeCursorAction,
+        FfiConverterTypeCursorEffectSetting,
         FfiConverterTypeCursorMotionEffects,
         FfiConverterTypeCursorMotionEffectsOutput,
         FfiConverterTypeCursorMotionOutput,

package/dist/native/cua_driver_sdk-ffi.d.ts

@@ -52,6 +52,8 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_fn_free_cuadriver(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): void;
     uniffi_cua_driver_sdk_fn_clone_cuadriversession(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_free_cuadriversession(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): void;
+    uniffi_cua_driver_sdk_fn_clone_cursortrajectory(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
+    uniffi_cua_driver_sdk_fn_free_cursortrajectory(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): void;
     uniffi_cua_driver_sdk_fn_clone_driveractivityobserver(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_free_driveractivityobserver(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): void;
     uniffi_cua_driver_sdk_fn_clone_driverauthorizationhost(ptr: bigint, uniffi_out_err: UniffiRustCallStatus): bigint;
@@ -72,8 +74,13 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_fn_func_create_remote_trusted_session(driver: bigint, options: Uint8Array): bigint;
     uniffi_cua_driver_sdk_fn_func_create_trusted_session(driver: bigint, options: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_func_current_mac_os_permission_status(uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_func_cursor_click_effects(effects: Uint8Array, age: number, x: number, y: number, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_func_cursor_motion_spec_for_style(style: Uint8Array, params: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_func_default_cursor_motion_params(uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     uniffi_cua_driver_sdk_fn_func_open_mac_os_screen_recording_settings(uniffi_out_err: UniffiRustCallStatus): void;
     uniffi_cua_driver_sdk_fn_func_open_mcp_driver_channel(transport: bigint, authenticatedPrincipal: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
+    uniffi_cua_driver_sdk_fn_func_plan_cursor_move(params: Uint8Array, request: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
+    uniffi_cua_driver_sdk_fn_func_plan_cursor_spec(spec: Uint8Array, request: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_func_request_mac_os_permissions(uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     uniffi_cua_driver_sdk_fn_constructor_cuadriver_connect(socketPath: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_constructor_cuadriver_connect_with_client_kind(socketPath: Uint8Array, clientKind: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
@@ -158,6 +165,16 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_fn_method_cuadriversession_start_session(uniffiSelf: bigint, input: Uint8Array): bigint;
     uniffi_cua_driver_sdk_fn_method_cuadriversession_type_text(uniffiSelf: bigint, input: Uint8Array): bigint;
     uniffi_cua_driver_sdk_fn_method_cuadriversession_verify_state(uniffiSelf: bigint, input: Uint8Array): bigint;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_arrival_t(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_duration(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_effect_frame(uniffiSelf: bigint, t: number, blend: number, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_effects(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_linger(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): number;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_sample_at(uniffiSelf: bigint, t: number, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_samples(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_snap_t(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_target(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_cursortrajectory_target_known(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): number;
     uniffi_cua_driver_sdk_fn_method_driveractivityobserver_on_activity(uniffiSelf: bigint, event: Uint8Array, uniffi_out_err: UniffiRustCallStatus): void;
     uniffi_cua_driver_sdk_fn_method_driverauthorizationhost_authorize(uniffiSelf: bigint, request: Uint8Array): bigint;
     uniffi_cua_driver_sdk_fn_method_driverservicetransport_send(uniffiSelf: bigint, request: Uint8Array): bigint;
@@ -184,8 +201,13 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_checksum_func_create_remote_trusted_session(): number;
     uniffi_cua_driver_sdk_checksum_func_create_trusted_session(): number;
     uniffi_cua_driver_sdk_checksum_func_current_mac_os_permission_status(): number;
+    uniffi_cua_driver_sdk_checksum_func_cursor_click_effects(): number;
+    uniffi_cua_driver_sdk_checksum_func_cursor_motion_spec_for_style(): number;
+    uniffi_cua_driver_sdk_checksum_func_default_cursor_motion_params(): number;
     uniffi_cua_driver_sdk_checksum_func_open_mac_os_screen_recording_settings(): number;
     uniffi_cua_driver_sdk_checksum_func_open_mcp_driver_channel(): number;
+    uniffi_cua_driver_sdk_checksum_func_plan_cursor_move(): number;
+    uniffi_cua_driver_sdk_checksum_func_plan_cursor_spec(): number;
     uniffi_cua_driver_sdk_checksum_func_request_mac_os_permissions(): number;
     uniffi_cua_driver_sdk_checksum_constructor_cuadriver_connect(): number;
     uniffi_cua_driver_sdk_checksum_constructor_cuadriver_connect_with_client_kind(): number;
@@ -270,6 +292,16 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_checksum_method_cuadriversession_start_session(): number;
     uniffi_cua_driver_sdk_checksum_method_cuadriversession_type_text(): number;
     uniffi_cua_driver_sdk_checksum_method_cuadriversession_verify_state(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_arrival_t(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_duration(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_effect_frame(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_effects(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_linger(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_sample_at(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_samples(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_snap_t(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_target(): number;
+    uniffi_cua_driver_sdk_checksum_method_cursortrajectory_target_known(): number;
     uniffi_cua_driver_sdk_checksum_method_driveractivityobserver_on_activity(): number;
     uniffi_cua_driver_sdk_checksum_method_driverauthorizationhost_authorize(): number;
     uniffi_cua_driver_sdk_checksum_method_driverservicetransport_send(): number;