@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/tools.js

@@ -0,0 +1,399 @@
+/**
+ * Tools de control del ordenador.
+ *
+ * El motor es nuestro fork de pi-computer-use (ver `motor/README.md`), pero el
+ * agente NO habla con él: habla con estas tools, y cada una pasa por
+ * `politica.ts` antes de mover nada. Registrar el motor directamente dejaría al
+ * modelo pulsando cualquier cosa en cualquier aplicación, y nuestra gobernanza
+ * no pintaría nada.
+ *
+ * Preferimos SIEMPRE actuar sobre el árbol de accesibilidad antes que sobre
+ * coordenadas. Pulsar "el botón Enviar" es verificable; pulsar en (840, 512) es
+ * una apuesta, y cuando falla no falla en el vacío: pulsa otra cosa.
+ *
+ * Desde el cambio de motor eso ya no es una preferencia: **para actuar hace
+ * falta el `lookId` de una observación previa**. El motor rechaza actuar sobre
+ * estado viejo, así que "lee antes de pulsar" pasó de consejo del prompt a
+ * requisito que no se puede saltar. El fallo que apareció contra TextEdit
+ * —escribir en una ventana que ya se había cerrado— dejó de ser posible.
+ */
+import { Type } from "typebox";
+import { avisoSinNavegador, reglaDeEleccion } from "../prompt-eleccion.js";
+import { capturarPantalla } from "./captura.js";
+import { actuar, appEnPrimerPlano, esperar, leerTexto, listarApps, observar, pidDe, } from "./motor-ada.js";
+import { CredencialError, esAppProhibida, exigirPermiso, pareceCredencial, techoDeCategoria, teclaPeligrosa, } from "./politica.js";
+/**
+ * Lo que el agente necesita saber para usar esto bien.
+ *
+ * `promptSnippet` solo dice que la tool existe. Para una capacidad que mueve el
+ * ratón sobre el escritorio de verdad, saber que existe no es saber usarla.
+ */
+function guiaOrdenador(navegador) {
+    return [
+        reglaDeEleccion({ navegador, ordenador: true }),
+        ...(navegador ? [] : [avisoSinNavegador()]),
+        "Ante la duda entre computer_* y cualquier otra, elige la otra: manejar una ventana es lo más frágil que puedes hacer y lo que más puede romper sin avisar.",
+        "Antes de controlar el ordenador, usa computer_apps: cada aplicación dice hasta dónde puedes llegar con ella.",
+        "computer_read te da un lookId y las referencias de los elementos; toda acción necesita ese lookId, y si la ventana cambió tendrás que volver a leer.",
+        "Cuando algo tarde en aparecer, usa computer_wait en vez de actuar y confiar: actuar sobre una ventana que no está lista falla en silencio.",
+        "Si lo que vas a pulsar envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de hacerlo.",
+        "No teclees contraseñas, tokens ni datos de tarjeta: pídeselo al usuario.",
+    ];
+}
+function texto(t) {
+    return { content: [{ type: "text", text: t }], details: undefined };
+}
+function fallo(error) {
+    return texto(`Error: ${error instanceof Error ? error.message : String(error)}`);
+}
+/** Los nombres, sueltos, para que `agent-session` los active sin construirlas. */
+export const NOMBRES_COMPUTER_TOOLS = [
+    "computer_apps",
+    "computer_read",
+    "computer_screenshot",
+    "computer_click",
+    "computer_type",
+    "computer_key",
+    "computer_scroll",
+    "computer_wait",
+    "computer_text",
+];
+export function crearComputerTools(opciones = {}) {
+    // Sin tools de navegador, la política que redirige "esto es un navegador,
+    // usa browser_*" apuntaría al vacío. Se avisa antes en vez de después.
+    const guia = guiaOrdenador(opciones.navegador === true);
+    /**
+     * Observaciones vivas, por `lookId`.
+     *
+     * El agente recibe el `lookId` y lo devuelve en cada acción. Se guarda aquí
+     * el objeto completo porque el motor necesita también el pid, y hacer que el
+     * modelo arrastre dos identificadores sería pedirle que no se equivoque en
+     * algo que podemos recordar nosotros.
+     */
+    const observaciones = new Map();
+    /** Puerta de permisos. Ver `politica.ts`. */
+    const guardia = (accion, app) => exigirPermiso(accion, app);
+    /** Resuelve el pid de una app aplicando la política antes de tocarla. */
+    const prepararApp = async (nombreApp, accion) => {
+        guardia(accion, nombreApp);
+        const pid = await pidDe(nombreApp);
+        if (pid === undefined) {
+            throw new Error(`No encuentro ninguna aplicación abierta llamada "${nombreApp}". Usa computer_apps para verlas.`);
+        }
+        return pid;
+    };
+    /** Recupera una observación. Actuar sin ella es actuar a ciegas. */
+    const observacionDe = (lookId) => {
+        const obs = observaciones.get(lookId);
+        if (!obs) {
+            throw new Error(`El lookId "${lookId}" no existe o ya caducó. Vuelve a leer la ventana con computer_read: ` +
+                `el motor no deja actuar sobre observaciones viejas, a propósito.`);
+        }
+        return obs;
+    };
+    const listar = {
+        name: "computer_apps",
+        label: "Listar aplicaciones",
+        promptGuidelines: guia,
+        description: "Lista las aplicaciones abiertas y hasta dónde puedes llegar con cada una. " +
+            "Úsalo antes de nada: cada una dice su límite.",
+        promptSnippet: "ver qué aplicaciones hay y hasta dónde puedo llegar con cada una",
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                const apps = await listarApps();
+                const frente = await appEnPrimerPlano().catch(() => null);
+                // El límite se anota por aplicación para que el modelo lo sepa ANTES
+                // de intentar algo, en vez de descubrirlo con un error.
+                const lineas = apps.map((a) => {
+                    const marca = frente?.pid === a.pid ? " [primer plano]" : "";
+                    if (esAppProhibida(a.nombre))
+                        return `${a.nombre}${marca} → NUNCA (credenciales)`;
+                    const techo = techoDeCategoria(a.nombre);
+                    const nota = techo === "read"
+                        ? "solo ver — para manejarlo usa browser_*"
+                        : techo === "click"
+                            ? "ver y pulsar — para ejecutar comandos usa bash"
+                            : "control total";
+                    return `${a.nombre}${marca} → ${nota}`;
+                });
+                return texto(lineas.join("\n"));
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const leer = {
+        name: "computer_read",
+        label: "Leer la ventana",
+        description: "Observa una aplicación y devuelve su árbol de elementos junto a un lookId. " +
+            "TODA acción necesita ese lookId. Si la ventana cambia, vuelve a leer.",
+        promptSnippet: "leer los elementos de una ventana y obtener su lookId",
+        parameters: Type.Object({
+            app: Type.String({ description: "Nombre de la aplicación" }),
+            scopeRef: Type.Optional(Type.String({ description: "Referencia de un elemento, para mirar solo dentro de él" })),
+        }),
+        async execute(_id, input) {
+            try {
+                const nombreApp = String(input.app ?? "");
+                const pid = await prepararApp(nombreApp, "screenshot");
+                const obs = await observar(pid, { scopeRef: input.scopeRef ? String(input.scopeRef) : undefined });
+                observaciones.set(obs.lookId, obs);
+                return texto(`Ventana: ${obs.titulo ?? "(sin título)"}  ·  ${obs.elementos} elementos\n` +
+                    `lookId: ${obs.lookId}\n\n${obs.resumen}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const captura = {
+        name: "computer_screenshot",
+        label: "Captura de pantalla",
+        description: "Captura la pantalla. Para decidir dónde pulsar, prefiere computer_read.",
+        promptSnippet: "ver la pantalla",
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                const frente = await appEnPrimerPlano();
+                guardia("screenshot", frente.nombre);
+                // Primero, por el MOTOR. No es una preferencia estética: en macOS el
+                // permiso de Grabación de pantalla se concede a una aplicación, y el
+                // helper ya lo tiene. `screencapture` lo lanzaría NUESTRO proceso —
+                // node, dentro de la Terminal o del escritorio — que es otra identidad
+                // y necesitaría su propio permiso, uno por cada sitio desde el que se
+                // use Ada. Comprobado: con el helper autorizado, `screencapture -x`
+                // desde node seguía devolviendo "could not create image from display".
+                //
+                // Captura la VENTANA de delante, no la pantalla entera. Además de
+                // funcionar, es lo correcto: no arrastra al contexto lo que haya en
+                // otras ventanas del usuario.
+                if (frente.pid !== undefined) {
+                    try {
+                        const obs = await observar(frente.pid, { conImagen: true });
+                        if (obs.imagen) {
+                            return {
+                                content: [
+                                    { type: "text", text: `Ventana: ${obs.titulo ?? frente.nombre}` },
+                                    { type: "image", data: obs.imagen.datos, mimeType: obs.imagen.mimeType },
+                                ],
+                                details: undefined,
+                            };
+                        }
+                    }
+                    catch {
+                        // Si el motor no puede, queda la captura del sistema.
+                    }
+                }
+                const r = await capturarPantalla();
+                if (!r.imagen)
+                    return texto(r.motivo ?? "No se pudo capturar la pantalla.");
+                return { content: [{ type: "image", data: r.imagen, mimeType: "image/png" }], details: undefined };
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const pulsar = {
+        name: "computer_click",
+        label: "Pulsar",
+        promptGuidelines: guia,
+        description: "Pulsa un elemento por su referencia, usando el lookId de computer_read. " +
+            "Si lo que vas a pulsar envía, compra, publica o borra, pregunta al usuario ANTES.",
+        promptSnippet: "pulsar un elemento de la pantalla",
+        parameters: Type.Object({
+            lookId: Type.String(),
+            ref: Type.String({ description: "Referencia del elemento, de computer_read" }),
+            boton: Type.Optional(Type.String({ description: "left (por defecto), right, middle" })),
+            veces: Type.Optional(Type.Number({ description: "1 (por defecto), 2 para doble" })),
+        }),
+        async execute(_id, input) {
+            try {
+                const obs = observacionDe(String(input.lookId ?? ""));
+                const boton = String(input.boton ?? "left");
+                const veces = Number(input.veces ?? 1);
+                const accion = boton === "right"
+                    ? "right_click"
+                    : boton === "middle"
+                        ? "middle_click"
+                        : veces >= 3
+                            ? "triple_click"
+                            : veces === 2
+                                ? "double_click"
+                                : "left_click";
+                const frente = await appEnPrimerPlano();
+                guardia(accion, frente.nombre);
+                const r = await actuar(obs, { tipo: "click", ref: String(input.ref ?? ""), boton, veces });
+                return texto(r.ok ? `Pulsado.${r.detalle ? `\n${r.detalle}` : ""}` : `No se pudo pulsar: ${r.detalle}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const escribir = {
+        name: "computer_type",
+        label: "Escribir",
+        promptGuidelines: guia,
+        description: "Escribe texto en un elemento, usando el lookId de computer_read. " +
+            "No escribe credenciales: claves, tokens, tarjetas o IBAN los pone el usuario.",
+        promptSnippet: "escribir texto en un campo",
+        parameters: Type.Object({ lookId: Type.String(), ref: Type.String(), texto: Type.String() }),
+        async execute(_id, input) {
+            try {
+                const contenido = String(input.texto ?? "");
+                // Antes que el permiso: si es una credencial da igual qué app sea.
+                if (pareceCredencial(contenido))
+                    return fallo(new CredencialError());
+                const obs = observacionDe(String(input.lookId ?? ""));
+                const frente = await appEnPrimerPlano();
+                guardia("type", frente.nombre);
+                const r = await actuar(obs, { tipo: "escribir", ref: String(input.ref ?? ""), texto: contenido });
+                if (!r.ok)
+                    return texto(`No se pudo escribir: ${r.detalle}`);
+                // El motor devuelve el estado posterior, así que la comprobación que
+                // antes había que hacer a mano viene de serie.
+                return texto(`Escrito.${r.detalle ? `\n${r.detalle}` : ""}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const tecla = {
+        name: "computer_key",
+        label: "Pulsar tecla",
+        description: "Pulsa una tecla o combinación ('cmd+s', 'return', 'tab'). " +
+            "Las que cierran o borran sin vuelta atrás necesitan que el usuario lo pida.",
+        promptSnippet: "pulsar una combinación de teclas",
+        parameters: Type.Object({
+            lookId: Type.String(),
+            tecla: Type.String(),
+            ref: Type.Optional(Type.String()),
+            confirmado: Type.Optional(Type.Boolean({ description: "El usuario ha pedido esta tecla peligrosa" })),
+        }),
+        async execute(_id, input) {
+            try {
+                const combinacion = String(input.tecla ?? "");
+                if (teclaPeligrosa(combinacion) && input.confirmado !== true) {
+                    return texto(`'${combinacion}' cierra o borra sin vuelta atrás. Pregúntale al usuario y vuelve con confirmado: true.`);
+                }
+                const obs = observacionDe(String(input.lookId ?? ""));
+                const frente = await appEnPrimerPlano();
+                guardia("key", frente.nombre);
+                const r = await actuar(obs, {
+                    tipo: "teclas",
+                    ref: input.ref ? String(input.ref) : undefined,
+                    teclas: combinacion.split("+").map((k) => k.trim()),
+                });
+                return texto(r.ok ? `Pulsado ${combinacion}.` : `No se pudo pulsar: ${r.detalle}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const desplazar = {
+        name: "computer_scroll",
+        label: "Desplazar",
+        description: "Desplaza el contenido de un elemento.",
+        promptSnippet: "desplazar la pantalla",
+        parameters: Type.Object({
+            lookId: Type.String(),
+            ref: Type.String(),
+            direccion: Type.String({ description: "up, down, left, right" }),
+            cantidad: Type.Optional(Type.Number()),
+        }),
+        async execute(_id, input) {
+            try {
+                const obs = observacionDe(String(input.lookId ?? ""));
+                const frente = await appEnPrimerPlano();
+                guardia("scroll", frente.nombre);
+                const paso = Number(input.cantidad ?? 3) * 100;
+                const dir = String(input.direccion ?? "down");
+                const r = await actuar(obs, {
+                    tipo: "desplazar",
+                    ref: String(input.ref ?? ""),
+                    x: dir === "left" ? -paso : dir === "right" ? paso : 0,
+                    y: dir === "up" ? -paso : dir === "down" ? paso : 0,
+                });
+                return texto(r.ok ? "Desplazado." : `No se pudo desplazar: ${r.detalle}`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const aguardar = {
+        name: "computer_wait",
+        label: "Esperar",
+        promptGuidelines: guia,
+        description: "Espera a que un texto o un tipo de control aparezca (o desaparezca) en una ventana. " +
+            "Úsalo cuando algo tarde: actuar sobre una ventana que no está lista falla en silencio.",
+        promptSnippet: "esperar a que la pantalla cambie",
+        parameters: Type.Object({
+            app: Type.String(),
+            texto: Type.Optional(Type.String({ description: "Texto que debe aparecer" })),
+            rol: Type.Optional(Type.String({ description: "Tipo de control, p. ej. button" })),
+            desaparezca: Type.Optional(Type.Boolean({ description: "Esperar a que DEJE de estar" })),
+            timeoutMs: Type.Optional(Type.Number({ description: "Por defecto 10000, máximo 60000" })),
+        }),
+        async execute(_id, input) {
+            try {
+                const pid = await prepararApp(String(input.app ?? ""), "screenshot");
+                const r = await esperar(pid, {
+                    texto: input.texto ? String(input.texto) : undefined,
+                    rol: input.rol ? String(input.rol) : undefined,
+                    desaparezca: input.desaparezca === true,
+                    timeoutMs: input.timeoutMs ? Number(input.timeoutMs) : undefined,
+                });
+                return texto(r.encontrado
+                    ? "Listo: lo que esperabas está. Vuelve a leer con computer_read para actuar."
+                    : `No llegó a pasar (${r.detalle}). No actúes a ciegas: mira con computer_read qué hay.`);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    const textoDe = {
+        name: "computer_text",
+        label: "Leer texto",
+        description: "Lee el texto completo de un elemento, por trozos. " +
+            "Para contenidos largos que computer_read resume o recorta.",
+        promptSnippet: "leer el texto completo de un elemento",
+        parameters: Type.Object({
+            lookId: Type.String(),
+            ref: Type.String(),
+            desde: Type.Optional(Type.Number()),
+            limite: Type.Optional(Type.Number()),
+        }),
+        async execute(_id, input) {
+            try {
+                const obs = observacionDe(String(input.lookId ?? ""));
+                const r = await leerTexto(obs, String(input.ref ?? ""), {
+                    offset: input.desde ? Number(input.desde) : 0,
+                    limit: input.limite ? Number(input.limite) : undefined,
+                });
+                return texto(r.hayMas ? `${r.texto}\n\n[…quedan ${r.total - r.texto.length} caracteres]` : r.texto);
+            }
+            catch (error) {
+                return fallo(error);
+            }
+        },
+    };
+    return {
+        computer_apps: listar,
+        computer_read: leer,
+        computer_screenshot: captura,
+        computer_click: pulsar,
+        computer_type: escribir,
+        computer_key: tecla,
+        computer_scroll: desplazar,
+        computer_wait: aguardar,
+        computer_text: textoDe,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/computer/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/computer/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tools de control del ordenador.\n *\n * El motor es nuestro fork de pi-computer-use (ver `motor/README.md`), pero el\n * agente NO habla con él: habla con estas tools, y cada una pasa por\n * `politica.ts` antes de mover nada. Registrar el motor directamente dejaría al\n * modelo pulsando cualquier cosa en cualquier aplicación, y nuestra gobernanza\n * no pintaría nada.\n *\n * Preferimos SIEMPRE actuar sobre el árbol de accesibilidad antes que sobre\n * coordenadas. Pulsar \"el botón Enviar\" es verificable; pulsar en (840, 512) es\n * una apuesta, y cuando falla no falla en el vacío: pulsa otra cosa.\n *\n * Desde el cambio de motor eso ya no es una preferencia: **para actuar hace\n * falta el `lookId` de una observación previa**. El motor rechaza actuar sobre\n * estado viejo, así que \"lee antes de pulsar\" pasó de consejo del prompt a\n * requisito que no se puede saltar. El fallo que apareció contra TextEdit\n * —escribir en una ventana que ya se había cerrado— dejó de ser posible.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { avisoSinNavegador, reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { capturarPantalla } from \"./captura.ts\";\nimport {\n\tactuar,\n\tappEnPrimerPlano,\n\tesperar,\n\tleerTexto,\n\tlistarApps,\n\ttype Observacion,\n\tobservar,\n\tpidDe,\n} from \"./motor-ada.ts\";\nimport {\n\ttype Accion,\n\tCredencialError,\n\tesAppProhibida,\n\texigirPermiso,\n\tpareceCredencial,\n\ttechoDeCategoria,\n\tteclaPeligrosa,\n} from \"./politica.ts\";\n\n/**\n * Lo que el agente necesita saber para usar esto bien.\n *\n * `promptSnippet` solo dice que la tool existe. Para una capacidad que mueve el\n * ratón sobre el escritorio de verdad, saber que existe no es saber usarla.\n */\nfunction guiaOrdenador(navegador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador, ordenador: true }),\n\t\t...(navegador ? [] : [avisoSinNavegador()]),\n\t\t\"Ante la duda entre computer_* y cualquier otra, elige la otra: manejar una ventana es lo más frágil que puedes hacer y lo que más puede romper sin avisar.\",\n\t\t\"Antes de controlar el ordenador, usa computer_apps: cada aplicación dice hasta dónde puedes llegar con ella.\",\n\t\t\"computer_read te da un lookId y las referencias de los elementos; toda acción necesita ese lookId, y si la ventana cambió tendrás que volver a leer.\",\n\t\t\"Cuando algo tarde en aparecer, usa computer_wait en vez de actuar y confiar: actuar sobre una ventana que no está lista falla en silencio.\",\n\t\t\"Si lo que vas a pulsar envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de hacerlo.\",\n\t\t\"No teclees contraseñas, tokens ni datos de tarjeta: pídeselo al usuario.\",\n\t];\n}\n\nfunction texto(t: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text: t }], details: undefined };\n}\n\nfunction fallo(error: unknown): AgentToolResult<unknown> {\n\treturn texto(`Error: ${error instanceof Error ? error.message : String(error)}`);\n}\n\n/** Los nombres, sueltos, para que `agent-session` los active sin construirlas. */\nexport const NOMBRES_COMPUTER_TOOLS = [\n\t\"computer_apps\",\n\t\"computer_read\",\n\t\"computer_screenshot\",\n\t\"computer_click\",\n\t\"computer_type\",\n\t\"computer_key\",\n\t\"computer_scroll\",\n\t\"computer_wait\",\n\t\"computer_text\",\n] as const;\n\nexport function crearComputerTools(opciones: { navegador?: boolean } = {}): Record<string, ToolDefinition> {\n\t// Sin tools de navegador, la política que redirige \"esto es un navegador,\n\t// usa browser_*\" apuntaría al vacío. Se avisa antes en vez de después.\n\tconst guia = guiaOrdenador(opciones.navegador === true);\n\t/**\n\t * Observaciones vivas, por `lookId`.\n\t *\n\t * El agente recibe el `lookId` y lo devuelve en cada acción. Se guarda aquí\n\t * el objeto completo porque el motor necesita también el pid, y hacer que el\n\t * modelo arrastre dos identificadores sería pedirle que no se equivoque en\n\t * algo que podemos recordar nosotros.\n\t */\n\tconst observaciones = new Map<string, Observacion>();\n\n\t/** Puerta de permisos. Ver `politica.ts`. */\n\tconst guardia = (accion: Accion, app: string): void => exigirPermiso(accion, app);\n\n\t/** Resuelve el pid de una app aplicando la política antes de tocarla. */\n\tconst prepararApp = async (nombreApp: string, accion: Accion): Promise<number> => {\n\t\tguardia(accion, nombreApp);\n\t\tconst pid = await pidDe(nombreApp);\n\t\tif (pid === undefined) {\n\t\t\tthrow new Error(\n\t\t\t\t`No encuentro ninguna aplicación abierta llamada \"${nombreApp}\". Usa computer_apps para verlas.`,\n\t\t\t);\n\t\t}\n\t\treturn pid;\n\t};\n\n\t/** Recupera una observación. Actuar sin ella es actuar a ciegas. */\n\tconst observacionDe = (lookId: string): Observacion => {\n\t\tconst obs = observaciones.get(lookId);\n\t\tif (!obs) {\n\t\t\tthrow new Error(\n\t\t\t\t`El lookId \"${lookId}\" no existe o ya caducó. Vuelve a leer la ventana con computer_read: ` +\n\t\t\t\t\t`el motor no deja actuar sobre observaciones viejas, a propósito.`,\n\t\t\t);\n\t\t}\n\t\treturn obs;\n\t};\n\n\tconst listar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_apps\",\n\t\tlabel: \"Listar aplicaciones\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Lista las aplicaciones abiertas y hasta dónde puedes llegar con cada una. \" +\n\t\t\t\"Úsalo antes de nada: cada una dice su límite.\",\n\t\tpromptSnippet: \"ver qué aplicaciones hay y hasta dónde puedo llegar con cada una\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst apps = await listarApps();\n\t\t\t\tconst frente = await appEnPrimerPlano().catch(() => null);\n\t\t\t\t// El límite se anota por aplicación para que el modelo lo sepa ANTES\n\t\t\t\t// de intentar algo, en vez de descubrirlo con un error.\n\t\t\t\tconst lineas = apps.map((a) => {\n\t\t\t\t\tconst marca = frente?.pid === a.pid ? \" [primer plano]\" : \"\";\n\t\t\t\t\tif (esAppProhibida(a.nombre)) return `${a.nombre}${marca} → NUNCA (credenciales)`;\n\t\t\t\t\tconst techo = techoDeCategoria(a.nombre);\n\t\t\t\t\tconst nota =\n\t\t\t\t\t\ttecho === \"read\"\n\t\t\t\t\t\t\t? \"solo ver — para manejarlo usa browser_*\"\n\t\t\t\t\t\t\t: techo === \"click\"\n\t\t\t\t\t\t\t\t? \"ver y pulsar — para ejecutar comandos usa bash\"\n\t\t\t\t\t\t\t\t: \"control total\";\n\t\t\t\t\treturn `${a.nombre}${marca} → ${nota}`;\n\t\t\t\t});\n\t\t\t\treturn texto(lineas.join(\"\\n\"));\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst leer: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_read\",\n\t\tlabel: \"Leer la ventana\",\n\t\tdescription:\n\t\t\t\"Observa una aplicación y devuelve su árbol de elementos junto a un lookId. \" +\n\t\t\t\"TODA acción necesita ese lookId. Si la ventana cambia, vuelve a leer.\",\n\t\tpromptSnippet: \"leer los elementos de una ventana y obtener su lookId\",\n\t\tparameters: Type.Object({\n\t\t\tapp: Type.String({ description: \"Nombre de la aplicación\" }),\n\t\t\tscopeRef: Type.Optional(\n\t\t\t\tType.String({ description: \"Referencia de un elemento, para mirar solo dentro de él\" }),\n\t\t\t),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nombreApp = String(input.app ?? \"\");\n\t\t\t\tconst pid = await prepararApp(nombreApp, \"screenshot\");\n\t\t\t\tconst obs = await observar(pid, { scopeRef: input.scopeRef ? String(input.scopeRef) : undefined });\n\t\t\t\tobservaciones.set(obs.lookId, obs);\n\t\t\t\treturn texto(\n\t\t\t\t\t`Ventana: ${obs.titulo ?? \"(sin título)\"}  ·  ${obs.elementos} elementos\\n` +\n\t\t\t\t\t\t`lookId: ${obs.lookId}\\n\\n${obs.resumen}`,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst captura: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_screenshot\",\n\t\tlabel: \"Captura de pantalla\",\n\t\tdescription: \"Captura la pantalla. Para decidir dónde pulsar, prefiere computer_read.\",\n\t\tpromptSnippet: \"ver la pantalla\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"screenshot\", frente.nombre);\n\n\t\t\t\t// Primero, por el MOTOR. No es una preferencia estética: en macOS el\n\t\t\t\t// permiso de Grabación de pantalla se concede a una aplicación, y el\n\t\t\t\t// helper ya lo tiene. `screencapture` lo lanzaría NUESTRO proceso —\n\t\t\t\t// node, dentro de la Terminal o del escritorio — que es otra identidad\n\t\t\t\t// y necesitaría su propio permiso, uno por cada sitio desde el que se\n\t\t\t\t// use Ada. Comprobado: con el helper autorizado, `screencapture -x`\n\t\t\t\t// desde node seguía devolviendo \"could not create image from display\".\n\t\t\t\t//\n\t\t\t\t// Captura la VENTANA de delante, no la pantalla entera. Además de\n\t\t\t\t// funcionar, es lo correcto: no arrastra al contexto lo que haya en\n\t\t\t\t// otras ventanas del usuario.\n\t\t\t\tif (frente.pid !== undefined) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst obs = await observar(frente.pid, { conImagen: true });\n\t\t\t\t\t\tif (obs.imagen) {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t\t\t{ type: \"text\" as const, text: `Ventana: ${obs.titulo ?? frente.nombre}` },\n\t\t\t\t\t\t\t\t\t{ type: \"image\" as const, data: obs.imagen.datos, mimeType: obs.imagen.mimeType },\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdetails: undefined,\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Si el motor no puede, queda la captura del sistema.\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst r = await capturarPantalla();\n\t\t\t\tif (!r.imagen) return texto(r.motivo ?? \"No se pudo capturar la pantalla.\");\n\t\t\t\treturn { content: [{ type: \"image\" as const, data: r.imagen, mimeType: \"image/png\" }], details: undefined };\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia, usando el lookId de computer_read. \" +\n\t\t\t\"Si lo que vas a pulsar envía, compra, publica o borra, pregunta al usuario ANTES.\",\n\t\tpromptSnippet: \"pulsar un elemento de la pantalla\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String({ description: \"Referencia del elemento, de computer_read\" }),\n\t\t\tboton: Type.Optional(Type.String({ description: \"left (por defecto), right, middle\" })),\n\t\t\tveces: Type.Optional(Type.Number({ description: \"1 (por defecto), 2 para doble\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst boton = String(input.boton ?? \"left\") as \"left\" | \"right\" | \"middle\";\n\t\t\t\tconst veces = Number(input.veces ?? 1);\n\t\t\t\tconst accion: Accion =\n\t\t\t\t\tboton === \"right\"\n\t\t\t\t\t\t? \"right_click\"\n\t\t\t\t\t\t: boton === \"middle\"\n\t\t\t\t\t\t\t? \"middle_click\"\n\t\t\t\t\t\t\t: veces >= 3\n\t\t\t\t\t\t\t\t? \"triple_click\"\n\t\t\t\t\t\t\t\t: veces === 2\n\t\t\t\t\t\t\t\t\t? \"double_click\"\n\t\t\t\t\t\t\t\t\t: \"left_click\";\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(accion, frente.nombre);\n\t\t\t\tconst r = await actuar(obs, { tipo: \"click\", ref: String(input.ref ?? \"\"), boton, veces });\n\t\t\t\treturn texto(r.ok ? `Pulsado.${r.detalle ? `\\n${r.detalle}` : \"\"}` : `No se pudo pulsar: ${r.detalle}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst escribir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un elemento, usando el lookId de computer_read. \" +\n\t\t\t\"No escribe credenciales: claves, tokens, tarjetas o IBAN los pone el usuario.\",\n\t\tpromptSnippet: \"escribir texto en un campo\",\n\t\tparameters: Type.Object({ lookId: Type.String(), ref: Type.String(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst contenido = String(input.texto ?? \"\");\n\t\t\t\t// Antes que el permiso: si es una credencial da igual qué app sea.\n\t\t\t\tif (pareceCredencial(contenido)) return fallo(new CredencialError());\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"type\", frente.nombre);\n\t\t\t\tconst r = await actuar(obs, { tipo: \"escribir\", ref: String(input.ref ?? \"\"), texto: contenido });\n\t\t\t\tif (!r.ok) return texto(`No se pudo escribir: ${r.detalle}`);\n\t\t\t\t// El motor devuelve el estado posterior, así que la comprobación que\n\t\t\t\t// antes había que hacer a mano viene de serie.\n\t\t\t\treturn texto(`Escrito.${r.detalle ? `\\n${r.detalle}` : \"\"}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst tecla: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_key\",\n\t\tlabel: \"Pulsar tecla\",\n\t\tdescription:\n\t\t\t\"Pulsa una tecla o combinación ('cmd+s', 'return', 'tab'). \" +\n\t\t\t\"Las que cierran o borran sin vuelta atrás necesitan que el usuario lo pida.\",\n\t\tpromptSnippet: \"pulsar una combinación de teclas\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\ttecla: Type.String(),\n\t\t\tref: Type.Optional(Type.String()),\n\t\t\tconfirmado: Type.Optional(Type.Boolean({ description: \"El usuario ha pedido esta tecla peligrosa\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst combinacion = String(input.tecla ?? \"\");\n\t\t\t\tif (teclaPeligrosa(combinacion) && input.confirmado !== true) {\n\t\t\t\t\treturn texto(\n\t\t\t\t\t\t`'${combinacion}' cierra o borra sin vuelta atrás. Pregúntale al usuario y vuelve con confirmado: true.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"key\", frente.nombre);\n\t\t\t\tconst r = await actuar(obs, {\n\t\t\t\t\ttipo: \"teclas\",\n\t\t\t\t\tref: input.ref ? String(input.ref) : undefined,\n\t\t\t\t\tteclas: combinacion.split(\"+\").map((k) => k.trim()),\n\t\t\t\t});\n\t\t\t\treturn texto(r.ok ? `Pulsado ${combinacion}.` : `No se pudo pulsar: ${r.detalle}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst desplazar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_scroll\",\n\t\tlabel: \"Desplazar\",\n\t\tdescription: \"Desplaza el contenido de un elemento.\",\n\t\tpromptSnippet: \"desplazar la pantalla\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String(),\n\t\t\tdireccion: Type.String({ description: \"up, down, left, right\" }),\n\t\t\tcantidad: Type.Optional(Type.Number()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst frente = await appEnPrimerPlano();\n\t\t\t\tguardia(\"scroll\", frente.nombre);\n\t\t\t\tconst paso = Number(input.cantidad ?? 3) * 100;\n\t\t\t\tconst dir = String(input.direccion ?? \"down\");\n\t\t\t\tconst r = await actuar(obs, {\n\t\t\t\t\ttipo: \"desplazar\",\n\t\t\t\t\tref: String(input.ref ?? \"\"),\n\t\t\t\t\tx: dir === \"left\" ? -paso : dir === \"right\" ? paso : 0,\n\t\t\t\t\ty: dir === \"up\" ? -paso : dir === \"down\" ? paso : 0,\n\t\t\t\t});\n\t\t\t\treturn texto(r.ok ? \"Desplazado.\" : `No se pudo desplazar: ${r.detalle}`);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst aguardar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_wait\",\n\t\tlabel: \"Esperar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Espera a que un texto o un tipo de control aparezca (o desaparezca) en una ventana. \" +\n\t\t\t\"Úsalo cuando algo tarde: actuar sobre una ventana que no está lista falla en silencio.\",\n\t\tpromptSnippet: \"esperar a que la pantalla cambie\",\n\t\tparameters: Type.Object({\n\t\t\tapp: Type.String(),\n\t\t\ttexto: Type.Optional(Type.String({ description: \"Texto que debe aparecer\" })),\n\t\t\trol: Type.Optional(Type.String({ description: \"Tipo de control, p. ej. button\" })),\n\t\t\tdesaparezca: Type.Optional(Type.Boolean({ description: \"Esperar a que DEJE de estar\" })),\n\t\t\ttimeoutMs: Type.Optional(Type.Number({ description: \"Por defecto 10000, máximo 60000\" })),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst pid = await prepararApp(String(input.app ?? \"\"), \"screenshot\");\n\t\t\t\tconst r = await esperar(pid, {\n\t\t\t\t\ttexto: input.texto ? String(input.texto) : undefined,\n\t\t\t\t\trol: input.rol ? String(input.rol) : undefined,\n\t\t\t\t\tdesaparezca: input.desaparezca === true,\n\t\t\t\t\ttimeoutMs: input.timeoutMs ? Number(input.timeoutMs) : undefined,\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\tr.encontrado\n\t\t\t\t\t\t? \"Listo: lo que esperabas está. Vuelve a leer con computer_read para actuar.\"\n\t\t\t\t\t\t: `No llegó a pasar (${r.detalle}). No actúes a ciegas: mira con computer_read qué hay.`,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\tconst textoDe: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"computer_text\",\n\t\tlabel: \"Leer texto\",\n\t\tdescription:\n\t\t\t\"Lee el texto completo de un elemento, por trozos. \" +\n\t\t\t\"Para contenidos largos que computer_read resume o recorta.\",\n\t\tpromptSnippet: \"leer el texto completo de un elemento\",\n\t\tparameters: Type.Object({\n\t\t\tlookId: Type.String(),\n\t\t\tref: Type.String(),\n\t\t\tdesde: Type.Optional(Type.Number()),\n\t\t\tlimite: Type.Optional(Type.Number()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst obs = observacionDe(String(input.lookId ?? \"\"));\n\t\t\t\tconst r = await leerTexto(obs, String(input.ref ?? \"\"), {\n\t\t\t\t\toffset: input.desde ? Number(input.desde) : 0,\n\t\t\t\t\tlimit: input.limite ? Number(input.limite) : undefined,\n\t\t\t\t});\n\t\t\t\treturn texto(r.hayMas ? `${r.texto}\\n\\n[…quedan ${r.total - r.texto.length} caracteres]` : r.texto);\n\t\t\t} catch (error) {\n\t\t\t\treturn fallo(error);\n\t\t\t}\n\t\t},\n\t};\n\n\treturn {\n\t\tcomputer_apps: listar as ToolDefinition,\n\t\tcomputer_read: leer as ToolDefinition,\n\t\tcomputer_screenshot: captura as ToolDefinition,\n\t\tcomputer_click: pulsar as ToolDefinition,\n\t\tcomputer_type: escribir as ToolDefinition,\n\t\tcomputer_key: tecla as ToolDefinition,\n\t\tcomputer_scroll: desplazar as ToolDefinition,\n\t\tcomputer_wait: aguardar as ToolDefinition,\n\t\tcomputer_text: textoDe as ToolDefinition,\n\t};\n}\n"]}

package/dist/core/context-breakdown.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Desglose de qué está llenando la ventana de contexto.
+ *
+ * POR QUÉ IMPORTA AQUÍ MÁS QUE EN OTROS PRODUCTOS: con caché por prefijo, el
+ * coste de un cambio depende de su POSICIÓN, no de su tamaño. Saber que las
+ * definiciones de tools ocupan 11 K y van delante te dice que tocarlas invalida
+ * todo lo que viene detrás. Sin este desglose, optimizar la caché es a ciegas.
+ *
+ * HONESTIDAD DEL DATO — la parte que las referencias no resuelven:
+ *
+ * El único número REAL es el total, que lo da el proveedor en el `usage` de la
+ * última respuesta. Los trozos se estiman con `chars/4`, que es una heurística.
+ * Presentar estimaciones como si fueran medidas sería mentir con precisión
+ * falsa, así que:
+ *
+ *   - Si hay total real, se REPARTE ese total según las proporciones estimadas.
+ *     El total cuadra siempre y el reparto se marca como estimado.
+ *   - Si no lo hay (recién compactado, antes de la primera respuesta), se
+ *     devuelve la suma de estimaciones y se dice que TODO es estimado.
+ */
+/** Categorías. El orden es el del prompt: lo estable primero. */
+export type CategoriaContexto = "systemPrompt" | "toolDefinitions" | "skills" | "mcpTools" | "contextFiles" | "memory" | "conversation";
+export interface PiezaContexto {
+    categoria: CategoriaContexto;
+    /** Tokens atribuidos. Estimados salvo que `exacto` sea true. */
+    tokens: number;
+    /** Fracción del total, entre 0 y 1. */
+    fraccion: number;
+}
+export interface DesgloseContexto {
+    /** Total de tokens en contexto. Exacto si vino del proveedor. */
+    total: number;
+    contextWindow: number;
+    /** Fracción de la ventana ocupada, entre 0 y 1. */
+    ocupacion: number;
+    /**
+     * True cuando `total` viene del `usage` del proveedor. False significa que
+     * todo el desglose, total incluido, es una estimación.
+     */
+    totalExacto: boolean;
+    piezas: PiezaContexto[];
+}
+/**
+ * Estimación de tokens de un texto.
+ *
+ * `chars/4` es la misma heurística que ya usa la compactación
+ * (`compaction.ts:estimateTokens`). Se mantiene idéntica a propósito: dos
+ * estimadores distintos darían cifras que no cuadran entre la barra de contexto
+ * y el momento en que salta la compactación, y el usuario no tendría forma de
+ * saber cuál creer.
+ */
+export declare function estimarTokensTexto(texto: string): number;
+export interface EntradaDesglose {
+    contextWindow: number;
+    /** Tokens reales del proveedor. `null` = desconocido (p. ej. tras compactar). */
+    tokensReales: number | null;
+    systemPrompt: string;
+    /** Nombre + descripción + esquema serializado de cada tool. */
+    toolDefinitions: string[];
+    /** Nombre + descripción de cada skill visible para el modelo. */
+    skills: string[];
+    /** Definiciones de tools MCP, aparte porque son las que más se disparan. */
+    mcpTools: string[];
+    /** Ficheros de contexto inyectados (AGENTS.md y compañía). */
+    contextFiles: string[];
+    /** Bloques de memoria inyectados. */
+    memory: string[];
+    /** Tokens de la conversación, ya estimados por el llamante. */
+    conversationTokens: number;
+}
+/**
+ * Construye el desglose.
+ *
+ * Las categorías con cero tokens se omiten: una lista con seis ceros no informa
+ * de nada y esconde las dos que sí pesan.
+ */
+export declare function construirDesglose(entrada: EntradaDesglose): DesgloseContexto;
+/** Etiquetas legibles. La interfaz traduce; esto es el orden y el nombre canónico. */
+export declare const ETIQUETAS_CONTEXTO: Record<CategoriaContexto, string>;
+//# sourceMappingURL=context-breakdown.d.ts.map

package/dist/core/context-breakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-breakdown.d.ts","sourceRoot":"","sources":["../../src/core/context-breakdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,kEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAC1B,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,cAAc,GACd,QAAQ,GACR,cAAc,CAAC;AAElB,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,wCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gEAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA4E;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gEAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAmC5E;AAED,uFAAsF;AACtF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAQhE,CAAC","sourcesContent":["/**\n * Desglose de qué está llenando la ventana de contexto.\n *\n * POR QUÉ IMPORTA AQUÍ MÁS QUE EN OTROS PRODUCTOS: con caché por prefijo, el\n * coste de un cambio depende de su POSICIÓN, no de su tamaño. Saber que las\n * definiciones de tools ocupan 11 K y van delante te dice que tocarlas invalida\n * todo lo que viene detrás. Sin este desglose, optimizar la caché es a ciegas.\n *\n * HONESTIDAD DEL DATO — la parte que las referencias no resuelven:\n *\n * El único número REAL es el total, que lo da el proveedor en el `usage` de la\n * última respuesta. Los trozos se estiman con `chars/4`, que es una heurística.\n * Presentar estimaciones como si fueran medidas sería mentir con precisión\n * falsa, así que:\n *\n *   - Si hay total real, se REPARTE ese total según las proporciones estimadas.\n *     El total cuadra siempre y el reparto se marca como estimado.\n *   - Si no lo hay (recién compactado, antes de la primera respuesta), se\n *     devuelve la suma de estimaciones y se dice que TODO es estimado.\n */\n\n/** Categorías. El orden es el del prompt: lo estable primero. */\nexport type CategoriaContexto =\n\t| \"systemPrompt\"\n\t| \"toolDefinitions\"\n\t| \"skills\"\n\t| \"mcpTools\"\n\t| \"contextFiles\"\n\t| \"memory\"\n\t| \"conversation\";\n\nexport interface PiezaContexto {\n\tcategoria: CategoriaContexto;\n\t/** Tokens atribuidos. Estimados salvo que `exacto` sea true. */\n\ttokens: number;\n\t/** Fracción del total, entre 0 y 1. */\n\tfraccion: number;\n}\n\nexport interface DesgloseContexto {\n\t/** Total de tokens en contexto. Exacto si vino del proveedor. */\n\ttotal: number;\n\tcontextWindow: number;\n\t/** Fracción de la ventana ocupada, entre 0 y 1. */\n\tocupacion: number;\n\t/**\n\t * True cuando `total` viene del `usage` del proveedor. False significa que\n\t * todo el desglose, total incluido, es una estimación.\n\t */\n\ttotalExacto: boolean;\n\tpiezas: PiezaContexto[];\n}\n\n/**\n * Estimación de tokens de un texto.\n *\n * `chars/4` es la misma heurística que ya usa la compactación\n * (`compaction.ts:estimateTokens`). Se mantiene idéntica a propósito: dos\n * estimadores distintos darían cifras que no cuadran entre la barra de contexto\n * y el momento en que salta la compactación, y el usuario no tendría forma de\n * saber cuál creer.\n */\nexport function estimarTokensTexto(texto: string): number {\n\treturn Math.ceil(texto.length / 4);\n}\n\nexport interface EntradaDesglose {\n\tcontextWindow: number;\n\t/** Tokens reales del proveedor. `null` = desconocido (p. ej. tras compactar). */\n\ttokensReales: number | null;\n\tsystemPrompt: string;\n\t/** Nombre + descripción + esquema serializado de cada tool. */\n\ttoolDefinitions: string[];\n\t/** Nombre + descripción de cada skill visible para el modelo. */\n\tskills: string[];\n\t/** Definiciones de tools MCP, aparte porque son las que más se disparan. */\n\tmcpTools: string[];\n\t/** Ficheros de contexto inyectados (AGENTS.md y compañía). */\n\tcontextFiles: string[];\n\t/** Bloques de memoria inyectados. */\n\tmemory: string[];\n\t/** Tokens de la conversación, ya estimados por el llamante. */\n\tconversationTokens: number;\n}\n\nfunction sumar(textos: string[]): number {\n\tlet total = 0;\n\tfor (const t of textos) total += estimarTokensTexto(t);\n\treturn total;\n}\n\n/**\n * Construye el desglose.\n *\n * Las categorías con cero tokens se omiten: una lista con seis ceros no informa\n * de nada y esconde las dos que sí pesan.\n */\nexport function construirDesglose(entrada: EntradaDesglose): DesgloseContexto {\n\tconst crudos: Array<[CategoriaContexto, number]> = [\n\t\t[\"systemPrompt\", estimarTokensTexto(entrada.systemPrompt)],\n\t\t[\"toolDefinitions\", sumar(entrada.toolDefinitions)],\n\t\t[\"skills\", sumar(entrada.skills)],\n\t\t[\"mcpTools\", sumar(entrada.mcpTools)],\n\t\t[\"contextFiles\", sumar(entrada.contextFiles)],\n\t\t[\"memory\", sumar(entrada.memory)],\n\t\t[\"conversation\", Math.max(0, entrada.conversationTokens)],\n\t];\n\n\tconst sumaEstimada = crudos.reduce((s, [, n]) => s + n, 0);\n\tconst totalExacto = entrada.tokensReales !== null && entrada.tokensReales > 0;\n\tconst total = totalExacto ? (entrada.tokensReales as number) : sumaEstimada;\n\n\t// Reparto proporcional sobre el total real. Si la suma estimada es cero no se\n\t// puede repartir nada: se devuelven las piezas a cero en vez de dividir por\n\t// cero y producir NaN, que en la interfaz se vería como \"—\" o como 0 aleatorio.\n\tconst escala = totalExacto && sumaEstimada > 0 ? (entrada.tokensReales as number) / sumaEstimada : 1;\n\n\tconst piezas: PiezaContexto[] = crudos\n\t\t.filter(([, n]) => n > 0)\n\t\t.map(([categoria, n]) => {\n\t\t\tconst tokens = Math.round(n * escala);\n\t\t\treturn { categoria, tokens, fraccion: total > 0 ? tokens / total : 0 };\n\t\t})\n\t\t.sort((a, b) => b.tokens - a.tokens);\n\n\treturn {\n\t\ttotal,\n\t\tcontextWindow: entrada.contextWindow,\n\t\tocupacion: entrada.contextWindow > 0 ? Math.min(1, total / entrada.contextWindow) : 0,\n\t\ttotalExacto,\n\t\tpiezas,\n\t};\n}\n\n/** Etiquetas legibles. La interfaz traduce; esto es el orden y el nombre canónico. */\nexport const ETIQUETAS_CONTEXTO: Record<CategoriaContexto, string> = {\n\tsystemPrompt: \"System prompt\",\n\ttoolDefinitions: \"Tool definitions\",\n\tskills: \"Skills\",\n\tmcpTools: \"MCP tools\",\n\tcontextFiles: \"Context files\",\n\tmemory: \"Memory\",\n\tconversation: \"Conversation\",\n};\n"]}