Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Esquema da configuração do espaço de trabalho do Aggrega

Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.

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

Arquivo de configuração por espaço de trabalho consumido pela CLI aggrega. Fica em .aggrega-config.yaml. O bloco workspace é o marcador da raiz: sua presença marca a raiz do espaço de trabalho, e ele contém apenas diretórios de catálogo. Toda outra chave é uma configuração e fica no nível superior, nestas classes — de onde o conteúdo é obtido, fixado e armazenado em cache (seleção do registro, offline, comportamento de auto-pull e de fixação, locais e tetos de tamanho dos caches de artefatos e de módulos compilados), como se confia no conteúdo (assinatura e comportamento da verificação de assinaturas), com que rigor a autoria é julgada (ajustes de lint por regra, rigor quanto a descontinuações e a indicação da release de autoria), quais plugins Wasm são vinculados ao espaço de trabalho inteiro (governança, linter, importador e associações de renderização do provedor por destino) e como a CLI é executada (concorrência, serviço e tetos de remoção do cache de análise do daemon). As propriedades abaixo são a lista completa e oficial; este resumo nomeia as classes em vez das chaves, de modo que adicionar uma chave não pode torná-lo falso. Formato plano de nível superior, sem envelope apiVersion/kind, distinto do conteúdo do catálogo. Disciplina de evolução do esquema: adicionar uma nova chave de nível superior é um incremento SemVer-MINOR (aditivo); remover ou realocar uma chave, ou tornar uma restrição mais rígida, é uma quebra SemVer-MAJOR.

Tipo de nível superior: object

Propriedades

PropriedadeTipoObrigatóriaDescrição
workspaceobjectnãoMarcador da raiz do espaço de trabalho. Sua presença por si só marca o diretório como raiz do espaço de trabalho; ele traz apenas os diretórios de catálogo que definem a raiz — os do próprio espaço de trabalho e os que uma Release recebe como seus. Toda configuração que não define a raiz fica no nível superior, e não aqui. Escreva workspace: {} para marcar uma raiz sem diretórios de catálogo incorporados ao projeto.
default_registrystringnãoRegistro OCI padrão no qual as entidades são publicadas e a partir do qual as dependências são resolvidas quando uma entidade não nomeia um registro explicitamente: aggrega push publica nele e aggrega pull obtém dele. O padrão é hub.aggrega.ai. Escreva o name de uma entrada em registries, que então representa o host dessa entrada; o próprio host; ou o host seguido de / e de um caminho de repositório, como ghcr.io/acme ou harbor.example.com/platform. Um nome é comparado primeiro: um valor que é o name de uma entrada é o host dessa entrada, mesmo quando também está escrito como um host, de modo que a publicação, o pull, a verificação de assinaturas e cada configuração de confiança por registro usam esse único host; um valor com o qual duas entradas são nomeadas é recusado como ambíguo, e um nome seguido de um caminho é recusado, porque um nome representa o host de uma entrada e não um local sob ele. Qualquer outro valor deve ser um host, escrito na grafia sob a qual sua política de confiança é mantida: um nome de host em minúsculas que contém um ponto (registry.example.com), localhost, um único nome seguido de uma porta (registry:5000), um endereço IPv4 ou um endereço IPv6 entre colchetes ([::1]), cada um com um :port opcional e sem esquema, credenciais, espaços em branco ou letra maiúscula — opcionalmente seguido de um caminho de repositório: um ou mais segmentos de letras minúsculas e dígitos unidos por /, que podem ser separados dentro de um segmento por ., _, __ ou hifens, sem tag, digest ou / final. O caminho é onde as coisas são publicadas e obtidas: toda entidade publicada por meio do registro padrão é publicada sob <host>/<path>/, e toda entidade resolvida por meio dele é obtida de lá, de modo que o que um publica o outro encontra. Ele nunca faz parte de como se confia em um registro: a entrada de registries cuja política se aplica, um login, um requisito de assinatura e as identidades confiáveis são todos encontrados apenas pelo host. A porta 443 em um host alcançado por HTTPS é a porta padrão desse host, e escrevê-la é recusado, indicando a grafia a escrever sem ela; localhost e os demais endereços de loopback são alcançados por HTTP simples, então ali 443 é uma porta comum e é mantida. Um valor vazio não nomeia nenhum registro padrão. O valor é julgado quando a configuração é carregada, e não por este esquema, porque a entrada a que um nome se refere pode estar declarada em outro arquivo de configuração: ele é lido depois de todo arquivo de configuração e da variável de ambiente AGGREGA_DEFAULT_REGISTRY, e recusado com as mesmas palavras, qualquer que seja o que o definiu, nomeando esse arquivo ou a variável. A flag --registry que nomeia o destino de uma publicação para uma única invocação é comparada com os nomes das entradas da mesma forma; qualquer outro valor que ela traga pode ser uma referência, e o host que essa referência nomeia está sujeito à mesma grafia e é onde a publicação chega, sem caminho de repositório. O host é julgado apenas por sua grafia: não se verifica se o nome é resolvido nem se um registro responde ali. Valor padrão: "hub.aggrega.ai"
offlinebooleanonãoQuando é true, o build não contata nenhum registro; apenas artefatos em cache e conteúdo de catálogo incorporado ao projeto são consultados. O padrão é false. Valor padrão: false
auto_pullbooleanonãoQuando é false (padrão), aggrega build é somente leitura: ele nunca escreve fixações de fontes, e um arquivo de bloqueio por release ausente ou incompleto interrompe o build de forma bem visível com um diagnóstico para executar primeiro aggrega pull --release <release>. Quando é true, aggrega build executa uma etapa de pull dentro do próprio processo antes do build — resolvendo as dependências da Release no arquivo de bloqueio e no cache — de modo que um primeiro build com uma Release não exige uma etapa de pull explícita. A mesma adesão para um único build está disponível na linha de comando como aggrega build --auto-pull; pull continua sendo o único que escreve o arquivo de bloqueio. offline: true não desativa a etapa de pull: ela é executada sobre o que a máquina já tem — o cache e os diretórios de catálogo locais — sem alcançar um registro, e uma referência que nenhum dos dois tem interrompe o build com a própria recusa do pull, que nomeia essa referência. Valor padrão: false
pin_sources_at_pullbooleanonãoQuando é false (padrão), um pull não registra nenhuma fixação junto a uma entidade: em uma Recipe ou FeatureRecipe de um dos diretórios de catálogo deste espaço de trabalho que a Release compila, ele é interrompido quando o entity.lock junto à entidade não registra uma fixação para cada elemento que a entidade lê — um source: remoto cujas coordenadas estão escritas por completo, um arquivo que uma entrada de artifacts importa, ou cada arquivo de um source: local junto à entidade — nomeando a entidade, cada elemento e sua classe, e aggrega pin como a etapa que os registra. A fixação é a etapa do autor da entidade, então uma entidade que ninguém fixou ainda não está pronta para ser consumida. Quando é true, todo pull neste espaço de trabalho executa essa etapa em vez disso, sobre as mesmas entidades, escrevendo os mesmos bytes de entity.lock que aggrega pin escreve; é assim que um espaço de trabalho que consome entidades que outra pessoa não fixou registra as fixações delas uma única vez, em vez de ser interrompido. Um build que preenche seu próprio arquivo de bloqueio é um pull e segue esta configuração. aggrega pull --pin-sources fixa para uma única invocação e --pin-sources=false interrompe para uma única invocação, independentemente do que esta configuração diga. Uma entidade resolvida a partir do cache em vez de um diretório de catálogo não tem onde escrever um bloqueio e nunca é fixada nem retida por um pull. Valor padrão: false
pin_sources_at_pushbooleanonãoQuando é true, todo aggrega push neste espaço de trabalho executa a etapa de fixação do autor da entidade sobre a entidade que publica antes de empacotá-la, de modo que o entity.lock que a etapa escreve junto à entidade faz parte do que é publicado; quando é false (padrão), o push não executa nenhuma etapa de fixação e recusa uma Recipe ou FeatureRecipe cujo entity.lock não registra cada fixação que essa etapa registraria, nomeando aggrega pin. A etapa escreve junto à entidade, então só é executada onde a entidade tem um local gravável, que um push sempre tem: ele publica uma entidade nomeada pelo seu documento. aggrega push --pin-sources fixa para uma única invocação e --pin-sources=false não, independentemente do que esta configuração diga. É a mesma etapa que aggrega pin executa, escrevendo os mesmos bytes. Valor padrão: false
artifact_cache_dirstringnãoDiretório local do cache de artefatos/conteúdo (pulls de registros, manifestos OCI, fixtures compilados). O padrão é .aggrega/cache. Por convenção, deve ser incluído no gitignore. O caminho é interpretado em relação à raiz do espaço de trabalho, de onde quer que o comando seja executado; um valor absoluto é recusado quando a configuração é carregada, porque todo leitor desta configuração o resolve em relação a essa raiz e um caminho absoluto nomearia um local que eles nunca alcançam. O cache pode ficar dentro de um diretório de catálogo — o padrão fica, já que um diretório de catálogo costuma ser a raiz do espaço de trabalho — mas não deve SER um: uma varredura do catálogo pula o cache, então um valor que nomeia um diretório de catálogo deixa todo o conteúdo desse diretório fora da varredura. Um valor que nomeia a própria raiz do espaço de trabalho (., ou qualquer grafia que se reduza a ela) é recusado quando a configuração é carregada, exatamente por esse motivo. Um valor que nomeia qualquer outro diretório de catálogo não é recusado: ele carrega sem erros e a varredura então não encontra nada nesse diretório, então manter o cache fora dos diretórios listados em workspace.catalog_dirs é algo que cabe a você verificar. Distinto de parse_cache, que limita o cache de análise em memória do daemon, e de compiled_module_cache, que limita o armazenamento de módulos compilados de toda a máquina. Valor padrão: ".aggrega/cache"
skip_signature_verificationbooleanonãoDesativação global e bem visível da verificação de assinaturas. Quando é true, a verificação de assinaturas fica desativada em todos os registros, incluindo a linha de base obrigatória do hub. Destinada a cenários de emergência (break-glass) e de desenvolvimento; nunca é silenciosa — onde quer que um pull tivesse verificado uma assinatura, ela avisa que a verificação foi desativada globalmente. O padrão é false. Valor padrão: false
buildobjectnãoAjustes de rigor em tempo de build e indicações de autoria. authoring_release fornece ao LSP uma indicação current Release para diagnósticos inline; halt_on_deprecated_severity controla como o build reage ao consumo de entidades descontinuadas; yaml_indent define a largura de indentação de cada artefato YAML renderizado.
pluginsobjectnãoVinculações de plugins Wasm no nível do espaço de trabalho. Cada socket (governança, linter, importador) recebe um array de referências a plugins; o build invoca a função de entrada documentada de cada plugin conforme o contrato do seu socket. A lista providers associa as capacidades aos plugins de renderização do provedor que as servem.
lintobjectnãoAjustes de rigor por regra.
parse_cacheobjectnãoTetos de remoção do cache de análise do daemon. Ambos os tetos se aplicam simultaneamente — o laço de remoção LRU é executado após cada inserção no cache e remove as entradas usadas menos recentemente até que tanto a contagem de entradas quanto o total de bytes estejam dentro dos limites. Zero em qualquer um dos dois significa unbounded on that axis, útil em cenários de CI em que o cache existe apenas durante uma invocação. Distinto de artifact_cache_dir, que é o cache de conteúdo em disco.
compiled_module_cacheobjectnãoTeto de tamanho para o cache em disco de módulos compilados, o armazenamento de código de máquina que o compilador reutiliza para que um plugin Wasm seja compilado uma vez por máquina em vez de uma vez por build. Ele é compartilhado por todos os espaços de trabalho da máquina, então esta chave pertence ao arquivo de configuração global quando você quer uma única resposta para a máquina inteira. O teto é aplicado uma vez por invocação, antes de qualquer plugin ser carregado, removendo entradas inteiras a partir das compiladas há mais tempo até que o restante caiba — nunca enquanto um build está compilando. Remover uma entrada custa uma recompilação posterior e nada mais, então é seguro reduzir o teto. aggrega cache status informa o tamanho atual do armazenamento, e aggrega cache evict --max-size o reduz sob demanda a um teto informado na linha de comando. Distinto de artifact_cache_dir (conteúdo obtido dos registros) e de parse_cache (o cache de análise em memória do daemon).
concurrencyobjectnãoConfigurações de concorrência do despacho de requisições do daemon. O daemon lê as requisições de um único fluxo stdin e executa cada uma por meio de um pool de workers que esvazia uma fila de requisições limitada; as respostas são emitidas na ordem de chegada das requisições, independentemente da ordem de conclusão.
serveobjectnãoConfigurações de comportamento do daemon (aggrega serve) para o compilador como serviço consumido pelas integrações com IDEs.
mcpobjectnãoConfigurações do servidor Model Context Protocol (aggrega mcp). transport escolhe como o servidor é alcançado — pela entrada e saída padrão do processo ou por HTTP — e é lido qualquer que seja a escolha. announce_tools também é lido nos dois transportes, porque quais ferramentas são oferecidas a um cliente é uma propriedade do servidor e não de como um cliente o alcançou. Toda outra chave configura o listener que o transporte HTTP inicia e não é usada enquanto o servidor se comunica pela entrada e saída padrão — listen incluída, que ali é lida apenas para que o servidor possa dizer, em uma linha no seu fluxo de erro, que o endereço não é usado. Cada chave abaixo diz qual é o seu caso. Distinto de serve, que configura o daemon de backend do editor.
registriesRegistryConfig[]nãoConfigurações por registro e política de confiança de assinaturas, indexadas pelo host do registro. Um registro não listado aqui usa os padrões: uma assinatura presente é verificada e uma assinatura ausente é tolerada, exceto para hub.aggrega.ai, cuja linha de base embutida exige uma assinatura verificada mesmo sem nenhuma entrada explícita. Uma entrada explícita para um host substitui a linha de base desse host. Valor padrão: []
signingSigningConfignãoBloco de assinatura de nível superior, aplicável a todos os registros: as URLs dos serviços keyless, um caminho opcional de chave para assinatura com chave e a postura de confiança comum a todos os registros (required e kinds). Um bloco signing por registro substitui os padrões dos endpoints para esse host e traz a mesma postura required/kinds com escopo restrito a esse host — um nome, uma função, o escopo dado pela posição. A política required/kinds de nível superior se compõe de forma monotônica ao longo da cascata de configurações. Segurança: este bloco não contém nenhum material secreto — o token de identidade OIDC nunca é um campo de configuração (ele é fornecido em tempo de execução por meio de uma flag ou do ambiente OIDC circundante) e key_path é um caminho para um arquivo de chave, nunca bytes de chave inline.

Não são permitidas propriedades adicionais.

aggrega-config.workspace

Marcador da raiz do espaço de trabalho. Sua presença por si só marca o diretório como raiz do espaço de trabalho; ele traz apenas os diretórios de catálogo que definem a raiz — os do próprio espaço de trabalho e os que uma Release recebe como seus. Toda configuração que não define a raiz fica no nível superior, e não aqui. Escreva workspace: {} para marcar uma raiz sem diretórios de catálogo incorporados ao projeto.

PropriedadeTipoObrigatóriaDescrição
catalog_dirsstring[]nãoDiretórios de catálogo opcionais dos quais este espaço de trabalho lê entidades locais, consultados antes de recorrer ao registro. Cada entrada é um caminho do sistema de arquivos, resolvido em relação ao arquivo que a declara. A lista é uma pilha de busca ordenada em que vence o primeiro: o diretório listado primeiro que declara uma identidade é o seu dono, e a mesma identidade em um diretório posterior fica encoberta. O diretório catalog na raiz do espaço de trabalho também é lido, depois de cada entrada listada e apenas quando existe — a menos que uma entrada listada já o contenha, caso em que é lido como parte dessa entrada — de modo que listar um diretório acrescenta ao que o espaço de trabalho já lia em vez de substituí-lo. Omitir esta chave e escrevê-la como uma lista vazia são declarações diferentes: quando é omitida, o espaço de trabalho ainda lê catalog; quando é escrita como [], ele não lê nenhum catálogo local, que é como um espaço de trabalho diz que não tem nenhum. Uma Release que recebe diretórios de catálogo próprios em releases lê esses no lugar desta lista. Com escopo de raiz: os diretórios de catálogo locais pertencem a esta raiz do espaço de trabalho, então ficam no marcador da raiz e não no nível superior.
catalog_dirs_appendstring[]nãoAcréscimo opcional, somente ao final, à lista catalog_dirs efetiva. Em cada camada de precedência, as entradas indicadas aqui são concatenadas à lista base resolvida, permitindo que as configurações do espaço de trabalho e globais componham os diretórios de catálogo em vez de encobri-los. Interação na mesma camada: quando catalog_dirs e catalog_dirs_append são especificados em uma mesma camada, o valor resolvido nessa camada é a lista base seguida da lista acrescentada. Valor padrão: []
releasesmapa de ReleaseCatalogConfignãoDiretórios de catálogo opcionais próprios de uma Release, para um espaço de trabalho que mantém várias variantes de catálogo lado a lado e compila cada Release com uma delas. Cada chave é um arquivo de Release, escrito como um caminho relativo ao arquivo que a declara; cada valor traz catalog_dirs e catalog_dirs_append com o significado que têm neste bloco, com escopo restrito a essa única Release. Uma Release nomeada aqui lê seu próprio catalog_dirs no lugar da lista deste bloco, seguido de seu próprio catalog_dirs_append; uma entrada que omite catalog_dirs mantém a lista deste bloco e acrescenta depois dela seu catalog_dirs_append. A ordem de busca, o diretório catalog na raiz do espaço de trabalho e o que uma lista vazia significa são os mesmos que para a própria lista deste bloco, e uma Release que este mapa não nomeia lê a lista deste bloco exatamente como antes. A Release lê esses diretórios independentemente de como é compilada — em um terminal, a partir de um editor por meio de aggrega serve, ou por meio de aggrega mcp — e um diretório --catalog ainda é pesquisado antes deles para uma única invocação. Uma entrada que nomeia um arquivo inexistente é recusada quando a configuração é carregada, nomeando a entrada e o arquivo, de modo que renomear uma Release não pode alterar silenciosamente o catálogo com o qual ela é compilada. Entre arquivos de configuração, a entrada de cada Release se compõe da mesma forma que as próprias chaves deste bloco: o catalog_dirs de um arquivo mais próximo para essa Release substitui o de um arquivo mais distante, e o catalog_dirs_append de cada arquivo para ela é acrescentado na ordem da cascata. AGGREGA_CATALOG_DIRS define a lista deste bloco e não alcança nenhuma entrada daqui. Uma operação que não diz respeito a nenhuma Release específica — um lint ou uma validação do catálogo inteiro, a busca de uma entidade pelo nome ou a listagem das entidades do espaço de trabalho em um editor — lê a lista deste bloco e não estas.

Não são permitidas propriedades adicionais.

aggrega-config.build

Ajustes de rigor em tempo de build e indicações de autoria. authoring_release fornece ao LSP uma indicação current Release para diagnósticos inline; halt_on_deprecated_severity controla como o build reage ao consumo de entidades descontinuadas; yaml_indent define a largura de indentação de cada artefato YAML renderizado.

PropriedadeTipoObrigatóriaDescrição
authoring_releasestringnãoCaminho para um arquivo YAML de Release que o LSP trata como o contexto current Release para diagnósticos inline. Opcional.
yaml_indentintegernãoLargura de indentação (em espaços) de cada artefato YAML renderizado — arquivos docker-compose, templates e valores de charts Helm, e manifestos do Kubernetes. O padrão é 2, a largura convencional para esses formatos. Mínimo: 2. Máximo: 9. Valor padrão: 2
halt_on_deprecated_severitystring (enum)nãoSeveridade, no conjunto ordenado warning < error < retracted, a partir da qual um marcador de descontinuação registrado interrompe o build. Ela rege os dois lugares em que um marcador é registrado: o arquivo de bloqueio, para tudo o que um build reproduz byte a byte, e o registro de confiança dos plugins ao lado dele, para um plugin vinculado em um papel que retorna um veredito de aceitação ou rejeição — uma vinculação plugins.governance em ir-verdict ou render-verdict, e toda vinculação plugins.linter. Um ajuste, uma regra, ambos os armazenamentos. Não definida por padrão, e não definida significa que nenhum marcador registrado interrompe nada: um marcador é registrado em relação a uma versão que você já fixou, de modo que um build que teve sucesso uma vez continua tendo sucesso. Notificação e resolução são dois eixos separados e nenhum deles é este ajuste. Toda superfície que lê qualquer um dos dois registros informa cada referência descontinuada que fixa e cada plugin confiável que traz um marcador — em qualquer severidade — nomeando-o, com sua severidade e sua mensagem: aggrega build, aggrega validate --release, aggrega lint --release, o daemon voltado ao editor e as ferramentas build, describe e validate nativas de IA. Portanto, elevar este limiar nunca reduz o que é informado a você. Este ajuste rege apenas o build: ele interrompe aggrega build (e a ferramenta build nativa de IA, que é a mesma operação), enquanto as superfícies que informam nomeiam o marcador e prosseguem. Apenas um marcador retracted afeta a versão para a qual uma referência é resolvida, e o faz quando aggrega pull escolhe uma versão, não no build. Valores permitidos: "warning", "error", "retracted"

Não são permitidas propriedades adicionais.

aggrega-config.plugins

Vinculações de plugins Wasm no nível do espaço de trabalho. Cada socket (governança, linter, importador) recebe um array de referências a plugins; o build invoca a função de entrada documentada de cada plugin conforme o contrato do seu socket. A lista providers associa as capacidades aos plugins de renderização do provedor que as servem.

PropriedadeTipoObrigatóriaDescrição
governancePluginRef[]nãoOs plugins do socket de governança. Cada entrada nomeia o role do pipeline em que está vinculada (annotation-transform, label-transform, ir-verdict ou render-verdict); o papel define tanto o que o plugin pode emitir quanto sua função de entrada padrão (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Valor padrão: []
governance_appendPluginRef[]nãoAcréscimo, somente ao final, à lista governance efetiva. As entradas indicadas aqui são concatenadas à lista base resolvida em cada camada de precedência, permitindo que as configurações do espaço de trabalho e globais componham as vinculações de governança em vez de encobri-las. Valor padrão: []
linterPluginRef[]nãoOs plugins do socket linter. Função de entrada padrão: lint_rules. As exportações de um plugin linter devem começar com lint_, então function: em uma destas entradas nomeia uma exportação com esse prefixo. Valor padrão: []
linter_appendPluginRef[]nãoAcréscimo, somente ao final, à lista linter efetiva. A mesma semântica de compor sem encobrir que governance_append. Valor padrão: []
importerFixedEntryPluginRef[]nãoOs plugins do socket importador. O socket chama a função de entrada import; uma vinculação não nomeia nenhuma. Valor padrão: []
importer_appendFixedEntryPluginRef[]nãoAcréscimo, somente ao final, à lista importer efetiva. A mesma semântica de compor sem encobrir que governance_append. Valor padrão: []
providersFixedEntryPluginRef[]nãoSeleções do provedor por capacidade. Cada entrada associa uma capacidade do provedor (o nome simples da capacidade que uma Recipe associa por meio de spec.capability, por exemplo helm ou compose) à identidade simples do plugin de renderização do provedor que a serve (a identidade da entidade Plugin, seus metadata.pluginType e metadata.name unidos por uma barra, por exemplo provider/helm), com um :version final opcional nas mesmas três formas de uma fixação de versão (simples, exata :1.0.0 ou intervalo compatível com a versão principal :^1.0.0). Esta é a superfície de desambiguação e de substituição para um catálogo federado em que mais de um plugin de provedor serve a mesma capacidade: a associação seleciona o plugin de qual publicador renderiza essa capacidade. Quando uma capacidade é servida por exatamente um plugin de provedor, nenhuma entrada é necessária. Em toda a lista composta é permitida exatamente uma entrada por capacidade; uma capacidade duplicada interrompe a resolução de forma bem visível. A resolução acontece no pull: o pull registra a associação resolvida no arquivo de bloqueio por Release, e o build lê o arquivo de bloqueio — uma alteração aqui depois de um pull não é adotada até o pull seguinte, de modo que a saída do build é invariante em relação a ela (saída determinística). Todo build e toda validação de uma Release também verificam cada entrada daqui, quer uma Recipe peça sua capacidade ou não: uma entrada que nomeia um plugin que o build contém e que não serve a capacidade da entrada provoca uma interrupção, nomeando o que esse plugin serve e uma grafia a uma edição de distância quando houver uma; uma entrada que nomeia uma capacidade e nenhum plugin, quando nenhum plugin de provedor que o build lê serve essa capacidade, é informada como um aviso em vez de interromper, porque o plugin que a serve pode ser um que apenas outra Release lê; e uma entrada para uma capacidade que um plugin serve mas que esta Release nunca pede é permitida e não é informada de forma alguma, já que as entradas são escritas para o espaço de trabalho inteiro e um build é de uma única Release. Uma capability que contém dois-pontos é recusada quando a configuração é carregada: o spec.capability de uma Recipe é lido como a capacidade até seus últimos dois-pontos e uma fixação de versão depois deles, de modo que nenhuma Recipe poderia alcançar uma entrada assim. Uma entrada ausente para uma capacidade servida sem ambiguidade não é um erro; uma entrada ausente para uma capacidade servida de forma ambígua interrompe o pull de forma bem visível, listando os plugins candidatos. A coexistência de versões é preservada: a associação seleciona o repositório do plugin por capacidade, e a própria fixação de versão em spec.capability de cada Recipe seleciona a versão dentro desse repositório, de modo que duas Recipes que fixam versões diferentes de um mesmo provedor continuam coexistindo. Valor padrão: []
providers_appendFixedEntryPluginRef[]nãoAcréscimo, somente ao final, à lista providers efetiva. As entradas indicadas aqui são concatenadas à lista base resolvida em cada camada de precedência, permitindo que as configurações do espaço de trabalho e globais componham as associações do provedor em vez de encobri-las. A mesma semântica de compor sem encobrir que governance_append. A regra de uma entrada por capacidade se aplica à lista composta, então uma entrada acrescentada que nomeia uma capacidade já associada por uma camada inferior interrompe a resolução de forma bem visível. Valor padrão: []
cliCLIPluginRef[]nãoOs plugins de extensão da CLI instalados como comandos aggrega de nível superior. Cada entrada fixa um plugin de CLI por sua referência de artefato resolvida e fixada em uma versão e pelo digest de conteúdo dos bytes do guest para os quais essa referência foi resolvida no momento da instalação. Ao contrário das quatro listas de sockets transversais, cuja lista base é substituída por inteiro ao longo da cascata de configurações, a lista da CLI se compõe: um plugin de CLI na configuração global registra seus comandos em todo espaço de trabalho, um em uma configuração do espaço de trabalho se registra apenas naquele projeto, e ambos se registram juntos — então ela não precisa de um complemento _append. Os nomes de comando e a ajuda com que cada plugin contribui vêm da autodescrição do próprio plugin, lida do cache de describe em disco indexado por digest (carregar o guest é o recurso alternativo com o cache frio); a lista traz apenas a fixação. Na invocação do comando, os bytes resolvidos passam por hash novamente e são comparados com digest; uma divergência interrompe o comando de forma bem visível e instrui a refazer a fixação, de modo que um plugin cujos bytes mudaram desde que foi fixado nunca é executado sem ser notado. Valor padrão: []

Não são permitidas propriedades adicionais.

aggrega-config.lint

Ajustes de rigor por regra.

PropriedadeTipoObrigatóriaDescrição
publishing_disciplineobjectnãoInterruptores para todo o espaço de trabalho sobre o conjunto de regras do linter de publicação. As flags allow_* flexibilizam verificações dissuasivas individuais. A imutabilidade dos artefatos não é configurável aqui: aggrega push se recusa incondicionalmente a sobrescrever uma versão publicada.

Não são permitidas propriedades adicionais.

aggrega-config.lint.publishing_discipline

Interruptores para todo o espaço de trabalho sobre o conjunto de regras do linter de publicação. As flags allow_* flexibilizam verificações dissuasivas individuais. A imutabilidade dos artefatos não é configurável aqui: aggrega push se recusa incondicionalmente a sobrescrever uma versão publicada.

PropriedadeTipoObrigatóriaDescrição
allow_dynamic_refsbooleanonãoQuando é true, o linter de publicação aceita as construções de JSON Schema $dynamicRef / $dynamicAnchor no conteúdo do catálogo. O padrão é false; essas construções são desaconselhadas porque tornam não local a composição de esquemas em tempo de compilação. Valor padrão: false
allow_id_overridesbooleanonãoQuando é true, o linter de publicação aceita substituições de $id em subesquemas dentro do conteúdo de esquema de uma entidade. O padrão é false; substituições de $id quebram a convenção de um identificador canônico por esquema da qual dependem tanto o resolvedor quanto o validador de JSON Schema. Valor padrão: false
allow_direct_x_aggrega_extensionsbooleanonãoQuando é true, a verificação dissuasiva em tempo de build aceita as palavras-chave x-aggrega-selector e x-aggrega-inject escritas diretamente no conteúdo do esquema. O padrão é false; o caminho de autoria recomendado é usesSchema (para sockets de dependência) ou featuresSchema (para associações de credenciais), que o compilador compõe nessas palavras-chave. Valor padrão: false
allow_aggrega_ai_prefixbooleanonãoQuando é true, o linter de publicação aceita chaves de anotação que usam os namespaces reservados aggrega.ai/ e feature.aggrega.ai/ fora de seus contextos canônicos. A regra de prefixos reservados controla os metadata.annotations das entidades de catálogo: o prefixo simples aggrega.ai/ é nativo da plataforma (as chaves de anotação bem conhecidas estão isentas independentemente desta flag); o prefixo feature.aggrega.ai/ é canônico apenas no tipo Feature. O padrão é false. Os operadores definem isso quando as ferramentas corporativas precisam legitimamente usar um prefixo reservado; isso flexibiliza ambos os prefixos juntos. Valor padrão: false
allow_nonstandard_namesbooleanonãoQuando é true, o linter de publicação aceita nomes de entidades de catálogo que não seguem as convenções de nomenclatura documentadas do projeto. O padrão é false; uma nomenclatura consistente é fundamental para o resolvedor, a seleção por rótulos e a ergonomia dos revisores. Valor padrão: false
allow_category_mismatchesbooleanonãoQuando é true, o linter de publicação suprime a regra category-matches-directory. A convenção do catálogo padrão exige que os Components em core// declarem component.aggrega.ai/category={category} correspondente ao segmento do diretório, em que {category} é um dos valores de um conjunto fechado (como ai-agent, ai-model, ai-tool, datastore, gateway, compute, …). Espaços de trabalho com exceções persistentes legítimas optam por sair aqui. O padrão é false. Valor padrão: false
allow_undeclared_recipe_providesbooleanonãoQuando é true, o linter de publicação suprime a regra provides-declared-by-component. Essa regra informa cada chave que uma Recipe publica em spec.provides e que o Component nomeado por seu spec.implements não declara no pilar provides de seu spec.schema. As duas são superfícies separadas: o que uma Recipe publica é o valor que um consumidor recebe, enquanto o que o Component declara é o contrato de saída com o qual uma referência inject from: é verificada — de modo que uma chave publicada sem ser declarada faz uma referência assim ser interrompida. Fora isso, uma Recipe que publica mais do que seu Component declara é aceita em tempo de build, e é por isso que a constatação é consultiva, e não uma recusa de publicação. O padrão é false. Valor padrão: false
allow_connection_credential_mismatchesbooleanonãoQuando é true, o linter de publicação suprime a regra connection-credential-matches-target-key, que aggrega lint --release executa sobre a Release que nomeia: a Release, o Aggregate que ela implanta e os Components que as instâncias desse Aggregate usam. Para cada conexão cujo destino declara a chave que exige de seus chamadores, a regra compara aquilo a que as duas pontas fazem referência: a credencial que a conexão apresenta e a chave que o destino mantém em seu próprio slot. Ela informa duas pontas que nomeiam segredos diferentes e uma chave declarada em apenas uma ponta, e nunca cita nenhum dos dois. Nenhuma das pontas pode ver as vinculações da outra, então as duas só concordam por disciplina de autoria — normalmente um único parâmetro que alimenta ambas — e um build as aceita de qualquer forma, e é por isso que a constatação é consultiva. Um espaço de trabalho cujas duas pontas diferem deliberadamente opta por sair aqui. O padrão é false. Valor padrão: false

Não são permitidas propriedades adicionais.

aggrega-config.parse_cache

Tetos de remoção do cache de análise do daemon. Ambos os tetos se aplicam simultaneamente — o laço de remoção LRU é executado após cada inserção no cache e remove as entradas usadas menos recentemente até que tanto a contagem de entradas quanto o total de bytes estejam dentro dos limites. Zero em qualquer um dos dois significa unbounded on that axis, útil em cenários de CI em que o cache existe apenas durante uma invocação. Distinto de artifact_cache_dir, que é o cache de conteúdo em disco.

PropriedadeTipoObrigatóriaDescrição
max_entriesintegernãoTeto do número de análises em cache. O padrão é 1000. 0 desativa o eixo da contagem de entradas (nenhuma remoção acionada pela contagem de entradas). Mínimo: 0. Valor padrão: 1000
max_bytesintegernãoTeto do tamanho cumulativo, em bytes, dos documentos que o cache contém. O padrão é 100000000 (100 MB). 0 desativa o eixo de bytes (nenhuma remoção acionada pelo total de bytes). Mínimo: 0. Valor padrão: 100000000

Não são permitidas propriedades adicionais.

aggrega-config.compiled_module_cache

Teto de tamanho para o cache em disco de módulos compilados, o armazenamento de código de máquina que o compilador reutiliza para que um plugin Wasm seja compilado uma vez por máquina em vez de uma vez por build. Ele é compartilhado por todos os espaços de trabalho da máquina, então esta chave pertence ao arquivo de configuração global quando você quer uma única resposta para a máquina inteira. O teto é aplicado uma vez por invocação, antes de qualquer plugin ser carregado, removendo entradas inteiras a partir das compiladas há mais tempo até que o restante caiba — nunca enquanto um build está compilando. Remover uma entrada custa uma recompilação posterior e nada mais, então é seguro reduzir o teto. aggrega cache status informa o tamanho atual do armazenamento, e aggrega cache evict --max-size o reduz sob demanda a um teto informado na linha de comando. Distinto de artifact_cache_dir (conteúdo obtido dos registros) e de parse_cache (o cache de análise em memória do daemon).

PropriedadeTipoObrigatóriaDescrição
max_bytesintegernãoTeto dos bytes que o cache de módulos compilados ocupa em disco. O padrão é 53687091200 (50 GiB), um limite superior que impede o crescimento ilimitado, e não um orçamento feito para ser sentido — um único plugin compilado chega a centenas de megabytes, então uma máquina que compila muitas versões de plugins acumula gigabytes. Defina-o acima do que um build compila: o teto é aplicado antes de um build compilar qualquer coisa, então um teto abaixo do conjunto de trabalho de um único build faz cada build descartar e recompilar os mesmos módulos, e o armazenamento deixa de economizar qualquer coisa. Como o teto é aplicado primeiro e o build depois escreve o que compila, o armazenamento pode ficar acima do teto entre builds; ele é reduzido novamente no início do build seguinte. 0 desativa o teto (o armazenamento cresce sem limite e nada é removido automaticamente em momento algum). Como o armazenamento é um único diretório que todos os espaços de trabalho compartilham, este teto não é por projeto, mesmo quando o próprio arquivo de um projeto o traz: o valor é resolvido da mesma forma que qualquer outra chave, com o arquivo mais próximo prevalecendo, mas o armazenamento continua tendo um único tamanho. O teto em vigor é o do build mais recente, então dois projetos que o limitam de forma diferente entram ambos em vigor, alternadamente, e um teto baixo em um descarta código de máquina que o outro compilou. Defini-lo uma vez no arquivo de configuração global é o que dá à máquina inteira uma única resposta. aggrega config show --origin nomeia o arquivo de onde veio o valor efetivo de cada configuração. Mínimo: 0. Valor padrão: 53687091200

Não são permitidas propriedades adicionais.

aggrega-config.concurrency

Configurações de concorrência do despacho de requisições do daemon. O daemon lê as requisições de um único fluxo stdin e executa cada uma por meio de um pool de workers que esvazia uma fila de requisições limitada; as respostas são emitidas na ordem de chegada das requisições, independentemente da ordem de conclusão.

PropriedadeTipoObrigatóriaDescrição
pool_sizeintegernãoNúmero de workers que atendem a fila de requisições. O padrão é 4, o que despacha até quatro requisições simultaneamente; defina-o como 1 para executar as requisições em série, na ordem de chegada. Um valor abaixo de 1 é elevado para 1 quando o daemon é iniciado. Mínimo: 1. Valor padrão: 4

Não são permitidas propriedades adicionais.

aggrega-config.serve

Configurações de comportamento do daemon (aggrega serve) para o compilador como serviço consumido pelas integrações com IDEs.

PropriedadeTipoObrigatóriaDescrição
build_on_inspectbooleanonãoDefine se o daemon executa a etapa de renderização de artefatos ao inspecionar um grafo IR, para que os avisos informativos que aggrega build emite durante a renderização também apareçam como problemas no editor. Não acrescenta nenhuma das verificações nas quais um build é interrompido. Nada é gravado em disco em nenhum dos casos — nenhum artefato renderizado, nenhum diretório de saída, nenhum arquivo de bloqueio — e a etapa de renderização nunca altera o grafo, de modo que, onde a inspeção responde com um, é o mesmo grafo nos dois casos. O padrão é false, em linha com aggrega inspect: o comando do terminal não chega à etapa de renderização ao inspecionar um grafo, então também não emite nenhum aviso desse tipo, e uma inspeção no editor que não emite nenhum mostra a você a mesma coisa que o terminal mostra. Defina como true para pedir ao editor essa camada adicional. Valor padrão: false
lint_on_validatebooleanonãoDefine se o daemon executa a verificação das convenções de publicação ao validar uma entidade de catálogo, para que as constatações que aggrega lint relata sobre essa entidade também apareçam como problemas no editor. As constatações são informativas: um documento que as recebe ainda é validado, e sua Release ainda é resolvida e renderizada. Somente a verificação que lê conteúdo local é executada — nenhum registro é consultado, nada é obtido e nada é gravado — e ela é avaliada sobre o buffer que o editor mantém, e não sobre o arquivo em disco, de modo que um nome que você corrige deixa de ser relatado antes de você salvar. O padrão é false: uma sessão do editor informa se um documento está correto e não diz nada sobre se uma entidade é publicável, até que você peça essa segunda camada. Defina como true para pedi-la. Independentemente desta chave, um editor sempre pode pedir a verificação diretamente, e é também assim que se chega à comparação pré-publicação com a versão publicada anteriormente. Valor padrão: false

Não são permitidas propriedades adicionais.

aggrega-config.mcp

Configurações do servidor Model Context Protocol (aggrega mcp). transport escolhe como o servidor é alcançado — pela entrada e saída padrão do processo ou por HTTP — e é lido qualquer que seja a escolha. announce_tools também é lido nos dois transportes, porque quais ferramentas são oferecidas a um cliente é uma propriedade do servidor e não de como um cliente o alcançou. Toda outra chave configura o listener que o transporte HTTP inicia e não é usada enquanto o servidor se comunica pela entrada e saída padrão — listen incluída, que ali é lida apenas para que o servidor possa dizer, em uma linha no seu fluxo de erro, que o endereço não é usado. Cada chave abaixo diz qual é o seu caso. Distinto de serve, que configura o daemon de backend do editor.

PropriedadeTipoObrigatóriaDescrição
transportstring (enum)nãoComo o servidor é alcançado: stdio fala o protocolo pela entrada e saída padrão do processo, que é como um cliente que inicia o comando como subprocesso o alcança; http o serve por HTTP no endereço que listen nomeia, e por HTTPS onde tls nomeia um certificado e uma chave. aggrega mcp --transport stdio|http substitui esta chave para uma única invocação. O padrão é stdio, então um espaço de trabalho que nunca nomeia um transporte é servido pela entrada e saída padrão, seja o que for que este bloco traga além disso — um listener só é iniciado onde http é escolhido, aqui ou na linha de comando. Qualquer outro valor é recusado quando a configuração é carregada. Defina http na configuração de um servidor que os chamadores alcançam pela rede, e deixe a chave sem definir onde o próprio cliente inicia o servidor: com stdio escolhido, um endereço em listen não é usado, e o servidor diz isso em uma linha no seu fluxo de erro. Valores permitidos: "stdio", "http" Valor padrão: "stdio"
listenstringnãoEndereço ao qual o listener se vincula quando o transporte HTTP é escolhido. Ele nomeia onde escutar e não escolhe nada: escolher o transporte cabe a transport, e com stdio escolhido esta chave não é usada. Duas formas são aceitas: host:port para um endereço TCP, e unix: seguido de um caminho do sistema de arquivos para um socket de domínio Unix. aggrega mcp --listen <address> substitui esta chave para uma única invocação. O padrão é vazio, e o transporte HTTP precisa de um endereço vindo de um ou de outro: sem nenhum dos dois, uma inicialização que o escolhe é recusada antes de qualquer vinculação. Um endereço em texto simples — alcançado sem certificado e chave em tls — só é aceito em um endereço de loopback (127.0.0.1, ::1 ou localhost resolvendo para um deles) ou em um socket Unix, que é o formato que um servidor usa quando um proxy à frente faz a terminação TLS; qualquer outro endereço é recusado antes de qualquer vinculação, nomeando mcp.tls.cert_file e mcp.tls.key_file. Essas mesmas duas formas são as únicas aceitas, com ou sem certificado, onde authorization.trusted_proxy está definido, porque um cabeçalho só pode ser considerado confiável como credencial onde nada além do proxy pode defini-lo. Valor padrão: ""
tlsobjectnãoCertificado e chave para fazer a terminação TLS dentro do processo que serve. Defina ambos para servir HTTPS diretamente a partir do listener que listen nomeia. Deixe ambos sem definir para servir em texto simples, o que restringe listen a um endereço de loopback ou a um socket Unix — o formato a usar quando um proxy à frente detém o certificado. Ambas as chaves são caminhos para arquivos em disco; nenhuma delas contém material de chave inline.
allowed_originsstring[]nãoOrigens aceitas no cabeçalho Origin de uma requisição. Uma requisição cujo cabeçalho Origin nomeia uma origem que esta lista não contém é recusada com 403; uma requisição que nomeia uma origem listada, ou que não traz nenhum cabeçalho Origin, é atendida. Uma entrada é comparada exatamente com o cabeçalho, então cada uma é escrita da forma como um navegador envia uma origem: um esquema em minúsculas, ://, um host em minúsculas — um nome, um endereço IPv4 ou um endereço IPv6 entre colchetes — e : com a porta quando ela não é a padrão do esquema, sem nada depois. Por exemplo https://app.example.com ou http://localhost:3000. Uma entrada em qualquer outro formato nunca poderia ser igual ao que um navegador envia, então ela é recusada quando o arquivo de configuração é carregado, nomeando o arquivo e a entrada: uma com uma / final ou um caminho (https://app.example.com/), uma sem esquema (app.example.com) e uma que contém uma letra maiúscula ou um espaço. O padrão é vazio, então nenhuma origem é aceita e só é atendido um chamador que não envia nenhum cabeçalho Origin. Um cliente baseado em navegador, portanto, precisa ter sua origem listada aqui; um cliente que não é um navegador não envia esse cabeçalho e não precisa de nenhuma entrada. Cada entrada corresponde ao padrão ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$. Valor padrão: []
limitsobjectnãoTetos que o listener HTTP aplica ao tráfego que aceita, para que um único chamador não possa esgotar o processo que serve. Eles limitam o tamanho que uma única requisição pode ter, quantas requisições são executadas ao mesmo tempo e com que rapidez um chamador pode enviar. Nenhum deles pode ser desativado.
authorizationobjectnãoO que este servidor declara sobre os bearer tokens que seus chamadores apresentam: qual servidor de autorização os emite, o endereço que este servidor publica para si mesmo como o recurso para o qual são emitidos, opcionalmente um arquivo do qual ler as chaves de verificação desse servidor e, opcionalmente, os cabeçalhos que um proxy à frente define quando é esse proxy que valida os tokens. issuer e resource são obrigatórios sempre que o transporte HTTP é escolhido, e sem eles um listener é recusado antes de qualquer vinculação; um servidor que se comunica pela entrada e saída padrão não lê nenhum deles. Ambos são publicados no documento de metadados OAuth do recurso protegido que o listener serve, que é a única resposta que um chamador HTTP recebe sem que nenhuma credencial seja pedida, porque um cliente o lê para descobrir onde obter um token. Este bloco não contém material secreto: um token é apresentado por um chamador na requisição que ele faz e nunca é um campo de configuração, e jwks_file nomeia chaves públicas de verificação, e não algo que assine.
deny_reachstring (enum)[]nãoTipos de alcance que este servidor não oferece, seja o que for que o token de um chamador diga. Toda operação declara até onde chegam os seus próprios efeitos — none para uma que lê ou renderiza e não deixa nada para trás, workspace para uma que grava dentro do espaço de trabalho que este processo serve, registry para uma que publica, assina ou retira, e machine para uma que altera o que todos os espaços de trabalho do host compartilham — e nomear um tipo aqui retira deste servidor toda ferramenta desse tipo. Uma ferramenta retirada fica ausente da lista de ferramentas e do que describe-capabilities responde, para todo chamador, e chamá-la mesmo assim é recusado nomeando esta configuração, porque nenhum escopo poderia admiti-la. O padrão é vazio, então o servidor oferece tudo o que os escopos dos seus chamadores admitem. É um limite que o servidor impõe a si mesmo, além do limite por chamador que os escopos definem: um servidor que serve leituras e nada mais nomeia aqui os três tipos que gravam e então não pode publicar nem mesmo para um chamador cujo token traz todos os escopos. Nomear machine é aceito e não muda nada — nenhuma ferramenta desse tipo é oferecida por HTTP, o que é uma propriedade do transporte e não uma configuração. Lido quando o listener é iniciado: um valor fora dos quatro é recusado quando a configuração é carregada, e alterá-lo exige uma reinicialização. Não é lido de forma alguma enquanto o servidor se comunica pela entrada e saída padrão, onde o chamador é a pessoa que iniciou o processo. Valores permitidos para cada entrada: "none", "workspace", "registry", "machine". Valor padrão: []
announce_toolsstring[]nãoFerramentas que este servidor anuncia, nomeadas exatamente como a lista de ferramentas as relata. Omita a chave e toda ferramenta que este servidor oferece é anunciada, que é o que um cliente que segue o protocolo espera: ele obtém a lista completa de ferramentas e decide por conta própria quanto dela apresentar a um modelo. Escreva uma lista e exatamente essas ferramentas são anunciadas — uma deixada de fora fica ausente da lista de ferramentas, ausente do que describe-capabilities responde, e é recusada quando chamada pelo nome, nomeando esta configuração. Escreva uma lista vazia e nada é anunciado. Defina a chave onde o cliente na outra ponta limita quantas ferramentas vai registrar — alguns clientes aplicam esse teto a todos os servidores aos quais estão conectados ao mesmo tempo — e nomeie as ferramentas de que esse cliente precisa. Ela restringe o que é anunciado e nada mais: não pode ampliar deny_reach, que retira uma capacidade por completo, nem os escopos que o token de um chamador traz. Uma ferramenta nomeada aqui de um tipo que deny_reach retira fica fora da lista de ferramentas e é recusada quando chamada, nomeando essa configuração; uma nomeada aqui que os escopos do chamador não admitem continua listada, e uma chamada a ela é recusada nomeando o escopo que a admitiria. Todo nome deve ser um que este binário oferece: um nome ao qual nenhuma ferramenta responde é recusado quando o servidor é iniciado, porque, caso contrário, quem pediu uma superfície mais restrita receberia uma diferente sem que nada o indicasse. Um nome da família cli-, que executa um comando aggrega em um processo separado, é aceito nos dois transportes e não anuncia nada por HTTP, onde nenhuma ferramenta desse tipo é oferecida a nenhum chamador. Lido nos dois transportes quando o servidor é iniciado, então o conjunto anunciado fica fixo durante toda a vida do processo e alterá-lo exige uma reinicialização.
healthobjectnãoOnde um supervisor pergunta se este processo está vivo e se está pronto para responder a uma chamada. As duas verificações são respondidas em um endereço próprio e nunca no endereço que listen nomeia: toda requisição ao endpoint traz um bearer token, então uma sonda respondida ali daria a qualquer coisa que consiga alcançar o endpoint uma leitura não autenticada do processo, junto com um meio gratuito de fazê-lo trabalhar. O endpoint responde a /healthz e /readyz com o mesmo 404 que dá a todo caminho que não serve, com token e sem token igualmente.

Não são permitidas propriedades adicionais.

aggrega-config.mcp.tls

Certificado e chave para fazer a terminação TLS dentro do processo que serve. Defina ambos para servir HTTPS diretamente a partir do listener que listen nomeia. Deixe ambos sem definir para servir em texto simples, o que restringe listen a um endereço de loopback ou a um socket Unix — o formato a usar quando um proxy à frente detém o certificado. Ambas as chaves são caminhos para arquivos em disco; nenhuma delas contém material de chave inline.

PropriedadeTipoObrigatóriaDescrição
cert_filestringnãoCaminho para a cadeia de certificados PEM que o listener apresenta, lido quando o processo é iniciado. É definido junto com key_file. O padrão é vazio, então o listener serve em texto simples e listen fica restrito a um endereço de loopback ou a um socket Unix. Valor padrão: ""
key_filestringnãoCaminho para a chave privada PEM do certificado em cert_file, lido quando o processo é iniciado. É definido junto com essa configuração. Um caminho para um arquivo, nunca material de chave inline. O padrão é vazio, então o listener serve em texto simples e listen fica restrito a um endereço de loopback ou a um socket Unix. Valor padrão: ""

Não são permitidas propriedades adicionais.

aggrega-config.mcp.limits

Tetos que o listener HTTP aplica ao tráfego que aceita, para que um único chamador não possa esgotar o processo que serve. Eles limitam o tamanho que uma única requisição pode ter, quantas requisições são executadas ao mesmo tempo e com que rapidez um chamador pode enviar. Nenhum deles pode ser desativado.

PropriedadeTipoObrigatóriaDescrição
max_body_bytesintegernãoMaior corpo de requisição que o listener aceita, em bytes. Uma requisição cujo corpo o excede é recusada com 413, e o corpo não é lido além do teto. O padrão é 4194304 (4 MiB), bem acima de uma chamada de ferramenta que traz um documento de autoria inteiro e bem abaixo do que permitiria a um único chamador ocupar uma parcela significativa da memória do processo. O mínimo é 1, então não há nenhum valor que desative o teto; aumente-o onde os chamadores enviam legitimamente documentos maiores. Mínimo: 1. Valor padrão: 4194304
max_concurrent_requestsintegernãoQuantas requisições o listener executa ao mesmo tempo. Uma requisição que chega enquanto essa quantidade já está em andamento é recusada com 503 em vez de ser enfileirada, de modo que um chamador é instruído a tentar de novo em vez de esperar atrás de um trabalho que não consegue ver. O padrão é 16, o que deixa espaço para várias chamadas de ferramentas simultâneas mantendo um host pequeno responsivo; aumente-o em um host maior. O mínimo é 1, então não há nenhum valor que desative o teto. Mínimo: 1. Valor padrão: 16
requests_per_minuteintegernãoQuantas requisições um chamador pode enviar em um minuto. A contagem é por chamador, e não por servidor — em relação ao sujeito que o token do chamador nomeia, ou à identidade que um proxy confiável declarou — de modo que um chamador muito ativo não pode gastar a cota de outro. Um chamador pode enviar essa quantidade de uma vez; a cota então se recompõe de forma constante, à razão de uma requisição a mais a cada 60 / requests_per_minute segundos, e uma requisição que chega sem nenhuma restante é recusada com 429. O padrão é 120, ou seja, duas por segundo de forma contínua: muito acima do que um assistente que opera um espaço de trabalho envia, e ainda assim um limite para um cliente que entrou em loop. O mínimo é 1, então não há nenhum valor que desative o teto. Mínimo: 1. Valor padrão: 120

Não são permitidas propriedades adicionais.

aggrega-config.mcp.authorization

O que este servidor declara sobre os bearer tokens que seus chamadores apresentam: qual servidor de autorização os emite, o endereço que este servidor publica para si mesmo como o recurso para o qual são emitidos, opcionalmente um arquivo do qual ler as chaves de verificação desse servidor e, opcionalmente, os cabeçalhos que um proxy à frente define quando é esse proxy que valida os tokens. issuer e resource são obrigatórios sempre que o transporte HTTP é escolhido, e sem eles um listener é recusado antes de qualquer vinculação; um servidor que se comunica pela entrada e saída padrão não lê nenhum deles. Ambos são publicados no documento de metadados OAuth do recurso protegido que o listener serve, que é a única resposta que um chamador HTTP recebe sem que nenhuma credencial seja pedida, porque um cliente o lê para descobrir onde obter um token. Este bloco não contém material secreto: um token é apresentado por um chamador na requisição que ele faz e nunca é um campo de configuração, e jwks_file nomeia chaves públicas de verificação, e não algo que assine.

PropriedadeTipoObrigatóriaDescrição
issuerstringnãoEndereço do servidor de autorização que emite os tokens que este listener aceita, escrito da forma como esse servidor declara seu próprio identificador de emissor — por exemplo https://login.example.com. Ele é publicado na lista authorization_servers do documento de metadados do recurso protegido, que é como um cliente descobre onde obter um token para este listener. O padrão é vazio, que não é um valor utilizável: um listener é recusado antes de qualquer vinculação a menos que esta chave traga um endereço completo, com esquema e host incluídos. É um endereço https, a menos que o servidor de autorização seja executado nesta máquina: http simples só é aceito para um host de loopback, como localhost, 127.0.0.1 ou ::1, e um emissor http simples em qualquer outro host é recusado antes de qualquer vinculação, nomeando esta chave e pedindo um endereço https. Isso vale quer as chaves sejam lidas do emissor ou de jwks_file, quer um trusted_proxy à frente verifique os tokens, porque todo cliente é enviado ao emissor para obter seu token. Valor padrão: ""
resourcestringnãoEndereço que este servidor publica para si mesmo, da forma como um chamador o alcança — por exemplo https://mcp.example.com/mcp. Escreva o endereço que os chamadores realmente usam, incluindo o host que um proxy à frente apresenta, porque este é o identificador que um cliente entrega ao servidor de autorização quando pede um token para este servidor, e ele é publicado sem alterações como o campo resource do documento de metadados do recurso protegido. O local onde esse documento é servido é derivado dele, inserindo /.well-known/oauth-protected-resource entre o host e o caminho: um servidor publicado como https://mcp.example.com/mcp o serve em https://mcp.example.com/.well-known/oauth-protected-resource/mcp, e também nesse caminho well-known sem nada depois, que é onde um cliente procura em segundo lugar. Um token só é aceito quando este endereço está entre as audiências que ele nomeia. O padrão é vazio, que não é um valor utilizável: um listener é recusado antes de qualquer vinculação a menos que esta chave traga um endereço completo, com esquema e host incluídos. Valor padrão: ""
jwks_filestringnãoCaminho para um arquivo que contém o JSON Web Key Set com o qual os tokens que este servidor aceita são verificados, lido quando o processo é iniciado. O padrão é vazio, que é o caso habitual: as chaves são lidas do próprio servidor de autorização, perguntando a issuer onde ele as publica e obtendo-as do endereço que ele indica, e são relidas uma vez quando chega um token assinado por um identificador de chave que o conjunto mantido não contém. Defina esta chave onde o espaço de trabalho está offline, caso em que, sem ela, um listener é recusado antes de qualquer vinculação, porque um espaço de trabalho offline não faz nenhuma requisição de rede e não há outra forma de obter as chaves; o arquivo então contém as únicas chaves aceitas, e o servidor de autorização nunca é contatado. O arquivo contém chaves públicas de verificação e nunca algo que assine. Um caminho relativo é resolvido em relação ao diretório do arquivo de configuração que o declarou. Valor padrão: ""
trusted_proxyobjectnãoLê quem é um chamador a partir de cabeçalhos que um proxy à frente define, em vez de validar aqui um bearer token. Defina isto apenas onde as duas condições se verificam: um proxy à frente valida os tokens por conta própria, e nada além desse proxy consegue alcançar o listener: com isto definido, listen deve ser um endereço de loopback ou um socket Unix, e qualquer outro endereço é recusado antes de qualquer vinculação, nomeando as duas configurações. Um cabeçalho é confiável exatamente na medida do conjunto de chamadores que podem defini-lo, e em um endereço que a rede alcança todo chamador pode definir qualquer cabeçalho que quiser, então um listener nesse modo em um endereço assim permitiria a todo chamador alegar ser qualquer pessoa. Com isto definido, nenhum token é lido — nem do cabeçalho Authorization, nem de qualquer outro lugar, e nenhum conjunto de chaves é obtido —, a identidade do chamador é o valor de principal_header, uma requisição que não traz esse cabeçalho recebe a resposta 401, e os dois cabeçalhos nomeados aqui são os únicos lidos. Omita-o, que é o padrão, e este servidor valida os bearer tokens por conta própria.

Não são permitidas propriedades adicionais.

aggrega-config.mcp.authorization.trusted_proxy

Lê quem é um chamador a partir de cabeçalhos que um proxy à frente define, em vez de validar aqui um bearer token. Defina isto apenas onde as duas condições se verificam: um proxy à frente valida os tokens por conta própria, e nada além desse proxy consegue alcançar o listener: com isto definido, listen deve ser um endereço de loopback ou um socket Unix, e qualquer outro endereço é recusado antes de qualquer vinculação, nomeando as duas configurações. Um cabeçalho é confiável exatamente na medida do conjunto de chamadores que podem defini-lo, e em um endereço que a rede alcança todo chamador pode definir qualquer cabeçalho que quiser, então um listener nesse modo em um endereço assim permitiria a todo chamador alegar ser qualquer pessoa. Com isto definido, nenhum token é lido — nem do cabeçalho Authorization, nem de qualquer outro lugar, e nenhum conjunto de chaves é obtido —, a identidade do chamador é o valor de principal_header, uma requisição que não traz esse cabeçalho recebe a resposta 401, e os dois cabeçalhos nomeados aqui são os únicos lidos. Omita-o, que é o padrão, e este servidor valida os bearer tokens por conta própria.

PropriedadeTipoObrigatóriaDescrição
principal_headerstringsimCabeçalho no qual o proxy à frente coloca a identidade do chamador — por exemplo X-Forwarded-User. Ele é escrito como um nome de cabeçalho HTTP: letras, dígitos e hifens, e os demais caracteres que um nome de cabeçalho pode conter (!#$%&'*+.^_|~ e o acento grave), sem espaço, dois-pontos ou outro separador. Um nome em qualquer outro formato é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a chave, porque nenhuma requisição pode trazer um cabeçalho assim. Um vazio também é recusado: deixaria este servidor verificando os tokens por conta própria enquanto o bloco diz que um proxy à frente faz isso. Para deixar este modo desativado, omita trusted_proxy. O valor do cabeçalho é tomado exatamente como está escrito e não é comparado com nada, da mesma forma que o sujeito de um token que este servidor valida por conta própria é registrado e não é comparado com nada. Ele é a credencial inteira neste modo, então é obrigatório sempre que trusted_proxy está definido, e uma requisição que chega sem ele recebe a resposta 401. Padrão: ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$.
scopes_headerstringnãoCabeçalho no qual o proxy à frente coloca os escopos concedidos ao chamador, separados por espaços — por exemplo X-Forwarded-Scopes. Ele é escrito como um nome de cabeçalho HTTP, no mesmo formato que principal_header, ou deixado vazio. Um nome em qualquer outro formato é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a chave, porque nenhuma requisição pode trazer um cabeçalho assim e nenhum chamador jamais receberia um escopo. O padrão é vazio, o que não declara nenhum escopo para nenhum chamador. Seja qual for o nome, nenhum cabeçalho além deste e de principal_header é lido. Padrão: ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. Valor padrão: ""

Não são permitidas propriedades adicionais.

aggrega-config.mcp.health

Onde um supervisor pergunta se este processo está vivo e se está pronto para responder a uma chamada. As duas verificações são respondidas em um endereço próprio e nunca no endereço que listen nomeia: toda requisição ao endpoint traz um bearer token, então uma sonda respondida ali daria a qualquer coisa que consiga alcançar o endpoint uma leitura não autenticada do processo, junto com um meio gratuito de fazê-lo trabalhar. O endpoint responde a /healthz e /readyz com o mesmo 404 que dá a todo caminho que não serve, com token e sem token igualmente.

PropriedadeTipoObrigatóriaDescrição
listenstringnãoEndereço no qual as verificações de atividade e de prontidão são respondidas, nas mesmas duas formas que listen aceita: host:port, ou unix: seguido de um caminho do sistema de arquivos. O padrão é vazio, então nenhum segundo listener é iniciado e nenhuma das duas verificações é respondida em lugar algum. Com um endereço definido, GET /healthz é respondido com 200 a partir do momento em que o processo está em execução, e GET /readyz é respondido com 503 até que o espaço de trabalho tenha sido resolvido e o endpoint tenha feito a vinculação, e com 200 a partir de então — que é a distinção de que um supervisor precisa, já que um processo que está no ar ainda não é um processo capaz de responder a uma chamada. Toda resposta é um código de status com corpo vazio, nenhum token é pedido e nenhum cabeçalho é lido; qualquer outro caminho neste endereço resulta em 404, e qualquer outro método nesses dois resulta em 405. Ao contrário de listen, este endereço não fica restrito ao loopback ou a um socket Unix e nenhum endereço é recusado para ele: aponte-o para um desses, que é para isso que ele serve, e observe que qualquer coisa que consiga alcançar o endereço escolhido pode ler essas duas respostas. Valor padrão: ""

Não são permitidas propriedades adicionais.

Definições

ReleaseCatalogConfig

Os diretórios de catálogo próprios de uma Release: as mesmas duas chaves que o bloco workspace traz, com escopo restrito a essa Release.

PropriedadeTipoObrigatóriaDescrição
catalog_dirsstring[]nãoDiretórios de catálogo dos quais esta Release lê entidades locais no lugar do catalog_dirs do espaço de trabalho, cada um resolvido em relação ao arquivo que o declara. A mesma pilha de busca ordenada em que vence o primeiro da lista do espaço de trabalho, com o diretório catalog na raiz do espaço de trabalho lido depois dela quando esse diretório existe e nenhuma entrada listada já o contém. Se esta chave for omitida, a Release mantém a lista do espaço de trabalho; se for escrita como [], nenhum catálogo local é lido.
catalog_dirs_appendstring[]nãoDiretórios de catálogo acrescentados depois da lista desta Release — seu próprio catalog_dirs quando a entrada escreve um, caso contrário o do espaço de trabalho —, cada um resolvido em relação ao arquivo que o declara. Valor padrão: []

Não são permitidas propriedades adicionais.

RegistryConfig

Configurações e política de confiança de assinaturas com escopo restrito a um único host de registro OCI.

PropriedadeTipoObrigatóriaDescrição
hoststringsimO host de registro ao qual estas configurações se aplicam (por ex. hub.aggrega.ai). É comparado com o host de registro do destino do push/pull, então é escrito na grafia em que essa comparação é feita: um nome de host em minúsculas que contém um ponto, localhost, um único nome seguido de uma porta (registry:5000), um endereço IPv4 ou um endereço IPv6 entre colchetes, cada um com um :port opcional — sem esquema, caminho, credenciais, espaços em branco ou letra maiúscula. A porta 443 em um host alcançado por HTTPS é a porta padrão desse host, e escrevê-la é recusado quando a configuração é carregada, nomeando o host a escrever sem ela, porque uma entrada escrita dessa forma nunca seria a encontrada; localhost e os demais endereços de loopback são alcançados por HTTP simples, então ali 443 é uma porta comum e é mantida. aggrega registry add e aggrega config init --registry indexam a entrada sob o host que seu argumento nomeia e recusam um que não esteja escrito dessa forma. O host é julgado apenas por sua grafia: não se verifica se o nome é resolvido nem se um registro responde ali. Padrão: ^(?:(?:(?:[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]))$.
namestringnãoAlias amigável opcional para este registro. O host é a identidade; name é um seletor de conveniência que é resolvido para o host desta entrada onde quer que um registro seja nomeado (por exemplo --registry, ou default_registry). Um alias deve ser único entre as entradas.
trusted_identitiesTrustedIdentity[]nãoConjunto OR de identidades de assinatura keyless aceitas para artefatos obtidos por pull deste registro. Uma assinatura é verificada quando seu certificado corresponde a qualquer uma das entradas. Usado pelo caminho de verificação keyless. Valor padrão: []
trusted_deprecation_identitiesTrustedIdentity[]nãoConjunto OR de identidades keyless aceitas adicionalmente para assinar um marcador de descontinuação retroativo de um artefato obtido por pull deste registro. Um marcador de descontinuação é respeitado quando sua assinatura corresponde ao signatário do artefato original OR a qualquer entrada daqui — de modo que o dono de um registro ou uma equipe de segurança pode retirar um artefato que o publicador original não consegue mais alcançar, sem que lhe seja confiada a assinatura dos próprios artefatos. Usado apenas pelo caminho de descoberta de descontinuações; nunca amplia o conjunto de confiança para assinaturas de artefatos. Valor padrão: []
public_keystringnãoChave pública fixada compatível com cosign para um registro em modo com chave, escrita inline como um bloco PEM: o texto de uma linha -----BEGIN PUBLIC KEY----- (ou -----BEGIN RSA PUBLIC KEY-----) até a sua linha -----END correspondente, da forma como aggrega registry add --key a copia de um arquivo de chave. Quando definida, as assinaturas deste registro são verificadas offline com esta chave em vez de com identidades keyless. Um valor que não traz nenhuma linha -----BEGIN … PUBLIC KEY----- é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a entrada, e o mesmo vale para uma chave privada colada aqui por engano. A linha pode estar em qualquer lugar do valor, porque a chave é lida do bloco PEM que o valor traz e qualquer texto antes desse bloco é ignorado. Apenas essa linha é verificada aqui: se o bloco contém uma chave que pode ser decodificada é descoberto quando uma assinatura deste registro é verificada com ela. O valor é declarado sensível (x-aggrega-sensitive), então um valor recusado — sobretudo uma chave privada escolhida por engano — nunca é citado: a recusa nomeia o arquivo, a entrada e a restrição que o valor não cumpriu — o padrão acima, ou o tipo string — e mostra <redacted> onde estaria o valor. Uma chave pública que carrega é lida e mostrada como está escrita. Padrão: -----BEGIN [A-Z ]*PUBLIC KEY-----.
trusted_rootstringnãoCaminho opcional para um bundle de raiz de confiança do Sigstore fixado, para a verificação keyless em ambientes isolados da rede. Quando definido, a âncora de confiança keyless é carregada deste arquivo sem rede; quando vazio, a raiz de confiança public-good é obtida e armazenada em cache.
advisorybooleanonãoQuando é true, uma falha de verificação de assinatura para este registro é rebaixada a um aviso em vez de interromper o pull. A verificação ainda é executada e a falha é relatada; o pull prossegue. O padrão é false. Valor padrão: false
skip_signature_verificationbooleanonãoDesativação de emergência (break-glass) por host da verificação de assinaturas — o mesmo interruptor skip_signature_verification que o global, com escopo restrito a este host pela sua posição. Não anula a política signing.required de nível superior: uma assinatura exigida pela organização continua sendo verificada neste host independentemente deste interruptor; apenas o interruptor global pode desativá-la. Defini-lo junto com um signing.required por registro no mesmo host é permitido, e combina uma assinatura exigida no push com a verificação omitida no pull: a omissão prevalece no lado da verificação, já que uma postura que exige assinatura definida por host (ao contrário da de nível superior) não é imune à omissão por host. O padrão é false. Valor padrão: false
signingSigningConfignãoO bloco de assinatura deste registro: as URLs dos serviços keyless, um caminho opcional de chave para assinatura com chave e a postura de confiança por host. Os campos dos endpoints substituem o bloco signing global para os pushes para este host; uma flag da CLI substitui ambos. required e kinds são lidos a partir da posição — sob uma entrada de registro, eles restringem a única postura de confiança a este host (publicar um artefato não assinado dentro do escopo é recusado, e consumir um não assinado é recusado), o mesmo conceito que o bloco signing de nível superior traz para todos os registros.

Não são permitidas propriedades adicionais.

SigningConfig

Um bloco de assinatura: as URLs dos serviços keyless, uma referência opcional a um arquivo de chave para assinatura com chave e a postura de confiança (required e kinds). Colocado no nível superior, aplica-se a todos os registros; colocado sob uma entrada de registries[], aplica-se a esse host — cada campo obtém seu escopo da posição. required é uma única postura de confiança que cobre as duas direções (um push não assinado dentro do escopo é recusado e um pull não assinado dentro do escopo é recusado). Segurança: ele não contém nenhum material secreto — o token de identidade OIDC nunca é um campo de configuração (é de curta duração e fornecido em tempo de execução), e key_path é um caminho para um arquivo de chave, nunca bytes de chave inline. Isso espelha a assimetria do lado da verificação: ali é permitida uma public_key inline, mas o lado da assinatura traz apenas um caminho de chave. Um servidor aggrega mcp alcançado por HTTP não consulta nenhum key_path em nenhuma das duas posições, então a assinatura com chave é inalcançável por um listener desse tipo: uma chamada que ele responde assina apenas com um token de identidade que essa chamada traz.

PropriedadeTipoObrigatóriaDescrição
fulcio_urlstringnãoURL da autoridade de certificação Fulcio para assinatura keyless. Quando não definida, é usada a instância public-good do Fulcio. Ela é escrita como uma URL https absoluta: https://, um host e, opcionalmente, uma porta e um caminho, sem espaços em branco — por exemplo https://fulcio.sigstore.dev. Um valor em qualquer outro formato, como um sem esquema (fulcio.example.com) ou um que começa com http://, é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a chave. O arquivo é verificado antes de qualquer outra coisa ser aplicada sobre ele, então o mesmo endpoint fornecido por AGGREGA_SIGNING_FULCIO_URL, pela flag --fulcio-url ou em uma requisição de publicação de um editor ou de um assistente não está sujeito a esse formato. Padrão: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
rekor_urlstringnãoURL do log de transparência Rekor para assinatura keyless. Quando não definida, é usada a instância public-good do Rekor. Ela é escrita como uma URL https absoluta: https://, um host e, opcionalmente, uma porta e um caminho, sem espaços em branco — por exemplo https://rekor.sigstore.dev. Um valor em qualquer outro formato, como um sem esquema (rekor.example.com) ou um que começa com http://, é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a chave. O arquivo é verificado antes de qualquer outra coisa ser aplicada sobre ele, então o mesmo endpoint fornecido por AGGREGA_SIGNING_REKOR_URL, pela flag --rekor-url ou em uma requisição de publicação de um editor ou de um assistente não está sujeito a esse formato. Padrão: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
timestamp_urlstringnãoURL da autoridade de carimbo de tempo RFC3161 para assinatura keyless. Ela não tem valor padrão: quando não definida, nenhuma autoridade de carimbo de tempo é contatada, e o horário confiável de uma assinatura keyless vem da sua entrada no log de transparência. Ela é escrita como uma URL https absoluta: https://, um host e, opcionalmente, uma porta e um caminho, sem espaços em branco — por exemplo https://tsa.example.com/api/v1/timestamp. Um valor em qualquer outro formato, como um sem esquema (tsa.example.com) ou um que começa com http://, é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a chave. O arquivo é verificado antes de qualquer outra coisa ser aplicada sobre ele, então o mesmo endpoint fornecido por AGGREGA_SIGNING_TIMESTAMP_URL, pela flag --timestamp-url ou em uma requisição de publicação de um editor ou de um assistente não está sujeito a esse formato. Padrão: ^https://[^\s/?#]+(?:[/?#]\S*)?$.
key_pathstringnãoCaminho para um arquivo PEM com uma chave privada ECDSA P-256 própria para assinatura com chave offline. Um caminho para um arquivo, nunca material de chave inline. Quando não definido, é usado o caminho keyless. Um servidor aggrega mcp alcançado por HTTP nunca consulta esta chave, onde quer que ela esteja definida — no bloco signing de nível superior, no de uma entrada de registro ou por AGGREGA_SIGNING_KEY_PATH: uma chamada que um listener desse tipo responde assina apenas com um token de identidade que a própria chamada traz, ou é recusada. Um servidor alcançado pela entrada e saída padrão assina com ela como faz um terminal.
requiredbooleanonãoA única postura de confiança para o escopo deste bloco: quando é true, publicar um tipo de artefato dentro do escopo exige uma assinatura (um push não assinado dentro do escopo é recusado), e consumir um exige uma assinatura (um pull não assinado dentro do escopo é recusado). O escopo é dado pela posição — no bloco signing de nível superior, ele cobre todo registro; sob o bloco signing de uma entrada de registries[], cobre esse único host. Um nome, uma função, ambos os escopos. A política de nível superior se compõe de forma monotônica ao longo da cascata de configurações — qualquer camada que a defina como true a torna efetivamente true, e nenhuma camada de precedência inferior pode desativá-la novamente — então ela não pode ser removida por uma edição comum da configuração. O padrão é false. Valor padrão: false
kindsstring[]nãoRestringe required a tipos de artefato específicos. Vazio ou uma única entrada all significa todo tipo assinável; caso contrário, a postura se aplica exatamente aos tipos listados, correspondentes ao valor kind: da entidade (por exemplo Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). No bloco signing de nível superior, ela se compõe como uma união ao longo da cascata — uma camada pode ampliar o escopo, mas nunca reduzi-lo. O escopo é dado pela posição, assim como em required. Valor padrão: []

Não são permitidas propriedades adicionais.

TrustedIdentity

Uma identidade de assinatura keyless aceitável: um sujeito de certificado (a identidade OIDC) associado ao emissor OIDC que a garantiu.

PropriedadeTipoObrigatóriaDescrição
identitystringnãoNome alternativo do sujeito exato do certificado — a identidade OIDC vinculada ao certificado de assinatura de curta duração (por exemplo o e-mail de um mantenedor ou a URI de um workflow de CI).
identity_regexpstringnãoExpressão regular comparada com o sujeito do certificado, usada no lugar de uma identity exata (por exemplo, para aceitar qualquer workflow de uma organização).
issuerstringsimURL do emissor OIDC que emitiu o token de identidade (por exemplo https://accounts.google.com ou https://token.actions.githubusercontent.com).

Não são permitidas propriedades adicionais.

PluginRef

Referência a um plugin Wasm vinculado em um socket cuja função de entrada a vinculação pode nomear — as listas governance e linter. Os sockets cujo ponto de entrada é fixo usam em vez disso FixedEntryPluginRef, que traz esses mesmos campos sem function. uri e capability juntos selecionam o plugin: apenas uri é uma vinculação direta (o plugin com essa identidade é vinculado como está — a via dos sockets transversais, já que seus plugins não declaram capacidades servidas); apenas capability resolve o plugin que serve essa capacidade (o nome simples da capacidade que uma Recipe associa por meio de spec.capability, por exemplo helm); os dois juntos desambiguam — capability nomeia o que resolver e uri seleciona o plugin de qual publicador a serve, pela identidade simples desse plugin, em um catálogo federado em que mais de um plugin serve a capacidade. function substitui a função de entrada padrão do socket; quando omitido, aplica-se o padrão documentado do socket — em uma entrada de governança, esse padrão decorre de role. role nomeia o papel de vinculação de governança e é lido apenas em uma entrada de governança. with traz dados de entrada opcionais do momento da vinculação que o plugin lê.

PropriedadeTipoObrigatóriaDescrição
uristringnãoIdentificador do Plugin: a identidade simples de uma entidade Plugin — o caminho <pluginType>/<name>, por exemplo governance/redact ou provider/helm —, um caminho do sistema de arquivos local ou um alias de registro. Opcional: uma entrada pode, em vez disso, selecionar o plugin por capability. Um :version final opcional fixa a versão nas mesmas três formas de qualquer fixação de versão (simples, exata :1.0.0 ou intervalo compatível com a versão principal :^1.0.0).
rolestring (enum)nãoO papel do pipeline ao qual uma vinculação de governança está ligada, lido apenas em uma entrada governance: annotation-transform injeta anotações nos componentes resolvidos antes da expansão de anotações, de modo que as injeções ligadas se tornam vinculações de Feature; label-transform atribui automaticamente rótulos aos nós do grafo de topologia durante a construção da topologia; ir-verdict emite um veredito de aceitação ou rejeição sobre o grafo IR durante a análise estática; render-verdict emite um veredito sobre os artefatos renderizados durante a renderização. É o papel — e não o tipo declarado do plugin — que define o que o plugin pode emitir: a saída de um papel de veredito só pode ser lida como um veredito, nunca aplicada como uma alteração; a saída de um papel de transformação fica confinada pelo host à sua faceta (anotações ou rótulos). Ele também seleciona a função de entrada padrão (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"
capabilitystringnãoA capacidade do provedor para a qual esta entrada seleciona um plugin — o nome simples da capacidade que uma Recipe associa por meio de spec.capability (por exemplo helm, compose). Opcional: uma entrada pode, em vez disso, vincular um plugin diretamente por uri. As associações do provedor usam isto para selecionar o plugin de qual publicador serve uma capacidade em um catálogo federado; os sockets transversais o deixam vazio e vinculam por uri.
functionstringnãoSubstituição opcional da função de entrada padrão do socket. Quando omitida, aplica-se o padrão documentado do socket (governança annotation-transform → transform_annotations, governança label-transform → mutate, governança ir-verdict → verdict_ir, governança render-verdict → verdict_render, linter → lint_rules). A substituição pode nomear qualquer exportação que o plugin declare, e a exportação que ela nomeia deve retornar o formato de saída que esse socket lê: o build é interrompido quando essa saída traz um campo de nível superior que o formato não declara, nomeando a exportação chamada e o campo inesperado. A verificação lê quais nomes de campo de nível superior estão presentes, e não quais estão ausentes nem o que está aninhado abaixo deles, então não é uma validação completa da saída.
withPluginRefWithnãoDados de entrada opcionais do momento da vinculação que o plugin lê. Ambos os membros são opcionais e agnósticos em relação ao socket, então qualquer socket pode reutilizar esta superfície.

Não são permitidas propriedades adicionais.

FixedEntryPluginRef

Referência a um plugin Wasm vinculado em um socket cujo ponto de entrada é fixo em vez de nomeado pela vinculação — a lista importer e as associações providers. Ela traz os mesmos campos de PluginRef sem function: o socket importador chama a única função de entrada que o contrato do seu socket nomeia, e um provedor aciona um conjunto fixo de exportações indexadas por fase em vez de um único ponto de entrada selecionável, então em nenhuma das duas listas há um ponto de entrada que function possa nomear, e a chave não é aceita ali. uri e capability juntos selecionam o plugin: apenas uri é uma vinculação direta (o plugin com essa identidade é vinculado como está — a via do socket importador, já que seus plugins não declaram capacidades servidas); apenas capability resolve o plugin que serve essa capacidade (o nome simples da capacidade que uma Recipe associa por meio de spec.capability, por exemplo helm); os dois juntos desambiguam — capability nomeia o que resolver e uri seleciona o plugin de qual publicador a serve, pela identidade simples desse plugin, em um catálogo federado em que mais de um plugin serve a capacidade. role é aceito aqui, mas não é lido em nenhuma das duas listas que este formato serve: o papel de vinculação de governança que ele nomeia é lido em uma entrada governance, que usa PluginRef, então um papel definido em uma destas entradas não tem efeito. with traz dados de entrada opcionais do momento da vinculação que o plugin lê; uma associação do provedor obtém, em vez disso, sua configuração de renderização da Recipe, então with: em uma delas é recusado no carregamento.

PropriedadeTipoObrigatóriaDescrição
uristringnãoIdentificador do Plugin: a identidade simples de uma entidade Plugin — o caminho <pluginType>/<name>, por exemplo governance/redact ou provider/helm —, um caminho do sistema de arquivos local ou um alias de registro. Opcional: uma entrada pode, em vez disso, selecionar o plugin por capability. Um :version final opcional fixa a versão nas mesmas três formas de qualquer fixação de versão (simples, exata :1.0.0 ou intervalo compatível com a versão principal :^1.0.0).
rolestring (enum)nãoO papel de vinculação de governança. Nenhuma das duas listas que usam este formato o lê — o papel é lido em uma entrada governance, e essas entradas usam PluginRef — então um papel definido aqui é aceito e não tem efeito. Os valores admitidos são os quatro papéis de governança, e o que cada um significa está descrito em PluginRef. Valores permitidos: "annotation-transform", "label-transform", "ir-verdict", "render-verdict"
capabilitystringnãoA capacidade do provedor para a qual esta entrada seleciona um plugin — o nome simples da capacidade que uma Recipe associa por meio de spec.capability (por exemplo helm, compose). Opcional: uma entrada pode, em vez disso, vincular um plugin diretamente por uri. As associações do provedor usam isto para selecionar o plugin de qual publicador serve uma capacidade em um catálogo federado; os sockets transversais o deixam vazio e vinculam por uri.
withPluginRefWithnãoDados de entrada opcionais do momento da vinculação que o plugin lê. Ambos os membros são opcionais e agnósticos em relação ao socket, então qualquer socket pode reutilizar esta superfície.

Não são permitidas propriedades adicionais.

CLIPluginRef

Um plugin de extensão da CLI fixado, instalado como comando aggrega de nível superior: a referência de artefato resolvida e fixada em uma versão que o comando resolve e executa, e o digest de conteúdo dos bytes do guest para os quais essa referência foi resolvida no momento da instalação. Juntos, eles fixam exatamente quais bytes o comando executa; o digest também indexa o cache de describe que fornece os nomes e a ajuda do comando sem carregar o guest.

PropriedadeTipoObrigatóriaDescrição
uristringsimA referência de artefato resolvida e fixada em uma versão que o comando resolve e executa, por exemplo oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0, fixada na instalação.
digeststringsimO digest de conteúdo dos bytes .wasm do guest para os quais a referência foi resolvida na instalação, escrito como sha256: seguido dos 64 dígitos hexadecimais minúsculos do SHA-256 dos bytes — a grafia que aggrega plugin add cli registra, e a grafia em que os bytes resolvidos são comparados. Um digest em qualquer outra grafia — hexadecimal simples sem o prefixo sha256:, letras maiúsculas ou um comprimento diferente — nunca poderia ser igual a ele, então é recusado quando o arquivo de configuração é carregado, nomeando o arquivo e a entrada. Ele fixa os bytes exatos que o comando executa — uma resolução posterior cujos bytes produzem um hash diferente interrompe o comando — e é a chave no cache de describe que gera a ajuda do comando sem carregar o guest. Padrão: ^sha256:[0-9a-f]{64}$.

Não são permitidas propriedades adicionais.

PluginRefWith

Dados de entrada opcionais do momento da vinculação que um plugin lê. Ambos os membros são opcionais e a superfície é geral, então qualquer socket pode reutilizá-la.

PropriedadeTipoObrigatóriaDescrição
sourcesstring[]nãoCaminhos de arquivos de definição que o host lê em tempo de compilação e entrega ao plugin. Cada entrada é um caminho do sistema de arquivos resolvido em relação ao diretório do arquivo de configuração que a declara.
settingsobjectnãoObjeto de configurações de formato livre entregue ao plugin como está. O host não interpreta seu formato; o plugin define as chaves que lê.

Não são permitidas propriedades adicionais.