Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Esquema de la configuración del espacio de trabajo de Aggrega

Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.

ID del esquema: https://aggrega.ai/schemas/aggrega-config-v1beta1.schema.json

Archivo de configuración por espacio de trabajo que consume la CLI aggrega. Se encuentra en .aggrega-config.yaml. El bloque workspace es el marcador de la raíz: su presencia marca la raíz del espacio de trabajo, y solo contiene directorios de catálogo. Cualquier otra clave es un ajuste y se encuentra en el nivel superior, en estas clases — de dónde se obtiene, se fija y se almacena en caché el contenido (selección del registro, offline, comportamiento de auto-pull y de fijación, ubicaciones y topes de tamaño de las cachés de artefactos y de módulos compilados), cómo se confía en el contenido (firma y comportamiento de la verificación de firmas), con qué rigor se juzga la autoría (ajustes de lint por regla, rigor ante las obsolescencias y la indicación de la release de autoría), qué plugins Wasm se vinculan a todo el espacio de trabajo (gobernanza, linter, importador y enlaces de renderizado del proveedor por destino) y cómo se ejecuta la CLI (concurrencia, servicio y topes de expulsión de la caché de análisis del daemon). Las propiedades que siguen son la lista completa y autorizada; este resumen nombra las clases en lugar de las claves, de modo que añadir una clave no puede volverlo falso. Forma plana de nivel superior, sin envoltorio apiVersion/kind, distinta del contenido del catálogo. Disciplina de evolución del esquema: añadir una nueva clave de nivel superior es un incremento SemVer-MINOR (aditivo); eliminar o reubicar una clave, o endurecer una restricción, es una ruptura SemVer-MAJOR.

Tipo de nivel superior: object

Propiedades

PropiedadTipoObligatoriaDescripción
workspaceobjectnoMarcador de la raíz del espacio de trabajo. Su sola presencia marca el directorio como raíz del espacio de trabajo; solo lleva los directorios de catálogo que definen la raíz — los propios del espacio de trabajo y los que se dan a una Release como propios. Todo ajuste que no define la raíz se encuentra en el nivel superior y no aquí. Escribe workspace: {} para marcar una raíz sin directorios de catálogo incluidos en el proyecto.
default_registrystringnoRegistro OCI predeterminado en el que se publican las entidades y desde el que se resuelven las dependencias cuando una entidad no nombra un registro explícitamente: aggrega push publica allí y aggrega pull obtiene desde allí. De forma predeterminada es hub.aggrega.ai. Escribe el name de una entrada bajo registries, que entonces representa el host de esa entrada; el propio host; o el host seguido de / y una ruta de repositorio, como ghcr.io/acme o harbor.example.com/platform. Primero se compara un nombre: un valor que es el name de una entrada es el host de esa entrada, incluso donde también se escribe como un host, de modo que la publicación, el pull, la verificación de firmas y cada ajuste de confianza por registro usan ese único host; un valor que da nombre a dos entradas se rechaza por ambiguo, y un nombre seguido de una ruta se rechaza, porque un nombre representa el host de una entrada y no una ubicación bajo él. Cualquier otro valor debe ser un host, escrito en la grafía con la que se guarda su política de confianza: un nombre de host en minúsculas que contiene un punto (registry.example.com), localhost, un único nombre seguido de un puerto (registry:5000), una dirección IPv4 o una dirección IPv6 entre corchetes ([::1]), cada uno con un :port opcional y sin esquema, credenciales, espacios en blanco ni mayúsculas — seguido opcionalmente de una ruta de repositorio: uno o más segmentos de letras minúsculas y dígitos unidos por /, que pueden separarse dentro de un segmento por ., _, __ o guiones, sin tag, digest ni / final. La ruta es donde se publican y se obtienen las cosas: cada entidad publicada a través del registro predeterminado se publica bajo <host>/<path>/, y cada entidad resuelta a través de él se obtiene desde allí, de modo que lo que uno publica el otro lo encuentra. Nunca forma parte de cómo se confía en un registro: la entrada de registries cuya política se aplica, un inicio de sesión, un requisito de firma y las identidades de confianza se encuentran todos solo por el host. El puerto 443 en un host al que se llega por HTTPS es el puerto predeterminado de ese host, y escribirlo se rechaza, indicando la grafía que debe escribirse sin él; a localhost y a las demás direcciones de loopback se llega por HTTP simple, así que allí 443 es un puerto ordinario y se conserva. Un valor vacío no nombra ningún registro predeterminado. El valor se juzga al cargar la configuración y no mediante este esquema, porque la entrada a la que se refiere un nombre puede estar declarada en otro archivo de configuración: se lee después de cada archivo de configuración y de la variable de entorno AGGREGA_DEFAULT_REGISTRY, y se rechaza con las mismas palabras sea cual sea el que lo haya establecido, nombrando ese archivo o la variable. El flag --registry que nombra el destino de una publicación para una sola invocación se compara con los nombres de las entradas de la misma manera; cualquier otro valor que lleve puede ser una referencia, y el host que nombra esa referencia se somete a la misma grafía y es donde llega la publicación, sin ruta de repositorio. El host se juzga solo por su grafía: no se comprueba si el nombre se resuelve ni si allí responde un registro. Valor predeterminado: "hub.aggrega.ai"
offlinebooleanonoCuando es true, la compilación no contacta con ningún registro; solo se consultan los artefactos en caché y el contenido de catálogo incluido en el proyecto. De forma predeterminada es false. Valor predeterminado: false
auto_pullbooleanonoCuando es false (valor predeterminado), aggrega build es de solo lectura: nunca escribe fijaciones de fuentes, y un archivo de bloqueo por release ausente o incompleto detiene la compilación de forma bien visible con un diagnóstico que indica ejecutar primero aggrega pull --release <release>. Cuando es true, aggrega build ejecuta un paso de pull dentro del mismo proceso antes de compilar — resolviendo las dependencias de la Release en el archivo de bloqueo y la caché — de modo que una primera compilación contra una Release no requiere un paso de pull explícito. La misma activación opcional para una sola compilación está disponible en la línea de comandos como aggrega build --auto-pull; pull sigue siendo el único que escribe el archivo de bloqueo. offline: true no desactiva el paso de pull: se ejecuta sobre lo que la máquina ya contiene — la caché y los directorios de catálogo locales — sin llegar a un registro, y una referencia que ninguno de los dos contiene detiene la compilación con el propio rechazo del pull que nombra esa referencia. Valor predeterminado: false
pin_sources_at_pullbooleanonoCuando es false (valor predeterminado), un pull no registra ninguna fijación junto a una entidad: sobre una Recipe o una FeatureRecipe de uno de los directorios de catálogo de este espacio de trabajo que la Release compila, se detiene cuando el entity.lock junto a la entidad no registra una fijación para cada elemento que lee la entidad — un source: remoto cuyas coordenadas están escritas por completo, un archivo que importa una entrada de artifacts, o cada archivo de un source: local junto a la entidad — nombrando la entidad, cada elemento y su clase, y aggrega pin como el paso que las registra. La fijación es el paso del autor de la entidad, así que una entidad que nadie ha fijado aún no está lista para consumirse. Cuando es true, cada pull de este espacio de trabajo ejecuta ese paso en su lugar, sobre las mismas entidades, escribiendo los mismos bytes de entity.lock que escribe aggrega pin; así es como un espacio de trabajo que consume entidades que otra persona no ha fijado registra sus fijaciones una sola vez en lugar de detenerse. Una compilación que rellena su propio archivo de bloqueo es un pull y sigue este ajuste. aggrega pull --pin-sources fija para una sola invocación y --pin-sources=false se detiene para una sola invocación, diga lo que diga este ajuste. Una entidad resuelta desde la caché en lugar de desde un directorio de catálogo no tiene dónde escribir un bloqueo y un pull nunca la fija ni la detiene. Valor predeterminado: false
pin_sources_at_pushbooleanonoCuando es true, cada aggrega push de este espacio de trabajo ejecuta el paso de fijación del autor de la entidad sobre la entidad que publica antes de empaquetarla, de modo que el entity.lock que el paso escribe junto a la entidad forma parte de lo que se publica; cuando es false (valor predeterminado), push no ejecuta ningún paso de fijación y rechaza una Recipe o una FeatureRecipe cuyo entity.lock no registra cada fijación que ese paso registraría, nombrando aggrega pin. El paso escribe junto a la entidad, así que solo se ejecuta donde la entidad tiene una ubicación con permiso de escritura, que un push siempre tiene: publica una entidad nombrada por su documento. aggrega push --pin-sources fija para una sola invocación y --pin-sources=false no, diga lo que diga este ajuste. Es el mismo paso que ejecuta aggrega pin, y escribe los mismos bytes. Valor predeterminado: false
artifact_cache_dirstringnoDirectorio local de la caché de artefactos/contenido (pulls de registros, manifiestos OCI, fixtures compilados). De forma predeterminada es .aggrega/cache. Por convención debería excluirse mediante gitignore. La ruta se interpreta relativa a la raíz del espacio de trabajo, sea cual sea el lugar desde el que se ejecute el comando; un valor absoluto se rechaza al cargar la configuración, porque cada lector de este ajuste lo resuelve con respecto a esa raíz y una ruta absoluta nombraría una ubicación a la que nunca llegan. La caché puede estar dentro de un directorio de catálogo — la predeterminada lo está, ya que un directorio de catálogo suele ser la raíz del espacio de trabajo — pero no debe SER uno: un escaneo del catálogo pasa por alto la caché, así que un valor que nombra un directorio de catálogo deja fuera del escaneo todo el contenido de ese directorio. Un valor que nombra la propia raíz del espacio de trabajo (., o cualquier grafía que se reduzca a ella) se rechaza al cargar la configuración, exactamente por ese motivo. Un valor que nombra cualquier otro directorio de catálogo no se rechaza: se carga sin errores y el escaneo luego no encuentra nada en ese directorio, así que mantener la caché fuera de los directorios enumerados en workspace.catalog_dirs es algo que te corresponde comprobar a ti. Distinto de parse_cache, que limita la caché de análisis en memoria del daemon, y de compiled_module_cache, que limita el almacén de módulos compilados de toda la máquina. Valor predeterminado: ".aggrega/cache"
skip_signature_verificationbooleanonoDesactivación global y bien visible de la verificación de firmas. Cuando es true, la verificación de firmas se desactiva en todos los registros, incluida la línea base obligatoria del hub. Pensada para escenarios de emergencia (break-glass) y de desarrollo; nunca es silenciosa — dondequiera que un pull habría comprobado una firma, avisa de que la verificación se ha desactivado globalmente. De forma predeterminada es false. Valor predeterminado: false
buildobjectnoAjustes de rigor en tiempo de compilación e indicaciones de autoría. authoring_release proporciona al LSP una indicación current Release para los diagnósticos inline; halt_on_deprecated_severity controla cómo reacciona la compilación al consumo de entidades obsoletas; yaml_indent establece el ancho de sangría de cada artefacto YAML renderizado.
pluginsobjectnoVinculaciones de plugins Wasm a nivel del espacio de trabajo. Cada socket (gobernanza, linter, importador) acepta un array de referencias a plugins; la compilación invoca la función de entrada documentada de cada plugin según el contrato de su socket. La lista providers enlaza las capacidades con los plugins de renderizado del proveedor que las sirven.
lintobjectnoAjustes de rigor por regla.
parse_cacheobjectnoTopes de expulsión de la caché de análisis del daemon. Ambos topes se aplican simultáneamente — el bucle de expulsión LRU se ejecuta después de cada inserción en la caché y elimina las entradas usadas menos recientemente hasta que tanto el número de entradas como el total de bytes están dentro de los límites. Cero en cualquiera de los dos significa unbounded on that axis, útil en escenarios de CI en los que la caché solo vive durante una invocación. Distinto de artifact_cache_dir, que es la caché de contenido en disco.
compiled_module_cacheobjectnoTope de tamaño para la caché en disco de módulos compilados, el almacén de código máquina que el compilador reutiliza para que un plugin Wasm se compile una vez por máquina en lugar de una vez por compilación. Se comparte entre todos los espacios de trabajo de la máquina, así que esta clave va en el archivo de configuración global cuando quieres una única respuesta para toda la máquina. El tope se aplica una vez por invocación, antes de cargar ningún plugin, eliminando entradas completas empezando por las compiladas hace más tiempo hasta que el resto cabe — nunca mientras una compilación está en curso. Eliminar una entrada cuesta una recompilación posterior y nada más, así que es seguro bajar el tope. aggrega cache status informa del tamaño actual del almacén, y aggrega cache evict --max-size lo recorta bajo demanda a un tope indicado en la línea de comandos. Distinto de artifact_cache_dir (contenido obtenido de los registros) y de parse_cache (la caché de análisis en memoria del daemon).
concurrencyobjectnoAjustes de concurrencia del despacho de solicitudes del daemon. El daemon lee las solicitudes de un único flujo stdin y ejecuta cada una a través de un pool de workers que vacía una cola de solicitudes acotada; las respuestas se emiten en el orden de llegada de las solicitudes, independientemente del orden de finalización.
serveobjectnoAjustes de comportamiento del daemon (aggrega serve) para el compilador como servicio que consumen las integraciones con IDE.
mcpobjectnoAjustes del servidor Model Context Protocol (aggrega mcp). transport elige cómo se llega al servidor — a través de la entrada y la salida estándar del proceso, o a través de HTTP — y se lee elija lo que elija. announce_tools también se lee en ambos transportes, porque qué herramientas se ofrecen a un cliente es una propiedad del servidor y no de cómo llegó a él un cliente. Cualquier otra clave configura el listener que inicia el transporte HTTP y no se usa mientras el servidor se comunica a través de la entrada y la salida estándar — listen incluido, que allí solo se lee para que el servidor pueda indicar, en una línea en su flujo de errores, que la dirección no se usa. Cada clave de abajo indica de cuál se trata. Distinto de serve, que configura el daemon de backend del editor.
registriesRegistryConfig[]noAjustes por registro y política de confianza de firmas, indexados por host de registro. Un registro que no figura aquí usa los valores predeterminados: una firma presente se verifica y una firma ausente se tolera, excepto para hub.aggrega.ai, cuya línea base integrada exige una firma verificada incluso sin ninguna entrada explícita. Una entrada explícita para un host sustituye la línea base de ese host. Valor predeterminado: []
signingSigningConfignoBloque de firma de nivel superior, aplicable a todos los registros: las URL de los servicios keyless, una ruta opcional de clave para la firma con clave y la postura de confianza común a todos los registros (required y kinds). Un bloque signing por registro sustituye los valores predeterminados de los endpoints para ese host y lleva la misma postura required/kinds con ámbito limitado a ese host — un nombre, una función, el ámbito según la ubicación. La política required/kinds de nivel superior se compone de forma monótona a lo largo de la cascada de configuraciones. Seguridad: este bloque no contiene material secreto — el token de identidad OIDC nunca es un campo de configuración (se suministra en tiempo de ejecución mediante un flag o el entorno OIDC del ambiente) y key_path es la ruta a un archivo de clave, nunca bytes de clave inline.

No se permiten propiedades adicionales.

aggrega-config.workspace

Marcador de la raíz del espacio de trabajo. Su sola presencia marca el directorio como raíz del espacio de trabajo; solo lleva los directorios de catálogo que definen la raíz — los propios del espacio de trabajo y los que se dan a una Release como propios. Todo ajuste que no define la raíz se encuentra en el nivel superior y no aquí. Escribe workspace: {} para marcar una raíz sin directorios de catálogo incluidos en el proyecto.

PropiedadTipoObligatoriaDescripción
catalog_dirsstring[]noDirectorios de catálogo opcionales desde los que este espacio de trabajo lee las entidades locales, consultados antes de recurrir al registro. Cada entrada es una ruta del sistema de archivos, resuelta de forma relativa al archivo que la declara. La lista es una pila de búsqueda ordenada en la que gana la primera coincidencia: el directorio listado primero que declara una identidad es su propietario, y la misma identidad en un directorio posterior queda oculta. También se lee el directorio catalog de la raíz del espacio de trabajo, después de cada entrada listada y solo cuando existe — salvo que una entrada listada ya lo contenga, en cuyo caso se lee como parte de esa entrada — de modo que listar un directorio se suma a lo que el espacio de trabajo ya leía en lugar de sustituirlo. Omitir esta clave y escribirla como una lista vacía son afirmaciones distintas: si se omite, el espacio de trabajo sigue leyendo catalog; si se escribe como [], no lee ningún catálogo local, que es como un espacio de trabajo indica que no tiene ninguno. Una Release a la que se dan directorios de catálogo propios bajo releases lee esos en lugar de esta lista. Con ámbito de raíz: los directorios de catálogo locales pertenecen a esta raíz del espacio de trabajo, así que se encuentran en el marcador de la raíz y no en el nivel superior.
catalog_dirs_appendstring[]noAdición opcional, solo al final, a la lista catalog_dirs efectiva. En cada capa de precedencia, las entradas indicadas aquí se concatenan a la lista base resuelta, lo que permite que las configuraciones del espacio de trabajo y globales compongan los directorios de catálogo en lugar de ocultarlos. Interacción en la misma capa: cuando en una capa se especifican tanto catalog_dirs como catalog_dirs_append, el valor resuelto en esa capa es la lista base seguida de la lista añadida. Valor predeterminado: []
releasesmapa de ReleaseCatalogConfignoDirectorios de catálogo opcionales propios de una Release, para un espacio de trabajo que mantiene varias variantes de catálogo una junto a otra y compila cada Release con una de ellas. Cada clave es un archivo de Release, escrito como una ruta relativa al archivo que la declara; cada valor lleva catalog_dirs y catalog_dirs_append con el significado que tienen en este bloque, limitado a esa única Release. Una Release nombrada aquí lee su propio catalog_dirs en lugar de la lista de este bloque, seguido de su propio catalog_dirs_append; una entrada que omite catalog_dirs conserva la lista de este bloque y añade después su catalog_dirs_append. El orden de búsqueda, el directorio catalog de la raíz del espacio de trabajo y lo que significa una lista vacía son los mismos que para la lista propia de este bloque, y una Release que este mapa no nombra lee la lista de este bloque exactamente como antes. La Release lee estos directorios sea cual sea la forma en que se compile — en un terminal, desde un editor a través de aggrega serve o a través de aggrega mcp — y un directorio --catalog se sigue buscando antes que ellos durante una sola invocación. Una entrada que nombra un archivo que no existe se rechaza al cargar la configuración, nombrando la entrada y el archivo, de modo que renombrar una Release no puede cambiar sin avisar el catálogo con el que se compila. Entre archivos de configuración, la entrada de cada Release se compone del mismo modo que las claves propias de este bloque: el catalog_dirs de un archivo más cercano para esa Release sustituye al de un archivo más lejano, y el catalog_dirs_append de cada archivo para ella se añade en el orden de la cascada. AGGREGA_CATALOG_DIRS establece la lista de este bloque y no llega a ninguna entrada de aquí. Una operación que no concierne a ninguna Release concreta — un lint o una validación de todo el catálogo, la búsqueda de una entidad por nombre o el listado de las entidades del espacio de trabajo en un editor — lee la lista de este bloque y no estas.

No se permiten propiedades adicionales.

aggrega-config.build

Ajustes de rigor en tiempo de compilación e indicaciones de autoría. authoring_release proporciona al LSP una indicación current Release para los diagnósticos inline; halt_on_deprecated_severity controla cómo reacciona la compilación al consumo de entidades obsoletas; yaml_indent establece el ancho de sangría de cada artefacto YAML renderizado.

PropiedadTipoObligatoriaDescripción
authoring_releasestringnoRuta a un archivo YAML de Release que el LSP trata como el contexto current Release para los diagnósticos inline. Opcional.
yaml_indentintegernoAncho de sangría (en espacios) de cada artefacto YAML renderizado — archivos docker-compose, plantillas y valores de charts de Helm, y manifiestos de Kubernetes. De forma predeterminada es 2, el ancho convencional para esos formatos. Mínimo: 2. Máximo: 9. Valor predeterminado: 2
halt_on_deprecated_severitystring (enum)noSeveridad, en el conjunto ordenado warning < error < retracted, a partir de la cual un marcador de obsolescencia registrado detiene la compilación. Rige los dos lugares en los que se registra un marcador: el archivo de bloqueo, para todo lo que una compilación reproduce byte a byte, y el registro de confianza de los plugins junto a él, para un plugin vinculado en un rol que devuelve un veredicto de aceptación o rechazo — una vinculación plugins.governance en ir-verdict o render-verdict, y cada vinculación plugins.linter. Un ajuste, una regla, ambos almacenes. Sin establecer de forma predeterminada, y sin establecer significa que ningún marcador registrado detiene nada: un marcador se registra contra una versión que ya fijaste, de modo que una compilación que tuvo éxito una vez sigue teniéndolo. La notificación y la resolución son dos ejes separados y ninguno de los dos es este ajuste. Cada superficie que lee cualquiera de los dos registros informa de cada referencia obsoleta que fija y de cada plugin de confianza que lleva un marcador — con cualquier severidad — nombrándolo, junto con su severidad y su mensaje: aggrega build, aggrega validate --release, aggrega lint --release, el daemon orientado al editor y las herramientas build, describe y validate nativas de IA. Así que subir este umbral nunca reduce lo que se te comunica. Este ajuste rige solo la compilación: detiene aggrega build (y la herramienta build nativa de IA, que es la misma operación), mientras que las superficies que informan nombran el marcador y continúan. Solo un marcador retracted afecta a la versión a la que se resuelve una referencia, y lo hace cuando aggrega pull elige una versión, no en la compilación. Valores permitidos: "warning", "error", "retracted"

No se permiten propiedades adicionales.

aggrega-config.plugins

Vinculaciones de plugins Wasm a nivel del espacio de trabajo. Cada socket (gobernanza, linter, importador) acepta un array de referencias a plugins; la compilación invoca la función de entrada documentada de cada plugin según el contrato de su socket. La lista providers enlaza las capacidades con los plugins de renderizado del proveedor que las sirven.

PropiedadTipoObligatoriaDescripción
governancePluginRef[]noLos plugins del socket de gobernanza. Cada entrada nombra el role de la pipeline en el que está vinculada (annotation-transform, label-transform, ir-verdict o render-verdict); el rol fija tanto lo que el plugin puede emitir como su función de entrada predeterminada (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Valor predeterminado: []
governance_appendPluginRef[]noAdición, solo al final, a la lista governance efectiva. Las entradas indicadas aquí se concatenan a la lista base resuelta en cada capa de precedencia, lo que permite que las configuraciones del espacio de trabajo y globales compongan las vinculaciones de gobernanza en lugar de ocultarlas. Valor predeterminado: []
linterPluginRef[]noLos plugins del socket linter. Función de entrada predeterminada: lint_rules. Las exportaciones de un plugin linter deben empezar por lint_, así que function: en una de estas entradas nombra una exportación con ese prefijo. Valor predeterminado: []
linter_appendPluginRef[]noAdición, solo al final, a la lista linter efectiva. La misma semántica de componer sin ocultar que governance_append. Valor predeterminado: []
importerFixedEntryPluginRef[]noLos plugins del socket importador. El socket llama a la función de entrada import; una vinculación no nombra ninguna. Valor predeterminado: []
importer_appendFixedEntryPluginRef[]noAdición, solo al final, a la lista importer efectiva. La misma semántica de componer sin ocultar que governance_append. Valor predeterminado: []
providersFixedEntryPluginRef[]noSelecciones del proveedor por capacidad. Cada entrada enlaza una capacidad del proveedor (el nombre simple de la capacidad que una Recipe enlaza mediante spec.capability, p. ej. helm o compose) con la identidad simple del plugin de renderizado del proveedor que la sirve (la identidad de la entidad Plugin, su metadata.pluginType y su metadata.name unidos por una barra, p. ej. provider/helm), con un :version final opcional en las mismas tres formas que una fijación de versión (simple, exacta :1.0.0 o rango compatible con la versión mayor :^1.0.0). Esta es la superficie de desambiguación y de anulación para un catálogo federado en el que más de un plugin de proveedor sirve la misma capacidad: el enlace selecciona el plugin de qué publicador renderiza esa capacidad. Cuando una capacidad la sirve exactamente un plugin de proveedor, no se necesita ninguna entrada. En toda la lista compuesta se permite exactamente una entrada por capacidad; una capacidad duplicada detiene la resolución de forma bien visible. La resolución ocurre en el pull: el pull registra el enlace resuelto en el archivo de bloqueo por Release, y la compilación lee el archivo de bloqueo — un cambio aquí después de un pull no se adopta hasta el siguiente pull, de modo que la salida de la compilación es invariante respecto a él (salida determinista). Cada compilación y cada validación de una Release también comprueba cada entrada de aquí, tanto si una Recipe pide su capacidad como si no: una entrada que nombra un plugin que la compilación contiene y que no sirve la capacidad de la entrada provoca una detención, nombrando lo que sirve ese plugin y una grafía a una edición de distancia cuando la hay; una entrada que nombra una capacidad y ningún plugin, cuando ningún plugin de proveedor que lee la compilación sirve esa capacidad, se informa como una advertencia en lugar de detener, porque el plugin que la sirve puede ser uno que solo lee otra Release; y una entrada para una capacidad que un plugin sirve pero que esta Release nunca pide es lícita y no se informa en absoluto, ya que las entradas se escriben para todo el espacio de trabajo y una compilación es de una sola Release. Una capability que contiene dos puntos se rechaza al cargar la configuración: el spec.capability de una Recipe se lee como la capacidad hasta sus últimos dos puntos y una fijación de versión después, de modo que ninguna Recipe podría llegar a una entrada así. Una entrada ausente para una capacidad servida sin ambigüedad no es un error; una entrada ausente para una capacidad servida de forma ambigua detiene el pull de forma bien visible, enumerando los plugins candidatos. La coexistencia de versiones se conserva: el enlace selecciona el repositorio del plugin por capacidad, y la propia fijación de versión en spec.capability de cada Recipe selecciona la versión dentro de ese repositorio, de modo que dos Recipes que fijan versiones distintas de un mismo proveedor siguen coexistiendo. Valor predeterminado: []
providers_appendFixedEntryPluginRef[]noAdición, solo al final, a la lista providers efectiva. Las entradas indicadas aquí se concatenan a la lista base resuelta en cada capa de precedencia, lo que permite que las configuraciones del espacio de trabajo y globales compongan los enlaces del proveedor en lugar de ocultarlos. La misma semántica de componer sin ocultar que governance_append. La regla de una entrada por capacidad se aplica a la lista compuesta, así que una entrada añadida que nombra una capacidad ya enlazada por una capa inferior detiene la resolución de forma bien visible. Valor predeterminado: []
cliCLIPluginRef[]noLos plugins de extensión de la CLI instalados como comandos aggrega de nivel superior. Cada entrada fija un plugin de CLI mediante su referencia de artefacto resuelta y fijada a una versión y el digest de contenido de los bytes del guest a los que esa referencia se resolvió en el momento de la instalación. A diferencia de las cuatro listas de sockets transversales, cuya lista base se sustituye por completo a lo largo de la cascada de configuraciones, la lista de la CLI se compone: un plugin de CLI en la configuración global registra sus comandos en cada espacio de trabajo, uno en una configuración del espacio de trabajo se registra solo en ese proyecto, y ambos se registran juntos — así que no necesita un complemento _append. Los nombres de comando y la ayuda que aporta cada plugin proceden de la autodescripción del propio plugin, leída de la caché de describe en disco indexada por digest (cargar el guest es el recurso alternativo con la caché fría); la lista solo lleva la fijación. Al invocar el comando, los bytes resueltos se vuelven a someter a hash y se comparan con digest; una discrepancia detiene el comando de forma bien visible e indica volver a fijarlo, de modo que un plugin cuyos bytes han cambiado desde que se fijó nunca se ejecuta sin que se note. Valor predeterminado: []

No se permiten propiedades adicionales.

aggrega-config.lint

Ajustes de rigor por regla.

PropiedadTipoObligatoriaDescripción
publishing_disciplineobjectnoConmutadores para todo el espacio de trabajo sobre el conjunto de reglas del linter de publicación. Los flags allow_* relajan comprobaciones disuasorias individuales. La inmutabilidad de los artefactos no se puede configurar aquí: aggrega push se niega incondicionalmente a sobrescribir una versión publicada.

No se permiten propiedades adicionales.

aggrega-config.lint.publishing_discipline

Conmutadores para todo el espacio de trabajo sobre el conjunto de reglas del linter de publicación. Los flags allow_* relajan comprobaciones disuasorias individuales. La inmutabilidad de los artefactos no se puede configurar aquí: aggrega push se niega incondicionalmente a sobrescribir una versión publicada.

PropiedadTipoObligatoriaDescripción
allow_dynamic_refsbooleanonoCuando es true, el linter de publicación acepta las construcciones de JSON Schema $dynamicRef / $dynamicAnchor en el contenido del catálogo. De forma predeterminada es false; estas construcciones se desaconsejan porque hacen que la composición de esquemas en tiempo de compilación no sea local. Valor predeterminado: false
allow_id_overridesbooleanonoCuando es true, el linter de publicación acepta sobrescrituras de $id en subesquemas dentro del contenido de esquema de una entidad. De forma predeterminada es false; las sobrescrituras de $id rompen la convención de un identificador canónico por esquema en la que se apoyan tanto el resolvedor como el validador de JSON Schema. Valor predeterminado: false
allow_direct_x_aggrega_extensionsbooleanonoCuando es true, la comprobación disuasoria en tiempo de compilación acepta las palabras clave x-aggrega-selector y x-aggrega-inject escritas directamente en el contenido del esquema. De forma predeterminada es false; la vía de autoría recomendada es usesSchema (para sockets de dependencia) o featuresSchema (para enlaces de credenciales), que el compilador compone en esas palabras clave. Valor predeterminado: false
allow_aggrega_ai_prefixbooleanonoCuando es true, el linter de publicación acepta claves de anotación que usan los espacios de nombres reservados aggrega.ai/ y feature.aggrega.ai/ fuera de sus contextos canónicos. La regla de prefijos reservados controla los metadata.annotations de las entidades de catálogo: el prefijo simple aggrega.ai/ es nativo de la plataforma (las claves de anotación bien conocidas están exentas independientemente de este flag); el prefijo feature.aggrega.ai/ es canónico solo en el tipo Feature. De forma predeterminada es false. Los operadores lo establecen cuando las herramientas empresariales necesitan legítimamente usar un prefijo reservado; relaja ambos prefijos a la vez. Valor predeterminado: false
allow_nonstandard_namesbooleanonoCuando es true, el linter de publicación acepta nombres de entidades de catálogo que no siguen las convenciones de nomenclatura documentadas del proyecto. De forma predeterminada es false; una nomenclatura coherente es fundamental para el resolvedor, la selección por etiquetas y la ergonomía de los revisores. Valor predeterminado: false
allow_category_mismatchesbooleanonoCuando es true, el linter de publicación suprime la regla category-matches-directory. La convención del catálogo estándar exige que los Components bajo core// declaren component.aggrega.ai/category={category} coincidente con el segmento del directorio, donde {category} es uno de los valores de un conjunto cerrado (como ai-agent, ai-model, ai-tool, datastore, gateway, compute, …). Los espacios de trabajo con excepciones persistentes legítimas se excluyen aquí. De forma predeterminada es false. Valor predeterminado: false
allow_undeclared_recipe_providesbooleanonoCuando es true, el linter de publicación suprime la regla provides-declared-by-component. Esa regla informa de cada clave que una Recipe publica en spec.provides y que el Component nombrado por su spec.implements no declara en el pilar provides de su spec.schema. Las dos son superficies separadas: lo que una Recipe publica es el valor que recibe un consumidor, mientras que lo que el Component declara es el contrato de salida con el que se comprueba una referencia inject from: — de modo que una clave publicada sin estar declarada hace que esa referencia se detenga. Por lo demás, una Recipe que publica más de lo que declara su Component se acepta en tiempo de compilación, y por eso el hallazgo es orientativo y no un rechazo a publicar. De forma predeterminada es false. Valor predeterminado: false
allow_connection_credential_mismatchesbooleanonoCuando es true, el linter de publicación suprime la regla connection-credential-matches-target-key, que aggrega lint --release ejecuta sobre la Release que nombra: la Release, el Aggregate que despliega y los Components que usan las instancias de ese Aggregate. Para cada conexión cuyo destino declara la clave que exige a sus llamadores, la regla compara aquello a lo que hacen referencia los dos extremos: la credencial que presenta la conexión y la clave que el destino guarda en su propia ranura. Informa de dos extremos que nombran secretos distintos y de una clave declarada en un solo extremo, y nunca cita ninguno de los dos. Ninguno de los extremos puede ver las vinculaciones del otro, así que ambos coinciden solo por disciplina de autoría — normalmente un único parámetro que alimenta a ambos — y una compilación los acepta en cualquier caso, y por eso el hallazgo es orientativo. Un espacio de trabajo cuyos dos extremos difieren deliberadamente se excluye aquí. De forma predeterminada es false. Valor predeterminado: false

No se permiten propiedades adicionales.

aggrega-config.parse_cache

Topes de expulsión de la caché de análisis del daemon. Ambos topes se aplican simultáneamente — el bucle de expulsión LRU se ejecuta después de cada inserción en la caché y elimina las entradas usadas menos recientemente hasta que tanto el número de entradas como el total de bytes están dentro de los límites. Cero en cualquiera de los dos significa unbounded on that axis, útil en escenarios de CI en los que la caché solo vive durante una invocación. Distinto de artifact_cache_dir, que es la caché de contenido en disco.

PropiedadTipoObligatoriaDescripción
max_entriesintegernoTope del número de análisis en caché. De forma predeterminada es 1000. 0 desactiva el eje del número de entradas (ninguna expulsión provocada por el número de entradas). Mínimo: 0. Valor predeterminado: 1000
max_bytesintegernoTope del tamaño acumulado, en bytes, de los documentos que contiene la caché. De forma predeterminada es 100000000 (100 MB). 0 desactiva el eje de bytes (ninguna expulsión provocada por el total de bytes). Mínimo: 0. Valor predeterminado: 100000000

No se permiten propiedades adicionales.

aggrega-config.compiled_module_cache

Tope de tamaño para la caché en disco de módulos compilados, el almacén de código máquina que el compilador reutiliza para que un plugin Wasm se compile una vez por máquina en lugar de una vez por compilación. Se comparte entre todos los espacios de trabajo de la máquina, así que esta clave va en el archivo de configuración global cuando quieres una única respuesta para toda la máquina. El tope se aplica una vez por invocación, antes de cargar ningún plugin, eliminando entradas completas empezando por las compiladas hace más tiempo hasta que el resto cabe — nunca mientras una compilación está en curso. Eliminar una entrada cuesta una recompilación posterior y nada más, así que es seguro bajar el tope. aggrega cache status informa del tamaño actual del almacén, y aggrega cache evict --max-size lo recorta bajo demanda a un tope indicado en la línea de comandos. Distinto de artifact_cache_dir (contenido obtenido de los registros) y de parse_cache (la caché de análisis en memoria del daemon).

PropiedadTipoObligatoriaDescripción
max_bytesintegernoTope de los bytes que la caché de módulos compilados ocupa en disco. De forma predeterminada es 53687091200 (50 GiB), un techo que detiene un crecimiento ilimitado y no un presupuesto pensado para notarse — un solo plugin compilado alcanza cientos de megabytes, así que una máquina que compila muchas versiones de plugins acumula gigabytes. Establécelo por encima de lo que se compila en una compilación: el tope se aplica antes de que una compilación compile nada, así que un tope inferior al propio conjunto de trabajo de una sola compilación hace que cada compilación descarte y vuelva a compilar los mismos módulos, y el almacén deja de ahorrar nada. Como el tope se aplica primero y la compilación escribe después lo que compila, el almacén puede quedar por encima del tope entre compilaciones; se vuelve a recortar al inicio de la siguiente. 0 desactiva el tope (el almacén crece sin límite y nunca se elimina nada automáticamente). Como el almacén es un único directorio que comparten todos los espacios de trabajo, este tope no es por proyecto aunque lo lleve el propio archivo de un proyecto: el valor se resuelve igual que cualquier otra clave, prevaleciendo el archivo más cercano, pero el almacén sigue teniendo un solo tamaño. El tope vigente es el de la compilación más reciente, así que dos proyectos que lo limitan de forma distinta surten efecto ambos por turnos, y un tope bajo en uno descarta el código máquina que compiló el otro. Establecerlo una vez en el archivo de configuración global es lo que da a toda la máquina una única respuesta. aggrega config show --origin nombra el archivo del que procede el valor efectivo de cada ajuste. Mínimo: 0. Valor predeterminado: 53687091200

No se permiten propiedades adicionales.

aggrega-config.concurrency

Ajustes de concurrencia del despacho de solicitudes del daemon. El daemon lee las solicitudes de un único flujo stdin y ejecuta cada una a través de un pool de workers que vacía una cola de solicitudes acotada; las respuestas se emiten en el orden de llegada de las solicitudes, independientemente del orden de finalización.

PropiedadTipoObligatoriaDescripción
pool_sizeintegernoNúmero de workers que atienden la cola de solicitudes. De forma predeterminada es 4, lo que despacha hasta cuatro solicitudes a la vez; establécelo en 1 para ejecutar las solicitudes en serie en orden de llegada. Un valor inferior a 1 se eleva a 1 cuando se inicia el daemon. Mínimo: 1. Valor predeterminado: 4

No se permiten propiedades adicionales.

aggrega-config.serve

Ajustes de comportamiento del daemon (aggrega serve) para el compilador como servicio que consumen las integraciones con IDE.

PropiedadTipoObligatoriaDescripción
build_on_inspectbooleanonoIndica si el daemon ejecuta la etapa de renderizado de artefactos al inspeccionar un grafo IR, de modo que los avisos informativos que aggrega build emite al renderizar también aparezcan como problemas del editor. No añade ninguna de las comprobaciones por las que se detiene una compilación. En ningún caso se escribe nada en disco — ni artefactos renderizados, ni directorio de salida, ni archivo de bloqueo — y la etapa de renderizado nunca modifica el grafo, de modo que, donde la inspección responde con uno, es el mismo grafo en ambos casos. De forma predeterminada es false, en consonancia con aggrega inspect: el comando de terminal no llega a la etapa de renderizado al inspeccionar un grafo, así que tampoco emite ningún aviso de ese tipo, y una inspección en el editor que no emite ninguno te muestra lo mismo que el terminal. Establécelo en true para pedir al editor esa capa adicional. Valor predeterminado: false
lint_on_validatebooleanonoIndica si el daemon ejecuta la comprobación de las convenciones de publicación al validar una entidad de catálogo, de modo que los hallazgos que aggrega lint notifica sobre esa entidad también aparezcan como problemas del editor. Los hallazgos son informativos: un documento que los recibe sigue validándose, y su Release sigue resolviéndose y renderizándose. Solo se ejecuta la comprobación que lee contenido local — no se consulta ningún registro, no se obtiene nada y no se escribe nada — y se evalúa sobre el búfer que tiene el editor y no sobre el archivo en disco, de modo que un nombre que corriges deja de notificarse antes de que guardes. De forma predeterminada es false: una sesión del editor informa de si un documento es correcto y no dice nada sobre si una entidad es publicable, hasta que pidas esa segunda capa. Establécelo en true para pedirla. Con independencia de esta clave, un editor siempre puede pedir la comprobación directamente, y así es también como se llega a la comparación, previa a la publicación, con la versión publicada anteriormente. Valor predeterminado: false

No se permiten propiedades adicionales.

aggrega-config.mcp

Ajustes del servidor Model Context Protocol (aggrega mcp). transport elige cómo se llega al servidor — a través de la entrada y la salida estándar del proceso, o a través de HTTP — y se lee elija lo que elija. announce_tools también se lee en ambos transportes, porque qué herramientas se ofrecen a un cliente es una propiedad del servidor y no de cómo llegó a él un cliente. Cualquier otra clave configura el listener que inicia el transporte HTTP y no se usa mientras el servidor se comunica a través de la entrada y la salida estándar — listen incluido, que allí solo se lee para que el servidor pueda indicar, en una línea en su flujo de errores, que la dirección no se usa. Cada clave de abajo indica de cuál se trata. Distinto de serve, que configura el daemon de backend del editor.

PropiedadTipoObligatoriaDescripción
transportstring (enum)noCómo se llega al servidor: stdio habla el protocolo a través de la entrada y la salida estándar del proceso, que es como llega a él un cliente que inicia el comando como subproceso; http lo sirve por HTTP en la dirección que nombra listen, y por HTTPS donde tls nombra un certificado y una clave. aggrega mcp --transport stdio|http sobrescribe esta clave para una sola invocación. De forma predeterminada es stdio, así que un espacio de trabajo que nunca nombra un transporte se sirve a través de la entrada y la salida estándar, lleve lo que lleve además este bloque — un listener solo se inicia donde se elige http, aquí o en la línea de comandos. Cualquier otro valor se rechaza al cargar la configuración. Establece http en la configuración de un servidor al que los llamadores llegan a través de la red, y deja la clave sin establecer donde es un cliente el que inicia el servidor: con stdio elegido, una dirección en listen no se usa, y el servidor lo indica en una línea en su flujo de errores. Valores permitidos: "stdio", "http" Valor predeterminado: "stdio"
listenstringnoDirección a la que se enlaza el listener cuando se elige el transporte HTTP. Nombra dónde escuchar y no elige nada: elegir el transporte le corresponde a transport, y con stdio elegido esta clave no se usa. Se aceptan dos formas: host:port para una dirección TCP, y unix: seguido de una ruta del sistema de archivos para un socket de dominio Unix. aggrega mcp --listen <address> sobrescribe esta clave para una sola invocación. De forma predeterminada está vacía, y el transporte HTTP necesita una dirección de uno u otro: sin ninguno de los dos, un inicio que lo elige se rechaza antes de que se enlace nada. Una dirección en texto plano — una a la que se llega sin certificado ni clave bajo tls — solo se acepta en una dirección de loopback (127.0.0.1, ::1, o localhost que se resuelva en una de ellas) o en un socket Unix, que es la forma que usa un servidor cuando un proxy situado delante termina TLS; cualquier otra dirección se rechaza antes de que se enlace nada, nombrando mcp.tls.cert_file y mcp.tls.key_file. Esas mismas dos formas son las únicas aceptadas, con certificado o sin él, donde está establecido authorization.trusted_proxy, porque solo se puede confiar en una cabecera como credencial donde nada salvo el proxy puede establecerla. Valor predeterminado: ""
tlsobjectnoCertificado y clave para terminar TLS dentro del proceso que sirve. Establece ambos para servir HTTPS directamente desde el listener que nombra listen. Deja ambos sin establecer para servir en texto plano, lo que limita listen a una dirección de loopback o a un socket Unix — la forma que conviene usar cuando un proxy situado delante tiene el certificado. Ambas claves son rutas a archivos en disco; ninguna contiene material de clave inline.
allowed_originsstring[]noOrígenes aceptados en la cabecera Origin de una solicitud. Una solicitud cuya cabecera Origin nombra un origen que esta lista no contiene se rechaza con 403; una solicitud que nombra un origen de la lista, o que no lleva ninguna cabecera Origin, se sirve. Cada entrada se compara exactamente con la cabecera, así que cada una se escribe como un navegador envía un origen: un esquema en minúsculas, ://, un host en minúsculas — un nombre, una dirección IPv4 o una dirección IPv6 entre corchetes — y : con el puerto cuando no es el predeterminado del esquema, sin nada después. Por ejemplo https://app.example.com o http://localhost:3000. Una entrada con cualquier otra forma nunca podría ser igual a lo que envía un navegador, así que se rechaza al cargar el archivo de configuración, nombrando el archivo y la entrada: una con una / final o una ruta (https://app.example.com/), una sin esquema (app.example.com) y una que contiene una mayúscula o un espacio. De forma predeterminada está vacía, así que no se acepta ningún origen y solo se sirve a un llamador que no envía ninguna cabecera Origin. Por tanto, un cliente basado en navegador necesita que su origen figure aquí; un cliente que no es un navegador no envía esa cabecera y no necesita ninguna entrada. Cada entrada coincide con el patrón ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$. Valor predeterminado: []
limitsobjectnoTopes que el listener HTTP aplica al tráfico que acepta, para que un solo llamador no pueda agotar el proceso que sirve. Limitan el tamaño que puede tener una sola solicitud, cuántas solicitudes se ejecutan a la vez y a qué velocidad puede enviar un llamador. Ninguno de ellos se puede desactivar.
authorizationobjectnoLo que este servidor declara sobre los bearer tokens que presentan sus llamadores: qué servidor de autorización los emite, la dirección que este servidor publica para sí mismo como el recurso para el que se emiten, opcionalmente un archivo del que leer las claves de verificación de ese servidor, y opcionalmente las cabeceras que establece un proxy situado delante cuando es ese proxy el que valida los tokens. issuer y resource son obligatorios siempre que se elige el transporte HTTP, y sin ellos un listener se rechaza antes de que se enlace nada; un servidor que se comunica a través de la entrada y la salida estándar no lee ninguno de ellos. Ambos se publican en el documento de metadatos OAuth del recurso protegido que sirve el listener, que es la única respuesta que recibe un llamador HTTP sin que se le pida ninguna credencial, porque un cliente lo lee para averiguar dónde obtener un token. Este bloque no contiene material secreto: un llamador presenta un token en la solicitud que hace y nunca es un campo de configuración, y jwks_file nombra claves de verificación públicas y no nada que firme.
deny_reachstring (enum)[]noTipos de alcance que este servidor no ofrece, diga lo que diga el token de un llamador. Cada operación declara hasta dónde llegan sus propios efectos — none para una que lee o renderiza y no deja nada tras de sí, workspace para una que escribe dentro del espacio de trabajo que sirve este proceso, registry para una que publica, firma o retira, y machine para una que cambia lo que comparten todos los espacios de trabajo del host — y nombrar un tipo aquí retira de este servidor todas las herramientas de ese tipo. Una herramienta retirada no aparece en la lista de herramientas ni en lo que responde describe-capabilities, para ningún llamador, y llamarla de todos modos se rechaza nombrando este ajuste, porque ningún scope podría admitirla. De forma predeterminada está vacío, así que el servidor ofrece todo lo que admiten los scopes de sus llamadores. Es un límite que el servidor se impone a sí mismo, además del límite por llamador que fijan los scopes: un servidor que sirve lecturas y nada más nombra aquí los tres tipos que escriben y entonces no puede publicar ni siquiera para un llamador cuyo token lleva todos los scopes. Nombrar machine se acepta y no cambia nada — no se ofrece ninguna herramienta de ese tipo por HTTP en absoluto, lo cual es una propiedad del transporte y no un ajuste. Se lee al iniciarse el listener: un valor fuera de los cuatro se rechaza al cargar la configuración, y cambiarlo requiere un reinicio. No se lee en absoluto mientras el servidor se comunica a través de la entrada y la salida estándar, donde el llamador es la persona que inició el proceso. Valores permitidos para cada entrada: "none", "workspace", "registry", "machine". Valor predeterminado: []
announce_toolsstring[]noHerramientas que este servidor anuncia, nombradas exactamente como las indica la lista de herramientas. Si omites la clave, se anuncian todas las herramientas que ofrece este servidor, que es lo que espera un cliente que sigue el protocolo: obtiene la lista completa de herramientas y decide por sí mismo qué parte presentar a un modelo. Si escribes una lista, se anuncian exactamente esas herramientas — una que se deje fuera no aparece en la lista de herramientas, no aparece en lo que responde describe-capabilities, y se rechaza cuando se la llama por su nombre, nombrando este ajuste. Si escribes una lista vacía, no se anuncia nada. Establece la clave donde el cliente del otro extremo limita cuántas herramientas registrará — algunos clientes aplican ese tope a todos los servidores a los que están conectados a la vez — y nombra las herramientas que ese cliente necesita. Restringe lo que se anuncia y nada más: no puede ampliar deny_reach, que retira una capacidad por completo, ni los scopes que lleva el token de un llamador. Una herramienta nombrada aquí de un tipo que deny_reach retira queda fuera de la lista de herramientas y se rechaza cuando se la llama, nombrando ese ajuste; una nombrada aquí que los scopes del llamador no admiten sigue apareciendo en la lista, y una llamada a ella se rechaza nombrando el scope que la admitiría. Cada nombre debe ser uno que ofrezca este binario: un nombre al que no responde ninguna herramienta se rechaza al iniciarse el servidor, porque de lo contrario quien pidió una superficie más reducida recibiría una distinta sin que nada lo indicara. Un nombre de la familia cli-, que ejecuta un comando aggrega en un proceso separado, se acepta en ambos transportes y no anuncia nada por HTTP, donde no se ofrece ninguna herramienta de ese tipo a ningún llamador. Se lee en ambos transportes al iniciarse el servidor, así que el conjunto anunciado queda fijo durante toda la vida del proceso y cambiarlo requiere un reinicio.
healthobjectnoDónde un supervisor pregunta si este proceso está vivo y si está listo para responder a una llamada. Las dos comprobaciones se responden en una dirección propia y nunca en la dirección que nombra listen: cada solicitud al endpoint lleva un bearer token, así que una sonda respondida allí daría a cualquier cosa que pueda llegar al endpoint una lectura no autenticada del proceso junto con una forma gratuita de hacerlo trabajar. El endpoint responde a /healthz y /readyz con el mismo 404 que da a toda ruta que no sirve, con token y sin él por igual.

No se permiten propiedades adicionales.

aggrega-config.mcp.tls

Certificado y clave para terminar TLS dentro del proceso que sirve. Establece ambos para servir HTTPS directamente desde el listener que nombra listen. Deja ambos sin establecer para servir en texto plano, lo que limita listen a una dirección de loopback o a un socket Unix — la forma que conviene usar cuando un proxy situado delante tiene el certificado. Ambas claves son rutas a archivos en disco; ninguna contiene material de clave inline.

PropiedadTipoObligatoriaDescripción
cert_filestringnoRuta a la cadena de certificados PEM que presenta el listener, leída al iniciarse el proceso. Se establece junto con key_file. De forma predeterminada está vacía, así que el listener sirve en texto plano y listen queda limitado a una dirección de loopback o a un socket Unix. Valor predeterminado: ""
key_filestringnoRuta a la clave privada PEM del certificado de cert_file, leída al iniciarse el proceso. Se establece junto con ese ajuste. Una ruta a un archivo, nunca material de clave inline. De forma predeterminada está vacía, así que el listener sirve en texto plano y listen queda limitado a una dirección de loopback o a un socket Unix. Valor predeterminado: ""

No se permiten propiedades adicionales.

aggrega-config.mcp.limits

Topes que el listener HTTP aplica al tráfico que acepta, para que un solo llamador no pueda agotar el proceso que sirve. Limitan el tamaño que puede tener una sola solicitud, cuántas solicitudes se ejecutan a la vez y a qué velocidad puede enviar un llamador. Ninguno de ellos se puede desactivar.

PropiedadTipoObligatoriaDescripción
max_body_bytesintegernoCuerpo de solicitud más grande que acepta el listener, en bytes. Una solicitud cuyo cuerpo lo supera se rechaza con 413, y el cuerpo no se lee más allá del tope. De forma predeterminada es 4194304 (4 MiB), muy por encima de una llamada a una herramienta que lleva un documento de autoría completo y muy por debajo de lo que permitiría a un solo llamador ocupar una parte significativa de la memoria del proceso. El mínimo es 1, así que no hay ningún valor que desactive el tope; súbelo donde los llamadores envían legítimamente documentos más grandes. Mínimo: 1. Valor predeterminado: 4194304
max_concurrent_requestsintegernoCuántas solicitudes ejecuta el listener a la vez. Una solicitud que llega cuando ya hay esa cantidad en curso se rechaza con 503 en lugar de ponerse en cola, de modo que a un llamador se le indica que reintente en lugar de esperar detrás de un trabajo que no puede ver. De forma predeterminada es 16, lo que deja margen para varias llamadas a herramientas simultáneas manteniendo ágil un host pequeño; súbelo en un host más grande. El mínimo es 1, así que no hay ningún valor que desactive el tope. Mínimo: 1. Valor predeterminado: 16
requests_per_minuteintegernoCuántas solicitudes puede enviar un llamador en un minuto. Se cuenta por llamador y no por servidor — frente al sujeto que nombra el token del llamador, o frente a la identidad que afirmó un proxy de confianza — de modo que un llamador muy activo no puede gastar la asignación de otro. Un llamador puede enviar esa cantidad de golpe; la asignación se repone después de forma constante, a razón de una solicitud más cada 60 / requests_per_minute segundos, y una solicitud que llega sin que quede ninguna disponible se rechaza con 429. De forma predeterminada es 120, es decir, dos por segundo de forma sostenida: muy por encima de lo que envía un asistente que maneja un espacio de trabajo, y aun así un límite para un cliente que ha entrado en un bucle. El mínimo es 1, así que no hay ningún valor que desactive el tope. Mínimo: 1. Valor predeterminado: 120

No se permiten propiedades adicionales.

aggrega-config.mcp.authorization

Lo que este servidor declara sobre los bearer tokens que presentan sus llamadores: qué servidor de autorización los emite, la dirección que este servidor publica para sí mismo como el recurso para el que se emiten, opcionalmente un archivo del que leer las claves de verificación de ese servidor, y opcionalmente las cabeceras que establece un proxy situado delante cuando es ese proxy el que valida los tokens. issuer y resource son obligatorios siempre que se elige el transporte HTTP, y sin ellos un listener se rechaza antes de que se enlace nada; un servidor que se comunica a través de la entrada y la salida estándar no lee ninguno de ellos. Ambos se publican en el documento de metadatos OAuth del recurso protegido que sirve el listener, que es la única respuesta que recibe un llamador HTTP sin que se le pida ninguna credencial, porque un cliente lo lee para averiguar dónde obtener un token. Este bloque no contiene material secreto: un llamador presenta un token en la solicitud que hace y nunca es un campo de configuración, y jwks_file nombra claves de verificación públicas y no nada que firme.

PropiedadTipoObligatoriaDescripción
issuerstringnoDirección del servidor de autorización que emite los tokens que acepta este listener, escrita tal como ese servidor declara su propio identificador de emisor — por ejemplo https://login.example.com. Se publica en la lista authorization_servers del documento de metadatos del recurso protegido, que es como un cliente averigua dónde obtener un token para este listener. De forma predeterminada está vacía, lo que no es un valor utilizable: un listener se rechaza antes de que se enlace nada a menos que esta clave contenga una dirección completa, con esquema y host incluidos. Es una dirección https salvo que el servidor de autorización se ejecute en esta máquina: http simple solo se acepta para un host de loopback, como localhost, 127.0.0.1 o ::1, y un emisor http simple en cualquier otro host se rechaza antes de que se enlace nada, nombrando esta clave y pidiendo una dirección https. Esto se cumple tanto si las claves se leen del emisor o de jwks_file como si un trusted_proxy situado delante comprueba los tokens, porque todo cliente se envía al emisor para obtener su token. Valor predeterminado: ""
resourcestringnoDirección que este servidor publica para sí mismo, tal como llega a él un llamador — por ejemplo https://mcp.example.com/mcp. Escribe la dirección que los llamadores usan realmente, incluido el host que presenta un proxy situado delante, porque este es el identificador que un cliente entrega al servidor de autorización cuando pide un token para este servidor, y se publica sin cambios como el campo resource del documento de metadatos del recurso protegido. El lugar donde se sirve ese documento se deriva de ella, insertando /.well-known/oauth-protected-resource entre el host y la ruta: un servidor publicado como https://mcp.example.com/mcp lo sirve en https://mcp.example.com/.well-known/oauth-protected-resource/mcp, y también en esa ruta well-known sin nada después, que es donde un cliente busca en segundo lugar. Un token solo se acepta cuando esta dirección está entre las audiencias que nombra. De forma predeterminada está vacía, lo que no es un valor utilizable: un listener se rechaza antes de que se enlace nada a menos que esta clave contenga una dirección completa, con esquema y host incluidos. Valor predeterminado: ""
jwks_filestringnoRuta a un archivo que contiene el JSON Web Key Set con el que se verifican los tokens que acepta este servidor, leído al iniciarse el proceso. De forma predeterminada está vacía, que es el caso habitual: las claves se leen del propio servidor de autorización, preguntando a issuer dónde las publica y obteniéndolas de la dirección que indica, y se vuelven a leer una vez cuando llega un token firmado con un identificador de clave que el conjunto que se tiene no contiene. Establece esta clave donde el espacio de trabajo está sin conexión, en cuyo caso sin ella un listener se rechaza antes de que se enlace nada, porque un espacio de trabajo sin conexión no hace ninguna solicitud de red y no hay otra forma de obtener las claves; el archivo contiene entonces las únicas claves aceptadas, y nunca se contacta con el servidor de autorización. El archivo contiene claves de verificación públicas y nunca nada que firme. Una ruta relativa se resuelve con respecto al directorio del archivo de configuración que la declaró. Valor predeterminado: ""
trusted_proxyobjectnoLee quién es un llamador a partir de las cabeceras que establece un proxy situado delante, en lugar de validar aquí un bearer token. Establécelo solo donde se cumplen ambas condiciones: un proxy situado delante valida los tokens por sí mismo, y nada salvo ese proxy puede llegar al listener: con esta clave establecida, listen debe ser una dirección de loopback o un socket Unix, y cualquier otra dirección se rechaza antes de que se enlace nada, nombrando ambos ajustes. Una cabecera es de confianza exactamente en la medida del conjunto de llamadores que pueden establecerla, y en una dirección a la que llega la red cualquier llamador puede establecer cualquier cabecera que quiera, así que un listener en este modo en una dirección así permitiría a cualquier llamador afirmar que es cualquiera. Con esta clave establecida no se lee ningún token en absoluto — ni de la cabecera Authorization, ni de ningún otro sitio, y no se obtiene ningún conjunto de claves —, la identidad del llamador es el valor de principal_header, una solicitud que no lleva esa cabecera recibe la respuesta 401, y las dos cabeceras nombradas aquí son las únicas que se leen. Si la omites, que es el valor predeterminado, este servidor valida los bearer tokens por sí mismo.

No se permiten propiedades adicionales.

aggrega-config.mcp.authorization.trusted_proxy

Lee quién es un llamador a partir de las cabeceras que establece un proxy situado delante, en lugar de validar aquí un bearer token. Establécelo solo donde se cumplen ambas condiciones: un proxy situado delante valida los tokens por sí mismo, y nada salvo ese proxy puede llegar al listener: con esta clave establecida, listen debe ser una dirección de loopback o un socket Unix, y cualquier otra dirección se rechaza antes de que se enlace nada, nombrando ambos ajustes. Una cabecera es de confianza exactamente en la medida del conjunto de llamadores que pueden establecerla, y en una dirección a la que llega la red cualquier llamador puede establecer cualquier cabecera que quiera, así que un listener en este modo en una dirección así permitiría a cualquier llamador afirmar que es cualquiera. Con esta clave establecida no se lee ningún token en absoluto — ni de la cabecera Authorization, ni de ningún otro sitio, y no se obtiene ningún conjunto de claves —, la identidad del llamador es el valor de principal_header, una solicitud que no lleva esa cabecera recibe la respuesta 401, y las dos cabeceras nombradas aquí son las únicas que se leen. Si la omites, que es el valor predeterminado, este servidor valida los bearer tokens por sí mismo.

PropiedadTipoObligatoriaDescripción
principal_headerstringsíCabecera en la que el proxy situado delante pone la identidad del llamador — por ejemplo X-Forwarded-User. Se escribe como un nombre de cabecera HTTP: letras, dígitos y guiones, y los demás caracteres que puede llevar un nombre de cabecera (!#$%&'*+.^_|~ y el acento grave), sin espacios, dos puntos ni otro separador. Un nombre con cualquier otra forma se rechaza al cargar el archivo de configuración, nombrando el archivo y la clave, porque ninguna solicitud puede llevar una cabecera así. Uno vacío también se rechaza: dejaría a este servidor comprobando los tokens por sí mismo mientras el bloque dice que lo hace un proxy situado delante. Para dejar este modo desactivado, omite trusted_proxy. El valor de la cabecera se toma exactamente como está escrito y no se compara con nada, del mismo modo que el sujeto de un token que este servidor valida por sí mismo se registra y no se compara con nada. En este modo es la credencial completa, así que es obligatorio siempre que trusted_proxy está establecido, y una solicitud que llega sin ella recibe la respuesta 401. Patrón: ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$.
scopes_headerstringnoCabecera en la que el proxy situado delante pone los scopes concedidos al llamador, separados por espacios — por ejemplo X-Forwarded-Scopes. Se escribe como un nombre de cabecera HTTP, con la misma forma que principal_header, o se deja vacía. Un nombre con cualquier otra forma se rechaza al cargar el archivo de configuración, nombrando el archivo y la clave, porque ninguna solicitud puede llevar una cabecera así y a ningún llamador se le concedería nunca un scope. De forma predeterminada está vacía, lo que no afirma ningún scope para ningún llamador. Se llame como se llame, no se lee ninguna cabecera distinta de esta y de principal_header. Patrón: ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. Valor predeterminado: ""

No se permiten propiedades adicionales.

aggrega-config.mcp.health

Dónde un supervisor pregunta si este proceso está vivo y si está listo para responder a una llamada. Las dos comprobaciones se responden en una dirección propia y nunca en la dirección que nombra listen: cada solicitud al endpoint lleva un bearer token, así que una sonda respondida allí daría a cualquier cosa que pueda llegar al endpoint una lectura no autenticada del proceso junto con una forma gratuita de hacerlo trabajar. El endpoint responde a /healthz y /readyz con el mismo 404 que da a toda ruta que no sirve, con token y sin él por igual.

PropiedadTipoObligatoriaDescripción
listenstringnoDirección en la que se responden las comprobaciones de actividad y de disponibilidad, en las mismas dos formas que admite listen: host:port, o unix: seguido de una ruta del sistema de archivos. De forma predeterminada está vacía, así que no se inicia ningún segundo listener y ninguna de las dos comprobaciones se responde en ningún sitio. Con una dirección establecida, GET /healthz se responde con 200 desde el momento en que el proceso está en ejecución, y GET /readyz se responde con 503 hasta que el espacio de trabajo se ha resuelto y el endpoint se ha enlazado, y con 200 a partir de entonces — que es la distinción que necesita un supervisor, ya que un proceso que está en marcha aún no es un proceso que pueda responder a una llamada. Cada respuesta es un código de estado con el cuerpo vacío, no se pide ningún token y no se lee ninguna cabecera; cualquier otra ruta en esta dirección da 404, y cualquier otro método en estas dos da 405. A diferencia de listen, esta dirección no está limitada al loopback o a un socket Unix y no se rechaza ninguna dirección para ella: apúntala a una de esas, que es para lo que existe, y ten en cuenta que cualquier cosa que pueda llegar a la dirección que elijas puede leer esas dos respuestas. Valor predeterminado: ""

No se permiten propiedades adicionales.

Definiciones

ReleaseCatalogConfig

Los directorios de catálogo propios de una Release: las mismas dos claves que lleva el bloque workspace, con ámbito limitado a esa Release.

PropiedadTipoObligatoriaDescripción
catalog_dirsstring[]noDirectorios de catálogo desde los que esta Release lee las entidades locales en lugar del catalog_dirs del espacio de trabajo, cada uno resuelto de forma relativa al archivo que lo declara. La misma pila de búsqueda ordenada en la que gana la primera coincidencia que la lista del espacio de trabajo, con el directorio catalog de la raíz del espacio de trabajo leído después de ella cuando ese directorio existe y ninguna entrada listada lo contiene ya. Si se omite esta clave, la Release conserva la lista del espacio de trabajo; si se escribe como [], no se lee ningún catálogo local.
catalog_dirs_appendstring[]noDirectorios de catálogo añadidos después de la lista de esta Release — su propio catalog_dirs donde la entrada escribe uno, el del espacio de trabajo en caso contrario —, cada uno resuelto de forma relativa al archivo que lo declara. Valor predeterminado: []

No se permiten propiedades adicionales.

RegistryConfig

Ajustes y política de confianza de firmas con ámbito limitado a un único host de registro OCI.

PropiedadTipoObligatoriaDescripción
hoststringsíEl host de registro al que se aplican estos ajustes (p. ej. hub.aggrega.ai). Se compara con el host de registro del destino del push/pull, así que se escribe en la grafía en la que se hace esa comparación: un nombre de host en minúsculas que contiene un punto, localhost, un único nombre seguido de un puerto (registry:5000), una dirección IPv4 o una dirección IPv6 entre corchetes, cada uno con un :port opcional — sin esquema, ruta, credenciales, espacios en blanco ni mayúsculas. El puerto 443 en un host al que se llega por HTTPS es el puerto predeterminado de ese host, y escribirlo se rechaza al cargar la configuración, nombrando el host que debe escribirse sin él, porque una entrada escrita así nunca sería la que se encuentra; a localhost y a las demás direcciones de loopback se llega por HTTP simple, así que allí 443 es un puerto ordinario y se conserva. aggrega registry add y aggrega config init --registry indexan la entrada bajo el host que nombra su argumento y rechazan uno que no esté escrito así. El host se juzga solo por su grafía: no se comprueba si el nombre se resuelve ni si allí responde un registro. Patrón: ^(?:(?:(?:[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]))$.
namestringnoAlias descriptivo opcional para este registro. El host es la identidad; name es un selector de conveniencia que se resuelve en el host de esta entrada dondequiera que se nombre un registro (por ejemplo --registry, o default_registry). Un alias debe ser único entre las entradas.
trusted_identitiesTrustedIdentity[]noConjunto OR de identidades de firma keyless aceptadas para los artefactos obtenidos mediante pull de este registro. Una firma se verifica cuando su certificado coincide con cualquiera de las entradas. Lo usa la ruta de verificación keyless. Valor predeterminado: []
trusted_deprecation_identitiesTrustedIdentity[]noConjunto OR de identidades keyless aceptadas adicionalmente para firmar un marcador de obsolescencia retroactivo de un artefacto obtenido mediante pull de este registro. Un marcador de obsolescencia se respeta cuando su firma coincide con el firmante del artefacto original OR con cualquier entrada de aquí — de modo que el propietario de un registro o un equipo de seguridad puede retirar un artefacto al que el publicador original ya no puede llegar, sin que se le confíe la firma de los propios artefactos. Lo usa solo la ruta de detección de obsolescencias; nunca amplía el conjunto de confianza para las firmas de artefactos. Valor predeterminado: []
public_keystringnoClave pública fijada compatible con cosign para un registro en modo con clave, escrita inline como un bloque PEM: el texto desde una línea -----BEGIN PUBLIC KEY----- (o -----BEGIN RSA PUBLIC KEY-----) hasta su línea -----END correspondiente, tal como aggrega registry add --key la copia desde un archivo de clave. Cuando está establecida, las firmas de este registro se verifican sin conexión con esta clave en lugar de con identidades keyless. Un valor que no lleva ninguna línea -----BEGIN … PUBLIC KEY----- se rechaza al cargar el archivo de configuración, nombrando el archivo y la entrada, y lo mismo ocurre con una clave privada pegada aquí por error. La línea puede estar en cualquier lugar del valor, porque la clave se lee del bloque PEM que lleva el valor y se ignora cualquier texto anterior a ese bloque. Aquí solo se comprueba esa línea: si el bloque contiene una clave que se decodifica se descubre cuando una firma de este registro se verifica con ella. El valor se declara sensible (x-aggrega-sensitive), así que un valor rechazado — sobre todo una clave privada elegida por error — nunca se cita: el rechazo nombra el archivo, la entrada y la restricción que el valor no cumplió — el patrón anterior, o el tipo string — y muestra <redacted> donde estaría el valor. Una clave pública que se carga se lee y se muestra tal como está escrita. Patrón: -----BEGIN [A-Z ]*PUBLIC KEY-----.
trusted_rootstringnoRuta opcional a un bundle de raíz de confianza de Sigstore fijado, para la verificación keyless en entornos aislados de la red. Cuando está establecida, el ancla de confianza keyless se carga desde este archivo sin red; cuando está vacía, la raíz de confianza public-good se obtiene y se almacena en caché.
advisorybooleanonoCuando es true, un fallo de verificación de firma para este registro se rebaja a una advertencia en lugar de detener el pull. La verificación se sigue ejecutando y el fallo se notifica; el pull continúa. De forma predeterminada es false. Valor predeterminado: false
skip_signature_verificationbooleanonoDesactivación de emergencia (break-glass) por host de la verificación de firmas — el mismo conmutador skip_signature_verification que el global, con ámbito limitado a este host por su ubicación. No anula la política signing.required de nivel superior: una firma exigida por la organización se sigue verificando en este host independientemente de este conmutador; solo el conmutador global puede desactivarla. Establecerlo junto con un signing.required por registro en el mismo host está permitido, y combina una firma exigida en el push con una verificación omitida en el pull: la omisión prevalece en el lado de la verificación, ya que una postura que exige firma propia de un host (a diferencia de la de nivel superior) no es inmune a la omisión por host. De forma predeterminada es false. Valor predeterminado: false
signingSigningConfignoEl bloque de firma de este registro: las URL de los servicios keyless, una ruta opcional de clave para la firma con clave y la postura de confianza por host. Los campos de los endpoints sobrescriben el bloque signing global para los push a este host; un flag de la CLI sobrescribe ambos. required y kinds se leen según la ubicación — bajo una entrada de registro limitan la única postura de confianza a este host (publicar un artefacto sin firmar dentro del ámbito se rechaza, y consumir uno sin firmar se rechaza), el mismo concepto que lleva el bloque signing de nivel superior para todos los registros.

No se permiten propiedades adicionales.

SigningConfig

Un bloque de firma: las URL de los servicios keyless, una referencia opcional a un archivo de clave para la firma con clave y la postura de confianza (required y kinds). Colocado en el nivel superior se aplica a todos los registros; colocado bajo una entrada de registries[] se aplica a ese host — cada campo deduce su ámbito de la ubicación. required es una única postura de confianza que cubre ambas direcciones (un push sin firmar dentro del ámbito se rechaza y un pull sin firmar dentro del ámbito se rechaza). Seguridad: no contiene material secreto — el token de identidad OIDC nunca es un campo de configuración (es de corta duración y se suministra en tiempo de ejecución), y key_path es la ruta a un archivo de clave, nunca bytes de clave inline. Esto refleja la asimetría del lado de la verificación: allí se permite una public_key inline, pero el lado de la firma solo lleva una ruta de clave. Un servidor aggrega mcp al que se llega por HTTP no consulta ningún key_path en ninguna de las dos ubicaciones, así que la firma con clave no es accesible a través de un listener así: una llamada que responde solo firma con un token de identidad que lleva esa llamada.

PropiedadTipoObligatoriaDescripción
fulcio_urlstringnoURL de la autoridad de certificación Fulcio para la firma keyless. Cuando no se establece, se usa la instancia public-good de Fulcio. Se escribe como una URL https absoluta: https://, un host y, opcionalmente, un puerto y una ruta, sin espacios en blanco — por ejemplo https://fulcio.sigstore.dev. Un valor con cualquier otra forma, como uno sin esquema (fulcio.example.com) o uno que empieza por http://, se rechaza al cargar el archivo de configuración, nombrando el archivo y la clave. El archivo se comprueba antes de que se aplique cualquier otra cosa sobre él, así que el mismo endpoint proporcionado por AGGREGA_SIGNING_FULCIO_URL, por el flag --fulcio-url o en una solicitud de publicación desde un editor o un asistente no se somete a esta forma. Patrón: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
rekor_urlstringnoURL del registro de transparencia Rekor para la firma keyless. Cuando no se establece, se usa la instancia public-good de Rekor. Se escribe como una URL https absoluta: https://, un host y, opcionalmente, un puerto y una ruta, sin espacios en blanco — por ejemplo https://rekor.sigstore.dev. Un valor con cualquier otra forma, como uno sin esquema (rekor.example.com) o uno que empieza por http://, se rechaza al cargar el archivo de configuración, nombrando el archivo y la clave. El archivo se comprueba antes de que se aplique cualquier otra cosa sobre él, así que el mismo endpoint proporcionado por AGGREGA_SIGNING_REKOR_URL, por el flag --rekor-url o en una solicitud de publicación desde un editor o un asistente no se somete a esta forma. Patrón: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
timestamp_urlstringnoURL de la autoridad de sellado de tiempo RFC3161 para la firma keyless. No tiene valor predeterminado: cuando no se establece, no se contacta con ninguna autoridad de sellado de tiempo, y la hora de confianza de una firma keyless procede de su entrada en el registro de transparencia. Se escribe como una URL https absoluta: https://, un host y, opcionalmente, un puerto y una ruta, sin espacios en blanco — por ejemplo https://tsa.example.com/api/v1/timestamp. Un valor con cualquier otra forma, como uno sin esquema (tsa.example.com) o uno que empieza por http://, se rechaza al cargar el archivo de configuración, nombrando el archivo y la clave. El archivo se comprueba antes de que se aplique cualquier otra cosa sobre él, así que el mismo endpoint proporcionado por AGGREGA_SIGNING_TIMESTAMP_URL, por el flag --timestamp-url o en una solicitud de publicación desde un editor o un asistente no se somete a esta forma. Patrón: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
key_pathstringnoRuta a un archivo PEM con una clave privada ECDSA P-256 propia para la firma con clave sin conexión. Una ruta a un archivo, nunca material de clave inline. Cuando no se establece, se usa la ruta keyless. Un servidor aggrega mcp al que se llega por HTTP nunca consulta esta clave, dondequiera que esté establecida — en el bloque signing de nivel superior, en el de una entrada de registro o mediante AGGREGA_SIGNING_KEY_PATH: una llamada que responde un listener así solo firma con un token de identidad que lleva la propia llamada, o se rechaza. Un servidor al que se llega a través de la entrada y la salida estándar firma con ella como lo hace un terminal.
requiredbooleanonoLa única postura de confianza para el ámbito de este bloque: cuando es true, publicar un tipo de artefacto dentro del ámbito requiere una firma (un push sin firmar dentro del ámbito se rechaza), y consumir uno requiere una firma (un pull sin firmar dentro del ámbito se rechaza). El ámbito se deduce de la ubicación — en el bloque signing de nivel superior cubre todos los registros; bajo el bloque signing de una entrada de registries[] cubre ese único host. Un nombre, una función, ambos ámbitos. La política de nivel superior se compone de forma monótona a lo largo de la cascada de configuraciones — cualquier capa que la establezca en true la hace efectivamente true, y ninguna capa de menor precedencia puede volver a desactivarla — así que no puede eliminarse con una edición ordinaria de la configuración. De forma predeterminada es false. Valor predeterminado: false
kindsstring[]noLimita required a tipos de artefacto concretos. Vacío o una única entrada all significa todos los tipos firmables; en caso contrario, la postura se aplica exactamente a los tipos enumerados, que coinciden con el valor kind: de la entidad (p. ej. Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). En el bloque signing de nivel superior se compone como una unión a lo largo de la cascada — una capa puede ampliar el ámbito pero nunca reducirlo. El ámbito se deduce de la ubicación, igual que required. Valor predeterminado: []

No se permiten propiedades adicionales.

TrustedIdentity

Una identidad de firma keyless aceptable: un sujeto de certificado (la identidad OIDC) emparejado con el emisor OIDC que la avaló.

PropiedadTipoObligatoriaDescripción
identitystringnoNombre alternativo del sujeto exacto del certificado — la identidad OIDC vinculada al certificado de firma de corta duración (p. ej. el correo electrónico de un mantenedor o la URI de un flujo de trabajo de CI).
identity_regexpstringnoExpresión regular que se compara con el sujeto del certificado, usada en lugar de una identity exacta (p. ej. para aceptar cualquier flujo de trabajo de una organización).
issuerstringsíURL del emisor OIDC que emitió el token de identidad (p. ej. https://accounts.google.com o https://token.actions.githubusercontent.com).

No se permiten propiedades adicionales.

PluginRef

Referencia a un plugin Wasm vinculado en un socket cuya función de entrada puede nombrar la vinculación — las listas governance y linter. Los sockets cuyo punto de entrada es fijo usan en su lugar FixedEntryPluginRef, que lleva estos mismos campos sin function. uri y capability seleccionan juntos el plugin: solo uri es una vinculación directa (el plugin con esa identidad se vincula tal cual — la vía de los sockets transversales, ya que sus plugins no declaran capacidades servidas); solo capability resuelve el plugin que sirve esa capacidad (el nombre simple de la capacidad que una Recipe enlaza mediante spec.capability, p. ej. helm); ambos juntos desambiguan — capability nombra qué resolver y uri selecciona el plugin de qué publicador la sirve, por la identidad simple de ese plugin, en un catálogo federado en el que más de un plugin sirve la capacidad. function sustituye la función de entrada predeterminada del socket; cuando se omite, se aplica el valor predeterminado documentado del socket — en una entrada de gobernanza ese valor predeterminado se deriva de role. role nombra el rol de vinculación de gobernanza y solo se lee en una entrada de gobernanza. with lleva datos de entrada opcionales del momento de la vinculación que lee el plugin.

PropiedadTipoObligatoriaDescripción
uristringnoIdentificador del Plugin: la identidad simple de una entidad Plugin — la ruta <pluginType>/<name>, p. ej. governance/redact o provider/helm —, una ruta del sistema de archivos local o un alias de registro. Opcional: una entrada puede seleccionar en su lugar el plugin mediante capability. Un :version final opcional fija la versión en las mismas tres formas que cualquier fijación de versión (simple, exacta :1.0.0 o rango compatible con la versión mayor :^1.0.0).
rolestring (enum)noEl rol de la pipeline al que está ligada una vinculación de gobernanza, que solo se lee en una entrada governance: annotation-transform inyecta anotaciones en los componentes resueltos antes de la expansión de anotaciones, de modo que las inyecciones ligadas se convierten en vinculaciones de Feature; label-transform asigna automáticamente etiquetas a los nodos del grafo de topología durante la construcción de la topología; ir-verdict emite un veredicto de aceptación o rechazo sobre el grafo IR durante el análisis estático; render-verdict emite un veredicto sobre los artefactos renderizados durante el renderizado. Es el rol — no el tipo declarado del plugin — el que fija lo que el plugin puede emitir: la salida de un rol de veredicto solo puede leerse como un veredicto, nunca aplicarse como un cambio; la salida de un rol de transformación queda confinada por el host a su faceta (anotaciones o etiquetas). También selecciona la función de entrada predeterminada (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Valores permitidos: "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringnoLa capacidad del proveedor para la que esta entrada selecciona un plugin — el nombre simple de la capacidad que una Recipe enlaza mediante spec.capability (p. ej. helm, compose). Opcional: una entrada puede, en su lugar, vincular un plugin directamente mediante uri. Los enlaces del proveedor la usan para seleccionar el plugin de qué publicador sirve una capacidad en un catálogo federado; los sockets transversales la dejan vacía y vinculan mediante uri.
functionstringnoAnulación opcional de la función de entrada predeterminada del socket. Cuando se omite, se aplica el valor predeterminado documentado del socket (gobernanza annotation-transform → transform_annotations, gobernanza label-transform → mutate, gobernanza ir-verdict → verdict_ir, gobernanza render-verdict → verdict_render, linter → lint_rules). La anulación puede nombrar cualquier exportación que declare el plugin, y la exportación que nombra debe devolver la forma de salida que lee ese socket: la compilación se detiene cuando esa salida lleva un campo de nivel superior que la forma no declara, nombrando la exportación llamada y el campo inesperado. La comprobación lee qué nombres de campo de nivel superior están presentes, no cuáles faltan ni qué hay anidado debajo, así que no es una validación completa de la salida.
withPluginRefWithnoDatos de entrada opcionales del momento de la vinculación que lee el plugin. Ambos miembros son opcionales y agnósticos respecto al socket, así que cualquier socket puede reutilizar esta superficie.

No se permiten propiedades adicionales.

FixedEntryPluginRef

Referencia a un plugin Wasm vinculado en un socket cuyo punto de entrada es fijo en lugar de nombrarlo la vinculación — la lista importer y los enlaces providers. Lleva los mismos campos que PluginRef sin function: el socket importador llama a la única función de entrada que nombra el contrato de su socket, y un proveedor dirige un conjunto fijo de exportaciones indexadas por fase en lugar de un único punto de entrada seleccionable, así que en ninguna de las dos listas hay un punto de entrada que function pueda nombrar y la clave no se acepta allí. uri y capability seleccionan juntos el plugin: solo uri es una vinculación directa (el plugin con esa identidad se vincula tal cual — la vía del socket importador, ya que sus plugins no declaran capacidades servidas); solo capability resuelve el plugin que sirve esa capacidad (el nombre simple de la capacidad que una Recipe enlaza mediante spec.capability, p. ej. helm); ambos juntos desambiguan — capability nombra qué resolver y uri selecciona el plugin de qué publicador la sirve, por la identidad simple de ese plugin, en un catálogo federado en el que más de un plugin sirve la capacidad. role se acepta aquí pero no se lee en ninguna de las dos listas a las que sirve esta forma: el rol de vinculación de gobernanza que nombra se lee en una entrada governance, que usa PluginRef, así que un rol establecido en una de estas entradas no tiene efecto. with lleva datos de entrada opcionales del momento de la vinculación que lee el plugin; un enlace del proveedor toma en su lugar su configuración de renderizado de la Recipe, así que with: en uno de ellos se rechaza al cargar.

PropiedadTipoObligatoriaDescripción
uristringnoIdentificador del Plugin: la identidad simple de una entidad Plugin — la ruta <pluginType>/<name>, p. ej. governance/redact o provider/helm —, una ruta del sistema de archivos local o un alias de registro. Opcional: una entrada puede seleccionar en su lugar el plugin mediante capability. Un :version final opcional fija la versión en las mismas tres formas que cualquier fijación de versión (simple, exacta :1.0.0 o rango compatible con la versión mayor :^1.0.0).
rolestring (enum)noEl rol de vinculación de gobernanza. Ninguna de las dos listas que usan esta forma lo lee — el rol se lee en una entrada governance, y esas entradas usan PluginRef — así que un rol establecido aquí se acepta y no tiene efecto. Los valores admitidos son los cuatro roles de gobernanza, y lo que significa cada uno se describe en PluginRef. Valores permitidos: "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringnoLa capacidad del proveedor para la que esta entrada selecciona un plugin — el nombre simple de la capacidad que una Recipe enlaza mediante spec.capability (p. ej. helm, compose). Opcional: una entrada puede, en su lugar, vincular un plugin directamente mediante uri. Los enlaces del proveedor la usan para seleccionar el plugin de qué publicador sirve una capacidad en un catálogo federado; los sockets transversales la dejan vacía y vinculan mediante uri.
withPluginRefWithnoDatos de entrada opcionales del momento de la vinculación que lee el plugin. Ambos miembros son opcionales y agnósticos respecto al socket, así que cualquier socket puede reutilizar esta superficie.

No se permiten propiedades adicionales.

CLIPluginRef

Un plugin de extensión de la CLI fijado, instalado como comando aggrega de nivel superior: la referencia de artefacto resuelta y fijada a una versión que el comando resuelve y ejecuta, y el digest de contenido de los bytes del guest a los que esa referencia se resolvió en el momento de la instalación. Juntos fijan exactamente qué bytes ejecuta el comando; el digest también indexa la caché de describe que proporciona los nombres y la ayuda del comando sin cargar el guest.

PropiedadTipoObligatoriaDescripción
uristringsíLa referencia de artefacto resuelta y fijada a una versión que el comando resuelve y ejecuta, p. ej. oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0, fijada en la instalación.
digeststringsíEl digest de contenido de los bytes .wasm del guest a los que se resolvió la referencia en la instalación, escrito como sha256: seguido de los 64 dígitos hexadecimales en minúsculas del SHA-256 de los bytes — la grafía que registra aggrega plugin add cli, y la grafía en la que se comparan los bytes resueltos. Un digest en cualquier otra grafía — hexadecimal simple sin el prefijo sha256:, mayúsculas o una longitud distinta — nunca podría ser igual a él, así que se rechaza al cargar el archivo de configuración, nombrando el archivo y la entrada. Fija los bytes exactos que ejecuta el comando — una resolución posterior cuyos bytes producen un hash distinto detiene el comando — y es la clave de la caché de describe que genera la ayuda del comando sin cargar el guest. Patrón: ^sha256:[0-9a-f]{64}$.

No se permiten propiedades adicionales.

PluginRefWith

Datos de entrada opcionales del momento de la vinculación que lee un plugin. Ambos miembros son opcionales y la superficie es general, así que cualquier socket puede reutilizarla.

PropiedadTipoObligatoriaDescripción
sourcesstring[]noRutas de archivos de definición que el host lee en tiempo de compilación y entrega al plugin. Cada entrada es una ruta del sistema de archivos resuelta con respecto al directorio del archivo de configuración que la declara.
settingsobjectnoObjeto de ajustes de forma libre que se entrega al plugin tal cual. El host no interpreta su forma; el plugin define las claves que lee.

No se permiten propiedades adicionales.