@milpa/comal 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# Instalar Comal
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Comal es un cliente de terminal. Necesitas Node.js 22 o posterior y npm; para búsquedas de código instala también `rg` (ripgrep). No necesitas desplegar PHP, Docker ni el backend para usar la CLI. Los Artifacts privados usan la casa pública de Comal.
+
+## Arrancar con npx
+
+El paquete `@milpa/comal` incluye sus dependencias JavaScript; no tiene scripts de instalación y no contiene credenciales o sesiones del autor.
+
+```sh
+npx @milpa/comal
+```
+
+El primer arranque, sin conexión configurada, muestra cómo elegir demo, Codex o tu endpoint; no intenta usar el servidor privado del autor. Usa la misma invocación en lugar de `comal` para los ejemplos de abajo. npm conserva su caché; el estado y las credenciales de Comal quedan en tu workspace y tu configuración, fuera de esa caché.
+
+## Dejar el comando global comal
+
+```sh
+npm install --global --ignore-scripts @milpa/comal
+
+# Si tu prefijo global requiere permisos, usa un prefijo de tu usuario:
+# npm install --global --prefix "$HOME/.local" --ignore-scripts @milpa/comal
+export PATH="$HOME/.local/bin:$PATH"
+comal --version
+comal --help
+```
+
+Conserva la línea de PATH en el archivo de inicio de tu shell si utilizas ese prefijo. Si tu gestor de Node ya proporciona un prefijo de usuario, puedes omitir `--prefix "$HOME/.local"`. El paquete registra el ejecutable `comal`; no necesitas crear un alias de shell.
+
+Puedes fijar una versión con `npx @milpa/comal@0.1.0` o `npm install --global @milpa/comal@0.1.0`. El manifiesto local de release conserva SHA-256 y la integridad SHA-512 se coteja con npm al publicar. No se afirma una firma independiente del editor.
+
+## Probar sin cuenta ni modelo
+
+```sh
+mkdir -p "$HOME/comal-practica"
+cd "$HOME/comal-practica"
+comal --demo -p 'Muestra el ciclo de herramientas'
+comal sessions
+```
+
+La demo es un guion determinista que usa herramientas reales y crea un archivo de práctica. No es inferencia ni requiere pago. Tus sesiones se guardan en el workspace, fuera de la instalación.
+
+## Conectar tu modelo
+
+El endpoint heredado del entorno original es `http://llama.local:11438/`; pertenece a esa red y no se incluye un modelo con Comal. Selecciona explícitamente tu conexión:
+
+```sh
+# Servidor compatible con OpenAI que ya tengas funcionando.
+comal --base-url http://127.0.0.1:8080/v1 --model TU_MODELO --name residente
+
+# O tu acceso Codex compatible: autenticación y selección son pasos distintos.
+comal login codex
+comal --auth-provider codex --name residente
+```
+
+Para APIs configura la clave mediante el entorno o tu gestor de secretos. No la pegues en el composer ni como argumento. Consulta https://comal.milpahq.com/academy/docs/modelos/ y https://comal.milpahq.com/academy/docs/login/ para perfiles y proveedores.
+
+## Conectar tu cuenta de Artifacts
+
+```sh
+comal cloud login
+comal cloud status
+```
+
+Abre la URL que imprime Comal, entra con Google o GitHub y aprueba esa CLI. Esta cuenta autoriza Artifacts; es independiente del login y la facturación de tu modelo. Tus credenciales quedan en archivos privados de tu usuario, nunca en el paquete.
+
+## Actualizar o quitar
+
+Instala `@milpa/comal@VERSION` con el mismo comando y prefijo. Comprueba `comal --version`. No hay actualización silenciosa.
+
+```sh
+npm uninstall --global @milpa/comal
+```
+
+Esto retira el cliente; conserva las sesiones de los proyectos y las credenciales del usuario. Para desconectar Artifacts antes de quitarlo usa `comal cloud logout`; los proveedores tienen su propio `comal logout PROVEEDOR`.
+
+## Alcance de esta primera distribución
+
+La instalación se comprueba en Linux, desde un prefijo y un HOME vacíos. macOS y Windows mediante WSL2 son rutas pendientes de verificación en esos entornos; no se afirma soporte de Windows nativo. Chrome Lab requiere configurar tu propio host SSH/CDP. El paquete no concede acceso al laboratorio del autor.
+
+El paquete pertenece a la organización npm `@milpa`. `npx comal` corresponde a otro proyecto; usa el nombre completo `npx @milpa/comal`. Una licencia pública, instaladores nativos y firma del editor se resolverán por separado con el mantenedor. Documentación completa: https://comal.milpahq.com/academy/ .
+
+El transporte de tarballs y las dependencias incluidas usan los mecanismos documentados de [npm install](https://docs.npmjs.com/cli/v12/commands/npm-install/) y [bundledDependencies](https://docs.npmjs.com/files/package.json/).

package/backend/contracts/artifact-check-v1.schema.json

@@ -0,0 +1,213 @@
+{
+  "description": "Checks use unique IDs outside the reserved platform_ prefix. Platform asset/access/render checks are added by the house.",
+  "anyOf": [
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]{0,47}$"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "text"
+          ]
+        },
+        "selector": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "equals": {
+          "type": "string",
+          "maxLength": 4000
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "selector",
+        "equals"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]{0,47}$"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "count"
+          ]
+        },
+        "selector": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10000
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "selector",
+        "count"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]{0,47}$"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "interaction"
+          ]
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 20,
+          "items": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "fill"
+                    ]
+                  },
+                  "selector": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512
+                  },
+                  "text": {
+                    "type": "string",
+                    "maxLength": 4000
+                  }
+                },
+                "required": [
+                  "action",
+                  "selector",
+                  "text"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "click"
+                    ]
+                  },
+                  "selector": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512
+                  }
+                },
+                "required": [
+                  "action",
+                  "selector"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "reload"
+                    ]
+                  }
+                },
+                "required": [
+                  "action"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "assert_text"
+                    ]
+                  },
+                  "selector": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512
+                  },
+                  "equals": {
+                    "type": "string",
+                    "maxLength": 4000
+                  }
+                },
+                "required": [
+                  "action",
+                  "selector",
+                  "equals"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "action": {
+                    "type": "string",
+                    "enum": [
+                      "assert_count"
+                    ]
+                  },
+                  "selector": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512
+                  },
+                  "count": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 10000
+                  }
+                },
+                "required": [
+                  "action",
+                  "selector",
+                  "count"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "id",
+        "kind",
+        "steps"
+      ],
+      "additionalProperties": false
+    }
+  ]
+}

package/backend/verifier/transport.mjs

@@ -0,0 +1,27 @@
+// A configured internal network address is transport routing, never a change of logical origin.
+// Node fetch ignores an overridden Host header; use the native request API for this explicit case.
+import http from 'node:http';
+import https from 'node:https';
+
+export async function networkFetch(logicalURL, { networkOrigin, maxBytes = 12582912, ...options } = {}) {
+  const logical = new URL(logicalURL);
+  if (!networkOrigin || new URL(networkOrigin).origin === logical.origin) return fetch(logical, { ...options, redirect: 'manual' });
+  const physical = new URL(logical.pathname + logical.search, networkOrigin);
+  if (!['http:', 'https:'].includes(physical.protocol)) throw new Error('Unsupported internal transport protocol.');
+  const headers=new Headers(options.headers);headers.set('host',logical.host);
+  const body=options.body===undefined||options.body===null?null:Buffer.from(options.body);
+  if(body!==null){headers.delete('transfer-encoding');headers.set('content-length',String(body.length));}
+  return new Promise((resolve, reject) => {
+    const request = (physical.protocol === 'https:' ? https : http).request(physical, { ...(physical.protocol === 'https:' ? { servername: logical.hostname } : {}), method: options.method || 'GET', headers: Object.fromEntries(headers), signal: options.signal || AbortSignal.timeout(20000) }, response => {
+      const chunks = []; let length = 0;
+      response.on('data', chunk => { length += chunk.length; if (length > maxBytes) { reject(new Error('Response exceeded byte budget.')); response.destroy(); request.destroy(); return; } chunks.push(chunk); });
+      response.on('error', reject);
+      response.on('end', () => {
+        const headers = new Headers();
+        for (let i = 0; i < response.rawHeaders.length; i += 2) headers.append(response.rawHeaders[i], response.rawHeaders[i + 1]);
+        resolve(new Response([204, 205, 304].includes(response.statusCode) ? null : Buffer.concat(chunks), { status: response.statusCode, headers }));
+      });
+    });
+    request.on('error', reject); request.end(body);
+  });
+}

package/bin/comal.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+try {
+  const args=process.argv.slice(2);
+  const {readFile,access}=await import('node:fs/promises');
+  const {default:path}=await import('node:path');
+  const pkg=JSON.parse(await readFile(new URL('../package.json',import.meta.url),'utf8'));
+  const configured=Object.entries(process.env).some(([key,value])=>value && /^(?:(?:COMAL|HARNESS)_(?:PROVIDER|BASE_URL|MODEL|PROVIDERS_CONFIG|PROFILE)|(?:OPENAI|ANTHROPIC|GEMINI)_(?:BASE_URL|MODEL|API_KEY))$/.test(key));
+  const hasProfile=await Promise.all(['.comal/providers.json','.harness/providers.json'].map(file=>access(path.resolve(file)).then(()=>true,()=>false)));
+  const firstRun=pkg.name==='@milpa/comal' && !args.length && !configured && !hasProfile.some(Boolean);
+  let pipedPrompt='';
+  if(firstRun && !process.stdin.isTTY)for await(const chunk of process.stdin){pipedPrompt+=chunk;if(Buffer.byteLength(pipedPrompt)>1024*1024)throw Error('Prompt excede 1 MiB.');}
+  if(args.length===1 && ['--version','-v'].includes(args[0])) {
+    process.stdout.write(`Comal ${pkg.version}\n`);
+  } else if(firstRun && !pipedPrompt.trim()) {
+    const command=process.env.npm_command==='exec'?'npx @milpa/comal':'comal';
+    process.stdout.write(`Comal ${pkg.version} · Tu primera vuelta\n\nElige cómo empezar desde tu proyecto:\n\n  Probar sin cuenta ni modelo:\n    ${command} --demo\n\n  Conectar Codex:\n    ${command} login codex\n    ${command} --auth-provider codex\n\n  Usar tu servidor compatible con OpenAI:\n    ${command} --base-url http://127.0.0.1:8080/v1 --model TU_MODELO\n\n  Conectar tu cuenta de Artifacts (opcional):\n    ${command} cloud login\n\nGuía: https://comal.milpahq.com/academy/\n`);
+  } else {
+    const {main}=await import('../src/cli.mjs');
+    process.exitCode=await main(pipedPrompt.trim()?['--print','--',pipedPrompt]:args);
+  }
+} catch(error){process.stderr.write(`Comal: ${error.message}\n`);process.exitCode=1;}

package/bin/harness.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// Legacy entry point; existing commands keep opening the same Comal application.
+import './comal.mjs';

package/docs/investigation.md

@@ -0,0 +1,3 @@
+# Procedencia de Comal
+
+Comal es una implementación independiente investigada mediante REA. El paquete incluye el cliente Node, sus herramientas y contratos compartidos. No ejecuta Claude Code para responder. Documentación: https://comal.milpahq.com/academy/

package/governance/chrome-task-v1.json

@@ -0,0 +1,13 @@
+{
+  "profile": { "name": "comal-chrome-task", "version": "1", "decisionIds": ["COMAL-CHROME-001"] },
+  "decisions": [{
+    "id": "COMAL-CHROME-001",
+    "title": "La casa conserva el encargo y cierra con evidencia vigente",
+    "status": "accepted",
+    "supersedes": null,
+    "gates": [
+      { "id": "task-scope", "tier": "enforced", "operations": ["*"], "boundTo": "runtime:chrome-task.scope" },
+      { "id": "current-evidence", "tier": "enforced", "operations": ["WorkTaskUpdate"], "boundTo": "runtime:chrome-task.close" }
+    ]
+  }]
+}

package/node_modules/ajv/.runkit_example.js

@@ -0,0 +1,23 @@
+const Ajv = require("ajv")
+const ajv = new Ajv({allErrors: true})
+
+const schema = {
+  type: "object",
+  properties: {
+    foo: {type: "string"},
+    bar: {type: "number", maximum: 3},
+  },
+  required: ["foo", "bar"],
+  additionalProperties: false,
+}
+
+const validate = ajv.compile(schema)
+
+test({foo: "abc", bar: 2})
+test({foo: 2, bar: 4})
+
+function test(data) {
+  const valid = validate(data)
+  if (valid) console.log("Valid!")
+  else console.log("Invalid: " + ajv.errorsText(validate.errors))
+}

package/node_modules/ajv/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/node_modules/ajv/README.md

@@ -0,0 +1,207 @@
+<img align="right" alt="Ajv logo" width="160" src="https://ajv.js.org/img/ajv.svg">
+
+&nbsp;
+
+# Ajv JSON schema validator
+
+The fastest JSON validator for Node.js and browser.
+
+Supports JSON Schema draft-04/06/07/2019-09/2020-12 ([draft-04 support](https://ajv.js.org/json-schema.html#draft-04) requires ajv-draft-04 package) and JSON Type Definition [RFC8927](https://datatracker.ietf.org/doc/rfc8927/).
+
+[![build](https://github.com/ajv-validator/ajv/actions/workflows/build.yml/badge.svg)](https://github.com/ajv-validator/ajv/actions?query=workflow%3Abuild)
+[![npm](https://img.shields.io/npm/v/ajv.svg)](https://www.npmjs.com/package/ajv)
+[![npm downloads](https://img.shields.io/npm/dm/ajv.svg)](https://www.npmjs.com/package/ajv)
+[![Coverage Status](https://coveralls.io/repos/github/ajv-validator/ajv/badge.svg?branch=master)](https://coveralls.io/github/ajv-validator/ajv?branch=master)
+[![SimpleX](https://img.shields.io/badge/chat-on%20SimpleX-70F0F9)](https://simplex.chat/contact#/?v=1-2&smp=smp%3A%2F%2Fu2dS9sG8nMNURyZwqASV4yROM28Er0luVTx5X1CsMrU%3D%40smp4.simplex.im%2F8KvvURM6J38Gdq9dCuPswMOkMny0xCOJ%23%2F%3Fv%3D1-2%26dh%3DMCowBQYDK2VuAyEAr8rPVRuMOXv6kwF2yUAap-eoVg-9ssOFCi1fIrxTUw0%253D%26srv%3Do5vmywmrnaxalvz6wi3zicyftgio6psuvyniis6gco6bp6ekl4cqj4id.onion&data=%7B%22type%22%3A%22group%22%2C%22groupLinkId%22%3A%224pwLRgWHU9tlroMWHz0uOg%3D%3D%22%7D)
+[![Gitter](https://img.shields.io/gitter/room/ajv-validator/ajv.svg)](https://gitter.im/ajv-validator/ajv)
+[![GitHub Sponsors](https://img.shields.io/badge/$-sponsors-brightgreen)](https://github.com/sponsors/epoberezkin)
+
+## Ajv sponsors
+
+[<img src="https://ajv.js.org/img/mozilla.svg" width="45%" alt="Mozilla">](https://www.mozilla.org)<img src="https://ajv.js.org/img/gap.svg" width="9%">[<img src="https://ajv.js.org/img/reserved.svg" width="45%">](https://opencollective.com/ajv)
+
+[<img src="https://ajv.js.org/img/microsoft.png" width="31%" alt="Microsoft">](https://opensource.microsoft.com)<img src="https://ajv.js.org/img/gap.svg" width="3%">[<img src="https://ajv.js.org/img/reserved.svg" width="31%">](https://opencollective.com/ajv)<img src="https://ajv.js.org/img/gap.svg" width="3%">[<img src="https://ajv.js.org/img/reserved.svg" width="31%">](https://opencollective.com/ajv)
+
+[<img src="https://ajv.js.org/img/retool.svg" width="22.5%" alt="Retool">](https://retool.com/?utm_source=sponsor&utm_campaign=ajv)<img src="https://ajv.js.org/img/gap.svg" width="3%">[<img src="https://ajv.js.org/img/tidelift.svg" width="22.5%" alt="Tidelift">](https://tidelift.com/subscription/pkg/npm-ajv?utm_source=npm-ajv&utm_medium=referral&utm_campaign=enterprise)<img src="https://ajv.js.org/img/gap.svg" width="3%">[<img src="https://ajv.js.org/img/simplex.svg" width="22.5%" alt="SimpleX">](https://github.com/simplex-chat/simplex-chat)<img src="https://ajv.js.org/img/gap.svg" width="3%">[<img src="https://ajv.js.org/img/reserved.svg" width="22.5%">](https://opencollective.com/ajv)
+
+## Contributing
+
+More than 100 people contributed to Ajv, and we would love to have you join the development. We welcome implementing new features that will benefit many users and ideas to improve our documentation.
+
+Please review [Contributing guidelines](./CONTRIBUTING.md) and [Code components](https://ajv.js.org/components.html).
+
+## Documentation
+
+All documentation is available on the [Ajv website](https://ajv.js.org).
+
+Some useful site links:
+
+- [Getting started](https://ajv.js.org/guide/getting-started.html)
+- [JSON Schema vs JSON Type Definition](https://ajv.js.org/guide/schema-language.html)
+- [API reference](https://ajv.js.org/api.html)
+- [Strict mode](https://ajv.js.org/strict-mode.html)
+- [Standalone validation code](https://ajv.js.org/standalone.html)
+- [Security considerations](https://ajv.js.org/security.html)
+- [Command line interface](https://ajv.js.org/packages/ajv-cli.html)
+- [Frequently Asked Questions](https://ajv.js.org/faq.html)
+
+## <a name="sponsors"></a>Please [sponsor Ajv development](https://github.com/sponsors/epoberezkin)
+
+Since I asked to support Ajv development 40 people and 6 organizations contributed via GitHub and OpenCollective - this support helped receiving the MOSS grant!
+
+Your continuing support is very important - the funds will be used to develop and maintain Ajv once the next major version is released.
+
+Please sponsor Ajv via:
+
+- [GitHub sponsors page](https://github.com/sponsors/epoberezkin) (GitHub will match it)
+- [Ajv Open Collective](https://opencollective.com/ajv)
+
+Thank you.
+
+#### Open Collective sponsors
+
+<a href="https://opencollective.com/ajv"><img src="https://opencollective.com/ajv/individuals.svg?width=890"></a>
+
+<a href="https://opencollective.com/ajv/organization/0/website"><img src="https://opencollective.com/ajv/organization/0/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/1/website"><img src="https://opencollective.com/ajv/organization/1/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/2/website"><img src="https://opencollective.com/ajv/organization/2/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/3/website"><img src="https://opencollective.com/ajv/organization/3/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/4/website"><img src="https://opencollective.com/ajv/organization/4/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/5/website"><img src="https://opencollective.com/ajv/organization/5/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/6/website"><img src="https://opencollective.com/ajv/organization/6/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/7/website"><img src="https://opencollective.com/ajv/organization/7/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/8/website"><img src="https://opencollective.com/ajv/organization/8/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/9/website"><img src="https://opencollective.com/ajv/organization/9/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/10/website"><img src="https://opencollective.com/ajv/organization/10/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/11/website"><img src="https://opencollective.com/ajv/organization/11/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/12/website"><img src="https://opencollective.com/ajv/organization/12/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/13/website"><img src="https://opencollective.com/ajv/organization/13/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/14/website"><img src="https://opencollective.com/ajv/organization/14/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/15/website"><img src="https://opencollective.com/ajv/organization/15/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/16/website"><img src="https://opencollective.com/ajv/organization/16/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/17/website"><img src="https://opencollective.com/ajv/organization/17/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/18/website"><img src="https://opencollective.com/ajv/organization/18/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/19/website"><img src="https://opencollective.com/ajv/organization/19/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/20/website"><img src="https://opencollective.com/ajv/organization/20/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/21/website"><img src="https://opencollective.com/ajv/organization/21/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/22/website"><img src="https://opencollective.com/ajv/organization/22/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/23/website"><img src="https://opencollective.com/ajv/organization/23/avatar.svg"></a>
+<a href="https://opencollective.com/ajv/organization/24/website"><img src="https://opencollective.com/ajv/organization/24/avatar.svg"></a>
+
+## Performance
+
+Ajv generates code to turn JSON Schemas into super-fast validation functions that are efficient for v8 optimization.
+
+Currently Ajv is the fastest and the most standard compliant validator according to these benchmarks:
+
+- [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark) - 50% faster than the second place
+- [jsck benchmark](https://github.com/pandastrike/jsck#benchmarks) - 20-190% faster
+- [z-schema benchmark](https://rawgit.com/zaggino/z-schema/master/benchmark/results.html)
+- [themis benchmark](https://cdn.rawgit.com/playlyfe/themis/master/benchmark/results.html)
+
+Performance of different validators by [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark):
+
+[![performance](https://chart.googleapis.com/chart?chxt=x,y&cht=bhs&chco=76A4FB&chls=2.0&chbh=62,4,1&chs=600x416&chxl=-1:|ajv|@exodus/schemasafe|is-my-json-valid|djv|@cfworker/json-schema|jsonschema/=t:100,69.2,51.5,13.1,5.1,1.2)](https://github.com/ebdrup/json-schema-benchmark/blob/master/README.md#performance)
+
+## Features
+
+- Ajv implements JSON Schema [draft-06/07/2019-09/2020-12](http://json-schema.org/) standards (draft-04 is supported in v6):
+  - all validation keywords (see [JSON Schema validation keywords](https://ajv.js.org/json-schema.html))
+  - [OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md) extensions:
+    - NEW: keyword [discriminator](https://ajv.js.org/json-schema.html#discriminator).
+    - keyword [nullable](https://ajv.js.org/json-schema.html#nullable).
+  - full support of remote references (remote schemas have to be added with `addSchema` or compiled to be available)
+  - support of recursive references between schemas
+  - correct string lengths for strings with unicode pairs
+  - JSON Schema [formats](https://ajv.js.org/guide/formats.html) (with [ajv-formats](https://github.com/ajv-validator/ajv-formats) plugin).
+  - [validates schemas against meta-schema](https://ajv.js.org/api.html#api-validateschema)
+- NEW: supports [JSON Type Definition](https://datatracker.ietf.org/doc/rfc8927/):
+  - all keywords (see [JSON Type Definition schema forms](https://ajv.js.org/json-type-definition.html))
+  - meta-schema for JTD schemas
+  - "union" keyword and user-defined keywords (can be used inside "metadata" member of the schema)
+- supports [browsers](https://ajv.js.org/guide/environments.html#browsers) and Node.js 18.x - current
+- [asynchronous loading](https://ajv.js.org/guide/managing-schemas.html#asynchronous-schema-loading) of referenced schemas during compilation
+- "All errors" validation mode with [option allErrors](https://ajv.js.org/options.html#allerrors)
+- [error messages with parameters](https://ajv.js.org/api.html#validation-errors) describing error reasons to allow error message generation
+- i18n error messages support with [ajv-i18n](https://github.com/ajv-validator/ajv-i18n) package
+- [removing-additional-properties](https://ajv.js.org/guide/modifying-data.html#removing-additional-properties)
+- [assigning defaults](https://ajv.js.org/guide/modifying-data.html#assigning-defaults) to missing properties and items
+- [coercing data](https://ajv.js.org/guide/modifying-data.html#coercing-data-types) to the types specified in `type` keywords
+- [user-defined keywords](https://ajv.js.org/guide/user-keywords.html)
+- additional extension keywords with [ajv-keywords](https://github.com/ajv-validator/ajv-keywords) package
+- [\$data reference](https://ajv.js.org/guide/combining-schemas.html#data-reference) to use values from the validated data as values for the schema keywords
+- [asynchronous validation](https://ajv.js.org/guide/async-validation.html) of user-defined formats and keywords
+
+## Install
+
+To install version 8:
+
+```
+npm install ajv
+```
+
+## <a name="usage"></a>Getting started
+
+Try it in the Node.js REPL: https://runkit.com/npm/ajv
+
+In JavaScript:
+
+```javascript
+// or ESM/TypeScript import
+import Ajv from "ajv"
+// Node.js require:
+const Ajv = require("ajv")
+
+const ajv = new Ajv() // options can be passed, e.g. {allErrors: true}
+
+const schema = {
+  type: "object",
+  properties: {
+    foo: {type: "integer"},
+    bar: {type: "string"},
+  },
+  required: ["foo"],
+  additionalProperties: false,
+}
+
+const data = {
+  foo: 1,
+  bar: "abc",
+}
+
+const validate = ajv.compile(schema)
+const valid = validate(data)
+if (!valid) console.log(validate.errors)
+```
+
+Learn how to use Ajv and see more examples in the [Guide: getting started](https://ajv.js.org/guide/getting-started.html)
+
+## Changes history
+
+See [https://github.com/ajv-validator/ajv/releases](https://github.com/ajv-validator/ajv/releases)
+
+**Please note**: [Changes in version 8.0.0](https://github.com/ajv-validator/ajv/releases/tag/v8.0.0)
+
+[Version 7.0.0](https://github.com/ajv-validator/ajv/releases/tag/v7.0.0)
+
+[Version 6.0.0](https://github.com/ajv-validator/ajv/releases/tag/v6.0.0).
+
+## Code of conduct
+
+Please review and follow the [Code of conduct](./CODE_OF_CONDUCT.md).
+
+Please report any unacceptable behaviour to ajv.validator@gmail.com - it will be reviewed by the project team.
+
+## Security contact
+
+To report a security vulnerability, please use the
+[Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure. Please do NOT report security vulnerabilities via GitHub issues.
+
+## Open-source software support
+
+Ajv is a part of [Tidelift subscription](https://tidelift.com/subscription/pkg/npm-ajv?utm_source=npm-ajv&utm_medium=referral&utm_campaign=readme) - it provides a centralised support to open-source software users, in addition to the support provided by software maintainers.
+
+## License
+
+[MIT](./LICENSE)

package/node_modules/ajv/dist/2019.d.ts

@@ -0,0 +1,19 @@
+import type { AnySchemaObject } from "./types";
+import AjvCore, { Options } from "./core";
+export declare class Ajv2019 extends AjvCore {
+    constructor(opts?: Options);
+    _addVocabularies(): void;
+    _addDefaultMetaSchema(): void;
+    defaultMeta(): string | AnySchemaObject | undefined;
+}
+export default Ajv2019;
+export { Format, FormatDefinition, AsyncFormatDefinition, KeywordDefinition, KeywordErrorDefinition, CodeKeywordDefinition, MacroKeywordDefinition, FuncKeywordDefinition, Vocabulary, Schema, SchemaObject, AnySchemaObject, AsyncSchema, AnySchema, ValidateFunction, AsyncValidateFunction, ErrorObject, ErrorNoParams, } from "./types";
+export { Plugin, Options, CodeOptions, InstanceOptions, Logger, ErrorsTextOptions } from "./core";
+export { SchemaCxt, SchemaObjCxt } from "./compile";
+export { KeywordCxt } from "./compile/validate";
+export { DefinedError } from "./vocabularies/errors";
+export { JSONType } from "./compile/rules";
+export { JSONSchemaType } from "./types/json-schema";
+export { _, str, stringify, nil, Name, Code, CodeGen, CodeGenOptions } from "./compile/codegen";
+export { default as ValidationError } from "./runtime/validation_error";
+export { default as MissingRefError } from "./compile/ref_error";