Repository navigation
Expand file tree
/
Copy pathprovider.ts
More file actions
94 lines (81 loc) · 3.26 KB
/
Copy pathprovider.ts
File metadata and controls
94 lines (81 loc) · 3.26 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
import type { ScrollDirection } from '@agent-device/contracts/scroll-gesture';
import type { SessionSurface } from '@agent-device/contracts/session';
import { createScopedProvider } from '@agent-device/kernel/scoped-provider';
import type { RawSnapshotNode } from '@agent-device/kernel/snapshot';
import type {
BackendDumpNetworkOptions,
BackendDumpNetworkResult,
} from '@agent-device/contracts/backend-diagnostics';
import type { AudioProbeResult } from '@agent-device/contracts/audio-probe-result';
import { createAgentBrowserWebProvider } from './agent-browser-provider.ts';
export type WebOpenOptions = {
url?: string;
};
export type WebScreenshotOptions = {
fullscreen?: boolean;
stabilize?: boolean;
surface?: SessionSurface;
};
export type WebSnapshotOptions = {
interactiveOnly?: boolean;
depth?: number;
scope?: string;
raw?: boolean;
includeRects?: boolean;
surface?: SessionSurface;
signal?: AbortSignal;
};
export type WebSnapshotResult = {
nodes: RawSnapshotNode[];
truncated?: boolean;
};
export type WebAudioProbeAction = 'start' | 'status' | 'stop';
export type WebAudioProbeOptions = {
action: WebAudioProbeAction;
durationMs?: number;
bucketMs?: number;
};
export type WebAudioProbeResult = AudioProbeResult & {
source: 'media-elements';
mediaElementCount: number;
};
export type WebProvider = {
open(target: string, options?: WebOpenOptions): Promise<void>;
close(target?: string): Promise<void>;
startRecording?(outPath: string): Promise<void>;
stopRecording?(): Promise<void>;
snapshot(options?: WebSnapshotOptions): Promise<WebSnapshotResult>;
screenshot(outPath: string, options?: WebScreenshotOptions): Promise<void>;
setViewport(width: number, height: number): Promise<void>;
click(x: number, y: number): Promise<void>;
clickRef?(ref: string): Promise<void>;
/** Move the pointer to a point without pressing, raising the page's hover state. */
hover?(x: number, y: number): Promise<void>;
/** Hover a snapshot ref through the provider's own element handle. */
hoverRef?(ref: string): Promise<void>;
fill(x: number, y: number, text: string, options?: { delayMs?: number }): Promise<void>;
fillRef?(ref: string, text: string, options?: { delayMs?: number }): Promise<void>;
typeText(text: string, options?: { delayMs?: number }): Promise<void>;
scroll(
direction: ScrollDirection,
options?: { amount?: number; pixels?: number; durationMs?: number },
): Promise<Record<string, unknown> | void>;
readText?(x: number, y: number): Promise<string>;
dumpNetwork?(options?: BackendDumpNetworkOptions): Promise<BackendDumpNetworkResult>;
probeAudio?(options: WebAudioProbeOptions): Promise<WebAudioProbeResult>;
};
const localWebProvider: WebProvider = createAgentBrowserWebProvider();
const webProviderScope = createScopedProvider(localWebProvider);
export function resolveWebProvider(provider?: WebProvider): WebProvider {
return webProviderScope.resolve(provider);
}
/** True only for an explicitly request-scoped provider, never the local fallback. */
export function hasScopedWebProvider(): boolean {
return webProviderScope.hasScope();
}
export async function withWebProvider<T>(
provider: WebProvider | undefined,
fn: () => Promise<T>,
): Promise<T> {
return await webProviderScope.run(provider, fn);
}