Esquema del socket Wasm de renderizado del Provider de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json
Las formas de transmisión que un socket de plugin de renderizado del Provider consume y emite. Un guest del Provider renderiza un nodo IR en archivos de salida mediante su exportación render_node (de RenderNodeInput a RenderNodeOutput) y, opcionalmente, fusiona las salidas por nodo de un límite en un único artefacto ensamblado mediante su exportación assemble_boundary (de AssembleBoundaryInput a AssembleBoundaryOutput). AssembleBoundaryOutput lleva los archivos ensamblados y los diagnósticos que haya; dónde se ubican los archivos de cada contribuyente se declara una sola vez en el contrato describe() del guest en lugar de en esta respuesta. Un guest también puede declarar una exportación opcional validate_node_input que comprueba estructuralmente la entrada resuelta de un nodo antes del despacho del renderizado: consume la misma proyección RenderNodeInput que recibe render_node y devuelve un ValidateNodeOutput que lleva solo diagnósticos — un diagnóstico de severidad halt detiene el build de forma explícita, un diagnóstico de severidad warn se presenta en el resultado del build. Un guest cuyo destino limita o restringe los nombres que acepta también puede declarar una exportación opcional name_bound, a la que el host consulta antes de fijar la identidad de componente de un nodo: consume un NameBoundInput que lleva un nombre propuesto y devuelve un NameBoundOutput que lleva un veredicto por cada tipo de nombre que el guest derivaría de él. Un veredicto lleva una restricción — utilizable, o limitado a una longitud más corta — y nunca un nombre construido por el guest, de modo que el conocimiento de lo que acepta el destino permanece en el guest. Por separado, un guest cuyo destino deriva un nombre propio para los recursos que renderiza — a partir de un origen proporcionado por el autor, o de un workload que sintetiza — puede declarar una exportación opcional rendered_name, a la que el host consulta para que el autor de una Recipe pueda leer ese nombre y publicar una dirección construida a partir de él: consume un RenderedNameInput que lleva las identidades de las que deriva el destino y los tipos de entrada que declara la Recipe del nodo, y devuelve un RenderedNameOutput que lleva el nombre con el que el propio guest renderizará, o ningún nombre cuando no deriva ninguno. Las dos exportaciones son direcciones opuestas de un mismo asunto y ninguna sustituye a la otra — name_bound pide al guest que juzgue un nombre que propone el host, mientras que rendered_name informa de un nombre que compuso el guest, que el host lleva sin leerlo. Un guest también puede declarar carve y reassemble, que dividen su propia salida en unidades direccionables para un paso de pipeline y vuelven a unir las unidades parcheadas, y link_publish y link_resolve, que cablean una arista uses cuyos extremos se ensamblan en grupos de despacho distintos. La forma de cada payload es la definición que nombra su exportación: la tabla x-aggrega-exports asigna cada exportación con la que el host llama a un guest — carve y reassemble incluidas — a la definición de su entrada y a la definición de su salida, cada una como un JSON Pointer en los $defs de este documento, de modo que una herramienta que valida un payload busca allí su definición. La raíz del documento no declara ninguna forma propia, porque un mismo documento puede ser un payload válido de varias exportaciones (un objeto vacío es una respuesta válida de validate_node_input, name_bound y rendered_name por igual). El guest devuelve los bytes serializados de cada archivo de salida; el host los escribe tal cual y no ejecuta ningún serializador, por lo que el determinismo es responsabilidad del guest: una entrada idéntica debe producir bytes idénticos. Los tipos de payload de Go, Rust y TypeScript se generan a partir de este esquema en los paquetes de la ABI de plugins, de modo que los tres lenguajes leen y escriben el mismo formato de transmisión; un guest los importa desde esos paquetes, o a través de su kit de plugins cuando el kit los reexporta.
Exportaciones
La tabla x-aggrega-exports del esquema asigna cada exportación con la que el host llama a un guest a la definición de su entrada y a la definición de su salida. La forma de un payload es la definición que nombra su exportación.
| Exportación | Entrada | Salida |
|---|---|---|
render_node | RenderNodeInput | RenderNodeOutput |
validate_node_input | RenderNodeInput | ValidateNodeOutput |
assemble_boundary | AssembleBoundaryInput | AssembleBoundaryOutput |
carve | CarveInput | CarveOutput |
reassemble | ReassembleInput | ReassembleOutput |
name_bound | NameBoundInput | NameBoundOutput |
rendered_name | RenderedNameInput | RenderedNameOutput |
link_publish | LinkPublishInput | LinkPublishOutput |
link_resolve | LinkResolveInput | LinkResolveOutput |
Definiciones
RenderNodeInput
El payload que un guest del Provider recibe en su exportación render_node: la proyección IR por nodo que renderiza el guest, el contexto del momento del renderizado, las entradas preevaluadas que declara la Recipe enlazada al nodo — un listado del origen adquirido, un workload, un conjunto de artefactos —, cada una presente solo cuando esa Recipe la declara, y las entradas que nombran unidades renderizadas que el guest deja fuera de un renderizado de origen.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
node | IRNodeProjection | sí | Los datos IR por nodo que renderiza un guest del Provider — una proyección acotada del nodo IR completo que lleva la identidad por nodo y la procedencia que el guest estampa en cada manifiesto emitido: su id, su tipo, la receta resuelta, los valores, si un mapeo de valores produjo esos valores, las vinculaciones de feature, la marca de sensibilidad sobre sus claves renderizadas y sobre los valores en su conjunto, las aristas uses salientes, la ruta del límite, la sync wave, la identidad de la Recipe, la sobrescritura del id de componente, la base del nombre derivado y la procedencia del build. La identidad y la base del nombre derivado se llevan por separado porque responden a dos preguntas — a qué pertenece un recurso, y contra qué se renderiza el origen propio de un autor — y una vinculación de Feature que entrega un origen escrito por su autor es donde las dos respuestas difieren. El contenido de los archivos de origen no se lleva aquí; viaja por separado en la proyección del origen. Cada conjunto de claves aquí tiene un orden fijo — features y uses en el orden del autor, values y la marca de sensibilidad en orden de clave — de modo que el payload transmitido es idéntico byte a byte entre ejecuciones con entrada idéntica. |
context | object | sí | El contexto del momento del renderizado que el host entrega al guest, transportado como los bytes de su documento JSON; este esquema deja el objeto sin declarar. Es el contexto que recibe un paso de pipeline del mismo nodo, más el ancho de la sangría: parameters, los valores de parámetros de la Release ordenados por nombre, ausentes cuando no hay ninguno; annotations, las anotaciones del nodo divididas según dónde se escribió cada una en aggregate, release y catalog, cada uno ausente cuando está vacío; boundary, el límite en el que se encuentra el nodo: name, path (sus segmentos), sync_wave (ausente cuando es 0), directory, sub_directory (ausente cuando no hay ninguno) y annotations (el conjunto que los límites de la Release propagan en cascada hasta el nodo, con su propia entrada de la Release aplicada en último lugar; ausente cuando está vacío); y yaml_indent, el ancho de la sangría común a todo el renderizado con el que el guest serializa su salida. El renderizado de una FeatureRecipe con ámbito de límite, que no tiene componente host, recibe el contexto que recibe su paso de pipeline, más yaml_indent: parameters; annotations, que lleva solo el contenedor release, que es el conjunto de anotaciones propio del límite; y un boundary que lleva su name, su path y ese mismo conjunto como sus annotations. Las anotaciones conocidas aggrega.ai/* se leen del contenedor aggregate con el contenedor release escrito encima, de modo que una clave que llevan ambos toma el valor de la Release; un proveedor de la biblioteca estándar las lee de ese conjunto por capas y nunca del contenedor catalog, de modo que un valor del catálogo nunca decide ninguna, y una FeatureRecipe con ámbito de límite, cuyo contexto no lleva ningún contenedor aggregate, renderiza según los valores de su límite y no según los de ningún componente. |
source_listing | SourceListing | no | La enumeración genérica del origen adquirido que el host entrega al guest para un proveedor con origen: la raíz del origen, si esa raíz es un directorio, y las entradas ordenadas relativas a la raíz que hay debajo de ella. Aquí el host no lee ningún contenido de archivo — solo lista nombres. El guest aplica su propia lógica de resolución sobre el listado y pide al host que empaquete una selección elegida mediante la función host pack-source, de modo que toda la inteligencia de resolución de origen propia de cada proveedor reside en el guest. Presente para los proveedores con origen; ausente en caso contrario. |
workload_projection | WorkloadProjection | no | El workload preevaluado que el host entrega al guest para que sintetice a partir de él manifiestos nativos del proveedor; presente cuando la Recipe enlazada declara un workload en lugar de un origen de chart, ausente en caso contrario. |
artifacts_projection | ArtifactsProjection | no | El conjunto de artefactos preevaluado que el host entrega al guest para que lo coloque en la salida del nodo, presente cuando la Recipe enlazada declara artefactos. El host ya leyó el origen de cada entrada, lo evaluó como plantilla Go contra el contexto de renderizado y calculó los conjuntos de claves de la procedencia del build; el guest decide el formato de salida, la ubicación de la procedencia, la ruta en disco y los bytes finales. Ausente cuando el nodo no declara ningún artefacto. |
omits | OmitEntry[] | no | Las entradas que nombran unidades renderizadas que el guest deja fuera de la salida de este nodo, en el orden en que el autor las declaró. Cada entrada llega resuelta, con sus campos como cadenas simples, y una entrada que no se aplica a este build no se lleva. Lo que seleccionan el kind, el name, el namespace y el subchart de una entrada es el contrato documentado propio de este proveedor, no el de este socket: el guest compara cada entrada con lo que renderizó en los términos de su propio formato, deja fuera de todo lo que devuelve cada unidad con la que coincide una entrada — sus archivos, los nombres que declara en derived_keys y los hechos que informa en render_facts — e informa en omitted de la salida con cuántas unidades coincidió cada entrada. Las entradas acompañan a un listado de origen y a ninguna otra entrada: un renderizado de un workload sintetizado o de un conjunto de artefactos nunca las lleva. Ausente cuando no hay entradas, y un guest al que no se le entrega ninguna renderiza exactamente como lo haría si el campo no existiera. |
No se permiten propiedades adicionales.
IRNodeProjection
Los datos IR por nodo que renderiza un guest del Provider — una proyección acotada del nodo IR completo que lleva la identidad por nodo y la procedencia que el guest estampa en cada manifiesto emitido: su id, su tipo, la receta resuelta, los valores, si un mapeo de valores produjo esos valores, las vinculaciones de feature, la marca de sensibilidad sobre sus claves renderizadas y sobre los valores en su conjunto, las aristas uses salientes, la ruta del límite, la sync wave, la identidad de la Recipe, la sobrescritura del id de componente, la base del nombre derivado y la procedencia del build. La identidad y la base del nombre derivado se llevan por separado porque responden a dos preguntas — a qué pertenece un recurso, y contra qué se renderiza el origen propio de un autor — y una vinculación de Feature que entrega un origen escrito por su autor es donde las dos respuestas difieren. El contenido de los archivos de origen no se lleva aquí; viaja por separado en la proyección del origen. Cada conjunto de claves aquí tiene un orden fijo — features y uses en el orden del autor, values y la marca de sensibilidad en orden de clave — de modo que el payload transmitido es idéntico byte a byte entre ejecuciones con entrada idéntica.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
id | string | sí | El id absoluto del nodo dentro del grafo de topología. |
type | string | sí | Declarado y retenido deliberadamente: el host siempre lo emite como cadena vacía. La etiqueta de tipo de componente del nodo es un metadato opaco y no un conmutador de comportamiento, por lo que llevarla aquí solo invitaría a un guest a bifurcar en función de ella. Un guest lee una cadena vacía y no debe interpretarla como un nodo cuyo tipo de componente no está establecido. (La forma de nodo de ensamblado de límite lleva un tipo propio, con un propósito distinto.) |
resolved_recipe | string | sí | Declarado y retenido deliberadamente: el host siempre lo emite como cadena vacía. La identidad de la Recipe enlazada ya llega al guest como el nombre y la versión de receta que estampa en la procedencia, por lo que el URI resuelto no añade nada a partir de lo cual renderice un guest. Un guest que necesita atribuir la salida a una Recipe lee en su lugar esos campos de procedencia. |
values | object | no | El diccionario de valores renderizados del nodo, el conjunto de claves a partir del cual renderiza el guest. Las claves llegan ordenadas, no en el orden del autor, y ese ordenamiento es lo que hace que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica; un guest que necesita cualquier otro orden lo impone él mismo. |
features | object | no | Las vinculaciones de feature del nodo indexadas por alias de feature, que llevan la misma forma de vinculación de feature por nodo que lleva el IR. Cada entrada lleva los values, el infra y el mapeo inject de la vinculación junto con su marca de sensibilidad derivada, de modo que un guest lee solo a partir del payload si una vinculación maneja material declarado sensible. Conserva el orden del autor, de modo que el payload es idéntico byte a byte entre ejecuciones con entrada idéntica. Opaco en esta capa del esquema; el guest lee la forma de la entrada de feature a través del contrato de transmisión del IR. |
sensitive_rendered_keys | mapa de string | no | Claves renderizadas cuya identidad se recupera a partir de un dato que un autor declaró sensible, cada una asociada a la declaración de la que heredó esa sensibilidad. Viaja del host al guest en la entrada de renderizado — la dirección opuesta a la de los nombres que un guest declara en la salida de renderizado. Lo que nombra una clave sigue la forma que lleva este payload: en un payload que lleva los valores del nodo es una de las claves de ese mapa; en un payload que lleva un workload nombra una entrada en los mapas de vinculación propios del workload, donde los valores del nodo están vacíos. Una clave solo está presente donde la recuperación es exacta, uniendo una declaración a una identidad renderizada sin leer nada del texto propio de la clave y sin repartir entre claves individuales ninguna marca por nodo o por vinculación. Una clave inventada por una plantilla está, por tanto, ausente, porque ninguna declaración la nombra: las claves de salida del valuesMapping de una receta y el contenido de un artefacto los escriben plantillas, por lo que ninguno de los dos produce aquí una clave — si un payload así se produjo a partir de un valor declarado sensible lo lleva en cambio sensitive_values, y el sensitive_content propio de una entrada de artefacto. Por tanto, la ausencia indica que no se pudo recuperar la identidad de ninguna clave, nunca que nada en este payload lleve material sensible — un guest que lee una clave ausente como permiso para mostrar o emitir un valor en claro la ha leído al revés. Las claves llegan ordenadas, y eso es lo que hace que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
sensitive_values | booleano | no | Verdadero cuando los valores que lleva este payload los produjo una plantilla que lee un valor que un autor declaró sensible, o un valor rastreado hasta uno de ellos: el valuesMapping de una Recipe o de una FeatureRecipe, una única plantilla cuyas claves y valores de salida son invención suya, de modo que ninguna clave de esa salida puede rastrearse hasta el dato del que procede y en su lugar se marca el mapa entero. Se lee de las referencias propias de la plantilla frente a las declaraciones — una referencia que alcanza un valor declarado, la plantilla que transmite la totalidad de sus datos o una plantilla que no se puede analizar cuentan todas — y nunca del contenido de un valor ni del nombre de una clave. Un guest que compone texto que lee una persona, un rechazo o una advertencia, deja fuera de ese texto todo valor de los valores del nodo cuando esto es verdadero, y deja fuera el valor bajo cualquier clave que nombre sensitive_rendered_keys, lo sea o no: los dos se combinan, uno nombrando las claves cuya identidad se recupera exactamente y este cubriendo el mapa donde no puede recuperarse ninguna. Ausente cuando ninguna plantilla de ese tipo leyó un valor así, lo que incluye los valores que son ellos mismos las hojas declaradas, marcados en su lugar por clave en sensitive_rendered_keys, y ausente en un payload que no lleva valores. La ausencia nunca indica que ningún valor sea sensible. |
values_mapped | booleano | no | Verdadero cuando los valores que lleva este payload son la salida del valuesMapping de la Recipe o de la FeatureRecipe enlazada, en lugar de los valores del nodo entregados tal como el autor los escribió. Un guest cuyo propio contrato enlaza con las entradas que declara su origen solo los valores que produjo un mapeo lee este campo, y deja sin leer los valores escritos para otra cosa, como los artefactos de la Recipe; un guest que enlaza los valores del nodo con su origen comoquiera que se hayan producido no lo lee. Registra cómo se produjeron los valores y nunca se deriva del nombre de una clave ni del contenido de un valor. Ausente donde no se ejecutó ningún valuesMapping, y en un payload que no lleva valores. |
uses | mapa de string[] | no | Declarado y retenido deliberadamente: el host nunca lo rellena, por lo que el mapa está ausente de todo payload de renderizado. Una arista saliente se consume antes del despacho — los valores publicados de la arista se rehidratan en el pipe inject propio del nodo, que la Recipe ya evaluó en los valores y el workload que recibe el guest — y un guest que ensambla un límite recibe en su lugar la lista de aristas en su propia entrada. Si se rellenara, indexaría las aristas uses salientes del nodo por alias de socket, cada una con los id ordenados de los nodos destino de ese socket en el orden del autor. |
boundary_path | string | no | La ruta del límite del nodo, estampada como la anotación aggrega.ai/boundary-path en cada manifiesto emitido que lleva un bloque metadata. |
sync_wave | integer | no | La oleada de despliegue heredada del límite que contiene este nodo (0 por defecto; se permiten valores negativos), que lleva el valor que el nodo IR guarda como sync_wave. Lo que un guest hace con ella es decisión propia del guest, y registrar el valor y ordenar según él son independientes y no alternativas — un guest puede hacer una cosa u otra, ambas o ninguna. Entre los proveedores de la biblioteca estándar: helm y helm-chart la emiten como una anotación argocd.argoproj.io/sync-wave en cada recurso renderizado y, además, como helm.sh/hook-weight en un recurso que el chart ya marca como hook de Helm; compose la registra como etiqueta de servicio y ordena los servicios del archivo en el que renderiza, mediante depends_on entre ellos; cloudformation ordena el aprovisionamiento del stack ensamblado, declarando que cada recurso de una oleada depende de los recursos de la oleada anterior; terraform ordena los bloques de módulo de la configuración raíz en la que se ensambla un límite, declarando que cada módulo de una oleada depende de los módulos de la oleada anterior, y además la registra con la procedencia del build del nodo. |
recipe_name | string | no | El nombre de la Recipe enlazada, emparejado con recipe_version para formar la anotación aggrega.ai/recipe-uri; cuando cualquiera de las dos mitades está vacía, la anotación no se estampa. |
recipe_version | string | no | La versión de la Recipe enlazada, emparejada con recipe_name para formar la anotación aggrega.ai/recipe-uri; cuando cualquiera de las dos mitades está vacía, la anotación no se estampa. |
label_component_id | string | no | La identidad de componente segura para Kubernetes — aquello a lo que PERTENECE un recurso que emite este nodo, que es lo que registra la procedencia y lo que consulta un selector. Cuando no está vacía, sustituye el id del nodo como valor de las etiquetas app.kubernetes.io/name y aggrega.ai/component-id; vacía significa que el id del nodo ya es válido como etiqueta y se usa directamente. Se lleva para cada recurso que emite una vinculación de Feature, sea cual sea la forma en que la vinculación los entrega, de modo que los recursos de una vinculación se distinguen de los de su componente host solo por la etiqueta. Aquello de lo que un guest deriva sus propios nombres se lleva por separado, derived_name_basis, y los dos responden a preguntas distintas. |
derived_name_basis | string | no | La identidad de la que un guest deriva sus propios nombres — el nombre de release que leen las plantillas de un instalador de charts, a partir del cual un guest así también puede nombrar los recursos que sintetiza para un componente, y el prefijo de los archivos que emite un renderizado de origen. Vacía significa que el id del nodo se usa directamente, que es el valor para un componente ordinario y para una vinculación de Feature por componente: una vinculación que entrega un chart o un fragmento escrito por su autor lo renderiza contra el nombre del componente HOST, porque las plantillas propias del autor nombran los recursos según ese nombre y uno distinto renombraría recursos ya desplegados. Un nodo cuyo id lleva sintaxis de marcador que el alfabeto de nombres de un destino rechaza lleva este valor de forma explícita en su lugar, de modo que el nombre que deriva un guest sigue siendo uno que el destino acepta. Está deliberadamente separada de label_component_id: un guest que CONSTRUYE recursos para una vinculación de Feature en lugar de renderizar el origen de su autor los nombra según la identidad, de modo que los recursos propios de la vinculación no pueden colisionar con los de su host, mientras que el nombre contra el que se renderiza el origen de un autor no cambia. Las dos llevan el mismo valor dondequiera que la identidad de un nodo sea también aquello contra lo que se renderiza su origen. |
output_labels | mapa de string | no | Las etiquetas de salida declaradas por el autor de la receta que el guest estampa en cada manifiesto emitido junto a la procedencia de la identidad del build, indexadas por nombre de etiqueta. Dos bloques escritos por el autor se fusionan en este único mapa: los pares clave-valor literales que una receta escribe en outputLabels, y una entrada por cada clave que una receta nombra en outputComponentLabels, cuyo valor se lee de esa clave en las etiquetas propias del componente renderizado — de modo que un valor promovido sigue al componente del que procede en lugar de repetirse en la receta. Ambos bloques son disjuntos del espacio de claves de la procedencia por la validación en tiempo de carga (ninguna clave aggrega.ai/ ni app.kubernetes.io/), por lo que el estampado nunca colisiona con una etiqueta de procedencia. Una clave promovida que el componente no declara no estampa nada y genera un aviso en lugar de una etiqueta vacía. Un guest cuya salida no es YAML de Kubernetes las traslada a su propia superficie de etiquetas (etiquetas de servicio de Compose) o las ignora. |
provenance | NodeProvenance | sí | La procedencia de la identidad del build que el guest estampa en cada manifiesto emitido como etiquetas aggrega.ai. |
No se permiten propiedades adicionales.
NodeProvenance
La procedencia de la identidad del build para un nodo — la identidad del compilador, del agregado y del entorno que el guest estampa en cada manifiesto emitido como etiquetas aggrega.ai. Cada campo se omite cuando está vacío, de modo que una identidad parcial solo estampa las etiquetas que lleva.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
compiler_version | string | no | La versión del compilador, estampada como la etiqueta aggrega.ai/compiler-version cuando no está vacía. |
aggregate_name | string | no | El nombre del agregado, estampado como la etiqueta aggrega.ai/aggregate-name cuando no está vacío. |
environment | string | no | El nombre del entorno, estampado como la etiqueta aggrega.ai/environment cuando no está vacío. |
provider_name | string | no | El tipo de proveedor sin más, estampado como la etiqueta aggrega.ai/provider cuando no está vacío. |
provider_version | string | no | La versión resuelta del plugin de renderizado del proveedor, estampada como la etiqueta aggrega.ai/provider-version cuando no está vacía. |
No se permiten propiedades adicionales.
RenderNodeOutput
El payload que un guest del Provider devuelve desde su exportación render_node: los bytes serializados de cada archivo de salida que emitió el guest, los nombres que derivó en cada uno de sus propios espacios de claves, los hechos que informa sobre lo que emitió, con cuántas unidades renderizadas coincidió cada entrada omits que se le entregó, y los diagnósticos que el guest generó durante el renderizado. El guest devuelve los bytes serializados de cada archivo; el host los escribe tal cual y no ejecuta ningún serializador. El determinismo es responsabilidad del guest: una entrada idéntica debe producir bytes idénticos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
files | RenderedFile[] | sí | Los archivos de salida que emitió el guest, en orden de emisión. Cada uno nombra su ruta en disco y lleva los bytes serializados que el host escribe tal cual. |
derived_keys | mapa de string[] | no | Los nombres que el guest derivó al renderizar este nodo, indexados por el espacio de claves en el que los derivó, cada espacio con sus nombres en orden de derivación. Un guest que deriva el nombre por el que su salida direcciona un recurso ha puesto ese nombre dentro de los bytes del archivo que el host escribe tal cual, donde el host no puede verlo; declararlo aquí es la forma en que el guest pide al host que confirme que no hay dos derivaciones que hayan ido a parar al mismo nombre. El host compara la igualdad de los nombres declarados dentro de un espacio declarado y no hace nada más — no analiza un nombre, no aprende qué significa un espacio o un nombre y nunca deriva uno por sí mismo. Dos contribuyentes a la misma salida ensamblada que declaran el mismo nombre en el mismo espacio detienen el build, y la detención nombra el espacio, el nombre y ambos contribuyentes. Tanto los nombres de los espacios como los nombres que contienen son el vocabulario propio del guest: un guest que quiere unicidad en un ámbito más estrecho o más amplio que una salida ensamblada expresa ese ámbito en el nombre del espacio que declara. Conserva el orden de declaración, de modo que el payload es idéntico byte a byte entre ejecuciones con entrada idéntica. Ausente cuando el guest no deriva nombres que quiera que se comprueben, lo que deja la comprobación inerte para ese guest. |
render_facts | RenderFact[] | no | Hechos que el guest informa sobre lo que emitió para este nodo, en el orden en que el guest los enumera. Cada hecho empareja un nombre con un valor, y ambos son el vocabulario propio del guest: qué hechos informa un proveedor, qué significa cada nombre y qué contienen sus entradas forman parte del contrato documentado de ese proveedor, no del de este socket. El valor de todo hecho es una lista, incluso cuando contiene una sola entrada: el host rechaza un hecho cuyo valor es cualquier otra cosa, nombrando el proveedor y el hecho, y detiene el build. Es lo único que el host aprende sobre un valor. Indexa los hechos por nombre y entrega cada lista a las plantillas que la leen, uniendo las listas de un mismo nombre informadas por más de un renderizado del mismo nodo en el orden en que se ejecutaron esos renderizados, y nunca aprende qué significa un nombre o una entrada ni deriva un hecho por sí mismo — de modo que un proveedor puede informar algo que solo su propio conocimiento del formato puede ver, como una propiedad de los documentos que escribió, sin que el host aprenda ese formato. Informar hechos nunca cambia lo que se escribe: los archivos que escribe el host son los archivos que devolvió el guest, vayan o no acompañados de hechos. El guest enumera sus hechos en un orden fijo, de modo que el payload es idéntico byte a byte entre ejecuciones con entrada idéntica. Ausente cuando el guest no informa nada, lo cual es una respuesta completa y no una que falte. |
omitted | integer[] | no | Con cuántas unidades renderizadas coincidió cada entrada de omits que llegó con la entrada: un recuento por cada entrada que se entregó al guest, en el mismo orden, cada uno el número de unidades con las que coincidió esa entrada, coincidiera también con ellas otra entrada o no. Un recuento de cero es una respuesta completa — la entrada no coincidió con nada de lo que renderizó el guest. Los recuentos son todo lo que el socket devuelve sobre lo que se dejó fuera: las unidades mismas simplemente están ausentes de lo que devolvió el guest. Ausente cuando no se entregó ninguna entrada al guest. |
diagnostics | Diagnostic[] | no | Diagnósticos que el guest generó durante el renderizado. Cada elemento tiene la forma de diagnóstico compartida de los plugins Wasm. |
error | string | no | Un mensaje de error que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. Es distinto de cualquier diagnóstico que lleve la salida: los diagnósticos informan de problemas encontrados durante una ejecución que aun así produjo un resultado, mientras que error informa de que la propia operación no se completó. El host presenta un error presente como una invocación de plugin fallida. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
ValidateNodeOutput
El payload que un guest del Provider devuelve desde su exportación opcional validate_node_input: los diagnósticos que planteó una comprobación estructural de la entrada resuelta del nodo. La exportación consume la misma proyección RenderNodeInput que recibe render_node y no emite ningún archivo — solo informa de diagnósticos. Un diagnóstico de severidad halt detiene el build de forma explícita, nombrando el nodo y el proveedor; un diagnóstico de severidad warn o info se presenta en el resultado del build sin cambiar la salida renderizada. Una lista de diagnósticos vacía significa que la entrada superó la comprobación estructural.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
diagnostics | Diagnostic[] | no | Diagnósticos que planteó el guest al validar la entrada del nodo. Cada elemento es la forma de diagnóstico compartida de los plugins Wasm. Vacío cuando la entrada superó la comprobación estructural. |
error | string | no | Un mensaje de error que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. Es distinto de cualquier diagnóstico que lleve la salida: los diagnósticos informan de problemas encontrados durante una ejecución que aun así produjo un resultado, mientras que error informa de que la propia operación no se completó. El host presenta un error presente como una invocación de plugin fallida. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
RenderedFile
Un archivo de salida que emitió un guest del Provider: su ruta en disco relativa a la raíz de salida del nodo y sus bytes serializados exactamente como los produjo el guest. El host escribe estos bytes tal cual y no ejecuta ningún serializador, por lo que la salida en disco es idéntica byte a byte a lo que emitió el guest.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | La ruta del archivo de salida relativa a la raíz de salida del nodo (por ejemplo, Chart.yaml o templates/deployment.yaml). |
content | string | sí | Los bytes serializados del archivo exactamente como los produjo el guest; el host escribe estos bytes tal cual y no ejecuta ningún serializador, por lo que la salida es idéntica byte a byte a lo que emitió el guest. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
format | string | no | El formato en el que el guest declara que se renderizó el archivo emitido, para que el host pueda enviar el archivo a un analizador correspondiente. Ausente cuando el guest no declara ningún formato, en cuyo caso el host deduce el formato a partir de la extensión del archivo. |
No se permiten propiedades adicionales.
RenderFact
Un hecho que un guest del Provider informa sobre lo que emitió para un nodo: un nombre y una lista de entradas, ambos definidos y documentados por el proveedor. El host lleva el hecho tal como lo escribió el guest, rechaza uno cuyo valor no sea una lista y no aprende nada más sobre ninguna de las dos mitades.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | El nombre del hecho, tomado del vocabulario documentado propio del proveedor. |
value | array | sí | El valor del hecho: un array JSON — siempre una lista, incluso con una sola entrada o ninguna — cuyas entradas son valores JSON cualesquiera con la forma que el proveedor documenta para ese nombre. Una lista es lo que permite que un nombre sea informado por más de un renderizado de un nodo: el host une las listas en una sola. Se lleva como el documento JSON que escribió el guest, byte a byte, de modo que el orden de las entradas de la lista y de las claves de cada objeto es el propio del guest. |
No se permiten propiedades adicionales.
OmitEntry
Una entrada que nombra unidades renderizadas que un guest del Provider deja fuera de la salida de un nodo, con sus campos ya resueltos como cadenas simples y marcados donde alguno de ellos se produjo a partir de un valor declarado sensible. El socket no les atribuye ningún significado: cada proveedor documenta qué seleccionan kind, name, namespace y subchart en su propio formato, y los compara él mismo.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
kind | string | sí | El tipo de unidad renderizada que nombra la entrada, en el vocabulario propio del proveedor. |
name | string | sí | El nombre de la unidad renderizada que nombra la entrada, en el vocabulario propio del proveedor. |
namespace | string | no | El namespace en el que se encuentra la unidad nombrada, para un proveedor cuyo formato coloca las unidades en uno. Ausente cuando el autor no escribió ninguno; con qué coincide una entrada sin namespace es el contrato propio del proveedor. |
subchart | string | no | El origen anidado del que procede la unidad nombrada, para un proveedor cuyo origen se ensambla a partir de orígenes anidados, como un chart a partir de sus subcharts. Ausente cuando el autor no escribió ninguno; con qué coincide una entrada sin subchart, y qué hace un proveedor cuyo origen no tiene orígenes anidados con una entrada que nombra uno, es el contrato propio del proveedor. |
sensitive | booleano | no | Verdadero cuando la plantilla que produjo cualquiera de los campos kind, name, namespace o subchart de la entrada lee un valor que un autor declaró sensible, o un valor rastreado hasta uno de ellos. Se lee de la plantilla de cada campo frente a las declaraciones — una referencia que alcanza un valor declarado, la plantilla que transmite la totalidad de sus datos o una plantilla que no se puede analizar cuentan todas — y nunca de las cadenas resueltas. La marca cubre toda la entrada en lugar de nombrar el campo, de modo que un guest trata una entrada marcada como trata cualquier otro valor marcado de su entrada: sigue comparando y contando la entrada por sus campos, que es para lo que sirve la entrada, y mantiene cada uno de sus campos fuera de cualquier texto que lea una persona — un rechazo, una advertencia o una línea de registro. Ausente cuando la plantilla de ningún campo lee un valor así; la ausencia nunca afirma que ningún campo sea sensible. |
No se permiten propiedades adicionales.
SourceFile
Un archivo de una proyección del origen preempaquetada: su ruta relativa a la raíz del origen y sus bytes en bruto, exactamente como el host los leyó del origen local en tiempo de compilación.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | La ruta del archivo relativa a la raíz del origen (por ejemplo, Chart.yaml o templates/deployment.yaml). |
content | string | sí | Los bytes en bruto del archivo exactamente como el host los leyó del origen local. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
No se permiten propiedades adicionales.
SourceProjection
El contenido del origen empaquetado (p. ej., los archivos de un chart de Helm, cada uno nombrado por su ruta relativa a la raíz del origen, en orden de recorrido) que el host lee y devuelve al guest en respuesta a una solicitud pack-source, de modo que el guest reconstruye en memoria el origen seleccionado y no toca ningún sistema de archivos. Es el payload de éxito de la función host pack-source.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
files | SourceFile[] | sí | Los archivos del origen, cada uno nombrado por su ruta relativa a la raíz del origen, en el orden de recorrido determinista del host. |
No se permiten propiedades adicionales.
SourceEntry
Una entrada de un listado del origen: su ruta relativa a la raíz del origen y si es un directorio. El host solo lista nombres y no lee ningún contenido, por lo que una entrada no lleva bytes.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | La ruta de la entrada relativa a la raíz del origen, separada por barras (por ejemplo, Chart.yaml o templates/deployment.yaml). |
is_dir | booleano | sí | Si la entrada es un directorio. Un guest que resuelve la raíz de un chart o un único archivo de origen dentro del listado lee este campo para distinguir los directorios de los archivos sin tocar el sistema de archivos. |
No se permiten propiedades adicionales.
SourceListing
La enumeración genérica de un origen adquirido que el host entrega al guest de un proveedor con origen: la raíz del origen, si esa raíz es un directorio, y las entradas ordenadas relativas a la raíz que hay debajo de ella. El host recorre el origen adquirido sin ningún conocimiento del dominio y no lee ningún contenido de archivo — solo lista nombres. El guest aplica su propia lógica de resolución sobre el listado (localizar la raíz de un chart, seleccionar un único documento compose, hacer vendoring de un árbol de módulos) y pide al host que empaquete una selección elegida mediante la función host pack-source. Las entradas se ordenan por ruta para que el listado sea idéntico byte a byte entre ejecuciones con entrada idéntica.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
root | string | sí | La ubicación del origen adquirido que enumeró el host. El guest la lleva a sus propios diagnósticos cuando no puede resolver el origen, de modo que una detención por resolución nombra el origen que proporcionó el autor. |
root_is_dir | booleano | no | Si la raíz del origen adquirido es un directorio. Falso para un origen de un solo archivo (un documento compose aislado, un único archivo de módulo, un archivo comprimido), en cuyo caso entries está vacío y el guest empaqueta la propia raíz. |
entries | SourceEntry[] | sí | Las entradas relativas a la raíz bajo una raíz del origen que es un directorio, ordenadas por ruta. Vacío para una raíz del origen de un solo archivo. |
No se permiten propiedades adicionales.
SourcePackRequest
La selección que un guest pide al host que empaquete a partir del origen adquirido mediante la función host pack-source. op nombra la forma de la selección y path la nombra de forma relativa a la raíz del origen; el host resuelve la ruta bajo la raíz del origen, rechazando cualquier escape por encima de ella, y devuelve los bytes empaquetados como un SourceProjection.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
op | string (enum) | sí | La forma de la selección: file empaqueta el único archivo situado en path; dir empaqueta los archivos inmediatos del directorio situado en path; tree empaqueta de forma recursiva todo el subárbol con raíz en path, en el orden de recorrido determinista del host. Valores permitidos: "file", "dir", "tree" |
path | string | sí | La ubicación de la selección relativa a la raíz del origen, separada por barras. La cadena vacía (o ”.”) nombra la propia raíz del origen, de modo que un origen de un solo archivo se empaqueta con una ruta vacía. |
No se permiten propiedades adicionales.
SourcePackResponse
La respuesta de la función host pack-source: en caso de éxito, el origen empaquetado; en caso de fallo, un mensaje de error. Exactamente uno de los dos campos está rellenado. El fallo se entrega en banda en lugar de mediante un trap, de modo que un guest lleva un rechazo del sandbox o un fallo de lectura a sus propios diagnósticos como un fallo de renderizado determinista.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
source_projection | SourceProjection | no | El origen empaquetado en caso de éxito; ausente en caso de fallo. |
error | string | no | El mensaje de error en caso de fallo, que nombra la selección y el motivo; ausente en caso de éxito. |
hostfunc_error_code | string (enum) | no | La identidad del fallo identificable por máquina en caso de fallo, tomada del catálogo cerrado de códigos de error de las funciones host, establecida junto al mensaje de error legible por personas; ausente en caso de éxito. Ese catálogo es un vocabulario fijo que nombra las formas en que puede fallar una función host, y es un vocabulario distinto de las condiciones de detención que registra el compilador, cuyos identificadores informa un guest en una salida de socket como condition_code y condition_short_code — el nombre de la clave dice a cuál de los dos pertenece un valor, de modo que los dos nunca se leen como un único conjunto. Un guest se ramifica según este código sin analizar el mensaje, tolerando un código ausente (host más antiguo) o uno no reconocido (host más reciente) mediante el recurso al mensaje. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
No se permiten propiedades adicionales.
SourceFileRequest
La lectura del contenido de un único archivo que un guest pide al host que realice mediante la función host read-source-file, para un guest cuya lógica de resolución debe inspeccionar el contenido de un archivo antes de elegir qué empaquetar. El host resuelve la ruta bajo la raíz del origen, rechazando cualquier escape por encima de ella, y devuelve los bytes del archivo.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | La ubicación del archivo relativa a la raíz del origen, separada por barras. |
No se permiten propiedades adicionales.
SourceFileResponse
La respuesta de la función host read-source-file: en caso de éxito, los bytes del archivo; en caso de fallo, un mensaje de error. Exactamente uno de los dos campos está rellenado. El fallo se entrega en banda en lugar de mediante un trap, de modo que un guest lleva un rechazo del sandbox o un fallo de lectura a sus propios diagnósticos como un fallo de renderizado determinista.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
content | string | no | Los bytes en bruto del archivo en caso de éxito; ausentes en caso de fallo. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
error | string | no | El mensaje de error en caso de fallo, que nombra el archivo y el motivo; ausente en caso de éxito. |
hostfunc_error_code | string (enum) | no | La identidad del fallo identificable por máquina en caso de fallo, tomada del catálogo cerrado de códigos de error de las funciones host, establecida junto al mensaje de error legible por personas; ausente en caso de éxito. Ese catálogo es un vocabulario fijo que nombra las formas en que puede fallar una función host, y es un vocabulario distinto de las condiciones de detención que registra el compilador, cuyos identificadores informa un guest en una salida de socket como condition_code y condition_short_code — el nombre de la clave dice a cuál de los dos pertenece un valor, de modo que los dos nunca se leen como un único conjunto. Un guest se ramifica según este código sin analizar el mensaje, tolerando un código ausente (host más antiguo) o uno no reconocido (host más reciente) mediante el recurso al mensaje. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
No se permiten propiedades adicionales.
FetchExternalInputResponse
La respuesta de la función host fetch-external-input: en caso de éxito, el contenido obtenido; en caso de fallo, un mensaje de error y su código. Una respuesta que no lleva ninguno de los dos campos de fallo es un éxito, de modo que un payload de longitud cero es la respuesta con todos los campos ausentes. El fallo se entrega en banda en lugar de mediante un trap, de modo que un guest lleva una URL que no se puede resolver o un fallo de obtención a sus propios diagnósticos como un fallo de renderizado determinista. La solicitud es una simple cadena de URL en lugar de un payload estructurado, por lo que solo la respuesta tiene una forma declarada.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
content | string | no | Los bytes en bruto del payload obtenido en caso de éxito; ausentes en caso de fallo, y ausentes cuando el payload está vacío. En el formato de transmisión, los bytes viajan como una cadena de bytes, nunca como texto base64. El kit de Go los guarda como un slice de bytes; los kits de Rust y TypeScript los guardan como una cadena base64, que decodifica el wrapper de fetch de cada kit, de modo que cada wrapper devuelve los bytes en bruto del payload. |
error | string | no | El mensaje de error en caso de fallo, que nombra la URL y la solución; ausente en caso de éxito. |
hostfunc_error_code | string (enum) | no | La identidad del fallo identificable por máquina en caso de fallo, tomada del catálogo cerrado de códigos de error de las funciones host, establecida junto al mensaje de error legible por personas; ausente en caso de éxito. Ese catálogo es un vocabulario fijo que nombra las formas en que puede fallar una función host, y es un vocabulario distinto de las condiciones de detención que registra el compilador, cuyos identificadores informa un guest en una salida de socket como condition_code y condition_short_code — el nombre de la clave dice a cuál de los dos pertenece un valor, de modo que los dos nunca se leen como un único conjunto. Un guest se ramifica según este código sin analizar el mensaje, tolerando un código ausente (host más antiguo) o uno no reconocido (host más reciente) mediante el recurso al mensaje. Valores permitidos: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed" |
No se permiten propiedades adicionales.
WorkloadProjection
El contenido del workload preevaluado que el host entrega a un guest del Provider para que el guest sintetice en memoria a partir de él manifiestos nativos del proveedor, presente cuando la Recipe enlazada declara un workload en lugar de un origen de chart. El determinismo es responsabilidad del guest: una entrada idéntica debe producir bytes idénticos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
workload | object | sí | El Workload evaluado por el host, posterior a la validación, que sintetiza el guest; opaco en esta capa del esquema para que el esquema del socket no vuelva a definir el contrato de la entidad Workload. |
sensitive_workload | booleano | no | Verdadero cuando la plantilla que produjo workload lee un valor que un autor declaró sensible, o un valor rastreado hasta uno de ellos. Se lee de las referencias propias de la plantilla frente a las declaraciones — una referencia que alcanza un valor declarado, la plantilla que transmite la totalidad de sus datos o una plantilla que no se puede analizar cuentan todas — y nunca del contenido de ningún campo. Los campos de un workload renderizado no llevan ningún vínculo con los datos que leyó su plantilla, por lo que este campo marca todo el documento: un guest que compone un texto que lee una persona, un rechazo o una advertencia, mantiene fuera de ese texto todo valor que lleve el workload cuando este campo es verdadero, mientras que la forma del documento — sus claves y dónde se encuentra un valor — sigue siendo legible. Las entradas de vinculación que nombra sensitive_rendered_keys de la proyección del nodo están marcadas allí, esté o no establecido este campo. Ausente cuando la plantilla no lee ningún valor así; la ausencia nunca afirma que ningún campo sea sensible. |
attachment_provides | object | no | Cada vinculación del nodo, proyectada sobre sus provides resueltos e indexada por el nombre de instancia de la vinculación que lleva una referencia de vinculación del workload; ausente cuando el nodo no lleva ninguna vinculación. El host copia las cadenas sin interpretarlas, de modo que el guest lee las entradas de los provides de una vinculación que necesite para resolver una referencia al recurso que produjo esa vinculación. Si una vinculación maneja material declarado sensible no se repite aquí: viaja en la entrada de feature correspondiente de la proyección del nodo, que un guest lee por el mismo nombre de instancia. |
No se permiten propiedades adicionales.
ArtifactsProjection
El conjunto de artefactos preevaluado que el host entrega a un guest del Provider para que lo coloque en la salida del nodo. El host ya resolvió el origen de cada entrada (contenido inline o un archivo importado que leyó), lo evaluó como plantilla Go contra el contexto de renderizado usando el par de delimitadores de plantilla de artefacto declarado por el guest, y calculó los conjuntos de claves de etiquetas y anotaciones de la procedencia del build. El guest es responsable de la decisión de formato, la ubicación de la procedencia, la ruta en disco y los bytes finales. Las entradas conservan el orden del autor para que la salida colocada sea idéntica byte a byte entre ejecuciones con entrada idéntica.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
entries | ArtifactProjectionEntry[] | sí | Las entradas de artefacto que coloca el guest, en el orden del autor. |
No se permiten propiedades adicionales.
ArtifactProjectionEntry
Una entrada de artefacto preevaluada que el host entrega a un guest del Provider para que la coloque: su nombre de salida resuelto por el host, su tipo de origen, los bytes de contenido ya evaluados como plantilla, si la plantilla de la que proceden esos bytes lee un valor declarado sensible, y los conjuntos de claves de etiquetas y anotaciones de la procedencia del build que el host calculó para el nodo. El guest decide cómo colocar la procedencia (insertándola en los metadatos de un manifiesto, anteponiéndola como comentario o emitiendo un archivo complementario) y dónde termina el archivo.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | El nombre de salida resuelto por el host para la entrada: la clave de mapa declarada por el autor, con un archivo proporcionado por un bundle de biblioteca anidado bajo esa clave. El guest coloca la entrada con este nombre o bajo una subruta específica del proveedor derivada de él. |
origin | string (enum) | sí | Si la entrada se escribió como contenido inline o como archivo importado. Un guest que rechaza una de las dos formas (un proveedor de umbrella chart rechaza el contenido inline) lee este campo para detenerse de forma explícita. Valores permitidos: "inline", "import" |
content | string | sí | Los bytes de contenido ya evaluados como plantilla que el host produjo a partir del contenido inline o del archivo importado de la entrada, evaluados contra el contexto de renderizado usando el par de delimitadores de plantilla de artefacto declarado por el guest. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
sensitive_content | booleano | no | Verdadero cuando la plantilla a partir de la cual se evaluó el contenido de esta entrada lee un valor que un autor declaró sensible, o un valor rastreado hasta uno de ellos. Se lee de las referencias propias de la plantilla frente a las declaraciones, con el par de delimitadores con el que se evaluó el contenido — una referencia que alcanza un valor declarado, la plantilla que transmite la totalidad de sus datos o una plantilla que no se puede analizar cuentan todas — y nunca del propio contenido. El contenido es la salida de esa plantilla, por lo que nada en él puede remontarse al dato del que procede: un guest que compone un texto que lee una persona, un rechazo o una advertencia, mantiene toda parte del contenido fuera de ese texto cuando este campo es verdadero, incluido el propio mensaje de un analizador sobre el contenido. Se establece por entrada, de modo que, si la plantilla de una entrada lee un valor así, eso no dice nada sobre la de otra. Ausente cuando la plantilla no lee ningún valor así; la ausencia nunca afirma que el contenido no sea sensible. |
labels | object | no | El conjunto de claves de la procedencia del build seguro para las etiquetas de Kubernetes que el host calculó para el nodo, indexado por nombre de etiqueta. Un guest que estampa la procedencia en metadata.labels de un manifiesto inserta estas claves; un guest cuya salida no es YAML de Kubernetes las ignora. |
annotations | object | no | El conjunto de claves de la procedencia del build, calculado por el host para el nodo, que una etiqueta de Kubernetes no puede representar, indexado por nombre de anotación. Un guest que estampa la procedencia en metadata.annotations de un manifiesto inserta estas claves; un guest cuya salida no es YAML de Kubernetes las ignora. |
No se permiten propiedades adicionales.
AssembleBoundaryInput
El payload que un guest del Provider recibe en su exportación assemble_boundary — la exportación que fusiona las salidas de renderizado por nodo de un grupo de despacho en un único artefacto ensamblado (un umbrella chart, un archivo compose fusionado). Lleva las salidas de renderizado por nodo con sus anotaciones fusionadas y sus oleadas de despliegue, la ruta de salida del grupo de despacho en la que termina el artefacto ensamblado, las aristas uses del grafo para la inferencia de dependencias por servicio y el contexto del momento del renderizado. No todos los proveedores declaran la exportación: los proveedores que solo emiten una salida plana por nodo la omiten.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
rendered_nodes | RenderedNode[] | sí | Las salidas de renderizado por nodo que alimentaron este grupo de despacho, en orden de nodo. |
context | object | sí | El contexto del momento del renderizado, transportado como los bytes de su documento JSON. En esta exportación el host establece solo yaml_indent, el ancho de la sangría común a todo el renderizado con el que se serializan los archivos ensamblados; los demás miembros del contexto no llevan nada aquí, porque un ensamblado fusiona contribuyentes cuyas anotaciones y límites difieren, y las anotaciones de cada contribuyente llegan en su lugar en su entrada de rendered_nodes. |
boundary_path | string | sí | La ruta de salida evaluada del grupo de despacho en la que termina el artefacto ensamblado; un ensamblador de límite la usa como identidad de respaldo a nivel de límite (p. ej., el nombre de la red compose para un nodo que no lleva ninguna anotación namespace). |
edges | RenderEdge[] | no | Las aristas uses dirigidas del grafo, para que un ensamblador de límite pueda inferir el orden/las dependencias por servicio entre los contribuyentes del grupo de despacho (p. ej., depends_on de compose). |
sub_charts | SubChart[] | no | El payload por sub-chart que un ensamblador de umbrella chart consume para emitir una dependencia y un ámbito de valores por contribuyente. Cada entrada lleva la identidad del sub-chart, los valores por instancia y, para un sub-chart incorporado mediante vendoring desde un origen de chart, los bytes intactos del archivo Chart.yaml de ese chart. Presente para el ensamblado de umbrella chart; un ensamblador que fusiona de forma plana lo omite. |
chart_name | string | no | El nombre de chart que un ensamblador de umbrella chart usa para el chart ensamblado cuando se proporciona un nombre para el grupo de despacho; vacío cuando el ensamblador deriva el nombre de la ruta de salida del grupo de despacho. |
aggregate_name | string | no | El nombre del agregado de nivel superior que un ensamblador de umbrella chart incorpora al nombre derivado del chart ensamblado; vacío cuando ninguna identidad de agregado contribuye al nombre. |
No se permiten propiedades adicionales.
RenderedNode
La salida de renderizado de un nodo tal como aparece en una entrada de assemble_boundary: el id del nodo, su tipo, sus anotaciones fusionadas, su sync wave, los valores que el compilador resolvió para él donde le corresponde al compilador proporcionarlos y si un mapeo de valores los produjo, y los archivos que la exportación render_node produjo para él — llevados en la forma de la salida de renderizado, con todo miembro de esa forma distinto de sus archivos dejado ausente.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
id | string | sí | El id absoluto del nodo dentro del grafo de topología. Un contribuyente que no es uno de los nodos del grafo — una Feature vinculada a un límite en lugar de a un componente — lleva aquí en su lugar la identidad de despacho propia del compilador para él, que es la misma identidad que llevó la llamada render_node para ese contribuyente; distingue un contribuyente de otro y no es un nombre que acepte ningún destino. Aquello de lo que un contribuyente así deriva nombres dentro del artefacto ensamblado es un valor que se lleva por separado, derived_name_basis. |
type | string | sí | La etiqueta de tipo de componente del nodo, llevada en esta forma — a diferencia de la proyección de renderizado por nodo, que la retiene. Metadato opaco y no un conmutador de comportamiento: está aquí para que un ensamblador pueda agrupar y etiquetar los nodos que fusiona, no para que un guest pueda bifurcar en función de ella. |
derived_name_basis | string | no | La identidad de la que este contribuyente deriva sus propios nombres dentro del artefacto ensamblado — un id lógico que un ensamblador acuña para una de las entradas publicadas del contribuyente, un ámbito por contribuyente en un documento fusionado, el nombre de una unidad hija colocada en una posición propia. Vacía significa que el id se usa directamente, que es el valor para un componente ordinario. Un contribuyente cuyo id es una identidad de despacho que el alfabeto de nombres de un destino rechaza lleva este valor de forma explícita, de modo que el artefacto ensamblado direcciona su contenido con un nombre que el destino acepta, y dos contribuyentes que un autor sabe distinguir no pueden llegar bajo uno solo. Donde el contenido del contribuyente se incorpora a un documento que el ensamblador fusiona, este es el mismo valor que recibió la llamada render_node para ese contribuyente, y llevarlo en ambos es lo que mantiene iguales las dos respuestas: un nombre que el contribuyente declaró durante el renderizado y el nombre con el que el documento fusionado direcciona ese contenido se derivan de una sola identidad y no de dos que resultan coincidir. Donde, en cambio, el contribuyente se coloca en una posición propia, esta es la identidad compuesta para ese contribuyente — para una Feature vinculada a un componente, la suya propia y no la del componente host contra el que se ejecutó su renderizado — de modo que una unidad hija colocada junto a su host se direcciona por separado de él. |
output_directory | string | no | El directorio en el que se encuentran los archivos renderizados de este contribuyente, relativo a la posición propia del artefacto ensamblado, sin separador final. Un guest que tiene que nombrar los archivos de un contribuyente desde dentro del artefacto ensamblado — la ruta de origen de un bloque de módulo, una directiva include — lee la posición de aquí en lugar de componer una a partir de la identidad del contribuyente, de modo que la ruta a la que apunta el artefacto ensamblado es la ruta en la que se escribieron los archivos. Los dos no siempre distan un solo directorio: un contribuyente que el host colocó dentro de la posición de otro contribuyente queda más profundo que los contribuyentes colocados directamente bajo el ensamblado. Presente solo donde el proveedor que ensambla coloca cada contribuyente bajo una posición propia; un proveedor que incorpora sus contribuyentes en un único documento no coloca ningún directorio por contribuyente y no recibe ninguno. |
rendered | RenderNodeOutput | sí | El payload que un guest del Provider devuelve desde su exportación render_node: los bytes serializados de cada archivo de salida que emitió el guest, los nombres que derivó en cada uno de sus propios espacios de claves, los hechos que informa sobre lo que emitió, con cuántas unidades renderizadas coincidió cada entrada omits que se le entregó, y los diagnósticos que el guest generó durante el renderizado. El guest devuelve los bytes serializados de cada archivo; el host los escribe tal cual y no ejecuta ningún serializador. El determinismo es responsabilidad del guest: una entrada idéntica debe producir bytes idénticos. |
annotations | mapa de string | no | Las anotaciones fusionadas del nodo, para que un ensamblador de límite pueda atribuir la ubicación por nodo (p. ej., la red compose derivada de la anotación aggrega.ai/namespace). |
sync_wave | integer | no | La oleada de despliegue heredada del límite que contiene este nodo (0 por defecto; se permiten valores negativos), para que un ensamblador de límite pueda ordenar unos respecto a otros los contribuyentes que fusiona. Un grupo de despacho puede fusionar contribuyentes de varios límites, cada uno con su propia oleada, por lo que la oleada viaja aquí con cada nodo en lugar de una sola vez para todo el payload. Un ensamblador cuya forma de salida no expresa ningún orden la ignora. |
values | object | no | Los valores que el compilador resolvió para este nodo, presentes solo para un nodo renderizado a partir de un origen — la llamada render_node que produjo sus archivos llevaba un source_listing. Es el único caso en que los archivos proceden de otra parte y los valores no pudieron escribirse en ellos, por lo que debe proporcionarlos una posición externa a ellos: un ensamblador de límite coloca un diccionario presente como las entradas de ese contribuyente en el propio artefacto ensamblado, en lugar de junto a los archivos propios del contribuyente, y donde el artefacto ensamblado es la única posición que evalúa el destino, esa es la diferencia entre una entrada que el destino lee y una que nunca alcanza. Un nodo renderizado a partir de un workload_projection o de un artifacts_projection resolvió estos valores en los archivos que produjo, por lo que aquí no lleva ninguno y el campo está ausente: proporcionarlos una segunda vez ofrecería al artefacto ensamblado entradas que los archivos propios de ese nodo nunca declaran, y que el destino es libre de rechazar. Las claves llegan ordenadas, no en el orden del autor, y ese ordenamiento es lo que hace que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica; un guest que necesita cualquier otro orden lo impone él mismo. Un ensamblador cuya forma de salida no lleva entradas por contribuyente ignora el campo. |
values_mapped | booleano | no | Verdadero cuando los valores que lleva este nodo son la salida del valuesMapping de su Recipe o FeatureRecipe enlazada (la Recipe de un componente, la FeatureRecipe de una Feature vinculada), en lugar de los valores del nodo entregados tal como el autor los escribió — la misma marca que la llamada render_node para este nodo llevaba en su proyección del nodo, llevada aquí junto a los valores que describe. Ausente donde no se ejecutó ningún valuesMapping, y dondequiera que values esté ausente. Si un ensamblador lo lee es el contrato propio de ese ensamblador: uno cuyo render_node enlaza los valores de un nodo mapeado con las entradas que declara su origen puede saber por él qué nombres rellenó ese enlace, mientras que uno que coloca los valores de un nodo como sus entradas comoquiera que se hayan producido no lo lee. Registra cómo se produjeron los valores y nunca se deriva del nombre de una clave ni del contenido de un valor. |
No se permiten propiedades adicionales.
RenderEdge
Una arista uses dirigida del grafo, nombrada por sus dos id de nodo: source es el nodo consumidor y target el consumido. La lista lleva toda arista uses del grafo, por lo que cualquiera de los dos extremos puede ser un nodo fuera de este grupo de despacho.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
source | string | sí | El id del nodo consumidor — el extremo source de una arista uses dirigida. |
target | string | sí | El id del nodo consumido — el extremo target al que apunta una arista uses dirigida. |
No se permiten propiedades adicionales.
SubChart
Un sub-chart que contribuye a un umbrella chart: su identidad de instancia, la versión que fija el umbrella, los valores por instancia que el umbrella coloca bajo el alias del sub-chart y, para un sub-chart incorporado mediante vendoring desde un origen de chart, los bytes intactos del archivo Chart.yaml de ese chart. Un ensamblador de umbrella chart construye las dependencias y el archivo de valores del umbrella solo a partir de estas vistas de datos puros y no toca ningún sistema de archivos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
instance_id | string | sí | La identidad de instancia del sub-chart dentro del grupo de despacho; el umbrella coloca bajo ella el alias de dependencia del sub-chart y sus valores, de modo que varias instancias de un mismo chart de origen se mantienen distintas. |
version | string | no | La versión que el umbrella fija para el sub-chart. Un sub-chart incorporado mediante vendoring desde un origen de chart toma en cambio el nombre y la versión de su dependencia del archivo Chart.yaml de ese chart, para que la dependencia se enlace; este valor se aplica a un sub-chart generativo que no lleva ningún chart incorporado mediante vendoring. |
values | object | no | Los valores por instancia que el umbrella coloca bajo el alias del sub-chart en el archivo values.yaml del umbrella. Las claves llegan ordenadas, no en el orden del autor, y ese ordenamiento es lo que hace que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica; un guest que necesita cualquier otro orden lo impone él mismo. |
chart_yaml | string | no | Los bytes intactos del Chart.yaml del chart incorporado mediante vendoring, leídos del origen local en tiempo de compilación, de los que el umbrella toma el nombre y la versión de la dependencia del sub-chart. Vacío para un sub-chart generativo que no lleva ningún chart incorporado mediante vendoring. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
No se permiten propiedades adicionales.
AssembleBoundaryOutput
El payload que un guest del Provider devuelve desde su exportación assemble_boundary: los bytes serializados de cada archivo ensamblado y los diagnósticos que el guest generó durante el ensamblado. Dónde se ubican los archivos por nodo del grupo ensamblado no forma parte de esta respuesta — es una propiedad estática del proveedor, declarada una sola vez en su contrato describe() y disponible antes de que se renderice ningún nodo. El guest devuelve los bytes serializados de cada archivo; el host los escribe tal cual y no ejecuta ningún serializador. El determinismo es responsabilidad del guest: una entrada idéntica debe producir bytes idénticos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
files | RenderedFile[] | sí | Los archivos de salida ensamblados que emitió el guest, en orden de emisión. Cada uno nombra su ruta en disco y lleva los bytes serializados que el host escribe tal cual. |
diagnostics | Diagnostic[] | no | Diagnósticos que el guest generó durante el ensamblado. Cada elemento es la forma de diagnóstico compartida de los plugins Wasm. |
error | string | no | Un mensaje de error que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. Es distinto de cualquier diagnóstico que lleve la salida: los diagnósticos informan de problemas encontrados durante una ejecución que aun así produjo un resultado, mientras que error informa de que la propia operación no se completó. El host presenta un error presente como una invocación de plugin fallida. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
CarveInput
El payload que un guest del Provider recibe en su exportación opcional carve: un archivo de salida con nombre que la pipeline divide en unidades direccionables antes de que un paso de una FeatureRecipe edite algunas de ellas. Un proveedor cuya forma de salida no puede dividir directamente el códec YAML estándar (un chart basado en plantillas, por ejemplo) anuncia carve y reassemble, de modo que su propio conocimiento de la forma de salida reside en el guest; un proveedor que omite las exportaciones recurre al códec YAML estándar del host.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | El nombre del archivo de salida, para que el códec pueda aplicar cualquier regla de división ligada al nombre. |
body | string | sí | Los bytes del archivo de salida que se van a dividir en unidades direccionables. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
yaml_indent | integer | no | El ancho de la sangría que usa el códec cuando debe sintetizar texto estructurado nuevo; se lleva para que la división del guest coincida con la sangría común a todo el renderizado. |
No se permiten propiedades adicionales.
CarveOutput
El payload que un guest del Provider devuelve desde su exportación carve: las unidades direccionables ordenadas en las que dividió el archivo. Una unidad estructurada lleva un árbol (un destino de PATCH); una unidad opaca lleva solo su tipo de medio y sus bytes.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
units | object[] | sí | Las unidades direccionables ordenadas en las que el guest dividió el archivo. |
No se permiten propiedades adicionales.
ReassembleInput
El payload que un guest del Provider recibe en su exportación opcional reassemble: el archivo original más sus unidades divididas y las unidades parcheadas que produjo un paso de pipeline, para que el guest vuelva a insertar quirúrgicamente los cambios en los bytes originales. Un token ausente del conjunto parcheado se vuelve a unir tal cual a partir de sus bytes originales; de un token parcheado solo se editan sus rangos de bytes direccionados.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | El nombre del archivo de salida, que coincide con el nombre con el que se dividió ese mismo archivo. |
body | string | sí | Los bytes del archivo original en los que el reensamblado vuelve a insertar las unidades parcheadas. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
segs | object[] | no | Las unidades en las que se dividió el archivo, tal como las devolvió carve. |
patched | object[] | no | Las unidades que cambió un paso de pipeline, cada una con su token, su árbol parcheado y las ops que produjeron el cambio. |
yaml_indent | integer | no | El ancho de la sangría que usa el códec cuando una op debe sintetizar texto estructurado nuevo; se lleva para que el reensamblado coincida con la sangría común a todo el renderizado. |
No se permiten propiedades adicionales.
ReassembleOutput
El payload que un guest del Provider devuelve desde su exportación reassemble: los bytes del archivo con las unidades parcheadas vueltas a insertar. El reensamblado es fiel byte a byte — todo byte que las ops no tocaron se conserva tal cual.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
body | string | sí | Los bytes del archivo reensamblado que el host escribe tal cual. Cada kit los lleva en su propio tipo de campo — en bruto donde ese tipo es un tipo de bytes, codificados en base64 donde es una cadena que el guest decodifica para recuperarlos — y el codificador generado convierte entre el campo y la forma en que el formato de transmisión lleva los bytes. |
No se permiten propiedades adicionales.
NameBoundInput
El payload que un guest del Provider recibe en su exportación opcional name_bound: un nombre que el host propone usar como identidad de componente de un nodo, para que el guest lo juzgue frente a cada nombre que derivaría de él para su destino, junto con los hechos del workload resuelto del nodo de los que dependen algunos de esos nombres, cuando la identidad se fija después de resolverse ese workload. El guest responde con una restricción y no con un nombre propio — un nombre derivado que viajara de vuelta pondría al host en la tarea de componer nombres para un destino del que no sabe nada, que es exactamente lo que elimina el hecho de plantear la pregunta. Un proveedor cuyo destino limita o restringe los nombres que acepta anuncia la exportación; un proveedor cuyo destino acepta cualquier nombre la omite y nunca se le consulta, y su renderizado no cambia.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
proposed | string | sí | El nombre que el host propone como identidad de componente del nodo. El guest deriva de él, en memoria, cada nombre que deriva de una identidad de componente e informa de si cada uno es un nombre que su destino acepta. Un veredicto se refiere a la PROPUESTA y no al nodo: el host hace una sola pregunta dondequiera que compone una identidad, y no dice de cuáles de los nombres de ese nodo terminará siendo base esta identidad, por lo que un guest responde como si fuera la base de todos ellos. Esa es la dirección conservadora, porque el host solo acorta en función de la respuesta y nunca alarga — un nombre que el nodo derivará de hecho de algún otro valor que se lleva se juzga, por tanto, con demasiada severidad y no con demasiada laxitud. |
authored | booleano | no | Si el nombre propuesto es uno que escribió una persona y no uno que el compilador compuso a partir de partes escritas por el autor. Se lleva para que un guest pueda formular su motivo para el lector que puede actuar en consecuencia. No decide qué hace un rechazo: un nombre escrito por el autor se rechaza y uno compuesto se acorta, y esa decisión es del host. |
workload_form | string | no | La forma del workload en la que se resuelve la Recipe o la FeatureRecipe del nodo, tal como la produjo su plantilla de workload, transmitida cuando la identidad se fija después de resolverse ese workload y el workload indica una forma. Se transmite tal como está escrita; el host no la interpreta. Un guest cuyo destino limita un nombre que emite para una sola forma — un job programado, cuyo nombre el destino exige más corto que sus otros nombres porque se le añade un sufijo en cada ejecución — la lee para juzgar ese nombre. Ausente significa que el host no transmite ninguna forma para esta pregunta: el nodo no declara ningún workload, su workload no indica ninguna o la identidad se fija antes de resolverse cualquier workload. Entonces el guest no juzga ningún nombre que dependa de la forma y responde exactamente como lo haría si el campo no existiera. |
service_keys | string[] | no | Las claves de los Services que declara el workload resuelto del nodo, en el orden en que el workload las declara, transmitidas cuando la identidad se fija después de resolverse ese workload y el workload declara alguno. Un guest cuyo destino nombra cada Service que emite para el nodo a partir de la identidad del componente y la clave del Service las lee para juzgar cada uno de esos nombres. Una clave la escribe el autor de la Recipe o de la FeatureRecipe y no quien escribió la identidad, así que un guest redacta también para ese autor el rechazo que causa una clave. Ausente significa que el host no transmite ninguna clave para esta pregunta: el nodo no declara ningún workload, su workload no declara ningún Service o la identidad se fija antes de resolverse cualquier workload. Entonces el guest no juzga ningún nombre construido a partir de una clave de Service y responde exactamente como lo haría si el campo no existiera. |
No se permiten propiedades adicionales.
DerivedNameVerdict
El veredicto de un tipo de nombre sobre una identidad propuesta: si el nombre que el guest derivaría para ese tipo es uno que su destino acepta y — donde se aceptaría una identidad más corta — la longitud máxima que se aceptaría. Lleva una restricción y un motivo, nunca un nombre que construyó el guest.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
kind | string | sí | El nombre propio del guest para el tipo de nombre que cubre este veredicto, escrito en el vocabulario del destino y no en el del compilador — el nombre de release de un instalador de charts, el nombre de servicio de un orquestador de contenedores. Llega a un lector tal cual en un rechazo, por lo que está escrito para alguien que conoce el destino. |
usable | booleano | sí | Si el nombre que el guest derivaría para este tipo a partir de la identidad propuesta es uno que el destino acepta. |
bound | integer | no | El número máximo de caracteres que puede llevar una identidad propuesta para que el nombre derivado de este tipo sea uno que el destino acepte. Presente solo en un rechazo que una identidad más corta satisfaría. AUSENTE significa que la longitud no es aquello a lo que el destino puso objeción — o no hay ningún límite de longitud, o la objeción es una que ningún acortamiento repara, como un carácter que la gramática del destino rechaza en la posición en la que quedó. La ausencia es, por tanto, distinta de un límite de cero, que sí indica una longitud: que ninguna identidad de ninguna longitud produce un nombre aceptable de este tipo. El host acorta hasta un límite presente y vuelve a preguntar; ante un límite ausente se detiene, porque no queda nada por probar. |
reason | string | no | Por qué el destino no acepta el nombre derivado, en los propios términos del destino, para un lector que decide qué escribir en su lugar. Vacío cuando el veredicto es utilizable. |
No se permiten propiedades adicionales.
NameBoundOutput
El payload que un guest del Provider devuelve desde su exportación name_bound: un veredicto por cada tipo de nombre que derivaría de la identidad propuesta. Una propuesta es utilizable cuando lo es cada veredicto; donde uno no lo es, el host acorta la propuesta al límite más pequeño que llevan los veredictos de rechazo y vuelve a preguntar, y se detiene cuando un veredicto de rechazo no lleva ningún límite. Una lista de veredictos vacía significa que el guest no deriva ningún nombre de una identidad de componente, lo cual es la misma respuesta que aceptar la propuesta.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
names | DerivedNameVerdict[] | no | Una entrada por cada tipo de nombre que el guest deriva de una identidad de componente, en el orden propio del guest. Un guest informa de cada tipo que derivaría en lugar de solo los tipos que rechazaron, de modo que un lector ve qué nombres se juzgaron y un host que lee las entradas no necesita una segunda llamada para conocer el resto. |
error | string | no | Un mensaje de fallo que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. Es distinto de un veredicto de rechazo: un veredicto informa de un nombre que el destino no aceptará, mientras que error informa de que no se pudo responder a la propia pregunta. El host presenta un error presente como una invocación de plugin fallida. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
RenderedNameInput
El payload que un guest del Provider recibe en su exportación opcional rendered_name: las dos identidades de las que un destino deriva sus propios nombres, y qué tipos de entrada declara la Recipe del nodo — un origen proporcionado por el autor, un workload que el guest sintetiza. El guest responde con el nombre que su destino dará a los recursos que renderiza para ese nodo: para un origen proporcionado, el nombre con respecto al cual se renderizan las propias plantillas del autor, como el nombre de release que lee un chart; para un workload sintetizado, el nombre que el guest da a los recursos que construye, donde deriva uno en lugar de escribir la identidad del nodo tal cual. Un guest que no deriva ningún nombre así no informa de ninguno, que es la respuesta honesta para un destino cuyos nombres de recursos escribe una Recipe tal cual, y para uno cuyo nombre depende de dónde se colocan los archivos y no del nodo. Esta exportación informa de un nombre que el propio guest compone y no es el intercambio que pide al guest juzgar un nombre que propone el host; son preguntas distintas y cada una tiene su propia exportación.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
node_id | string | sí | La identidad propia del nodo, tal como se escribió. Se lleva sin codificar: un destino la restringe mediante su propio alfabeto, por lo que codificarla antes pondría un escape dentro de otro y escribiría el nombre de forma distinta de aquel con el que el autor de una receta lo predice. |
derived_name_basis | string | no | La identidad con respecto a la cual se renderiza el origen propio de un contribuidor cuando no es la propia del nodo — establecida para un contribuidor cuya identidad rechaza el alfabeto de nombres de un destino, ausente en caso contrario. Un guest resuelve el par del mismo modo que cualquier otra superficie: este valor cuando está presente, el id del nodo cuando no lo está. |
sourced | booleano | no | Si la Recipe enlazada del nodo declara un origen proporcionado por el autor, leído del texto que escribió el autor. Se lleva, junto con synthesized, para que la pregunta pueda hacerse sobre cualquier nodo y responderse correctamente: un guest no informa de ningún nombre para un nodo que no declara ninguno de los dos, cuya salida es solo un conjunto de artefactos, porque los recursos de un conjunto así se nombran por los artefactos que escribió el autor y no por un nombre que derive el guest. |
synthesized | booleano | no | Si la Recipe enlazada del nodo declara un workload que el guest debe sintetizar, leído del texto que escribió el autor, como lo es sourced. Un guest cuyo destino nombra los recursos que sintetiza según un nombre que deriva, en lugar de según la identidad del nodo tal como está escrita, informa de ese nombre para un nodo así, de modo que una dirección que una Recipe publica para uno de esos recursos pueda construirse a partir del nombre que lleva el recurso. |
No se permiten propiedades adicionales.
RenderedNameOutput
El payload que un guest del Provider devuelve desde su exportación rendered_name: el nombre que su destino da a los recursos que renderiza para el nodo — a partir del origen del nodo proporcionado por el autor, o del workload que sintetiza — o ningún nombre. Un nombre ausente o vacío es una respuesta positiva y no un fallo — dice que este destino no deriva ningún nombre así — y el host usa lo que se le dijo sin leerlo, de modo que ningún conocimiento de la denominación del destino cruza la frontera.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | no | El nombre bajo el que el guest renderiza el origen de este nodo proporcionado por el autor, o que da a los recursos que sintetiza para el nodo, ya escrito en el alfabeto que su destino acepta en esa posición. Vacío o ausente significa que el guest no deriva ningún nombre así. |
error | string | no | Un mensaje de fallo que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. Es distinto de no informar de ningún nombre: ningún nombre es una respuesta sobre el destino, mientras que error informa de que no se pudo responder a la propia pregunta. El host presenta un error presente como una invocación de plugin fallida. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
LinkEndpoint
Un endpoint de un enlace entre límites: el nodo, la ruta del límite en la que se ensambla su salida renderizada y el proveedor que lo renderizó. Los dos endpoints de un enlace nombran los extremos consumidor y consumido de una arista uses cuyos extremos se ensamblan en grupos de despacho distintos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
node | string | sí | El id absoluto del nodo del endpoint dentro del grafo de la topología. |
boundary | string | sí | La ruta del límite del endpoint — el grupo de despacho en el que se ensambla su salida renderizada. |
provider | string | sí | El proveedor que renderizó el endpoint (el nombre simple del proveedor). Ambos endpoints de un enlace cableado nombran el mismo proveedor; el host no enruta un enlace cuyos endpoints nombran proveedores distintos. |
release | string | no | La Release a la que pertenece la salida renderizada del endpoint — el ámbito dentro del cual se nombran sus artefactos ensamblados. El host la ensambla a partir de la Release que resolvió el build y la pasa tal cual; no infiere ningún significado del valor. Un proveedor la lee para acotar a la Release un nombre de referencia cruzada. Un valor ausente es la cadena vacía, que un proveedor trata como un nombre sin ámbito. |
No se permiten propiedades adicionales.
LinkEdge
El payload por arista generalizado y agnóstico respecto al dominio que el host ensambla para una arista uses cuyos extremos consumidor y consumido se ensamblan en grupos de despacho distintos. Lleva ambos endpoints, las anotaciones de ubicación de ambos endpoints como mapas escalares opacos que el host no interpreta, la salida provides del endpoint consumido, y el socket y el mapeo inject que cablea la arista. Un proveedor lo lee para producir el cableado de referencia cruzada nativo del proveedor que necesitan los dos extremos; el host lo ensambla y pasa el mapa de anotaciones como escalares opacos, sin inferir ningún significado de ningún valor.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
source | LinkEndpoint | sí | El endpoint consumidor — el extremo de origen de la arista uses dirigida, en cuya salida ensamblada se inyecta el cableado del lado del consumidor. |
target | LinkEndpoint | sí | El endpoint consumido — el extremo de destino al que apunta la arista uses, cuya salida ensamblada publica el cableado del lado del productor. |
target_annotations | mapa de string | no | Las anotaciones de ubicación del endpoint consumido (destino) como un mapa escalar opaco, indexado por nombre de anotación. El host las ensambla a partir de las anotaciones resueltas del destino y las pasa tal cual; no infiere ningún significado de ningún valor. Un proveedor las lee para decidir cómo dar forma a una referencia cruzada (por ejemplo, si los dos extremos comparten una ubicación o necesitan una referencia entre ubicaciones). Las claves se serializan ordenadas para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
source_annotations | mapa de string | no | Las anotaciones de ubicación del endpoint consumidor (origen) como un mapa escalar opaco, indexado por nombre de anotación. El host las ensambla a partir de las anotaciones resueltas del origen y las pasa tal cual; no infiere ningún significado de ningún valor. Un proveedor las lee para comparar la ubicación de los dos extremos — por ejemplo, si el origen y el destino comparten una ubicación o están en ubicaciones distintas. Las claves se serializan ordenadas para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
socket | string | sí | El alias del socket bajo el que está enlazada la arista uses. |
provides | mapa de string | sí | La salida provides del endpoint consumido, un conjunto de claves en el orden del autor que expone las salidas declaradas del destino. Conserva el orden del autor para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
inject | object | sí | El mapeo inject del endpoint consumidor, indexado por mecanismo de entrega hacia un conjunto de claves en el orden del autor, que describe cómo el extremo consumidor recibe la salida del endpoint consumido. Conserva el orden del autor para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
read_provides_keys | string[] | no | Las claves de la salida provides del endpoint consumido que las plantillas del endpoint consumidor leen directamente a través de .context.uses, las entregue también o no el mapeo inject, en el orden del autor de provides. Cada entrada es una de las claves que lleva provides. La lista viaja en la arista para que la publicación del lado del productor y la resolución del lado del consumidor lean una misma lista. Ausente cuando el endpoint consumidor no leyó directamente ninguna clave de provides, y un proveedor que no recibe ninguna cablea el enlace exactamente como lo haría si el campo no existiera. |
No se permiten propiedades adicionales.
LinkPatch
Un parche estructural por archivo que un proveedor devuelve como cableado de artefactos: el archivo de salida y las operaciones estructurales ordenadas que se le aplican. Una pasada posterior del host divide el archivo nombrado, aplica las operaciones y lo reensambla con fidelidad byte a byte. La forma de la operación es el vocabulario compartido de operaciones de parche del pipeline; es opaca en esta capa del esquema, de modo que un guest lleva cada operación tal cual mientras el host realiza la operación tipada que aplica su pipeline.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
file | string | sí | El archivo de salida al que se aplican las operaciones, nombrado tal como lo emitió el proveedor. |
ops | any[] | sí | Las operaciones estructurales ordenadas que se aplican al archivo, en orden de aplicación. |
No se permiten propiedades adicionales.
LinkPublishInput
El payload que un proveedor recibe en su exportación link_publish: un enlace entre límites cuya salida del endpoint consumido se referencia a través de un límite, y los archivos ensamblados de ese endpoint. La exportación devuelve la identidad publicada frente a la que resuelve el consumidor y cualquier cableado de artefactos del lado del productor que necesite la salida del endpoint consumido.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
edge | LinkEdge | sí | El enlace entre límites que se está publicando, leído desde el lado del endpoint consumido (destino). |
producer_files | RenderedFile[] | no | Los archivos ensamblados del endpoint consumido, para que el proveedor pueda leer lo que ese endpoint ya declara y comprobar frente a ellos los nombres que está a punto de publicar. Cada uno nombra su ruta en disco y lleva los bytes ensamblados. Ausente cuando el host no tiene ninguna salida ensamblada del productor que entregar a la publicación; un proveedor que no necesita ningún documento para escribir su cableado lo ignora. |
No se permiten propiedades adicionales.
LinkPublishOutput
El payload que un proveedor devuelve desde su exportación link_publish: el handle de identidad publicada frente al que resuelve el consumidor, y el cableado de artefactos del lado del productor que se aplica a la salida ensamblada del endpoint consumido.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
handle | mapa de string | sí | La identidad publicada que expone el endpoint consumido para que el consumidor resuelva frente a ella, un mapa opaco de cadenas de puntero deterministas indexado por nombre de campo (por ejemplo, un nombre de export, un nombre de stack, una región, una referencia de rol). Los valores son cadenas de puntero deterministas que el compilador canaliza y nunca resuelve; el entorno de ejecución las resuelve en el momento del despliegue. Las claves se serializan ordenadas para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
patches | LinkPatch[] | no | El cableado de artefactos del lado del productor, un parche estructural por cada archivo de salida del endpoint consumido que la publicación debe editar. Vacío cuando la salida del endpoint consumido no necesita ningún cambio para el enlace. |
error | string | no | Un mensaje de fallo que se establece cuando el guest se ejecutó pero no pudo publicar el enlace; ausente en caso de éxito. El host presenta un error presente como una invocación de plugin fallida. Una publicación que no puede continuar — un nombre de export que el stack ya declara bajo otra entrada, por ejemplo — se informa aquí en lugar de solo como una caída, de modo que se pueda nombrar la condición que hay detrás. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.
LinkResolveInput
El payload que un proveedor recibe en su exportación link_resolve: un enlace entre límites, el handle de identidad publicada que expuso su endpoint consumido y los archivos ensamblados del endpoint consumidor. La exportación devuelve el cableado de artefactos del lado del consumidor que inyecta la referencia en la salida ensamblada del endpoint consumidor.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
edge | LinkEdge | sí | El enlace entre límites que se está resolviendo, leído desde el lado del endpoint consumidor (origen). |
handle | mapa de string | sí | El handle de identidad publicada que devolvió el link_publish del endpoint consumido, frente al que el consumidor resuelve su referencia. Cadenas de puntero deterministas opacas indexadas por nombre de campo; el compilador las canaliza y nunca las resuelve. Las claves se serializan ordenadas para que el payload sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
consumer_files | RenderedFile[] | no | Los archivos ensamblados del endpoint consumidor, para que el proveedor pueda localizar el marcador de posición que el host estampó en la salida consumidora y escribir su sustitución en la ruta real del marcador de posición. Cada uno nombra su ruta en disco y lleva los bytes ensamblados. Ausente cuando el host no tiene ninguna salida ensamblada del consumidor que entregar a la resolución; un proveedor que no necesita ningún documento para escribir su cableado lo ignora. |
No se permiten propiedades adicionales.
LinkResolveOutput
El payload que un proveedor devuelve desde su exportación link_resolve: el cableado de artefactos del lado del consumidor que se aplica a la salida ensamblada del endpoint consumidor, inyectando la referencia a la identidad publicada del endpoint consumido.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
patches | LinkPatch[] | sí | El cableado de artefactos del lado del consumidor, un parche estructural por cada archivo de salida del endpoint consumidor que la resolución debe editar. |
error | string | no | Un mensaje de fallo que se establece cuando el guest se ejecutó pero no pudo resolver el enlace; ausente en caso de éxito. El host presenta un error presente como una invocación de plugin fallida. Una resolución que no puede continuar — una referencia que el destino solo puede llevar como un escalar completo, encontrada dentro de una cadena más larga — se informa aquí en lugar de solo como una caída, de modo que se pueda nombrar la condición que hay detrás. |
condition_code | string | no | La identidad descriptiva e identificable por máquina de la condición que nombra el fallo — el código bajo el que está registrada la condición, en el mismo conjunto abierto en el que el compilador registra sus propias condiciones de detención, y no un miembro del catálogo cerrado de códigos de error de las funciones host del que toma su valor el hostfunc_error_code de un sobre de respuesta. Establecida junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. Un guest que se detiene informa aquí el identificador de la condición que nombra su mensaje, de modo que un consumidor se ramifica según él en lugar de recuperar una identidad leyendo el mensaje. El host resuelve este identificador frente a las condiciones que declara el compilador y publica los identificadores propios de la condición resuelta en el diagnóstico estructurado, de modo que un código que llega a un lector siempre se resuelve; un identificador que no nombra ninguna condición de ese tipo, o uno que la numeración ha retirado, detiene el build. Un guest sin una condición precisa que nombrar recurre en su lugar a una de las condiciones genéricas de fallo de plugin que el compilador declara con ese fin, y pone los detalles en su propio mensaje. Este identificador y condition_short_code se informan juntos, porque nombran una misma condición en dos formas: un guest que establece uno y no el otro ha nombrado una condición que el host no puede resolver, y entonces el host informa en su lugar su propia condición genérica de fallo de plugin, mientras el mensaje sigue llevando el fallo completo. |
condition_short_code | string | no | El identificador compacto de la misma condición — la letra E y cuatro dígitos, la forma que un lector cita, busca y pega en un informe — establecido junto al mensaje de error legible por personas; ausente en caso de éxito, y ausente cuando el guest no nombra ninguna condición de ese tipo. El host lo imprime en el encabezado entre corchetes del diagnóstico que produce para este fallo, de modo que una condición que genera un guest se puede citar exactamente igual que una que genera el compilador. El host resuelve el valor frente a las condiciones que declara el compilador en lugar de llevarlo de confianza: un valor que no nombra ninguna condición de ese tipo, un valor que la numeración ha retirado o una grafía que el registro no lleva detiene el build y cita el valor infractor, y el mensaje propio del guest se sigue informando. Se informa junto con condition_code, por el motivo indicado allí. |
No se permiten propiedades adicionales.