Enum CaptureTier 

pub(crate) enum CaptureTier {
    SameInstance,
    OtherInstance,
    OtherUser,
    ForeignApp,
}

Capture tier for one target window — see docs/specs/SPEC_AGENT_UNRESTRICTED_CAPTURE_WITH_ACCOUNTABILITY_2026_08_30.md §3. Keyed on WHAT is being captured, never on who is asking: identity is already proven upstream (sign_ui_automation_auth), so the open question is what a proven identity may reach.

This replaces the previous binary !is_self exclusion. That rule came from SPEC_AGENT_UI_AUTOMATION_CLICK_SCREENSHOT_2026_08_18.md §6, which itself says cross-agent targeting “if it’s ever wanted at all” should be a distinct capability — i.e. it defaulted closed because no mechanism existed to be selective, not because open had been judged wrong. The repo owner has since directed that agents be able to capture anything. This enum is that mechanism.

Variants

SameInstance

T1 — another pane inside the caller’s OWN instance. Its window hosts every agent’s pane, which is exactly what the old rule blocked.

OtherInstance

T2 — a different AgentMux instance owned by the same OS user.

OtherUser

T3 — a window owned by a DIFFERENT OS user. The one tier that crosses a human rather than an agent boundary: that user never consented to this app’s agents, and no in-app notification can reach them.

ForeignApp

T4 — a non-AgentMux window owned by the same OS user (their browser, their password manager). PR #2709 round 2 caught the original unscoped tool capturing a KeePass window; allowed now, but always audited.

Implementations

impl CaptureTier

pub(crate) fn allowed(self) -> bool

Phase 1 allow defaults (spec §3). Only T3 is closed, and only because it is a human-to-human boundary — every agent-to-agent tier is open.

pub(crate) fn label(self) -> &'static str

Trait Implementations

impl Clone for CaptureTier

fn clone(&self) -> CaptureTier

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CaptureTier

impl Debug for CaptureTier

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for CaptureTier

impl PartialEq for CaptureTier

fn eq(&self, other: &CaptureTier) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for CaptureTier