@byokit/openclaw 0.5.1 → 0.6.1

package/dist/browser/host.d.ts

@@ -0,0 +1,98 @@
+import type { BrowserHost, BrowserOptions, LiveFrame, LiveInput, NeedSignIn, SignInReason, SignInMethodHint, SignInRefusedWhy } from '../browser.ts';
+import type { Member } from '../types.ts';
+import { type SignInStore } from './store.ts';
+import { type Probe } from './verify.ts';
+import { type ResumeDispatch } from './resume.ts';
+export type HostBroker = {
+    endpoint(): {
+        cdpUrl: string;
+    };
+    fence(on: boolean): Promise<void>;
+    agentTab(): string | undefined;
+    originOf(targetId: string): Promise<string>;
+    openPrivate(url: string): Promise<string>;
+    closePrivate(): Promise<void>;
+    probe(url: string, verify: (p: Probe) => Promise<boolean>, timeoutMs: number): Promise<'ok' | 'fail' | 'timeout'>;
+    attachViewer(o: {
+        lease?: {
+            epoch: number;
+            nonce: string;
+        };
+        maxWidth?: number;
+    }): {
+        frames: AsyncIterable<LiveFrame>;
+        states: AsyncIterable<{
+            origin: string;
+            secure: boolean;
+            offOrigin: boolean;
+        }>;
+        input(i: LiveInput): void;
+        close(): void;
+    };
+    bindLease(l: {
+        epoch: number;
+        nonce: string;
+        origin: string;
+        knownIdps: string[];
+    } | null): void;
+    confirmOrigin(l: {
+        epoch: number;
+        nonce: string;
+    }, origin: string): boolean;
+    privateState(): {
+        origin: string;
+        secure: boolean;
+        offOrigin: boolean;
+    } | undefined;
+    clearSite(origins: string[]): Promise<void>;
+    navigateAgent(url: string | 'reload'): Promise<void>;
+    close(): Promise<void>;
+};
+export declare class SignInRefused extends Error {
+    readonly why: SignInRefusedWhy;
+    constructor(why: SignInRefusedWhy);
+}
+export declare class HandoffUnprotected extends Error {
+    readonly why = "handoff-unprotected";
+    constructor();
+}
+export type RaiseSignIn = {
+    member: Member;
+    sessionKey: string;
+    checkUrl: string;
+    targetId?: string;
+    reasons: SignInReason[];
+    hints?: SignInMethodHint[];
+};
+export type BrowserHostServices = {
+    brokers: ReadonlyMap<Member, HostBroker>;
+    store: SignInStore;
+    options: BrowserOptions;
+    authorize(grant: string, member: Member, control: boolean): boolean;
+    park(member: Member, sessionKey: string): Promise<void>;
+    resume: ResumeDispatch;
+    siteOf(origin: string): string;
+    ping?: (member: Member, kind: 'state' | 'signin') => void;
+    now?: () => number;
+    restart?: (member: Member, attempt: number) => Promise<HostBroker | undefined>;
+};
+export declare function secureOrigin(origin: string): boolean;
+export type BrokerBinding = Readonly<{
+    broker: HostBroker;
+    generation: number;
+    endpoint: Readonly<{
+        cdpUrl: string;
+    }>;
+}>;
+export interface BrowserHostController extends BrowserHost {
+    raise(input: RaiseSignIn): Promise<NeedSignIn>;
+    revokeGrant(grant: string): Promise<void>;
+    sweep(): Promise<void>;
+    browserGone(member: Member, expected?: HostBroker): Promise<void>;
+    beforeRun(member: Member, sessionKey: string): Promise<boolean>;
+    attachBroker(member: Member, broker: HostBroker, previous?: HostBroker): Promise<void>;
+    brokerBinding(member: Member): BrokerBinding | undefined;
+    close(): Promise<void>;
+}
+export declare function createBrowserHost(services: BrowserHostServices): Promise<BrowserHostController>;
+export declare function fixtureBrowserHost(services: BrowserHostServices): Promise<BrowserHostController>;