Skip to content

Commit 7ce5432

Browse files
committed
Mechanical: Apply formatting to codebase
1 parent c463f4c commit 7ce5432

1,091 files changed

Lines changed: 38008 additions & 31559 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gemini/GEMINI.md

Lines changed: 51 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -6,40 +6,40 @@ This document serves as a guide for using the Gemini agent within the A2UI repos
66

77
The A2UI repository is organized into several key directories:
88

9-
- `specification/`: Contains the A2UI protocol specifications.
10-
- `v0_8/`: The stable protocol version.
11-
- `docs/`: Human-readable documentation.
12-
- `json/`: JSON schema definitions.
13-
- `eval/`: Genkit-based evaluation framework.
14-
- `v0_9/`: The draft protocol version (in development).
15-
- `docs/`: Human-readable documentation.
16-
- `json/`: JSON schema definitions.
17-
- `eval/`: Genkit-based evaluation framework.
18-
- `v0_10/`: The proposed protocol version (next version).
19-
- `docs/`: Human-readable documentation.
20-
- `json/`: JSON schema definitions.
21-
- `eval/`: Genkit-based evaluation framework.
22-
- `samples/`: Contains sample implementations.
23-
- `agent/`:
24-
- `adk/`: Python-based ADK agent samples (e.g., `contact_lookup`, `restaurant_finder`, `rizzcharts`, `orchestrator`).
25-
- `mcp/`: MCP server sample (A2UI over MCP).
26-
- `client/`: Web client implementations.
27-
- `lit/`: Clients using Lit and Vite (e.g., `contact`, `shell`).
28-
- `angular/`: Clients using Angular (e.g., `contact`, `orchestrator`).
29-
- `personalized_learning/`: Personalized learning sample implementation.
30-
- `agent_sdks/`: Contains source code for Agent integrations.
31-
- `python/`: Python implementation of the A2UI agent library.
32-
- `kotlin/`: Kotlin implementation of the A2UI agent library.
33-
- `renderers/`: Contains renderer libraries.
34-
- `lit/`: The shared Lit renderer library used by the Lit clients.
35-
- `angular/`: The shared Angular renderer library used by the Angular clients.
36-
- `web_core/`: The shared core library used by web renderers.
37-
- `markdown/`: Markdown rendering utilities.
38-
- `tools/`: Helper tools for development.
39-
- `editor/`: A web-based editor for generating and visualizing A2UI.
40-
- `inspector/`: A web-based inspector for A2UI responses.
41-
- `composer/`: Visual composer tool.
42-
- `build_catalog/`: Catalog building utility.
9+
- `specification/`: Contains the A2UI protocol specifications.
10+
- `v0_8/`: The stable protocol version.
11+
- `docs/`: Human-readable documentation.
12+
- `json/`: JSON schema definitions.
13+
- `eval/`: Genkit-based evaluation framework.
14+
- `v0_9/`: The draft protocol version (in development).
15+
- `docs/`: Human-readable documentation.
16+
- `json/`: JSON schema definitions.
17+
- `eval/`: Genkit-based evaluation framework.
18+
- `v0_10/`: The proposed protocol version (next version).
19+
- `docs/`: Human-readable documentation.
20+
- `json/`: JSON schema definitions.
21+
- `eval/`: Genkit-based evaluation framework.
22+
- `samples/`: Contains sample implementations.
23+
- `agent/`:
24+
- `adk/`: Python-based ADK agent samples (e.g., `contact_lookup`, `restaurant_finder`, `rizzcharts`, `orchestrator`).
25+
- `mcp/`: MCP server sample (A2UI over MCP).
26+
- `client/`: Web client implementations.
27+
- `lit/`: Clients using Lit and Vite (e.g., `contact`, `shell`).
28+
- `angular/`: Clients using Angular (e.g., `contact`, `orchestrator`).
29+
- `personalized_learning/`: Personalized learning sample implementation.
30+
- `agent_sdks/`: Contains source code for Agent integrations.
31+
- `python/`: Python implementation of the A2UI agent library.
32+
- `kotlin/`: Kotlin implementation of the A2UI agent library.
33+
- `renderers/`: Contains renderer libraries.
34+
- `lit/`: The shared Lit renderer library used by the Lit clients.
35+
- `angular/`: The shared Angular renderer library used by the Angular clients.
36+
- `web_core/`: The shared core library used by web renderers.
37+
- `markdown/`: Markdown rendering utilities.
38+
- `tools/`: Helper tools for development.
39+
- `editor/`: A web-based editor for generating and visualizing A2UI.
40+
- `inspector/`: A web-based inspector for A2UI responses.
41+
- `composer/`: Visual composer tool.
42+
- `build_catalog/`: Catalog building utility.
4343

4444
## A2UI Specification Overview
4545

@@ -49,17 +49,17 @@ The A2UI protocol is a JSONL-based, streaming UI protocol designed to be easily
4949

5050
The core concepts of the A2UI protocol are detailed in the main specification document. Refer to the authoritative source for the current version (0.9):
5151

52-
- **A2UI Protocol Specification**: `@specification/v0_9/docs/a2ui_protocol.md`
52+
- **A2UI Protocol Specification**: `@specification/v0_9/docs/a2ui_protocol.md`
5353

5454
This document covers the design philosophy, architecture, data flow, and core concepts of the protocol.
5555

5656
### Schemas
5757

5858
The formal, machine-readable definitions of the protocol are maintained as JSON schemas. For version 0.9:
5959

60-
- **Server-to-Client Schema**: `@specification/v0_9/json/server_to_client.json`
61-
- **Client-to-Server Schema**: `@specification/v0_9/json/client_to_server.json`
62-
- **Basic Catalog**: `@specification/v0_9/json/basic_catalog.json`
60+
- **Server-to-Client Schema**: `@specification/v0_9/json/server_to_client.json`
61+
- **Client-to-Server Schema**: `@specification/v0_9/json/client_to_server.json`
62+
- **Basic Catalog**: `@specification/v0_9/json/basic_catalog.json`
6363

6464
## Running the Demos
6565

@@ -82,6 +82,7 @@ The Lit clients are located in `samples/client/lit/`.
8282

8383
1. **Build the Renderer**:
8484
First, ensure the shared renderers are built:
85+
8586
```bash
8687
cd renderers/markdown/markdown-it
8788
npm install
@@ -109,6 +110,7 @@ The Lit clients are located in `samples/client/lit/`.
109110
The Angular clients are located in `samples/client/angular/`.
110111

111112
First, ensure the shared renderers are built (if not already done):
113+
112114
```bash
113115
cd renderers/markdown/markdown-it
114116
npm install
@@ -124,6 +126,7 @@ npm run build
124126
```
125127

126128
Then run the Angular client:
129+
127130
```bash
128131
cd samples/client/angular
129132
npm install
@@ -132,25 +135,25 @@ npm start -- contact # Replace 'contact' with the desired project name (e.g., r
132135

133136
### Running Tools
134137

135-
- **Editor**: Located in `tools/editor`. Run with `npm install && npm run dev`.
136-
- Requires a Gemini API key in `.env` (`GEMINI_API_KEY=<key>`).
137-
- **Inspector**: Located in `tools/inspector`. Run with `npm install && npm run dev`.
138+
- **Editor**: Located in `tools/editor`. Run with `npm install && npm run dev`.
139+
- Requires a Gemini API key in `.env` (`GEMINI_API_KEY=<key>`).
140+
- **Inspector**: Located in `tools/inspector`. Run with `npm install && npm run dev`.
138141

139142
## Renderers
140143

141144
There are three renderers available for A2UI:
142145

143-
- **Web (Lit)**: Located in `renderers/lit`, this is the primary web renderer used by the demos in `web/`.
144-
- **Angular**: Located in `renderers/angular`, this is an alternative web renderer for Angular applications.
145-
- **Flutter**: The Flutter renderer is in a separate repository: [https://github.com/flutter/genui](https://github.com/flutter/genui). There is a placeholder renderer folder with a README.md file at `renderers/flutter`.
146+
- **Web (Lit)**: Located in `renderers/lit`, this is the primary web renderer used by the demos in `web/`.
147+
- **Angular**: Located in `renderers/angular`, this is an alternative web renderer for Angular applications.
148+
- **Flutter**: The Flutter renderer is in a separate repository: [https://github.com/flutter/genui](https://github.com/flutter/genui). There is a placeholder renderer folder with a README.md file at `renderers/flutter`.
146149

147150
## Keeping This Guide Updated
148151

149152
This document is intended to be a living guide for the repository. As the repository evolves, it's important to keep this file up-to-date. When making changes to the repository, please consider the following:
150153
151-
- **New Demos or Clients**: If you add a new demo or client in `samples/`, add it to the "Running the Demos" section.
152-
- **Specification Changes**: If you make significant changes to the A2UI protocol, ensure that the "A2UI Specification Overview" section is updated.
153-
- **Repository Structure Changes**: If you change the directory structure of the repository, update the "Repository Structure" section.
154+
- **New Demos or Clients**: If you add a new demo or client in `samples/`, add it to the "Running the Demos" section.
155+
- **Specification Changes**: If you make significant changes to the A2UI protocol, ensure that the "A2UI Specification Overview" section is updated.
156+
- **Repository Structure Changes**: If you change the directory structure of the repository, update the "Repository Structure" section.
154157
155158
To get this file back in sync, you can run the following commands:
156159
@@ -160,4 +163,4 @@ To get this file back in sync, you can run the following commands:
160163
161164
## Change descriptions
162165
163-
If you (the agent) are generating a pull request summary, pull request description, or change description, avoid flowery or hyperbolic terms (e.g. "significantly improves", "greatly enhances", "is an incredible improvement"). Be factual and avoid marketing language: you're not selling the PR, you're describing it.
166+
If you (the agent) are generating a pull request summary, pull request description, or change description, avoid flowery or hyperbolic terms (e.g. "significantly improves", "greatly enhances", "is an incredible improvement"). Be factual and avoid marketing language: you're not selling the PR, you're describing it.

.github/ISSUE_TEMPLATE/sprint-task.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,4 @@ about: An issue to track a task used in a sprint
44
title: ''
55
labels: P2, sprint ready
66
assignees: ''
7-
87
---
9-
10-

.github/workflows/auto-assignment.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,4 +41,4 @@ jobs:
4141
const fileUrl = pathToFileURL(filePath).href;
4242
4343
const importedModule = await import(fileUrl);
44-
await importedModule.default({ github, context });
44+
await importedModule.default({ github, context });

.github/workflows/docs.yml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,18 +19,18 @@ on:
1919
branches:
2020
- main
2121
paths:
22-
- ".github/workflows/docs.yml"
23-
- "requirements-docs.txt"
24-
- "mkdocs.yml"
25-
- "docs/**"
22+
- '.github/workflows/docs.yml'
23+
- 'requirements-docs.txt'
24+
- 'mkdocs.yml'
25+
- 'docs/**'
2626
pull_request:
2727
branches:
2828
- main
2929
paths:
30-
- ".github/workflows/docs.yml"
31-
- "requirements-docs.txt"
32-
- "mkdocs.yml"
33-
- "docs/**"
30+
- '.github/workflows/docs.yml'
31+
- 'requirements-docs.txt'
32+
- 'mkdocs.yml'
33+
- 'docs/**'
3434

3535
jobs:
3636
build_and_deploy:

.github/workflows/e2e_test.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,10 @@
55
name: E2E Tests
66

77
on:
8-
push:
8+
push:
99
# Workflow runs on push to any branch in the repo (not forks).
1010
schedule:
11-
- cron: "0 * * * *" # hourly
11+
- cron: '0 * * * *' # hourly
1212

1313
jobs:
1414
e2e_test:

.github/workflows/flutter_packages_test.yaml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ on:
1818
workflow_dispatch:
1919
push:
2020
branches:
21-
- main
21+
- main
2222
pull_request:
2323
branches:
2424
- main
@@ -77,9 +77,9 @@ jobs:
7777
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
7878
- uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654
7979
with:
80-
distribution: "zulu"
81-
java-version: "17"
82-
cache: "gradle"
80+
distribution: 'zulu'
81+
java-version: '17'
82+
cache: 'gradle'
8383
# Before bumping, verify the new version is on the flutter org's
8484
# enterprise actions allowlist, or CI will fail with startup_failure.
8585
- uses: subosito/flutter-action@fd55f4c5af5b953cc57a2be44cb082c8f6635e8e

.github/workflows/inspector_build.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ name: Inspector
1616

1717
on:
1818
push:
19-
branches: [ main ]
19+
branches: [main]
2020
paths:
2121
- 'tools/inspector/**'
2222
- 'renderers/lit/**'

.github/workflows/lit_build_and_test.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ name: Lit renderer
1616

1717
on:
1818
push:
19-
branches: [ main ]
19+
branches: [main]
2020
paths:
2121
- 'renderers/lit/**'
2222
- 'renderers/web_core/**'

.github/workflows/lit_samples_build.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ name: Lit samples
1616

1717
on:
1818
push:
19-
branches: [ main ]
19+
branches: [main]
2020
paths-ignore:
2121
- 'samples/agent/adk/**'
2222
pull_request:
@@ -46,5 +46,3 @@ jobs:
4646
- name: Build all lit samples workspaces
4747
working-directory: ./samples/client/lit
4848
run: npm run build --workspaces
49-
50-

.github/workflows/ng_build_and_test.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ name: Angular
1616

1717
on:
1818
push:
19-
branches: [ main ]
19+
branches: [main]
2020
paths-ignore:
2121
- 'samples/agent/adk/**'
2222
pull_request:

0 commit comments

Comments
 (0)