@trycua/cua-driver 0.37.0 → 0.39.0

package/README.md

@@ -201,6 +201,15 @@ for its generation, observe unexpected termination with
 Rust host also closes a parent-liveness pipe on normal destruction so the daemon
 cannot remain orphaned after a host crash.
 
+For startup troubleshooting, create the host with
+`EmbeddedCuaDriverHost.withOptions()` and set `captureStderr: true`. After a
+failed start, `lastDiagnostics()` returns the generation-scoped final 65,536
+bytes, exit code, and truncation state; a successful start clears the previous
+diagnostics. Captured text is raw child stderr and can contain application data,
+so do not place secrets in daemon stderr or forward diagnostics to telemetry.
+When `inheritStderr` is also enabled, the host tees output on a bounded
+best-effort path so a blocked terminal cannot stop diagnostic collection.
+
 The npm package installs one optional native package selected for the current
 OS and CPU. It does not bundle the `cua-driver` executable: ship that executable
 outside ASAR, preserve its executable bit, and sign it before signing and

package/dist/native/cua_driver_contract.d.ts

@@ -141,13 +141,20 @@ export type ActionResult = {
      * or a call that keeps the user's window where it is).
      */
     nextCall?: ActionNextCall;
+    /**
+     * Present only when the `fast_path` config key is `on`: the check cost,
+     * the target class and the changed regions since the last read, as one
+     * JSON object. Absent when the flag is off, so default results are
+     * unchanged.
+     */
+    fastPath?: string;
 };
 /**
  * Generated factory for {@link ActionResult} record objects.
  */
 export declare const ActionResult: Readonly<{
-    create: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall">>) => ActionResult;
-    new: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall">>) => ActionResult;
+    create: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall" | "fastPath">>) => ActionResult;
+    new: (partial: Partial<ActionResult> & Required<Omit<ActionResult, "hint" | "delivery" | "evidence" | "escalation" | "summary" | "error" | "nextCall" | "fastPath">>) => ActionResult;
     defaults: () => Partial<ActionResult>;
 }>;
 export type AppInfo = {

package/dist/native/cua_driver_contract.js

@@ -428,7 +428,8 @@ const FfiConverterTypeActionResult = (() => {
                 summary: FfiConverterOptionalString.read(from),
                 error: FfiConverterOptionalTypeActionError.read(from),
                 hint: FfiConverterOptionalString.read(from),
-                nextCall: FfiConverterOptionalTypeActionNextCall.read(from)
+                nextCall: FfiConverterOptionalTypeActionNextCall.read(from),
+                fastPath: FfiConverterOptionalString.read(from)
             };
         }
         write(value, into) {
@@ -441,6 +442,7 @@ const FfiConverterTypeActionResult = (() => {
             FfiConverterOptionalTypeActionError.write(value.error, into);
             FfiConverterOptionalString.write(value.hint, into);
             FfiConverterOptionalTypeActionNextCall.write(value.nextCall, into);
+            FfiConverterOptionalString.write(value.fastPath, into);
         }
         allocationSize(value) {
             return FfiConverterTypeActionEffect.allocationSize(value.effect) +
@@ -451,7 +453,8 @@ const FfiConverterTypeActionResult = (() => {
                 FfiConverterOptionalString.allocationSize(value.summary) +
                 FfiConverterOptionalTypeActionError.allocationSize(value.error) +
                 FfiConverterOptionalString.allocationSize(value.hint) +
-                FfiConverterOptionalTypeActionNextCall.allocationSize(value.nextCall);
+                FfiConverterOptionalTypeActionNextCall.allocationSize(value.nextCall) +
+                FfiConverterOptionalString.allocationSize(value.fastPath);
         }
     }
     ;

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

@@ -181,6 +181,7 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_fn_constructor_embeddedcuadriverhost_new(binaryPath: Uint8Array, hostBundleId: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_constructor_embeddedcuadriverhost_with_options(options: Uint8Array, uniffi_out_err: UniffiRustCallStatus): bigint;
     uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_connection(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
+    uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_last_diagnostics(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
     uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_restart(uniffiSelf: bigint): bigint;
     uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_start(uniffiSelf: bigint): bigint;
     uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_state(uniffiSelf: bigint, uniffi_out_err: UniffiRustCallStatus): Uint8Array;
@@ -308,6 +309,7 @@ interface NativeModuleInterface {
     uniffi_cua_driver_sdk_checksum_constructor_embeddedcuadriverhost_new(): number;
     uniffi_cua_driver_sdk_checksum_constructor_embeddedcuadriverhost_with_options(): number;
     uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_connection(): number;
+    uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_last_diagnostics(): number;
     uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_restart(): number;
     uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_start(): number;
     uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_state(): number;

package/dist/native/cua_driver_sdk-ffi.js

@@ -917,6 +917,11 @@ const DEFINITIONS = {
             ret: FfiType.RustBuffer,
             hasRustCallStatus: true,
         },
+        "uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_last_diagnostics": {
+            args: [FfiType.Handle],
+            ret: FfiType.RustBuffer,
+            hasRustCallStatus: true,
+        },
         "uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_restart": {
             args: [FfiType.Handle],
             ret: FfiType.Handle,
@@ -1552,6 +1557,11 @@ const DEFINITIONS = {
             ret: FfiType.UInt16,
             hasRustCallStatus: false,
         },
+        "uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_last_diagnostics": {
+            args: [],
+            ret: FfiType.UInt16,
+            hasRustCallStatus: false,
+        },
         "uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_restart": {
             args: [],
             ret: FfiType.UInt16,

package/dist/native/cua_driver_sdk.d.ts

@@ -1239,6 +1239,20 @@ export declare const EmbeddedDriverConnection: Readonly<{
     new: (partial: Partial<EmbeddedDriverConnection> & Required<Omit<EmbeddedDriverConnection, never>>) => EmbeddedDriverConnection;
     defaults: () => Partial<EmbeddedDriverConnection>;
 }>;
+export type EmbeddedDriverDiagnostics = {
+    lifecyclePhase: string;
+    exitCode?: number;
+    stderrTail: string;
+    stderrTruncated: boolean;
+};
+/**
+ * Generated factory for {@link EmbeddedDriverDiagnostics} record objects.
+ */
+export declare const EmbeddedDriverDiagnostics: Readonly<{
+    create: (partial: Partial<EmbeddedDriverDiagnostics> & Required<Omit<EmbeddedDriverDiagnostics, "exitCode">>) => EmbeddedDriverDiagnostics;
+    new: (partial: Partial<EmbeddedDriverDiagnostics> & Required<Omit<EmbeddedDriverDiagnostics, "exitCode">>) => EmbeddedDriverDiagnostics;
+    defaults: () => Partial<EmbeddedDriverDiagnostics>;
+}>;
 export type EmbeddedDriverExit = {
     generation: string;
     code?: number;
@@ -1275,13 +1289,14 @@ export type EmbeddedDriverHostOptions = {
     environment: Array<EmbeddedEnvironmentVariable>;
     inheritStderr: boolean;
     noOverlay: boolean;
+    captureStderr: boolean;
 };
 /**
  * Generated factory for {@link EmbeddedDriverHostOptions} record objects.
  */
 export declare const EmbeddedDriverHostOptions: Readonly<{
-    create: (partial: Partial<EmbeddedDriverHostOptions> & Required<Omit<EmbeddedDriverHostOptions, "socketPath" | "permissionMode" | "startupTimeoutMs" | "shutdownTimeoutMs" | "capabilityManifestPath" | "approveCapabilityManifest" | "sessionPolicyPath" | "noOverlay">>) => EmbeddedDriverHostOptions;
-    new: (partial: Partial<EmbeddedDriverHostOptions> & Required<Omit<EmbeddedDriverHostOptions, "socketPath" | "permissionMode" | "startupTimeoutMs" | "shutdownTimeoutMs" | "capabilityManifestPath" | "approveCapabilityManifest" | "sessionPolicyPath" | "noOverlay">>) => EmbeddedDriverHostOptions;
+    create: (partial: Partial<EmbeddedDriverHostOptions> & Required<Omit<EmbeddedDriverHostOptions, "socketPath" | "permissionMode" | "startupTimeoutMs" | "shutdownTimeoutMs" | "capabilityManifestPath" | "approveCapabilityManifest" | "sessionPolicyPath" | "noOverlay" | "captureStderr">>) => EmbeddedDriverHostOptions;
+    new: (partial: Partial<EmbeddedDriverHostOptions> & Required<Omit<EmbeddedDriverHostOptions, "socketPath" | "permissionMode" | "startupTimeoutMs" | "shutdownTimeoutMs" | "capabilityManifestPath" | "approveCapabilityManifest" | "sessionPolicyPath" | "noOverlay" | "captureStderr">>) => EmbeddedDriverHostOptions;
     defaults: () => Partial<EmbeddedDriverHostOptions>;
 }>;
 /**
@@ -4072,6 +4087,7 @@ export declare class DriverServiceTransportImpl extends UniffiAbstractObject imp
 }
 export interface EmbeddedCuaDriverHostLike {
     connection(): EmbeddedDriverConnection | undefined;
+    lastDiagnostics(): EmbeddedDriverDiagnostics | undefined;
     restart(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<EmbeddedDriverConnection>;
@@ -4097,6 +4113,7 @@ export declare class EmbeddedCuaDriverHost extends UniffiAbstractObject implemen
     constructor(binaryPath: string, hostBundleId: string);
     static withOptions(options: EmbeddedDriverHostOptions): EmbeddedCuaDriverHostLike;
     connection(): EmbeddedDriverConnection | undefined;
+    lastDiagnostics(): EmbeddedDriverDiagnostics | undefined;
     restart(asyncOpts_?: {
         signal: AbortSignal;
     }): Promise<EmbeddedDriverConnection>;
@@ -4542,6 +4559,13 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): EmbeddedDriverConnection;
             lower(value: EmbeddedDriverConnection, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeEmbeddedDriverDiagnostics: {
+            read(from: RustBuffer): EmbeddedDriverDiagnostics;
+            write(value: EmbeddedDriverDiagnostics, into: RustBuffer): void;
+            allocationSize(value: EmbeddedDriverDiagnostics): number;
+            lift(value: UniffiByteArray): EmbeddedDriverDiagnostics;
+            lower(value: EmbeddedDriverDiagnostics, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeEmbeddedDriverError: {
             read(from: RustBuffer): EmbeddedDriverError;
             write(value: EmbeddedDriverError, into: RustBuffer): void;

package/dist/native/cua_driver_sdk.js

@@ -2124,6 +2124,46 @@ const FfiConverterTypeEmbeddedDriverConnection = (() => {
     ;
     return new FFIConverter();
 })();
+/**
+ * Generated factory for {@link EmbeddedDriverDiagnostics} record objects.
+ */
+export const EmbeddedDriverDiagnostics = (() => {
+    const defaults = () => ({});
+    const create = (() => {
+        return uniffiCreateRecord(defaults);
+    })();
+    return Object.freeze({
+        create,
+        new: create,
+        defaults: () => Object.freeze(defaults()),
+    });
+})();
+const FfiConverterTypeEmbeddedDriverDiagnostics = (() => {
+    class FFIConverter extends AbstractFfiConverterByteArray {
+        read(from) {
+            return {
+                lifecyclePhase: FfiConverterString.read(from),
+                exitCode: FfiConverterOptionalInt32.read(from),
+                stderrTail: FfiConverterString.read(from),
+                stderrTruncated: FfiConverterBool.read(from)
+            };
+        }
+        write(value, into) {
+            FfiConverterString.write(value.lifecyclePhase, into);
+            FfiConverterOptionalInt32.write(value.exitCode, into);
+            FfiConverterString.write(value.stderrTail, into);
+            FfiConverterBool.write(value.stderrTruncated, into);
+        }
+        allocationSize(value) {
+            return FfiConverterString.allocationSize(value.lifecyclePhase) +
+                FfiConverterOptionalInt32.allocationSize(value.exitCode) +
+                FfiConverterString.allocationSize(value.stderrTail) +
+                FfiConverterBool.allocationSize(value.stderrTruncated);
+        }
+    }
+    ;
+    return new FFIConverter();
+})();
 /**
  * Generated factory for {@link EmbeddedDriverExit} record objects.
  */
@@ -2198,7 +2238,8 @@ export const EmbeddedDriverHostOptions = (() => {
     const defaults = () => ({
         capabilityManifestPath: undefined,
         approveCapabilityManifest: false,
-        noOverlay: false
+        noOverlay: false,
+        captureStderr: false
     });
     const create = (() => {
         return uniffiCreateRecord(defaults);
@@ -2226,7 +2267,8 @@ const FfiConverterTypeEmbeddedDriverHostOptions = (() => {
                 dangerouslyBypassApprovals: FfiConverterBool.read(from),
                 environment: FfiConverterSequenceTypeEmbeddedEnvironmentVariable.read(from),
                 inheritStderr: FfiConverterBool.read(from),
-                noOverlay: FfiConverterBool.read(from)
+                noOverlay: FfiConverterBool.read(from),
+                captureStderr: FfiConverterBool.read(from)
             };
         }
         write(value, into) {
@@ -2244,6 +2286,7 @@ const FfiConverterTypeEmbeddedDriverHostOptions = (() => {
             FfiConverterSequenceTypeEmbeddedEnvironmentVariable.write(value.environment, into);
             FfiConverterBool.write(value.inheritStderr, into);
             FfiConverterBool.write(value.noOverlay, into);
+            FfiConverterBool.write(value.captureStderr, into);
         }
         allocationSize(value) {
             return FfiConverterString.allocationSize(value.binaryPath) +
@@ -2259,7 +2302,8 @@ const FfiConverterTypeEmbeddedDriverHostOptions = (() => {
                 FfiConverterBool.allocationSize(value.dangerouslyBypassApprovals) +
                 FfiConverterSequenceTypeEmbeddedEnvironmentVariable.allocationSize(value.environment) +
                 FfiConverterBool.allocationSize(value.inheritStderr) +
-                FfiConverterBool.allocationSize(value.noOverlay);
+                FfiConverterBool.allocationSize(value.noOverlay) +
+                FfiConverterBool.allocationSize(value.captureStderr);
         }
     }
     ;
@@ -7175,6 +7219,20 @@ export class EmbeddedCuaDriverHost extends UniffiAbstractObject {
         }, 
         /*liftString:*/ FfiConverterString.lift.bind(FfiConverterString)));
     }
+    lastDiagnostics() {
+        return ((__rb) => {
+            try {
+                return FfiConverterOptionalTypeEmbeddedDriverDiagnostics.lift(__rb);
+            }
+            finally {
+                nativeModule().rustbuffer_free(__rb);
+            }
+        })(uniffiCaller.rustCall(
+        /*caller:*/ (callStatus) => {
+            return nativeModule().uniffi_cua_driver_sdk_fn_method_embeddedcuadriverhost_last_diagnostics(uniffiTypeEmbeddedCuaDriverHostObjectFactory.clonePointer(this), callStatus);
+        }, 
+        /*liftString:*/ FfiConverterString.lift.bind(FfiConverterString)));
+    }
     async restart(asyncOpts_) {
         const __stack = uniffiIsDebug ? new Error().stack : undefined;
         try {
@@ -7547,6 +7605,8 @@ const FfiConverterOptionalTypeVerifyStateOutput = new FfiConverterOptional(FfiCo
 const FfiConverterSequenceTypeCursorMotionSample = new FfiConverterArray(FfiConverterTypeCursorMotionSample);
 // FfiConverter for EmbeddedDriverConnection | undefined
 const FfiConverterOptionalTypeEmbeddedDriverConnection = new FfiConverterOptional(FfiConverterTypeEmbeddedDriverConnection);
+// FfiConverter for EmbeddedDriverDiagnostics | undefined
+const FfiConverterOptionalTypeEmbeddedDriverDiagnostics = new FfiConverterOptional(FfiConverterTypeEmbeddedDriverDiagnostics);
 // FfiConverter for CursorMotionSpec | undefined
 const FfiConverterOptionalTypeCursorMotionSpec = new FfiConverterOptional(FfiConverterTypeCursorMotionSpec);
 // FfiConverter for DriverOptions | undefined
@@ -7902,6 +7962,9 @@ function uniffiEnsureInitialized() {
     if (nativeModule().uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_connection() !== 44467) {
         throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_connection");
     }
+    if (nativeModule().uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_last_diagnostics() !== 57979) {
+        throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_last_diagnostics");
+    }
     if (nativeModule().uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_restart() !== 27248) {
         throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_driver_sdk_checksum_method_embeddedcuadriverhost_restart");
     }
@@ -7996,6 +8059,7 @@ export default Object.freeze({
         FfiConverterTypeDriverServiceTransportError,
         FfiConverterTypeEmbeddedCuaDriverHost,
         FfiConverterTypeEmbeddedDriverConnection,
+        FfiConverterTypeEmbeddedDriverDiagnostics,
         FfiConverterTypeEmbeddedDriverError,
         FfiConverterTypeEmbeddedDriverExit,
         FfiConverterTypeEmbeddedDriverHostOptions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trycua/cua-driver",
-  "version": "0.37.0",
+  "version": "0.39.0",
   "description": "Rust-backed Cua Driver SDK and embedded Node host",
   "type": "module",
   "license": "MIT",
@@ -44,11 +44,11 @@
     "@ubjs/node": "0.31.0-3"
   },
   "optionalDependencies": {
-    "@trycua/cua-driver-darwin-arm64": "0.37.0",
-    "@trycua/cua-driver-darwin-x64": "0.37.0",
-    "@trycua/cua-driver-linux-arm64-gnu": "0.37.0",
-    "@trycua/cua-driver-linux-x64-gnu": "0.37.0",
-    "@trycua/cua-driver-win32-arm64-msvc": "0.37.0",
-    "@trycua/cua-driver-win32-x64-msvc": "0.37.0"
+    "@trycua/cua-driver-darwin-arm64": "0.39.0",
+    "@trycua/cua-driver-darwin-x64": "0.39.0",
+    "@trycua/cua-driver-linux-arm64-gnu": "0.39.0",
+    "@trycua/cua-driver-linux-x64-gnu": "0.39.0",
+    "@trycua/cua-driver-win32-arm64-msvc": "0.39.0",
+    "@trycua/cua-driver-win32-x64-msvc": "0.39.0"
   }
 }