a2ui-project / a2ui-project/a2ui

[DOCS]: a2uiClientCapabilities format in v0.9 documentation and schema

Abierto Apto para principiantes
#2,476 0 comentarios 0 reacciones 0 asignados Ver en GitHub
component: specification P2 status: first-line-handled status: needs-triage type: bug
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

Abrir la 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

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.