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 do socket Wasm describe 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/wasm-describe-v1beta1.schema.json

A forma de transmissão que todo plugin Wasm retorna da sua exportação describe() (PluginDescriptor). describe() é a autodeclaração do plugin, lida uma vez pelo host quando ele carrega o plugin: a versão da ABI à qual o guest se associa, o tipo de plugin, as exportações que ele oferece com a declaração de capacidades de cada exportação, um autorrelato de capacidades no nível do plugin, um contrato opcional de comportamento de renderização do provedor, um contrato opcional de reconhecimento do importador, comandos CLI opcionais, um esquema de configurações opcional e metadados de autoria opcionais. Uma única forma cobre todos os tipos de plugin — provedor, linter, etapa de pipeline feature-recipe, governança, CLI, parser e importador. O host lê describe() antes de despachar qualquer outra exportação e recusa um descritor que não pode admitir em vez de invocar o plugin de forma errada no despacho.

Uma das seguintes formas

  • PluginDescriptor

Definições

PluginDescriptor

A autodeclaração completa de um plugin, retornada por describe() e lida uma única vez no carregamento. Ela traz o handshake de compatibilidade de ABI, o tipo de plugin, as exportações oferecidas e as superfícies opcionais próprias de cada tipo (o contrato de comportamento de renderização de um provedor, o contrato de reconhecimento de um importador, os comandos de um plugin CLI, um esquema de configurações, metadados de autoria).

PropriedadeTipoObrigatóriaDescrição
abi_versionconst “v1beta1”simA ABI de plugins à qual o guest se associa. O host aceita exatamente esta versão; um guest compilado para qualquer outra ABI é recusado no carregamento em vez de ser invocado de forma errada no despacho. Constante: "v1beta1"
plugin_typestring (enum)simO tipo do plugin. Ele seleciona a regra de exportação mínima que o host valida e, junto com o nome da exportação, o modelo padrão de entrega da entrada. Um plugin de governança atende aos papéis de transformação e de veredito do pipeline de build; é o papel no qual ele está vinculado — não o seu tipo — que fixa o que ele pode emitir. Valores permitidos: "provider", "linter", "pipeline-step", "governance", "cli", "parser", "importer"
capabilitiesstring[]nãoO que o plugin serve. A lista é plana no formato de transmissão e o plugin_type obrigatório adjacente fixa qual dos quatro sentidos cada entrada carrega: para um provedor, os nomes de capacidade (como helm ou compose) cuja forma de saída ele renderiza; para uma etapa de pipeline feature-recipe, as capacidades de provedor com as quais a sua etapa é compatível; para um parser, os formatos de origem que ele transforma em uma árvore estruturada canônica, cada um escrito como parse:; para um importador, os formatos de origem externos que ele transforma em arquivos de autoria em rascunho, cada um escrito como import:. Um plugin linter, de governança ou CLI não é resolvido por capacidade e a deixa vazia. As entradas estão na ordem declarada e são uma afirmação explícita de compatibilidade testada. Uma lista ausente ou vazia não declara nenhuma afirmação de capacidade. A entidade de catálogo publicada carrega os mesmos valores sob o bloco por tipo ao qual o seu tipo de plugin dá significado, de modo que quem lê a entidade nunca precisa decidir qual sentido se aplica.
exportsPluginExport[]simAs exportações que o plugin oferece, na ordem declarada. O host valida que a exportação mínima própria do tipo está presente e liga a superfície de host de cada exportação antes de invocá-la.
contractProviderContractnãoO autorrelato do comportamento de renderização do provedor — os tipos de entrada que ele renderiza, como ele monta a saída por nó de um grupo de despacho e o par de delimitadores de templates de artefato que aplica. Descreve o provedor como um todo em vez de uma exportação específica. Ausente para um plugin que não declara nenhum contrato de comportamento de renderização.
importerImporterContractnãoO autorrelato de um importador sobre como uma origem dos formatos que ele anuncia é reconhecida quando uma importação não nomeia nenhum formato. Somente um plugin cujo plugin_type é importer pode declará-lo; qualquer outro plugin que o declare é recusado no carregamento. Ausente para um importador que não declara nenhuma forma de reconhecer os seus formatos, que então só são alcançados ao nomeá-los.
descriptionstringnãoA descrição própria do plugin, em uma linha e legível por uma pessoa, do que ele faz, distinta da descrição de uma exportação e da descrição nos metadados da entidade. É informativa; o host não a valida nem age com base nela.
commandsPluginCLICommand[]nãoOs verbos de comando aggrega de nível superior com que um plugin CLI contribui, cada um com a sua própria linha de ajuda curta. Um mesmo plugin CLI pode contribuir com vários comandos; o host registra um comando por entrada e encaminha o nome de comando resolvido ao guest na invocação. Um plugin que não é CLI a deixa vazia.
settings_schemaobjectnãoUm documento JSON Schema opcional que um plugin declara para tipar as configurações fornecidas pelo operador que a sua vinculação carrega. Quando presente, o host o compila no carregamento e valida contra ele as configurações da vinculação no despacho, antes de invocar o plugin; configurações não conformes interrompem o build. Quando ausente, o plugin não declara nenhuma forma e as configurações passam sem alteração. O esquema é a declaração própria e livre do plugin; o host executa contra ele uma validação JSON Schema genérica e não interpreta o significado das configurações.
metadataPluginDescriptorMetanãoInformações opcionais de autoria e de proveniência do build. Não carregam nenhum contrato de comportamento — o host não as valida nem age com base nelas.

Não são permitidas propriedades adicionais.

PluginExport

Uma exportação que um plugin oferece, conforme declarado em describe(). O host despacha para a exportação pelo seu nome e liga a superfície de host de menor privilégio que as funções de host declaradas da exportação exigem.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome ABI da exportação — por exemplo render_node, assemble_boundary, lint_rules ou step. O host despacha para a exportação por esse nome.
input_patternstring (enum)nãoComo o host entrega a entrada da exportação: b entrega o payload completo em linha para que o guest renderize a partir apenas do payload; a entrega um payload pequeno que o guest enriquece por meio de funções de host. Uma exportação que omite este campo assume o padrão do seu tipo de plugin e do seu nome. Valores permitidos: "a", "b"
host_functionsstring[]nãoOs nomes das funções de host que esta exportação importa. Todo nome deve estar na allowlist de funções de host. A declaração é autoritativa e é conferida no carregamento com as funções que o guest de fato importa do seu módulo, de modo que não pode divergir das funções que o guest realmente chama.
descriptionstringnãoTexto opcional legível por uma pessoa que descreve a exportação. É documentação para os leitores do catálogo; o host não o valida nem age com base nele.
stabilitystring (enum)nãoO nível de estabilidade da exportação. Um valor omitido não carrega nenhuma afirmação de estabilidade. Valores permitidos: "stable", "experimental", "deprecated"
operatesstring (enum)nãoA operação de pipeline que esta exportação realiza: patch modifica um documento renderizado existente, emit adiciona um novo documento. A forma do valor é verificada no carregamento; o runtime o lê ao despachar a etapa. Valores permitidos: "patch", "emit"
scopestring (enum)nãoA raiz de documentos sobre a qual esta exportação opera: own são os documentos renderizados próprios do nó, host são os documentos do componente ao qual está vinculada uma receita de feature com escopo de componente. A forma do valor é verificada no carregamento; o runtime resolve os documentos do escopo ao despachar. Valores permitidos: "own", "host"
selectorstringnãoUma descrição livre, legível por uma pessoa, daquilo sobre o que a exportação age. É documentação para os leitores do catálogo; o host não valida o seu conteúdo nem age com base nele.
inputobjectnãoUm documento JSON Schema opcional que uma exportação step declara para tipar a entrada local à etapa que uma entrada de pipeline fornece por meio do seu bloco with. Quando presente, descreve a forma que a entrada with de uma etapa satisfaz; quando ausente, a exportação não declara nenhum contrato de entrada. O esquema é a declaração própria e livre, feita pela exportação, da superfície de entrada que o autor de um pipeline visa para esta exportação.
outputobjectnãoUm documento JSON Schema opcional que uma exportação step declara para tipar as saídas que retorna para uma etapa — a forma das saídas endereçáveis com que uma etapa contribui para que uma etapa posterior ou um template as leia. Quando presente, descreve a forma dessas saídas retornadas; quando ausente, a exportação não declara nenhum contrato de saída. O esquema é a declaração própria e livre, feita pela exportação, da superfície de saída que esta exportação produz.

Não são permitidas propriedades adicionais.

PluginCLICommand

Um verbo de comando aggrega de nível superior com que um plugin CLI contribui, conforme declarado em describe(). O host registra um comando por entrada e encaminha de volta ao guest o nome de comando resolvido na invocação, de modo que um único guest pode sustentar vários comandos e escolher o seu comportamento pelo nome.

PropriedadeTipoObrigatóriaDescrição
namestringsimO verbo de comando que o host registra — o token aggrega que um operador invoca e o discriminador que o host entrega ao guest para que ele possa encaminhar conforme o comando chamado. Todo comando declarado deve nomeá-lo.
descriptionstringnãoO texto de ajuda curta do comando, em uma linha, exibido na listagem de comandos e na saída de ajuda. É documentação opcional; o host não o valida nem age com base nele.
flagsPluginCommandFlag[]nãoAs flags do comando, na ordem declarada. Cada entrada contribui com uma flag que o host registra no comando para que aggrega help a exiba como a flag de um comando do núcleo. Um comando sem flags a deixa vazia.

Não são permitidas propriedades adicionais.

PluginCommandFlag

Uma flag que um plugin CLI declara em um comando, conforme informado em describe(). O host a registra no comando para que aggrega help a liste ao lado das flags de um comando do núcleo.

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome longo do flag — o token —name que um operador passa na linha de comando. Todo flag declarado deve indicá-lo. Pelo menos 1 caractere.
shorthandstringnãoO alias curto opcional de um único caractere da flag — a forma -x que um operador pode passar em vez do nome longo. Ausente significa que a flag não tem alias curto.
descriptionstringnãoO texto de ajuda de uma linha do flag, exibido na saída de ajuda do comando. É documentação opcional; o host não o valida nem age com base nele.
typestringnãoO tipo de valor da flag — por exemplo string, bool ou int. Ausente, não carrega nenhuma afirmação de tipo.
defaultstringnãoO valor padrão da flag quando o operador não a passa, expresso como string. Ausente significa que a flag não declara nenhum valor padrão.

Não são permitidas propriedades adicionais.

PluginDescriptorMeta

Metadados opcionais de autoria e de proveniência do build que um plugin declara em describe(). São informativos; o host não os valida nem age com base neles. Os campos version e commit são a proveniência do build carimbada no guest no momento do build; um build sem carimbo os omite.

PropriedadeTipoObrigatóriaDescrição
authorstringnãoO autor do plugin.
repositorystringnãoO repositório de origem do plugin.
licensestringnãoO identificador de licença do plugin.
versionstringnãoA versão de proveniência do build carimbada no guest no momento do build. Omitida por um build sem carimbo.
commitstringnãoO commit curto de proveniência do build a partir do qual o guest foi compilado. Omitido por um build sem carimbo.

Não são permitidas propriedades adicionais.

ProviderContract

A autodeclaração de um provedor sobre os comportamentos de renderização em tempo de compilação que ele realiza nos nós que renderiza — os tipos de entrada que aceita, se e como monta a saída por nó de um grupo de despacho em um único artefato, o par de delimitadores de templates Go que aplica aos arquivos de artefato importados, se aceita os arquivos com que uma Recipe contribui para a saída compartilhada da sua fronteira, e os arquivos que o seu ecossistema nunca distribui ao lado de uma origem. Descreve o provedor como um todo, não uma exportação específica. A verificação de carregamento a confere com a afirmação escrita da entidade.

PropriedadeTipoObrigatóriaDescrição
input_kindsInputKindssimQuais dos três tipos de entrada de uma Recipe o plugin renderiza: um conjunto de arquivos com origem, um workload sintetizado e um nó autônomo somente de artefatos.
boundary_assemblystring (enum)simComo o plugin combina a saída de renderização por nó de um grupo de despacho: none escreve a saída de cada nó diretamente no caminho de despacho, merge funde os fragmentos por nó em um único documento, e nest coloca a saída de cada nó na sua própria posição dentro de uma estrutura guarda-chuva. Um valor vazio não carrega nenhuma afirmação de montagem. Valores permitidos: "none", "merge", "nest", ""
artifact_delimitersArtifactDelimitersnãoO par de delimitadores de templates Go que o plugin aplica aos arquivos de artefato importados. Ausente, vale o par padrão de abertura/fechamento; um plugin cuja sintaxe de destino colide com esse par informa aqui um par alternativo.
assembly_name_annotationAssemblyNameAnnotationnãoUma anotação de fronteira cujo valor resolvido nomeia o artefato que o plugin monta a partir de um grupo de despacho. Ausente, o plugin nomeia a sua montagem apenas a partir do caminho de despacho.
reusable_instancebooleanonãoSe uma única instância carregada do plugin pode atender a toda travessia de renderização, montagem e validação do build em vez de uma instância nova por travessia. Um plugin o declara true somente quando não mantém nenhum estado entre travessias. Ausente (false) é o padrão seguro: o host carrega uma instância nova por travessia.
cross_boundary_linkingbooleanonãoSe o plugin cabeia arestas uses que cruzam a fronteira — arestas cujas extremidades consumidora e consumida são montadas em grupos de despacho diferentes — produzindo um cabeamento de referências cruzadas nativo do provedor por meio das suas exportações link_publish e link_resolve. Um plugin o declara true somente quando exporta ambas. Ausente (false) é o padrão seguro: o plugin não cabeia nenhuma aresta que cruze a fronteira.
omitsbooleanonãoSe o plugin respeita as entradas omit que uma entrada render_node carrega: ele deixa de fora de tudo o que retorna cada unidade renderizada à qual uma entrada corresponde, e informa no campo omitted da saída uma contagem por entrada que recebeu. Um plugin o declara true somente quando faz ambas as coisas. Ausente (false) é o padrão seguro: o plugin não afirma deixar nada de fora.
boundary_artifactsbooleanonãoSe o destino do plugin aceita os arquivos com que uma Recipe contribui para a saída compartilhada da fronteira em que ele renderiza. O host avalia esses arquivos e escreve cada um uma única vez, no diretório que contém a saída montada do grupo de despacho, ao lado do que a montagem do plugin escreve; nenhum deles é entregue ao plugin e ele não lê nenhum deles, de modo que a afirmação declara que o seu destino trata um arquivo colocado ali como parte da saída da fronteira. Ausente (false) é o padrão seguro: uma Recipe que declara esses arquivos para este plugin é recusada antes que qualquer coisa seja renderizada.
nest_segmentstringnãoO diretório sob o qual o destino do plugin coloca o subdiretório próprio de cada contribuidor, para um plugin que aninha a saída por nó de um grupo de despacho. O host junta este segmento, o nome do contribuidor no nível de autoria e o caminho próprio de cada arquivo. Lido somente quando boundary_assembly é nest. Ausente, o host coloca o subdiretório de cada contribuidor diretamente na posição de despacho, sem nenhum diretório envolvente. O valor nomeia um diretório e nunca um caminho: um valor que contém um separador de caminho, ou que nomeia o diretório atual ou o diretório pai, é recusado, porque o host compõe nele o nome do contribuidor e um fragmento de caminho colocaria os arquivos de um contribuidor em outro lugar que não sob a posição de despacho.
source_ignoreSourceIgnorenãoOs arquivos que o ecossistema deste plugin nunca distribui ao lado de uma origem que ele renderiza, declarados como regras de exclusão. O host lê a declaração quando um autor fixa uma Recipe ou uma FeatureRecipe cuja capacidade este plugin atende para ele: compõe essas regras com o próprio arquivo de exclusão do autor, registra as regras compostas no lock da entidade ao lado da entidade e, a partir daí, toda publicação da entidade, toda comparação da sua origem local e toda renderização dela aplicam as regras registradas em vez de consultar um plugin novamente. Assim, uma Recipe publicada para uma capacidade carrega os arquivos que as regras do seu publicador mantiveram, e um plugin a renderiza quando fala a mesma versão de ABI, o seu contrato corresponde à afirmação da sua entidade e ele não precisa de nenhum arquivo fora desse conjunto. Um plugin que precisa de um arquivo que o conjunto deixou de fora deve fazer o seu build falhar de forma explícita e nomear o arquivo; a parte do host é recusar um empacotamento ou uma leitura de um arquivo que o conjunto não contém, nomeando-o. Ausente, não declara nenhuma regra de exclusão, e uma origem que o plugin renderiza mantém então todo arquivo que as próprias regras do autor mantêm.

Não são permitidas propriedades adicionais.

SourceIgnore

As regras de exclusão que o ecossistema de um plugin aplica a um diretório de origem, em sintaxe gitignore: um padrão que não contém nenhuma barra, ou apenas uma final, corresponde a um nome em qualquer profundidade, um padrão que contém qualquer outra barra é lido a partir da raiz do diretório ao qual está restrito, uma barra final corresponde apenas a um diretório, e um ! inicial traz de volta o que uma regra anterior excluiu. As regras se aplicam em ordem e uma correspondência posterior prevalece sobre uma anterior. Um diretório que uma regra exclui não é percorrido, de modo que nada dentro dele volta, a menos que o próprio diretório seja trazido de volta antes.

PropriedadeTipoObrigatóriaDescrição
patternsstring[]nãoOs padrões de exclusão próprios do ecossistema, cada um restrito à raiz do diretório de origem local que está sendo percorrido, na ordem em que se aplicam. Ausente ou vazio não declara nenhum.
filesstring[]nãoOs nomes dos arquivos de exclusão que o ecossistema respeita dentro de uma origem — .helmignore para um chart, por exemplo. Onde quer que o percurso de uma origem encontre um arquivo com um desses nomes, as suas linhas são lidas como padrões adicionais na mesma sintaxe, cada um restrito ao diretório que contém o arquivo, e se aplicam depois dos padrões acima; uma linha em branco e uma linha que começa com # são ignoradas. Um arquivo com um desses nomes é ele próprio mantido, a menos que uma regra o exclua. Ausente ou vazio não nomeia nenhum.

Não são permitidas propriedades adicionais.

InputKinds

Quais tipos de entrada de Recipe um plugin renderiza. Cada campo é uma afirmação independente; um plugin pode informar qualquer combinação.

PropriedadeTipoObrigatóriaDescrição
sourcedbooleanosimSe o plugin renderiza um conjunto de arquivos com origem (um chart, um módulo, um arquivo compose).
synthesizedbooleanosimSe o plugin renderiza um workload sintetizado.
artifacts_standalonebooleanosimSe o plugin renderiza um nó autônomo somente de artefatos — um que carrega documentos de artefato importados e nenhuma origem nem workload.

Não são permitidas propriedades adicionais.

ArtifactDelimiters

O par de delimitadores de templates Go que um plugin aplica aos arquivos de artefato importados, informado quando difere do par padrão.

PropriedadeTipoObrigatóriaDescrição
leftstringsimO delimitador de abertura.
rightstringsimO delimitador de fechamento.

Não são permitidas propriedades adicionais.

AssemblyNameAnnotation

A anotação de fronteira cujo valor resolvido nomeia o artefato montado de um plugin, informada quando o plugin reúne as fronteiras contribuintes de um grupo de despacho em uma única montagem nomeada.

PropriedadeTipoObrigatóriaDescrição
annotationstringsimA chave da anotação de fronteira da qual o plugin lê o nome do artefato montado.
require_uniquebooleanonãoSe cada fronteira que contribui para um mesmo grupo de despacho deve concordar quanto ao valor resolvido da anotação. Quando true, um grupo cujas fronteiras contribuintes resolvem a anotação para valores diferentes interrompe o build; quando false, o plugin aceita o primeiro valor resolvido.

Não são permitidas propriedades adicionais.

ImporterContract

O que um importador declara sobre os seus formatos além de anunciá-los: as assinaturas pelas quais uma origem desses formatos é reconhecida. Quando uma importação não nomeia nenhum formato, o host lê as assinaturas registradas por cada importador entre os quais a importação escolhe — os importadores no catálogo do espaço de trabalho e os importadores do núcleo do compilador, cujas entidades Plugin o binário traz —, compara cada uma com a origem sem saber o que é qualquer formato, e lê a origem como o formato do único importador cuja assinatura corresponde. Uma origem à qual nenhuma assinatura corresponde é recusada pedindo o formato, e uma origem à qual correspondem assinaturas de mais de um formato é recusada nomeando-os. A entidade Plugin registra a mesma lista, e o host recusa um importador cujo relatório de describe() difere do registro.

PropriedadeTipoObrigatóriaDescrição
detectDetectSignature[]nãoAs assinaturas que reconhecem uma origem dos formatos deste importador, na ordem declarada; uma origem é reconhecida quando qualquer uma delas corresponde a ela. Uma origem reconhecida por um importador é reconhecida como cada formato que o importador anuncia, de modo que um importador que anuncia mais de um formato tem toda correspondência recusada como ambígua, e um importador cujas origens precisam ser reconhecidas anuncia um único formato. Ausente ou vazio não declara nenhuma assinatura, e os formatos do importador só são alcançados ao nomeá-los.

Não são permitidas propriedades adicionais.

DetectSignature

Uma forma pela qual uma origem é reconhecida: a sintaxe em que a origem é lida, os nomes de arquivo aos quais a assinatura se aplica e os predicados que a árvore analisada precisa satisfazer. Ela corresponde a um arquivo cujo nome corresponde a um dos seus padrões de arquivo — ou, quando não declara nenhum, a uma origem que é um único arquivo, qualquer que seja o seu nome — cujos bytes são analisados na sua sintaxe e cuja árvore analisada satisfaz cada um dos seus predicados. Ela corresponde a um diretório quando corresponde a um dos arquivos do diretório que os seus padrões selecionam, de modo que uma assinatura que não declara nenhum padrão não corresponde a nenhum diretório.

PropriedadeTipoObrigatóriaDescrição
syntaxstringsimO formato sintático como o qual a origem é analisada — json ou yaml, por exemplo —, que é o formato que um plugin parser anuncia como parse:. O host analisa a origem por meio do parser que o catálogo do espaço de trabalho fornece para essa sintaxe ou, para uma sintaxe para a qual o catálogo não fornece nenhum, por meio daquele que o compilador traz, no máximo uma vez, qualquer que seja o número de assinaturas que nomeiam a sintaxe, e uma origem que não é analisada nela não corresponde a nenhuma assinatura que a nomeie. Uma sintaxe para a qual nenhum dos dois fornece um parser interrompe o reconhecimento nomeando a ausência desse parser, em vez de ser ignorada. Pelo menos 1 caractere.
filesstring[]nãoOs padrões de nome de arquivo aos quais a assinatura se aplica, comparados com o final do nome da origem com os seus separadores lidos como barras normais: um padrão de um segmento é comparado com o próprio nome do arquivo, e um padrão de vários segmentos separados por barras com esse mesmo número de segmentos finais do seu caminho, de modo que .vscode/mcp.json corresponde a um arquivo chamado mcp.json em um diretório chamado .vscode. Dentro de um segmento, * corresponde a qualquer sequência de caracteres, ? corresponde a um caractere e […] corresponde a um caractere de uma classe. A assinatura se aplica quando qualquer padrão corresponde. Um padrão malformado é recusado no carregamento. Ausente ou vazio aplica a assinatura a uma origem que é um único arquivo, qualquer que seja o seu nome, e a nenhum arquivo de um diretório. Os padrões das assinaturas de um importador também são o que decide quais arquivos de um diretório uma importação entrega a ele.
matchPathMatch[]nãoOs predicados que a árvore analisada deve satisfazer, todos eles, na ordem declarada. Se ausente ou vazio, não exige nada da árvore além de ser analisável na sintaxe.

Não são permitidas propriedades adicionais.

PathMatch

Um predicado sobre a árvore analisada: o valor que um caminho alcança, o tipo de valor que ele precisa ser e, opcionalmente, uma string à qual ele precisa ser igual ou com a qual precisa começar.

PropriedadeTipoObrigatóriaDescrição
pathstringsimOnde na árvore o predicado olha, escrito como chaves unidas por pontos a partir do topo da árvore: data.nodes nomeia o membro nodes do objeto data de nível superior. Um segmento escrito como um número inteiro, 0 ou maior, seleciona essa posição de um array contando a partir de zero, de modo que nodes.0.type nomeia o type do primeiro nó; todo outro segmento seleciona um membro de um objeto. Uma chave que contém ela própria um ponto não pode ser nomeada. Pelo menos 1 caractere.
isstring (enum)simO que o caminho precisa alcançar: present vale quando alcança um valor de qualquer tipo, null incluído; absent vale quando não alcança nada; object, array, string, number e boolean valem cada um quando alcança um valor desse tipo. Valores permitidos: "present", "absent", "object", "array", "string", "number", "boolean"
equalsstringnãoUma string à qual o valor que o caminho alcança precisa ser exatamente igual. Um valor que não é uma string nunca é igual a ela. No máximo um de equals e prefix é declarado em um predicado, e um predicado que declara ambos é recusado no carregamento. Pelo menos 1 caractere.
prefixstringnãoUma string com a qual o valor que o caminho alcança precisa começar. Um valor que não é uma string nunca começa com ela. No máximo um de equals e prefix é declarado em um predicado, e um predicado que declara ambos é recusado no carregamento. Pelo menos 1 caractere.

Não são permitidas propriedades adicionais.