common_browser.schemas.results
One safe operation report for browser work, with explicit partial evidence.
Classes
BrowserCoverage
Observed scope, not a claim of complete site or catalog coverage.
__init__
def __init__(matched: int = 0, attempted: int = 0, returned: int = 0, limit: int | None = None, truncated: bool = False, interrupted: bool = False, unavailable_frames: tuple[str, ...] = ()) -> NoneFields and properties declared here; inherited members belong to the bases above.
attempted
attempted: int = 0interrupted
interrupted: bool = Falselimit
limit: int | None = Nonematched
matched: int = 0returned
returned: int = 0truncated
truncated: bool = Falseunavailable_frames
unavailable_frames: tuple[str, ...] = ()BrowserError
Bases: RuntimeError
Safe failure whose report retains explicitly accessible evidence.
__init__
def __init__(reason: str, *, status: BrowserStatus = 'error', result: BrowserResult[Any] | None = None) -> NoneFields and properties declared here; inherited members belong to the bases above.
reason
reason = reasonresult
result = resultstatus
status = statusBrowserInfo
Declared mode capabilities and the runtime’s current lifecycle state.
__init__
def __init__(engine: str, mode: str, state: str, capabilities: frozenset[str], sdk_version: str | None = None) -> NoneFields and properties declared here; inherited members belong to the bases above.
capabilities
capabilities: frozenset[str]engine
engine: strmode
mode: strsdk_version
sdk_version: str | None = Nonestate
state: strsupports
def supports(capability: str) -> boolBrowserIssue
A stable error code and location, never copied input or exception text.
__init__
def __init__(code: str, row_index: int | None = None, field_path: tuple[str | int, ...] = ()) -> NoneFields and properties declared here; inherited members belong to the bases above.
code
code: strfield_path
field_path: tuple[str | int, ...] = ()row_index
row_index: int | None = NoneBrowserResult
Browser outcome; SDK completion never asserts application mutation success.
unwrap admits only complete success. Partial values, captured events and
original errors remain explicitly inspectable and absent from repr.
__init__
def __init__(op: str, status: BrowserStatus, value: T | None = None, phase: OperationPhase = 'not_started', reason: str | None = None, issues: tuple[BrowserIssue, ...] = (), coverage: BrowserCoverage | None = None, evidence: object | None = None, operation_id: str = '', observed_at: datetime = (lambda: datetime.now(UTC))(), duration_sec: float = 0.0, error: BaseException | None = None) -> NoneFields and properties declared here; inherited members belong to the bases above.
coverage
coverage: BrowserCoverage | None = Noneduration_sec
duration_sec: float = 0.0error
error: BaseException | None = field(default=None, repr=False, compare=False)evidence
evidence: object | None = field(default=None, repr=False, compare=False)issues
issues: tuple[BrowserIssue, ...] = ()observed_at
observed_at: datetime = field(default_factory=(lambda: datetime.now(UTC)))ok
Read-only property.
ok: boolop
op: stroperation_id
operation_id: str = ''phase
phase: OperationPhase = 'not_started'reason
reason: str | None = Nonestatus
status: BrowserStatusvalue
value: T | None = field(default=None, repr=False)unwrap
def unwrap() -> TReturn a complete value or raise a safe error retaining this result.