@trycua/cua-driver 0.26.1 → 0.27.0

package/dist/native/cua_driver_sdk.d.ts

@@ -20,6 +20,10 @@ export declare function createRemoteTrustedSession(driver: CuaDriverLike, option
 export declare function createTrustedSession(driver: CuaDriverLike, options: TrustedSessionOptions): CuaDriverSessionLike;
 export declare function currentMacOsPermissionStatus(): MacOsPermissionStatus;
 export declare function openMacOsScreenRecordingSettings(): void;
+/**
+ * Construct before opening so the owner can invalidate an in-flight initialize.
+ */
+export declare function openMcpDriverChannel(transport: DriverServiceTransport, authenticatedPrincipal: string): McpDriverChannelLike;
 export declare function requestMacOsPermissions(): MacOsPermissionStatus;
 /**
  * Permission mode chosen by trusted host code for a runtime or session.
@@ -194,6 +198,46 @@ export declare const DriverOptions: Readonly<{
     new: (partial: Partial<DriverOptions> & Required<Omit<DriverOptions, never>>) => DriverOptions;
     defaults: () => Partial<DriverOptions>;
 }>;
+export type DriverServiceHeader = {
+    name: string;
+    value: string;
+};
+/**
+ * Generated factory for {@link DriverServiceHeader} record objects.
+ */
+export declare const DriverServiceHeader: Readonly<{
+    create: (partial: Partial<DriverServiceHeader> & Required<Omit<DriverServiceHeader, never>>) => DriverServiceHeader;
+    new: (partial: Partial<DriverServiceHeader> & Required<Omit<DriverServiceHeader, never>>) => DriverServiceHeader;
+    defaults: () => Partial<DriverServiceHeader>;
+}>;
+export type DriverServiceRequest = {
+    method: string;
+    path: string;
+    headers: Array<DriverServiceHeader>;
+    body: ArrayBuffer;
+    timeoutMs: bigint;
+};
+/**
+ * Generated factory for {@link DriverServiceRequest} record objects.
+ */
+export declare const DriverServiceRequest: Readonly<{
+    create: (partial: Partial<DriverServiceRequest> & Required<Omit<DriverServiceRequest, never>>) => DriverServiceRequest;
+    new: (partial: Partial<DriverServiceRequest> & Required<Omit<DriverServiceRequest, never>>) => DriverServiceRequest;
+    defaults: () => Partial<DriverServiceRequest>;
+}>;
+export type DriverServiceResponse = {
+    status: number;
+    headers: Array<DriverServiceHeader>;
+    body: ArrayBuffer;
+};
+/**
+ * Generated factory for {@link DriverServiceResponse} record objects.
+ */
+export declare const DriverServiceResponse: Readonly<{
+    create: (partial: Partial<DriverServiceResponse> & Required<Omit<DriverServiceResponse, never>>) => DriverServiceResponse;
+    new: (partial: Partial<DriverServiceResponse> & Required<Omit<DriverServiceResponse, never>>) => DriverServiceResponse;
+    defaults: () => Partial<DriverServiceResponse>;
+}>;
 export type EmbeddedEnvironmentVariable = {
     name: string;
     value: string;
@@ -1552,6 +1596,99 @@ export declare enum DriverExecutionMode {
     PrivateWorker = 2,
     Remote = 3
 }
+export declare enum DriverServiceTransportError_Tags {
+    Failed = "Failed"
+}
+export declare const DriverServiceTransportError: Readonly<{
+    instanceOf: (obj: any) => obj is DriverServiceTransportError;
+    Failed: {
+        new (inner: {
+            reason: string;
+        }): {
+            readonly tag: DriverServiceTransportError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        "new"(inner: {
+            reason: string;
+        }): {
+            readonly tag: DriverServiceTransportError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: DriverServiceTransportError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        hasInner(obj: any): obj is {
+            readonly tag: DriverServiceTransportError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        getInner(obj: {
+            readonly tag: DriverServiceTransportError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        }): Readonly<{
+            reason: string;
+        }>;
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+        prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+        stackTraceLimit: number;
+    };
+}>;
+export type DriverServiceTransportError = InstanceType<typeof DriverServiceTransportError['Failed']>;
 export declare enum EmbeddedDriverError_Tags {
     Configuration = "Configuration",
     EndpointConflict = "EndpointConflict",
@@ -2844,6 +2981,34 @@ export declare class DriverAuthorizationHostImpl extends UniffiAbstractObject im
     uniffiDestroy(): void;
     static instanceOf(obj_: any): obj_ is DriverAuthorizationHostImpl;
 }
+/**
+ * A host-bound named service, never a guest-selected URL or authority.
+ * The transport must enforce `timeout_ms` and bound buffered response bytes to
+ * 16 MiB. Rust bounds caller waits independently but deliberately never aborts
+ * an active response stream during receiver teardown.
+ */
+export interface DriverServiceTransport {
+    send(request: DriverServiceRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<DriverServiceResponse>;
+}
+/**
+ * A host-bound named service, never a guest-selected URL or authority.
+ * The transport must enforce `timeout_ms` and bound buffered response bytes to
+ * 16 MiB. Rust bounds caller waits independently but deliberately never aborts
+ * an active response stream during receiver teardown.
+ */
+export declare class DriverServiceTransportImpl extends UniffiAbstractObject implements DriverServiceTransport {
+    readonly [uniffiTypeNameSymbol] = "DriverServiceTransportImpl";
+    readonly [destructorGuardSymbol]: UniffiGcObject;
+    readonly [pointerLiteralSymbol]: UniffiHandle;
+    private constructor();
+    send(request: DriverServiceRequest, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<DriverServiceResponse>;
+    uniffiDestroy(): void;
+    static instanceOf(obj_: any): obj_ is DriverServiceTransportImpl;
+}
 export interface EmbeddedCuaDriverHostLike {
     connection(): EmbeddedDriverConnection | undefined;
     restart(asyncOpts_?: {
@@ -2887,6 +3052,36 @@ export declare class EmbeddedCuaDriverHost extends UniffiAbstractObject implemen
     uniffiDestroy(): void;
     static instanceOf(obj_: any): obj_ is EmbeddedCuaDriverHost;
 }
+export interface McpDriverChannelLike {
+    close(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    driver(): CuaDriverLike;
+    open(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    publicSession(): string;
+}
+/**
+ * @deprecated Use `McpDriverChannelLike` instead.
+ */
+export type McpDriverChannelInterface = McpDriverChannelLike;
+export declare class McpDriverChannel extends UniffiAbstractObject implements McpDriverChannelLike {
+    readonly [uniffiTypeNameSymbol] = "McpDriverChannel";
+    readonly [destructorGuardSymbol]: UniffiGcObject;
+    readonly [pointerLiteralSymbol]: UniffiHandle;
+    private constructor();
+    close(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    driver(): CuaDriverLike;
+    open(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    publicSession(): string;
+    uniffiDestroy(): void;
+    static instanceOf(obj_: any): obj_ is McpDriverChannel;
+}
 /**
  * This should be called before anything else.
  *
@@ -3059,6 +3254,105 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): DriverOptions;
             lower(value: DriverOptions, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeDriverServiceHeader: {
+            read(from: RustBuffer): DriverServiceHeader;
+            write(value: DriverServiceHeader, into: RustBuffer): void;
+            allocationSize(value: DriverServiceHeader): number;
+            lift(value: UniffiByteArray): DriverServiceHeader;
+            lower(value: DriverServiceHeader, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeDriverServiceRequest: {
+            read(from: RustBuffer): DriverServiceRequest;
+            write(value: DriverServiceRequest, into: RustBuffer): void;
+            allocationSize(value: DriverServiceRequest): number;
+            lift(value: UniffiByteArray): DriverServiceRequest;
+            lower(value: DriverServiceRequest, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeDriverServiceResponse: {
+            read(from: RustBuffer): DriverServiceResponse;
+            write(value: DriverServiceResponse, into: RustBuffer): void;
+            allocationSize(value: DriverServiceResponse): number;
+            lift(value: UniffiByteArray): DriverServiceResponse;
+            lower(value: DriverServiceResponse, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeDriverServiceTransport: FfiConverterObjectWithCallbacks<DriverServiceTransport>;
+        FfiConverterTypeDriverServiceTransportError: {
+            read(from: RustBuffer): {
+                readonly tag: DriverServiceTransportError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            };
+            write(value: {
+                readonly tag: DriverServiceTransportError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }, into: RustBuffer): void;
+            allocationSize(value: {
+                readonly tag: DriverServiceTransportError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }): number;
+            lift(value: UniffiByteArray): {
+                readonly tag: DriverServiceTransportError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            };
+            lower(value: {
+                readonly tag: DriverServiceTransportError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "DriverServiceTransportError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeEmbeddedCuaDriverHost: FfiConverterObject<EmbeddedCuaDriverHostLike>;
         FfiConverterTypeEmbeddedDriverConnection: {
             read(from: RustBuffer): EmbeddedDriverConnection;
@@ -3243,6 +3537,7 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): MacOsPermissionStatus;
             lower(value: MacOsPermissionStatus, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeMcpDriverChannel: FfiConverterObject<McpDriverChannelLike>;
         FfiConverterTypePrivateWorkerOptions: {
             read(from: RustBuffer): PrivateWorkerOptions;
             write(value: PrivateWorkerOptions, into: RustBuffer): void;