@opengeni/sdk 0.48.0 → 0.52.1

package/dist/interaction.d.ts

@@ -0,0 +1,885 @@
+import type { OpenGeniRequestOptions } from "./client.js";
+import type { RetainedArtifactReference } from "./types.js";
+/** Public Browser/Computer protocol version. Driver and provider details stay private. */
+export declare const INTERACTION_PROTOCOL_VERSION: 1;
+export declare const BROWSER_CONTROL_WEBSOCKET_PROTOCOL: "opengeni.browser.v1";
+export declare const COMPUTER_CONTROL_WEBSOCKET_PROTOCOL: "opengeni.computer.v1";
+export declare const BROWSER_CONTROL_WEBSOCKET_BEARER_PREFIX: "opengeni.auth.";
+export declare const BROWSER_CONTROL_MAX_FRAME_HEADER_BYTES: number;
+export declare const BROWSER_FRAME_MAX_BYTES: number;
+export declare const BROWSER_FRAME_MAX_DIMENSION = 32768;
+export declare const BROWSER_FRAME_MAX_PIXELS = 100000000;
+export type InteractionJsonValue = null | string | number | boolean | InteractionJsonValue[] | {
+    [key: string]: InteractionJsonValue;
+};
+export type InteractionPlacement = {
+    kind: "sandbox_group";
+    sandboxGroupId: string;
+} | {
+    kind: "connected_machine";
+    sandboxId: string;
+} | {
+    kind: "attached_device";
+    deviceId: string;
+} | {
+    kind: "external_provider";
+    providerId: string;
+    placementId: string;
+};
+export type AttachedBrowserDeviceCapabilities = {
+    tabInventory: boolean;
+    debuggerAttachment: boolean;
+    semanticObservation: boolean;
+    screenshots: boolean;
+    liveFrames: boolean;
+    humanInput: boolean;
+    diagnostics: boolean;
+    rawCdp: boolean;
+    linkedComputer: boolean;
+};
+/** One live browser-profile endpoint on an enrolled machine. Saved, reusable
+ *  login state is represented separately by BrowserIdentity. */
+export type AttachedBrowserDevice = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    enrollmentId: string;
+    name: string;
+    profileLabel: string | null;
+    browserName: string;
+    browserVersion: string;
+    extensionVersion: string;
+    platform: "linux" | "macos" | "windows";
+    architecture: "x64" | "arm64";
+    state: "connected" | "disconnected";
+    connectionGeneration: string;
+    inventoryRevision: number;
+    tabCount: number;
+    capabilities: AttachedBrowserDeviceCapabilities;
+    lastSeenAt: string;
+    disconnectedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type AttachedBrowserDeviceListResponse = {
+    revision: number;
+    devices: AttachedBrowserDevice[];
+};
+export type InteractionControllerBinding = {
+    controllerId: string;
+    controllerGeneration: string;
+    placementInstanceId: string;
+};
+export type InteractionAssociation = {
+    sessionId: string;
+    turnId: string | null;
+    attemptId: string | null;
+    relationship: "created" | "using" | "observing" | "related";
+    actorSubjectId: string;
+    lastUsedAt: string;
+};
+export type InteractionLifecycle = "starting" | "active" | "suspending" | "suspended" | "restoring" | "repair_required" | "lost" | "ending" | "ended" | "failed";
+export type BrowserSessionCapabilities = {
+    semanticObservation: boolean;
+    screenshots: boolean;
+    liveFrames: boolean;
+    humanInput: boolean;
+    tabs: boolean;
+    downloads: boolean;
+    uploads: boolean;
+    clipboard: boolean;
+    diagnostics: boolean;
+    rawCdp: boolean;
+    linkedComputer: boolean;
+    privateCheckpoint: boolean;
+    identityPublication: boolean;
+    parallelTargets: boolean;
+};
+export type BrowserSession = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    name: string;
+    lifecycle: InteractionLifecycle;
+    placement: InteractionPlacement;
+    controller: InteractionControllerBinding | null;
+    driverId: string;
+    engine: "chromium" | "chrome" | "firefox" | "webkit" | "lightpanda" | "external";
+    engineVersion: string | null;
+    headless: boolean;
+    identityId: string | null;
+    baseRevisionId: string | null;
+    networkRouteId: string | null;
+    linkedComputerSessionId: string | null;
+    capabilities: BrowserSessionCapabilities;
+    associations: InteractionAssociation[];
+    createdBySubjectId: string;
+    createdAt: string;
+    lastUsedAt: string;
+    failureCode: string | null;
+};
+export type BrowserIdentityStatus = "active" | "archived";
+export type BrowserRevisionComponentKind = "chromium_profile" | "normalized_web_state" | "provider_snapshot";
+export type BrowserRevisionPortability = "portable" | "provider_bound" | "placement_bound";
+export type BrowserRevisionMaterialization = {
+    portability: BrowserRevisionPortability;
+    reason: string | null;
+    platform: "linux" | "macos" | "windows" | null;
+    architecture: "x64" | "arm64" | null;
+    engine: "chromium" | "chrome" | "firefox" | "webkit" | "lightpanda" | "external";
+    engineVersion: string | null;
+    driverId: string;
+    driverSchemaVersion: number;
+    profileCrypto: "chromium_basic" | "chromium_mock_keychain" | "platform_bound";
+    providerId: string | null;
+    placement: InteractionPlacement | null;
+};
+export type BrowserRevisionComponent = {
+    id: string;
+    kind: BrowserRevisionComponentKind;
+    format: string;
+    artifactDigest: string;
+    sizeBytes: number;
+    materialization: BrowserRevisionMaterialization;
+};
+export type BrowserRevision = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    identityId: string;
+    parentRevisionId: string | null;
+    ordinal: number;
+    sourceBrowserSessionId: string;
+    manifestDigest: string;
+    components: BrowserRevisionComponent[];
+    createdBySubjectId: string;
+    createdAt: string;
+};
+export type BrowserIdentity = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    name: string;
+    status: BrowserIdentityStatus;
+    defaultRevisionId: string | null;
+    headGeneration: number;
+    revisionCount: number;
+    createdBySubjectId: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export type BrowserIdentityListResponse = {
+    revision: number;
+    identities: BrowserIdentity[];
+};
+export type BrowserRevisionListResponse = {
+    identity: BrowserIdentity;
+    revisions: BrowserRevision[];
+};
+export type CreateBrowserIdentityRequest = {
+    operationId: string;
+    name: string;
+};
+export type BrowserIdentityMutationResponse = {
+    identity: BrowserIdentity;
+    operationId: string;
+    replayed: boolean;
+};
+export type PublishBrowserRevisionRequest = {
+    operationId: string;
+    identityId: string;
+    expectedHeadGeneration: number;
+    advanceDefault?: boolean | undefined;
+};
+export type PublishBrowserRevisionResponse = {
+    identity: BrowserIdentity;
+    revision: BrowserRevision;
+    outcome: "saved_as_default" | "saved_not_default";
+    replayed: boolean;
+};
+export type BrowserTarget = {
+    id: string;
+    browserSessionId: string;
+    controllerGeneration: string;
+    targetGeneration: string;
+    documentGeneration: string | null;
+    kind: "page" | "popup" | "background_page" | "worker";
+    title: string;
+    url: string;
+    selected: boolean;
+    attached: boolean;
+    createdAt: string;
+};
+export type InteractionRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type InteractionRedactedValue = {
+    redacted: true;
+    reason: "password" | "payment" | "private" | "policy";
+};
+export type InteractionSemanticNode = {
+    ref: string;
+    role: string;
+    identifier?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    value?: string | InteractionRedactedValue | undefined;
+    states: string[];
+    bounds?: InteractionRect | undefined;
+    actions: string[];
+    children?: InteractionSemanticNode[] | undefined;
+    native?: {
+        platform: "dom" | "mac_ax" | "at_spi" | "uia";
+        data: unknown;
+    } | undefined;
+};
+export type InteractionSemanticSnapshot = {
+    kind: "snapshot";
+    roots: InteractionSemanticNode[];
+    nodeCount: number;
+};
+export type InteractionSemanticDiff = {
+    kind: "diff";
+    baseObservationId: string;
+    removedRefs: string[];
+    changed: InteractionSemanticNode[];
+};
+export type InteractionDiagnosticSummary = {
+    consoleErrorCount: number;
+    failedRequestCount: number;
+    downloadCount: number;
+    pageErrorCount: number;
+};
+export type BrowserDialog = {
+    type: "alert" | "confirm" | "prompt" | "beforeunload";
+    message: string;
+    defaultPrompt: string;
+    openedAt: string;
+};
+export type BrowserObservation = {
+    protocolVersion: typeof INTERACTION_PROTOCOL_VERSION;
+    observationId: string;
+    browserSessionId: string;
+    target: BrowserTarget;
+    frameId: string | null;
+    semantic: InteractionSemanticSnapshot | InteractionSemanticDiff | null;
+    screenshot: RetainedArtifactReference | null;
+    focusedRef: string | null;
+    changedRegions: InteractionRect[];
+    diagnostics: InteractionDiagnosticSummary;
+    dialog: BrowserDialog | null;
+    observedAt: string;
+};
+export type BrowserDiagnosticKind = "console" | "page_error" | "failed_request" | "download";
+export type BrowserDiagnosticEntry = {
+    sequence: number;
+    kind: BrowserDiagnosticKind;
+    level: "debug" | "info" | "warning" | "error" | null;
+    message: string;
+    url: string | null;
+    method: string | null;
+    status: number | null;
+    filename: string | null;
+    occurredAt: string;
+};
+export type BrowserDiagnosticBatch = {
+    browserSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    targetGeneration: string;
+    entries: BrowserDiagnosticEntry[];
+    cursor: number;
+    truncated: boolean;
+};
+export type BrowserLocator = {
+    kind: "ref";
+    ref: string;
+} | {
+    kind: "role";
+    role: string;
+    name?: string | undefined;
+    exact?: boolean | undefined;
+} | {
+    kind: "label";
+    text: string;
+} | {
+    kind: "text";
+    text: string;
+} | {
+    kind: "placeholder";
+    text: string;
+} | {
+    kind: "test_id";
+    value: string;
+} | {
+    kind: "css";
+    selector: string;
+};
+export type BrowserAction = {
+    type: "navigate";
+    url: string;
+} | {
+    type: "click";
+    locator: BrowserLocator;
+    button?: "left" | "right" | "middle" | undefined;
+} | {
+    type: "double_click";
+    locator: BrowserLocator;
+} | {
+    type: "hover";
+    locator: BrowserLocator;
+} | {
+    type: "fill";
+    locator: BrowserLocator;
+    value: string;
+} | {
+    type: "type";
+    locator?: BrowserLocator | undefined;
+    text: string;
+} | {
+    type: "press";
+    locator?: BrowserLocator | undefined;
+    key: string;
+} | {
+    type: "select";
+    locator: BrowserLocator;
+    values: string[];
+} | {
+    type: "check";
+    locator: BrowserLocator;
+    checked: boolean;
+} | {
+    type: "scroll";
+    locator?: BrowserLocator | undefined;
+    deltaX: number;
+    deltaY: number;
+} | {
+    type: "drag";
+    from: BrowserLocator;
+    to: BrowserLocator;
+} | {
+    type: "pointer";
+    action: "click" | "double_click" | "move" | "scroll" | "drag";
+    x: number;
+    y: number;
+    endX?: number | undefined;
+    endY?: number | undefined;
+    deltaX?: number | undefined;
+    deltaY?: number | undefined;
+    button?: "left" | "right" | "middle" | undefined;
+} | {
+    type: "handle_dialog";
+    response: "accept" | "dismiss";
+    promptText?: string | undefined;
+} | {
+    type: "upload";
+    locator: BrowserLocator;
+    workspaceFileIds: string[];
+} | {
+    type: "wait";
+    condition: "load" | "network_idle" | "visible" | "hidden";
+    locator?: BrowserLocator | undefined;
+    timeoutMs?: number | undefined;
+};
+export type BrowserActionBatch = {
+    type: "batch";
+    actions: BrowserAction[];
+};
+export type InteractionError = {
+    code: "resource_not_found" | "resource_unavailable" | "controller_stale" | "target_not_found" | "target_stale" | "observation_stale" | "document_stale" | "frame_stale" | "locator_not_found" | "locator_ambiguous" | "unsupported" | "permission_denied" | "machine_locked" | "attempt_stale" | "operation_conflict" | "outcome_unknown" | "invalid_action" | "timeout" | "controller_lost" | "driver_failed";
+    message: string;
+    retryable: boolean;
+    details?: Record<string, InteractionJsonValue> | undefined;
+};
+export type InteractionOperationState = "prepared" | "dispatched" | "completed" | "failed" | "outcome_unknown";
+export type InteractionLifecycleOperationReceipt = {
+    operationId: string;
+    resourceKind: "browser_session" | "computer_session";
+    resourceId: string;
+    kind: "create" | "resume" | "suspend" | "end" | "publish";
+    state: InteractionOperationState;
+    replayed: boolean;
+    error: InteractionError | null;
+    createdAt: string;
+    dispatchedAt: string | null;
+    settledAt: string | null;
+};
+export type CreateBrowserSessionRequest = {
+    operationId: string;
+    sessionId: string;
+    name?: string | undefined;
+    initialUrl?: string | undefined;
+    headless?: boolean | undefined;
+    placement?: InteractionPlacement | undefined;
+    identityId?: string | undefined;
+    baseRevisionId?: string | undefined;
+    linkedComputerSessionId?: string | undefined;
+};
+export type BrowserSessionListResponse = {
+    revision: number;
+    sessions: BrowserSession[];
+};
+export type BrowserSessionMutationResponse = {
+    session: BrowserSession;
+    operation: InteractionLifecycleOperationReceipt;
+};
+export type BrowserSessionLifecycleRequest = {
+    operationId: string;
+};
+export type BrowserOpenTargetRequest = {
+    url?: string | undefined;
+};
+export type BrowserTargetListResponse = {
+    browserSessionId: string;
+    controllerGeneration: string;
+    targets: BrowserTarget[];
+};
+export type InteractionFrameStreamAttachment<RelayKind extends 3 | 4 = 3 | 4> = {
+    kind: "direct_websocket";
+    url: string;
+    protocols: string[];
+} | {
+    kind: "relay";
+    url: string;
+    token: string;
+    channel: {
+        channelId: string;
+        workspaceId: string;
+        agentId: string;
+        kind: RelayKind;
+        port: number;
+    };
+};
+export type BrowserSessionAttachment = {
+    browserSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    stream: InteractionFrameStreamAttachment<3>;
+    expiresAt: string;
+};
+export type BrowserSessionAttachmentRequest = {
+    targetId: string;
+    expiresInSeconds?: number | undefined;
+    stream?: BrowserFrameStreamOptions | undefined;
+};
+export type BrowserActionRequest = {
+    operationId: string;
+    targetId: string;
+    expectedTargetGeneration: string;
+    expectedDocumentGeneration: string | null;
+    expectedFrameId: string | null;
+    action: BrowserAction | BrowserActionBatch;
+};
+export type BrowserActionReceipt = {
+    protocolVersion: typeof INTERACTION_PROTOCOL_VERSION;
+    operationId: string;
+    browserSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    state: InteractionOperationState;
+    dispatchedAt: string | null;
+    settledAt: string | null;
+    observation: BrowserObservation | null;
+    error: InteractionError | null;
+};
+export type BrowserSessionHeartbeatResponse = {
+    browserSessionId: string;
+    controllerGeneration: string;
+    alive: true;
+};
+export type ComputerSessionCapabilities = {
+    semanticObservation: boolean;
+    appDiscovery: boolean;
+    appLaunch: boolean;
+    windowCapture: boolean;
+    screenCapture: boolean;
+    semanticActions: boolean;
+    pointerInput: boolean;
+    keyboardInput: boolean;
+    backgroundActions: boolean;
+    parallelApps: boolean;
+};
+export type ComputerSession = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    name: string;
+    lifecycle: InteractionLifecycle;
+    placement: InteractionPlacement;
+    controller: InteractionControllerBinding | null;
+    platform: "linux" | "macos" | "windows" | null;
+    adapter: string | null;
+    seatId: string | null;
+    displayId: string | null;
+    capabilities: ComputerSessionCapabilities | null;
+    associations: InteractionAssociation[];
+    createdBySubjectId: string;
+    createdAt: string;
+    lastUsedAt: string;
+    failureCode: string | null;
+};
+export type ComputerTarget = {
+    id: string;
+    computerSessionId: string;
+    controllerGeneration: string;
+    targetGeneration: string;
+    kind: "app" | "window" | "screen";
+    applicationId: string | null;
+    processId: number | null;
+    title: string;
+    bounds: InteractionRect | null;
+    focused: boolean;
+};
+export type ComputerObservation = {
+    protocolVersion: typeof INTERACTION_PROTOCOL_VERSION;
+    observationId: string;
+    computerSessionId: string;
+    target: ComputerTarget;
+    frameId: string | null;
+    semantic: InteractionSemanticSnapshot | InteractionSemanticDiff | null;
+    screenshot: RetainedArtifactReference | null;
+    focusedRef: string | null;
+    changedRegions: InteractionRect[];
+    observedAt: string;
+};
+export type ComputerLocator = {
+    kind: "ref";
+    ref: string;
+} | {
+    kind: "role";
+    role: string;
+    name?: string | undefined;
+    exact?: boolean | undefined;
+} | {
+    kind: "label";
+    text: string;
+    exact?: boolean | undefined;
+} | {
+    kind: "text";
+    text: string;
+    exact?: boolean | undefined;
+} | {
+    kind: "identifier";
+    value: string;
+};
+export type ComputerAction = {
+    type: "semantic";
+    locator: ComputerLocator;
+    action: "invoke" | "focus" | "set_value" | "increment" | "decrement" | "select" | "deselect" | "expand" | "collapse" | "show_menu" | "scroll_into_view";
+    value?: string | number | boolean | undefined;
+} | {
+    type: "pointer";
+    frameId: string;
+    action: "click" | "double_click" | "move" | "scroll" | "drag";
+    x: number;
+    y: number;
+    endX?: number | undefined;
+    endY?: number | undefined;
+    deltaX?: number | undefined;
+    deltaY?: number | undefined;
+    button?: "left" | "right" | "middle" | undefined;
+} | {
+    type: "keyboard";
+    action: "type" | "press";
+    value: string;
+} | {
+    type: "focus";
+    targetId: string;
+} | {
+    type: "launch";
+    applicationId: string;
+};
+export type CreateComputerSessionRequest = {
+    operationId: string;
+    sessionId: string;
+    name?: string | undefined;
+    placement?: InteractionPlacement | undefined;
+};
+export type ComputerSessionListResponse = {
+    revision: number;
+    sessions: ComputerSession[];
+};
+export type ComputerSessionMutationResponse = {
+    session: ComputerSession;
+    operation: InteractionLifecycleOperationReceipt;
+};
+export type ComputerSessionLifecycleRequest = {
+    operationId: string;
+};
+export type ComputerTargetListResponse = {
+    computerSessionId: string;
+    controllerGeneration: string;
+    targets: ComputerTarget[];
+};
+export type InteractionFrameStreamOptions = {
+    format?: "jpeg" | "png" | undefined;
+    quality?: number | undefined;
+    maxWidth?: number | undefined;
+    maxHeight?: number | undefined;
+    everyNthFrame?: number | undefined;
+};
+export type ComputerFrameStreamOptions = InteractionFrameStreamOptions;
+export type ComputerSessionAttachment = {
+    computerSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    stream: InteractionFrameStreamAttachment<4>;
+    expiresAt: string;
+};
+export type ComputerSessionAttachmentRequest = {
+    targetId: string;
+    expiresInSeconds?: number | undefined;
+    stream?: ComputerFrameStreamOptions | undefined;
+};
+export type ComputerActionRequest = {
+    operationId: string;
+    targetId: string;
+    expectedTargetGeneration: string;
+    expectedObservationId: string | null;
+    expectedFrameId: string | null;
+    action: ComputerAction;
+};
+export type ComputerActionReceipt = {
+    protocolVersion: typeof INTERACTION_PROTOCOL_VERSION;
+    operationId: string;
+    computerSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    state: InteractionOperationState;
+    dispatchedAt: string | null;
+    settledAt: string | null;
+    observation: ComputerObservation | null;
+    error: InteractionError | null;
+};
+export type ComputerSessionHeartbeatResponse = {
+    computerSessionId: string;
+    controllerGeneration: string;
+    alive: true;
+};
+export type BrowserDiagnosticsOptions = {
+    kinds?: BrowserDiagnosticKind[] | undefined;
+    after?: number | undefined;
+    limit?: number | undefined;
+    signal?: AbortSignal | undefined;
+};
+/** The exact HTTP surface needed by the framework-free interaction client. */
+export interface InteractionTransport {
+    listAttachedBrowsers(workspaceId: string, options?: AttachedBrowserDeviceListOptions): Promise<AttachedBrowserDeviceListResponse>;
+    getAttachedBrowser(workspaceId: string, deviceId: string, options?: OpenGeniRequestOptions): Promise<AttachedBrowserDevice>;
+    listBrowserIdentities(workspaceId: string, options?: BrowserIdentityListOptions): Promise<BrowserIdentityListResponse>;
+    getBrowserIdentity(workspaceId: string, identityId: string, options?: OpenGeniRequestOptions): Promise<BrowserIdentity>;
+    createBrowserIdentity(workspaceId: string, request: CreateBrowserIdentityRequest, options?: OpenGeniRequestOptions): Promise<BrowserIdentityMutationResponse>;
+    listBrowserRevisions(workspaceId: string, identityId: string, options?: OpenGeniRequestOptions): Promise<BrowserRevisionListResponse>;
+    listBrowserSessions(workspaceId: string, options?: OpenGeniRequestOptions): Promise<BrowserSessionListResponse>;
+    getBrowserSession(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserSession>;
+    createBrowserSession(workspaceId: string, request: CreateBrowserSessionRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    listBrowserTargets(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
+    openBrowserTarget(workspaceId: string, browserSessionId: string, request?: BrowserOpenTargetRequest, options?: OpenGeniRequestOptions): Promise<BrowserTarget>;
+    selectBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTarget>;
+    closeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
+    observeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
+    actInBrowser(workspaceId: string, browserSessionId: string, request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
+    getBrowserActionReceipt(workspaceId: string, browserSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
+    listBrowserDiagnostics(workspaceId: string, browserSessionId: string, targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
+    attachBrowserSession(workspaceId: string, browserSessionId: string, request: BrowserSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionAttachment>;
+    heartbeatBrowserSession(workspaceId: string, browserSessionId: string, options?: OpenGeniRequestOptions): Promise<BrowserSessionHeartbeatResponse>;
+    publishBrowserRevision(workspaceId: string, browserSessionId: string, request: PublishBrowserRevisionRequest, options?: OpenGeniRequestOptions): Promise<PublishBrowserRevisionResponse>;
+    suspendBrowserSession(workspaceId: string, browserSessionId: string, request: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    resumeBrowserSession(workspaceId: string, browserSessionId: string, request: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    endBrowserSession(workspaceId: string, browserSessionId: string, request: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    listComputerSessions(workspaceId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionListResponse>;
+    getComputerSession(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSession>;
+    createComputerSession(workspaceId: string, request: CreateComputerSessionRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionMutationResponse>;
+    listComputerTargets(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerTargetListResponse>;
+    observeComputerTarget(workspaceId: string, computerSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerObservation>;
+    actInComputer(workspaceId: string, computerSessionId: string, request: ComputerActionRequest, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
+    getComputerActionReceipt(workspaceId: string, computerSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
+    attachComputerSession(workspaceId: string, computerSessionId: string, request: ComputerSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionAttachment>;
+    heartbeatComputerSession(workspaceId: string, computerSessionId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionHeartbeatResponse>;
+    endComputerSession(workspaceId: string, computerSessionId: string, request: ComputerSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionMutationResponse>;
+}
+/** @deprecated Use InteractionTransport. */
+export type BrowserInteractionTransport = InteractionTransport;
+export type BrowserIdentityListOptions = OpenGeniRequestOptions & {
+    includeArchived?: boolean | undefined;
+};
+export type AttachedBrowserDeviceListOptions = OpenGeniRequestOptions & {
+    includeDisconnected?: boolean | undefined;
+};
+export type CurrentOrOpenBrowserOptions = {
+    workspaceId: string;
+    associationSessionId: string;
+    operationId?: string | undefined;
+    name?: string | undefined;
+    initialUrl?: string | undefined;
+    headless?: boolean | undefined;
+    placement?: InteractionPlacement | undefined;
+    identityId?: string | undefined;
+    baseRevisionId?: string | undefined;
+    linkedComputerSessionId?: string | undefined;
+    signal?: AbortSignal | undefined;
+};
+export type CurrentOrOpenComputerOptions = {
+    workspaceId: string;
+    associationSessionId: string;
+    operationId?: string | undefined;
+    name?: string | undefined;
+    placement?: InteractionPlacement | undefined;
+    signal?: AbortSignal | undefined;
+};
+/** Framework-free resource facade over the public interaction HTTP API. */
+export declare class OpenGeniInteractionClient {
+    readonly attachedBrowsers: AttachedBrowserDeviceCollection;
+    readonly browsers: BrowserSessionCollection;
+    readonly computers: ComputerSessionCollection;
+    readonly identities: BrowserIdentityCollection;
+    constructor(transport: BrowserInteractionTransport);
+}
+export declare class AttachedBrowserDeviceCollection {
+    private readonly transport;
+    constructor(transport: BrowserInteractionTransport);
+    list(workspaceId: string, options?: AttachedBrowserDeviceListOptions): Promise<AttachedBrowserDeviceListResponse>;
+    device(workspaceId: string, deviceId: string): AttachedBrowserDeviceResource;
+}
+export declare class AttachedBrowserDeviceResource {
+    private readonly transport;
+    readonly workspaceId: string;
+    readonly id: string;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, id: string);
+    get(options?: OpenGeniRequestOptions): Promise<AttachedBrowserDevice>;
+}
+export declare class BrowserIdentityCollection {
+    private readonly transport;
+    constructor(transport: BrowserInteractionTransport);
+    list(workspaceId: string, options?: BrowserIdentityListOptions): Promise<BrowserIdentityListResponse>;
+    identity(workspaceId: string, identityId: string): BrowserIdentityResource;
+    create(workspaceId: string, request: CreateBrowserIdentityRequest, options?: OpenGeniRequestOptions): Promise<BrowserIdentityResource>;
+}
+export declare class BrowserIdentityResource {
+    private readonly transport;
+    readonly workspaceId: string;
+    readonly id: string;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, id: string);
+    get(options?: OpenGeniRequestOptions): Promise<BrowserIdentity>;
+    revisions(options?: OpenGeniRequestOptions): Promise<BrowserRevisionListResponse>;
+}
+export declare class BrowserSessionCollection {
+    private readonly transport;
+    constructor(transport: BrowserInteractionTransport);
+    list(workspaceId: string, options?: OpenGeniRequestOptions): Promise<BrowserSessionListResponse>;
+    session(workspaceId: string, browserSessionId: string): BrowserSessionResource;
+    open(workspaceId: string, request: CreateBrowserSessionRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionResource>;
+    currentOrOpen(options: CurrentOrOpenBrowserOptions): Promise<BrowserSessionResource>;
+}
+export declare class BrowserSessionResource {
+    private readonly transport;
+    readonly workspaceId: string;
+    readonly id: string;
+    readonly tabs: BrowserTargetCollection;
+    /** Alias for hosts that prefer the protocol term. */
+    readonly targets: BrowserTargetCollection;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, id: string);
+    get(options?: OpenGeniRequestOptions): Promise<BrowserSession>;
+    observe(targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
+    act(request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
+    receipt(operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
+    diagnostics(targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
+    attach(request: BrowserSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionAttachment>;
+    heartbeat(options?: OpenGeniRequestOptions): Promise<BrowserSessionHeartbeatResponse>;
+    publishRevision(request: PublishBrowserRevisionRequest, options?: OpenGeniRequestOptions): Promise<PublishBrowserRevisionResponse>;
+    suspend(request?: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    resume(request?: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+    end(request?: BrowserSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<BrowserSessionMutationResponse>;
+}
+export declare class BrowserTargetCollection {
+    private readonly transport;
+    private readonly workspaceId;
+    private readonly browserSessionId;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, browserSessionId: string);
+    list(options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
+    open(url?: string, options?: OpenGeniRequestOptions): Promise<BrowserTarget>;
+    select(targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTarget>;
+    close(targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
+}
+export declare class ComputerSessionCollection {
+    private readonly transport;
+    constructor(transport: BrowserInteractionTransport);
+    list(workspaceId: string, options?: OpenGeniRequestOptions): Promise<ComputerSessionListResponse>;
+    session(workspaceId: string, computerSessionId: string): ComputerSessionResource;
+    open(workspaceId: string, request: CreateComputerSessionRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionResource>;
+    currentOrOpen(options: CurrentOrOpenComputerOptions): Promise<ComputerSessionResource>;
+}
+export declare class ComputerSessionResource {
+    private readonly transport;
+    readonly workspaceId: string;
+    readonly id: string;
+    readonly targets: ComputerTargetCollection;
+    /** Native application/window targets are also the public app collection. */
+    readonly apps: ComputerTargetCollection;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, id: string);
+    get(options?: OpenGeniRequestOptions): Promise<ComputerSession>;
+    observe(targetId: string, options?: OpenGeniRequestOptions): Promise<ComputerObservation>;
+    act(request: ComputerActionRequest, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
+    receipt(operationId: string, options?: OpenGeniRequestOptions): Promise<ComputerActionReceipt>;
+    attach(request: ComputerSessionAttachmentRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionAttachment>;
+    heartbeat(options?: OpenGeniRequestOptions): Promise<ComputerSessionHeartbeatResponse>;
+    end(request?: ComputerSessionLifecycleRequest, options?: OpenGeniRequestOptions): Promise<ComputerSessionMutationResponse>;
+}
+export declare class ComputerTargetCollection {
+    private readonly transport;
+    private readonly workspaceId;
+    private readonly computerSessionId;
+    constructor(transport: BrowserInteractionTransport, workspaceId: string, computerSessionId: string);
+    list(options?: OpenGeniRequestOptions): Promise<ComputerTargetListResponse>;
+}
+export type BrowserFrameMetadata = {
+    frameId: string;
+    browserSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    targetGeneration: string;
+    documentGeneration: string;
+    sequence: number;
+    mediaType: "image/jpeg" | "image/png";
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+    scrollX: number;
+    scrollY: number;
+    capturedAt: string;
+};
+export type BrowserFrame = BrowserFrameMetadata & {
+    data: Uint8Array;
+};
+export type ComputerFrameMetadata = {
+    frameId: string;
+    computerSessionId: string;
+    controllerGeneration: string;
+    targetId: string;
+    targetGeneration: string;
+    sequence: number;
+    mediaType: "image/jpeg" | "image/png";
+    width: number;
+    height: number;
+    capturedAt: string;
+    sha256: string;
+};
+export type ComputerFrame = ComputerFrameMetadata & {
+    data: Uint8Array;
+};
+export type BrowserFrameStreamOptions = InteractionFrameStreamOptions;
+/** Convert a short-lived HTTP attachment URL into its browser WebSocket URL. */
+export declare function browserFrameSocketUrl(attachment: BrowserSessionAttachment, options?: BrowserFrameStreamOptions): string;
+/** Convert a direct ComputerSession attachment into its WebSocket URL. */
+export declare function computerFrameSocketUrl(attachment: ComputerSessionAttachment, options?: ComputerFrameStreamOptions): string;
+/** Decode one bounded binary frame message from the placement controller. */
+export declare function decodeBrowserFrameMessage(message: ArrayBuffer | Uint8Array): BrowserFrame;
+/** Decode and authenticate one bounded ComputerSession frame. Computer frames
+ * carry a content digest because native capture adapters may cross process and
+ * relay boundaries before reaching the SDK. */
+export declare function decodeComputerFrameMessage(message: ArrayBuffer | Uint8Array): Promise<ComputerFrame>;
+export declare function parseBrowserFrameMetadata(value: unknown): BrowserFrameMetadata;
+export declare function parseComputerFrameMetadata(value: unknown): ComputerFrameMetadata;