diff --git a/.gitignore b/.gitignore
index 057ded59f..0f769de39 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,8 +15,8 @@
.svn/
.swiftpm/
migrate_working_dir/
-**/firepit-log.txt
-**/pglite-debug.log
+firepit-log.txt
+pglite-debug.log
# Diagrams, produced by https://pub.dev/packages/layerlens.
DEPS.md
@@ -30,20 +30,20 @@ DEPS.md
# Flutter/Dart/Pub related
**/doc/api/
**/ios/Flutter/.last_build_id
-**/.dart_tool/
-**/.flutter-plugins-dependencies
-**/.pub-cache/
-**/.pub/
-**/build/
-**/coverage/
-**/pubspec.lock
-**/generated_plugins.cmake
-**/GeneratedPluginRegistrant.*
-**/generated_plugin_registrant.*
-**/Podfile
-**/Podfile.lock
-**/Runner-Bridging-Header.h
-**/contents.xcworkspacedata
+.dart_tool/
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+build/
+coverage/
+pubspec.lock
+generated_plugins.cmake
+GeneratedPluginRegistrant.*
+generated_plugin_registrant.*
+Podfile
+Podfile.lock
+Runner-Bridging-Header.h
+contents.xcworkspacedata
# Symbolication related
app.*.symbols
@@ -57,13 +57,28 @@ app.*.map.json
**/android/app/release
# Firebase
-**/google-services.json
+google-services.json
**/lib/firebase_options.dart
-**/firebase.json
-**/GoogleService-Info.plist
-**/.firebase
-**/.firebaserc
+firebase.json
+GoogleService-Info.plist
+.firebase
+.firebaserc
# This package's specific logs.
-**/*.log.*
-**/*.log
+*.log.*
+*.log
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.venv
+venv/
+ENV/
+.env
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+.coverage
+htmlcov/
diff --git a/examples/verdure/README.md b/examples/verdure/README.md
new file mode 100644
index 000000000..3afe46870
--- /dev/null
+++ b/examples/verdure/README.md
@@ -0,0 +1,62 @@
+# Verdure Landscape Design Example
+
+This directory contains a sample application demonstrating a Flutter client interacting with a Python-based A2A (Agent-to-Agent) server for landscape design.
+
+## Prerequisites
+
+- Flutter SDK
+- Python 3.13 or higher
+- [UV](https://docs.astral.sh/uv/)
+- A Gemini API Key
+ - You can create one using [AI Studio](https://ai.google.dev/aistudio).
+
+## Running the Example
+
+To run this example, you need to start both the server and the client application.
+
+### 1. Start the Server
+
+a. Navigate to the server directory:
+
+ ```bash
+ cd server
+ ```
+
+b. Create a `.env` file with your Gemini API key:
+
+ ```bash
+ echo "GEMINI_API_KEY=YOUR_API_KEY_HERE" > .env
+ ```
+ *Replace `YOUR_API_KEY_HERE` with your actual Gemini API key.*
+
+c. Install dependencies and run the server using UV:
+
+ ```bash
+ uv run verdure
+ ```
+
+The server will start on `http://localhost:10002` by default.
+
+### 2. Run the Client
+
+a. Open a new terminal window.
+
+b. Navigate to the client directory:
+
+ ```bash
+ cd client
+ ```
+
+c. Run the Flutter application on your desired device:
+
+ ```bash
+ flutter run
+ ```
+
+The Flutter application will connect to the server running on `localhost:10002` to interact with the landscape design agent.
+
+## Disclaimer
+
+Important: The sample code provided is for demonstration purposes and illustrates the mechanics of the Agent-to-Agent (A2A) protocol. When building production applications, it is critical to treat any agent operating outside of your direct control as a potentially untrusted entity.
+
+All data received from an external agent—including but not limited to its AgentCard, messages, artifacts, and task statuses—should be handled as untrusted input. Failure to properly validate and sanitize this data before use can introduce security vulnerabilities into your application.
diff --git a/examples/verdure/client/.metadata b/examples/verdure/client/.metadata
new file mode 100644
index 000000000..50b8eba35
--- /dev/null
+++ b/examples/verdure/client/.metadata
@@ -0,0 +1,42 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+ revision: "bff5cb4a90f1bc1e24fff1eef39ee2596917c07b"
+ channel: "main"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+ platforms:
+ - platform: root
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ - platform: android
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ - platform: ios
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ - platform: linux
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ - platform: macos
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ - platform: web
+ create_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+ base_revision: bff5cb4a90f1bc1e24fff1eef39ee2596917c07b
+
+ # User provided section
+
+ # List of Local paths (relative to this file) that should be
+ # ignored by the migrate tool.
+ #
+ # Files that are not part of the templates will be ignored by default.
+ unmanaged_files:
+ - 'lib/main.dart'
+ - 'ios/Runner.xcodeproj/project.pbxproj'
diff --git a/examples/verdure/client/android/.gitignore b/examples/verdure/client/android/.gitignore
new file mode 100644
index 000000000..be3943c96
--- /dev/null
+++ b/examples/verdure/client/android/.gitignore
@@ -0,0 +1,14 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+.cxx/
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/to/reference-keystore
+key.properties
+**/*.keystore
+**/*.jks
diff --git a/examples/verdure/client/android/app/build.gradle.kts b/examples/verdure/client/android/app/build.gradle.kts
new file mode 100644
index 000000000..cf20c7d8f
--- /dev/null
+++ b/examples/verdure/client/android/app/build.gradle.kts
@@ -0,0 +1,44 @@
+plugins {
+ id("com.android.application")
+ id("kotlin-android")
+ // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+ id("dev.flutter.flutter-gradle-plugin")
+}
+
+android {
+ namespace = "com.example.verdure"
+ compileSdk = flutter.compileSdkVersion
+ ndkVersion = flutter.ndkVersion
+
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_17
+ targetCompatibility = JavaVersion.VERSION_17
+ }
+
+ kotlinOptions {
+ jvmTarget = JavaVersion.VERSION_17.toString()
+ }
+
+ defaultConfig {
+ // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+ applicationId = "com.example.verdure"
+ // You can update the following values to match your application needs.
+ // For more information, see: https://flutter.dev/to/review-gradle-config.
+ minSdk = flutter.minSdkVersion
+ targetSdk = flutter.targetSdkVersion
+ versionCode = flutter.versionCode
+ versionName = flutter.versionName
+ }
+
+ buildTypes {
+ release {
+ // TODO: Add your own signing config for the release build.
+ // Signing with the debug keys for now, so `flutter run --release` works.
+ signingConfig = signingConfigs.getByName("debug")
+ }
+ }
+}
+
+flutter {
+ source = "../.."
+}
diff --git a/examples/verdure/client/android/app/src/debug/AndroidManifest.xml b/examples/verdure/client/android/app/src/debug/AndroidManifest.xml
new file mode 100644
index 000000000..d52429175
--- /dev/null
+++ b/examples/verdure/client/android/app/src/debug/AndroidManifest.xml
@@ -0,0 +1,12 @@
+
+
+
+
+
+
+
diff --git a/examples/verdure/client/android/app/src/main/AndroidManifest.xml b/examples/verdure/client/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..8a2dad9ff
--- /dev/null
+++ b/examples/verdure/client/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,50 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/examples/verdure/client/android/app/src/main/kotlin/com/example/verdure/MainActivity.kt b/examples/verdure/client/android/app/src/main/kotlin/com/example/verdure/MainActivity.kt
new file mode 100644
index 000000000..b6c7946f0
--- /dev/null
+++ b/examples/verdure/client/android/app/src/main/kotlin/com/example/verdure/MainActivity.kt
@@ -0,0 +1,9 @@
+// Copyright 2025 The Flutter Authors.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package com.example.verdure
+
+import io.flutter.embedding.android.FlutterActivity
+
+class MainActivity : FlutterActivity()
diff --git a/examples/verdure/client/android/app/src/main/res/drawable-v21/launch_background.xml b/examples/verdure/client/android/app/src/main/res/drawable-v21/launch_background.xml
new file mode 100644
index 000000000..3827ad38b
--- /dev/null
+++ b/examples/verdure/client/android/app/src/main/res/drawable-v21/launch_background.xml
@@ -0,0 +1,16 @@
+
+
+
+
+
+ , '2' for ).",
+ "enum": ["1", "2", "3", "4", "5"]
+ }
+ },
+ "required": ["text"]
+ },
+ "Text": {
+ "type": "object",
+ "properties": {
+ "text": {
+ "type": "object",
+ "description": "The text content to display. This can be a literal string or a reference to a value in the data model ('path', e.g. '/hotel/description').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": ["text"]
+ },
+ "Image": {
+ "type": "object",
+ "properties": {
+ "url": {
+ "type": "object",
+ "description": "The URL of the image to display. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/thumbnail/url').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "fit": {
+ "type": "string",
+ "description": "Specifies how the image should be resized to fit its container. This corresponds to the CSS 'object-fit' property.",
+ "enum": [
+ "contain",
+ "cover",
+ "fill",
+ "none",
+ "scale-down"
+ ]
+ }
+ },
+ "required": ["url"]
+ },
+ "Icon": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "object",
+ "description": "The name of the icon to display. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/icon/name').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": ["name"]
+ },
+ "Video": {
+ "type": "object",
+ "properties": {
+ "url": {
+ "type": "object",
+ "description": "The URL of the video to display. This can be a literal string or a reference to a value in the data model ('path', e.g. '/video/url').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": ["url"]
+ },
+ "AudioPlayer": {
+ "type": "object",
+ "properties": {
+ "url": {
+ "type": "object",
+ "description": "The URL of the audio to be played. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/song/url').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "description": {
+ "type": "object",
+ "description": "A description of the audio, such as a title or summary. This can be a literal string or a reference to a value in the data model ('path', e.g. '/song/title').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": ["url"]
+ },
+ "Row": {
+ "type": "object",
+ "properties": {
+ "children": {
+ "type": "object",
+ "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
+ "properties": {
+ "explicitList": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "template": {
+ "type": "object",
+ "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
+ "properties": {
+ "componentId": {
+ "type": "string"
+ },
+ "dataBinding": {
+ "type": "string"
+ }
+ },
+ "required": ["componentId", "dataBinding"]
+ }
+ }
+ },
+ "distribution": {
+ "type": "string",
+ "description": "Defines the arrangement of children along the main axis (horizontally). This corresponds to the CSS 'justify-content' property.",
+ "enum": [
+ "center",
+ "end",
+ "spaceAround",
+ "spaceBetween",
+ "spaceEvenly",
+ "start"
+ ]
+ },
+ "alignment": {
+ "type": "string",
+ "description": "Defines the alignment of children along the cross axis (vertically). This corresponds to the CSS 'align-items' property.",
+ "enum": ["start", "center", "end", "stretch"]
+ }
+ },
+ "required": ["children"]
+ },
+ "Column": {
+ "type": "object",
+ "properties": {
+ "children": {
+ "type": "object",
+ "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
+ "properties": {
+ "explicitList": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "template": {
+ "type": "object",
+ "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
+ "properties": {
+ "componentId": {
+ "type": "string"
+ },
+ "dataBinding": {
+ "type": "string"
+ }
+ },
+ "required": ["componentId", "dataBinding"]
+ }
+ }
+ },
+ "distribution": {
+ "type": "string",
+ "description": "Defines the arrangement of children along the main axis (vertically). This corresponds to the CSS 'justify-content' property.",
+ "enum": [
+ "start",
+ "center",
+ "end",
+ "spaceBetween",
+ "spaceAround",
+ "spaceEvenly"
+ ]
+ },
+ "alignment": {
+ "type": "string",
+ "description": "Defines the alignment of children along the cross axis (horizontally). This corresponds to the CSS 'align-items' property.",
+ "enum": ["center", "end", "start", "stretch"]
+ }
+ },
+ "required": ["children"]
+ },
+ "List": {
+ "type": "object",
+ "properties": {
+ "children": {
+ "type": "object",
+ "description": "Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list.",
+ "properties": {
+ "explicitList": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "template": {
+ "type": "object",
+ "description": "A template for generating a dynamic list of children from a data model list. `componentId` is the component to use as a template, and `dataBinding` is the path to the map of components in the data model. Values in the map will define the list of children.",
+ "properties": {
+ "componentId": {
+ "type": "string"
+ },
+ "dataBinding": {
+ "type": "string"
+ }
+ },
+ "required": ["componentId", "dataBinding"]
+ }
+ }
+ },
+ "direction": {
+ "type": "string",
+ "description": "The direction in which the list items are laid out.",
+ "enum": ["vertical", "horizontal"]
+ },
+ "alignment": {
+ "type": "string",
+ "description": "Defines the alignment of children along the cross axis.",
+ "enum": ["start", "center", "end", "stretch"]
+ }
+ },
+ "required": ["children"]
+ },
+ "Card": {
+ "type": "object",
+ "properties": {
+ "child": {
+ "type": "string",
+ "description": "The ID of the component to be rendered inside the card."
+ }
+ },
+ "required": ["child"]
+ },
+ "Tabs": {
+ "type": "object",
+ "properties": {
+ "tabItems": {
+ "type": "array",
+ "description": "An array of objects, where each object defines a tab with a title and a child component.",
+ "items": {
+ "type": "object",
+ "properties": {
+ "title": {
+ "type": "object",
+ "description": "The tab title. Defines the value as either a literal value or a path to data model value (e.g. '/options/title').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "child": {
+ "type": "string"
+ }
+ },
+ "required": ["title", "child"]
+ }
+ }
+ },
+ "required": ["tabItems"]
+ },
+ "Divider": {
+ "type": "object",
+ "properties": {
+ "axis": {
+ "type": "string",
+ "description": "The orientation of the divider.",
+ "enum": ["horizontal", "vertical"]
+ }
+ }
+ },
+ "Modal": {
+ "type": "object",
+ "properties": {
+ "entryPointChild": {
+ "type": "string",
+ "description": "The ID of the component that opens the modal when interacted with (e.g., a button)."
+ },
+ "contentChild": {
+ "type": "string",
+ "description": "The ID of the component to be displayed inside the modal."
+ }
+ },
+ "required": ["entryPointChild", "contentChild"]
+ },
+ "Button": {
+ "type": "object",
+ "properties": {
+ "child": {
+ "type": "string",
+ "description": "The ID of the component to display in the button, typically a Text component."
+ },
+ "primary": {
+ "type": "boolean",
+ "description": "Indicates if this button should be styled as the primary action."
+ },
+ "action": {
+ "type": "object",
+ "description": "The client-side action to be dispatched when the button is clicked. It includes the action's name and an optional context payload.",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "context": {
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string"
+ },
+ "value": {
+ "type": "object",
+ "description": "Defines the value to be included in the context as either a literal value or a path to a data model value (e.g. '/user/name').",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "literalString": {
+ "type": "string"
+ },
+ "literalNumber": {
+ "type": "number"
+ },
+ "literalBoolean": {
+ "type": "boolean"
+ }
+ }
+ }
+ },
+ "required": ["key", "value"]
+ }
+ }
+ },
+ "required": ["name"]
+ }
+ },
+ "required": ["child", "action"]
+ },
+ "CheckBox": {
+ "type": "object",
+ "properties": {
+ "label": {
+ "type": "object",
+ "description": "The text to display next to the checkbox. Defines the value as either a literal value or a path to data model ('path', e.g. '/option/label').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "value": {
+ "type": "object",
+ "description": "The current state of the checkbox (true for checked, false for unchecked). This can be a literal boolean ('literalBoolean') or a reference to a value in the data model ('path', e.g. '/filter/open').",
+ "properties": {
+ "literalBoolean": {
+ "type": "boolean"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ }
+ },
+ "required": ["label", "value"]
+ },
+ "TextField": {
+ "type": "object",
+ "properties": {
+ "label": {
+ "type": "object",
+ "description": "The text label for the input field. This can be a literal string or a reference to a value in the data model ('path, e.g. '/user/name').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "text": {
+ "type": "object",
+ "description": "The value of the text field. This can be a literal string or a reference to a value in the data model ('path', e.g. '/user/name').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "textFieldType": {
+ "type": "string",
+ "description": "The type of input field to display.",
+ "enum": [
+ "date",
+ "longText",
+ "number",
+ "shortText",
+ "obscured"
+ ]
+ },
+ "validationRegexp": {
+ "type": "string",
+ "description": "A regular expression used for client-side validation of the input."
+ }
+ },
+ "required": ["label"]
+ },
+ "DateTimeInput": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "object",
+ "description": "The selected date and/or time value. This can be a literal string ('literalString') or a reference to a value in the data model ('path', e.g. '/user/dob').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "enableDate": {
+ "type": "boolean",
+ "description": "If true, allows the user to select a date."
+ },
+ "enableTime": {
+ "type": "boolean",
+ "description": "If true, allows the user to select a time."
+ },
+ "outputFormat": {
+ "type": "string",
+ "description": "The desired format for the output string after a date or time is selected."
+ }
+ },
+ "required": ["value"]
+ },
+ "MultipleChoice": {
+ "type": "object",
+ "properties": {
+ "selections": {
+ "type": "object",
+ "description": "The currently selected values for the component. This can be a literal array of strings or a path to an array in the data model('path', e.g. '/hotel/options').",
+ "properties": {
+ "literalArray": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "options": {
+ "type": "array",
+ "description": "An array of available options for the user to choose from.",
+ "items": {
+ "type": "object",
+ "properties": {
+ "label": {
+ "type": "object",
+ "description": "The text to display for this option. This can be a literal string or a reference to a value in the data model (e.g. '/option/label').",
+ "properties": {
+ "literalString": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "value": {
+ "type": "string",
+ "description": "The value to be associated with this option when selected."
+ }
+ },
+ "required": ["label", "value"]
+ }
+ },
+ "maxAllowedSelections": {
+ "type": "integer",
+ "description": "The maximum number of options that the user is allowed to select."
+ }
+ },
+ "required": ["selections", "options"]
+ },
+ "Slider": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "object",
+ "description": "The current value of the slider. This can be a literal number ('literalNumber') or a reference to a value in the data model ('path', e.g. '/restaurant/cost').",
+ "properties": {
+ "literalNumber": {
+ "type": "number"
+ },
+ "path": {
+ "type": "string"
+ }
+ }
+ },
+ "minValue": {
+ "type": "number",
+ "description": "The minimum value of the slider."
+ },
+ "maxValue": {
+ "type": "number",
+ "description": "The maximum value of the slider."
+ }
+ },
+ "required": ["value"]
+ }
+ }
+ }
+ },
+ "required": ["id", "component"]
+ }
+ }
+ },
+ "required": ["surfaceId", "components"]
+ },
+ "dataModelUpdate": {
+ "type": "object",
+ "description": "Updates the data model for a surface.",
+ "properties": {
+ "surfaceId": {
+ "type": "string",
+ "description": "The unique identifier for the UI surface this data model update applies to."
+ },
+ "path": {
+ "type": "string",
+ "description": "An optional path to a location within the data model (e.g., '/user/name'). If omitted, or set to '/', the entire data model will be replaced."
+ },
+ "contents": {
+ "type": "array",
+ "description": "An array of data entries. Each entry must contain a 'key' and exactly one corresponding typed 'value*' property.",
+ "items": {
+ "type": "object",
+ "description": "A single data entry. Exactly one 'value*' property should be provided alongside the key.",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "The key for this data entry."
+ },
+ "valueString": {
+ "type": "string"
+ },
+ "valueNumber": {
+ "type": "number"
+ },
+ "valueBoolean": {
+ "type": "boolean"
+ },
+ "valueMap": {
+ "description": "Represents a map as an adjacency list.",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "description": "One entry in the map. Exactly one 'value*' property should be provided alongside the key.",
+ "properties": {
+ "key": {
+ "type": "string"
+ },
+ "valueString": {
+ "type": "string"
+ },
+ "valueNumber": {
+ "type": "number"
+ },
+ "valueBoolean": {
+ "type": "boolean"
+ }
+ },
+ "required": ["key"]
+ }
+ }
+ },
+ "required": ["key"]
+ }
+ }
+ },
+ "required": ["contents", "surfaceId"]
+ },
+ "deleteSurface": {
+ "type": "object",
+ "description": "Signals the client to delete the surface identified by 'surfaceId'.",
+ "properties": {
+ "surfaceId": {
+ "type": "string",
+ "description": "The unique identifier for the UI surface to be deleted."
+ }
+ },
+ "required": ["surfaceId"]
+ }
+ }
+}
+"""
diff --git a/examples/verdure/server/verdure/agent.py b/examples/verdure/server/verdure/agent.py
new file mode 100644
index 000000000..c72a1d010
--- /dev/null
+++ b/examples/verdure/server/verdure/agent.py
@@ -0,0 +1,338 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import logging
+import os
+from collections.abc import AsyncIterable
+from typing import Any
+
+import jsonschema
+
+# --- IMPORT MODIFICATION ---
+from a2ui_schema import A2UI_SCHEMA
+from google.adk.agents.llm_agent import LlmAgent
+from google.adk.artifacts import InMemoryArtifactService
+from google.adk.memory.in_memory_memory_service import InMemoryMemoryService
+from google.adk.models.lite_llm import LiteLlm
+from google.adk.runners import Runner
+from google.adk.sessions import InMemorySessionService
+from google.genai import types
+from prompt_builder import (
+ get_text_prompt,
+ get_ui_prompt,
+)
+
+# --- END MODIFICATION ---
+from tools import get_landscape_options
+from ui_examples import LANDSCAPE_UI_EXAMPLES
+
+logger = logging.getLogger(__name__)
+
+AGENT_INSTRUCTION = """
+ You are a helpful landscape design assistant. Your goal is to guide users through designing their dream landscape using a rich UI.
+ You MUST follow the UI TEMPLATE RULES. For every user query that matches a rule, you MUST generate the UI using the specified template.
+ DO NOT just reply with text if a UI template is available for the query.
+
+ To achieve this, you MUST follow this logic:
+
+ 1. **Welcome:**
+ a. If the user sends a greeting (e.g., "hi", "start"), you MUST generate the UI using the `WELCOME_SCREEN_EXAMPLE` template.
+
+ 2. **Project Details:**
+ a. When you receive a query like 'USER_WANTS_TO_START_PROJECT', you MUST generate the UI using the `PROJECT_DETAILS_EXAMPLE` template. DO NOT just say "OK, let's start".
+
+ 3. **Dynamic Questionnaire:**
+ a. When you receive a query like 'USER_SUBMITTED_DETAILS...', this means the user has "uploaded" a photo.
+ b. You MUST **analyze the features of the user's photo** (which will be provided as a URL or description) and **dynamically generate a new questionnaire** based on what you see.
+ c. The `QUESTIONNAIRE_EXAMPLE` is your template for this. For example, the photo in the template (`old_backyard.png`) has an old concrete patio, some bushes, and a grill area. Therefore, you MUST generate specific questions about those exact items (e.g., "What to do with the concrete patio?", "Preserve established bushes?").
+ d. If a user uploads a photo of a grassy lawn, your questions should be about *that* (e.g., "Add a flower bed?", "Install a patio?").
+
+ 4. **Get Options:**
+ a. When you receive a query like 'USER_SUBMITTED_QUESTIONNAIRE...', you MUST first call the `get_landscape_options` tool. Extract the budget, style, maintenance, and space description from the query.
+ b. After receiving the data, you MUST use the `OPTIONS_PRESENTATION_EXAMPLE` template, populating the `dataModelUpdate.contents` with the JSON data from the tool.
+
+ 5. **Shopping Cart:**
+ a. When you receive a query like 'USER_SELECTED_OPTION...', you MUST generate the UI using the `SHOPPING_CART_EXAMPLE` template. Populate the `dataModelUpdate.contents` with simulated cart items for the chosen design.
+
+ 6. **Confirmation:**
+ a. When you receive a query like 'USER_CHECKED_OUT...', you MUST use the `ORDER_CONFIRMATION_EXAMPLE` template, populating the `dataModelUpdate.contents` with the final order details.
+"""
+
+
+class LandscapeAgent:
+ """An agent that helps design landscapes based on user criteria."""
+
+ SUPPORTED_CONTENT_TYPES = ["text", "text/plain"]
+
+ def __init__(self, base_url: str, use_ui: bool = False):
+ self.base_url = base_url
+ self.use_ui = use_ui
+ self._agent = self._build_agent(use_ui)
+ self._user_id = "remote_agent"
+ self._runner = Runner(
+ app_name=self._agent.name,
+ agent=self._agent,
+ artifact_service=InMemoryArtifactService(),
+ session_service=InMemorySessionService(),
+ memory_service=InMemoryMemoryService(),
+ )
+
+ # --- MODIFICATION: Wrap the schema ---
+ # Load the A2UI_SCHEMA string into a Python object for validation
+ try:
+ # First, load the schema for a *single message*
+ single_message_schema = json.loads(A2UI_SCHEMA)
+
+ # The prompt instructs the LLM to return a *list* of messages.
+ # Therefore, our validation schema must be an *array* of the single message schema.
+ self.a2ui_schema_object = {"type": "array", "items": single_message_schema}
+ logger.info(
+ "A2UI_SCHEMA successfully loaded and wrapped in an array validator."
+ )
+ except json.JSONDecodeError as e:
+ logger.error(f"CRITICAL: Failed to parse A2UI_SCHEMA: {e}")
+ self.a2ui_schema_object = None
+ # --- END MODIFICATION ---
+
+ def get_processing_message(self) -> str:
+ return "Designing your landscape options..."
+
+ def _build_agent(self, use_ui: bool) -> LlmAgent:
+ """Builds the LLM agent for the landscape agent."""
+ LITELLM_MODEL = os.getenv("LITELLM_MODEL", "gemini-2.5-flash")
+
+ if use_ui:
+ # Construct the full prompt with UI instructions, examples, and schema
+ instruction = AGENT_INSTRUCTION + get_ui_prompt(
+ self.base_url, LANDSCAPE_UI_EXAMPLES
+ )
+ else:
+ instruction = get_text_prompt()
+
+ return LlmAgent(
+ model=LiteLlm(model=LITELLM_MODEL),
+ name="landscape_agent",
+ description="An agent that helps design landscapes.",
+ instruction=instruction,
+ tools=[get_landscape_options],
+ )
+
+ async def stream(self, query, session_id, image_part=None) -> AsyncIterable[dict[str, Any]]:
+ session_state = {"base_url": self.base_url}
+
+ session = await self._runner.session_service.get_session(
+ app_name=self._agent.name,
+ user_id=self._user_id,
+ session_id=session_id,
+ )
+ if session is None:
+ session = await self._runner.session_service.create_session(
+ app_name=self._agent.name,
+ user_id=self._user_id,
+ state=session_state,
+ session_id=session_id,
+ )
+ elif "base_url" not in session.state:
+ session.state["base_url"] = self.base_url
+
+ # --- Begin: UI Validation and Retry Logic ---
+ max_retries = 1 # Total 2 attempts
+ attempt = 0
+ current_query_text = query
+
+ # Ensure schema was loaded
+ if self.use_ui and self.a2ui_schema_object is None:
+ logger.error(
+ "--- LandscapeAgent.stream: A2UI_SCHEMA is not loaded. "
+ "Cannot perform UI validation. ---"
+ )
+ yield {
+ "is_task_complete": True,
+ "content": (
+ "I'm sorry, I'm facing an internal configuration error with my UI components. "
+ "Please contact support."
+ ),
+ }
+ return
+
+ while attempt <= max_retries:
+ attempt += 1
+ logger.info(
+ f"--- LandscapeAgent.stream: Attempt {attempt}/{max_retries + 1} "
+ f"for session {session_id} ---"
+ )
+
+ parts = [types.Part.from_text(text=current_query_text)]
+ if image_part:
+ if image_part.bytes_data:
+ logger.info(f"Adding image bytes to message")
+ parts.append(
+ types.Part.from_bytes(
+ data=image_part.bytes_data,
+ mime_type=image_part.mime_type or "image/jpeg",
+ )
+ )
+ else:
+ logger.info(f"Adding image URL to message: {image_part.url}")
+ parts.append(
+ types.Part.from_uri(
+ file_uri=image_part.url,
+ mime_type=image_part.mime_type or "image/jpeg",
+ )
+ )
+
+ current_message = types.Content(role="user", parts=parts)
+ final_response_content = None
+
+ async for event in self._runner.run_async(
+ user_id=self._user_id,
+ session_id=session.id,
+ new_message=current_message,
+ ):
+ logger.info(f"Event from runner: {event}")
+ if event.is_final_response():
+ if (
+ event.content
+ and event.content.parts
+ and event.content.parts[0].text
+ ):
+ final_response_content = "\n".join(
+ [p.text for p in event.content.parts if p.text]
+ )
+ break # Got the final response, stop consuming events
+ else:
+ logger.info(f"Intermediate event: {event}")
+ # Yield intermediate updates on every attempt
+ yield {
+ "is_task_complete": False,
+ "updates": self.get_processing_message(),
+ }
+
+ if final_response_content is None:
+ logger.warning(
+ f"--- LandscapeAgent.stream: Received no final response content from runner "
+ f"(Attempt {attempt}). ---"
+ )
+ if attempt <= max_retries:
+ current_query_text = (
+ "I received no response. Please try again."
+ f"Please retry the original request: '{query}'"
+ )
+ continue # Go to next retry
+ else:
+ # Retries exhausted on no-response
+ final_response_content = "I'm sorry, I encountered an error and couldn't process your request."
+ # Fall through to send this as a text-only error
+
+ is_valid = False
+ error_message = ""
+
+ if self.use_ui:
+ logger.info(
+ f"--- LandscapeAgent.stream: Validating UI response (Attempt {attempt})... ---"
+ )
+ try:
+ if "---a2ui_JSON---" not in final_response_content:
+ raise ValueError("Delimiter '---a2ui_JSON---' not found.")
+
+ text_part, json_string = final_response_content.split(
+ "---a2ui_JSON---", 1
+ )
+
+ if not json_string.strip():
+ raise ValueError("JSON part is empty.")
+
+ json_string_cleaned = (
+ json_string.strip().lstrip("```json").rstrip("```").strip()
+ )
+
+ if not json_string_cleaned:
+ raise ValueError("Cleaned JSON string is empty.")
+
+ # --- New Validation Steps ---
+ # 1. Check if it's parsable JSON
+ parsed_json_data = json.loads(json_string_cleaned)
+
+ # 2. Check if it validates against the A2UI_SCHEMA
+ # This will raise jsonschema.exceptions.ValidationError if it fails
+ logger.info(
+ "--- LandscapeAgent.stream: Validating against A2UI_SCHEMA... ---"
+ )
+ jsonschema.validate(
+ instance=parsed_json_data, schema=self.a2ui_schema_object
+ )
+ # --- End New Validation Steps ---
+
+ logger.info(
+ f"--- LandscapeAgent.stream: UI JSON successfully parsed AND validated against schema. "
+ f"Validation OK (Attempt {attempt}). ---"
+ )
+ is_valid = True
+
+ except (
+ ValueError,
+ json.JSONDecodeError,
+ jsonschema.exceptions.ValidationError,
+ ) as e:
+ logger.warning(
+ f"--- LandscapeAgent.stream: A2UI validation failed: {e} (Attempt {attempt}) ---"
+ )
+ logger.warning(
+ f"--- Failed response content: {final_response_content[:500]}... ---"
+ )
+ error_message = f"Validation failed: {e}."
+
+ else: # Not using UI, so text is always "valid"
+ is_valid = True
+
+ if is_valid:
+ logger.info(
+ f"--- LandscapeAgent.stream: Response is valid. Sending final response (Attempt {attempt}). ---"
+ )
+ logger.info(f"Final response: {final_response_content}")
+ yield {
+ "is_task_complete": True,
+ "content": final_response_content,
+ }
+ return # We're done, exit the generator
+
+ # --- If we're here, it means validation failed ---
+
+ if attempt <= max_retries:
+ logger.warning(
+ f"--- LandscapeAgent.stream: Retrying... ({attempt}/{max_retries + 1}) ---"
+ )
+ # Prepare the query for the retry
+ current_query_text = (
+ f"Your previous response was invalid. {error_message} "
+ "You MUST generate a valid response that strictly follows the A2UI JSON SCHEMA. "
+ "The response MUST be a JSON list of A2UI messages. "
+ "Ensure the response is split by '---a2ui_JSON---' and the JSON part is well-formed. "
+ f"Please retry the original request: '{query}'"
+ )
+ # Loop continues...
+
+ # --- If we're here, it means we've exhausted retries ---
+ logger.error(
+ "--- LandscapeAgent.stream: Max retries exhausted. Sending text-only error. ---"
+ )
+ yield {
+ "is_task_complete": True,
+ "content": (
+ "I'm sorry, I'm having trouble generating the interface for that request right now. "
+ "Please try again in a moment."
+ ),
+ }
+ # --- End: UI Validation andRetry Logic ---
diff --git a/examples/verdure/server/verdure/agent_executor.py b/examples/verdure/server/verdure/agent_executor.py
new file mode 100644
index 000000000..fc852c440
--- /dev/null
+++ b/examples/verdure/server/verdure/agent_executor.py
@@ -0,0 +1,292 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import json
+import logging
+import mimetypes
+import os
+import uuid
+
+from a2a.server.agent_execution import AgentExecutor, RequestContext
+from a2a.server.events import EventQueue
+from a2a.server.tasks import TaskUpdater
+from a2a.types import (
+ DataPart,
+ Part,
+ Task,
+ TaskState,
+ TextPart,
+ UnsupportedOperationError,
+ FilePart,
+)
+from a2a.utils import (
+ new_agent_parts_message,
+ new_agent_text_message,
+ new_task,
+)
+from a2a.utils.errors import ServerError
+from a2ui_ext import a2ui_MIME_TYPE
+from agent import LandscapeAgent
+
+logger = logging.getLogger(__name__)
+
+
+class ImagePart:
+ def __init__(self, url: str, mime_type: str = None, bytes_data: bytes = None):
+ self.url = url
+ self.mime_type = mime_type
+ self.bytes_data = bytes_data
+
+
+class LandscapeAgentExecutor(AgentExecutor):
+ """Landscape AgentExecutor Example."""
+
+ def __init__(self, base_url: str):
+ # Instantiate two agents: one for UI and one for text-only.
+ # The appropriate one will be chosen at execution time.
+ self.ui_agent = LandscapeAgent(base_url=base_url, use_ui=True)
+ self.text_agent = LandscapeAgent(base_url=base_url, use_ui=False)
+
+ async def execute(
+ self,
+ context: RequestContext,
+ event_queue: EventQueue,
+ use_ui: bool = False, # This will be passed by the a2ui wrapper
+ ) -> None:
+ query = ""
+ ui_event_part = None
+ image_part = None
+ action = None
+
+ # Determine which agent to use based on whether the a2ui extension is active.
+ if use_ui:
+ agent = self.ui_agent
+ logger.info(
+ "--- AGENT_EXECUTOR: A2UI extension is active. Using UI agent. ---"
+ )
+ else:
+ agent = self.text_agent
+ logger.info(
+ "--- AGENT_EXECUTOR: A2UI extension is not active. Using text agent. ---"
+ )
+
+ if context.message and context.message.parts:
+ logger.info(
+ f"--- AGENT_EXECUTOR: Processing {len(context.message.parts)} message parts ---"
+ )
+ for i, part in enumerate(context.message.parts):
+ if isinstance(part.root, DataPart):
+ if "userAction" in part.root.data:
+ logger.info(f" Part {i}: Found a2ui UI ClientEvent payload.")
+ ui_event_part = part.root.data["userAction"]
+ else:
+ logger.info(f" Part {i}: DataPart (data: {part.root.data})")
+ elif isinstance(part.root, TextPart):
+ logger.info(f" Part {i}: TextPart (text: {part.root.text})")
+ elif isinstance(part.root, FilePart):
+ logger.info(f" Part {i}: Found FilePart: bytes: {part.root.file.bytes[0:100]}...")
+ file_data = part.root.file
+ if file_data.bytes:
+ logger.info(f" Extracting {len(part.root.file.bytes)} bytes")
+ try:
+ image_bytes = base64.b64decode(file_data.bytes)
+ mime_type = file_data.mime_type
+ extension = {
+ "image/png": ".png",
+ "image/jpeg": ".jpg",
+ "image/heic": ".heic",
+ "image/webp": ".webp",
+ }.get(mime_type, ".jpg")
+ filename = f"{uuid.uuid4()}{extension}"
+ images_dir = os.path.join(os.path.dirname(__file__), "images", "uploads")
+ os.makedirs(images_dir, exist_ok=True)
+ filepath = os.path.join(images_dir, filename)
+ with open(filepath, "wb") as f:
+ f.write(image_bytes)
+
+ image_url = f"{self.ui_agent.base_url}/images/uploads/{filename}"
+ mime_type = file_data.mime_type if file_data.mime_type else "image/jpeg"
+ image_part = ImagePart(image_url, mime_type, image_bytes)
+ logger.info(f" Part {i}: Set image_part to a {mime_type} image.")
+ logger.info(f" Saved FilePart to {filepath}, URL: {image_url}")
+ except Exception as e:
+ logger.error(f"Failed to save FilePart: {e}")
+ elif file_data.uri:
+ logger.info(f" Part {i}: FilePart has URI: {file_data.uri}")
+ # Handle URI if needed, but for now focus on bytes
+ else:
+ logger.info(f" Part {i}: Unknown part type ({type(part.root)})")
+
+ if ui_event_part:
+ logger.info(f"Received a2ui ClientEvent: {ui_event_part}")
+ action = ui_event_part.get("name")
+ ctx = ui_event_part.get("context", {})
+
+ if action == "start_project":
+ logger.info("Handling 'start_project' action.")
+ query = "USER_WANTS_TO_START_PROJECT"
+
+ elif action == "submit_details":
+ logger.info("Handling 'submit_details' action.")
+ yard_desc = ctx.get("yardDescription", "No description")
+ image_url = ctx.get("imageUrl", "No URL")
+ if image_part:
+ image_url = image_part.url
+ logger.info(f"Using image URL from ImagePart: {image_url}")
+
+ logger.info("Handling 'submit_details' action.")
+ query = f"USER_SUBMITTED_DETAILS: Description: '{yard_desc}', Image: '{image_url}'"
+
+ elif action == "submit_questionnaire":
+ # These keys now match the new dynamic questionnaire
+ preserve_bushes = ctx.get("preserveBushes", True)
+ guest_count = ctx.get("guestCount", 4)
+ patio_plan = ctx.get("patioPlan", ["any"])
+
+ logger.info("Handling 'submit_questionnaire' action.")
+ # Ensure patio_plan is a single string for the prompt
+ patio_plan_str = (
+ patio_plan[0]
+ if isinstance(patio_plan, list) and patio_plan
+ else "any"
+ )
+
+ query = f"USER_SUBMITTED_QUESTIONNAIRE: Preserve Bushes: {preserve_bushes}, Guest Count: {guest_count}, Patio Plan: {patio_plan_str}"
+
+ elif action == "select_option":
+ option_name = ctx.get("optionName", "Unknown Option")
+ logger.info("Handling 'select_option' action.")
+ query = f"USER_SELECTED_OPTION: {option_name}"
+
+ elif action == "checkout":
+ option_name = ctx.get("optionName", "Unknown Option")
+ total_price = ctx.get("totalPrice", "Unknown Price")
+ logger.info("Handling 'checkout' action.")
+ query = f"USER_CHECKED_OUT: {option_name}, Price: {total_price}"
+
+ else:
+ logger.warning(f"Handling unknown action: {action}")
+ query = f"User submitted an event: {action} with data: {ctx}"
+ else:
+ logger.info("No a2ui UI event part found. Falling back to text input.")
+ user_input = context.get_user_input()
+ if image_part:
+ query = f"USER_SUBMITTED_DETAILS: Description: '{user_input}', Image: '{image_part.url}'"
+ else:
+ query = user_input
+
+ # --- NEW DEBUG LOG ---
+ logger.info(
+ "====================================================================="
+ )
+ logger.info(f"--- AGENT_EXECUTOR: Sending this query to LLM: '{query}' ---")
+ logger.info(
+ "====================================================================="
+ )
+ # --- END NEW DEBUG LOG ---
+
+ task = context.current_task
+
+ if not task:
+ task = new_task(context.message)
+ await event_queue.enqueue_event(task)
+ updater = TaskUpdater(event_queue, task.id, task.context_id)
+
+ async for item in agent.stream(query, task.context_id, image_part=image_part):
+ is_task_complete = item["is_task_complete"]
+ if not is_task_complete:
+ await updater.update_status(
+ TaskState.working,
+ new_agent_text_message(item["updates"], task.context_id, task.id),
+ )
+ continue
+
+ final_state = (
+ TaskState.completed
+ if action == "checkout"
+ else TaskState.input_required
+ )
+
+ content = item["content"]
+ final_parts = []
+ if "---a2ui_JSON---" in content:
+ logger.info("Splitting final response into text and UI parts.")
+ text_content, json_string = content.split("---a2ui_JSON---", 1)
+
+ if text_content.strip():
+ final_parts.append(Part(root=TextPart(text=text_content.strip())))
+
+ if json_string.strip():
+ try:
+ json_string_cleaned = (
+ json_string.strip().lstrip("```json").rstrip("```").strip()
+ )
+ # The new protocol sends a stream of JSON objects.
+ # For this example, we'll assume they are sent as a list in the final response.
+ json_data = json.loads(json_string_cleaned)
+
+ if isinstance(json_data, list):
+ logger.info(
+ f"Found {len(json_data)} messages. Creating individual DataParts."
+ )
+ for message in json_data:
+ final_parts.append(
+ Part(
+ root=DataPart(
+ data=message,
+ mime_type=a2ui_MIME_TYPE,
+ )
+ )
+ )
+ else:
+ # Handle the case where a single JSON object is returned
+ logger.info(
+ "Received a single JSON object. Creating a DataPart."
+ )
+ final_parts.append(
+ Part(
+ root=DataPart(
+ data=json_data,
+ mime_type=a2ui_MIME_TYPE,
+ )
+ )
+ )
+
+ except json.JSONDecodeError as e:
+ logger.error(f"Failed to parse UI JSON: {e}")
+ final_parts.append(Part(root=TextPart(text=json_string)))
+ else:
+ final_parts.append(Part(root=TextPart(text=content.strip())))
+
+ logger.info("--- FINAL PARTS TO BE SENT ---")
+ for i, part in enumerate(final_parts):
+ logger.info(f" - Part {i}: Type = {type(part.root)}")
+ if isinstance(part.root, TextPart):
+ logger.info(f" - Text: {part.root.text[:200]}...")
+ elif isinstance(part.root, DataPart):
+ logger.info(f" - Data: {str(part.root.data)[:200]}...")
+ logger.info("-----------------------------")
+
+ await updater.update_status(
+ final_state,
+ new_agent_parts_message(final_parts, task.context_id, task.id),
+ final=(final_state == TaskState.completed),
+ )
+ break
+
+ async def cancel(
+ self, request: RequestContext, event_queue: EventQueue
+ ) -> Task | None:
+ raise ServerError(error=UnsupportedOperationError())
diff --git a/examples/verdure/server/verdure/images/cottage_garden.png b/examples/verdure/server/verdure/images/cottage_garden.png
new file mode 100644
index 000000000..3b193b869
Binary files /dev/null and b/examples/verdure/server/verdure/images/cottage_garden.png differ
diff --git a/examples/verdure/server/verdure/images/example.png b/examples/verdure/server/verdure/images/example.png
new file mode 100644
index 000000000..ecfdb47f9
Binary files /dev/null and b/examples/verdure/server/verdure/images/example.png differ
diff --git a/examples/verdure/server/verdure/images/header_image.png b/examples/verdure/server/verdure/images/header_image.png
new file mode 100644
index 000000000..662adad7a
Binary files /dev/null and b/examples/verdure/server/verdure/images/header_image.png differ
diff --git a/examples/verdure/server/verdure/images/old_backyard.png b/examples/verdure/server/verdure/images/old_backyard.png
new file mode 100644
index 000000000..02029dafd
Binary files /dev/null and b/examples/verdure/server/verdure/images/old_backyard.png differ
diff --git a/examples/verdure/server/verdure/images/orig_cottage_garden.png b/examples/verdure/server/verdure/images/orig_cottage_garden.png
new file mode 100644
index 000000000..73637c35d
Binary files /dev/null and b/examples/verdure/server/verdure/images/orig_cottage_garden.png differ
diff --git a/examples/verdure/server/verdure/images/orig_zen_garden.png b/examples/verdure/server/verdure/images/orig_zen_garden.png
new file mode 100644
index 000000000..82e03832a
Binary files /dev/null and b/examples/verdure/server/verdure/images/orig_zen_garden.png differ
diff --git a/examples/verdure/server/verdure/images/verdure_logo.png b/examples/verdure/server/verdure/images/verdure_logo.png
new file mode 100644
index 000000000..e38580591
Binary files /dev/null and b/examples/verdure/server/verdure/images/verdure_logo.png differ
diff --git a/examples/verdure/server/verdure/images/zen_full.png b/examples/verdure/server/verdure/images/zen_full.png
new file mode 100644
index 000000000..9739cb800
Binary files /dev/null and b/examples/verdure/server/verdure/images/zen_full.png differ
diff --git a/examples/verdure/server/verdure/images/zen_garden.png b/examples/verdure/server/verdure/images/zen_garden.png
new file mode 100644
index 000000000..ca015b768
Binary files /dev/null and b/examples/verdure/server/verdure/images/zen_garden.png differ
diff --git a/examples/verdure/server/verdure/prompt_builder.py b/examples/verdure/server/verdure/prompt_builder.py
new file mode 100644
index 000000000..28d2937d2
--- /dev/null
+++ b/examples/verdure/server/verdure/prompt_builder.py
@@ -0,0 +1,107 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# --- MODIFIED IMPORTS ---
+from a2ui_schema import A2UI_SCHEMA
+from ui_examples import LANDSCAPE_UI_EXAMPLES
+
+# --- END MODIFICATION ---
+
+
+# --- The large LANDSCAPE_UI_EXAMPLES string has been removed from here ---
+
+
+def get_ui_prompt(base_url: str, examples: str) -> str:
+ """
+ Constructs the full prompt with UI instructions, rules, examples, and schema.
+
+ Args:
+ base_url: The base URL for resolving static assets like logos.
+ examples: A string containing the specific UI examples for the agent's task.
+
+ Returns:
+ A formatted string to be used as the system prompt for the LLM.
+ """
+ # The f-string substitution for base_url happens here, at runtime.
+ formatted_examples = examples.format(base_url=base_url)
+
+ return f"""
+ You are a helpful landscape design assistant. Your final output MUST be an a2ui UI JSON response.
+
+ To generate the response, you MUST follow these rules:
+ 1. Your response MUST be in two parts, separated by the delimiter: `---a2ui_JSON---`.
+ 2. The first part is your conversational text response.
+ 3. The second part is a single, raw JSON object which is a list (array) of A2UI messages.
+ 4. The JSON part MUST validate against the A2UI JSON SCHEMA provided below.
+
+ --- UI TEMPLATE RULES ---
+ - If the user query is a greeting or "start", you MUST use the `WELCOME_SCREEN_EXAMPLE` template.
+ - If the query is 'USER_WANTS_TO_START_PROJECT', you MUST use the `PROJECT_DETAILS_EXAMPLE` template.
+
+ - If the query is 'USER_SUBMITTED_DETAILS...', this means the user has "uploaded" a photo.
+ The query will contain the URL of the uploaded image.
+ b. You MUST **analyze the features of the user's photo** (the URL will be provided in the query) and **dynamically generate a new questionnaire** based on what you see. When generating the `dataModelUpdate` for the questionnaire, you MUST replace the placeholder with the actual image URL from the user's query.
+ The `QUESTIONNAIRE_EXAMPLE` is your template for this. For example, the photo in the template (`old_backyard.png`) has an old concrete patio, some bushes, and a grill area.
+ Therefore, you MUST generate specific questions about those exact items (e.g., "What to do with the concrete patio?", "Preserve established bushes?").
+ You MUST show the user's uploaded image at the top of this screen by using its URL in the data model.
+ **CRITICAL: Replace the example image URL (`{base_url}/images/old_backyard.png`) in the `dataModelUpdate` with the actual URL provided in the query.**
+
+ - If the query is 'USER_SUBMITTED_QUESTIONNAIRE', you MUST first call the `get_landscape_options` tool.
+ - After receiving data from `get_landscape_options`, you MUST use the `OPTIONS_PRESENTATION_EXAMPLE` template to display the 2 options. Populate the `dataModelUpdate.contents` with the tool's JSON output.
+ - If the query is 'USER_SELECTED_OPTION', you MUST use the `SHOPPING_CART_EXAMPLE` template. Populate the `dataModelUpdate.contents` with items for the selected option.
+ - If the query is 'USER_CHECKED_OUT', you MUST use the `ORDER_CONFIRMATION_EXAMPLE` template.
+
+ {formatted_examples}
+
+ ---BEGIN A2UI JSON SCHEMA---
+ {A2UI_SCHEMA}
+ ---END A2UI JSON SCHEMA---
+ """
+
+
+def get_text_prompt() -> str:
+ """
+ Constructs the prompt for a text-only agent.
+ """
+ return """
+ You are a helpful landscape design assistant. Your final output MUST be a text response.
+
+ To generate the response, you MUST follow these rules:
+ 1. **Welcome:** If the user greets you, respond with "Welcome to Landscape Vision! Would you like to start a new project?"
+ 2. **Start Project:** If they say yes, ask them to "Please describe your yard (e.g., 'small, shady backyard')".
+ 3. **Get Preferences:** After they describe their yard, ask for their preferences: "What is your budget, desired style (e.g., Modern, Zen, Cottage), and maintenance level (Low, Medium, High)?"
+ 4. **Get Options:**
+ a. Once you have budget, style, and maintenance, you MUST call the `get_landscape_options` tool.
+ b. After receiving data, format the options as a clear, human-readable text response. You MUST preserve any markdown formatting.
+ 5. **Select Option:** Ask the user "Which option would you like to proceed with?"
+ 6. **Checkout:** When they choose, respond with "Great! Your order for the '[Option Name]' is confirmed. Our team will be in touch."
+ """
+
+
+if __name__ == "__main__":
+ # Example of how to use the prompt builder
+ # In your actual application, you would call this from your main agent logic.
+ my_base_url = "http://localhost:8000"
+
+ # You can now easily construct a prompt with the relevant examples.
+ # For a different agent (e.g., a flight booker), you would pass in
+ # different examples but use the same `get_ui_prompt` function.
+ restaurant_prompt = get_ui_prompt(my_base_url, LANDSCAPE_UI_EXAMPLES)
+
+ print(restaurant_prompt)
+
+ # This demonstrates how you could save the prompt to a file for inspection
+ with open("generated_prompt.txt", "w") as f:
+ f.write(restaurant_prompt)
+ print("\nGenerated prompt saved to generated_prompt.txt")
diff --git a/examples/verdure/server/verdure/pyproject.toml b/examples/verdure/server/verdure/pyproject.toml
new file mode 100644
index 000000000..17705a285
--- /dev/null
+++ b/examples/verdure/server/verdure/pyproject.toml
@@ -0,0 +1,26 @@
+[project]
+name = "a2ui-landscape-design"
+version = "0.1.0"
+description = "Sample Google ADK-based Landscape Design agent that uses a2ui UI and is hosted as an A2A server agent."
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+ "a2a-sdk>=0.3.0",
+ "click>=8.1.8",
+ "google-adk>=1.8.0",
+ "google-genai>=1.27.0",
+ "python-dotenv>=1.1.0",
+ "litellm",
+ "a2ui_ext",
+ "jsonschema>=4.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv.sources]
+a2ui_ext = { workspace = true }
\ No newline at end of file
diff --git a/examples/verdure/server/verdure/tools.py b/examples/verdure/server/verdure/tools.py
new file mode 100644
index 000000000..0fc722721
--- /dev/null
+++ b/examples/verdure/server/verdure/tools.py
@@ -0,0 +1,66 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+def get_landscape_options(
+ budget: str, style: str, maintenance: str, space_description: str
+) -> str:
+ """
+ Call this tool to get landscape design options based on user preferences.
+ 'budget' is the user's estimated budget.
+ 'style' is the desired landscape vibe (e.g., 'Modern', 'Zen', 'Cottage').
+ 'maintenance' is the preferred level (e.g., 'Low', 'Medium', 'High').
+ 'space_description' is the user's text description of their yard.
+ """
+ logger.info("--- TOOL CALLED: get_landscape_options ---")
+ logger.info(f" - Budget: {budget}")
+ logger.info(f" - Style: {style}")
+ logger.info(f" - Maintenance: {maintenance}")
+ logger.info(f" - Space: {space_description}")
+
+ # In a real app, this would query a model or database.
+ # Here, we return hardcoded options.
+ options = [
+ {
+ "name": "Modern Zen Garden",
+ "detail": "Low maintenance, drought-tolerant plants, and clean lines. Perfect for relaxation.",
+ "imageUrl": "http://localhost:10002/images/zen_garden.png",
+ "price": "Est. $5,000 - $8,000",
+ "time": "Est. 2-3 weeks",
+ "tradeoffs": "Higher upfront cost, less floral variety.",
+ "id": "option1",
+ },
+ {
+ "name": "English Cottage Garden",
+ "detail": "Vibrant, colorful, and teeming with life. A classic, romantic look.",
+ "imageUrl": "http://localhost:10002/images/cottage_garden.png",
+ "price": "Est. $3,000 - $6,000",
+ "time": "Est. 4-6 weeks",
+ "tradeoffs": "Higher maintenance (watering/weeding), seasonal changes.",
+ "id": "option2",
+ },
+ ]
+
+ # --- MODIFICATION ---
+ # Remove the filtering logic to always return both options
+ items = options
+ # --- END MODIFICATION ---
+
+ logger.info(f" - Success: Returning {len(items)} landscape options.")
+ return json.dumps(items)
diff --git a/examples/verdure/server/verdure/ui_examples.py b/examples/verdure/server/verdure/ui_examples.py
new file mode 100644
index 000000000..22acfd11a
--- /dev/null
+++ b/examples/verdure/server/verdure/ui_examples.py
@@ -0,0 +1,285 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This file serves as the single source of truth for all A2UI example templates.
+# It is imported by agent.py to be passed to the prompt builder.
+
+LANDSCAPE_UI_EXAMPLES = """
+---BEGIN WELCOME_SCREEN_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "welcome", "root": "welcome-column", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "welcome",
+ "components": [
+ {{ "id": "welcome-column", "component": {{ "Column": {{ "alignment": "center", "distribution": "center", "children": {{ "explicitList": ["logo-image", "welcome-title", "welcome-subtitle", "button-row"] }} }} }} }},
+ {{ "id": "logo-image", "component": {{ "Image": {{ "url": {{ "literalString": "{base_url}/images/verdure_logo.png" }}, "fit": "contain" }} }} }},
+ {{ "id": "welcome-title", "component": {{ "Heading": {{ "level": "1", "text": {{ "literalString": "Envision Your Dream Landscape" }} }} }} }},
+ {{ "id": "welcome-subtitle", "component": {{ "Text": {{ "text": {{ "literalString": "Bring your perfect outdoor space to life with our AI-powered design tools." }} }} }} }},
+
+ {{ "id": "button-row", "component": {{ "Row": {{ "distribution": "spaceEvenly", "alignment": "center", "children": {{ "explicitList": ["start-button", "explore-button", "returning-user-button"] }} }} }} }},
+
+ {{ "id": "start-button", "component": {{ "Button": {{ "child": "start-button-text", "primary": true, "action": {{ "name": "start_project" }} }} }} }},
+ {{ "id": "start-button-text", "component": {{ "Text": {{ "text": {{ "literalString": "Start New Project" }} }} }} }},
+
+ {{ "id": "explore-button", "component": {{ "Button": {{ "child": "explore-button-text", "primary": false, "action": {{ "name": "explore_ideas" }} }} }} }},
+ {{ "id": "explore-button-text", "component": {{ "Text": {{ "text": {{ "literalString": "Explore Ideas" }} }} }} }},
+
+ {{ "id": "returning-user-button", "component": {{ "Button": {{ "child": "returning-user-text", "primary": false, "action": {{ "name": "returning_user" }} }} }} }},
+ {{ "id": "returning-user-text", "component": {{ "Text": {{ "text": {{ "literalString": "I'm a returning user" }} }} }} }}
+ ]
+ }} }}
+]
+---END WELCOME_SCREEN_EXAMPLE---
+
+---BEGIN PROJECT_DETAILS_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "details", "root": "details-column", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "details",
+ "components": [
+ {{ "id": "details-column", "component": {{ "Column": {{ "alignment": "stretch", "children": {{ "explicitList": [
+ "header-row",
+ "hero-image",
+ "transformation-title",
+ "transformation-subtitle",
+ "take-photo-card",
+ "choose-library-card",
+ "tips-row",
+ "upload-photo-button"
+ ] }} }} }} }},
+
+ {{ "id": "header-row", "component": {{ "Row": {{ "distribution": "start", "alignment": "center", "children": {{ "explicitList": ["back-arrow", "header-title"] }} }} }} }},
+ {{ "id": "back-arrow", "component": {{ "Icon": {{ "name": {{ "literalString": "arrow-back" }} }} }} }},
+ {{ "id": "header-title", "component": {{ "Heading": {{ "level": "3", "text": {{ "literalString": "Visualize Your Garden" }} }} }} }},
+
+ {{ "id": "hero-image", "component": {{ "Image": {{ "url": {{ "literalString": "{base_url}/images/header_image.png" }}, "fit": "cover" }} }} }},
+
+ {{ "id": "transformation-title", "component": {{ "Heading": {{ "level": "1", "text": {{ "literalString": "Let's Start Your Transformation" }} }} }} }},
+ {{ "id": "transformation-subtitle", "component": {{ "Text": {{ "text": {{ "literalString": "Upload a photo of your front or back yard, and our designers will use it to create a custom vision. Get ready to see the potential." }} }} }} }},
+
+ {{ "id": "take-photo-card", "component": {{ "Card": {{ "child": "take-photo-row" }} }} }},
+ {{ "id": "take-photo-row", "component": {{ "Row": {{ "distribution": "start", "alignment": "center", "children": {{ "explicitList": ["take-photo-icon", "take-photo-column"] }} }} }} }},
+ {{ "id": "take-photo-icon", "component": {{ "Icon": {{ "name": {{ "literalString": "camera-alt" }} }} }} }},
+ {{ "id": "take-photo-column", "component": {{ "Column": {{ "children": {{ "explicitList": ["take-photo-title", "take-photo-subtitle"] }} }} }} }},
+ {{ "id": "take-photo-title", "component": {{ "Heading": {{ "level": 4, "text": {{ "literalString": "Take a Photo" }} }} }} }},
+ {{ "id": "take-photo-subtitle", "component": {{ "Text": {{ "text": {{ "literalString": "Capture your space directly from the app." }} }} }} }},
+
+ {{ "id": "choose-library-card", "component": {{ "Card": {{ "child": "choose-library-row" }} }} }},
+ {{ "id": "choose-library-row", "component": {{ "Row": {{ "distribution": "start", "alignment": "center", "children": {{ "explicitList": ["choose-library-icon", "choose-library-column"] }} }} }} }},
+ {{ "id": "choose-library-icon", "component": {{ "Icon": {{ "name": {{ "literalString": "photo-library" }} }} }} }},
+ {{ "id": "choose-library-column", "component": {{ "Column": {{ "children": {{ "explicitList": ["choose-library-title", "choose-library-subtitle"] }} }} }} }},
+ {{ "id": "choose-library-title", "component": {{ "Heading": {{ "level": 4, "text": {{ "literalString": "Choose from Library" }} }} }} }},
+ {{ "id": "choose-library-subtitle", "component": {{ "Text": {{ "text": {{ "literalString": "Select a photo from your phone's gallery." }} }} }} }},
+
+ {{ "id": "tips-row", "component": {{ "Row": {{ "distribution": "center", "alignment": "center", "children": {{ "explicitList": ["tips-icon", "tips-text"] }} }} }} }},
+ {{ "id": "tips-icon", "component": {{ "Icon": {{ "name": {{ "literalString": "lightbulb" }} }} }} }},
+ {{ "id": "tips-text", "component": {{ "Text": {{ "text": {{ "literalString": "Tips for the best photo" }} }} }} }},
+
+ {{ "id": "upload-photo-button", "component": {{ "Button": {{ "child": "upload-photo-text", "primary": true, "action": {{ "name": "submit_details", "context": [
+ {{ "key": "yardDescription", "value": {{ "literalString": "Photo of an old backyard with a concrete patio and weeds." }} }},
+ {{ "key": "imageUrl", "value": {{ "literalString": "{base_url}/images/old_backyard.png" }} }}
+ ] }} }} }} }},
+ {{ "id": "upload-photo-text", "component": {{ "Text": {{ "text": {{ "literalString": "Upload Your Photo" }} }} }} }}
+ ]
+ }} }}
+]
+---END PROJECT_DETAILS_EXAMPLE---
+
+---BEGIN QUESTIONNAIRE_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "questionnaire", "root": "question-column", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "questionnaire",
+ "components": [
+ {{ "id": "question-column", "component": {{ "Column":{{ "alignment": "stretch", "children": {{ "explicitList": [
+ "user-photo",
+ "q-entertain-slider-title",
+ "q-entertain-slider",
+ "q-preserve-bushes-check",
+ "q-patio-title",
+ "q-patio-options",
+ "q-submit-button"
+ ] }} }} }} }},
+
+ {{ "id": "user-photo", "component": {{ "Image": {{ "url": {{ "path": "imageUrl" }}, "fit": "cover" }} }} }},
+
+ {{ "id": "q-entertain-slider-title", "component": {{ "Heading": {{ "level": "5", "text": {{ "literalString": "Outdoor entertaining size (number of people)" }} }} }} }},
+ {{ "id": "q-entertain-slider", "component": {{ "Slider": {{ "value": {{ "path": "guestCount" }}, "minValue": 2, "maxValue": 12 }} }} }},
+
+ {{ "id": "q-preserve-bushes-check", "component": {{ "CheckBox": {{ "label": {{ "literalString": "Preserve established bushes/trees?" }}, "value": {{ "path": "preserveBushes" }} }} }} }},
+
+ {{ "id": "q-patio-title", "component": {{ "Heading": {{ "level": "5", "text": {{ "literalString": "That concrete patio... what's the plan?" }} }} }} }},
+ {{ "id": "q-patio-options", "component": {{ "MultipleChoice": {{
+ "selections": {{ "path": "patioPlan" }},
+ "maxAllowedSelections": 1,
+ "options": [
+ {{ "label": {{ "literalString": "Preserve existing paving" }}, "value": "preserve" }},
+ {{ "label": {{ "literalString": "Replace with lawn" }}, "value": "lawn" }},
+ {{ "label": {{ "literalString": "Replace with decking + lawn" }}, "value": "decking" }}
+ ]
+ }} }} }},
+
+ {{ "id": "q-submit-button", "component": {{ "Button": {{ "child": "q-submit-button-text", "primary": true, "action": {{ "name": "submit_questionnaire", "context": [
+ {{ "key": "preserveBushes", "value": {{ "path": "preserveBushes" }} }},
+ {{ "key": "guestCount", "value": {{ "path": "guestCount" }} }},
+ {{ "key": "patioPlan", "value": {{ "path": "patioPlan" }} }}
+ ] }} }} }} }},
+ {{ "id": "q-submit-button-text", "component": {{ "Text": {{ "text": {{ "literalString": "Next Page" }} }} }} }}
+ ]
+ }} }},
+ {{ "dataModelUpdate": {{
+ "surfaceId": "questionnaire",
+ "path": "/",
+ "contents": [
+ {{ "key": "imageUrl", "valueString": "" }},
+ {{ "key": "preserveBushes", "valueBoolean": true }},
+ {{ "key": "guestCount", "valueNumber": 4 }},
+ {{ "key": "patioPlan", "valueArray": ["preserve"] }}
+ ]
+ }} }}
+]
+---END QUESTIONNAIRE_EXAMPLE---
+
+---BEGIN OPTIONS_PRESENTATION_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "options", "root": "options-column", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "options",
+ "components": [
+ {{ "id": "options-column", "component": {{ "Column": {{ "children": {{ "explicitList": ["options-row"] }} }} }} }},
+
+ {{ "id": "options-row", "component": {{ "Column": {{ "children": {{ "explicitList": ["option-card-1", "option-card-2"] }} }} }} }},
+
+ {{ "id": "option-card-1", "weight": 1, "component": {{ "Card": {{ "child": "option-layout-1" }} }} }},
+ {{ "id": "option-layout-1", "component": {{ "Column": {{ "alignment": "center", "distribution": "center", "children": {{ "explicitList": ["option-image-1", "option-details-1"] }} }} }} }},
+ {{ "id": "option-image-1", "component": {{ "Image": {{ "url": {{ "path": "/items/option1/imageUrl" }}, "fit": "cover" }} }} }},
+ {{ "id": "option-details-1", "component": {{ "Column": {{ "alignment": "stretch","distribution": "center", "children": {{ "explicitList": ["option-name-1", "option-price-1", "option-time-1", "option-detail-1", "option-tradeoffs-1", "select-button-1"] }} }} }} }},
+ {{ "id": "option-name-1", "component": {{ "Heading": {{ "level": "4", "text": {{ "path": "/items/option1/name" }} }} }} }},
+ {{ "id": "option-price-1", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "/items/option1/price" }} }} }} }},
+ {{ "id": "option-time-1", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "/items/option1/time" }} }} }} }},
+ {{ "id": "option-detail-1", "component": {{ "Text": {{ "text": {{ "path": "/items/option1/detail" }} }} }} }},
+ {{ "id": "option-tradeoffs-1", "component": {{ "Text": {{ "text": {{ "path": "/items/option1/tradeoffs" }} }} }} }},
+ {{ "id": "select-button-1", "component": {{ "Button": {{ "primary": true, "child": "select-text-1", "action": {{ "name": "select_option", "context": [ {{ "key": "optionName", "value": {{ "path": "/items/option1/name" }} }}, {{ "key": "optionPrice", "value": {{ "path": "/items/option1/price" }} }} ] }} }} }} }},
+ {{ "id": "select-text-1", "component": {{ "Text": {{ "text": {{ "literalString": "Select This Option" }} }} }} }},
+
+ {{ "id": "option-card-2", "weight": 1, "component": {{ "Card": {{ "child": "option-layout-2" }} }} }},
+ {{ "id": "option-layout-2", "component": {{ "Column": {{ "alignment": "center", "distribution": "center", "children": {{ "explicitList": ["option-image-2", "option-details-2"] }} }} }} }},
+ {{ "id": "option-image-2", "component": {{ "Image": {{ "url": {{ "path": "/items/option2/imageUrl" }}, "fit": "cover" }} }} }} }},
+ {{ "id": "option-details-2", "component": {{ "Column": {{ "alignment": "stretch","distribution": "center", "children": {{ "explicitList": ["option-name-2", "option-price-2", "option-time-2", "option-detail-2", "option-tradeoffs-2", "select-button-2"] }} }} }} }},
+ {{ "id": "option-name-2", "component": {{ "Heading": {{ "level": "4", "text": {{ "path": "/items/option2/name" }} }} }} }},
+ {{ "id": "option-price-2", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "/items/option2/price" }} }} }} }},
+ {{ "id": "option-time-2", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "/items/option2/time" }} }} }} }},
+ {{ "id": "option-detail-2", "component": {{ "Text": {{ "text": {{ "path": "/items/option2/detail" }} }} }} }},
+ {{ "id": "option-tradeoffs-2", "component": {{ "Text": {{ "text": {{ "path": "/items/option2/tradeoffs" }} }} }} }},
+ {{ "id": "select-button-2", "component": {{ "Button": {{ "primary": true, "child": "select-text-2", "action": {{ "name": "select_option", "context": [ {{ "key": "optionName", "value": {{ "path": "/items/option2/name" }} }}, {{ "key": "optionPrice", "value": {{ "path": "/items/option2/price" }} }} ] }} }} }} }},
+ {{ "id": "select-text-2", "component": {{ "Text": {{ "text": {{ "literalString": "Select This Option" }} }} }} }}
+ ]
+ }} }},
+ {{ "dataModelUpdate": {{
+ "surfaceId": "options",
+ "path": "/",
+ "contents": [
+ {{ "key": "items", "valueMap": [
+ {{ "key": "option1", "valueMap": [
+ {{ "key": "name", "valueString": "Modern Zen Garden" }},
+ {{ "key": "detail", "valueString": "Low maintenance, drought-tolerant plants..." }},
+ {{ "key": "imageUrl", "valueString": "{base_url}/images/zen_garden.png" }},
+ {{ "key": "price", "valueString": "Est. $5,000 - $8,000" }},
+ {{ "key": "time", "valueString": "Est. 2-3 weeks" }},
+ {{ "key": "tradeoffs", "valueString": "Higher upfront cost, less floral variety." }}
+ ] }},
+ {{ "key": "option2", "valueMap": [
+ {{ "key": "name", "valueString": "English Cottage Garden" }},
+ {{ "key": "detail", "valueString": "Vibrant, colorful, and teeming with life..." }},
+ {{ "key": "imageUrl", "valueString": "{base_url}/images/cottage_garden.png" }},
+ {{ "key": "price", "valueString": "Est. $3,000 - $6,000" }},
+ {{ "key": "time", "valueString": "Est. 4-6 weeks" }},
+ {{ "key": "tradeoffs", "valueString": "Higher maintenance (watering/weeding), seasonal changes.\\n" }}
+ ] }}
+ ] }}
+ ]
+ }} }}
+]
+---END OPTIONS_PRESENTATION_EXAMPLE---
+
+---BEGIN SHOPPING_CART_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "cart", "root": "cart-card", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "cart",
+ "components": [
+ {{ "id": "cart-card", "weight": 1, "component": {{ "Card": {{ "child": "cart-column" }} }} }},
+ {{ "id": "cart-column", "component": {{ "Column": {{ "alignment": "stretch", "children": {{ "explicitList": ["cart-subtitle", "item-list", "total-price", "checkout-button"] }} }} }} }},
+ {{ "id": "cart-subtitle", "component": {{ "Heading": {{ "level": "4", "text": {{ "path": "optionName" }} }} }} }},
+ {{ "id": "item-list", "component": {{ "List": {{ "direction": "vertical", "children": {{ "template": {{ "componentId": "item-template", "dataBinding": "/cartItems" }} }} }} }} }},
+ {{ "id": "item-template", "component": {{ "Row": {{ "distribution": "spaceBetween", "children": {{ "explicitList": ["template-item-name", "template-item-price"] }} }} }} }},
+ {{ "id": "template-item-name", "component": {{ "Text": {{ "text": {{ "path": "name" }} }} }} }},
+ {{ "id": "template-item-price", "component": {{ "Text": {{ "text": {{ "path": "price" }} }} }} }},
+ {{ "id": "total-price", "component": {{ "Heading": {{ "level": "4", "text": {{ "path": "totalPrice" }} }} }} }},
+ {{ "id": "checkout-button", "component": {{ "Button": {{ "child": "checkout-text", "primary": true, "action": {{ "name": "checkout", "context": [ {{ "key": "optionName", "value": {{ "path": "optionName" }} }}, {{ "key": "totalPrice", "value": {{ "path": "totalPrice" }} }} ] }} }} }} }},
+ {{ "id": "checkout-text", "component": {{ "Text": {{ "text": {{ "literalString": "Purchase" }} }} }} }}
+ ]
+ }} }},
+ {{ "dataModelUpdate": {{
+ "surfaceId": "cart",
+ "path": "/",
+ "contents": [
+ {{ "key": "optionName", "valueString": "Modern Zen Garden" }},
+ {{ "key": "totalPrice", "valueString": "Total: $7,500.00" }},
+ {{ "key": "cartItems", "valueMap": [
+ {{ "key": "item1", "valueMap": [ {{ "key": "name", "valueString": "Zen Design Service" }}, {{ "key": "price", "valueString": "$2,000" }} ] }},
+ {{ "key": "item2", "valueMap": [ {{ "key": "name", "valueString": "River Rocks (5 tons)" }}, {{ "key": "price", "valueString": "$1,500" }} ] }},
+ {{ "key": "item3", "valueMap": [ {{ "key": "name", "valueString": "Japanese Maple Tree" }}, {{ "key": "price", "valueString": "$500" }} ] }},
+ {{ "key": "item4", "valueMap": [ {{ "key": "name", "valueString": "Drought-Tolerant Shrubs" }}, {{ "key": "price", "valueString": "$1,000" }} ] }},
+ {{ "key": "item5", "valueMap": [ {{ "key": "name", "valueString": "Labor & Installation" }}, {{ "key":"price", "valueString": "$2,500" }} ] }}
+ ] }}
+ ]
+ }} }}
+]
+---END SHOPPING_CART_EXAMPLE---
+
+---BEGIN ORDER_CONFIRMATION_EXAMPLE---
+[
+ {{ "beginRendering": {{ "surfaceId": "confirmation", "root": "confirmation-card", "styles": {{ "primaryColor": "#228B22", "font": "Roboto" }} }} }},
+ {{ "surfaceUpdate": {{
+ "surfaceId": "confirmation",
+ "components": [
+ {{ "id": "confirmation-card", "weight": 1, "component": {{ "Card": {{ "child": "confirmation-column" }} }} }},
+ {{ "id": "confirmation-column", "component": {{ "Column": {{ "alignment": "stretch", "children": {{ "explicitList": ["confirm-icon", "details-column", "confirm-next-steps"] }} }} }} }},
+ {{ "id": "confirm-icon", "component": {{ "Icon": {{ "name": {{ "literalString": "check" }} }} }} }},
+ {{ "id": "details-column", "component": {{ "Column": {{ "alignment": "stretch", "children": {{ "explicitList": ["design-name-row", "price-row", "order-number-row"] }} }} }} }},
+ {{ "id": "design-name-row", "component": {{ "Row": {{ "children": {{ "explicitList": ["design-name-label", "design-name-value"] }} }} }} }},
+ {{ "id": "design-name-label", "component": {{ "Heading": {{ "level": "5", "text": {{ "literalString": "Design: " }} }} }} }},
+ {{ "id": "design-name-value", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "designName" }} }} }} }},
+ {{ "id": "price-row", "component": {{ "Row": {{ "children": {{ "explicitList": ["price-label", "price-value"] }} }} }} }},
+ {{ "id": "price-label", "component": {{ "Heading": {{ "level": "5", "text": {{ "literalString": "Price: " }} }} }} }},
+ {{ "id": "price-value", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "price" }} }} }} }},
+ {{ "id": "order-number-row", "component": {{ "Row": {{ "children": {{ "explicitList": ["order-number-label", "order-number-value"] }} }} }} }},
+ {{ "id": "order-number-label", "component": {{ "Heading": {{ "level": "5", "text": {{ "literalString": "Order #: " }} }} }} }},
+ {{ "id": "order-number-value", "component": {{ "Heading": {{ "level": "5", "text": {{ "path": "orderNumber" }} }} }} }},
+ {{ "id": "confirm-next-steps", "component": {{ "Text": {{ "text": {{ "literalString": "Our design team will contact you within 48 hours to schedule an on-site consultation." }} }} }} }}
+ ]
+ }} }},
+ {{ "dataModelUpdate": {{
+ "surfaceId": "confirmation",
+ "path": "/",
+ "contents": [
+ {{ "key": "designName", "valueString": "Modern Zen Garden" }},
+ {{ "key": "price", "valueString": "$7,500.00" }},
+ {{ "key": "orderNumber", "valueString": "#LSC-12345" }}
+ ]
+ }} }}
+]
+---END ORDER_CONFIRMATION_EXAMPLE---
+"""
diff --git a/packages/flutter_genui/lib/src/core/genui_manager.dart b/packages/flutter_genui/lib/src/core/genui_manager.dart
index 9c5427299..daabf84b9 100644
--- a/packages/flutter_genui/lib/src/core/genui_manager.dart
+++ b/packages/flutter_genui/lib/src/core/genui_manager.dart
@@ -205,7 +205,6 @@ class GenUiManager implements GenUiHost {
);
final DataModel dataModel = dataModelForSurface(message.surfaceId);
dataModel.update(DataPath(path), message.contents);
- break;
case SurfaceDeletion():
final String surfaceId = message.surfaceId;
if (_surfaces.containsKey(surfaceId)) {
diff --git a/packages/flutter_genui_a2ui/pubspec.yaml b/packages/flutter_genui_a2ui/pubspec.yaml
index e3747f84e..d31dd3d57 100644
--- a/packages/flutter_genui_a2ui/pubspec.yaml
+++ b/packages/flutter_genui_a2ui/pubspec.yaml
@@ -14,14 +14,7 @@ environment:
resolution: workspace
dependencies:
- # Revert to the published version when the following PRs have landed:
- # https://github.com/shamblett/a2a/pull/53
- # https://github.com/shamblett/a2a/pull/52
- # a2a: ^3.0.0
- a2a:
- git:
- url: https://github.com/gspencergoog/shamblett_a2a.git
- ref: genui
+ a2a: ^3.1.0
flutter:
sdk: flutter
flutter_genui: ^0.4.0
diff --git a/packages/json_schema_builder/lib/src/schema_validation.dart b/packages/json_schema_builder/lib/src/schema_validation.dart
index 0f392f11d..ff466498c 100644
--- a/packages/json_schema_builder/lib/src/schema_validation.dart
+++ b/packages/json_schema_builder/lib/src/schema_validation.dart
@@ -651,7 +651,6 @@ extension SchemaValidation on Schema {
}
}
}
- break;
case JsonType.num:
case JsonType.int:
{
@@ -712,11 +711,9 @@ extension SchemaValidation on Schema {
}
}
}
- break;
case JsonType.boolean:
case JsonType.nil:
- // No specific keywords for bool or null besides generic ones.
- break;
+ // No specific keywords for bool or null besides generic ones.
}
return ValidationResult.fromErrors(errors, AnnotationSet.empty());
}
diff --git a/pubspec.yaml b/pubspec.yaml
index 9878c776c..c47698679 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -20,6 +20,7 @@ workspace:
- examples/custom_backend
- examples/simple_chat
- examples/travel_app
+ - examples/verdure/client
- tool/fix_copyright
- tool/test_and_fix