@rynx-ai/remote-runtime-client 0.1.9

package/dist/browser-surface-client.d.ts

@@ -0,0 +1,31 @@
+import { type RuntimeBrowserSurfaceClientFrame, type RuntimeBrowserSurfaceClosedFrame, type RuntimeBrowserSurfaceClosedReason, type RuntimeBrowserSurfaceDriverChangedFrame, type RuntimeBrowserSurfaceImageFrame, type RuntimeBrowserSurfaceOpenFrame, type RuntimeBrowserSurfaceReadyFrame } from "@rynx-ai/protocol/runtime-browser-surface";
+import { DirectRuntimeClientError } from "./errors.js";
+export type DirectRuntimeBrowserSurfaceEvent = RuntimeBrowserSurfaceDriverChangedFrame | RuntimeBrowserSurfaceClosedFrame | RuntimeBrowserSurfaceImageFrame;
+export interface DirectRuntimeBrowserSurfaceClientOptions {
+    timeoutMs?: number;
+    /** Cancels only the connect/authenticate/open barrier. */
+    signal?: AbortSignal;
+    liveness?: {
+        pingIntervalMs?: number;
+        inactivityTimeoutMs?: number;
+    };
+}
+export interface DirectRuntimeBrowserSurfaceConnection extends AsyncIterable<DirectRuntimeBrowserSurfaceEvent> {
+    readonly subscriptionId: string;
+    readonly sessionId: string;
+    readonly pageId: string;
+    readonly daemonInstanceId: string;
+    readonly ready: RuntimeBrowserSurfaceReadyFrame;
+    readonly closed: Promise<RuntimeBrowserSurfaceClosedFrame>;
+    /** Send one already-bounded ACK, driver or human-input control frame. */
+    send(frame: Exclude<RuntimeBrowserSurfaceClientFrame, RuntimeBrowserSurfaceOpenFrame>): Promise<void>;
+    /** Idempotently close this dedicated Surface connection. */
+    close(): Promise<void>;
+}
+export declare class DirectRuntimeBrowserSurfaceError extends DirectRuntimeClientError {
+    readonly reason: RuntimeBrowserSurfaceClosedReason;
+    readonly subscriptionId: string;
+    constructor(reason: RuntimeBrowserSurfaceClosedReason, subscriptionId: string, message: string);
+}
+/** Authenticate a fresh V3 channel and open exactly one Browser Surface. */
+export declare function openDirectRuntimeBrowserSurface(untrustedCredential: unknown, untrustedOpenFrame: unknown, options?: DirectRuntimeBrowserSurfaceClientOptions): Promise<DirectRuntimeBrowserSurfaceConnection>;