Skip to content

Conversation

@jacobsimionato
Copy link
Collaborator

This PR updates the v0.9 specification to include iconUrl and agentDisplayName in the standard catalog theme definition.

Changes

  • standard_catalog.json: Added iconUrl and agentDisplayName to the theme object.
  • a2ui_protocol.md: Added a Theme section under Standard Component Catalog to document these new properties and explain their usage for identifying sub-agents and ensuring security against impersonation in orchestrator scenarios.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds iconUrl and agentDisplayName to the theme definition in the v0.9 specification, enhancing agent identification and security. The changes are well-documented in both the protocol markdown file and the standard catalog JSON schema. My review includes a couple of minor suggestions to improve documentation consistency and fix a formatting issue in the markdown.

| :----------------- | :----- | :-------------------------------------------------------------------------------------------------------- |
| **primaryColor** | String | The primary UI color as a hexadecimal code (e.g., '#00BFFF'). |
| **iconUrl** | URI | A URL for an image (e.g., logo or avatar) that identifies the agent or tool associated with the surface. |
| **agentDisplayName**| String | Text to be displayed next to the surface to identify the agent or tool that created it (e.g. "Weather Bot").|

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

There's a minor formatting issue in the markdown table. The agentDisplayName property is missing a space before the closing pipe |, which might cause rendering issues in some markdown viewers. Adding a space will ensure the table is correctly formatted.

Suggested change
| **agentDisplayName**| String | Text to be displayed next to the surface to identify the agent or tool that created it (e.g. "Weather Bot").|
| **agentDisplayName** | String | Text to be displayed next to the surface to identify the agent or tool that created it (e.g. "Weather Bot").|

Comment on lines +742 to 750
"iconUrl": {
"type": "string",
"format": "uri",
"description": "A URL for an image that identifies the agent or tool associated with the surface."
},
"agentDisplayName": {
"type": "string",
"description": "Text to be displayed next to the surface to identify the agent or tool that created it."
}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with the documentation in a2ui_protocol.md, consider adding the examples to the descriptions of iconUrl and agentDisplayName. This provides more context for developers using the schema directly and ensures both documents are aligned.

Suggested change
"iconUrl": {
"type": "string",
"format": "uri",
"description": "A URL for an image that identifies the agent or tool associated with the surface."
},
"agentDisplayName": {
"type": "string",
"description": "Text to be displayed next to the surface to identify the agent or tool that created it."
}
"iconUrl": {
"type": "string",
"format": "uri",
"description": "A URL for an image (e.g., logo or avatar) that identifies the agent or tool associated with the surface."
},
"agentDisplayName": {
"type": "string",
"description": "Text to be displayed next to the surface to identify the agent or tool that created it (e.g. \"Weather Bot\")."
}


| Property | Type | Description |
| :----------------- | :----- | :-------------------------------------------------------------------------------------------------------- |
| **primaryColor** | String | The primary UI color as a hexadecimal code (e.g., '#00BFFF'). |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what this used for?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants