@trycua/cua-driver 0.24.0 → 0.25.0

package/dist/native/cua_driver_sdk.d.ts

@@ -1,5 +1,15 @@
 import { type ActionResult, type ClickInput, type ClipboardReadInput, type ClipboardWriteInput, type DragInput, type EndSessionInput, type EndSessionOutput, type EscalateSessionInput, type GetAgentCursorStateInput, type GetCursorPositionInput, type GetDesktopStateInput, type GetScreenSizeInput, type GetSessionInput, type GetSessionStateInput, type HotkeyInput, type InvokeMenuInput, type ListSessionsInput, type ListSessionsOutput, type MoveCursorInput, type PressKeyInput, type ScrollInput, type SessionOutput, type SessionStateOutput, type SetAgentCursorEnabledInput, type SetAgentCursorMotionInput, type SetAgentCursorThemeInput, type SetWindowFrameInput, type StartSessionInput, type StartSessionOutput, type TypeTextInput, type VerifyStateInput, type VerifyStateOutput } from "./cua_driver_contract.js";
 import { type UniffiByteArray, type UniffiGcObject, type UniffiHandle, FfiConverterObject, FfiConverterObjectWithCallbacks, RustBuffer, UniffiAbstractObject, destructorGuardSymbol, pointerLiteralSymbol, uniffiTypeNameSymbol } from "@ubjs/core";
+/**
+ * Connect the canonical typed Driver to a host-provided remote carrier.
+ */
+export declare function connectRemoteChannel(channel: ForeignDriverEnvelopeChannel): CuaDriverLike;
+/**
+ * Bind a logical remote session without serializing its authority.
+ */
+export declare function createRemoteTrustedSession(driver: CuaDriverLike, options: TrustedSessionOptions, asyncOpts_?: {
+    signal: AbortSignal;
+}): Promise<CuaDriverSessionLike>;
 /**
  * Generated-language host factory for a session-bound action surface.
  *
@@ -271,6 +281,245 @@ export declare const EmbeddedDriverHostOptions: Readonly<{
     new: (partial: Partial<EmbeddedDriverHostOptions> & Required<Omit<EmbeddedDriverHostOptions, "socketPath" | "permissionMode" | "startupTimeoutMs" | "shutdownTimeoutMs" | "capabilityManifestPath" | "approveCapabilityManifest" | "sessionPolicyPath" | "noOverlay">>) => EmbeddedDriverHostOptions;
     defaults: () => Partial<EmbeddedDriverHostOptions>;
 }>;
+/**
+ * Opaque context established by the authenticated carrier, not guest claims.
+ */
+export type ForeignDriverChannelIdentity = {
+    authenticatedPrincipal: string;
+    connectionGeneration: string;
+};
+/**
+ * Generated factory for {@link ForeignDriverChannelIdentity} record objects.
+ */
+export declare const ForeignDriverChannelIdentity: Readonly<{
+    create: (partial: Partial<ForeignDriverChannelIdentity> & Required<Omit<ForeignDriverChannelIdentity, never>>) => ForeignDriverChannelIdentity;
+    new: (partial: Partial<ForeignDriverChannelIdentity> & Required<Omit<ForeignDriverChannelIdentity, never>>) => ForeignDriverChannelIdentity;
+    defaults: () => Partial<ForeignDriverChannelIdentity>;
+}>;
+export declare enum ForeignDriverChannelError_Tags {
+    Failed = "Failed"
+}
+export declare const ForeignDriverChannelError: Readonly<{
+    instanceOf: (obj: any) => obj is ForeignDriverChannelError;
+    Failed: {
+        new (inner: {
+            reason: string;
+        }): {
+            readonly tag: ForeignDriverChannelError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        "new"(inner: {
+            reason: string;
+        }): {
+            readonly tag: ForeignDriverChannelError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        instanceOf(obj: any): obj is {
+            readonly tag: ForeignDriverChannelError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        hasInner(obj: any): obj is {
+            readonly tag: ForeignDriverChannelError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+            name: string;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        getInner(obj: {
+            readonly tag: ForeignDriverChannelError_Tags.Failed;
+            readonly inner: Readonly<{
+                reason: string;
+            }>;
+            /**
+             * @private
+             * This field is private and should not be used, use `tag` instead.
+             */
+            readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+            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 ForeignDriverChannelError = InstanceType<typeof ForeignDriverChannelError['Failed']>;
+export type ForeignDriverChannelCapabilities = {
+    minimumEnvelopeVersion: number;
+    maximumEnvelopeVersion: number;
+    supportsCancellation: boolean;
+};
+/**
+ * Generated factory for {@link ForeignDriverChannelCapabilities} record objects.
+ */
+export declare const ForeignDriverChannelCapabilities: Readonly<{
+    create: (partial: Partial<ForeignDriverChannelCapabilities> & Required<Omit<ForeignDriverChannelCapabilities, never>>) => ForeignDriverChannelCapabilities;
+    new: (partial: Partial<ForeignDriverChannelCapabilities> & Required<Omit<ForeignDriverChannelCapabilities, never>>) => ForeignDriverChannelCapabilities;
+    defaults: () => Partial<ForeignDriverChannelCapabilities>;
+}>;
+export type ForeignDriverRequestEnvelope = {
+    envelopeVersion: number;
+    requestId: string;
+    operation: string;
+    name?: string;
+    argumentsJson?: string;
+    deadlineUnixMs: bigint;
+};
+/**
+ * Generated factory for {@link ForeignDriverRequestEnvelope} record objects.
+ */
+export declare const ForeignDriverRequestEnvelope: Readonly<{
+    create: (partial: Partial<ForeignDriverRequestEnvelope> & Required<Omit<ForeignDriverRequestEnvelope, "name" | "argumentsJson">>) => ForeignDriverRequestEnvelope;
+    new: (partial: Partial<ForeignDriverRequestEnvelope> & Required<Omit<ForeignDriverRequestEnvelope, "name" | "argumentsJson">>) => ForeignDriverRequestEnvelope;
+    defaults: () => Partial<ForeignDriverRequestEnvelope>;
+}>;
+export type ForeignDriverResponseEnvelope = {
+    envelopeVersion: number;
+    requestId: string;
+    ok: boolean;
+    resultJson?: string;
+    error?: string;
+    errorCode?: string;
+    completionKnown: boolean;
+};
+/**
+ * Generated factory for {@link ForeignDriverResponseEnvelope} record objects.
+ */
+export declare const ForeignDriverResponseEnvelope: Readonly<{
+    create: (partial: Partial<ForeignDriverResponseEnvelope> & Required<Omit<ForeignDriverResponseEnvelope, "errorCode" | "resultJson" | "error">>) => ForeignDriverResponseEnvelope;
+    new: (partial: Partial<ForeignDriverResponseEnvelope> & Required<Omit<ForeignDriverResponseEnvelope, "errorCode" | "resultJson" | "error">>) => ForeignDriverResponseEnvelope;
+    defaults: () => Partial<ForeignDriverResponseEnvelope>;
+}>;
+/**
+ * Trusted host request for one immutable, connection-bound action surface.
+ */
+export type TrustedSessionOptions = {
+    publicSession: string;
+    mode: SessionPermissionMode;
+    ttlSeconds: bigint;
+    idleTtlSeconds: bigint;
+    capabilityManifestPath?: string;
+    /**
+     * Deprecated alias for `capability_manifest_path`.
+     */
+    boundedManifestPath?: string;
+};
+/**
+ * Generated factory for {@link TrustedSessionOptions} record objects.
+ */
+export declare const TrustedSessionOptions: Readonly<{
+    create: (partial: Partial<TrustedSessionOptions> & Required<Omit<TrustedSessionOptions, "capabilityManifestPath" | "boundedManifestPath">>) => TrustedSessionOptions;
+    new: (partial: Partial<TrustedSessionOptions> & Required<Omit<TrustedSessionOptions, "capabilityManifestPath" | "boundedManifestPath">>) => TrustedSessionOptions;
+    defaults: () => Partial<TrustedSessionOptions>;
+}>;
+/**
+ * Trusted host implementation of the existing remote transport contract.
+ * Identity is captured once when each channel is adapted. A bound channel
+ * must retain its parent's authenticated principal and connection generation.
+ */
+export interface ForeignDriverEnvelopeChannel {
+    identity(): ForeignDriverChannelIdentity;
+    negotiate(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverChannelCapabilities>;
+    exchange(request: ForeignDriverRequestEnvelope, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverResponseEnvelope>;
+    bindSession(options: TrustedSessionOptions, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverBoundChannel>;
+    cancel(requestId: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    close(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+}
+/**
+ * Trusted host implementation of the existing remote transport contract.
+ * Identity is captured once when each channel is adapted. A bound channel
+ * must retain its parent's authenticated principal and connection generation.
+ */
+export declare class ForeignDriverEnvelopeChannelImpl extends UniffiAbstractObject implements ForeignDriverEnvelopeChannel {
+    readonly [uniffiTypeNameSymbol] = "ForeignDriverEnvelopeChannelImpl";
+    readonly [destructorGuardSymbol]: UniffiGcObject;
+    readonly [pointerLiteralSymbol]: UniffiHandle;
+    private constructor();
+    identity(): ForeignDriverChannelIdentity;
+    negotiate(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverChannelCapabilities>;
+    exchange(request: ForeignDriverRequestEnvelope, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverResponseEnvelope>;
+    bindSession(options: TrustedSessionOptions, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<ForeignDriverBoundChannel>;
+    cancel(requestId: string, asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    close(asyncOpts_?: {
+        signal: AbortSignal;
+    }): Promise<void>;
+    uniffiDestroy(): void;
+    static instanceOf(obj_: any): obj_ is ForeignDriverEnvelopeChannelImpl;
+}
+export type ForeignDriverBoundChannel = {
+    channel: ForeignDriverEnvelopeChannel;
+};
+/**
+ * Generated factory for {@link ForeignDriverBoundChannel} record objects.
+ */
+export declare const ForeignDriverBoundChannel: Readonly<{
+    create: (partial: Partial<ForeignDriverBoundChannel> & Required<Omit<ForeignDriverBoundChannel, never>>) => ForeignDriverBoundChannel;
+    new: (partial: Partial<ForeignDriverBoundChannel> & Required<Omit<ForeignDriverBoundChannel, never>>) => ForeignDriverBoundChannel;
+    defaults: () => Partial<ForeignDriverBoundChannel>;
+}>;
 export type ImageContent = {
     mimeType: string;
     dataBase64: string;
@@ -346,28 +595,6 @@ export declare const ToolResult: Readonly<{
     new: (partial: Partial<ToolResult> & Required<Omit<ToolResult, "errorCode" | "action" | "structuredJson" | "verification">>) => ToolResult;
     defaults: () => Partial<ToolResult>;
 }>;
-/**
- * Trusted host request for one immutable, connection-bound action surface.
- */
-export type TrustedSessionOptions = {
-    publicSession: string;
-    mode: SessionPermissionMode;
-    ttlSeconds: bigint;
-    idleTtlSeconds: bigint;
-    capabilityManifestPath?: string;
-    /**
-     * Deprecated alias for `capability_manifest_path`.
-     */
-    boundedManifestPath?: string;
-};
-/**
- * Generated factory for {@link TrustedSessionOptions} record objects.
- */
-export declare const TrustedSessionOptions: Readonly<{
-    create: (partial: Partial<TrustedSessionOptions> & Required<Omit<TrustedSessionOptions, "capabilityManifestPath" | "boundedManifestPath">>) => TrustedSessionOptions;
-    new: (partial: Partial<TrustedSessionOptions> & Required<Omit<TrustedSessionOptions, "capabilityManifestPath" | "boundedManifestPath">>) => TrustedSessionOptions;
-    defaults: () => Partial<TrustedSessionOptions>;
-}>;
 export declare enum ActionCompletion {
     NotStarted = 0,
     Completed = 1,
@@ -2853,6 +3080,119 @@ declare const _default: Readonly<{
             lift(value: UniffiByteArray): EmbeddedPermissionMode;
             lower(value: EmbeddedPermissionMode, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
         };
+        FfiConverterTypeForeignDriverBoundChannel: {
+            read(from: RustBuffer): ForeignDriverBoundChannel;
+            write(value: ForeignDriverBoundChannel, into: RustBuffer): void;
+            allocationSize(value: ForeignDriverBoundChannel): number;
+            lift(value: UniffiByteArray): ForeignDriverBoundChannel;
+            lower(value: ForeignDriverBoundChannel, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeForeignDriverChannelCapabilities: {
+            read(from: RustBuffer): ForeignDriverChannelCapabilities;
+            write(value: ForeignDriverChannelCapabilities, into: RustBuffer): void;
+            allocationSize(value: ForeignDriverChannelCapabilities): number;
+            lift(value: UniffiByteArray): ForeignDriverChannelCapabilities;
+            lower(value: ForeignDriverChannelCapabilities, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeForeignDriverChannelError: {
+            read(from: RustBuffer): {
+                readonly tag: ForeignDriverChannelError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            };
+            write(value: {
+                readonly tag: ForeignDriverChannelError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }, into: RustBuffer): void;
+            allocationSize(value: {
+                readonly tag: ForeignDriverChannelError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }): number;
+            lift(value: UniffiByteArray): {
+                readonly tag: ForeignDriverChannelError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            };
+            lower(value: {
+                readonly tag: ForeignDriverChannelError_Tags.Failed;
+                readonly inner: Readonly<{
+                    reason: string;
+                }>;
+                /**
+                 * @private
+                 * This field is private and should not be used, use `tag` instead.
+                 */
+                readonly [uniffiTypeNameSymbol]: "ForeignDriverChannelError";
+                name: string;
+                message: string;
+                stack?: string;
+                cause?: unknown;
+            }, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeForeignDriverChannelIdentity: {
+            read(from: RustBuffer): ForeignDriverChannelIdentity;
+            write(value: ForeignDriverChannelIdentity, into: RustBuffer): void;
+            allocationSize(value: ForeignDriverChannelIdentity): number;
+            lift(value: UniffiByteArray): ForeignDriverChannelIdentity;
+            lower(value: ForeignDriverChannelIdentity, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeForeignDriverEnvelopeChannel: FfiConverterObjectWithCallbacks<ForeignDriverEnvelopeChannel>;
+        FfiConverterTypeForeignDriverRequestEnvelope: {
+            read(from: RustBuffer): ForeignDriverRequestEnvelope;
+            write(value: ForeignDriverRequestEnvelope, into: RustBuffer): void;
+            allocationSize(value: ForeignDriverRequestEnvelope): number;
+            lift(value: UniffiByteArray): ForeignDriverRequestEnvelope;
+            lower(value: ForeignDriverRequestEnvelope, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
+        FfiConverterTypeForeignDriverResponseEnvelope: {
+            read(from: RustBuffer): ForeignDriverResponseEnvelope;
+            write(value: ForeignDriverResponseEnvelope, into: RustBuffer): void;
+            allocationSize(value: ForeignDriverResponseEnvelope): number;
+            lift(value: UniffiByteArray): ForeignDriverResponseEnvelope;
+            lower(value: ForeignDriverResponseEnvelope, alloc: import("@ubjs/core").RustBufferAllocator): UniffiByteArray;
+        };
         FfiConverterTypeImageContent: {
             read(from: RustBuffer): ImageContent;
             write(value: ImageContent, into: RustBuffer): void;