@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/marketplace/doctor.js

@@ -0,0 +1,155 @@
+/**
+ * CLI-08 — `plugin doctor`: diagnóstico de un plugin instalado.
+ *
+ * Verifica: package.json parseable, entry (`main`/`bin`) existe en disco,
+ * dependencias resueltas (node_modules/<dep> presente), features declaradas
+ * vs activas y conflictos de versión con el catálogo. `--fix`
+ * (`aplicarCorrecciones`) solo aplica correcciones SEGURAS y únicamente con
+ * confirmación explícita (`confirmado: true`); nunca es destructivo.
+ */
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { buscarEnCatalogo } from "./catalogo.js";
+import { cargarFeatures } from "./features.js";
+function leerPaqueteJson(ruta) {
+    try {
+        return { paquete: JSON.parse(readFileSync(join(ruta, "package.json"), "utf-8")) };
+    }
+    catch (error) {
+        return {
+            error: {
+                tipo: "package-json-ilegible",
+                detalle: error instanceof Error ? error.message : String(error),
+                reparable: true,
+            },
+        };
+    }
+}
+function entryDelPaquete(paquete) {
+    if (typeof paquete.main === "string" && paquete.main.length > 0)
+        return paquete.main;
+    if (typeof paquete.bin === "string")
+        return paquete.bin;
+    if (typeof paquete.bin === "object" && paquete.bin !== null) {
+        const primero = Object.values(paquete.bin)[0];
+        if (typeof primero === "string")
+            return primero;
+    }
+    return undefined;
+}
+/** Localiza el plugin instalado (scope proyecto tiene precedencia sobre usuario). */
+function localizar(motor, nombre) {
+    for (const scope of ["project", "user"]) {
+        const ruta = motor.getInstalledPath(nombre, scope);
+        if (ruta && existsSync(ruta))
+            return { ruta, scope };
+    }
+    return undefined;
+}
+export function diagnosticoPlugin(nombre, dependencias) {
+    const diagnostico = {
+        plugin: nombre,
+        instalado: false,
+        problemas: [],
+        featuresDeclaradas: [],
+        featuresActivas: [],
+        conflictos: [],
+        sano: false,
+    };
+    const entrada = dependencias.catalogo?.estado === "cargado"
+        ? buscarEnCatalogo(dependencias.catalogo, nombre)
+        : undefined;
+    diagnostico.featuresDeclaradas = entrada?.features ?? [];
+    const localizado = localizar(dependencias.motor, nombre);
+    if (!localizado) {
+        diagnostico.problemas.push({
+            tipo: "entry-inexistente",
+            detalle: `${nombre} no está instalado`,
+            reparable: false,
+        });
+        diagnostico.sano = false;
+        return diagnostico;
+    }
+    diagnostico.instalado = true;
+    diagnostico.scope = localizado.scope;
+    diagnostico.rutaInstalada = localizado.ruta;
+    let paquete;
+    const leido = leerPaqueteJson(localizado.ruta);
+    if ("error" in leido) {
+        diagnostico.problemas.push(leido.error);
+    }
+    else {
+        paquete = leido.paquete;
+        const entry = entryDelPaquete(paquete);
+        if (entry && !existsSync(join(localizado.ruta, entry))) {
+            diagnostico.problemas.push({
+                tipo: "entry-inexistente",
+                detalle: `entry '${entry}' no existe en ${localizado.ruta}`,
+                reparable: true,
+            });
+        }
+        for (const dependencia of Object.keys(paquete.dependencies ?? {})) {
+            if (!existsSync(join(localizado.ruta, "node_modules", dependencia))) {
+                diagnostico.problemas.push({
+                    tipo: "deps-sin-resolver",
+                    detalle: `dependencia '${dependencia}' sin resolver`,
+                    reparable: true,
+                });
+            }
+        }
+    }
+    if (entrada && paquete?.version && entrada.version && entrada.version !== paquete.version) {
+        diagnostico.conflictos.push(`instalado ${paquete.version} != catálogo ${entrada.version}`);
+        diagnostico.problemas.push({
+            tipo: "version-en-conflicto",
+            detalle: `versión instalada ${paquete.version} difiere del catálogo (${entrada.version})`,
+            reparable: true,
+        });
+    }
+    const almacen = dependencias.features ?? cargarFeatures(dependencias.featuresRuta ?? "");
+    diagnostico.featuresActivas = Object.entries(almacen[nombre] ?? {})
+        .filter(([, activa]) => activa)
+        .map(([feature]) => feature);
+    diagnostico.sano = diagnostico.problemas.length === 0;
+    return diagnostico;
+}
+/**
+ * Aplica correcciones seguras. SOLO ejecuta algo si `confirmado` es true
+ * (equivalente a `--fix` con confirmación del usuario); sin confirmación
+ * devuelve las acciones propuestas sin tocar nada.
+ */
+export async function aplicarCorrecciones(nombre, diagnostico, opciones) {
+    const propuestas = [];
+    const aplicadas = [];
+    const tipos = new Set(diagnostico.problemas.filter((p) => p.reparable).map((p) => p.tipo));
+    if (tipos.has("entry-inexistente") || tipos.has("deps-sin-resolver") || tipos.has("package-json-ilegible"))
+        propuestas.push("reinstalar");
+    if (diagnostico.rutaInstalada && existsSync(join(diagnostico.rutaInstalada, "node_modules", ".cache")))
+        propuestas.push("limpiar-cache");
+    if (!opciones.confirmado || !diagnostico.instalado) {
+        return { aplicadas, propuestas };
+    }
+    const scope = opciones.scope ?? diagnostico.scope ?? "user";
+    for (const accion of propuestas) {
+        if (accion === "reinstalar") {
+            try {
+                await opciones.motor.installAndPersist(nombre, { local: scope === "project" });
+                aplicadas.push({ accion, ok: true, mensaje: `${nombre} reinstalado (entry/deps reparados)` });
+            }
+            catch (error) {
+                aplicadas.push({ accion, ok: false, mensaje: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        else if (accion === "limpiar-cache" && diagnostico.rutaInstalada) {
+            try {
+                rmSync(join(diagnostico.rutaInstalada, "node_modules", ".cache"), { recursive: true, force: true });
+                aplicadas.push({ accion, ok: true, mensaje: "caché limpiada" });
+            }
+            catch (error) {
+                aplicadas.push({ accion, ok: false, mensaje: error instanceof Error ? error.message : String(error) });
+            }
+        }
+    }
+    return { aplicadas, propuestas };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/marketplace/doctor.js.map

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

package/dist/core/marketplace/features.d.ts

@@ -0,0 +1,22 @@
+import { type Catalogo } from "./catalogo.ts";
+export interface AlmacenFeatures {
+    [plugin: string]: Record<string, boolean>;
+}
+export type ResultadoFeature = {
+    ok: boolean;
+    mensaje: string;
+};
+export declare function rutaFeatures(dirConfig?: string): string;
+export declare function cargarFeatures(ruta: string): AlmacenFeatures;
+export declare function guardarFeatures(almacen: AlmacenFeatures, ruta: string): void;
+export declare function activarFeature(plugin: string, feature: string, opciones: {
+    ruta: string;
+    catalogo?: Catalogo;
+}): ResultadoFeature;
+export declare function desactivarFeature(plugin: string, feature: string, opciones: {
+    ruta: string;
+    catalogo?: Catalogo;
+}): ResultadoFeature;
+/** Devuelve las features activadas (true) de un plugin. */
+export declare function featuresActivas(plugin: string, ruta: string): string[];
+//# sourceMappingURL=features.d.ts.map

package/dist/core/marketplace/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/core/marketplace/features.ts"],"names":[],"mappings":"AASA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC/B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAkB5D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5E;AAqBD,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC7C,gBAAgB,CAElB;AAED,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC7C,gBAAgB,CAElB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtE"}

package/dist/core/marketplace/features.js

@@ -0,0 +1,70 @@
+/**
+ * B03 — Features on/off por plugin, persistido en
+ * `${configDir}/plugin-features.json`. Activar exige que el plugin declare la
+ * feature en su entrada de catálogo.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CONFIG_DIR_NAME } from "../../config.js";
+import { buscarEnCatalogo } from "./catalogo.js";
+export function rutaFeatures(dirConfig) {
+    return join(dirConfig ?? process.env.ADA_CONFIG_DIR ?? join(process.env.HOME || homedir(), CONFIG_DIR_NAME), "plugin-features.json");
+}
+export function cargarFeatures(ruta) {
+    if (!existsSync(ruta))
+        return {};
+    try {
+        const crudo = JSON.parse(readFileSync(ruta, "utf-8"));
+        if (typeof crudo !== "object" || crudo === null)
+            return {};
+        const almacen = {};
+        for (const [plugin, features] of Object.entries(crudo)) {
+            if (typeof features !== "object" || features === null)
+                continue;
+            const validas = {};
+            for (const [feature, activa] of Object.entries(features)) {
+                if (typeof activa === "boolean")
+                    validas[feature] = activa;
+            }
+            almacen[plugin] = validas;
+        }
+        return almacen;
+    }
+    catch {
+        return {};
+    }
+}
+export function guardarFeatures(almacen, ruta) {
+    mkdirSync(join(ruta, ".."), { recursive: true });
+    writeFileSync(ruta, `${JSON.stringify(almacen, null, "\t")}\n`, "utf-8");
+}
+function cambiar(plugin, feature, valor, opciones) {
+    const catalogoValido = opciones.catalogo?.estado === "cargado" ? opciones.catalogo : undefined;
+    const entrada = catalogoValido ? buscarEnCatalogo(opciones.catalogo, plugin) : undefined;
+    if (catalogoValido && entrada && !entrada.features.includes(feature)) {
+        return { ok: false, mensaje: `el plugin ${plugin} no declara la feature '${feature}'` };
+    }
+    const almacen = cargarFeatures(opciones.ruta);
+    const delPlugin = almacen[plugin] ?? {};
+    delPlugin[feature] = valor;
+    almacen[plugin] = delPlugin;
+    guardarFeatures(almacen, opciones.ruta);
+    return { ok: true, mensaje: `${plugin}.${feature} ${valor ? "activada" : "desactivada"}` };
+}
+export function activarFeature(plugin, feature, opciones) {
+    return cambiar(plugin, feature, true, opciones);
+}
+export function desactivarFeature(plugin, feature, opciones) {
+    return cambiar(plugin, feature, false, opciones);
+}
+/** Devuelve las features activadas (true) de un plugin. */
+export function featuresActivas(plugin, ruta) {
+    const delPlugin = cargarFeatures(ruta)[plugin];
+    if (!delPlugin)
+        return [];
+    return Object.entries(delPlugin)
+        .filter(([, activa]) => activa)
+        .map(([feature]) => feature);
+}
+//# sourceMappingURL=features.js.map

package/dist/core/marketplace/features.js.map

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

package/dist/core/marketplace/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * B03 + CLI-08 — Marketplace de plugins de Ada.
+ *
+ * Módulos:
+ * - `catalogo.ts`: catálogo (~/.ada/marketplace.json + fetch remoto opcional
+ *   vía ADA_MARKETPLACE_URL), tres estados: cargado / vacío / inaccesible.
+ * - `instalar.ts`: instalar/actualizar/eliminar sobre el package-manager
+ *   existente (src/core/package-manager.ts) con idempotencia informada.
+ * - `doctor.ts`: diagnosticoPlugin() + aplicarCorrecciones() (--fix seguro,
+ *   nunca destructivo sin confirmación).
+ * - `features.ts`: features on/off por plugin (~/.ada/plugin-features.json)
+ *   validadas contra las declaradas en el catálogo.
+ *
+ * Wiring CLI (patrón C01/D07 — API expuesta, subcommand documentado):
+ * los hints de src/cli/guardrails.ts (`marketplace`, `upgrade`, `enable`,
+ * `disable`, `extensions`) apuntan a estas funciones. Para añadir el
+ * subcommand real en main.ts (cuando toque hunk propio):
+ *
+ * 	plugin marketplace list   → await cargarCatalogo(); render por estado.
+ * 	plugin install <n>        → instalar(n, { motor, scope, catalogo }).
+ * 	plugin upgrade [n]        → actualizar(n, { motor }).
+ * 	plugin uninstall <n>      → eliminar(n, { motor, scope }).
+ * 	plugin enable <p> <f>     → activarFeature(p, f, { ruta: rutaFeatures(), catalogo }).
+ * 	plugin doctor <p> --fix   → diagnosticoPlugin(p, deps); aplicarCorrecciones(..., { confirmado: flags.fix }).
+ *
+ * donde `motor` es `new DefaultPackageManager({ cwd, agentDir, settingsManager })`
+ * (ver src/cli/startup-ui.ts:75 para el patrón de construcción).
+ */
+export { buscarEnCatalogo, type Catalogo, cargarCatalogo, type EntradaCatalogo, type OrigenPlugin, rutaCatalogo, } from "./catalogo.ts";
+export { type AccionCorreccion, aplicarCorrecciones, type Diagnostico, diagnosticoPlugin, type Problema, type TipoProblema, } from "./doctor.ts";
+export { type AlmacenFeatures, activarFeature, cargarFeatures, desactivarFeature, featuresActivas, guardarFeatures, type ResultadoFeature, rutaFeatures, } from "./features.ts";
+export { actualizar, eliminar, instalar, type MotorPaquetes, type ResultadoOperacion, type ScopePlugin, } from "./instalar.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/marketplace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/marketplace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACN,gBAAgB,EAChB,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,eAAe,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,KAAK,gBAAgB,EACrB,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GAChB,MAAM,eAAe,CAAC"}

package/dist/core/marketplace/index.js

@@ -0,0 +1,33 @@
+/**
+ * B03 + CLI-08 — Marketplace de plugins de Ada.
+ *
+ * Módulos:
+ * - `catalogo.ts`: catálogo (~/.ada/marketplace.json + fetch remoto opcional
+ *   vía ADA_MARKETPLACE_URL), tres estados: cargado / vacío / inaccesible.
+ * - `instalar.ts`: instalar/actualizar/eliminar sobre el package-manager
+ *   existente (src/core/package-manager.ts) con idempotencia informada.
+ * - `doctor.ts`: diagnosticoPlugin() + aplicarCorrecciones() (--fix seguro,
+ *   nunca destructivo sin confirmación).
+ * - `features.ts`: features on/off por plugin (~/.ada/plugin-features.json)
+ *   validadas contra las declaradas en el catálogo.
+ *
+ * Wiring CLI (patrón C01/D07 — API expuesta, subcommand documentado):
+ * los hints de src/cli/guardrails.ts (`marketplace`, `upgrade`, `enable`,
+ * `disable`, `extensions`) apuntan a estas funciones. Para añadir el
+ * subcommand real en main.ts (cuando toque hunk propio):
+ *
+ * 	plugin marketplace list   → await cargarCatalogo(); render por estado.
+ * 	plugin install <n>        → instalar(n, { motor, scope, catalogo }).
+ * 	plugin upgrade [n]        → actualizar(n, { motor }).
+ * 	plugin uninstall <n>      → eliminar(n, { motor, scope }).
+ * 	plugin enable <p> <f>     → activarFeature(p, f, { ruta: rutaFeatures(), catalogo }).
+ * 	plugin doctor <p> --fix   → diagnosticoPlugin(p, deps); aplicarCorrecciones(..., { confirmado: flags.fix }).
+ *
+ * donde `motor` es `new DefaultPackageManager({ cwd, agentDir, settingsManager })`
+ * (ver src/cli/startup-ui.ts:75 para el patrón de construcción).
+ */
+export { buscarEnCatalogo, cargarCatalogo, rutaCatalogo, } from "./catalogo.js";
+export { aplicarCorrecciones, diagnosticoPlugin, } from "./doctor.js";
+export { activarFeature, cargarFeatures, desactivarFeature, featuresActivas, guardarFeatures, rutaFeatures, } from "./features.js";
+export { actualizar, eliminar, instalar, } from "./instalar.js";
+//# sourceMappingURL=index.js.map

package/dist/core/marketplace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/marketplace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACN,gBAAgB,EAEhB,cAAc,EAGd,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAEN,mBAAmB,EAEnB,iBAAiB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEN,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EAEf,YAAY,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,UAAU,EACV,QAAQ,EACR,QAAQ,GAIR,MAAM,eAAe,CAAC"}

package/dist/core/marketplace/instalar.d.ts

@@ -0,0 +1,27 @@
+/**
+ * B03/CLI-08 — Instalación de plugins sobre el package-manager existente
+ * (`src/core/package-manager.ts`, CRUD npm/git/local). Sin CRUD nuevo: este
+ * módulo añade idempotencia informada y scope explícito user/project.
+ */
+import type { PackageManager } from "../package-manager.ts";
+import { type Catalogo } from "./catalogo.ts";
+export type MotorPaquetes = Pick<PackageManager, "installAndPersist" | "removeAndPersist" | "listConfiguredPackages" | "update" | "getInstalledPath">;
+export type ScopePlugin = "user" | "project";
+export type ResultadoOperacion = {
+    accion: "instalado" | "ya-instalado" | "eliminado" | "no-instalado" | "actualizado" | "error";
+    mensaje: string;
+};
+/** Instala `nombre` en el scope dado. Instalar lo ya instalado es no-op informado. */
+export declare function instalar(nombre: string, opciones: {
+    motor: MotorPaquetes;
+    scope: ScopePlugin;
+    catalogo?: Catalogo;
+}): Promise<ResultadoOperacion>;
+export declare function actualizar(nombre: string, opciones: {
+    motor: MotorPaquetes;
+}): Promise<ResultadoOperacion>;
+export declare function eliminar(nombre: string, opciones: {
+    motor: MotorPaquetes;
+    scope: ScopePlugin;
+}): Promise<ResultadoOperacion>;
+//# sourceMappingURL=instalar.d.ts.map

package/dist/core/marketplace/instalar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instalar.d.ts","sourceRoot":"","sources":["../../../src/core/marketplace/instalar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAoB,KAAK,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,IAAI,CAC/B,cAAc,EACd,mBAAmB,GAAG,kBAAkB,GAAG,wBAAwB,GAAG,QAAQ,GAAG,kBAAkB,CACnG,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,sFAAsF;AACtF,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GACzE,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAUhH;AAED,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACpD,OAAO,CAAC,kBAAkB,CAAC,CAU7B"}

package/dist/core/marketplace/instalar.js

@@ -0,0 +1,50 @@
+import { buscarEnCatalogo } from "./catalogo.js";
+function resolverFuente(nombre, catalogo) {
+    const entrada = buscarEnCatalogo(catalogo ?? { estado: "vacio", fuente: "" }, nombre);
+    return { fuente: entrada?.fuente ?? nombre, entrada };
+}
+function estaInstalado(motor, nombre) {
+    return motor
+        .listConfiguredPackages()
+        .some((paquete) => paquete.source === nombre || paquete.source.startsWith(`${nombre}@`));
+}
+/** Instala `nombre` en el scope dado. Instalar lo ya instalado es no-op informado. */
+export async function instalar(nombre, opciones) {
+    if (estaInstalado(opciones.motor, nombre)) {
+        return { accion: "ya-instalado", mensaje: `${nombre} ya está instalado; no se reinstala` };
+    }
+    const { fuente } = resolverFuente(nombre, opciones.catalogo);
+    try {
+        await opciones.motor.installAndPersist(fuente, { local: opciones.scope === "project" });
+    }
+    catch (error) {
+        return { accion: "error", mensaje: error instanceof Error ? error.message : String(error) };
+    }
+    return { accion: "instalado", mensaje: `${nombre} instalado (scope ${opciones.scope})` };
+}
+export async function actualizar(nombre, opciones) {
+    if (!estaInstalado(opciones.motor, nombre)) {
+        return { accion: "no-instalado", mensaje: `${nombre} no está instalado` };
+    }
+    try {
+        await opciones.motor.update(nombre);
+    }
+    catch (error) {
+        return { accion: "error", mensaje: error instanceof Error ? error.message : String(error) };
+    }
+    return { accion: "actualizado", mensaje: `${nombre} actualizado` };
+}
+export async function eliminar(nombre, opciones) {
+    const configurados = opciones.motor.listConfiguredPackages();
+    const paquete = configurados.find((p) => p.source === nombre || p.source.startsWith(`${nombre}@`));
+    if (!paquete)
+        return { accion: "no-instalado", mensaje: `${nombre} no está instalado` };
+    try {
+        await opciones.motor.removeAndPersist(paquete.source, { local: opciones.scope === "project" });
+    }
+    catch (error) {
+        return { accion: "error", mensaje: error instanceof Error ? error.message : String(error) };
+    }
+    return { accion: "eliminado", mensaje: `${nombre} eliminado (scope ${opciones.scope})` };
+}
+//# sourceMappingURL=instalar.js.map

package/dist/core/marketplace/instalar.js.map

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

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

@@ -0,0 +1,60 @@
+/**
+ * Cliente MCP nativo en TypeScript.
+ *
+ * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla
+ * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP
+ * directamente — lo que además elimina su dependencia de un venv de ~500MB.
+ *
+ * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el
+ * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a
+ * propósito: lanzar procesos arbitrarios desde una config es una superficie de
+ * ejecución que no queremos abrir por defecto.
+ */
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError: boolean;
+}
+export interface McpClientOptions {
+    url: string;
+    /** Cabeceras estáticas de la config del usuario. */
+    headers?: Record<string, string>;
+    /** Token bearer (del Vault o de una variable de entorno). */
+    bearerToken?: string;
+    timeoutMs?: number;
+    /** Inyectable para tests. */
+    fetchImpl?: typeof fetch;
+}
+export declare class McpError extends Error {
+    code: number;
+    constructor(message: string, code?: number);
+}
+export declare class McpClient {
+    private url;
+    private headers;
+    private bearerToken?;
+    private timeoutMs;
+    private fetchImpl;
+    private nextId;
+    /** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */
+    private sessionId?;
+    private initialized;
+    constructor(options: McpClientOptions);
+    private buildHeaders;
+    /** Una respuesta SSE envuelve el JSON en líneas `data:`. */
+    private static parseBody;
+    private rpc;
+    /** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */
+    initialize(): Promise<void>;
+    listTools(): Promise<McpTool[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACzB;AASD,qBAAa,QAAS,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK;CAKtC;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,MAAM,CAAK;IACnB,2EAA2E;IAC3E,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,gBAAgB;IAQrC,OAAO,CAAC,YAAY;IAYpB,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,SAAS;YAgBV,GAAG;IAwCjB,wEAAwE;IAClE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAM/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAOnF"}

package/dist/core/mcp/client.js

@@ -0,0 +1,139 @@
+/**
+ * Cliente MCP nativo en TypeScript.
+ *
+ * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla
+ * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP
+ * directamente — lo que además elimina su dependencia de un venv de ~500MB.
+ *
+ * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el
+ * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a
+ * propósito: lanzar procesos arbitrarios desde una config es una superficie de
+ * ejecución que no queremos abrir por defecto.
+ */
+const PROTOCOL_VERSION = "2025-06-18";
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class McpError extends Error {
+    code;
+    constructor(message, code = -1) {
+        super(message);
+        this.name = "McpError";
+        this.code = code;
+    }
+}
+export class McpClient {
+    url;
+    headers;
+    bearerToken;
+    timeoutMs;
+    fetchImpl;
+    nextId = 1;
+    /** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */
+    sessionId;
+    initialized = false;
+    constructor(options) {
+        this.url = options.url;
+        this.headers = options.headers ?? {};
+        this.bearerToken = options.bearerToken;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    buildHeaders() {
+        const headers = {
+            "content-type": "application/json",
+            // Los servidores Streamable HTTP pueden responder JSON o SSE.
+            accept: "application/json, text/event-stream",
+            ...this.headers,
+        };
+        if (this.bearerToken)
+            headers.authorization = `Bearer ${this.bearerToken}`;
+        if (this.sessionId)
+            headers["mcp-session-id"] = this.sessionId;
+        return headers;
+    }
+    /** Una respuesta SSE envuelve el JSON en líneas `data:`. */
+    static parseBody(contentType, body) {
+        if (!contentType.includes("text/event-stream"))
+            return JSON.parse(body);
+        for (const line of body.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith("data:"))
+                continue;
+            const payload = trimmed.slice(5).trim();
+            if (!payload || payload === "[DONE]")
+                continue;
+            try {
+                return JSON.parse(payload);
+            }
+            catch {
+                // siguiente evento
+            }
+        }
+        throw new McpError("Respuesta SSE sin payload JSON-RPC");
+    }
+    async rpc(method, params) {
+        const id = this.nextId++;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(this.url, {
+                method: "POST",
+                headers: this.buildHeaders(),
+                body: JSON.stringify({ jsonrpc: "2.0", id, method, ...(params ? { params } : {}) }),
+                signal: controller.signal,
+            });
+            const sessionHeader = response.headers?.get?.("mcp-session-id");
+            if (sessionHeader)
+                this.sessionId = sessionHeader;
+            if (!response.ok) {
+                // 401 se distingue a propósito: es "falta autenticar", no un fallo del
+                // servidor, y el mensaje debe llevar al usuario a /mcp login.
+                if (response.status === 401 || response.status === 403) {
+                    throw new McpError(`No autenticado contra ${this.url} (HTTP ${response.status})`, response.status);
+                }
+                throw new McpError(`El servidor MCP devolvió HTTP ${response.status}`, response.status);
+            }
+            const body = await response.text();
+            if (!body.trim())
+                return undefined; // notificación aceptada sin cuerpo
+            const parsed = McpClient.parseBody(response.headers?.get?.("content-type") ?? "", body);
+            if (parsed.error)
+                throw new McpError(parsed.error.message, parsed.error.code);
+            return parsed.result;
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                throw error;
+            if (error.name === "AbortError") {
+                throw new McpError(`El servidor MCP no respondió en ${this.timeoutMs}ms`);
+            }
+            throw new McpError(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.rpc("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "ada-cli", version: "1" },
+        });
+        // El servidor espera la notificación antes de aceptar peticiones normales.
+        await this.rpc("notifications/initialized").catch(() => { });
+        this.initialized = true;
+    }
+    async listTools() {
+        await this.initialize();
+        const result = (await this.rpc("tools/list"));
+        return result?.tools ?? [];
+    }
+    async callTool(name, args) {
+        await this.initialize();
+        const result = (await this.rpc("tools/call", { name, arguments: args }));
+        return { content: result?.content ?? [], isError: result?.isError === true };
+    }
+}
+//# sourceMappingURL=client.js.map