xonecode 0.1.0

package/dist/core/config.js

@@ -0,0 +1,236 @@
+/**
+ * La validación PURA de los dos ficheros de configuración: sin tocar disco (eso es cosa
+ * de `agent/configEnDisco.ts`) y sin importar nada de langchain — la frontera de `core/`
+ * está probada en `imports.test.ts`.
+ *
+ * Dos ficheros con dos ciclos de vida distintos, como opencode:
+ *
+ *  - `config.json` (proyecto o global): modelos y proveedores. Comiteable. NUNCA claves.
+ *    Una clave aquí no se avisa: se RECHAZA, porque un aviso dejaría el fichero
+ *    funcionando y la clave camino del commit. La alternativa —`~/.xonecode/auth.json`—
+ *    está a un comando de distancia.
+ *  - `auth.json` (solo global): las credenciales. En un proyecto se rechaza entero, y se
+ *    comprueba el modo: un `chmod` de más, un `cp -r` o un backup restaurado dejan el
+ *    fichero legible por otros, y eso hay que cantarlo al leerlo, no al día del incidente.
+ *
+ * Y la regla que sostiene a las dos: un aviso NUNCA contiene el valor rechazado, ni
+ * truncado. Un mensaje de error acaba en logs, capturas e issues; el aviso dice QUÉ
+ * campo, no QUÉ contenía. Por eso estos mensajes no interpolan nunca el valor de entrada.
+ */
+import { PROVEEDORES, PAPELES } from "./modelos.js";
+/**
+ * Formas plausibles de colar una clave dentro de un `config.json`. El intento se rechaza
+ * sea cual sea el valor: lo que delata es el NOMBRE del campo, porque una clave con otro
+ * nombre ya no es reconocible — y estas seis cubren lo que la gente escribe a mano.
+ */
+const CLAVES_DENEGADAS = [
+    "claves",
+    "apiKey",
+    "api_key",
+    "key",
+    "secret",
+    "token",
+];
+/** Un JSON-array NO es un objeto a estos efectos: el raíz que no sea objeto se ignora. */
+function esObjeto(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * Valida un `config.json` sin tocar disco. Lo que no entiende lo descarta y lo avisa
+ * nombrándolo: un campo mal escrito tiene que producir un mensaje que lo diga, si no el
+ * usuario cree haber configurado algo y no.
+ */
+export function validar(bruto, ruta, procedencia) {
+    // La procedencia no cambia ninguna regla —una clave de API se rechaza igual venga del
+    // proyecto o del global—: va en la firma por simetría con `validarAuth`, que sí la usa.
+    void procedencia;
+    const avisos = [];
+    if (!esObjeto(bruto)) {
+        return {
+            config: {},
+            avisos: [
+                {
+                    texto: `«${ruta}»: el JSON raíz debe ser un objeto; se ignora el fichero entero.`,
+                    severidad: "aviso",
+                },
+            ],
+        };
+    }
+    const config = {};
+    for (const clave of Object.keys(bruto)) {
+        const valor = bruto[clave];
+        // El rechazo se comprueba PRIMERO, para que una clave denegada no salga también como
+        // «campo desconocido»: el mismo campo con dos avisos es ruido en la dirección mala.
+        const proveedorConCadena = PROVEEDORES.includes(clave) && typeof valor === "string";
+        if (CLAVES_DENEGADAS.includes(clave) || proveedorConCadena) {
+            avisos.push({
+                texto: `«${ruta}»: el campo «${clave}» parece una clave de API y NO se acepta en un config.json: las claves van en ~/.xonecode/auth.json.`,
+                severidad: "grave",
+            });
+            continue;
+        }
+        if (clave === "modelo") {
+            if (typeof valor === "string") {
+                config.modelo = valor;
+            }
+            else {
+                avisos.push({
+                    texto: `«${ruta}»: «modelo» debe ser la cadena «proveedor/modelo»; se descarta.`,
+                    severidad: "aviso",
+                });
+            }
+            continue;
+        }
+        if (clave === "modelos") {
+            if (!esObjeto(valor)) {
+                avisos.push({
+                    texto: `«${ruta}»: «modelos» debe ser un objeto de papel → «proveedor/modelo»; se descarta.`,
+                    severidad: "aviso",
+                });
+                continue;
+            }
+            const modelos = {};
+            for (const papel of Object.keys(valor)) {
+                const idModelo = valor[papel];
+                if (!PAPELES.includes(papel)) {
+                    avisos.push({
+                        texto: `«${ruta}»: «modelos.${papel}» no es un papel válido (los que hay: ${PAPELES.join(", ")}); se descarta.`,
+                        severidad: "aviso",
+                    });
+                }
+                else if (typeof idModelo !== "string") {
+                    avisos.push({
+                        texto: `«${ruta}»: «modelos.${papel}» debe ser la cadena «proveedor/modelo»; se descarta.`,
+                        severidad: "aviso",
+                    });
+                }
+                else {
+                    modelos[papel] = idModelo;
+                }
+            }
+            config.modelos = modelos;
+            continue;
+        }
+        // El tope de la ventana de contexto que la tabla de `core/contextos.ts` no
+        // sabe: cada entrada es «proveedor/modelo» → tope en tokens. Se fija a mano
+        // porque el usuario sabe más de SU modelo (sobre todo del local) que la tabla.
+        if (clave === "contextos") {
+            if (!esObjeto(valor)) {
+                avisos.push({
+                    texto: `«${ruta}»: «contextos» debe ser un objeto «proveedor/modelo» → tope en tokens; se descarta.`,
+                    severidad: "aviso",
+                });
+                continue;
+            }
+            const contextos = {};
+            for (const id of Object.keys(valor)) {
+                const tope = valor[id];
+                if (typeof tope === "number" && Number.isInteger(tope) && tope > 0) {
+                    contextos[id] = tope;
+                }
+                else {
+                    avisos.push({
+                        texto: `«${ruta}»: «contextos.${id}» debe ser un número entero de tokens positivo; se descarta.`,
+                        severidad: "aviso",
+                    });
+                }
+            }
+            config.contextos = contextos;
+            continue;
+        }
+        if (clave === "ollama") {
+            // «ollama» como objeto es configuración; como cadena ya la cogió arriba el rechazo
+            // de proveedor-con-cadena. Por eso el orden del if importa.
+            if (!esObjeto(valor)) {
+                avisos.push({
+                    texto: `«${ruta}»: «ollama» debe ser un objeto con «baseUrl»; se descarta.`,
+                    severidad: "aviso",
+                });
+                continue;
+            }
+            const ollama = {};
+            const baseUrl = valor["baseUrl"];
+            if (baseUrl !== undefined) {
+                if (typeof baseUrl === "string") {
+                    ollama.baseUrl = baseUrl;
+                }
+                else {
+                    avisos.push({
+                        texto: `«${ruta}»: «ollama.baseUrl» debe ser una cadena; se descarta.`,
+                        severidad: "aviso",
+                    });
+                }
+            }
+            config.ollama = ollama;
+            continue;
+        }
+        avisos.push({
+            texto: `«${ruta}»: el campo «${clave}» no se reconoce; se descarta.`,
+            severidad: "aviso",
+        });
+    }
+    return { config, avisos };
+}
+/**
+ * Valida un `auth.json`. Las credenciales SOLO viven en la ruta global: en un proyecto
+ * se rechaza el fichero entero — no es una regla de formato, es de dónde puede vivir
+ * un secreto. El modo se comprueba al leerlo porque crearlo bien no basta.
+ */
+export function validarAuth(bruto, ruta, modo, procedencia) {
+    const avisos = [];
+    if (procedencia === "proyecto") {
+        return {
+            auth: {},
+            avisos: [
+                {
+                    texto: `«${ruta}»: auth.json solo se acepta en la ruta global (~/.xonecode/auth.json), nunca dentro de un proyecto; se ignora el fichero entero.`,
+                    severidad: "grave",
+                },
+            ],
+        };
+    }
+    if ((modo & 0o077) !== 0) {
+        avisos.push({
+            texto: `«${ruta}»: el fichero de credenciales es legible por otros usuarios (grupo y resto); ejecuta chmod 600 ${ruta}.`,
+            severidad: "grave",
+        });
+    }
+    if (!esObjeto(bruto)) {
+        avisos.push({
+            texto: `«${ruta}»: el JSON raíz debe ser un objeto; se ignora el fichero.`,
+            severidad: "aviso",
+        });
+        return { auth: {}, avisos };
+    }
+    const auth = {};
+    for (const clave of Object.keys(bruto)) {
+        const valor = bruto[clave];
+        if (!PROVEEDORES.includes(clave)) {
+            avisos.push({
+                texto: `«${ruta}»: «${clave}» no es un proveedor conocido (los que hay: ${PROVEEDORES.join(", ")}); se descarta.`,
+                severidad: "aviso",
+            });
+            continue;
+        }
+        // La forma que va a escribir la gente a mano: {"proveedor": "sk-…"}.
+        if (typeof valor === "string") {
+            auth[clave] = { key: valor };
+            continue;
+        }
+        if (esObjeto(valor)) {
+            const key = valor["key"];
+            if (typeof key === "string") {
+                const tipo = valor["type"];
+                auth[clave] =
+                    typeof tipo === "string" ? { key, type: tipo } : { key };
+                continue;
+            }
+        }
+        avisos.push({
+            texto: `«${ruta}»: la credencial de «${clave}» debe ser «{ "key": "…" }» o una cadena; se descarta.`,
+            severidad: "aviso",
+        });
+    }
+    return { auth, avisos };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/contextos.js

@@ -0,0 +1,56 @@
+/**
+ * El tope de la ventana de contexto de cada modelo, con toda la honestidad de
+ * la que es capaz una tabla.
+ *
+ * **Lo que NO hay aquí es tan deliberado como lo que hay:**
+ *
+ * - `ollama` no aparece a propósito. Cada modelo local trae el suyo (y a veces
+ *   lo recorta el `num_ctx` del Modelfile), así que cualquier tope sería
+ *   inventado — y un porcentaje calculado sobre un tope inventado no es un
+ *   indicador: es una mentira con forma de cifra.
+ * - Las familias de la tabla se emparejan por PREFIJO (`gpt-4o-mini` calza con
+ *   `gpt-4o`), porque los ids son `familia-variante-fecha`.
+ *
+ * Para lo que la tabla no sabe, está el override de `config.json`
+ * («contextos»: {«proveedor/modelo»: tope}): el usuario sabe más de SU modelo
+ * que esta tabla, y se lo cree.
+ */
+/** Familias conocidas por proveedor, emparejadas por prefijo del id del modelo. */
+const TOPES = {
+    anthropic: [["claude", 200_000]],
+    gemini: [["gemini", 1_000_000]],
+    openai: [
+        ["gpt-4.1", 1_000_000],
+        ["gpt-4o", 128_000],
+        ["gpt-4-turbo", 128_000],
+        ["gpt-4", 128_000],
+    ],
+};
+/**
+ * El tope de contexto de un modelo, o `undefined` si no se sabe.
+ *
+ * El override se mira ANTES que la tabla y va por id completo
+ * («proveedor/modelo»): un tope fijado a mano describe a ESE modelo, no a la
+ * familia.
+ */
+export function topeDeContexto(proveedor, modelo, overrides = {}) {
+    const porId = overrides[`${proveedor}/${modelo}`];
+    if (typeof porId === "number")
+        return porId;
+    return TOPES[proveedor]?.find(([prefijo]) => modelo.startsWith(prefijo))?.[1];
+}
+/**
+ * El tope con su ORIGEN, para `/config`: lo que el usuario fijó a mano (proyecto gana
+ * a global, igual que con los modelos), la tabla como último recurso — o nada, que es
+ * una respuesta válida y se distingue del cero.
+ */
+export function topeResuelto(proveedor, modelo, configs) {
+    const id = `${proveedor}/${modelo}`;
+    if (configs.proyecto?.[id] !== undefined)
+        return { tope: configs.proyecto[id], origen: "proyecto" };
+    if (configs.global?.[id] !== undefined)
+        return { tope: configs.global[id], origen: "global" };
+    const deTabla = topeDeContexto(proveedor, modelo);
+    return deTabla !== undefined ? { tope: deTabla, origen: "tabla" } : undefined;
+}
+//# sourceMappingURL=contextos.js.map

package/dist/core/contextos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextos.js","sourceRoot":"","sources":["../../src/core/contextos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,mFAAmF;AACnF,MAAM,KAAK,GAAuE;IAChF,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/B,MAAM,EAAE;QACN,CAAC,SAAS,EAAE,SAAS,CAAC;QACtB,CAAC,QAAQ,EAAE,OAAO,CAAC;QACnB,CAAC,aAAa,EAAE,OAAO,CAAC;QACxB,CAAC,OAAO,EAAE,OAAO,CAAC;KACnB;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAoB,EACpB,MAAc,EACd,YAAoC,EAAE;IAEtC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,OAAO,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,MAAc,EACd,OAA+E;IAE/E,MAAM,EAAE,GAAG,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACrG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC/F,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC"}

package/dist/core/deps.js

@@ -0,0 +1,51 @@
+import { esDoble, McpVacio, SkillsEnMemoria, StubVerifier, ModeloGuionizado, } from "./ports.js";
+import { PAPELES } from "./modelos.js";
+/** Todo dobles. La suite corre con esto, y `describe` lo canta entero. */
+export function depsOffline() {
+    return {
+        modelos: new ModeloGuionizado(),
+        skills: new SkillsEnMemoria(),
+        verifier: new StubVerifier(),
+        mcp: new McpVacio(),
+    };
+}
+/** Los puertos, en el orden en que se le cuentan al usuario. */
+const PUERTOS = [
+    { clave: "verifier", nombre: "verificador", gravedad: "grave" },
+    { clave: "modelos", nombre: "modelos", gravedad: "grave" },
+    { clave: "skills", nombre: "skills", gravedad: "aviso" },
+    { clave: "mcp", nombre: "MCP (proyecto remoto)", gravedad: "aviso" },
+];
+/**
+ * Qué hay montado, y qué de ello es de pega.
+ *
+ * Pura y sin efectos: no llama a ningún puerto, solo mira qué son. Por eso `xonecode
+ * describe` no necesita ni credenciales ni red.
+ *
+ * El verificador va PRIMERO y como `grave` por un motivo: un verificador de pega dice que
+ * todo está bien, así que es el doble que más daño hace pasando desapercibido.
+ */
+export function describir(deps) {
+    const lineas = ["--- qué hay montado ---"];
+    for (const { clave, nombre, gravedad } of PUERTOS) {
+        const doble = esDoble(deps[clave]);
+        const marca = doble ? (gravedad === "grave" ? "⚠ DE PEGA" : "· doble") : "✓ real";
+        lineas.push(`  ${marca}  ${nombre}`);
+    }
+    const desc = deps.modelos.descripcion();
+    lineas.push("--- modelos por papel ---");
+    for (const papel of PAPELES)
+        lineas.push(`  ${papel.padEnd(8)} ${desc[papel]}`);
+    const graves = PUERTOS.filter((p) => p.gravedad === "grave" && esDoble(deps[p.clave]));
+    if (graves.length > 0) {
+        lineas.push("");
+        lineas.push(`⚠  ${graves.length} pieza(s) de pega: lo que diga este agente NO está respaldado ` +
+            `por ${graves.map((g) => g.nombre).join(" ni ")}.`);
+    }
+    return lineas;
+}
+/** Para el aviso del final del turno: los nombres de los puertos caros que son dobles. */
+export function doblesGraves(deps) {
+    return PUERTOS.filter((p) => p.gravedad === "grave" && esDoble(deps[p.clave])).map((p) => p.nombre);
+}
+//# sourceMappingURL=deps.js.map

package/dist/core/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/core/deps.ts"],"names":[],"mappings":"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"}

package/dist/core/diff.js

@@ -0,0 +1,79 @@
+/**
+ * El diff de líneas para la aprobación: el ANTES contra el DESPUÉS de una escritura
+ * pendiente, como datos — quien pinta decide colores y presupuesto de líneas.
+ *
+ * Es PURO a propósito: quién aprueba y de dónde sale el antes y el después no son
+ * cosa de este módulo. El algoritmo es el LCS clásico por programación dinámica,
+ * con un GUARDIÁN de tamaño: dos ficheros de mil líneas serían un millón de celdas
+ * por el precio de un diff bonito, y el fallback (entero reescrito: todo quitado y
+ * todo añadido) sigue contando la verdad, solo que sin deduplicar lo que se mantiene.
+ */
+/** Por encima de este producto, ni LCS ni nada: fallback lineal. */
+const MAX_CELDAS = 250_000;
+function lineasDe(texto) {
+    const lineas = texto.split("\n");
+    // El salto final de un fichero normal no es una línea vacía.
+    if (lineas.length > 0 && lineas[lineas.length - 1] === "")
+        lineas.pop();
+    return lineas;
+}
+export function diffDeLineas(antes, despues) {
+    const a = lineasDe(antes);
+    const b = lineasDe(despues);
+    if (a.length * b.length > MAX_CELDAS) {
+        return [
+            ...a.map((texto) => ({ tipo: "quitado", texto })),
+            ...b.map((texto) => ({ tipo: "anadido", texto })),
+        ];
+    }
+    // dp[i][j] = LCS de a[0..i) y b[0..j)
+    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] + 1 : Math.max(dp[i - 1][j], dp[i][j - 1]);
+        }
+    }
+    // Se recorre hacia atrás y se da la vuelta; en el empate se come primero de `b`
+    // (añadido), para que al dar la vuelta el QUITADO quede delante del AÑADIDO —
+    // el orden en que los diffs se leen: qué se quita, qué se pone.
+    const salida = [];
+    let i = a.length;
+    let j = b.length;
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && a[i - 1] === b[j - 1]) {
+            salida.push({ tipo: "igual", texto: a[i - 1] });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            salida.push({ tipo: "anadido", texto: b[j - 1] });
+            j--;
+        }
+        else {
+            salida.push({ tipo: "quitado", texto: a[i - 1] });
+            i--;
+        }
+    }
+    return salida.reverse();
+}
+/**
+ * Solo las líneas que importan para decidir: los cambios y `contexto` líneas alrededor
+ * de cada uno. Las rachas largas de «igual» se recortan por VENTANAS solapadas (dos
+ * cambios cercanos comparten el contexto), no por trozos fijos.
+ */
+export function conContexto(d, contexto) {
+    const mantener = new Set();
+    d.forEach((l, idx) => {
+        if (l.tipo === "igual")
+            return;
+        for (let k = Math.max(0, idx - contexto); k <= Math.min(d.length - 1, idx + contexto); k++) {
+            mantener.add(k);
+        }
+    });
+    return d.filter((_, idx) => mantener.has(idx));
+}
+/** El techo de líneas del bloque de diff, con la cuenta honesta de lo que no cabe. */
+export function recortar(d, tope) {
+    return { lineas: d.slice(0, tope), recortadas: Math.max(0, d.length - tope) };
+}
+//# sourceMappingURL=diff.js.map

package/dist/core/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/core/diff.ts"],"names":[],"mappings":"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"}