intervention

package

v0.3.0 Latest Latest Go to latest Published: Sep 23, 2026 License: MIT Imports: 8 Imported by: 0

Details

Package intervention detects recent physical user input.

This section is empty.

This section is empty.

This section is empty.

type Config struct {
	Enabled     bool
	QuietPeriod time.Duration
}

Config controls the user-intervention monitor.

type Monitor struct {
	// contains filtered or unexported fields
}

Monitor records that physical input happened recently.

func New(cfg Config) *Monitor

New returns a monitor. It does not install an event tap until Start is called.

func (m *Monitor) Blocked(now time.Time) (Status, bool)

Blocked reports whether actions should pause for recent physical input.

func (m *Monitor) Close()

Close releases the event tap resources.

func (m *Monitor) Record(kind string, now time.Time)

Record records a physical input event. It is exported for tests.

func (m *Monitor) Start() error

Start installs a listen-only event tap when the monitor is enabled. Calling Start on an already started monitor has no effect.

func (m *Monitor) Status() Status

Status returns the current monitor state.

type Status struct {
	Enabled     bool
	QuietPeriod time.Duration
	LastInput   time.Time
	LastType    string
}

Status reports the monitor state without exposing input payloads.