Files
orca/src/shared/runtime-browser-contracts.ts
T

257 lines
8.3 KiB
TypeScript

import type {
BrowserCertificateFailure,
BrowserCookieImportResult,
BrowserLoadError,
BrowserSessionProfile,
BrowserSessionProfileSource
} from './browser-workspace-types'
import type { BROWSER_UNAVAILABLE_ERROR_CODE } from './runtime-session-contracts'
export type BrowserSnapshotRef = { ref: string; role: string; name: string }
// agent-browser's `snapshot --delta` answer; `full` carries the tree, the others change the last one.
export type BrowserSnapshotDelta =
| { kind: 'full'; revision: number; tree: string }
| { kind: 'unchanged'; revision: number; baseRevision: number }
| {
kind: 'delta'
revision: number
baseRevision: number
treeChange?: { startLine: number; deleteCount: number; lines: string[] }
}
export type BrowserSnapshotResult = {
browserPageId: string
snapshot: string | BrowserSnapshotDelta
refs: BrowserSnapshotRef[]
url: string
title: string
}
/** What an agent's page action caused; absent for people's input and from runtimes that predate it. */
export type BrowserActionEffects = {
/** Set only when the action changed them. */
url?: string
title?: string
/** A navigation was still loading at the settle cap, so no page changes are listed. */
loading?: boolean
loadError?: string
/** No browserPageId: the tab was requested but had not opened by the settle cap. */
newTabs?: { browserPageId?: string; url: string }[]
popups?: { action: 'blocked' | 'opened-external' | 'window'; origin: string }[]
downloads?: { filename: string; origin: string }[]
consoleErrors?: string[]
/** Snapshot lines changed since the last reading; `full` is the whole new tree. Absent when unread. */
page?: 'unchanged' | { lines: string[]; removedLines: number; full: boolean; truncated: boolean }
/** False when the page was still changing at the settle cap. */
settled: boolean
}
export type BrowserClickResult = { clicked: string }
export type BrowserGotoResult = { url: string; title: string }
export type BrowserFillResult = { filled: string }
export type BrowserTypeResult = { typed: boolean }
export type BrowserSelectResult = { selected: string }
export type BrowserScrollResult = { scrolled: 'up' | 'down' }
export type BrowserBackResult = { url: string; title: string }
export type BrowserReloadResult = { url: string; title: string }
export type BrowserScreenshotAnnotation = {
ref: string
number: number
role: string
name?: string
box: { x: number; y: number; width: number; height: number }
}
export type BrowserScreenshotResult = {
data: string
format: 'png' | 'jpeg'
// Set only for --if-changed; false means nothing was captured and data is empty.
changed?: boolean
annotations?: BrowserScreenshotAnnotation[]
}
export type BrowserScreencastReadyResult = {
type: 'ready'
subscriptionId: string
browserPageId: string
format: 'jpeg' | 'png'
tab: BrowserTabInfo
// Echo of `frameAck: 1`: the host holds frames until the viewer acks them.
frameAck?: true
}
export type BrowserScreencastEndResult = { type: 'end'; subscriptionId: string }
export type BrowserScreencastDialogResult = { type: 'dialog'; dialogType: string; message: string }
export type BrowserScreencastDialogClosedResult = { type: 'dialogClosed' }
export type BrowserScreencastErrorResult = { type: 'error'; message: string }
export type BrowserScreencastResult =
| BrowserScreencastReadyResult
| BrowserScreencastEndResult
| BrowserScreencastDialogResult
| BrowserScreencastDialogClosedResult
| BrowserScreencastErrorResult
export type BrowserEvalResult = { result: string; origin: string }
export type BrowserTabInfo = {
browserPageId: string
index: number
url: string
title: string
active: boolean
loadError?: BrowserLoadError | null
certificateFailure?: BrowserCertificateFailure | null
worktreeId?: string | null
profileId?: string | null
profileLabel?: string | null
/** Set on a popup window (OAuth, payment): the tab whose page opened it. */
openerBrowserPageId?: string
/** False for a restored tab whose page has not loaded; a command aimed at it loads it. */
loaded?: boolean
}
export type BrowserTabListResult = { tabs: BrowserTabInfo[] }
export type BrowserTabSwitchResult = { switched: number; browserPageId: string }
export type BrowserTabSetProfileResult = {
browserPageId: string
profileId: string | null
profileLabel: string | null
}
export type BrowserTabShowResult = { tab: BrowserTabInfo }
export type BrowserTabCurrentResult = { tab: BrowserTabInfo }
export type BrowserTabProfileShowResult = {
browserPageId: string
worktreeId: string | null
profileId: string | null
profileLabel: string | null
}
export type BrowserTabProfileCloneResult = {
browserPageId: string
sourceBrowserPageId: string
profileId: string | null
profileLabel: string | null
}
export type BrowserProfileListResult = {
profiles: BrowserSessionProfile[]
executorRuntimeId?: string
}
export type BrowserProfileCreateResult = { profile: BrowserSessionProfile | null }
export type BrowserProfileDeleteResult = { deleted: boolean; profileId: string }
export type BrowserDetectedProfileInfo = { name: string; directory: string }
export type BrowserDetectedInfo = {
family: BrowserSessionProfileSource['browserFamily']
label: string
profiles: BrowserDetectedProfileInfo[]
selectedProfile: string
}
export type BrowserDetectProfilesResult = { browsers: BrowserDetectedInfo[] }
export type BrowserProfileImportFromBrowserResult = BrowserCookieImportResult & {
executorRuntimeId?: string
}
export type BrowserProfileClearDefaultCookiesResult = { cleared: boolean }
export type BrowserHoverResult = { hovered: string }
export type BrowserDragResult = { dragged: { from: string; to: string } }
// Older hosts and server-hosted pages report only the count.
export type BrowserUploadResult = { uploaded: number; frameUrl?: string }
export type BrowserWaitResult = { waited: boolean }
export type BrowserCheckResult = { checked: boolean }
export type BrowserFocusResult = { focused: string }
export type BrowserClearResult = { cleared: string }
export type BrowserSelectAllResult = { selected: string }
export type BrowserKeypressResult = { pressed: string }
export type BrowserPdfResult = { data: string }
export type BrowserCookie = {
name: string
value: string
domain: string
path: string
expires: number
httpOnly: boolean
secure: boolean
sameSite: string
}
export type BrowserCookieGetResult = { cookies: BrowserCookie[] }
export type BrowserCookieSetResult = { success: boolean }
export type BrowserCookieDeleteResult = { deleted: boolean }
export type BrowserViewportResult = {
width: number
height: number
deviceScaleFactor: number
mobile: boolean
}
export type BrowserGeolocationResult = {
latitude: number
longitude: number
accuracy: number
}
export type BrowserInterceptedRequest = {
id: string
url: string
method: string
headers: Record<string, string>
resourceType: string
}
export type BrowserInterceptEnableResult = { enabled: boolean; patterns: string[] }
export type BrowserInterceptDisableResult = { disabled: boolean }
export type BrowserConsoleEntry = {
level: string
text: string
timestamp?: number
url?: string
line?: number
}
export type BrowserConsoleResult = { entries: BrowserConsoleEntry[]; truncated: boolean }
export type BrowserNetworkEntry = {
url: string
method: string
// Absent while a request is pending or after it failed.
status?: number
mimeType?: string
size?: number
timestamp?: number
}
export type BrowserNetworkLogResult = { entries: BrowserNetworkEntry[]; truncated: boolean }
export type BrowserCaptureStartResult = { capturing: boolean }
export type BrowserCaptureStopResult = { stopped: boolean }
export type BrowserTabCreateResult = { browserPageId: string }
export type BrowserErrorCode =
| typeof BROWSER_UNAVAILABLE_ERROR_CODE
| 'browser_command_unavailable'
| 'browser_profile_unavailable'
| 'browser_screencast_unavailable'
| 'browser_certificate_trust_unavailable'
| 'browser_no_tab'
| 'browser_tab_not_found'
| 'browser_tab_closed'
| 'browser_tab_changed'
| 'browser_owner_unavailable'
| 'browser_stale_ref'
| 'browser_ref_not_found'
| 'browser_navigation_failed'
| 'browser_element_not_interactable'
| 'browser_eval_error'
| 'browser_cdp_error'
| 'browser_debugger_detached'
| 'browser_timeout'
| 'browser_error'