a2ui-project / a2ui-project/a2ui
[DOCS]: a2uiClientCapabilities format in v0.9 documentation and schema
- Lenguaje dominante
- TypeScript
- Estrellas
- 16.4k
- Forks
- 1.3k
- Merge medio
- 3 d 15 h
- PR fusionados (30 d)
- 134
Descripción
- [ ] I have searched the existing issues to make sure this documentation issue has not already been reported.
## Problem Page(s)
- `specification/v0_9_1/json/client_capabilities.json`
- https://a2ui.org/concepts/catalogs/#step-2-client-advertises-its-support-catalogs-required
- https://a2ui.org/concepts/actions/#advertising-capabilities
## Describe the Issue
I am validating `a2uiClientCapabilities` against the v0.9 schema, but the formats differ.
The schema and Actions documentation show:
```json
{
"v0.9": {
"supportedCatalogIds": ["..."]
}
}
```
The Catalogs documentation shows:
```json
{
"a2uiClientCapabilities": {
"supportedCatalogIds": ["..."]
}
}
```
Would love some clarity whether the `"v0.9"` wrapper is required.
## Proposed Changes
Update the schema and documentation examples to consistently show the canonical format and remove the trailing comma.
## Additional Context
This prevents clients from reliably validating the documented payload.
Guía de contribución
Línea de trabajo
El issue señala tres ubicaciones: el archivo de esquema en specification/v0_9_1/json/client_capabilities.json y dos páginas de documentación. Compara los ejemplos para ver la discrepancia entre el wrapper 'v0.9' y la clave 'a2uiClientCapabilities'. Actualiza el esquema y la documentación para que coincidan con el formato canónico, asegurándote de eliminar las comas finales. Verifica los cambios comprobando la sintaxis JSON y la coherencia entre los archivos.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- json, typescript
- Área
- documentation
- Tipo de issue
- Documentación
- Dificultad
- 1/5
- Tiempo estimado
- Menos de una hora
- Estado de actividad
- Activo
- Claridad
- Bien especificado
- Aptitud para principiantes
- 85/100