adk-ui 0.8.0

Dynamic UI generation for ADK-Rust agents - render forms, cards, tables, charts and more
Documentation 
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use crate::compat::{Result, Tool, ToolContext};
use crate::schema::*;
use crate::tools::{LegacyProtocolOptions, render_ui_response_with_protocol};
use async_trait::async_trait;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use serde_json::Value;
use std::sync::Arc;

/// Parameters for the render_confirm tool
#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
pub struct RenderConfirmParams {
    /// Confirmation title
    pub title: String,
    /// Message explaining what the user is confirming
    pub message: String,
    /// Action ID triggered when user confirms
    pub confirm_action: String,
    /// Optional cancel action ID (defaults to dismissing)
    #[serde(default)]
    pub cancel_action: Option<String>,
    /// Confirm button label
    #[serde(default = "default_confirm_label")]
    pub confirm_label: String,
    /// Cancel button label
    #[serde(default = "default_cancel_label")]
    pub cancel_label: String,
    /// Whether this is a destructive action (shows danger button)
    #[serde(default)]
    pub destructive: bool,
    /// Optional protocol output configuration.
    #[serde(flatten)]
    pub protocol: LegacyProtocolOptions,
}

fn default_confirm_label() -> String {
    "Confirm".to_string()
}

fn default_cancel_label() -> String {
    "Cancel".to_string()
}

/// Tool for rendering confirmation dialogs
pub struct RenderConfirmTool;

impl RenderConfirmTool {
    pub fn new() -> Self {
        Self
    }
}

impl Default for RenderConfirmTool {
    fn default() -> Self {
        Self::new()
    }
}

#[async_trait]
impl Tool for RenderConfirmTool {
    fn name(&self) -> &str {
        "render_confirm"
    }

    fn description(&self) -> &str {
        "Render a confirmation dialog to get user approval before proceeding. Use this for destructive actions, important decisions, or when you need explicit user consent."
    }

    fn parameters_schema(&self) -> Option<Value> {
        Some(super::generate_gemini_schema::<RenderConfirmParams>())
    }

    async fn execute(&self, _ctx: Arc<dyn ToolContext>, args: Value) -> Result<Value> {
        let params: RenderConfirmParams = serde_json::from_value(args)
            .map_err(|e| crate::compat::AdkError::tool(format!("Invalid parameters: {}", e)))?;
        let protocol_options = params.protocol.clone();

        let confirm_variant = if params.destructive {
            ButtonVariant::Danger
        } else {
            ButtonVariant::Primary
        };

        let footer = vec![
            Component::Button(Button {
                id: None,
                label: params.cancel_label,
                action_id: params.cancel_action.unwrap_or_else(|| "cancel".to_string()),
                variant: ButtonVariant::Ghost,
                disabled: false,
                icon: None,
            }),
            Component::Button(Button {
                id: None,
                label: params.confirm_label,
                action_id: params.confirm_action,
                variant: confirm_variant,
                disabled: false,
                icon: None,
            }),
        ];

        let ui = UiResponse::new(vec![Component::Card(Card {
            id: None,
            title: Some(params.title),
            description: None,
            content: vec![Component::Text(Text {
                id: None,
                content: params.message,
                variant: TextVariant::Body,
            })],
            footer: Some(footer),
        })]);

        render_ui_response_with_protocol(ui, &protocol_options, "confirm")
    }
}