@hoilab/ada-cli 0.85.0 → 0.85.1

package/dist/core/computer/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/computer/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkD9E,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,4KAUzB,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuWzG","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"]}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/computer/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkD9E,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,4KAUzB,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuWzG"}

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

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

package/dist/core/config/quarantine.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cuarentena de config corrupta (A05).
+ *
+ * Si un JSON es corrupto, se mueve a `.broken-<timestamp>-<pid>-<uuid>` bajo
+ * file-lock y nunca se sobreescribe la única copia. Espejo de
+ * `config/settings.ts:1305-1323` y `config/config-file.ts:29` de omp, adaptado
+ * a JSON (nuestro formato de settings) y a proper-lockfile / lock en memoria.
+ *
+ * Garantías:
+ *  - Bajo lock: re-valida antes de mover; si otro proceso ya lo movió, falla
+ *    con "invalid before locking and is now missing".
+ *  - Si el rename falla, no se trunca el original: se propaga "could not be
+ *    moved aside; refusing to overwrite".
+ *  - Cuarentena es atómica (rename), no copia+borrado.
+ */
+declare function isEnoent(err: unknown): boolean;
+export declare function withQuarantineLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+export interface QuarantineResult {
+    backupPath: string;
+    originalError: Error;
+}
+/**
+ * Mueve un fichero inválido a `.broken-…` bajo lock.
+ * Debe llamarse solo cuando ya se ha detectado que el contenido es inválido.
+ * Re-valida que el fichero sigue existiendo bajo el lock; si no, significa
+ * que otro proceso ya lo cuarentenó.
+ */
+export declare function quarantineInvalidJsonLocked(filePath: string, originalError: unknown): Promise<QuarantineResult>;
+/**
+ * Variante síncrona para callers con lock ya adquirido o contextos sync.
+ */
+export declare function quarantineInvalidJsonLockedSync(filePath: string, originalError: unknown): QuarantineResult;
+export interface ReadJsonWithQuarantineResult<T> {
+    data: T;
+    quarantinedPath?: string;
+    wasQuarantined: boolean;
+    error?: Error;
+}
+/**
+ * Lee un JSON. Si el fichero no existe, devuelve fallback sin cuarentena.
+ * Si el JSON es inválido, lo mueve a `.broken-…` bajo lock y devuelve fallback.
+ * Si el JSON es válido pero no es objeto/array esperado, también lo considera inválido.
+ *
+ * Nunca sobreescribe la única copia: el rename es atómico y si falla se propaga
+ * sin truncar el original.
+ */
+export declare function readJsonWithQuarantine<T>(filePath: string, fallback: T): Promise<ReadJsonWithQuarantineResult<T>>;
+/**
+ * Variante síncrona.
+ */
+export declare function readJsonWithQuarantineSync<T>(filePath: string, fallback: T): ReadJsonWithQuarantineResult<T>;
+export declare const __internalsForTesting: {
+    quarantineLocks: Map<string, Promise<void>>;
+    isEnoent: typeof isEnoent;
+};
+export {};
+//# sourceMappingURL=quarantine.d.ts.map

package/dist/core/config/quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine.d.ts","sourceRoot":"","sources":["../../../src/core/config/quarantine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,iBAAS,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvC;AAKD,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiB9F;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBrH;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,gBAAgB,CAqB1G;AAED,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC7C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,GACT,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAyB1C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAqB5G;AAED,eAAO,MAAM,qBAAqB;;;CAGjC,CAAC"}

package/dist/core/config/quarantine.js

@@ -0,0 +1,161 @@
+/**
+ * Cuarentena de config corrupta (A05).
+ *
+ * Si un JSON es corrupto, se mueve a `.broken-<timestamp>-<pid>-<uuid>` bajo
+ * file-lock y nunca se sobreescribe la única copia. Espejo de
+ * `config/settings.ts:1305-1323` y `config/config-file.ts:29` de omp, adaptado
+ * a JSON (nuestro formato de settings) y a proper-lockfile / lock en memoria.
+ *
+ * Garantías:
+ *  - Bajo lock: re-valida antes de mover; si otro proceso ya lo movió, falla
+ *    con "invalid before locking and is now missing".
+ *  - Si el rename falla, no se trunca el original: se propaga "could not be
+ *    moved aside; refusing to overwrite".
+ *  - Cuarentena es atómica (rename), no copia+borrado.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+function toError(err) {
+    if (err instanceof Error)
+        return err;
+    return new Error(String(err));
+}
+function isEnoent(err) {
+    return !!err && typeof err === "object" && "code" in err && err.code === "ENOENT";
+}
+// Lock por fichero (intra-proceso) — equivalente a withRepoLock por repo pero por path
+const quarantineLocks = new Map();
+export async function withQuarantineLock(filePath, fn) {
+    const key = path.resolve(filePath);
+    const prev = quarantineLocks.get(key) ?? Promise.resolve();
+    let release;
+    const next = new Promise((r) => {
+        release = r;
+    });
+    quarantineLocks.set(key, prev.then(() => next));
+    await prev;
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Mueve un fichero inválido a `.broken-…` bajo lock.
+ * Debe llamarse solo cuando ya se ha detectado que el contenido es inválido.
+ * Re-valida que el fichero sigue existiendo bajo el lock; si no, significa
+ * que otro proceso ya lo cuarentenó.
+ */
+export async function quarantineInvalidJsonLocked(filePath, originalError) {
+    const resolved = path.resolve(filePath);
+    return withQuarantineLock(resolved, async () => {
+        // Re-validar existencia bajo lock
+        try {
+            await fs.promises.access(resolved);
+        }
+        catch (err) {
+            if (isEnoent(err)) {
+                throw new Error(`Config file was invalid before locking and is now missing: ${filePath}; another process may have moved it aside`);
+            }
+            throw toError(err);
+        }
+        const backupPath = `${resolved}.broken-${Date.now()}-${process.pid}-${randomUUID()}`;
+        try {
+            await fs.promises.rename(resolved, backupPath);
+        }
+        catch (err) {
+            throw new Error(`Config file is invalid and could not be moved aside: ${filePath}; refusing to overwrite it: ${String(err)}`);
+        }
+        return { backupPath, originalError: toError(originalError) };
+    });
+}
+/**
+ * Variante síncrona para callers con lock ya adquirido o contextos sync.
+ */
+export function quarantineInvalidJsonLockedSync(filePath, originalError) {
+    const resolved = path.resolve(filePath);
+    try {
+        fs.accessSync(resolved);
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            throw new Error(`Config file was invalid before locking and is now missing: ${filePath}; another process may have moved it aside`);
+        }
+        throw toError(err);
+    }
+    const backupPath = `${resolved}.broken-${Date.now()}-${process.pid}-${randomUUID()}`;
+    try {
+        fs.renameSync(resolved, backupPath);
+    }
+    catch (err) {
+        throw new Error(`Config file is invalid and could not be moved aside: ${filePath}; refusing to overwrite it: ${String(err)}`);
+    }
+    return { backupPath, originalError: toError(originalError) };
+}
+/**
+ * Lee un JSON. Si el fichero no existe, devuelve fallback sin cuarentena.
+ * Si el JSON es inválido, lo mueve a `.broken-…` bajo lock y devuelve fallback.
+ * Si el JSON es válido pero no es objeto/array esperado, también lo considera inválido.
+ *
+ * Nunca sobreescribe la única copia: el rename es atómico y si falla se propaga
+ * sin truncar el original.
+ */
+export async function readJsonWithQuarantine(filePath, fallback) {
+    let raw;
+    try {
+        raw = await fs.promises.readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            return { data: fallback, wasQuarantined: false };
+        }
+        throw toError(err);
+    }
+    // Fichero vacío → tratar como missing (no cuarentenar)
+    if (raw.trim() === "") {
+        return { data: fallback, wasQuarantined: false };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (parseErr) {
+        const result = await quarantineInvalidJsonLocked(filePath, parseErr);
+        return { data: fallback, quarantinedPath: result.backupPath, wasQuarantined: true, error: result.originalError };
+    }
+    return { data: parsed, wasQuarantined: false };
+}
+/**
+ * Variante síncrona.
+ */
+export function readJsonWithQuarantineSync(filePath, fallback) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            return { data: fallback, wasQuarantined: false };
+        }
+        throw toError(err);
+    }
+    if (raw.trim() === "") {
+        return { data: fallback, wasQuarantined: false };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (parseErr) {
+        const result = quarantineInvalidJsonLockedSync(filePath, parseErr);
+        return { data: fallback, quarantinedPath: result.backupPath, wasQuarantined: true, error: result.originalError };
+    }
+    return { data: parsed, wasQuarantined: false };
+}
+export const __internalsForTesting = {
+    quarantineLocks,
+    isEnoent,
+};
+//# sourceMappingURL=quarantine.js.map

package/dist/core/config/quarantine.js.map

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

package/dist/core/config-viva/ambito.d.ts

@@ -0,0 +1,46 @@
+/**
+ * C05 — Settings con ámbito de ruta (AUDITORIA-OMP.md C05).
+ *
+ * Hoy `enabledModels` es `string[]` plano (settings-manager.ts) y vale igual
+ * en cualquier directorio. En monorepos eso obliga a elegir un único juego de
+ * modelos para todo el árbol. Aquí la misma clave acepta además entradas
+ * acotadas por prefijo de ruta:
+ *
+ *   "enabledModels": [ { "pathPrefix": "/repo/servicios", "values": [...] },
+ *                      { "pathPrefix": "/repo/web",       "values": [...] } ]
+ *
+ * Reglas de resolución (`resolverValorPorAmbito`):
+ *  1. Las capas van ordenadas de MÁS a MENOS prioritaria (proyecto antes que
+ *     global, como deepMergeSettings). La primera capa que responda gana.
+ *  2. Dentro de una capa: un valor plano siempre gana sobre entradas con
+ *     ámbito de esa misma capa (el formato acotado es opt-in por clave).
+ *  3. Entre entradas con ámbito que coinciden con el cwd, gana el prefijo
+ *     LARGO (el más específico).
+ *  4. Si ninguna entrada con ámbito coincide con el cwd, se cae a la capa
+ *     siguiente (fallback global).
+ *
+ * API pura: sin I/O, sin estado, inyectando las capas ya leídas.
+ */
+/** Una entrada de settings acotada a un prefijo de ruta. */
+export interface ValorConAmbito<T> {
+    /** Prefijo de ruta (se normaliza a absoluto); el cwd debe empezar por él. */
+    pathPrefix: string;
+    values: T;
+}
+/** Valor de una clave: plano o lista acotada por prefijos de ruta. */
+export type ValorAmbito<T> = T | Array<ValorConAmbito<T>>;
+/**
+ * Una capa de settings ya leída. `capas[0]` es la MÁS prioritaria
+ * (p.ej. proyecto); la última suele ser la global.
+ */
+export interface CapaAmbito {
+    /** Identificador opcional para diagnóstico (/status). */
+    id?: string;
+    settings: Record<string, unknown>;
+}
+/**
+ * Resuelve `clave` para `cwd` sobre capas ordenadas de más a menos
+ * prioritaria. Devuelve `undefined` si ninguna capa responde.
+ */
+export declare function resolverValorPorAmbito<T>(clave: string, cwd: string, capas: ReadonlyArray<CapaAmbito>): T | undefined;
+//# sourceMappingURL=ambito.d.ts.map

package/dist/core/config-viva/ambito.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambito.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/ambito.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,4DAA4D;AAC5D,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;CACV;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAaD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAsBrH"}

package/dist/core/config-viva/ambito.js

@@ -0,0 +1,62 @@
+/**
+ * C05 — Settings con ámbito de ruta (AUDITORIA-OMP.md C05).
+ *
+ * Hoy `enabledModels` es `string[]` plano (settings-manager.ts) y vale igual
+ * en cualquier directorio. En monorepos eso obliga a elegir un único juego de
+ * modelos para todo el árbol. Aquí la misma clave acepta además entradas
+ * acotadas por prefijo de ruta:
+ *
+ *   "enabledModels": [ { "pathPrefix": "/repo/servicios", "values": [...] },
+ *                      { "pathPrefix": "/repo/web",       "values": [...] } ]
+ *
+ * Reglas de resolución (`resolverValorPorAmbito`):
+ *  1. Las capas van ordenadas de MÁS a MENOS prioritaria (proyecto antes que
+ *     global, como deepMergeSettings). La primera capa que responda gana.
+ *  2. Dentro de una capa: un valor plano siempre gana sobre entradas con
+ *     ámbito de esa misma capa (el formato acotado es opt-in por clave).
+ *  3. Entre entradas con ámbito que coinciden con el cwd, gana el prefijo
+ *     LARGO (el más específico).
+ *  4. Si ninguna entrada con ámbito coincide con el cwd, se cae a la capa
+ *     siguiente (fallback global).
+ *
+ * API pura: sin I/O, sin estado, inyectando las capas ya leídas.
+ */
+import { resolve as resolverRuta } from "node:path";
+function esEntradaConAmbito(valor) {
+    if (typeof valor !== "object" || valor === null || !("pathPrefix" in valor))
+        return false;
+    const prefijo = valor.pathPrefix;
+    return typeof prefijo === "string";
+}
+function normalizarPrefijo(prefijo) {
+    const resuelto = resolverRuta(prefijo);
+    return resuelto.endsWith("/") && resuelto !== "/" ? resuelto.slice(0, -1) : resuelto;
+}
+/**
+ * Resuelve `clave` para `cwd` sobre capas ordenadas de más a menos
+ * prioritaria. Devuelve `undefined` si ninguna capa responde.
+ */
+export function resolverValorPorAmbito(clave, cwd, capas) {
+    const cwdNormalizado = normalizarPrefijo(cwd);
+    for (const capa of capas) {
+        const bruto = capa.settings?.[clave];
+        if (bruto === undefined || bruto === null)
+            continue;
+        if (!Array.isArray(bruto) || !bruto.every(esEntradaConAmbito)) {
+            // Valor plano: gana dentro de su capa sin mirar ámbitos.
+            return bruto;
+        }
+        let mejor;
+        for (const entrada of bruto) {
+            if (!cwdNormalizado.startsWith(normalizarPrefijo(entrada.pathPrefix)))
+                continue;
+            if (!mejor || entrada.pathPrefix.length > mejor.pathPrefix.length)
+                mejor = entrada;
+        }
+        if (mejor)
+            return mejor.values;
+        // Sin coincidencia en esta capa: fallback a la siguiente (global).
+    }
+    return undefined;
+}
+//# sourceMappingURL=ambito.js.map

package/dist/core/config-viva/ambito.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambito.js","sourceRoot":"","sources":["../../../src/core/config-viva/ambito.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAsBpD,SAAS,kBAAkB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1F,MAAM,OAAO,GAAY,KAAK,CAAC,UAAU,CAAC;IAC1C,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACzC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAI,KAAa,EAAE,GAAW,EAAE,KAAgC;IACrG,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAY,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/D,yDAAyD;YACzD,OAAO,KAAU,CAAC;QACnB,CAAC;QAED,IAAI,KAAoC,CAAC;QACzC,KAAK,MAAM,OAAO,IAAI,KAAiC,EAAE,CAAC;YACzD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAAE,SAAS;YAChF,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM;gBAAE,KAAK,GAAG,OAAO,CAAC;QACpF,CAAC;QACD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;QAE/B,mEAAmE;IACpE,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/core/config-viva/cache-negativa.d.ts

@@ -0,0 +1,50 @@
+/**
+ * C07 — Negative-cache con TTL para valores de config que son comandos
+ * (`!cmd`) (AUDITORIA-OMP.md C07).
+ *
+ * Problema en resolve-config-value.ts: `commandResultCache` guarda el
+ * resultado AUNQUE sea undefined y para SIEMPRE (vida del proceso). Un
+ * password manager bloqueado o una red caída en el momento de la primera
+ * lectura desactiva la clave para siempre, además sin límite de re-ejecuciones
+ * cuando se decide no cachear.
+ *
+ * Este envoltorio corrige la dirección que falta:
+ *  - éxito  → caché positiva permanente (misma semántica que upstream);
+ *  - fallo (undefined O throw) → caché NEGATIVA con TTL configurable
+ *    (30s por defecto): dentro del TTL no se re-ejecuta el comando; expirado,
+ *    la siguiente lectura vuelve a intentarlo.
+ *
+ * Pensado sobre `resolveConfigValueUncached` (que nunca cachea) para no
+ * depender del Map interno de upstream.
+ */
+/** TTL por defecto de los fallos: 30 s (C07). */
+export declare const TTL_CACHE_NEGATIVA_DEFECTO_MS = 30000;
+export interface OpcionesCacheNegativa {
+    /** TTL de los fallos cacheados, en ms. Default 30_000. */
+    ttlMs?: number;
+    /** Reloj inyectable (tests). Default Date.now. */
+    ahora?: () => number;
+}
+export interface EstadisticasCacheNegativa {
+    /** Veces que se ejecutó el resolver de verdad. */
+    ejecuciones: number;
+    /** Lecturas servidas por un éxito previo cacheado. */
+    aciertosPositivos: number;
+    /** Lecturas servidas por un fallo aún fresco en caché negativa. */
+    fallosServidosDeCache: number;
+    /** Fallos nuevos registrados en caché negativa. */
+    fallosCacheados: number;
+}
+export type ResolverConCacheNegativa = ((clave: string) => string | undefined) & {
+    /** Vacía ambas cachés (positiva y negativa). */
+    limpiar(): void;
+    /** Contadores desde la creación (o el último limpiar() no los toca). */
+    estadisticas(): EstadisticasCacheNegativa;
+};
+/**
+ * Envuelve `resolver` con caché positiva permanente + negativa con TTL.
+ * Un throw del resolver se trata como fallo cacheable (C07: "exit != 0 o
+ * throw"), no se propaga.
+ */
+export declare function resolverConCacheNegativa(resolver: (clave: string) => string | undefined, opciones?: OpcionesCacheNegativa): ResolverConCacheNegativa;
+//# sourceMappingURL=cache-negativa.d.ts.map

package/dist/core/config-viva/cache-negativa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-negativa.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/cache-negativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACzC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG;IAChF,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC;IAChB,wEAAwE;IACxE,YAAY,IAAI,yBAAyB,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAC/C,QAAQ,GAAE,qBAA0B,GAClC,wBAAwB,CAsD1B"}