Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma de la configuration de l’espace de travail d’Aggrega

Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.

Identifiant du schéma : https://aggrega.ai/schemas/aggrega-config-v1beta1.schema.json

Fichier de configuration propre à chaque espace de travail, consommé par la CLI aggrega. Se trouve dans .aggrega-config.yaml. Le bloc workspace est le marqueur de racine : sa présence marque la racine de l’espace de travail, et il ne contient que des répertoires de catalogue. Toute autre clé est un réglage et se trouve au premier niveau, dans ces classes — d’où le contenu est récupéré, épinglé et mis en cache (sélection du registre, offline, comportement d’auto-pull et d’épinglage, emplacements et plafonds de taille des caches d’artefacts et de modules compilés), comment on fait confiance au contenu (signature, et comportement de la vérification des signatures), avec quelle rigueur la rédaction est jugée (réglages de lint par règle, rigueur vis-à-vis des dépréciations, et l’indication de la release de rédaction), quels plugins Wasm sont rattachés à l’ensemble de l’espace de travail (gouvernance, linter, importeur et liaisons de rendu du fournisseur par cible), et comment la CLI s’exécute (concurrence, service, et plafonds d’éviction du cache d’analyse du daemon). Les propriétés ci-dessous constituent la liste complète et faisant autorité ; ce résumé nomme les classes plutôt que les clés, de sorte que l’ajout d’une clé ne peut pas le rendre faux. Forme plate au premier niveau, sans enveloppe apiVersion/kind, distincte du contenu du catalogue. Discipline d’évolution du schéma : ajouter une nouvelle clé de premier niveau est une montée SemVer-MINOR (additive) ; supprimer ou déplacer une clé, ou resserrer une contrainte, est une rupture SemVer-MAJOR.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
workspaceobjectnonMarqueur de racine de l’espace de travail. Sa seule présence marque le répertoire comme racine de l’espace de travail ; il ne porte que les répertoires de catalogue qui définissent la racine — ceux de l’espace de travail lui-même, et ceux qu’une Release reçoit en propre. Tout réglage qui ne définit pas la racine se trouve au premier niveau plutôt qu’ici. Écrivez workspace: {} pour marquer une racine sans répertoires de catalogue embarqués.
default_registrystringnonRegistre OCI par défaut vers lequel les entités sont publiées et à partir duquel les dépendances sont résolues lorsqu’une entité ne nomme pas explicitement de registre : aggrega push y publie et aggrega pull y récupère. Vaut hub.aggrega.ai par défaut. Écrivez le name d’une entrée sous registries, qui représente alors le host de cette entrée ; l’hôte lui-même ; ou l’hôte suivi de / et d’un chemin de dépôt, comme ghcr.io/acme ou harbor.example.com/platform. Un nom est comparé en premier : une valeur qui est le name d’une entrée est l’hôte de cette entrée, même lorsqu’elle s’écrit aussi comme un hôte, de sorte que la publication, le pull, la vérification des signatures et chaque réglage de confiance propre à un registre utilisent ce seul hôte ; une valeur d’après laquelle deux entrées sont nommées est refusée comme ambiguë, et un nom suivi d’un chemin est refusé, car un nom représente l’hôte d’une entrée et non un emplacement sous celui-ci. Toute autre valeur doit être un hôte, écrit dans la graphie sous laquelle sa politique de confiance est conservée : un nom d’hôte en minuscules contenant un point (registry.example.com), localhost, un nom unique suivi d’un port (registry:5000), une adresse IPv4, ou une adresse IPv6 entre crochets ([::1]), chacun avec un :port facultatif et sans schéma, identifiants, espace ni majuscule — suivi éventuellement d’un chemin de dépôt : un ou plusieurs segments de lettres minuscules et de chiffres reliés par /, qui peuvent être séparés à l’intérieur d’un segment par ., _, __ ou des tirets, sans tag, digest ni / final. Le chemin est l’endroit où les choses sont publiées et récupérées : toute entité publiée via le registre par défaut est publiée sous <host>/<path>/, et toute entité résolue via celui-ci est récupérée à partir de là, de sorte que ce que l’un publie, l’autre le trouve. Il ne fait jamais partie de la manière dont on fait confiance à un registre : l’entrée registries dont la politique s’applique, une connexion, une exigence de signature et les identités de confiance sont toutes trouvées par le seul hôte. Le port 443 sur un hôte atteint via HTTPS est le port par défaut de cet hôte, et l’écrire est refusé, en nommant la graphie à écrire sans lui ; localhost et les autres adresses de loopback sont atteints via HTTP simple, donc 443 y est un port ordinaire et il est conservé. Une valeur vide ne nomme aucun registre par défaut. La valeur est jugée au chargement de la configuration plutôt que par ce schéma, car l’entrée à laquelle un nom fait référence peut être déclarée dans un autre fichier de configuration : elle est lue après chaque fichier de configuration et la variable d’environnement AGGREGA_DEFAULT_REGISTRY, et refusée dans les mêmes termes quel que soit celui d’entre eux qui l’a définie, en nommant ce fichier ou la variable. Le flag --registry qui nomme la destination d’une publication pour une seule invocation est comparé de la même manière aux noms des entrées ; toute autre valeur qu’il porte peut être une référence, et l’hôte que nomme cette référence est soumis à la même graphie et est l’endroit où la publication aboutit, sans chemin de dépôt. L’hôte est jugé sur sa seule graphie : le fait que le nom se résolve, ou qu’un registre y réponde, n’est pas vérifié. Par défaut : "hub.aggrega.ai"
offlinebooléennonLorsque la valeur est true, le build ne contacte aucun registre ; seuls les artefacts en cache et le contenu de catalogue embarqué sont consultés. Vaut false par défaut. Par défaut : false
auto_pullbooléennonLorsque la valeur est false (par défaut), aggrega build est en lecture seule : il n’écrit jamais d’épinglages de sources, et un fichier de verrouillage propre à la release manquant ou incomplet interrompt le build de façon bien visible avec un diagnostic indiquant d’exécuter d’abord aggrega pull --release <release>. Lorsque la valeur est true, aggrega build exécute une étape de pull dans le même processus avant le build — en résolvant les dépendances de la Release dans le fichier de verrouillage et le cache — de sorte qu’un premier build sur une Release ne nécessite pas d’étape de pull explicite. Le même choix explicite pour un seul build est disponible en ligne de commande sous la forme aggrega build --auto-pull ; pull reste le seul à écrire le fichier de verrouillage. offline: true ne désactive pas l’étape de pull : elle s’exécute sur ce que la machine détient déjà — le cache et les répertoires de catalogue locaux — sans atteindre de registre, et une référence que ni l’un ni l’autre ne détient interrompt le build avec le refus propre au pull, qui nomme cette référence. Par défaut : false
pin_sources_at_pullbooléennonLorsque la valeur est false (par défaut), un pull n’enregistre aucun épinglage à côté d’une entité : sur une Recipe ou une FeatureRecipe située dans l’un des répertoires de catalogue de cet espace de travail et que la Release construit, il s’interrompt lorsque l’entity.lock à côté de l’entité n’enregistre pas d’épinglage pour chaque élément que lit l’entité — une source: distante dont les coordonnées sont écrites en entier, un fichier qu’importe une entrée artifacts, ou chaque fichier d’une source: locale à côté de l’entité — en nommant l’entité, chaque élément et sa classe, ainsi que aggrega pin comme l’étape qui les enregistre. L’épinglage est l’étape de l’auteur de l’entité, de sorte qu’une entité que personne n’a épinglée n’est pas encore prête à être consommée. Lorsque la valeur est true, chaque pull de cet espace de travail exécute cette étape à la place, sur les mêmes entités, en écrivant les mêmes octets d’entity.lock que ceux qu’écrit aggrega pin ; c’est ainsi qu’un espace de travail qui consomme des entités que quelqu’un d’autre n’a pas épinglées enregistre leurs épinglages une seule fois au lieu de s’interrompre. Un build qui remplit son propre fichier de verrouillage est un pull et suit ce réglage. aggrega pull --pin-sources épingle pour une seule invocation et --pin-sources=false s’interrompt pour une seule invocation, quoi que dise ce réglage. Une entité résolue à partir du cache plutôt que d’un répertoire de catalogue n’a nulle part où écrire de verrou et n’est jamais épinglée ni retenue par un pull. Par défaut : false
pin_sources_at_pushbooléennonLorsque la valeur est true, chaque aggrega push de cet espace de travail exécute l’étape d’épinglage de l’auteur de l’entité sur l’entité qu’il publie avant de l’empaqueter, de sorte que l’entity.lock que l’étape écrit à côté de l’entité fait partie de ce qui est publié ; lorsque la valeur est false (par défaut), push n’exécute aucune étape d’épinglage et refuse une Recipe ou une FeatureRecipe dont l’entity.lock n’enregistre pas chaque épinglage que cette étape enregistrerait, en nommant aggrega pin. L’étape écrit à côté de l’entité, elle ne s’exécute donc que là où l’entité dispose d’un emplacement accessible en écriture, ce qu’un push a toujours : il publie une entité nommée par son document. aggrega push --pin-sources épingle pour une seule invocation et --pin-sources=false non, quoi que dise ce réglage. C’est la même étape que celle qu’exécute aggrega pin, qui écrit les mêmes octets. Par défaut : false
artifact_cache_dirstringnonRépertoire local du cache d’artefacts/de contenu (pulls depuis les registres, manifestes OCI, fixtures compilées). Vaut .aggrega/cache par défaut. Devrait être exclu via gitignore par convention. Le chemin est interprété relativement à la racine de l’espace de travail, quel que soit l’endroit d’où la commande est exécutée ; une valeur absolue est refusée au chargement de la configuration, car chaque lecteur de ce réglage le résout par rapport à cette racine et un chemin absolu nommerait un emplacement qu’ils n’atteignent jamais. Le cache peut se trouver à l’intérieur d’un répertoire de catalogue — c’est le cas de la valeur par défaut, puisqu’un répertoire de catalogue est couramment la racine de l’espace de travail — mais il ne doit pas EN ÊTRE un : un parcours du catalogue passe par-dessus le cache, de sorte qu’une valeur nommant un répertoire de catalogue exclut du parcours tout le contenu de ce répertoire. Une valeur nommant la racine de l’espace de travail elle-même (., ou toute graphie qui s’y ramène) est refusée au chargement de la configuration, exactement pour cette raison. Une valeur nommant tout autre répertoire de catalogue n’est pas refusée : elle se charge sans erreur et le parcours ne trouve ensuite rien dans ce répertoire, de sorte qu’il vous appartient de vérifier que le cache reste en dehors des répertoires listés dans workspace.catalog_dirs. Distinct de parse_cache, qui plafonne le cache d’analyse en mémoire du daemon, et de compiled_module_cache, qui plafonne le stockage de modules compilés à l’échelle de la machine. Par défaut : ".aggrega/cache"
skip_signature_verificationbooléennonDésactivation globale et bien visible de la vérification des signatures. Lorsque la valeur est true, la vérification des signatures est désactivée pour tous les registres, y compris la base de référence obligatoire du hub. Prévue pour les situations d’urgence (break-glass) et de développement ; elle n’est jamais silencieuse — partout où un pull aurait vérifié une signature, elle avertit que la vérification a été désactivée globalement. Vaut false par défaut. Par défaut : false
buildobjectnonRéglages de rigueur au moment du build et indications de rédaction. authoring_release fournit au LSP une indication current Release pour les diagnostics inline ; halt_on_deprecated_severity contrôle la manière dont le build réagit à la consommation d’entités dépréciées ; yaml_indent définit la largeur d’indentation de chaque artefact YAML rendu.
pluginsobjectnonRattachements des plugins Wasm au niveau de l’espace de travail. Chaque socket (gouvernance, linter, importeur) prend un tableau de références de plugins ; le build invoque la fonction d’entrée documentée de chaque plugin selon le contrat de son socket. La liste providers lie les capacités aux plugins de rendu du fournisseur qui les servent.
lintobjectnonRéglages de rigueur par règle.
parse_cacheobjectnonPlafonds d’éviction du cache d’analyse du daemon. Les deux plafonds s’appliquent simultanément — la boucle d’éviction LRU s’exécute après chaque insertion dans le cache et supprime les entrées les moins récemment utilisées jusqu’à ce que le nombre d’entrées et le total d’octets soient tous deux dans les limites. Zéro sur l’un ou l’autre signifie unbounded on that axis, utile pour les scénarios de CI où le cache ne vit que le temps d’une invocation. Distinct de artifact_cache_dir, qui est le cache de contenu sur disque.
compiled_module_cacheobjectnonPlafond de taille du cache de modules compilés sur disque, le stockage de code machine que le compilateur réutilise afin qu’un plugin Wasm soit compilé une fois par machine plutôt qu’une fois par build. Il est partagé entre tous les espaces de travail de la machine, cette clé a donc sa place dans le fichier de configuration global lorsque vous voulez une seule réponse pour toute la machine. Le plafond est appliqué une fois par invocation, avant le chargement de tout plugin, en supprimant des entrées entières en commençant par les plus anciennement compilées jusqu’à ce que le reste tienne — jamais pendant qu’un build compile. Supprimer une entrée coûte une recompilation ultérieure et rien d’autre, il est donc sans risque d’abaisser le plafond. aggrega cache status indique la taille actuelle du stockage, et aggrega cache evict --max-size le réduit à la demande à un plafond donné en ligne de commande. Distinct de artifact_cache_dir (contenu récupéré des registres) et de parse_cache (le cache d’analyse en mémoire du daemon).
concurrencyobjectnonRéglages de concurrence de la répartition des requêtes du daemon. Le daemon lit les requêtes depuis un unique flux stdin et exécute chacune via un pool de workers qui vide une file de requêtes bornée ; les réponses sont émises dans l’ordre d’arrivée des requêtes, quel que soit l’ordre d’achèvement.
serveobjectnonRéglages de comportement du daemon (aggrega serve) pour le compilateur en tant que service consommé par les intégrations d’IDE.
mcpobjectnonRéglages du serveur Model Context Protocol (aggrega mcp). transport choisit comment le serveur est atteint — via l’entrée et la sortie standard du processus, ou via HTTP — et il est lu quel que soit son choix. announce_tools est lui aussi lu sur les deux transports, car les outils proposés à un client sont une propriété du serveur plutôt que de la manière dont un client l’a atteint. Toute autre clé configure l’écouteur que démarre le transport HTTP et n’est pas utilisée tant que le serveur communique via l’entrée et la sortie standard — listen compris, qui n’y est lu que pour que le serveur puisse indiquer, en une ligne sur son flux d’erreur, que l’adresse n’est pas utilisée. Chaque clé ci-dessous indique de quel cas il s’agit. Distinct de serve, qui configure le daemon du backend de l’éditeur.
registriesRegistryConfig[]nonRéglages propres à chaque registre et politique de confiance des signatures, indexés par hôte de registre. Un registre non listé ici utilise les valeurs par défaut : une signature présente est vérifiée et une signature absente est tolérée, sauf pour hub.aggrega.ai, dont la base de référence intégrée exige une signature vérifiée même sans entrée explicite. Une entrée explicite pour un hôte remplace la base de référence de cet hôte. Par défaut : []
signingSigningConfignonBloc de signature de premier niveau, s’appliquant à tous les registres : les URL des services keyless, un chemin facultatif de clé pour la signature par clé, et la position de confiance commune à tous les registres (required et kinds). Un bloc signing propre à un registre remplace les valeurs par défaut des points de terminaison pour cet hôte et porte la même position required/kinds limitée à cet hôte — un nom, une fonction, la portée donnée par l’emplacement. La politique required/kinds de premier niveau se compose de façon monotone à travers la cascade de configurations. Sécurité : ce bloc ne contient aucun élément secret — le jeton d’identité OIDC n’est jamais un champ de configuration (il est fourni à l’exécution via un flag ou l’environnement OIDC ambiant) et key_path est le chemin d’un fichier de clé, jamais des octets de clé inline.

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.workspace

Marqueur de racine de l’espace de travail. Sa seule présence marque le répertoire comme racine de l’espace de travail ; il ne porte que les répertoires de catalogue qui définissent la racine — ceux de l’espace de travail lui-même, et ceux qu’une Release reçoit en propre. Tout réglage qui ne définit pas la racine se trouve au premier niveau plutôt qu’ici. Écrivez workspace: {} pour marquer une racine sans répertoires de catalogue embarqués.

PropriétéTypeObligatoireDescription
catalog_dirsstring[]nonRépertoires de catalogue facultatifs à partir desquels cet espace de travail lit les entités locales, consultés avant de se rabattre sur le registre. Chaque entrée est un chemin du système de fichiers, résolu relativement au fichier qui la déclare. La liste est une pile de recherche ordonnée où la première correspondance l’emporte : le répertoire listé le plus tôt qui déclare une identité en est propriétaire, et la même identité dans un répertoire ultérieur est masquée. Le répertoire catalog à la racine de l’espace de travail est lu également, après chaque entrée listée et seulement s’il existe — sauf si une entrée listée le contient déjà, auquel cas il est lu comme faisant partie de cette entrée — de sorte que lister un répertoire s’ajoute à ce que l’espace de travail lisait déjà au lieu de le remplacer. Omettre cette clé et l’écrire comme une liste vide sont deux déclarations différentes : si elle est omise, l’espace de travail lit toujours catalog ; si elle est écrite comme [], il ne lit aucun catalogue local, et c’est ainsi qu’un espace de travail indique qu’il n’en a pas. Une Release à laquelle sont donnés ses propres répertoires de catalogue sous releases lit ceux-ci à la place de cette liste. Portée racine : les répertoires de catalogue locaux appartiennent à cette racine de l’espace de travail, ils se trouvent donc sur le marqueur de racine plutôt qu’au premier niveau.
catalog_dirs_appendstring[]nonAjout facultatif, uniquement en fin de liste, à la liste catalog_dirs effective. À chaque niveau de priorité, les entrées indiquées ici sont concaténées à la liste de base résolue, ce qui permet aux configurations de l’espace de travail et globales de composer les répertoires de catalogue plutôt que de les masquer. Interaction au sein d’un même niveau : lorsque catalog_dirs et catalog_dirs_append sont tous deux spécifiés à un même niveau, la valeur résolue à ce niveau est la liste de base suivie de la liste ajoutée. Par défaut : []
releasesmap de ReleaseCatalogConfignonRépertoires de catalogue facultatifs propres à une Release, pour un espace de travail qui conserve côte à côte plusieurs variantes de catalogue et construit chaque Release avec l’une d’elles. Chaque clé est un fichier de Release, écrit comme un chemin relatif au fichier qui la déclare ; chaque valeur porte catalog_dirs et catalog_dirs_append avec la signification qu’ils ont dans ce bloc, limitée à cette seule Release. Une Release nommée ici lit son propre catalog_dirs à la place de la liste de ce bloc, suivi de son propre catalog_dirs_append ; une entrée qui omet catalog_dirs conserve la liste de ce bloc et y ajoute ensuite son catalog_dirs_append. L’ordre de recherche, le répertoire catalog à la racine de l’espace de travail et ce que signifie une liste vide sont les mêmes que pour la liste propre de ce bloc, et une Release que cette map ne nomme pas lit la liste de ce bloc exactement comme auparavant. La Release lit ces répertoires quelle que soit la manière dont elle est construite — dans un terminal, depuis un éditeur via aggrega serve, ou via aggrega mcp — et un répertoire --catalog est toujours parcouru avant eux pour une seule invocation. Une entrée nommant un fichier qui n’existe pas est refusée au chargement de la configuration, en nommant l’entrée et le fichier, de sorte que renommer une Release ne peut pas changer discrètement le catalogue avec lequel elle est construite. D’un fichier de configuration à l’autre, l’entrée de chaque Release se compose comme les clés propres de ce bloc : le catalog_dirs d’un fichier plus proche pour cette Release remplace celui d’un fichier plus éloigné, et le catalog_dirs_append de chaque fichier pour elle est ajouté dans l’ordre de la cascade. AGGREGA_CATALOG_DIRS définit la liste de ce bloc et n’atteint aucune entrée d’ici. Une opération qui ne concerne aucune Release en particulier — un lint ou une validation de tout le catalogue, la recherche d’une entité par son nom, ou la liste des entités de l’espace de travail dans un éditeur — lit la liste de ce bloc et non celles-ci.

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.build

Réglages de rigueur au moment du build et indications de rédaction. authoring_release fournit au LSP une indication current Release pour les diagnostics inline ; halt_on_deprecated_severity contrôle la manière dont le build réagit à la consommation d’entités dépréciées ; yaml_indent définit la largeur d’indentation de chaque artefact YAML rendu.

PropriétéTypeObligatoireDescription
authoring_releasestringnonChemin d’un fichier YAML de Release que le LSP traite comme le contexte current Release pour les diagnostics inline. Facultatif.
yaml_indentintegernonLargeur d’indentation (en espaces) de chaque artefact YAML rendu — fichiers docker-compose, modèles et valeurs des charts Helm, et manifestes Kubernetes. Vaut 2 par défaut, la largeur conventionnelle pour ces formats. Minimum : 2. Maximum : 9. Par défaut : 2
halt_on_deprecated_severitystring (enum)nonSévérité, dans l’ensemble ordonné warning < error < retracted, à partir de laquelle un marqueur de dépréciation enregistré interrompt le build. Elle régit les deux endroits où un marqueur est enregistré : le fichier de verrouillage, pour tout ce qu’un build reproduit octet pour octet, et l’enregistrement de confiance des plugins à côté de lui, pour un plugin rattaché dans un rôle qui renvoie un verdict d’acceptation ou de rejet — un rattachement plugins.governance à ir-verdict ou render-verdict, et chaque rattachement plugins.linter. Un réglage, une règle, les deux stockages. Non définie par défaut, et non définie signifie qu’aucun marqueur enregistré ne provoque d’interruption : un marqueur est enregistré sur une version que vous avez déjà épinglée, de sorte qu’un build qui a réussi une fois continue de réussir. La notification et la résolution sont deux axes distincts et aucun des deux n’est ce réglage. Chaque surface qui lit l’un ou l’autre enregistrement signale chaque référence dépréciée qu’elle épingle et chaque plugin de confiance portant un marqueur — à chaque sévérité — en nommant l’élément, sa sévérité et son message : aggrega build, aggrega validate --release, aggrega lint --release, le daemon destiné à l’éditeur, et les outils build, describe et validate natifs pour l’IA. Relever ce seuil ne réduit donc jamais ce qui vous est signalé. Ce réglage ne régit que le build : il arrête aggrega build (et l’outil build natif pour l’IA, qui est la même opération), tandis que les surfaces de signalement nomment le marqueur et poursuivent. Seul un marqueur retracted influe sur la version vers laquelle une référence se résout, et il le fait lorsque aggrega pull choisit une version, pas au build. Valeurs autorisées : "warning", "error", "retracted"

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.plugins

Rattachements des plugins Wasm au niveau de l’espace de travail. Chaque socket (gouvernance, linter, importeur) prend un tableau de références de plugins ; le build invoque la fonction d’entrée documentée de chaque plugin selon le contrat de son socket. La liste providers lie les capacités aux plugins de rendu du fournisseur qui les servent.

PropriétéTypeObligatoireDescription
governancePluginRef[]nonLes plugins du socket de gouvernance. Chaque entrée nomme le role de pipeline auquel elle est rattachée (annotation-transform, label-transform, ir-verdict ou render-verdict) ; le rôle fixe à la fois ce que le plugin peut émettre et sa fonction d’entrée par défaut (annotation-transform → transform_annotations ; label-transform → mutate ; ir-verdict → verdict_ir ; render-verdict → verdict_render). Par défaut : []
governance_appendPluginRef[]nonAjout, uniquement en fin de liste, à la liste governance effective. Les entrées indiquées ici sont concaténées à la liste de base résolue à chaque niveau de priorité, ce qui permet aux configurations de l’espace de travail et globales de composer les rattachements de gouvernance plutôt que de les masquer. Par défaut : []
linterPluginRef[]nonLes plugins du socket linter. Fonction d’entrée par défaut : lint_rules. Les exports d’un plugin linter doivent commencer par lint_, de sorte que function: sur l’une de ces entrées nomme un export portant ce préfixe. Par défaut : []
linter_appendPluginRef[]nonAjout, uniquement en fin de liste, à la liste linter effective. Même sémantique de composition sans masquage que governance_append. Par défaut : []
importerFixedEntryPluginRef[]nonLes plugins du socket importeur. Le socket appelle la fonction d’entrée import ; un rattachement n’en nomme pas. Par défaut : []
importer_appendFixedEntryPluginRef[]nonAjout, uniquement en fin de liste, à la liste importer effective. Même sémantique de composition sans masquage que governance_append. Par défaut : []
providersFixedEntryPluginRef[]nonSélections du fournisseur par capacité. Chaque entrée lie une capacité du fournisseur (le nom nu de la capacité qu’une Recipe lie via spec.capability, par ex. helm ou compose) à l’identité nue du plugin de rendu du fournisseur qui la sert (l’identité de l’entité Plugin, son metadata.pluginType et son metadata.name joints par une barre oblique, par ex. provider/helm), avec un :version final facultatif sous les trois mêmes formes qu’un épinglage de version (nu, exact :1.0.0, ou plage compatible avec la version majeure :^1.0.0). C’est la surface de désambiguïsation et de surcharge pour un catalogue fédéré où plus d’un plugin de fournisseur sert la même capacité : la liaison choisit le plugin de quel éditeur effectue le rendu de cette capacité. Lorsqu’une capacité est servie par exactement un plugin de fournisseur, aucune entrée n’est nécessaire. Exactement une entrée par capacité est autorisée dans l’ensemble de la liste composée ; une capacité en double interrompt la résolution de façon bien visible. La résolution a lieu au pull : le pull enregistre la liaison résolue dans le fichier de verrouillage propre à la Release, et le build lit le fichier de verrouillage — une modification ici après un pull n’est pas adoptée avant le pull suivant, de sorte que la sortie du build y est invariante (sortie déterministe). Chaque build et chaque validation d’une Release vérifie aussi chaque entrée d’ici, qu’une Recipe demande sa capacité ou non : une entrée nommant un plugin que le build détient et qui ne sert pas la capacité de l’entrée provoque une interruption, en nommant ce que sert ce plugin et une graphie à une modification près lorsqu’il en existe une ; une entrée nommant une capacité et aucun plugin, alors qu’aucun plugin de fournisseur lu par le build ne sert cette capacité, est signalée comme un avertissement au lieu de provoquer une interruption, car le plugin qui la sert peut être un plugin que seule une autre Release lit ; et une entrée pour une capacité qu’un plugin sert mais que cette Release ne demande jamais est légale et n’est pas signalée du tout, puisque les entrées sont écrites pour tout l’espace de travail et qu’un build porte sur une seule Release. Une capability contenant un deux-points est refusée au chargement de la configuration : le spec.capability d’une Recipe est lu comme la capacité jusqu’à son dernier deux-points, suivie d’un épinglage de version, de sorte qu’aucune Recipe ne pourrait atteindre une telle entrée. Une entrée manquante pour une capacité servie sans ambiguïté n’est pas une erreur ; une entrée manquante pour une capacité servie de manière ambiguë interrompt le pull de façon bien visible, en listant les plugins candidats. La coexistence des versions est préservée : la liaison choisit le dépôt de plugin par capacité, et l’épinglage de version dans le spec.capability propre à chaque Recipe choisit la version au sein de ce dépôt, de sorte que deux Recipes épinglant des versions différentes d’un même fournisseur coexistent toujours. Par défaut : []
providers_appendFixedEntryPluginRef[]nonAjout, uniquement en fin de liste, à la liste providers effective. Les entrées indiquées ici sont concaténées à la liste de base résolue à chaque niveau de priorité, ce qui permet aux configurations de l’espace de travail et globales de composer les liaisons du fournisseur plutôt que de les masquer. Même sémantique de composition sans masquage que governance_append. La règle d’une entrée par capacité s’applique à la liste composée, de sorte qu’une entrée ajoutée nommant une capacité déjà liée par un niveau inférieur interrompt la résolution de façon bien visible. Par défaut : []
cliCLIPluginRef[]nonLes plugins d’extension de la CLI installés comme commandes aggrega de premier niveau. Chaque entrée épingle un plugin de CLI par sa référence d’artefact résolue et épinglée à une version, et par le digest du contenu des octets du guest vers lesquels cette référence s’est résolue au moment de l’installation. Contrairement aux quatre listes de sockets transversales, dont la liste de base est remplacée en entier à travers la cascade de configurations, la liste de la CLI se compose : un plugin de CLI dans la configuration globale enregistre sa ou ses commandes dans chaque espace de travail, un plugin dans une configuration d’espace de travail ne s’enregistre que dans ce projet, et les deux s’enregistrent ensemble — elle n’a donc pas besoin d’un pendant _append. Les noms de commande et l’aide que fournit chaque plugin proviennent de l’autodescription du plugin lui-même, lue depuis le cache describe sur disque indexé par digest (un chargement du guest est la solution de repli lorsque le cache est froid) ; la liste ne porte que l’épinglage. À l’invocation de la commande, les octets résolus sont à nouveau hachés et comparés à digest ; une non-correspondance interrompt la commande de façon bien visible et indique de refaire l’épinglage, de sorte qu’un plugin dont les octets ont changé depuis son épinglage ne s’exécute jamais sans que cela se remarque. Par défaut : []

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.lint

Réglages de rigueur par règle.

PropriétéTypeObligatoireDescription
publishing_disciplineobjectnonCommutateurs à l’échelle de l’espace de travail pour l’ensemble de règles du linter de publication. Les flags allow_* assouplissent des contrôles dissuasifs individuels. L’immuabilité des artefacts n’est pas configurable ici : aggrega push refuse sans condition d’écraser une version publiée.

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.lint.publishing_discipline

Commutateurs à l’échelle de l’espace de travail pour l’ensemble de règles du linter de publication. Les flags allow_* assouplissent des contrôles dissuasifs individuels. L’immuabilité des artefacts n’est pas configurable ici : aggrega push refuse sans condition d’écraser une version publiée.

PropriétéTypeObligatoireDescription
allow_dynamic_refsbooléennonLorsque la valeur est true, le linter de publication accepte les constructions JSON Schema $dynamicRef / $dynamicAnchor dans le contenu du catalogue. Vaut false par défaut ; ces constructions sont déconseillées car elles rendent non locale la composition des schémas à la compilation. Par défaut : false
allow_id_overridesbooléennonLorsque la valeur est true, le linter de publication accepte les surcharges de $id sur les sous-schémas au sein du contenu de schéma d’une entité. Vaut false par défaut ; les surcharges de $id rompent la convention d’un identifiant canonique par schéma sur laquelle s’appuient à la fois le résolveur et le validateur JSON Schema. Par défaut : false
allow_direct_x_aggrega_extensionsbooléennonLorsque la valeur est true, le contrôle dissuasif au moment du build accepte les mots-clés x-aggrega-selector et x-aggrega-inject écrits directement dans le contenu du schéma. Vaut false par défaut ; le chemin de rédaction recommandé est usesSchema (pour les sockets de dépendance) ou featuresSchema (pour les liaisons d’identifiants), que le compilateur compose en ces mots-clés. Par défaut : false
allow_aggrega_ai_prefixbooléennonLorsque la valeur est true, le linter de publication accepte les clés d’annotation utilisant les espaces de noms réservés aggrega.ai/ et feature.aggrega.ai/ en dehors de leurs contextes canoniques. La règle des préfixes réservés contrôle les metadata.annotations des entités de catalogue : le préfixe nu aggrega.ai/ est natif de la plateforme (les clés d’annotation bien connues en sont exemptées quel que soit ce flag) ; le préfixe feature.aggrega.ai/ n’est canonique que sur le type Feature. Vaut false par défaut. Les opérateurs le définissent lorsque l’outillage d’entreprise doit légitimement utiliser un préfixe réservé ; il assouplit les deux préfixes ensemble. Par défaut : false
allow_nonstandard_namesbooléennonLorsque la valeur est true, le linter de publication accepte les noms d’entités de catalogue qui ne suivent pas les conventions de nommage documentées du projet. Vaut false par défaut ; un nommage cohérent est essentiel pour le résolveur, la sélection par labels et l’ergonomie des relecteurs. Par défaut : false
allow_category_mismatchesbooléennonLorsque la valeur est true, le linter de publication supprime la règle category-matches-directory. La convention du catalogue standard exige que les Components sous core// déclarent component.aggrega.ai/category={category} correspondant au segment de répertoire, où {category} est l’une des valeurs d’un ensemble fermé (comme ai-agent, ai-model, ai-tool, datastore, gateway, compute, …). Les espaces de travail ayant des exceptions persistantes légitimes s’en retirent ici. Vaut false par défaut. Par défaut : false
allow_undeclared_recipe_providesbooléennonLorsque la valeur est true, le linter de publication supprime la règle provides-declared-by-component. Cette règle signale chaque clé qu’une Recipe publie dans spec.provides et que le Component nommé par son spec.implements ne déclare pas dans le pilier provides de son spec.schema. Les deux sont des surfaces distinctes : ce qu’une Recipe publie est la valeur que reçoit un consommateur, tandis que ce que le Component déclare est le contrat de sortie par rapport auquel une référence inject from: est vérifiée — de sorte qu’une clé publiée sans être déclarée fait s’interrompre une telle référence. Une Recipe qui publie plus que ce que déclare son Component est par ailleurs acceptée au moment du build, c’est pourquoi le constat est indicatif plutôt qu’un refus de publier. Vaut false par défaut. Par défaut : false
allow_connection_credential_mismatchesbooléennonLorsque la valeur est true, le linter de publication supprime la règle connection-credential-matches-target-key, que aggrega lint --release exécute sur la Release qu’il nomme : la Release, l’Aggregate qu’elle déploie et les Components qu’utilisent les instances de cet Aggregate. Pour chaque connexion dont la cible déclare la clé qu’elle exige de ses appelants, la règle compare ce à quoi font référence les deux extrémités : l’identifiant que présente la connexion et la clé que la cible détient dans son propre emplacement. Elle signale deux extrémités nommant des secrets différents, ainsi qu’une clé déclarée à une seule extrémité, et elle ne cite jamais ni l’un ni l’autre. Aucune des deux extrémités ne peut voir les rattachements de l’autre, de sorte que les deux ne concordent que par discipline de rédaction — généralement un seul paramètre alimentant les deux — et un build les accepte dans les deux cas, c’est pourquoi le constat est indicatif. Un espace de travail dont les deux extrémités diffèrent délibérément s’en retire ici. Vaut false par défaut. Par défaut : false

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.parse_cache

Plafonds d’éviction du cache d’analyse du daemon. Les deux plafonds s’appliquent simultanément — la boucle d’éviction LRU s’exécute après chaque insertion dans le cache et supprime les entrées les moins récemment utilisées jusqu’à ce que le nombre d’entrées et le total d’octets soient tous deux dans les limites. Zéro sur l’un ou l’autre signifie unbounded on that axis, utile pour les scénarios de CI où le cache ne vit que le temps d’une invocation. Distinct de artifact_cache_dir, qui est le cache de contenu sur disque.

PropriétéTypeObligatoireDescription
max_entriesintegernonPlafond du nombre d’analyses en cache. Vaut 1000 par défaut. 0 désactive l’axe du nombre d’entrées (aucune éviction déclenchée par le nombre d’entrées). Minimum : 0. Par défaut : 1000
max_bytesintegernonPlafond de la taille cumulée, en octets, des documents que contient le cache. Vaut 100000000 (100 Mo) par défaut. 0 désactive l’axe des octets (aucune éviction déclenchée par le total d’octets). Minimum : 0. Par défaut : 100000000

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.compiled_module_cache

Plafond de taille du cache de modules compilés sur disque, le stockage de code machine que le compilateur réutilise afin qu’un plugin Wasm soit compilé une fois par machine plutôt qu’une fois par build. Il est partagé entre tous les espaces de travail de la machine, cette clé a donc sa place dans le fichier de configuration global lorsque vous voulez une seule réponse pour toute la machine. Le plafond est appliqué une fois par invocation, avant le chargement de tout plugin, en supprimant des entrées entières en commençant par les plus anciennement compilées jusqu’à ce que le reste tienne — jamais pendant qu’un build compile. Supprimer une entrée coûte une recompilation ultérieure et rien d’autre, il est donc sans risque d’abaisser le plafond. aggrega cache status indique la taille actuelle du stockage, et aggrega cache evict --max-size le réduit à la demande à un plafond donné en ligne de commande. Distinct de artifact_cache_dir (contenu récupéré des registres) et de parse_cache (le cache d’analyse en mémoire du daemon).

PropriétéTypeObligatoireDescription
max_bytesintegernonPlafond des octets que le cache de modules compilés occupe sur disque. Vaut 53687091200 (50 Gio) par défaut, une limite supérieure qui arrête une croissance illimitée plutôt qu’un budget destiné à se faire sentir — un seul plugin compilé atteint des centaines de mégaoctets, de sorte qu’une machine qui construit de nombreuses versions de plugins accumule des gigaoctets. Réglez-le au-dessus de ce que compile un build : le plafond est appliqué avant qu’un build ne compile quoi que ce soit, de sorte qu’un plafond inférieur à l’ensemble de travail d’un seul build fait que chaque build jette et recompile les mêmes modules, et le stockage cesse de faire gagner quoi que ce soit. Comme le plafond est appliqué en premier et que le build écrit ensuite ce qu’il compile, le stockage peut se trouver au-dessus du plafond entre deux builds ; il est de nouveau réduit au début du build suivant. 0 désactive le plafond (le stockage croît sans limite et rien n’est jamais supprimé automatiquement). Comme le stockage est un seul répertoire que partagent tous les espaces de travail, ce plafond n’est pas propre à chaque projet, même lorsque le fichier propre d’un projet le porte : la valeur se résout de la même manière que toute autre clé, le fichier le plus proche l’emportant, mais le stockage n’a toujours qu’une seule taille. Le plafond en vigueur est celui du build le plus récent, de sorte que deux projets qui le plafonnent différemment s’appliquent tous deux tour à tour, et un plafond bas dans l’un supprime le code machine que l’autre a compilé. Le définir une seule fois dans le fichier de configuration global est ce qui donne une seule réponse à toute la machine. aggrega config show --origin nomme le fichier dont provient la valeur effective de chaque réglage. Minimum : 0. Par défaut : 53687091200

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.concurrency

Réglages de concurrence de la répartition des requêtes du daemon. Le daemon lit les requêtes depuis un unique flux stdin et exécute chacune via un pool de workers qui vide une file de requêtes bornée ; les réponses sont émises dans l’ordre d’arrivée des requêtes, quel que soit l’ordre d’achèvement.

PropriétéTypeObligatoireDescription
pool_sizeintegernonNombre de workers qui servent la file de requêtes. Vaut 4 par défaut, ce qui répartit jusqu’à quatre requêtes simultanément ; définissez-le à 1 pour exécuter les requêtes en série dans l’ordre d’arrivée. Une valeur inférieure à 1 est portée à 1 au démarrage du daemon. Minimum : 1. Par défaut : 4

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.serve

Réglages de comportement du daemon (aggrega serve) pour le compilateur en tant que service consommé par les intégrations d’IDE.

PropriétéTypeObligatoireDescription
build_on_inspectbooléennonIndique si le daemon exécute l’étape de rendu des artefacts lors de l’inspection d’un graphe IR, de sorte que les avis que aggrega build émet pendant le rendu apparaissent aussi comme problèmes dans l’éditeur. Il n’ajoute aucune des vérifications sur lesquelles un build s’interrompt. Rien n’est écrit sur le disque dans un cas comme dans l’autre — aucun artefact rendu, aucun répertoire de sortie, aucun fichier de verrouillage — et l’étape de rendu ne modifie jamais le graphe, de sorte que, là où l’inspection répond avec un graphe, c’est le même graphe dans les deux cas. Vaut false par défaut, comme aggrega inspect : la commande du terminal n’atteint pas l’étape de rendu lors de l’inspection d’un graphe, elle n’émet donc pas non plus de tel avis, et une inspection dans l’éditeur qui n’en émet aucun vous montre la même chose que le terminal. Définissez-le à true pour demander à l’éditeur cette couche supplémentaire. Par défaut : false
lint_on_validatebooléennonIndique si le daemon exécute la vérification des conventions de publication lors de la validation d’une entité de catalogue, de sorte que les constats que aggrega lint signale sur cette entité apparaissent aussi comme problèmes dans l’éditeur. Les constats sont indicatifs : un document qui les suscite est tout de même validé, et sa Release est tout de même résolue et rendue. Seule la vérification qui lit le contenu local s’exécute — aucun registre n’est consulté, rien n’est récupéré et rien n’est écrit — et elle est évaluée sur le tampon que détient l’éditeur plutôt que sur le fichier sur disque, de sorte qu’un nom que vous corrigez cesse d’être signalé avant que vous n’enregistriez. Vaut false par défaut : une session de l’éditeur indique si un document est correct, et ne dit rien sur le fait qu’une entité soit publiable, jusqu’à ce que vous demandiez cette seconde couche. Définissez-le à true pour la demander. Indépendamment de cette clé, un éditeur peut toujours demander directement la vérification, et c’est aussi ainsi que l’on atteint la comparaison, avant publication, avec la version publiée précédemment. Par défaut : false

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp

Réglages du serveur Model Context Protocol (aggrega mcp). transport choisit comment le serveur est atteint — via l’entrée et la sortie standard du processus, ou via HTTP — et il est lu quel que soit son choix. announce_tools est lui aussi lu sur les deux transports, car les outils proposés à un client sont une propriété du serveur plutôt que de la manière dont un client l’a atteint. Toute autre clé configure l’écouteur que démarre le transport HTTP et n’est pas utilisée tant que le serveur communique via l’entrée et la sortie standard — listen compris, qui n’y est lu que pour que le serveur puisse indiquer, en une ligne sur son flux d’erreur, que l’adresse n’est pas utilisée. Chaque clé ci-dessous indique de quel cas il s’agit. Distinct de serve, qui configure le daemon du backend de l’éditeur.

PropriétéTypeObligatoireDescription
transportstring (enum)nonComment le serveur est atteint : stdio parle le protocole via l’entrée et la sortie standard du processus, et c’est ainsi que l’atteint un client qui lance la commande comme sous-processus ; http le sert en HTTP à l’adresse que nomme listen, et en HTTPS là où tls nomme un certificat et une clé. aggrega mcp --transport stdio|http remplace cette clé pour une seule invocation. Vaut stdio par défaut, de sorte qu’un espace de travail qui ne nomme jamais de transport est servi via l’entrée et la sortie standard, quoi que contienne par ailleurs ce bloc — un écouteur ne démarre que là où http est choisi, ici ou en ligne de commande. Toute autre valeur est refusée au chargement de la configuration. Définissez http dans la configuration d’un serveur que les appelants atteignent via le réseau, et laissez cette clé non définie là où un client lance lui-même le serveur : lorsque stdio est choisi, une adresse dans listen n’est pas utilisée, et le serveur le signale en une ligne sur son flux d’erreur. Valeurs autorisées : "stdio", "http" Par défaut : "stdio"
listenstringnonAdresse à laquelle l’écouteur se lie lorsque le transport HTTP est choisi. Elle nomme où écouter et ne choisit rien : le choix du transport revient à transport, et lorsque stdio est choisi, cette clé n’est pas utilisée. Deux formes sont acceptées : host:port pour une adresse TCP, et unix: suivi d’un chemin du système de fichiers pour un socket de domaine Unix. aggrega mcp --listen <address> remplace cette clé pour une seule invocation. Vide par défaut, et le transport HTTP a besoin d’une adresse provenant de l’un ou de l’autre : sans aucun des deux, un lancement qui le choisit est refusé avant toute liaison. Une adresse en clair — atteinte sans certificat ni clé sous tls — n’est acceptée que sur une adresse de loopback (127.0.0.1, ::1, ou localhost se résolvant vers l’une d’elles) ou sur un socket Unix, ce qui est la forme qu’utilise un serveur lorsqu’un proxy placé devant assure la terminaison TLS ; toute autre adresse est refusée avant toute liaison, en nommant mcp.tls.cert_file et mcp.tls.key_file. Ces deux mêmes formes sont les seules acceptées, avec ou sans certificat, là où authorization.trusted_proxy est défini, car un en-tête ne peut être considéré comme un identifiant digne de confiance que là où rien d’autre que le proxy ne peut le définir. Par défaut : ""
tlsobjectnonCertificat et clé pour assurer la terminaison TLS à l’intérieur du processus qui sert. Définissez les deux pour servir HTTPS directement depuis l’écouteur que nomme listen. Laissez les deux non définis pour servir en clair, ce qui limite listen à une adresse de loopback ou à un socket Unix — la forme à utiliser lorsqu’un proxy placé devant détient le certificat. Les deux clés sont des chemins vers des fichiers sur disque ; aucune ne contient de matériel de clé inline.
allowed_originsstring[]nonOrigines acceptées dans l’en-tête Origin d’une requête. Une requête dont l’en-tête Origin nomme une origine que cette liste ne contient pas est refusée avec 403 ; une requête qui nomme une origine listée, ou qui ne porte aucun en-tête Origin, est servie. Une entrée est comparée exactement à l’en-tête, de sorte que chacune s’écrit comme un navigateur envoie une origine : un schéma en minuscules, ://, un hôte en minuscules — un nom, une adresse IPv4, ou une adresse IPv6 entre crochets — et : avec le port lorsque ce n’est pas celui par défaut du schéma, sans rien après. Par exemple https://app.example.com ou http://localhost:3000. Une entrée de toute autre forme ne pourrait jamais être égale à ce qu’envoie un navigateur, elle est donc refusée au chargement du fichier de configuration, en nommant le fichier et l’entrée : une entrée avec un / final ou un chemin (https://app.example.com/), une entrée sans schéma (app.example.com), et une entrée contenant une majuscule ou une espace. Vide par défaut, de sorte qu’aucune origine n’est acceptée et que seul un appelant qui n’envoie aucun en-tête Origin est servi. Un client fonctionnant dans un navigateur a donc besoin que son origine soit listée ici ; un client qui n’est pas un navigateur n’envoie pas un tel en-tête et n’a besoin d’aucune entrée. Chaque entrée correspond au motif ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$. Par défaut : []
limitsobjectnonPlafonds que l’écouteur HTTP applique au trafic qu’il accepte, afin qu’un seul appelant ne puisse pas épuiser le processus qui sert. Ils limitent la taille que peut avoir une seule requête, le nombre de requêtes exécutées simultanément et la vitesse à laquelle un appelant peut envoyer. Aucun d’eux ne peut être désactivé.
authorizationobjectnonCe que ce serveur déclare au sujet des bearer tokens que présentent ses appelants : quel serveur d’autorisation les émet, l’adresse que ce serveur publie pour lui-même en tant que ressource pour laquelle ils sont émis, éventuellement un fichier à partir duquel lire les clés de vérification de ce serveur, et éventuellement les en-têtes que définit un proxy placé devant lorsque c’est ce proxy qui valide les jetons. issuer et resource sont obligatoires dès que le transport HTTP est choisi, et sans eux un écouteur est refusé avant toute liaison ; un serveur qui communique via l’entrée et la sortie standard n’en lit aucun. Les deux sont publiés dans le document de métadonnées OAuth de la ressource protégée que sert l’écouteur, qui est la seule réponse qu’un appelant HTTP reçoit sans qu’aucun identifiant ne lui soit demandé, car un client le lit pour savoir où obtenir un jeton. Ce bloc ne contient aucun élément secret : un jeton est présenté par un appelant sur la requête qu’il effectue et n’est jamais un champ de configuration, et jwks_file nomme des clés de vérification publiques plutôt que quoi que ce soit qui signe.
deny_reachstring (enum)[]nonTypes de portée que ce serveur ne propose pas, quoi que dise le jeton d’un appelant. Chaque opération déclare jusqu’où vont ses propres effets — none pour une opération qui lit ou rend et ne laisse rien derrière elle, workspace pour une opération qui écrit à l’intérieur de l’espace de travail que sert ce processus, registry pour une opération qui publie, signe ou retire, et machine pour une opération qui modifie ce que partagent tous les espaces de travail de l’hôte — et nommer un type ici retire de ce serveur tous les outils de ce type. Un outil retiré est absent de la liste des outils et de ce que répond describe-capabilities, pour tout appelant, et l’appeler malgré tout est refusé en nommant ce réglage, car aucun scope ne pourrait l’admettre. Vide par défaut, de sorte que le serveur propose tout ce que les scopes de ses appelants admettent. C’est une limite que le serveur s’impose à lui-même, en plus de la limite par appelant que fixent les scopes : un serveur qui sert des lectures et rien d’autre nomme ici les trois types qui écrivent et ne peut alors rien publier, même pour un appelant dont le jeton porte tous les scopes. Nommer machine est accepté et ne change rien — aucun outil de ce type n’est jamais proposé via HTTP, ce qui est une propriété du transport plutôt qu’un réglage. Lu au démarrage de l’écouteur : une valeur en dehors des quatre est refusée au chargement de la configuration, et la modifier nécessite un redémarrage. N’est pas lu du tout tant que le serveur communique via l’entrée et la sortie standard, où l’appelant est la personne qui a lancé le processus. Valeurs autorisées pour chaque entrée : "none", "workspace", "registry", "machine". Par défaut : []
announce_toolsstring[]nonOutils que ce serveur annonce, nommés exactement comme la liste des outils les indique. Si vous omettez la clé, tous les outils que propose ce serveur sont annoncés, ce qu’attend un client qui suit le protocole : il récupère toute la liste des outils et décide lui-même quelle part en présenter à un modèle. Si vous écrivez une liste, exactement ces outils sont annoncés — un outil laissé de côté est absent de la liste des outils, absent de ce que répond describe-capabilities, et refusé lorsqu’il est appelé par son nom, en nommant ce réglage. Si vous écrivez une liste vide, rien n’est annoncé. Définissez cette clé là où le client à l’autre bout plafonne le nombre d’outils qu’il enregistre — certains clients appliquent ce plafond à l’ensemble des serveurs auxquels ils sont connectés à la fois — et nommez les outils dont ce client a besoin. Elle restreint ce qui est annoncé et rien de plus : elle ne peut élargir ni deny_reach, qui retire purement et simplement une capacité, ni les scopes que porte le jeton d’un appelant. Un outil nommé ici d’un type que deny_reach retire reste hors de la liste des outils et est refusé lorsqu’il est appelé, en nommant ce dernier réglage ; un outil nommé ici que les scopes de l’appelant n’admettent pas est tout de même listé, et un appel à cet outil est refusé en nommant le scope qui l’admettrait. Chaque nom doit être celui d’un outil que propose ce binaire : un nom auquel aucun outil ne répond est refusé au démarrage du serveur, car sinon la personne qui a demandé une surface plus restreinte se verrait servir une surface différente sans que rien ne le signale. Un nom de la famille cli-, qui exécute une commande aggrega dans un processus distinct, est accepté sur les deux transports et n’annonce rien via HTTP, où aucun outil de ce type n’est proposé à aucun appelant. Lu sur les deux transports au démarrage du serveur, de sorte que l’ensemble annoncé est fixe pendant toute la vie du processus et que le modifier nécessite un redémarrage.
healthobjectnonEndroit où un superviseur demande si ce processus est vivant et s’il est prêt à répondre à un appel. Il est répondu aux deux vérifications sur une adresse qui leur est propre et jamais sur l’adresse que nomme listen : chaque requête vers le point de terminaison porte un bearer token, de sorte qu’une sonde à laquelle on répondrait là donnerait à tout ce qui peut atteindre le point de terminaison une lecture non authentifiée du processus, ainsi qu’un moyen gratuit de le faire travailler. Le point de terminaison répond à /healthz et /readyz avec le même 404 qu’il renvoie pour tout chemin qu’il ne sert pas, avec un jeton comme sans.

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp.tls

Certificat et clé pour assurer la terminaison TLS à l’intérieur du processus qui sert. Définissez les deux pour servir HTTPS directement depuis l’écouteur que nomme listen. Laissez les deux non définis pour servir en clair, ce qui limite listen à une adresse de loopback ou à un socket Unix — la forme à utiliser lorsqu’un proxy placé devant détient le certificat. Les deux clés sont des chemins vers des fichiers sur disque ; aucune ne contient de matériel de clé inline.

PropriétéTypeObligatoireDescription
cert_filestringnonChemin de la chaîne de certificats PEM que présente l’écouteur, lu au démarrage du processus. Se définit avec key_file. Vide par défaut, de sorte que l’écouteur sert en clair et que listen est limité à une adresse de loopback ou à un socket Unix. Par défaut : ""
key_filestringnonChemin de la clé privée PEM du certificat de cert_file, lu au démarrage du processus. Se définit avec ce réglage. Un chemin vers un fichier, jamais de matériel de clé inline. Vide par défaut, de sorte que l’écouteur sert en clair et que listen est limité à une adresse de loopback ou à un socket Unix. Par défaut : ""

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp.limits

Plafonds que l’écouteur HTTP applique au trafic qu’il accepte, afin qu’un seul appelant ne puisse pas épuiser le processus qui sert. Ils limitent la taille que peut avoir une seule requête, le nombre de requêtes exécutées simultanément et la vitesse à laquelle un appelant peut envoyer. Aucun d’eux ne peut être désactivé.

PropriétéTypeObligatoireDescription
max_body_bytesintegernonPlus grand corps de requête que l’écouteur accepte, en octets. Une requête dont le corps le dépasse est refusée avec 413, et le corps n’est pas lu au-delà du plafond. Vaut 4194304 (4 Mio) par défaut, ce qui se situe bien au-dessus d’un appel d’outil transportant un document de rédaction entier et bien en dessous de ce qui permettrait à un seul appelant d’occuper une part significative de la mémoire du processus. Le minimum est 1, il n’existe donc aucune valeur qui désactive le plafond ; augmentez-le là où les appelants envoient légitimement des documents plus volumineux. Minimum : 1. Par défaut : 4194304
max_concurrent_requestsintegernonNombre de requêtes que l’écouteur exécute simultanément. Une requête qui arrive alors que ce nombre est déjà en cours est refusée avec 503 plutôt que mise en file d’attente, de sorte qu’un appelant est invité à réessayer au lieu d’attendre derrière un travail qu’il ne peut pas voir. Vaut 16 par défaut, ce qui laisse de la place pour plusieurs appels d’outils simultanés tout en gardant un petit hôte réactif ; augmentez-le sur un hôte plus grand. Le minimum est 1, il n’existe donc aucune valeur qui désactive le plafond. Minimum : 1. Par défaut : 16
requests_per_minuteintegernonNombre de requêtes qu’un seul appelant peut envoyer par minute. Le décompte se fait par appelant plutôt que par serveur — par rapport au sujet que nomme le jeton de l’appelant, ou à l’identité qu’a affirmée un proxy de confiance — de sorte qu’un appelant très actif ne peut pas consommer le quota d’un autre. Un appelant peut en envoyer ce nombre en rafale ; le quota se reconstitue ensuite régulièrement, à raison d’une requête de plus toutes les 60 / requests_per_minute secondes, et une requête qui arrive alors qu’il n’en reste plus est refusée avec 429. Vaut 120 par défaut, soit deux par seconde en continu : bien au-delà de ce qu’envoie un assistant qui pilote un espace de travail, et tout de même une limite pour un client parti en boucle. Le minimum est 1, il n’existe donc aucune valeur qui désactive le plafond. Minimum : 1. Par défaut : 120

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp.authorization

Ce que ce serveur déclare au sujet des bearer tokens que présentent ses appelants : quel serveur d’autorisation les émet, l’adresse que ce serveur publie pour lui-même en tant que ressource pour laquelle ils sont émis, éventuellement un fichier à partir duquel lire les clés de vérification de ce serveur, et éventuellement les en-têtes que définit un proxy placé devant lorsque c’est ce proxy qui valide les jetons. issuer et resource sont obligatoires dès que le transport HTTP est choisi, et sans eux un écouteur est refusé avant toute liaison ; un serveur qui communique via l’entrée et la sortie standard n’en lit aucun. Les deux sont publiés dans le document de métadonnées OAuth de la ressource protégée que sert l’écouteur, qui est la seule réponse qu’un appelant HTTP reçoit sans qu’aucun identifiant ne lui soit demandé, car un client le lit pour savoir où obtenir un jeton. Ce bloc ne contient aucun élément secret : un jeton est présenté par un appelant sur la requête qu’il effectue et n’est jamais un champ de configuration, et jwks_file nomme des clés de vérification publiques plutôt que quoi que ce soit qui signe.

PropriétéTypeObligatoireDescription
issuerstringnonAdresse du serveur d’autorisation qui émet les jetons qu’accepte cet écouteur, écrite comme ce serveur indique son propre identifiant d’émetteur — par exemple https://login.example.com. Elle est publiée dans la liste authorization_servers du document de métadonnées de la ressource protégée, et c’est ainsi qu’un client apprend où obtenir un jeton pour cet écouteur. Vide par défaut, ce qui n’est pas une valeur utilisable : un écouteur est refusé avant toute liaison à moins que cette clé ne contienne une adresse complète, schéma et hôte compris. C’est une adresse https, sauf si le serveur d’autorisation s’exécute sur cette machine : http simple n’est accepté que pour un hôte de loopback, comme localhost, 127.0.0.1 ou ::1, et un émetteur en http simple sur tout autre hôte est refusé avant toute liaison, en nommant cette clé et en demandant une adresse https. Cela vaut que les clés soient lues depuis l’émetteur ou depuis jwks_file, ou qu’un trusted_proxy placé devant vérifie les jetons, car chaque client est envoyé vers l’émetteur pour obtenir son jeton. Par défaut : ""
resourcestringnonAdresse que ce serveur publie pour lui-même, telle qu’un appelant l’atteint — par exemple https://mcp.example.com/mcp. Écrivez l’adresse que les appelants utilisent réellement, y compris l’hôte que présente un proxy placé devant, car c’est l’identifiant qu’un client remet au serveur d’autorisation lorsqu’il demande un jeton pour ce serveur, et elle est publiée telle quelle comme champ resource du document de métadonnées de la ressource protégée. L’endroit où ce document est servi en est dérivé, en insérant /.well-known/oauth-protected-resource entre l’hôte et le chemin : un serveur publié comme https://mcp.example.com/mcp le sert à https://mcp.example.com/.well-known/oauth-protected-resource/mcp, et aussi à ce chemin well-known sans rien après, qui est l’endroit où un client regarde en second. Un jeton n’est accepté que lorsque cette adresse figure parmi les audiences qu’il nomme. Vide par défaut, ce qui n’est pas une valeur utilisable : un écouteur est refusé avant toute liaison à moins que cette clé ne contienne une adresse complète, schéma et hôte compris. Par défaut : ""
jwks_filestringnonChemin d’un fichier contenant le JSON Web Key Set par rapport auquel sont vérifiés les jetons qu’accepte ce serveur, lu au démarrage du processus. Vide par défaut, ce qui est le cas habituel : les clés sont lues depuis le serveur d’autorisation lui-même, en demandant à issuer où il les publie et en les récupérant à l’adresse qu’il nomme, et elles sont relues une fois lorsqu’arrive un jeton signé par un identifiant de clé que le jeu détenu ne contient pas. Définissez cette clé lorsque l’espace de travail est hors ligne, auquel cas un écouteur est refusé avant toute liaison sans elle, car un espace de travail hors ligne n’effectue aucune requête réseau et il n’existe aucun autre moyen d’obtenir les clés ; le fichier contient alors les seules clés acceptées, et le serveur d’autorisation n’est jamais contacté. Le fichier contient des clés de vérification publiques et jamais rien qui signe. Un chemin relatif se résout par rapport au répertoire du fichier de configuration qui l’a déclaré. Par défaut : ""
trusted_proxyobjectnonLit qui est un appelant à partir des en-têtes que définit un proxy placé devant, au lieu de valider ici un bearer token. Ne définissez cette clé que là où les deux conditions sont réunies : un proxy placé devant valide lui-même les jetons, et rien d’autre que ce proxy ne peut atteindre l’écouteur : lorsqu’elle est définie, listen doit être une adresse de loopback ou un socket Unix, et toute autre adresse est refusée avant toute liaison, en nommant les deux réglages. Un en-tête est digne de confiance exactement dans la mesure de l’ensemble des appelants qui peuvent le définir, et sur une adresse que le réseau atteint, chaque appelant peut définir n’importe quel en-tête, de sorte qu’un écouteur dans ce mode sur une telle adresse permettrait à chaque appelant de prétendre être n’importe qui. Lorsqu’elle est définie, aucun jeton n’est lu du tout — ni depuis l’en-tête Authorization, ni depuis ailleurs, et aucun jeu de clés n’est récupéré —, l’identité de l’appelant est la valeur de principal_header, une requête qui ne porte pas cet en-tête reçoit la réponse 401, et les deux en-têtes nommés ici sont les seuls lus. Omettez-la, ce qui est le comportement par défaut, et ce serveur valide lui-même les bearer tokens.

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp.authorization.trusted_proxy

Lit qui est un appelant à partir des en-têtes que définit un proxy placé devant, au lieu de valider ici un bearer token. Ne définissez cette clé que là où les deux conditions sont réunies : un proxy placé devant valide lui-même les jetons, et rien d’autre que ce proxy ne peut atteindre l’écouteur : lorsqu’elle est définie, listen doit être une adresse de loopback ou un socket Unix, et toute autre adresse est refusée avant toute liaison, en nommant les deux réglages. Un en-tête est digne de confiance exactement dans la mesure de l’ensemble des appelants qui peuvent le définir, et sur une adresse que le réseau atteint, chaque appelant peut définir n’importe quel en-tête, de sorte qu’un écouteur dans ce mode sur une telle adresse permettrait à chaque appelant de prétendre être n’importe qui. Lorsqu’elle est définie, aucun jeton n’est lu du tout — ni depuis l’en-tête Authorization, ni depuis ailleurs, et aucun jeu de clés n’est récupéré —, l’identité de l’appelant est la valeur de principal_header, une requête qui ne porte pas cet en-tête reçoit la réponse 401, et les deux en-têtes nommés ici sont les seuls lus. Omettez-la, ce qui est le comportement par défaut, et ce serveur valide lui-même les bearer tokens.

PropriétéTypeObligatoireDescription
principal_headerstringouiEn-tête dans lequel le proxy placé devant met l’identité de l’appelant — par exemple X-Forwarded-User. Il s’écrit comme un nom d’en-tête HTTP : lettres, chiffres et tirets, ainsi que les autres caractères qu’un nom d’en-tête peut contenir (!#$%&'*+.^_|~ et l’accent grave), sans espace, deux-points ni autre séparateur. Un nom de toute autre forme est refusé au chargement du fichier de configuration, en nommant le fichier et la clé, car aucune requête ne peut porter un tel en-tête. Un nom vide est refusé aussi : il laisserait ce serveur vérifier lui-même les jetons alors que le bloc indique qu’un proxy placé devant le fait. Pour laisser ce mode désactivé, omettez trusted_proxy. La valeur de l’en-tête est prise exactement telle qu’elle est écrite et n’est comparée à rien, de la même manière que le sujet d’un jeton que ce serveur valide lui-même est enregistré et n’est comparé à rien. C’est l’intégralité de l’identifiant dans ce mode, il est donc obligatoire dès que trusted_proxy est défini, et une requête qui arrive sans lui reçoit la réponse 401. Motif : ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$.
scopes_headerstringnonEn-tête dans lequel le proxy placé devant met les scopes accordés à l’appelant, séparés par des espaces — par exemple X-Forwarded-Scopes. Il s’écrit comme un nom d’en-tête HTTP, sous la même forme que principal_header, ou est laissé vide. Un nom de toute autre forme est refusé au chargement du fichier de configuration, en nommant le fichier et la clé, car aucune requête ne peut porter un tel en-tête et aucun appelant ne se verrait jamais accorder de scope. Vide par défaut, ce qui n’affirme aucun scope pour aucun appelant. Quel que soit son nom, aucun en-tête autre que celui-ci et principal_header n’est lu. Motif : ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. Par défaut : ""

Les propriétés supplémentaires ne sont pas autorisées.

aggrega-config.mcp.health

Endroit où un superviseur demande si ce processus est vivant et s’il est prêt à répondre à un appel. Il est répondu aux deux vérifications sur une adresse qui leur est propre et jamais sur l’adresse que nomme listen : chaque requête vers le point de terminaison porte un bearer token, de sorte qu’une sonde à laquelle on répondrait là donnerait à tout ce qui peut atteindre le point de terminaison une lecture non authentifiée du processus, ainsi qu’un moyen gratuit de le faire travailler. Le point de terminaison répond à /healthz et /readyz avec le même 404 qu’il renvoie pour tout chemin qu’il ne sert pas, avec un jeton comme sans.

PropriétéTypeObligatoireDescription
listenstringnonAdresse sur laquelle il est répondu aux vérifications de vivacité et de disponibilité, sous les deux mêmes formes que prend listen : host:port, ou unix: suivi d’un chemin du système de fichiers. Vide par défaut, de sorte qu’aucun second écouteur n’est démarré et qu’il n’est répondu nulle part à aucune des deux vérifications. Lorsqu’une adresse est définie, GET /healthz reçoit la réponse 200 dès que le processus s’exécute, et GET /readyz reçoit la réponse 503 jusqu’à ce que l’espace de travail soit résolu et que le point de terminaison se soit lié, puis 200 à partir de là — c’est la distinction dont a besoin un superviseur, puisqu’un processus démarré n’est pas encore un processus capable de répondre à un appel. Chaque réponse est un code d’état avec un corps vide, aucun jeton n’est demandé et aucun en-tête n’est lu ; tout autre chemin sur cette adresse donne 404, et toute autre méthode sur ces deux chemins donne 405. Contrairement à listen, cette adresse n’est pas limitée au loopback ou à un socket Unix et aucune adresse n’est refusée pour elle : faites-la pointer vers l’un de ceux-ci, ce qui est sa raison d’être, et notez que tout ce qui peut atteindre l’adresse que vous choisissez peut lire ces deux réponses. Par défaut : ""

Les propriétés supplémentaires ne sont pas autorisées.

Définitions

ReleaseCatalogConfig

Les répertoires de catalogue propres à une Release : les deux mêmes clés que porte le bloc workspace, limitées à cette Release.

PropriétéTypeObligatoireDescription
catalog_dirsstring[]nonRépertoires de catalogue à partir desquels cette Release lit les entités locales à la place du catalog_dirs de l’espace de travail, chacun résolu relativement au fichier qui le déclare. La même pile de recherche ordonnée où la première correspondance l’emporte que la liste de l’espace de travail, le répertoire catalog à la racine de l’espace de travail étant lu après elle lorsque ce répertoire existe et qu’aucune entrée listée ne le contient déjà. Si cette clé est omise, la Release conserve la liste de l’espace de travail ; si elle est écrite comme [], aucun catalogue local n’est lu.
catalog_dirs_appendstring[]nonRépertoires de catalogue ajoutés après la liste de cette Release — son propre catalog_dirs lorsque l’entrée en écrit un, celui de l’espace de travail sinon —, chacun résolu relativement au fichier qui le déclare. Par défaut : []

Les propriétés supplémentaires ne sont pas autorisées.

RegistryConfig

Réglages et politique de confiance des signatures limités à un seul hôte de registre OCI.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte de registre auquel s’appliquent ces réglages (p. ex. hub.aggrega.ai). Il est comparé à l’hôte de registre de la cible du push/pull, il s’écrit donc dans la graphie dans laquelle cette comparaison est faite : un nom d’hôte en minuscules contenant un point, localhost, un nom unique suivi d’un port (registry:5000), une adresse IPv4 ou une adresse IPv6 entre crochets, chacun avec un :port facultatif — sans schéma, chemin, identifiants, espace ni majuscule. Le port 443 sur un hôte atteint via HTTPS est le port par défaut de cet hôte, et l’écrire est refusé au chargement de la configuration, en nommant l’hôte à écrire sans lui, car une entrée écrite ainsi ne serait jamais celle qui est trouvée ; localhost et les autres adresses de loopback sont atteints via HTTP simple, donc 443 y est un port ordinaire et il est conservé. aggrega registry add et aggrega config init --registry indexent l’entrée sous l’hôte que nomme leur argument et refusent un hôte qui n’est pas écrit ainsi. L’hôte est jugé sur sa seule graphie : le fait que le nom se résolve, ou qu’un registre y réponde, n’est pas vérifié. Motif : ^(?:(?:(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?|localhost|(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\.(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|\[(?:(?:[0-9a-f]{1,4}:){7}[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,7}:|(?:[0-9a-f]{1,4}:){1,6}:[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,5}(?::[0-9a-f]{1,4}){1,2}|(?:[0-9a-f]{1,4}:){1,4}(?::[0-9a-f]{1,4}){1,3}|(?:[0-9a-f]{1,4}:){1,3}(?::[0-9a-f]{1,4}){1,4}|(?:[0-9a-f]{1,4}:){1,2}(?::[0-9a-f]{1,4}){1,5}|[0-9a-f]{1,4}:(?::[0-9a-f]{1,4}){1,6}|:(?:(?::[0-9a-f]{1,4}){1,7}|:))\])(?::(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?|[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?:(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))$.
namestringnonAlias convivial facultatif pour ce registre. L’hôte est l’identité ; name est un sélecteur de commodité qui se résout vers l’hôte de cette entrée partout où un registre est nommé (par exemple --registry, ou default_registry). Un alias doit être unique parmi les entrées.
trusted_identitiesTrustedIdentity[]nonEnsemble OR d’identités de signature keyless acceptées pour les artefacts récupérés par pull depuis ce registre. Une signature est vérifiée lorsque son certificat correspond à l’une quelconque des entrées. Utilisé par le chemin de vérification keyless. Par défaut : []
trusted_deprecation_identitiesTrustedIdentity[]nonEnsemble OR d’identités keyless acceptées en plus pour signer un marqueur de dépréciation rétroactif pour un artefact récupéré par pull depuis ce registre. Un marqueur de dépréciation est pris en compte lorsque sa signature correspond au signataire de l’artefact d’origine OR à l’une quelconque des entrées d’ici — de sorte que le propriétaire d’un registre ou une équipe de sécurité peut retirer un artefact que l’éditeur d’origine ne peut plus atteindre, sans qu’on lui confie la signature des artefacts eux-mêmes. Utilisé uniquement par le chemin de découverte des dépréciations ; il n’élargit jamais l’ensemble de confiance pour les signatures d’artefacts. Par défaut : []
public_keystringnonClé publique épinglée compatible avec cosign pour un registre en mode par clé, écrite inline sous forme de bloc PEM : le texte allant d’une ligne -----BEGIN PUBLIC KEY----- (ou -----BEGIN RSA PUBLIC KEY-----) à la ligne -----END correspondante, tel que aggrega registry add --key le copie depuis un fichier de clé. Lorsqu’elle est définie, les signatures de ce registre sont vérifiées hors ligne par rapport à cette clé plutôt que par rapport à des identités keyless. Une valeur ne contenant aucune ligne -----BEGIN … PUBLIC KEY----- est refusée au chargement du fichier de configuration, en nommant le fichier et l’entrée, et il en va de même pour une clé privée collée ici par erreur. La ligne peut se trouver n’importe où dans la valeur, car la clé est lue depuis le bloc PEM que contient la valeur et tout texte précédant ce bloc est ignoré. Seule cette ligne est vérifiée ici : la question de savoir si le bloc contient une clé qui se décode se règle lorsqu’une signature de ce registre est vérifiée par rapport à elle. La valeur est déclarée sensible (x-aggrega-sensitive), de sorte qu’une valeur refusée — avant tout une clé privée choisie par erreur — n’est jamais citée : le refus nomme le fichier, l’entrée et la contrainte que la valeur n’a pas respectée — le motif ci-dessus, ou le type string — et affiche <redacted> à la place de la valeur. Une clé publique qui se charge est lue et affichée telle qu’elle est écrite. Motif : -----BEGIN [A-Z ]*PUBLIC KEY-----.
trusted_rootstringnonChemin facultatif vers un bundle de racine de confiance Sigstore épinglé, pour la vérification keyless dans un environnement isolé du réseau. Lorsqu’il est défini, l’ancre de confiance keyless est chargée depuis ce fichier sans réseau ; lorsqu’il est vide, la racine de confiance public-good est récupérée et mise en cache.
advisorybooléennonLorsque la valeur est true, un échec de vérification de signature pour ce registre est rétrogradé en avertissement au lieu d’interrompre le pull. La vérification s’exécute quand même et l’échec est signalé ; le pull se poursuit. Vaut false par défaut. Par défaut : false
skip_signature_verificationbooléennonDésactivation d’urgence (break-glass) par hôte de la vérification des signatures — le même commutateur skip_signature_verification que le commutateur global, limité à cet hôte par son emplacement. Il ne neutralise pas la politique signing.required de premier niveau : une signature exigée par l’organisation est toujours vérifiée sur cet hôte quel que soit ce commutateur ; seul le commutateur global peut la désactiver. Le définir en même temps qu’un signing.required propre au registre sur le même hôte est autorisé, et combine une signature exigée au push avec une vérification omise au pull : l’omission l’emporte côté vérification, car une position exigeant la signature propre à un hôte (contrairement à celle de premier niveau) n’est pas à l’abri de l’omission par hôte. Vaut false par défaut. Par défaut : false
signingSigningConfignonLe bloc de signature de ce registre : les URL des services keyless, un chemin facultatif de clé pour la signature par clé, et la position de confiance propre à l’hôte. Les champs des points de terminaison remplacent le bloc signing global pour les push vers cet hôte ; un flag de la CLI remplace les deux. required et kinds se lisent d’après l’emplacement — sous une entrée de registre, ils limitent l’unique position de confiance à cet hôte (publier un artefact non signé dans la portée est refusé, et consommer un artefact non signé est refusé), le même concept que porte le bloc signing de premier niveau pour tous les registres.

Les propriétés supplémentaires ne sont pas autorisées.

SigningConfig

Un bloc de signature : les URL des services keyless, une référence facultative à un fichier de clé pour la signature par clé, et la position de confiance (required et kinds). Placé au premier niveau, il s’applique à tous les registres ; placé sous une entrée registries[], il s’applique à cet hôte — chaque champ tire sa portée de l’emplacement. required est une position de confiance unique couvrant les deux sens (un push non signé dans la portée est refusé et un pull non signé dans la portée est refusé). Sécurité : il ne contient aucun élément secret — le jeton d’identité OIDC n’est jamais un champ de configuration (de courte durée, fourni à l’exécution), et key_path est le chemin d’un fichier de clé, jamais des octets de clé inline. Cela reflète l’asymétrie du côté vérification : une public_key inline y est autorisée, mais le côté signature ne porte qu’un chemin de clé. Un serveur aggrega mcp atteint via HTTP ne consulte aucun key_path, à aucun des deux emplacements, de sorte que la signature par clé est inaccessible via un tel écouteur : un appel auquel il répond ne signe qu’avec un jeton d’identité que porte cet appel.

PropriétéTypeObligatoireDescription
fulcio_urlstringnonURL de l’autorité de certification Fulcio pour la signature keyless. Lorsqu’elle n’est pas définie, l’instance public-good de Fulcio est utilisée. Elle s’écrit comme une URL https absolue : https://, un hôte, et éventuellement un port et un chemin, sans espace — par exemple https://fulcio.sigstore.dev. Une valeur de toute autre forme, comme une valeur sans schéma (fulcio.example.com) ou une valeur commençant par http://, est refusée au chargement du fichier de configuration, en nommant le fichier et la clé. Le fichier est vérifié avant que quoi que ce soit d’autre ne soit appliqué par-dessus, de sorte que le même point de terminaison fourni par AGGREGA_SIGNING_FULCIO_URL, par le flag --fulcio-url, ou dans une requête de publication provenant d’un éditeur ou d’un assistant n’est pas soumis à cette forme. Motif : ^https://[^\s/?#]+(?:[/?#]\S*)?$.
rekor_urlstringnonURL du journal de transparence Rekor pour la signature keyless. Lorsqu’elle n’est pas définie, l’instance public-good de Rekor est utilisée. Elle s’écrit comme une URL https absolue : https://, un hôte, et éventuellement un port et un chemin, sans espace — par exemple https://rekor.sigstore.dev. Une valeur de toute autre forme, comme une valeur sans schéma (rekor.example.com) ou une valeur commençant par http://, est refusée au chargement du fichier de configuration, en nommant le fichier et la clé. Le fichier est vérifié avant que quoi que ce soit d’autre ne soit appliqué par-dessus, de sorte que le même point de terminaison fourni par AGGREGA_SIGNING_REKOR_URL, par le flag --rekor-url, ou dans une requête de publication provenant d’un éditeur ou d’un assistant n’est pas soumis à cette forme. Motif : ^https://[^\s/?#]+(?:[/?#]\S*)?$.
timestamp_urlstringnonURL de l’autorité d’horodatage RFC3161 pour la signature keyless. Elle n’a pas de valeur par défaut : lorsqu’elle n’est pas définie, aucune autorité d’horodatage n’est contactée, et l’heure de confiance d’une signature keyless provient de son entrée dans le journal de transparence. Elle s’écrit comme une URL https absolue : https://, un hôte, et éventuellement un port et un chemin, sans espace — par exemple https://tsa.example.com/api/v1/timestamp. Une valeur de toute autre forme, comme une valeur sans schéma (tsa.example.com) ou une valeur commençant par http://, est refusée au chargement du fichier de configuration, en nommant le fichier et la clé. Le fichier est vérifié avant que quoi que ce soit d’autre ne soit appliqué par-dessus, de sorte que le même point de terminaison fourni par AGGREGA_SIGNING_TIMESTAMP_URL, par le flag --timestamp-url, ou dans une requête de publication provenant d’un éditeur ou d’un assistant n’est pas soumis à cette forme. Motif : ^https://[^\s/?#]+(?:[/?#]\S*)?$.
key_pathstringnonChemin d’un fichier PEM contenant une clé privée ECDSA P-256 détenue en propre, pour la signature par clé hors ligne. Un chemin vers un fichier, jamais d’élément de clé inline. Lorsqu’il n’est pas défini, le chemin keyless est utilisé. Un serveur aggrega mcp atteint via HTTP ne consulte jamais cette clé, où qu’elle soit définie — dans le bloc signing de premier niveau, dans celui d’une entrée de registre, ou par AGGREGA_SIGNING_KEY_PATH : un appel auquel répond un tel écouteur ne signe qu’avec un jeton d’identité que porte l’appel lui-même, ou il est refusé. Un serveur atteint via l’entrée et la sortie standard signe avec elle comme le fait un terminal.
requiredbooléennonLa position de confiance unique pour la portée de ce bloc : lorsque la valeur est true, publier un type d’artefact dans la portée exige une signature (un push non signé dans la portée est refusé), et en consommer un exige une signature (un pull non signé dans la portée est refusé). La portée est donnée par l’emplacement — sur le bloc signing de premier niveau, elle couvre tous les registres ; sous le bloc signing d’une entrée registries[], elle couvre ce seul hôte. Un nom, une fonction, les deux portées. La politique de premier niveau se compose de façon monotone à travers la cascade de configurations — tout niveau qui la définit à true la rend effectivement true, et aucun niveau de priorité inférieure ne peut la désactiver à nouveau — de sorte qu’elle ne peut pas être supprimée par une simple modification de configuration. Vaut false par défaut. Par défaut : false
kindsstring[]nonLimite required à des types d’artefacts précis. Une liste vide ou une seule entrée all désigne tous les types signables ; sinon la position s’applique exactement aux types listés, correspondant à la valeur kind: de l’entité (par ex. Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). Sur le bloc signing de premier niveau, elle se compose comme une union à travers la cascade — un niveau peut élargir la portée mais jamais la réduire. La portée est donnée par l’emplacement, comme pour required. Par défaut : []

Les propriétés supplémentaires ne sont pas autorisées.

TrustedIdentity

Une identité de signature keyless acceptable : un sujet de certificat (l’identité OIDC) associé à l’émetteur OIDC qui s’en est porté garant.

PropriétéTypeObligatoireDescription
identitystringnonNom alternatif du sujet exact du certificat — l’identité OIDC liée au certificat de signature de courte durée (par ex. l’adresse e-mail d’un mainteneur ou l’URI d’un workflow de CI).
identity_regexpstringnonExpression régulière comparée au sujet du certificat, utilisée à la place d’une identity exacte (par ex. pour accepter n’importe quel workflow d’une organisation).
issuerstringouiURL de l’émetteur OIDC qui a émis le jeton d’identité (par ex. https://accounts.google.com ou https://token.actions.githubusercontent.com).

Les propriétés supplémentaires ne sont pas autorisées.

PluginRef

Référence à un plugin Wasm rattaché à un socket dont le rattachement peut nommer la fonction d’entrée — les listes governance et linter. Les sockets dont le point d’entrée est fixe utilisent à la place FixedEntryPluginRef, qui porte ces mêmes champs sans function. uri et capability sélectionnent ensemble le plugin : uri seul est un rattachement direct (le plugin ayant cette identité est rattaché tel quel — la voie des sockets transversaux, puisque leurs plugins ne déclarent aucune capacité servie) ; capability seul résout le plugin qui sert cette capacité (le nom nu de la capacité qu’une Recipe lie via spec.capability, par ex. helm) ; les deux ensemble désambiguïsent — capability nomme ce qu’il faut résoudre et uri choisit le plugin de quel éditeur la sert, par l’identité nue de ce plugin, dans un catalogue fédéré où plus d’un plugin sert la capacité. function remplace la fonction d’entrée par défaut du socket ; lorsqu’il est omis, la valeur par défaut documentée du socket s’applique — sur une entrée de gouvernance, cette valeur par défaut découle de role. role nomme le rôle de rattachement de gouvernance et n’est lu que sur une entrée de gouvernance. with porte des données d’entrée facultatives fournies au moment du rattachement, que lit le plugin.

PropriétéTypeObligatoireDescription
uristringnonIdentifiant du Plugin : l’identité nue d’une entité Plugin — le chemin <pluginType>/<name>, par ex. governance/redact ou provider/helm — un chemin de système de fichiers local, ou un alias de registre. Facultatif : une entrée peut à la place sélectionner le plugin par capability. Un :version final facultatif épingle la version sous les trois mêmes formes que tout épinglage de version (nu, exact :1.0.0, ou plage compatible avec la version majeure :^1.0.0).
rolestring (enum)nonLe rôle de pipeline auquel est lié un rattachement de gouvernance, lu uniquement sur une entrée governance : annotation-transform injecte des annotations sur les composants résolus avant l’expansion des annotations, de sorte que les injections liées deviennent des rattachements de Feature ; label-transform attribue automatiquement des labels aux nœuds du graphe de topologie lors de la construction de la topologie ; ir-verdict rend un verdict d’acceptation ou de rejet sur le graphe IR lors de l’analyse statique ; render-verdict rend un verdict sur les artefacts rendus lors du rendu. C’est le rôle — et non le type déclaré du plugin — qui fixe ce que le plugin peut émettre : la sortie d’un rôle de verdict ne peut être lue que comme un verdict, jamais appliquée comme une modification ; la sortie d’un rôle de transformation est confinée par l’hôte à sa facette (annotations ou labels). Il sélectionne aussi la fonction d’entrée par défaut (annotation-transform → transform_annotations ; label-transform → mutate ; ir-verdict → verdict_ir ; render-verdict → verdict_render). Valeurs autorisées : "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringnonLa capacité du fournisseur pour laquelle cette entrée sélectionne un plugin — le nom nu de la capacité qu’une Recipe lie via spec.capability (par ex. helm, compose). Facultatif : une entrée peut à la place rattacher un plugin directement par uri. Les liaisons du fournisseur s’en servent pour choisir le plugin de quel éditeur sert une capacité dans un catalogue fédéré ; les sockets transversaux la laissent vide et rattachent par uri.
functionstringnonSurcharge facultative de la fonction d’entrée par défaut du socket. Lorsqu’elle est omise, la valeur par défaut documentée du socket s’applique (gouvernance annotation-transform → transform_annotations, gouvernance label-transform → mutate, gouvernance ir-verdict → verdict_ir, gouvernance render-verdict → verdict_render, linter → lint_rules). La surcharge peut nommer tout export que déclare le plugin, et l’export qu’elle nomme doit renvoyer la forme de sortie que lit ce socket : le build s’interrompt lorsque cette sortie porte un champ de premier niveau que la forme ne déclare pas, en nommant l’export appelé et le champ inattendu. Le contrôle lit quels noms de champs de premier niveau sont présents, et non lesquels sont absents ni ce qui est imbriqué en dessous, de sorte qu’il ne constitue pas une validation complète de la sortie.
withPluginRefWithnonDonnées d’entrée facultatives fournies au moment du rattachement, que lit le plugin. Les deux membres sont facultatifs et agnostiques vis-à-vis du socket, de sorte que tout socket peut réutiliser cette surface.

Les propriétés supplémentaires ne sont pas autorisées.

FixedEntryPluginRef

Référence à un plugin Wasm rattaché à un socket dont le point d’entrée est fixe plutôt que nommé par le rattachement — la liste importer et les liaisons providers. Elle porte les mêmes champs que PluginRef sans function : le socket importeur appelle l’unique fonction d’entrée que nomme le contrat de son socket, et un fournisseur pilote un ensemble fixe d’exports indexés par phase plutôt qu’un unique point d’entrée sélectionnable, de sorte que sur aucune des deux listes il n’existe de point d’entrée que function puisse nommer, et la clé n’y est pas acceptée. uri et capability sélectionnent ensemble le plugin : uri seul est un rattachement direct (le plugin ayant cette identité est rattaché tel quel — la voie du socket importeur, puisque ses plugins ne déclarent aucune capacité servie) ; capability seul résout le plugin qui sert cette capacité (le nom nu de la capacité qu’une Recipe lie via spec.capability, par ex. helm) ; les deux ensemble désambiguïsent — capability nomme ce qu’il faut résoudre et uri choisit le plugin de quel éditeur la sert, par l’identité nue de ce plugin, dans un catalogue fédéré où plus d’un plugin sert la capacité. role est accepté ici mais n’est lu sur aucune des deux listes que sert cette forme : le rôle de rattachement de gouvernance qu’il nomme est lu sur une entrée governance, qui utilise PluginRef, de sorte qu’un rôle défini sur l’une de ces entrées n’a aucun effet. with porte des données d’entrée facultatives fournies au moment du rattachement, que lit le plugin ; une liaison du fournisseur tire à la place sa configuration de rendu de la Recipe, de sorte que with: sur une telle liaison est refusé au chargement.

PropriétéTypeObligatoireDescription
uristringnonIdentifiant du Plugin : l’identité nue d’une entité Plugin — le chemin <pluginType>/<name>, par ex. governance/redact ou provider/helm — un chemin de système de fichiers local, ou un alias de registre. Facultatif : une entrée peut à la place sélectionner le plugin par capability. Un :version final facultatif épingle la version sous les trois mêmes formes que tout épinglage de version (nu, exact :1.0.0, ou plage compatible avec la version majeure :^1.0.0).
rolestring (enum)nonLe rôle de rattachement de gouvernance. Aucune des deux listes qui utilisent cette forme ne le lit — le rôle est lu sur une entrée governance, et ces entrées utilisent PluginRef — de sorte qu’un rôle défini ici est accepté et n’a aucun effet. Les valeurs permises sont les quatre rôles de gouvernance, et la signification de chacun est décrite sur PluginRef. Valeurs autorisées : "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringnonLa capacité du fournisseur pour laquelle cette entrée sélectionne un plugin — le nom nu de la capacité qu’une Recipe lie via spec.capability (par ex. helm, compose). Facultatif : une entrée peut à la place rattacher un plugin directement par uri. Les liaisons du fournisseur s’en servent pour choisir le plugin de quel éditeur sert une capacité dans un catalogue fédéré ; les sockets transversaux la laissent vide et rattachent par uri.
withPluginRefWithnonDonnées d’entrée facultatives fournies au moment du rattachement, que lit le plugin. Les deux membres sont facultatifs et agnostiques vis-à-vis du socket, de sorte que tout socket peut réutiliser cette surface.

Les propriétés supplémentaires ne sont pas autorisées.

CLIPluginRef

Un plugin d’extension de la CLI épinglé, installé comme commande aggrega de premier niveau : la référence d’artefact résolue et épinglée à une version que la commande résout et exécute, et le digest du contenu des octets du guest vers lesquels cette référence s’est résolue au moment de l’installation. Ensemble, ils épinglent exactement les octets qu’exécute la commande ; le digest sert aussi de clé au cache describe qui fournit les noms et l’aide de la commande sans charger le guest.

PropriétéTypeObligatoireDescription
uristringouiLa référence d’artefact résolue et épinglée à une version que la commande résout et exécute, par ex. oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0, épinglée à l’installation.
digeststringouiLe digest du contenu des octets .wasm du guest vers lesquels la référence s’est résolue à l’installation, écrit sous la forme sha256: suivi des 64 chiffres hexadécimaux en minuscules du SHA-256 des octets — la graphie qu’enregistre aggrega plugin add cli, et la graphie dans laquelle les octets résolus sont comparés. Un digest dans toute autre graphie — hexadécimal nu sans le préfixe sha256:, majuscules ou longueur différente — ne pourrait jamais lui être égal, de sorte qu’il est refusé au chargement du fichier de configuration, en nommant le fichier et l’entrée. Il épingle les octets exacts qu’exécute la commande — une résolution ultérieure dont les octets donnent un hachage différent interrompt la commande — et constitue la clé du cache describe qui produit l’aide de la commande sans charger le guest. Motif : ^sha256:[0-9a-f]{64}$.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRefWith

Données d’entrée facultatives fournies au moment du rattachement, que lit un plugin. Les deux membres sont facultatifs et la surface est générale, de sorte que tout socket peut la réutiliser.

PropriétéTypeObligatoireDescription
sourcesstring[]nonChemins de fichiers de définition que l’hôte lit à la compilation et transmet au plugin. Chaque entrée est un chemin de système de fichiers résolu par rapport au répertoire du fichier de configuration qui la déclare.
settingsobjectnonObjet de réglages de forme libre transmis tel quel au plugin. L’hôte n’interprète pas sa forme ; c’est le plugin qui définit les clés qu’il lit.

Les propriétés supplémentaires ne sont pas autorisées.