deweygui 1.0.0

An agentic-first GUI framework with pluggable rendering backends and complete ontology for AI agent discoverability
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! Widget capabilities that advertise interaction affordances.

use serde::{Deserialize, Serialize};

/// A capability that a widget instance advertises.
///
/// Agents query capabilities to understand what interactions are possible
/// with a given widget without trial-and-error.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub enum AgentCapability {
    /// Widget can receive keyboard focus.
    Focusable,
    /// Widget responds to mouse clicks.
    Clickable,
    /// Widget can be scrolled (vertical, horizontal, or both).
    Scrollable { vertical: bool, horizontal: bool },
    /// Widget accepts text input.
    TextInput {
        multiline: bool,
        max_length: Option<usize>,
    },
    /// Widget supports item selection (single or multi).
    Selectable {
        multi_select: bool,
        item_count: usize,
    },
    /// Widget can be expanded or collapsed.
    Expandable { expanded: bool },
    /// Widget supports drag-and-drop as a source.
    Draggable,
    /// Widget acts as a drop target.
    DropTarget,
    /// Widget supports resizing by the user.
    Resizable {
        min_width: Option<f32>,
        min_height: Option<f32>,
        max_width: Option<f32>,
        max_height: Option<f32>,
    },
    /// Widget has an animation in progress.
    Animated { playing: bool },
    /// Widget supports value editing within a range.
    RangeEditable {
        min: f64,
        max: f64,
        step: Option<f64>,
    },
    /// Widget can be toggled on/off.
    Toggleable { state: bool },
    /// Widget supports sorting.
    Sortable { columns: Vec<String> },
    /// Widget supports filtering.
    Filterable,
    /// Widget supports search.
    Searchable,
    /// Widget supports copy-to-clipboard.
    Copyable,
    /// Widget provides hover tooltips.
    HasTooltip,
    /// Widget supports keyboard shortcuts.
    HasKeyBindings { bindings: Vec<(String, String)> },
    /// Widget can be minimized.
    Minimizable,
    /// Widget can be maximized.
    Maximizable,
    /// Widget can be closed.
    Closable,
    /// Widget supports pinch-to-zoom.
    Zoomable { min_zoom: f32, max_zoom: f32 },
    /// Custom capability with a name tag.
    Custom(String),
}

impl AgentCapability {
    /// Returns the canonical name of this capability for querying.
    pub fn name(&self) -> &str {
        match self {
            Self::Focusable => "focusable",
            Self::Clickable => "clickable",
            Self::Scrollable { .. } => "scrollable",
            Self::TextInput { .. } => "text-input",
            Self::Selectable { .. } => "selectable",
            Self::Expandable { .. } => "expandable",
            Self::Draggable => "draggable",
            Self::DropTarget => "drop-target",
            Self::Resizable { .. } => "resizable",
            Self::Animated { .. } => "animated",
            Self::RangeEditable { .. } => "range-editable",
            Self::Toggleable { .. } => "toggleable",
            Self::Sortable { .. } => "sortable",
            Self::Filterable => "filterable",
            Self::Searchable => "searchable",
            Self::Copyable => "copyable",
            Self::HasTooltip => "has-tooltip",
            Self::HasKeyBindings { .. } => "has-key-bindings",
            Self::Minimizable => "minimizable",
            Self::Maximizable => "maximizable",
            Self::Closable => "closable",
            Self::Zoomable { .. } => "zoomable",
            Self::Custom(name) => name.as_str(),
        }
    }
}