a2ui-project / a2ui-project/a2ui

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

Ouverte Adaptée aux débutants
#2,476 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
component: specification P2 status: first-line-handled status: needs-triage type: bug
Langage dominant
TypeScript
Étoiles
16.4k
Forks
1.3k
Merge moyen
3 j 15 h
PR mergées (30 j)
134

Description

- [ ] 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.

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

L'issue indique trois emplacements : le fichier de schéma à l'emplacement specification/v0_9_1/json/client_capabilities.json et deux pages de documentation. Comparez les exemples pour voir l'écart entre le wrapper 'v0.9' et la clé 'a2uiClientCapabilities'. Mettez à jour le schéma et la documentation afin qu'ils correspondent au format canonique, en veillant à supprimer les virgules finales. Vérifiez les modifications en contrôlant la syntaxe JSON et la cohérence entre les fichiers.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
json, typescript
Domaine
documentation
Type d'issue
Documentation
Difficulté
1/5
Temps estimé
Moins d'une heure
Activité
Active
Clarté
Clairement spécifiée
Accessibilité débutants
85/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.