Distributed worker daemon: polls a server for browser-automation tasks, executes them via a real browser, submits results, sends heartbeats
| Tier | operations |
| Role | unclassified (baselined) |
| Path | crates/operations/browser-agent-worker |
| Edition | 2021 |
| Targets | operations-browser-agent-worker |
| Public items | 0 across 0 modules |
| Tests | 26 |
What it is for
Browser Agent Worker - distributed browser automation daemon.
Polls a central server (WebSocket primary, HTTP polling fallback) for browser-automation tasks, executes them via a real browser, submits results back, and sends heartbeats. Generic task-polling/browser- automation infrastructure -- no vertical-specific branding or logic (AC-generic check, sprint 3.46 crate 22).
Capabilities
No public items.
How to use it
No examples/ target and no doctest in this crate's rustdoc. The tests listed under Verification are the closest executable usage.
Module structure
No public modules: the crate root is its whole surface.
Public surface
No public items.
No pub use re-exports: every item above is declared in this crate.
Boundary
Reaches into infrastructure.
Shares tier operations with 40 other crates: operations-approval-workflow, operations-assessments, operations-block-imaging, operations-boot-media, operations-camera-discovery, operations-camera-liveview, operations-camera-registry, operations-compliance, … (40 total).
_What this crate deliberately does NOT own is a judgment. No committed registry records one for it, so none is stated here._
Where it sits
| Tier (ontology) | operations |
| Architectural role (taxonomy) | unclassified (baselined) |
| Location | crates/operations/browser-agent-worker |
| Vocabulary in force (lexicon) | current |
Tier flow. Which tiers this crate's own edges cross.
flowchart LR n_operations["operations"] --> n_infrastructure["infrastructure"]
Dependencies
Runtime, in this workspace.
| Crate | Tier | Optional | Only on |
|---|---|---|---|
| `infrastructure-browser-automation` | infrastructure | no | always |
Runtime, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
anyhow | ^1 | — | no | always |
base64 | ^0.22 | — | no | always |
chromiumoxide | ^0.7 | tokio-runtime | no | always |
chrono | ^0.4 | serde | no | always |
clap | ^4 | derive, env | no | always |
directories | ^5.0 | — | no | always |
flate2 | ^1 | — | no | always |
futures | ^0.3 | — | no | always |
rand | ^0.9 | small_rng | no | always |
reqwest | ^0.12 | json, gzip, stream | no | always |
serde | ^1 | derive | no | always |
serde_json | ^1 | — | no | always |
thiserror | ^2 | — | no | always |
tokio | ^1 | full | no | always |
tokio-tungstenite | ^0.26 | native-tls | no | always |
toml | ^0.8 | — | no | always |
tracing | ^0.1 | — | no | always |
tracing-subscriber | ^0.3 | env-filter | no | always |
uuid | ^1 | v4, v7, serde, js | no | always |
Development, from outside the workspace.
| Crate | Requirement | Features | Optional | Only on |
|---|---|---|---|---|
tokio | ^1 | full, macros, rt-multi-thread | no | always |
Build. None.
Depended on by. Nothing in this workspace.
Signal flow — what reaches this crate, and what it reaches.
flowchart LR SELF["operations-browser-agent-worker"] SELF -->|runtime| n_infrastructure_browser_automation["infrastructure-browser-automation"] classDef self fill:#1f883d,stroke:#1f883d,color:#fff; class SELF self;
Feature flags
No Cargo features are defined: every capability is unconditional, so no consumer can receive a half-wired crate.
Targets
| Kind | Name | Source |
|---|---|---|
| bin | operations-browser-agent-worker | `src/main.rs` |
Error model
No public error type was detected: no public item declares a type named *Error, and no public signature returns one.
Operational characteristics
| Property | Evidence |
|---|---|
| async public surface | none detected |
| async runtime | yes |
| database access | none detected |
| network I/O | yes |
| unsafe code | none detected |
| environment variables | none detected |
No unsafe block, unsafe fn, unsafe impl or unsafe trait was found by the parser anywhere in this crate's source.
Configuration
No environment variable is read with a literal name anywhere in this crate. A variable whose key is computed at run time cannot be listed here, and is not claimed to be absent.
Related capabilities
No workspace crate depends on this one.
Verification
| Kind | Count |
|---|---|
| Unit tests | 26 |
| Integration tests | 0 |
| Examples | 0 |
| Doctests | 0 |
What the tests establish, by name:
compress_html_round_trips—src/api_client.rsredact_api_key_hides_key_in_url—src/api_client.rsredact_api_key_leaves_rest_of_url_intact—src/api_client.rsredact_api_key_noop_on_empty_key—src/api_client.rsserver_message_task_assigned_deserializes—src/api_client.rstask_result_serializes_expected_fields—src/api_client.rsapi_key_preview_truncates_and_never_panics_on_short_keys—src/config.rsdefaults_match_source_values—src/config.rshumanization_to_profile_overrides_only_delay_range—src/config.rsschedule_config_to_window_carries_hours—src/config.rstemplate_round_trips_through_toml—src/config.rstemplate_toml_uses_humanization_and_schedule_sections—src/config.rsequal_start_and_end_means_always_active—src/schedule.rsfull_day_window_always_active—src/schedule.rsjitter_deterministic_with_seeded_rng—src/schedule.rsjitter_stays_within_factor_range—src/schedule.rsjitter_varies_across_calls—src/schedule.rsnormal_window_before_start_is_outside—src/schedule.rsnormal_window_end_hour_is_exclusive—src/schedule.rsnormal_window_within_bounds—src/schedule.rswrap_around_end_hour_is_exclusive—src/schedule.rswrap_around_start_hour_is_inclusive—src/schedule.rswrap_around_window_excludes_daytime—src/schedule.rswrap_around_window_overnight—src/schedule.rsto_task_error_carries_message_and_retry_flag—src/tasks.rsto_task_result_merges_title_and_final_url_into_metadata—src/tasks.rs
Documentation coverage
| Measure | Documented | Total |
|---|---|---|
| Public items with rustdoc | 0 | 0 |
Public modules with a //! block | 0 | 0 |
Metrics
| Metric | Value |
|---|---|
| Rust source files | 6 |
| Source lines | 2554 |
| Code lines | 1867 |
| Public API items | 0 |
| Public modules | 0 |
| Tests | 26 |
| Examples | 0 |
| Cargo features | 0 |
| Direct runtime dependencies | 20 |
| Workspace reverse dependencies | 0 |
pie showData
title Rust source composition
"Code" : 1867
"Blank or comment" : 687
Generation
Rendered by tools-corpus corpus readme from repository evidence alone, renderer schema 2, lexicon current. No model, network service or database was consulted. Regenerate with tools-corpus corpus readme --write; verify with --check.