@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/credenciales/servidor.js

@@ -0,0 +1,213 @@
+/**
+ * Servidor HTTP del broker de credenciales.
+ *
+ * No es un producto nuevo: es un MODO de `ada-cli serve` (ver
+ * `cli/serve-command.ts`). El gateway de oh-my-pi resuelve la credencial en el
+ * servidor y la inyecta para que el cliente nunca vea el token; aquí no hay
+ * proxy de peticiones a proveedores (fuera de alcance), así que `/v1/credential`
+ * SÍ entrega el secreto — es lo mínimo para que un cliente pueda llamar al
+ * proveedor sin tenerlo nunca en su disco. Lo que sí se copia sin rebajar:
+ *
+ * - **Fallar cerrado.** Sin bearer configurado, `iniciarServidorBroker` lanza
+ *   antes de abrir el socket de escucha. Un broker que arrancara sin auth
+ *   "por ahora" es exactamente el tipo de atajo que se queda para siempre.
+ * - **Comparación en tiempo constante del bearer**, para no dar una guía de
+ *   temporización a quien intente adivinarlo por fuerza bruta.
+ * - **Todo excepto `/v1/health` exige bearer.** La salud tiene que poder
+ *   contestar aunque el token esté mal configurado en quien pregunta — es lo
+ *   único que un balanceador o un `curl` de comprobación necesita sin secreto.
+ *
+ * Cada resolución de credencial y cada reporte de uso quedan en el libro de
+ * sesión (`core/audit/libro.ts`) — es la pieza que oh-my-pi no tiene: quién
+ * usó qué cuenta y cuándo, auditable.
+ */
+import { timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+export const DEFAULT_BROKER_BIND = "127.0.0.1:8765";
+function leerCuerpo(req) {
+    return new Promise((resolve, reject) => {
+        const trozos = [];
+        req.on("data", (t) => trozos.push(t));
+        req.on("end", () => resolve(Buffer.concat(trozos).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+function enviarJson(res, estado, cuerpo) {
+    const texto = JSON.stringify(cuerpo);
+    res.writeHead(estado, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(texto),
+    });
+    res.end(texto);
+}
+/** `true` si `host` no sale de la máquina — lo único que hace inofensivo el HTTP sin cifrar. */
+function esLoopback(host) {
+    return host === "127.0.0.1" || host === "localhost" || host === "::1" || host === "[::1]";
+}
+/**
+ * Compara el bearer en tiempo constante. `timingSafeEqual` exige buffers de
+ * igual longitud, así que una longitud distinta ya es "no coincide" sin pasar
+ * por la comparación — no hay atajo de timing ahí porque la longitud de un
+ * bearer típico no es secreta (va en la URL de configuración de cada cliente).
+ */
+function bearerValido(cabecera, token) {
+    if (!cabecera?.startsWith("Bearer "))
+        return false;
+    const recibido = Buffer.from(cabecera.slice("Bearer ".length));
+    const esperado = Buffer.from(token);
+    if (recibido.length !== esperado.length)
+        return false;
+    return timingSafeEqual(recibido, esperado);
+}
+/**
+ * Arranca el broker. Lanza SIN escuchar si no hay bearer — fallar cerrado, no
+ * "escuchar sin auth por ahora". Esto es lo que la puerta de verificación
+ * comprueba forzando el caso vacío y confirmando que no hay servidor.
+ */
+export async function iniciarServidorBroker(opciones) {
+    const token = opciones.token?.trim() ?? "";
+    if (token === "") {
+        throw new Error("El broker no arranca sin un bearer configurado (ADA_BROKER_TOKEN). " +
+            "Escuchar sin auth expondría las credenciales de todo el equipo a quien alcance el puerto.");
+    }
+    const { pool, libro, enfriamiento } = opciones;
+    const [host, puertoTexto] = (opciones.bind ?? DEFAULT_BROKER_BIND).split(":");
+    const puertoPedido = Number(puertoTexto);
+    // El bearer viaja en texto plano: HTTP, no HTTPS. En loopback eso es
+    // inofensivo (no sale de la máquina). En cuanto el bind apunta a una interfaz
+    // real —que es justo lo que hace falta para que el equipo lo alcance desde
+    // otro portátil, el caso de uso que motiva este módulo— el bearer y las
+    // credenciales que reparte cruzan la red sin cifrar: quien esnife ese
+    // segmento se lleva el token y, con él, cualquier credencial.
+    //
+    // Aquí SE FALLA CERRADO, y no es lo mismo que avisar. Un aviso por stderr
+    // compite con la señal de éxito («broker escuchando en 0.0.0.0:8765») y
+    // pierde: el operador lee que arrancó y sigue. Es un fallo que se lee como
+    // éxito, la familia de defectos que más nos ha costado en este repositorio.
+    //
+    // El despliegue legítimo —un proxy TLS terminando por delante de este mismo
+    // bind— sigue siendo posible: escribe `inseguroSinTls` una vez y queda en su
+    // fichero de configuración, que es auditable. Un aviso no queda en ninguna
+    // parte, y «te avisamos por stderr» no se sostiene delante de un auditor.
+    if (!esLoopback(host) && opciones.inseguroSinTls !== true) {
+        throw new Error(`El broker no arranca en ${host}: fuera de loopback el bearer y todas las credenciales que ` +
+            "reparte viajarían en HTTP sin cifrar, y cualquiera en esa red podría esnifarlos.\n\n" +
+            "  · Recomendado: déjalo en 127.0.0.1 y llega a él por un túnel (SSH, WireGuard) o por un\n" +
+            "    proxy TLS que termine delante.\n" +
+            "  · Si YA tienes ese proxy TLS delante de este mismo bind, pasa `inseguroSinTls: true`\n" +
+            "    (CLI: --inseguro-sin-tls) para confirmarlo de forma explícita.");
+    }
+    if (!esLoopback(host)) {
+        // Llegar aquí es haberlo pedido a conciencia. Se deja constancia igualmente:
+        // el que lo escribió no es siempre el que lee los registros seis meses después.
+        console.error(`AVISO: el broker escucha en ${host} sin TLS propio, por --inseguro-sin-tls. Solo es seguro si ` +
+            "hay un proxy TLS terminando delante de este bind.");
+    }
+    const manejar = async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://localhost");
+        if (req.method === "GET" && url.pathname === "/v1/health") {
+            enviarJson(res, 200, { ok: true });
+            return;
+        }
+        if (!bearerValido(req.headers.authorization, token)) {
+            enviarJson(res, 401, { error: "bearer-invalido" });
+            return;
+        }
+        if (req.method === "GET" && url.pathname === "/v1/snapshot") {
+            enviarJson(res, 200, { credenciales: pool.snapshot() });
+            return;
+        }
+        if (req.method === "POST" && url.pathname === "/v1/credential") {
+            let cuerpo;
+            try {
+                cuerpo = JSON.parse(await leerCuerpo(req));
+            }
+            catch {
+                enviarJson(res, 400, { error: "cuerpo-invalido" });
+                return;
+            }
+            const proveedor = cuerpo.proveedor;
+            if (!proveedor) {
+                enviarJson(res, 400, { error: "falta-proveedor" });
+                return;
+            }
+            const elegida = pool.elegir(proveedor, cuerpo.promptCacheKey);
+            await libro.anotar({
+                tipo: "credencial",
+                accion: "resuelta",
+                proveedor,
+                credencialId: elegida?.id ?? null,
+                resultado: elegida ? "ok" : "sin-credencial-activa",
+                cliente: cuerpo.cliente,
+            });
+            if (!elegida) {
+                // "No hay nada" (todas bloqueadas o proveedor desconocido), no "no he
+                // podido": por eso 404 con un motivo, no un 500.
+                enviarJson(res, 404, { error: "sin-credencial-activa", proveedor });
+                return;
+            }
+            enviarJson(res, 200, elegida);
+            return;
+        }
+        if (req.method === "POST" && url.pathname === "/v1/usage") {
+            let cuerpo;
+            try {
+                cuerpo = JSON.parse(await leerCuerpo(req));
+            }
+            catch {
+                enviarJson(res, 400, { error: "cuerpo-invalido" });
+                return;
+            }
+            if (!cuerpo.id) {
+                enviarJson(res, 400, { error: "falta-id" });
+                return;
+            }
+            const resultado = cuerpo.ok === true
+                ? { ok: true }
+                : { ok: false, estadoHttp: cuerpo.estadoHttp, mensaje: cuerpo.mensaje ?? "" };
+            const efecto = pool.marcarUso(cuerpo.id, resultado);
+            if (!efecto) {
+                enviarJson(res, 404, { error: "credencial-desconocida", id: cuerpo.id });
+                return;
+            }
+            // Un 429 con Retry-After enfrió la cuenta (no la bloquea: sigue siendo
+            // buena). La marca por HUELLA en el registro persistente, así el
+            // descanso sobrevive al reinicio del broker y ninguna clave toca disco.
+            if (efecto.clase === "limite-de-tasa" && enfriamiento && (cuerpo.retryTrasSegundos ?? 0) > 0) {
+                const huella = pool.huellaDe(cuerpo.id);
+                if (huella)
+                    enfriamiento.marcarEnfriada(huella, Date.now() + (cuerpo.retryTrasSegundos ?? 0) * 1000);
+            }
+            await libro.anotar({
+                tipo: "credencial",
+                accion: "uso",
+                proveedor: cuerpo.proveedor ?? "desconocido",
+                credencialId: cuerpo.id,
+                resultado: efecto.clase,
+            });
+            enviarJson(res, 200, efecto);
+            return;
+        }
+        enviarJson(res, 404, { error: "ruta-desconocida" });
+    };
+    const server = createServer((req, res) => {
+        manejar(req, res).catch((error) => {
+            enviarJson(res, 500, {
+                error: "fallo-interno",
+                mensaje: error instanceof Error ? error.message : String(error),
+            });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(puertoPedido, host, () => resolve());
+    });
+    const direccion = server.address();
+    const puerto = typeof direccion === "object" && direccion ? direccion.port : puertoPedido;
+    return {
+        url: `http://${host}:${puerto}`,
+        puerto,
+        cerrar: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+//# sourceMappingURL=servidor.js.map

package/dist/core/credenciales/servidor.js.map

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

package/dist/core/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAC9D,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAQ1D,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\nexport const THINKING_LEVEL_OPTIONS: readonly ThinkingLevel[] = [\n\t\"off\",\n\t\"minimal\",\n\t\"low\",\n\t\"medium\",\n\t\"high\",\n\t\"xhigh\",\n\t\"max\",\n];\n"]}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC;AAC9D,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAQ1D,CAAC"}

package/dist/core/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC/D,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;CACL,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\nexport const THINKING_LEVEL_OPTIONS: readonly ThinkingLevel[] = [\n\t\"off\",\n\t\"minimal\",\n\t\"low\",\n\t\"medium\",\n\t\"high\",\n\t\"xhigh\",\n\t\"max\",\n];\n"]}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC/D,KAAK;IACL,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;CACL,CAAC"}

package/dist/core/descubrimiento/comandos.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Comandos de barra que Claude Code ya tiene definidos en el proyecto:
+ * `.claude/commands/*.md`.
+ *
+ * Solo se listan — a diferencia de las skills, que sí se pasan a la sesión
+ * (ver `skills.ts`), un comando de barra ajeno no tiene un sitio propio en el
+ * sistema de comandos de Ada (`core/slash-commands.ts` es de upstream y su
+ * formato de prompt-templates no es el mismo). Listarlo con su origen ya
+ * ahorra la media hora de "¿qué comandos tenía este proyecto?" al cambiar de
+ * herramienta.
+ */
+export interface ComandoDescubierto {
+    origen: string;
+    /** Ruta relativa al proyecto. */
+    ruta: string;
+    /** Con `:` como separador de namespace, igual que hace Claude Code. */
+    nombre: string;
+    descripcion?: string;
+}
+export interface ResultadoDescubrimientoComandos {
+    comandos: ComandoDescubierto[];
+    /** Directorios mirados, existan o no. */
+    directoriosMirados: string[];
+    errores: Array<{
+        ruta: string;
+        motivo: string;
+    }>;
+}
+export declare function descubrirComandos(cwd: string): ResultadoDescubrimientoComandos;
+//# sourceMappingURL=comandos.d.ts.map

package/dist/core/descubrimiento/comandos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comandos.d.ts","sourceRoot":"","sources":["../../../src/core/descubrimiento/comandos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AA+BD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,+BAA+B,CAoC9E"}

package/dist/core/descubrimiento/comandos.js

@@ -0,0 +1,76 @@
+/**
+ * Comandos de barra que Claude Code ya tiene definidos en el proyecto:
+ * `.claude/commands/*.md`.
+ *
+ * Solo se listan — a diferencia de las skills, que sí se pasan a la sesión
+ * (ver `skills.ts`), un comando de barra ajeno no tiene un sitio propio en el
+ * sistema de comandos de Ada (`core/slash-commands.ts` es de upstream y su
+ * formato de prompt-templates no es el mismo). Listarlo con su origen ya
+ * ahorra la media hora de "¿qué comandos tenía este proyecto?" al cambiar de
+ * herramienta.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { parseFrontmatter } from "../../utils/frontmatter.js";
+const ORIGEN = "Claude Code";
+const DIRECTORIO = ".claude/commands";
+/** Los .md de un directorio, recursivo, en orden estable. */
+function ficherosMd(dir, salida) {
+    let entradas;
+    try {
+        entradas = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // no existe o no se puede listar: "no hay", no es un fallo
+    }
+    for (const entrada of [...entradas].sort((a, b) => a.name.localeCompare(b.name))) {
+        const completa = join(dir, entrada.name);
+        if (entrada.isDirectory()) {
+            ficherosMd(completa, salida);
+        }
+        else if (entrada.isFile() && entrada.name.endsWith(".md")) {
+            salida.push(completa);
+        }
+    }
+}
+function primeraLinea(cuerpo) {
+    const linea = cuerpo
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0);
+    return linea ? linea.slice(0, 100) : undefined;
+}
+export function descubrirComandos(cwd) {
+    const comandos = [];
+    const errores = [];
+    const dir = join(cwd, DIRECTORIO);
+    const rutas = [];
+    ficherosMd(dir, rutas);
+    for (const ruta of rutas) {
+        const relativa = relative(cwd, ruta).split(sep).join("/");
+        let contenido;
+        try {
+            contenido = readFileSync(ruta, "utf-8");
+        }
+        catch (error) {
+            errores.push({ ruta: relativa, motivo: error instanceof Error ? error.message : "no se pudo leer" });
+            continue;
+        }
+        let descripcion;
+        try {
+            const { frontmatter, body } = parseFrontmatter(contenido);
+            descripcion = typeof frontmatter.description === "string" ? frontmatter.description : primeraLinea(body);
+        }
+        catch (error) {
+            errores.push({
+                ruta: relativa,
+                motivo: `frontmatter inválido: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            descripcion = primeraLinea(contenido);
+        }
+        const nombre = relative(dir, ruta).replace(/\.md$/, "").split(sep).join(":");
+        comandos.push({ origen: ORIGEN, ruta: relativa, nombre, descripcion });
+    }
+    return { comandos, directoriosMirados: [DIRECTORIO], errores };
+}
+//# sourceMappingURL=comandos.js.map

package/dist/core/descubrimiento/comandos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comandos.js","sourceRoot":"","sources":["../../../src/core/descubrimiento/comandos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAkB9D,MAAM,MAAM,GAAG,aAAa,CAAC;AAC7B,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,6DAA6D;AAC7D,SAAS,UAAU,CAAC,GAAW,EAAE,MAAgB;IAChD,IAAI,QAAoC,CAAC;IACzC,IAAI,CAAC;QACJ,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,2DAA2D;IACpE,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3B,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM;SAClB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC5C,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAElC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE1D,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACJ,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;YACrG,SAAS;QACV,CAAC;QAED,IAAI,WAA+B,CAAC;QACpC,IAAI,CAAC;YACJ,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAA4B,SAAS,CAAC,CAAC;YACrF,WAAW,GAAG,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC1G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACzF,CAAC,CAAC;YACH,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/dist/core/descubrimiento/mcp.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Servidores MCP que otras herramientas ya han configurado en este proyecto
+ * (o para este usuario), leídos de sus propios ficheros de config.
+ *
+ * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.
+ * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un
+ * proceso arbitrario que otra herramienta dejó apuntado en un JSON es
+ * superficie de ejecución que no se abre por defecto. Así que aquí no hay
+ * "activar": hay "encontrado y soportado" frente a "encontrado y no
+ * soportado, y por qué".
+ *
+ * Cada fichero mirado se anota exista o no: es lo único que permite decir
+ * DÓNDE se ha buscado en un proyecto vacío, en vez de un "nada" mudo.
+ */
+export type NivelConfigMcp = "usuario" | "proyecto";
+export interface ServidorMcpDescubierto {
+    /** De qué herramienta viene la config. */
+    origen: string;
+    /** Ruta absoluta al fichero de config. */
+    ruta: string;
+    nivel: NivelConfigMcp;
+    nombre: string;
+    transporte: "http" | "stdio";
+    url?: string;
+    comando?: string;
+    /** Argumentos del comando stdio (para comparar conexiones entre sí). */
+    args?: string[];
+    /** true solo si Ada puede hablar con él de verdad (HTTP y no desactivado). */
+    soportado: boolean;
+    /** Por qué no está soportado. Ausente cuando `soportado` es true. */
+    motivo?: string;
+    /**
+     * true si otra conexión de mayor precedencia (proyecto > usuario) es
+     * conectivamente igual (misma URL o mismo command+args normalizados) y la
+     * tapa. Sigue listándose: el shadowing es visible, nunca silencioso.
+     */
+    _shadowed?: boolean;
+    /** Quién la tapa. Presente solo cuando `_shadowed` es true. */
+    tapadaPor?: string;
+}
+export interface ResultadoDescubrimientoMcp {
+    servidores: ServidorMcpDescubierto[];
+    /** Todos los ficheros mirados, existan o no. */
+    ficherosMirados: string[];
+    /** Ficheros o entradas que existían pero no se pudieron leer/interpretar. */
+    errores: Array<{
+        ruta: string;
+        motivo: string;
+    }>;
+}
+export declare function descubrirServidoresMcp(cwd: string, home?: string): ResultadoDescubrimientoMcp;
+/** Higiene B06: discovery con timeout — el handler compite vs timer; si llega a tiempo gana, si no fallback. */
+export declare function descubrirServidoresMcpConTimeout(cwd: string, timeoutMs: number, fallback: ResultadoDescubrimientoMcp, home?: string): Promise<ResultadoDescubrimientoMcp>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/core/descubrimiento/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/core/descubrimiento/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACtC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IAC1C,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,gDAAgD;IAChD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAqDD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,0BAA0B,CA4GxG;AAED,gHAAgH;AAChH,wBAAsB,gCAAgC,CACrD,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,0BAA0B,EACpC,IAAI,GAAE,MAAkB,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAGrC"}

package/dist/core/descubrimiento/mcp.js

@@ -0,0 +1,162 @@
+/**
+ * Servidores MCP que otras herramientas ya han configurado en este proyecto
+ * (o para este usuario), leídos de sus propios ficheros de config.
+ *
+ * La decisión que no es obvia: un servidor `stdio` se LISTA, nunca se lanza.
+ * `core/mcp/client.ts` solo habla Streamable HTTP a propósito — lanzar un
+ * proceso arbitrario que otra herramienta dejó apuntado en un JSON es
+ * superficie de ejecución que no se abre por defecto. Así que aquí no hay
+ * "activar": hay "encontrado y soportado" frente a "encontrado y no
+ * soportado, y por qué".
+ *
+ * Cada fichero mirado se anota exista o no: es lo único que permite decir
+ * DÓNDE se ha buscado en un proyecto vacío, en vez de un "nada" mudo.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { dedupFirstWins } from "../capability/index.js";
+import { raceHandlerWithTimeout } from "../higiene/race-handler.js";
+/**
+ * Dónde mira cada herramienta, tomado de sus propios adaptadores
+ * (oh-my-pi: claude.ts, cursor.ts, vscode.ts, gemini.ts, mcp-json.ts).
+ *
+ * `.claude/mcp.json` NO es un fichero real de Claude Code (fue una feature
+ * request rechazada, anthropics/claude-code#5350) — se quitó de aquí porque
+ * "mirado en" no puede incluir un sitio que la herramienta real nunca escribe.
+ */
+const FUENTES = [
+    { origen: "MCP (raíz del proyecto)", relativa: ".mcp.json", base: "proyecto", formato: "plano" },
+    { origen: "Cursor", relativa: ".cursor/mcp.json", base: "proyecto", formato: "plano" },
+    { origen: "VS Code", relativa: ".vscode/mcp.json", base: "proyecto", formato: "vscode" },
+    { origen: "Gemini CLI", relativa: ".gemini/settings.json", base: "proyecto", formato: "plano" },
+    { origen: "Claude Code", relativa: ".claude.json", base: "usuario", formato: "plano" },
+    { origen: "Claude Code (proyecto)", relativa: ".claude.json", base: "usuario", formato: "claude-proyecto" },
+    { origen: "Cursor", relativa: ".cursor/mcp.json", base: "usuario", formato: "plano" },
+];
+function serversDe(json, formato, cwd) {
+    if (!json || typeof json !== "object")
+        return null;
+    if (formato === "claude-proyecto") {
+        const projects = json.projects;
+        if (!projects || typeof projects !== "object")
+            return null;
+        const clave = resolve(cwd);
+        const proyecto = projects[clave] ?? projects[cwd];
+        if (!proyecto || typeof proyecto !== "object")
+            return null;
+        const servers = proyecto.mcpServers;
+        return servers && typeof servers === "object" ? servers : null;
+    }
+    const clave = formato === "vscode" ? "servers" : "mcpServers";
+    const servers = json[clave];
+    return servers && typeof servers === "object" ? servers : null;
+}
+export function descubrirServidoresMcp(cwd, home = homedir()) {
+    const servidores = [];
+    const ficherosMirados = [];
+    const errores = [];
+    for (const fuente of FUENTES) {
+        const absoluta = join(fuente.base === "usuario" ? home : cwd, fuente.relativa);
+        // Un mismo fichero puede aparecer en dos fuentes (p.ej. `.claude.json`
+        // para el scope de usuario y para el de proyecto): se mira una vez, se
+        // anota una vez.
+        if (!ficherosMirados.includes(absoluta))
+            ficherosMirados.push(absoluta);
+        if (!existsSync(absoluta))
+            continue;
+        let contenido;
+        try {
+            contenido = readFileSync(absoluta, "utf-8");
+        }
+        catch (error) {
+            errores.push({ ruta: absoluta, motivo: error instanceof Error ? error.message : "no se pudo leer" });
+            continue;
+        }
+        let json;
+        try {
+            json = JSON.parse(contenido);
+        }
+        catch {
+            errores.push({ ruta: absoluta, motivo: "JSON inválido" });
+            continue;
+        }
+        const servers = serversDe(json, fuente.formato, cwd);
+        // Fichero válido sin mcpServers: no hay nada que listar, no es un fallo.
+        if (!servers)
+            continue;
+        for (const [nombre, raw] of Object.entries(servers)) {
+            if (!raw || typeof raw !== "object") {
+                errores.push({ ruta: absoluta, motivo: `servidor '${nombre}': configuración inválida` });
+                continue;
+            }
+            const config = raw;
+            // Gemini CLI usa `httpUrl` (no `url`) para transporte HTTP — ver
+            // docs/tools/mcp-server.md de google-gemini/gemini-cli.
+            const url = typeof config.url === "string"
+                ? config.url
+                : typeof config.httpUrl === "string"
+                    ? config.httpUrl
+                    : undefined;
+            const comando = typeof config.command === "string" ? config.command : undefined;
+            const args = Array.isArray(config.args)
+                ? config.args.filter((a) => typeof a === "string")
+                : undefined;
+            if (!url && !comando) {
+                errores.push({ ruta: absoluta, motivo: `servidor '${nombre}': sin 'url' ni 'command'` });
+                continue;
+            }
+            const transporte = url ? "http" : "stdio";
+            const desactivado = config.enabled === false;
+            const soportado = transporte === "http" && !desactivado;
+            const motivo = desactivado
+                ? "desactivado en su propia configuración (enabled: false)"
+                : transporte === "stdio"
+                    ? "servidor stdio: el cliente MCP de Ada solo habla HTTP a propósito (core/mcp/client.ts)"
+                    : undefined;
+            servidores.push({
+                origen: fuente.origen,
+                ruta: absoluta,
+                // `claude-proyecto` vive físicamente en el fichero de usuario, pero
+                // es config de ESTE proyecto — el nivel que importa para quien lee
+                // la salida es el lógico, no dónde Claude Code decidió guardarlo.
+                nivel: fuente.formato === "claude-proyecto" ? "proyecto" : fuente.base,
+                nombre,
+                transporte,
+                url,
+                comando,
+                args,
+                soportado,
+                motivo,
+            });
+        }
+    }
+    // Dedup conectivo reutilizando la máquina del capability registry
+    // (first-wins + `_shadowed`). FUENTES ya viene ordenada proyecto antes que
+    // usuario, así que first-wins == precedencia proyecto > usuario.
+    const claveConexion = (s) => s.transporte === "http"
+        ? `http:${(s.url ?? "").trim().replace(/\/+$/, "").toLowerCase()}`
+        : `stdio:${[s.comando ?? "", ...(s.args ?? [])].join(" ").trim().toLowerCase()}`;
+    const ganadorPorClave = new Map();
+    for (const s of servidores) {
+        const clave = claveConexion(s);
+        if (!ganadorPorClave.has(clave))
+            ganadorPorClave.set(clave, s);
+    }
+    dedupFirstWins(servidores, claveConexion);
+    for (const s of servidores) {
+        if (!s._shadowed || s.tapadaPor)
+            continue;
+        const ganador = ganadorPorClave.get(claveConexion(s));
+        s.tapadaPor = ganador
+            ? `${ganador.nivel}: ${ganador.origen} '${ganador.nombre}' (${ganador.ruta})`
+            : "otra conexión equivalente de mayor precedencia";
+    }
+    return { servidores, ficherosMirados, errores };
+}
+/** Higiene B06: discovery con timeout — el handler compite vs timer; si llega a tiempo gana, si no fallback. */
+export async function descubrirServidoresMcpConTimeout(cwd, timeoutMs, fallback, home = homedir()) {
+    const handler = Promise.resolve(descubrirServidoresMcp(cwd, home));
+    return raceHandlerWithTimeout(handler, timeoutMs, fallback);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/core/descubrimiento/mcp.js.map

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