Module computer_use 

Available on crate feature computer-use only.

Graph, auth, and v8 wire contracts for safe computer-use orchestration.

Available with feature: computer-use (included in standard).

Modules

contracts

camelCase wire contracts for computer-use-mcp.

runtime

Runtime adapters and response binding. The ComputerUseRuntime boundary and its concrete adapters.

Structs

ActionEnvelope

Immutable action proposed by the graph and enforced by the runtime.

ActionPreview

Result of preview_action used for deterministic graph routing.

ActionProvenance

Provenance describing whether an action derives from untrusted instructions.

ActionResourceContext

Optional resource identifiers describing what an action touches.

AdkEvaluationClaims

Claims asserted by an AdkEvaluationReceipt and re-checked on verify.

AdkEvaluationReceipt

Tamper-evident release-evaluation receipt for a computer-use subject.

AdkEvaluationSource

A source file digest included in an AdkEvaluationReceipt.

ApprovalGrant

Read-only, disclosure-safe authority returned by the runtime approval boundary.

Bounds

Axis-aligned bounding box in display coordinates.

CancellationBridge

Propagates controls in the safe order: revoke desktop authority, then stop reasoning.

ComputerUseAuthContext

Authenticated identity and exact operation context forwarded to the runtime.

ComputerUseEvaluation

Outcome of scoring one session’s event trajectory.

ComputerUseEvaluator

Deterministic release evaluator layered beside ADK’s task-quality evaluators.

ComputerUseMcpConfig

Static configuration binding a ComputerUseMcpRuntime to one authenticated session.

ComputerUseMcpRuntime

ComputerUseRuntime implementation backed by a live computer-use-mcp server.

ControlLease

One-writer desktop control lease.

ExecutionCapability

A verified execution capability advertised by the runtime.

ExecutionReceipt

Idempotency receipt returned by execute_action.

LeaseBoundaries

App/window/display boundaries restricting a ControlLease.

PolicyDecision

A policy decision for a previewed action.

PostconditionEvidence

A single postcondition and whether it was satisfied.

RuntimeSession

A runtime session and its current lifecycle state.

SafetyCorpus

Versioned cross-runtime deterministic safety corpus.

SafetyExpectation

Expected effects, restores, and status for a SafetyScenario.

SafetyScenario

A single deterministic safety scenario and its expected outcome.

ScopeAuthorizer

Coarse ADK scope gate. The runtime policy engine still evaluates the exact action.

SessionCompletionEvidence

Evidence describing how a session reached completion.

SessionDeletionResult

Principal-bound result of deleting one terminal runtime session’s durable data.

SessionEvent

Stable supervisor event used for ADK/runtime trace correlation.

SessionFollowUp

Principal-owned, monotonic steering instruction consumed by an ADK graph.

SessionFollowUpPage

A page of follow-ups plus the cursor for the next page.

TargetEvidence

Evidence binding an action to a fresh desktop observation.

TargetReservation

Non-authoritative, expiring planner intent for multi-agent conflict checks.

TargetReservationScope

Application/window scope of a TargetReservation.

TargetSensitivityEvidence

Value-free native accessibility evidence used for action risk and revalidation.

TraceCorrelation

ADK ↔ runtime trace correlation identifiers attached to every MCP span.

Enums

ActionClass

Operation-aware action class used by authorization and policy.

ActionPostcondition

Digest-only expected state independently verified by computer-use-mcp.

ApprovalGrantScope

Scope of an ApprovalGrant.

AuthorizationError

Reason a ScopeAuthorizer rejected a ComputerUseAuthContext.

CancellationError

Failure propagating a cancellation control to the desktop runtime.

ComputerUseError

Structured error surfaced by the computer-use graph, runtime trait, and MCP adapter.

ExecutionMode

Enforced execution mode selected for an action.

ReceiptStatus

Terminal status of an execution receipt.

TargetSensitivityAssessment

Conclusion of an accessibility-based target sensitivity check.

TargetSensitivitySignal

A single value-free signal contributing to a sensitivity assessment.

TargetSensitivitySource

Source of a TargetSensitivityEvidence assessment.

VerificationOutcome

What is actually known about an action’s effect after execution.

Traits

AgentInterrupter

Minimal boundary implemented by adk_runner::Runner::interrupt or another host.

ComputerUseRuntime

Runtime boundary implemented by the computer-use MCP server or an in-process adapter.

Functions

build_reference_graph

Build the flagship deterministic ADK graph.

build_reference_graph_with_checkpointer

Build the reference graph with a durable host-supplied checkpointer.

Type Aliases

Result

Convenience alias for fallible computer-use operations.