uzor 1.2.2

Core UI engine — geometry, interaction, input state
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Agent control surface for `LayoutManager`.
//!
//! Exposes a platform-agnostic API that lets external agents (LLMs,
//! QA tooling, scripts, IDE plugins) read live LM state and drive
//! every UI operation LM understands.
//!
//! Two operating modes for write-side calls:
//!
//! - **Semantic / direct LM ops** (default).  Address things by their
//!   logical id: `ClickWidget { widget_id }`, `OpenModal { id }`,
//!   `ToggleSidebar`, `ApplyStylePreset`, `SetSyncMode`.  No pixel
//!   coordinates required, deterministic, robust against re-layout.
//!
//! - **Pixel + screenshot** (escape hatch).  `InjectClick { x, y }`,
//!   `InjectHover`, plus `Screenshot` from the WM trait.  Used for
//!   custom blackbox bodies (charts, sketch areas) where the widget
//!   tree cannot describe a clickable region.
//!
//! ## Layering
//!
//! - The [`AgentControl`] trait is defined here in uzor core so any
//!   platform window manager can implement it.
//! - [`LmAgent<P>`] is a default implementation that handles every
//!   call routable purely through `LayoutManager` — read snapshot,
//!   click_widget, modal/sidebar/dropdown ops, sync-registry edits,
//!   style presets.
//! - Window managers extend it with platform-specific operations
//!   (screenshot, spawn/close OS window, real synthetic input).
//!   They typically wrap an `LmAgent` and forward the calls it can
//!   answer, then add their own.

//! Agent control surface for `LayoutManager`.
//!
//! See `uzor-agent-api/README.md` for the full route catalogue,
//! snapshot / log shapes, blackbox recipe, and threading notes.
//!
//! Quick start: enable a server with
//! `AppBuilder::new(...).agent_api(17480).run()` then `curl
//! http://127.0.0.1:17480/state/tree`.
//!
//! Anyone holding `&mut LayoutManager` may push merged-log
//! breadcrumbs via [`crate::layout::LayoutManager::agent_log_push`].
//! Blackbox panels implement [`BlackboxAgentSurface`] and register
//! themselves via
//! [`crate::layout::LayoutManager::register_blackbox_agent`].

mod blackbox;
mod command;
mod control;
mod lm_agent;
mod log;
mod snapshot;

pub use blackbox::{AgentAction, AgentActionReply, AgentWidget, BlackboxAgentSurface};
pub use command::{Command, CommandReply, MouseButton};
pub use control::{AgentControl, AgentControlObj};
pub use lm_agent::LmAgent;
pub use log::{AgentLog, AgentLogEntry, DEFAULT_LOG_CAPACITY};
pub use snapshot::{
    AgentSnapshot, BranchSnapshot, ClickSnap, DockNodeSnap, NodeSyncSnapshot, RectSnap,
    RootSnapshot, WidgetSnapshot,
};