@hoilab/ada-cli 0.85.0 → 0.85.1

package/dist/core/browser/sesion.js.map

@@ -1 +1 @@
-{"version":3,"file":"sesion.js","sourceRoot":"","sources":["../../../src/core/browser/sesion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * El navegador del agente.\n *\n * Arranca Chrome con un **perfil propio y vacío** (`--user-data-dir` dentro de\n * `<agentDir>/browser`). Eso no es un detalle de limpieza: convierte la regla\n * de \"solo se conducen las pestañas del agente\" en algo estructural en vez de\n * una promesa. En ese perfil no hay cookies, ni sesiones iniciadas, ni el\n * correo del usuario — aunque el agente se equivoque, no hay nada que filtrar.\n *\n * El precio es que no puede usar sitios donde el usuario ya está identificado.\n * Es el precio correcto: la alternativa es un agente con acceso al banco.\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { existsSync, mkdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { ClienteCdp } from \"./cdp.ts\";\nimport { exigirPestañaPropia, type Pestaña } from \"./politica.ts\";\n\nconst CANDIDATOS_CHROME = [\n\t\"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\",\n\t\"/Applications/Chromium.app/Contents/MacOS/Chromium\",\n\t\"/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge\",\n\t\"/Applications/Brave Browser.app/Contents/MacOS/Brave Browser\",\n\t\"/usr/bin/google-chrome\",\n\t\"/usr/bin/chromium\",\n\t\"/usr/bin/chromium-browser\",\n\t\"C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\n\t\"C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\n];\n\nexport function buscarNavegador(candidatos: string[] = CANDIDATOS_CHROME): string | null {\n\treturn candidatos.find((ruta) => existsSync(ruta)) ?? null;\n}\n\nexport interface OpcionesNavegador {\n\tagentDir: string;\n\t/** 0 = que el sistema elija uno libre, que es lo que queremos. */\n\tpuerto?: number;\n\theadless?: boolean;\n\tejecutable?: string;\n\t/** Ancho y alto iniciales; `browser_viewport` los cambia después. */\n\tviewport?: { width: number; height: number };\n}\n\nexport class NavegadorAgente {\n\tprivate proceso: ChildProcess | null = null;\n\tprivate cliente: ClienteCdp | null = null;\n\tprivate pestañas = new Map<string, Pestaña>();\n\tprivate sesionesPorTarget = new Map<string, string>();\n\n\t// Campo normal y no propiedad de constructor: el repo compila con\n\t// `erasableSyntaxOnly`, que prohíbe la forma corta.\n\tprivate viewport: { width: number; height: number };\n\n\tprivate constructor(proceso: ChildProcess, cliente: ClienteCdp, viewport: { width: number; height: number }) {\n\t\tthis.proceso = proceso;\n\t\tthis.cliente = cliente;\n\t\tthis.viewport = viewport;\n\t}\n\n\tstatic async abrir(opciones: OpcionesNavegador): Promise<NavegadorAgente> {\n\t\tconst ejecutable = opciones.ejecutable ?? buscarNavegador();\n\t\tif (!ejecutable) {\n\t\t\tthrow new Error(\n\t\t\t\t\"No se encontró Chrome, Chromium, Edge ni Brave. Instala uno o pasa la ruta en la configuración.\",\n\t\t\t);\n\t\t}\n\t\tconst perfil = join(opciones.agentDir, \"browser\", \"perfil\");\n\t\tmkdirSync(perfil, { recursive: true, mode: 0o700 });\n\t\tconst viewport = opciones.viewport ?? { width: 1280, height: 800 };\n\n\t\tconst puerto = opciones.puerto ?? 0;\n\t\tconst proceso = spawn(\n\t\t\tejecutable,\n\t\t\t[\n\t\t\t\t`--remote-debugging-port=${puerto}`,\n\t\t\t\t// Perfil propio y vacío: ver la cabecera del fichero.\n\t\t\t\t`--user-data-dir=${perfil}`,\n\t\t\t\t\"--no-first-run\",\n\t\t\t\t\"--no-default-browser-check\",\n\t\t\t\t// Sin esto, Chrome puede reutilizar una instancia ya abierta del\n\t\t\t\t// usuario y acabaríamos conduciendo SU navegador.\n\t\t\t\t\"--disable-features=ChromeWhatsNewUI\",\n\t\t\t\t`--window-size=${viewport.width},${viewport.height}`,\n\t\t\t\t...(opciones.headless ? [\"--headless=new\"] : []),\n\t\t\t\t\"about:blank\",\n\t\t\t],\n\t\t\t{ stdio: [\"ignore\", \"ignore\", \"pipe\"] },\n\t\t);\n\n\t\tconst urlWs = await leerUrlDevTools(proceso);\n\t\tconst cliente = await ClienteCdp.conectar(urlWs);\n\t\treturn new NavegadorAgente(proceso, cliente, viewport);\n\t}\n\n\tprivate exigirCliente(): ClienteCdp {\n\t\tif (!this.cliente) throw new Error(\"el navegador está cerrado\");\n\t\treturn this.cliente;\n\t}\n\n\t/** Abre una pestaña NUEVA. Es la única forma de que el agente tenga una. */\n\tasync abrirPestaña(url: string): Promise<Pestaña> {\n\t\tconst cliente = this.exigirCliente();\n\t\tconst { targetId } = await cliente.enviar<{ targetId: string }>(\"Target.createTarget\", { url });\n\t\tconst { sessionId } = await cliente.enviar<{ sessionId: string }>(\"Target.attachToTarget\", {\n\t\t\ttargetId,\n\t\t\tflatten: true,\n\t\t});\n\t\tthis.sesionesPorTarget.set(targetId, sessionId);\n\t\tconst pestaña: Pestaña = { targetId, url, propia: true };\n\t\tthis.pestañas.set(targetId, pestaña);\n\t\tawait cliente.enviar(\"Page.enable\", {}, sessionId);\n\t\tawait cliente.enviar(\"Runtime.enable\", {}, sessionId);\n\t\treturn pestaña;\n\t}\n\n\tprivate sesionDe(targetId: string): string {\n\t\texigirPestañaPropia(this.pestañas, targetId);\n\t\tconst sessionId = this.sesionesPorTarget.get(targetId);\n\t\tif (!sessionId) throw new Error(`la pestaña ${targetId} no está conectada`);\n\t\treturn sessionId;\n\t}\n\n\tasync navegar(targetId: string, url: string): Promise<void> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\"Page.navigate\", { url }, sessionId);\n\t\tconst pestaña = this.pestañas.get(targetId);\n\t\tif (pestaña) pestaña.url = url;\n\t}\n\n\t/** Evalúa JavaScript en la pestaña y devuelve el valor serializado. */\n\tasync evaluar<T = unknown>(targetId: string, expresion: string): Promise<T> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tconst respuesta = await this.exigirCliente().enviar<{\n\t\t\tresult?: { value?: T };\n\t\t\texceptionDetails?: { text?: string; exception?: { description?: string } };\n\t\t}>(\"Runtime.evaluate\", { expression: expresion, returnByValue: true, awaitPromise: true }, sessionId);\n\t\tif (respuesta.exceptionDetails) {\n\t\t\tthrow new Error(\n\t\t\t\trespuesta.exceptionDetails.exception?.description ??\n\t\t\t\t\trespuesta.exceptionDetails.text ??\n\t\t\t\t\t\"error en la página\",\n\t\t\t);\n\t\t}\n\t\treturn respuesta.result?.value as T;\n\t}\n\n\tasync capturar(targetId: string): Promise<string> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tconst { data } = await this.exigirCliente().enviar<{ data: string }>(\n\t\t\t\"Page.captureScreenshot\",\n\t\t\t{ format: \"png\" },\n\t\t\tsessionId,\n\t\t);\n\t\treturn data;\n\t}\n\n\tasync cambiarViewport(targetId: string, width: number, height: number, movil = false): Promise<void> {\n\t\tconst sessionId = this.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\n\t\t\t\"Emulation.setDeviceMetricsOverride\",\n\t\t\t{ width, height, deviceScaleFactor: 1, mobile: movil },\n\t\t\tsessionId,\n\t\t);\n\t\tthis.viewport = { width, height };\n\t}\n\n\tget viewportActual(): { width: number; height: number } {\n\t\treturn { ...this.viewport };\n\t}\n\n\tasync cerrarPestaña(targetId: string): Promise<void> {\n\t\tthis.sesionDe(targetId);\n\t\tawait this.exigirCliente().enviar(\"Target.closeTarget\", { targetId });\n\t\tthis.pestañas.delete(targetId);\n\t\tthis.sesionesPorTarget.delete(targetId);\n\t}\n\n\tlistarPestañas(): Pestaña[] {\n\t\treturn [...this.pestañas.values()];\n\t}\n\n\tcerrar(): void {\n\t\tthis.cliente?.cerrar();\n\t\tthis.cliente = null;\n\t\tthis.proceso?.kill();\n\t\tthis.proceso = null;\n\t\tthis.pestañas.clear();\n\t\tthis.sesionesPorTarget.clear();\n\t}\n}\n\n/**\n * Lee la URL de DevTools que Chrome escribe en stderr al arrancar.\n *\n * Se lee del proceso en vez de sondear `http://localhost:<puerto>/json/version`\n * porque con `--remote-debugging-port=0` el puerto lo elige el sistema y no lo\n * sabemos de antemano. Sondear un puerto fijo, además, podría acertar con una\n * instancia de Chrome que ya tuviera el usuario abierta — y acabaríamos\n * conduciendo su navegador con sus sesiones.\n */\nfunction leerUrlDevTools(proceso: ChildProcess, timeoutMs = 15_000): Promise<string> {\n\treturn new Promise((resolve, reject) => {\n\t\tlet acumulado = \"\";\n\t\tconst temporizador = setTimeout(() => {\n\t\t\treject(new Error(`el navegador no anunció su puerto de depuración en ${timeoutMs} ms`));\n\t\t}, timeoutMs);\n\n\t\tconst terminar = (fn: () => void) => {\n\t\t\tclearTimeout(temporizador);\n\t\t\tfn();\n\t\t};\n\n\t\tproceso.stderr?.on(\"data\", (trozo: Buffer) => {\n\t\t\tacumulado += trozo.toString(\"utf8\");\n\t\t\tconst encontrado = acumulado.match(/ws:\\/\\/[^\\s]+/);\n\t\t\tif (encontrado) terminar(() => resolve(encontrado[0]));\n\t\t});\n\t\tproceso.on(\"error\", (error) => terminar(() => reject(error)));\n\t\tproceso.on(\"exit\", (codigo) =>\n\t\t\tterminar(() => reject(new Error(`el navegador se cerró con código ${codigo} antes de arrancar`))),\n\t\t);\n\t});\n}\n"]}
+{"version":3,"file":"sesion.js","sourceRoot":"","sources":["../../../src/core/browser/sesion.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4EtE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwOhC","sourcesContent":["/**\n * Tools de navegador para el agente.\n *\n * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.\n * Nadie paga un proceso de Chrome por tener las tools registradas.\n *\n * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se\n * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y\n * además lo hace en un perfil vacío sin ninguna sesión del usuario.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { CampoSecretoError, esCampoSecreto, pareceIrreversible, urlNavegable } from \"./politica.ts\";\nimport { NavegadorAgente, type OpcionesNavegador } from \"./sesion.ts\";\n\n/**\n * Cómo usar el navegador, no solo que existe.\n *\n * Sin esto el modelo intentaría conducir pestañas que no abrió (y que fallan\n * con un error que no entiende), o pulsaría \"Comprar\" sin preguntar.\n */\nfunction guiaNavegador(ordenador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador: true, ordenador }),\n\t\t\"Abre las páginas con browser_open: no puedes conducir las pestañas del usuario, solo las que abras tú.\",\n\t\t\"Usa browser_read antes de pulsar o escribir, y actúa por la referencia que devuelve; vuelve a leer después de navegar.\",\n\t\t\"Si un control envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de pulsarlo.\",\n\t\t\"El navegador del agente usa un perfil vacío: no hay sesiones iniciadas, así que no cuentes con estar identificado en ningún sitio.\",\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/**\n * Script que se inyecta para leer la página.\n *\n * Devuelve el texto y los elementos con los que se puede interactuar, cada uno\n * con una referencia estable dentro de la lectura. Se marcan los campos que\n * piden credenciales y los botones que parecen irreversibles, para que el\n * agente lo sepa ANTES de tocarlos, no después.\n */\nconst LEER_PAGINA = `(() => {\n  const interactivos = [...document.querySelectorAll('a[href],button,input,select,textarea,[role=button],[role=link],[onclick]')];\n  window.__adaRefs = interactivos;\n  const visible = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0; };\n  return {\n    url: location.href,\n    titulo: document.title,\n    texto: (document.body?.innerText ?? '').slice(0, 20000),\n    elementos: interactivos.map((el, i) => ({\n      ref: i,\n      etiqueta: el.tagName.toLowerCase(),\n      type: el.getAttribute('type') ?? undefined,\n      name: el.getAttribute('name') ?? undefined,\n      id: el.id || undefined,\n      autocomplete: el.getAttribute('autocomplete') ?? undefined,\n      placeholder: el.getAttribute('placeholder') ?? undefined,\n      ariaLabel: el.getAttribute('aria-label') ?? undefined,\n      texto: (el.innerText || el.value || '').trim().slice(0, 120),\n      visible: visible(el),\n    })).filter((e) => e.visible).slice(0, 200),\n  };\n})()`;\n\ninterface ElementoLeido {\n\tref: number;\n\tetiqueta: string;\n\ttype?: string;\n\tname?: string;\n\tid?: string;\n\tautocomplete?: string;\n\tplaceholder?: string;\n\tariaLabel?: string;\n\ttexto: string;\n}\n\ninterface PaginaLeida {\n\turl: string;\n\ttitulo: string;\n\ttexto: string;\n\telementos: ElementoLeido[];\n}\n\nexport function crearBrowserTools(\n\topciones: OpcionesNavegador & { ordenador?: boolean },\n): Record<string, ToolDefinition> {\n\t// La regla de elección solo puede nombrar `computer_*` si esas tools existen.\n\tconst guia = guiaNavegador(opciones.ordenador === true);\n\tlet navegador: NavegadorAgente | null = null;\n\n\tconst exigirNavegador = async (): Promise<NavegadorAgente> => {\n\t\tif (!navegador) navegador = await NavegadorAgente.abrir(opciones);\n\t\treturn navegador;\n\t};\n\n\tconst abrir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_open\",\n\t\tlabel: \"Abrir pestaña\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Abre una pestaña NUEVA en el navegador del agente y devuelve su id. \" +\n\t\t\t\"Es la única forma de tener una pestaña: las del usuario no se pueden conducir. \" +\n\t\t\t\"El navegador usa un perfil vacío, así que no hay sesiones iniciadas.\",\n\t\tpromptSnippet: \"abrir una página web para interactuar con ella\",\n\t\tparameters: Type.Object({ url: Type.String({ description: \"URL http(s) a abrir\" }) }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pestaña = await nav.abrirPestaña(url.toString());\n\t\t\t\treturn texto(`Pestaña abierta: ${pestaña.targetId}\\nURL: ${pestaña.url}`);\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 navegar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_navigate\",\n\t\tlabel: \"Navegar\",\n\t\tdescription: \"Lleva una pestaña del agente a otra URL.\",\n\t\tpromptSnippet: \"cambiar de página en una pestaña ya abierta\",\n\t\tparameters: Type.Object({ tabId: Type.String(), url: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.navegar(String(input.tabId), url.toString());\n\t\t\t\treturn texto(`Navegado a ${url}`);\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: \"browser_read\",\n\t\tlabel: \"Leer página\",\n\t\tdescription:\n\t\t\t\"Devuelve el texto de la página y sus elementos interactivos con una referencia cada uno. \" +\n\t\t\t\"Usa esas referencias en browser_click y browser_type. Hay que volver a leer tras navegar.\",\n\t\tpromptSnippet: \"leer el contenido y los controles de una página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pagina = await nav.evaluar<PaginaLeida>(String(input.tabId), LEER_PAGINA);\n\t\t\t\tconst lineas = pagina.elementos.map((e) => {\n\t\t\t\t\tconst marcas = [\n\t\t\t\t\t\tesCampoSecreto(e) ? \"CREDENCIAL — el agente no escribe aquí\" : \"\",\n\t\t\t\t\t\tpareceIrreversible(e.texto) ? \"parece irreversible: pregunta antes\" : \"\",\n\t\t\t\t\t].filter(Boolean);\n\t\t\t\t\tconst desc = e.texto || e.placeholder || e.ariaLabel || e.name || e.id || \"(sin texto)\";\n\t\t\t\t\treturn `  [${e.ref}] <${e.etiqueta}${e.type ? ` type=${e.type}` : \"\"}> ${desc}${marcas.length ? ` ⚠ ${marcas.join(\"; \")}` : \"\"}`;\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\t`${pagina.titulo}\\n${pagina.url}\\n\\n${pagina.texto}\\n\\nElementos interactivos:\\n${lineas.join(\"\\n\") || \"  (ninguno)\"}`,\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 pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia de browser_read. \" +\n\t\t\t\"Si el botón parece irreversible (enviar, comprar, publicar, borrar), pregunta al usuario antes.\",\n\t\tpromptSnippet: \"pulsar un botón o enlace de la página\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst r = await nav.evaluar<{ ok: boolean; texto?: string; motivo?: string }>(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return { ok: false, motivo: 'referencia desconocida; vuelve a leer la página' };\n\t\t\t\t\t  const t = (el.innerText || el.value || '').trim();\n\t\t\t\t\t  el.click();\n\t\t\t\t\t  return { ok: true, texto: t };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!r.ok) return texto(`No se pudo pulsar: ${r.motivo}`);\n\t\t\t\treturn texto(`Pulsado: ${r.texto || \"(sin 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\tconst escribir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un campo por su referencia. \" +\n\t\t\t\"Nunca escribe en campos de contraseña, token o tarjeta: eso lo hace el usuario.\",\n\t\tpromptSnippet: \"rellenar un campo de un formulario\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst tabId = String(input.tabId);\n\t\t\t\t// Se comprueba en el momento, no con lo leído antes: la página pudo\n\t\t\t\t// cambiar el campo entre la lectura y ahora.\n\t\t\t\tconst campo = await nav.evaluar<ElementoLeido | null>(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return null;\n\t\t\t\t\t  return { ref: ${Number(input.ref)}, etiqueta: el.tagName.toLowerCase(), type: el.getAttribute('type') ?? undefined,\n\t\t\t\t\t    name: el.getAttribute('name') ?? undefined, id: el.id || undefined,\n\t\t\t\t\t    autocomplete: el.getAttribute('autocomplete') ?? undefined,\n\t\t\t\t\t    placeholder: el.getAttribute('placeholder') ?? undefined,\n\t\t\t\t\t    ariaLabel: el.getAttribute('aria-label') ?? undefined, texto: '' };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!campo) return texto(\"No se pudo escribir: referencia desconocida; vuelve a leer la página.\");\n\t\t\t\tif (esCampoSecreto(campo)) return fallo(new CampoSecretoError());\n\n\t\t\t\tawait nav.evaluar(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = window.__adaRefs[${Number(input.ref)}];\n\t\t\t\t\t  const setter = Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value')?.set;\n\t\t\t\t\t  // El setter del prototipo, no el de la instancia: React sobrescribe\n\t\t\t\t\t  // el de la instancia y su onChange no se enteraría del cambio.\n\t\t\t\t\t  if (setter) setter.call(el, ${JSON.stringify(String(input.texto ?? \"\"))});\n\t\t\t\t\t  else el.value = ${JSON.stringify(String(input.texto ?? \"\"))};\n\t\t\t\t\t  el.dispatchEvent(new Event('input', { bubbles: true }));\n\t\t\t\t\t  el.dispatchEvent(new Event('change', { bubbles: true }));\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\treturn texto(`Escrito en [${Number(input.ref)}].`);\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 capturar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_screenshot\",\n\t\tlabel: \"Captura\",\n\t\tdescription: \"Captura la pestaña y devuelve la imagen.\",\n\t\tpromptSnippet: \"ver cómo se ve la página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst data = await nav.capturar(String(input.tabId));\n\t\t\t\treturn { content: [{ type: \"image\" as const, data, 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 viewport: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_viewport\",\n\t\tlabel: \"Cambiar viewport\",\n\t\tdescription:\n\t\t\t\"Cambia el tamaño de la ventana emulada. Con movil=true, una página SIN <meta name=viewport> \" +\n\t\t\t\"usará el viewport heredado de 980 px: es lo que hace un teléfono de verdad, no un fallo.\",\n\t\tpromptSnippet: \"probar la página en otro tamaño de pantalla\",\n\t\tparameters: Type.Object({\n\t\t\ttabId: Type.String(),\n\t\t\twidth: Type.Number(),\n\t\t\theight: Type.Number(),\n\t\t\tmovil: Type.Optional(Type.Boolean()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cambiarViewport(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\tNumber(input.width),\n\t\t\t\t\tNumber(input.height),\n\t\t\t\t\tinput.movil === true,\n\t\t\t\t);\n\t\t\t\treturn texto(`Viewport: ${Number(input.width)}x${Number(input.height)}${input.movil ? \" (móvil)\" : \"\"}`);\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 cerrar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_close\",\n\t\tlabel: \"Cerrar pestaña\",\n\t\tdescription: \"Cierra una pestaña del agente.\",\n\t\tpromptSnippet: \"cerrar una pestaña que ya no hace falta\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cerrarPestaña(String(input.tabId));\n\t\t\t\treturn texto(\"Pestaña cerrada.\");\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\tbrowser_open: abrir as ToolDefinition,\n\t\tbrowser_navigate: navegar as ToolDefinition,\n\t\tbrowser_read: leer as ToolDefinition,\n\t\tbrowser_click: pulsar as ToolDefinition,\n\t\tbrowser_type: escribir as ToolDefinition,\n\t\tbrowser_screenshot: capturar as ToolDefinition,\n\t\tbrowser_viewport: viewport as ToolDefinition,\n\t\tbrowser_close: cerrar as ToolDefinition,\n\t};\n}\n"]}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4EtE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAwOhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tools de navegador para el agente.\n *\n * El navegador arranca perezosamente: la primera tool que lo necesita lo abre.\n * Nadie paga un proceso de Chrome por tener las tools registradas.\n *\n * Las tres reglas viven en `politica.ts` y aquí solo se aplican. La que más se\n * nota en el uso: el agente **solo conduce las pestañas que abrió él**, y\n * además lo hace en un perfil vacío sin ninguna sesión del usuario.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport { reglaDeEleccion } from \"../prompt-eleccion.ts\";\nimport { CampoSecretoError, esCampoSecreto, pareceIrreversible, urlNavegable } from \"./politica.ts\";\nimport { NavegadorAgente, type OpcionesNavegador } from \"./sesion.ts\";\n\n/**\n * Cómo usar el navegador, no solo que existe.\n *\n * Sin esto el modelo intentaría conducir pestañas que no abrió (y que fallan\n * con un error que no entiende), o pulsaría \"Comprar\" sin preguntar.\n */\nfunction guiaNavegador(ordenador: boolean): string[] {\n\treturn [\n\t\treglaDeEleccion({ navegador: true, ordenador }),\n\t\t\"Abre las páginas con browser_open: no puedes conducir las pestañas del usuario, solo las que abras tú.\",\n\t\t\"Usa browser_read antes de pulsar o escribir, y actúa por la referencia que devuelve; vuelve a leer después de navegar.\",\n\t\t\"Si un control envía, compra, publica, borra o acepta condiciones, pregunta al usuario ANTES de pulsarlo.\",\n\t\t\"El navegador del agente usa un perfil vacío: no hay sesiones iniciadas, así que no cuentes con estar identificado en ningún sitio.\",\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/**\n * Script que se inyecta para leer la página.\n *\n * Devuelve el texto y los elementos con los que se puede interactuar, cada uno\n * con una referencia estable dentro de la lectura. Se marcan los campos que\n * piden credenciales y los botones que parecen irreversibles, para que el\n * agente lo sepa ANTES de tocarlos, no después.\n */\nconst LEER_PAGINA = `(() => {\n  const interactivos = [...document.querySelectorAll('a[href],button,input,select,textarea,[role=button],[role=link],[onclick]')];\n  window.__adaRefs = interactivos;\n  const visible = (el) => { const r = el.getBoundingClientRect(); return r.width > 0 && r.height > 0; };\n  return {\n    url: location.href,\n    titulo: document.title,\n    texto: (document.body?.innerText ?? '').slice(0, 20000),\n    elementos: interactivos.map((el, i) => ({\n      ref: i,\n      etiqueta: el.tagName.toLowerCase(),\n      type: el.getAttribute('type') ?? undefined,\n      name: el.getAttribute('name') ?? undefined,\n      id: el.id || undefined,\n      autocomplete: el.getAttribute('autocomplete') ?? undefined,\n      placeholder: el.getAttribute('placeholder') ?? undefined,\n      ariaLabel: el.getAttribute('aria-label') ?? undefined,\n      texto: (el.innerText || el.value || '').trim().slice(0, 120),\n      visible: visible(el),\n    })).filter((e) => e.visible).slice(0, 200),\n  };\n})()`;\n\ninterface ElementoLeido {\n\tref: number;\n\tetiqueta: string;\n\ttype?: string;\n\tname?: string;\n\tid?: string;\n\tautocomplete?: string;\n\tplaceholder?: string;\n\tariaLabel?: string;\n\ttexto: string;\n}\n\ninterface PaginaLeida {\n\turl: string;\n\ttitulo: string;\n\ttexto: string;\n\telementos: ElementoLeido[];\n}\n\nexport function crearBrowserTools(\n\topciones: OpcionesNavegador & { ordenador?: boolean },\n): Record<string, ToolDefinition> {\n\t// La regla de elección solo puede nombrar `computer_*` si esas tools existen.\n\tconst guia = guiaNavegador(opciones.ordenador === true);\n\tlet navegador: NavegadorAgente | null = null;\n\n\tconst exigirNavegador = async (): Promise<NavegadorAgente> => {\n\t\tif (!navegador) navegador = await NavegadorAgente.abrir(opciones);\n\t\treturn navegador;\n\t};\n\n\tconst abrir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_open\",\n\t\tlabel: \"Abrir pestaña\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Abre una pestaña NUEVA en el navegador del agente y devuelve su id. \" +\n\t\t\t\"Es la única forma de tener una pestaña: las del usuario no se pueden conducir. \" +\n\t\t\t\"El navegador usa un perfil vacío, así que no hay sesiones iniciadas.\",\n\t\tpromptSnippet: \"abrir una página web para interactuar con ella\",\n\t\tparameters: Type.Object({ url: Type.String({ description: \"URL http(s) a abrir\" }) }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pestaña = await nav.abrirPestaña(url.toString());\n\t\t\t\treturn texto(`Pestaña abierta: ${pestaña.targetId}\\nURL: ${pestaña.url}`);\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 navegar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_navigate\",\n\t\tlabel: \"Navegar\",\n\t\tdescription: \"Lleva una pestaña del agente a otra URL.\",\n\t\tpromptSnippet: \"cambiar de página en una pestaña ya abierta\",\n\t\tparameters: Type.Object({ tabId: Type.String(), url: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst url = urlNavegable(String(input.url ?? \"\"));\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.navegar(String(input.tabId), url.toString());\n\t\t\t\treturn texto(`Navegado a ${url}`);\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: \"browser_read\",\n\t\tlabel: \"Leer página\",\n\t\tdescription:\n\t\t\t\"Devuelve el texto de la página y sus elementos interactivos con una referencia cada uno. \" +\n\t\t\t\"Usa esas referencias en browser_click y browser_type. Hay que volver a leer tras navegar.\",\n\t\tpromptSnippet: \"leer el contenido y los controles de una página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst pagina = await nav.evaluar<PaginaLeida>(String(input.tabId), LEER_PAGINA);\n\t\t\t\tconst lineas = pagina.elementos.map((e) => {\n\t\t\t\t\tconst marcas = [\n\t\t\t\t\t\tesCampoSecreto(e) ? \"CREDENCIAL — el agente no escribe aquí\" : \"\",\n\t\t\t\t\t\tpareceIrreversible(e.texto) ? \"parece irreversible: pregunta antes\" : \"\",\n\t\t\t\t\t].filter(Boolean);\n\t\t\t\t\tconst desc = e.texto || e.placeholder || e.ariaLabel || e.name || e.id || \"(sin texto)\";\n\t\t\t\t\treturn `  [${e.ref}] <${e.etiqueta}${e.type ? ` type=${e.type}` : \"\"}> ${desc}${marcas.length ? ` ⚠ ${marcas.join(\"; \")}` : \"\"}`;\n\t\t\t\t});\n\t\t\t\treturn texto(\n\t\t\t\t\t`${pagina.titulo}\\n${pagina.url}\\n\\n${pagina.texto}\\n\\nElementos interactivos:\\n${lineas.join(\"\\n\") || \"  (ninguno)\"}`,\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 pulsar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_click\",\n\t\tlabel: \"Pulsar\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Pulsa un elemento por su referencia de browser_read. \" +\n\t\t\t\"Si el botón parece irreversible (enviar, comprar, publicar, borrar), pregunta al usuario antes.\",\n\t\tpromptSnippet: \"pulsar un botón o enlace de la página\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst r = await nav.evaluar<{ ok: boolean; texto?: string; motivo?: string }>(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return { ok: false, motivo: 'referencia desconocida; vuelve a leer la página' };\n\t\t\t\t\t  const t = (el.innerText || el.value || '').trim();\n\t\t\t\t\t  el.click();\n\t\t\t\t\t  return { ok: true, texto: t };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!r.ok) return texto(`No se pudo pulsar: ${r.motivo}`);\n\t\t\t\treturn texto(`Pulsado: ${r.texto || \"(sin 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\tconst escribir: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_type\",\n\t\tlabel: \"Escribir\",\n\t\tpromptGuidelines: guia,\n\t\tdescription:\n\t\t\t\"Escribe texto en un campo por su referencia. \" +\n\t\t\t\"Nunca escribe en campos de contraseña, token o tarjeta: eso lo hace el usuario.\",\n\t\tpromptSnippet: \"rellenar un campo de un formulario\",\n\t\tparameters: Type.Object({ tabId: Type.String(), ref: Type.Number(), texto: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst tabId = String(input.tabId);\n\t\t\t\t// Se comprueba en el momento, no con lo leído antes: la página pudo\n\t\t\t\t// cambiar el campo entre la lectura y ahora.\n\t\t\t\tconst campo = await nav.evaluar<ElementoLeido | null>(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = (window.__adaRefs || [])[${Number(input.ref)}];\n\t\t\t\t\t  if (!el) return null;\n\t\t\t\t\t  return { ref: ${Number(input.ref)}, etiqueta: el.tagName.toLowerCase(), type: el.getAttribute('type') ?? undefined,\n\t\t\t\t\t    name: el.getAttribute('name') ?? undefined, id: el.id || undefined,\n\t\t\t\t\t    autocomplete: el.getAttribute('autocomplete') ?? undefined,\n\t\t\t\t\t    placeholder: el.getAttribute('placeholder') ?? undefined,\n\t\t\t\t\t    ariaLabel: el.getAttribute('aria-label') ?? undefined, texto: '' };\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\tif (!campo) return texto(\"No se pudo escribir: referencia desconocida; vuelve a leer la página.\");\n\t\t\t\tif (esCampoSecreto(campo)) return fallo(new CampoSecretoError());\n\n\t\t\t\tawait nav.evaluar(\n\t\t\t\t\ttabId,\n\t\t\t\t\t`(() => {\n\t\t\t\t\t  const el = window.__adaRefs[${Number(input.ref)}];\n\t\t\t\t\t  const setter = Object.getOwnPropertyDescriptor(el.constructor.prototype, 'value')?.set;\n\t\t\t\t\t  // El setter del prototipo, no el de la instancia: React sobrescribe\n\t\t\t\t\t  // el de la instancia y su onChange no se enteraría del cambio.\n\t\t\t\t\t  if (setter) setter.call(el, ${JSON.stringify(String(input.texto ?? \"\"))});\n\t\t\t\t\t  else el.value = ${JSON.stringify(String(input.texto ?? \"\"))};\n\t\t\t\t\t  el.dispatchEvent(new Event('input', { bubbles: true }));\n\t\t\t\t\t  el.dispatchEvent(new Event('change', { bubbles: true }));\n\t\t\t\t\t})()`,\n\t\t\t\t);\n\t\t\t\treturn texto(`Escrito en [${Number(input.ref)}].`);\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 capturar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_screenshot\",\n\t\tlabel: \"Captura\",\n\t\tdescription: \"Captura la pestaña y devuelve la imagen.\",\n\t\tpromptSnippet: \"ver cómo se ve la página\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tconst data = await nav.capturar(String(input.tabId));\n\t\t\t\treturn { content: [{ type: \"image\" as const, data, 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 viewport: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_viewport\",\n\t\tlabel: \"Cambiar viewport\",\n\t\tdescription:\n\t\t\t\"Cambia el tamaño de la ventana emulada. Con movil=true, una página SIN <meta name=viewport> \" +\n\t\t\t\"usará el viewport heredado de 980 px: es lo que hace un teléfono de verdad, no un fallo.\",\n\t\tpromptSnippet: \"probar la página en otro tamaño de pantalla\",\n\t\tparameters: Type.Object({\n\t\t\ttabId: Type.String(),\n\t\t\twidth: Type.Number(),\n\t\t\theight: Type.Number(),\n\t\t\tmovil: Type.Optional(Type.Boolean()),\n\t\t}),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cambiarViewport(\n\t\t\t\t\tString(input.tabId),\n\t\t\t\t\tNumber(input.width),\n\t\t\t\t\tNumber(input.height),\n\t\t\t\t\tinput.movil === true,\n\t\t\t\t);\n\t\t\t\treturn texto(`Viewport: ${Number(input.width)}x${Number(input.height)}${input.movil ? \" (móvil)\" : \"\"}`);\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 cerrar: ToolDefinition<ReturnType<typeof Type.Object>> = {\n\t\tname: \"browser_close\",\n\t\tlabel: \"Cerrar pestaña\",\n\t\tdescription: \"Cierra una pestaña del agente.\",\n\t\tpromptSnippet: \"cerrar una pestaña que ya no hace falta\",\n\t\tparameters: Type.Object({ tabId: Type.String() }),\n\t\tasync execute(_id, input): Promise<AgentToolResult<unknown>> {\n\t\t\ttry {\n\t\t\t\tconst nav = await exigirNavegador();\n\t\t\t\tawait nav.cerrarPestaña(String(input.tabId));\n\t\t\t\treturn texto(\"Pestaña cerrada.\");\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\tbrowser_open: abrir as ToolDefinition,\n\t\tbrowser_navigate: navegar as ToolDefinition,\n\t\tbrowser_read: leer as ToolDefinition,\n\t\tbrowser_click: pulsar as ToolDefinition,\n\t\tbrowser_type: escribir as ToolDefinition,\n\t\tbrowser_screenshot: capturar as ToolDefinition,\n\t\tbrowser_viewport: viewport as ToolDefinition,\n\t\tbrowser_close: cerrar as ToolDefinition,\n\t};\n}\n"]}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/browser/tools.ts"],"names":[],"mappings":"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"}

package/dist/core/cache-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-stats.d.ts","sourceRoot":"","sources":["../../src/core/cache-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAgB,CAAC;AAK1C,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACzB,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,CAAC;CACzF;AAmGD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAErG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,gBAAgB,GACtB,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAElC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,gBAAgB,GACtB,SAAS,GAAG,SAAS,CAEvB","sourcesContent":["import type { AssistantMessage } from \"@earendil-works/pi-ai\";\nimport type { SessionEntry } from \"./session-manager.ts\";\n\n/**\n * Prompt-cache TTL: idle gaps longer than this are worth mentioning as the\n * likely cause of a miss. Anthropic's default cache TTL is 5 minutes.\n */\nexport const CACHE_TTL_MS = 5 * 60 * 1000;\n\n/** Per-turn misses at or below this are cache breakpoint granularity noise. */\nconst NOISE_FLOOR_TOKENS = 1024;\n\n/** A counted cache miss on a single assistant message. */\nexport interface CacheMiss {\n\t/** Prompt tokens that were in the previous turn's prompt but not read from cache. */\n\tmissedTokens: number;\n\t/** Extra dollars paid vs. a full cache hit; 0 when pricing is unknown. */\n\tmissedCost: number;\n\t/** Milliseconds since the previous request (which last refreshed the cache). */\n\tidleMs: number;\n\t/** True when the model changed relative to the previous request. */\n\tmodelChanged: boolean;\n}\n\nexport interface CacheWasteTotals {\n\tmissedTokens: number;\n\tmissedCost: number;\n\t/** Number of counted misses (turns above the noise floor). */\n\tmissCount: number;\n}\n\n/** Minimal pricing lookup, satisfied by ModelRuntime. Cost is $/million tokens. */\nexport interface ModelPriceSource {\n\tgetModel(provider: string, modelId: string): { cost: { cacheRead: number } } | undefined;\n}\n\n/** The last request seen by the scan; everything in its prompt should be cached. */\ninterface PreviousRequest {\n\tpromptTokens: number;\n\tmodelKey: string;\n\ttimestamp: number;\n\t/**\n\t * Sticky: some earlier request in this scan segment reported cache activity.\n\t * Distinguishes a total miss on a cache-read-only provider (OpenAI-style,\n\t * writes unreported) from a provider that never reports caching at all.\n\t */\n\treportedCache: boolean;\n}\n\n/**\n * Compute the cache miss for one assistant message relative to the previous\n * request. Returns undefined when nothing is counted: first turn, after a\n * reset, no cache activity ever reported (provider without cache support), or\n * miss below the noise floor.\n */\nfunction detectMiss(\n\tprev: PreviousRequest | undefined,\n\tmessage: AssistantMessage,\n\tmodels: ModelPriceSource,\n): CacheMiss | undefined {\n\tconst usage = message.usage;\n\tconst promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;\n\t// A zero-cache turn only counts when cache activity was reported before:\n\t// on cache-read-only providers that is a total miss, while on providers\n\t// that never report caching it means nothing.\n\tif (!prev || promptTokens <= 0 || (usage.cacheRead + usage.cacheWrite === 0 && !prev.reportedCache)) {\n\t\treturn undefined;\n\t}\n\n\tconst missedTokens = Math.min(prev.promptTokens, promptTokens) - usage.cacheRead;\n\tif (missedTokens <= NOISE_FLOOR_TOKENS) return undefined;\n\n\t// Extra cost = missed tokens billed at the actual paid rate (input/cacheWrite,\n\t// incl. write premium) instead of the cache-read rate. Missed tokens can only\n\t// land in the input or cacheWrite buckets, so the paid rate comes straight\n\t// from this message's own cost breakdown.\n\tconst paidTokens = usage.input + usage.cacheWrite;\n\tconst paidPerToken = paidTokens > 0 ? (usage.cost.input + usage.cost.cacheWrite) / paidTokens : 0;\n\tconst readPerToken =\n\t\tusage.cacheRead > 0\n\t\t\t? usage.cost.cacheRead / usage.cacheRead\n\t\t\t: (models.getModel(message.provider, message.model)?.cost.cacheRead ?? 0) / 1_000_000;\n\n\treturn {\n\t\tmissedTokens,\n\t\tmissedCost: missedTokens * Math.max(0, paidPerToken - readPerToken),\n\t\tidleMs: Math.max(0, message.timestamp - prev.timestamp),\n\t\tmodelChanged: `${message.provider}/${message.model}` !== prev.modelKey,\n\t};\n}\n\nfunction asPreviousRequest(message: AssistantMessage, reportedCache: boolean): PreviousRequest | undefined {\n\tconst usage = message.usage;\n\tconst promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;\n\tif (promptTokens <= 0) return undefined;\n\treturn {\n\t\tpromptTokens,\n\t\tmodelKey: `${message.provider}/${message.model}`,\n\t\ttimestamp: message.timestamp,\n\t\treportedCache: reportedCache || usage.cacheRead + usage.cacheWrite > 0,\n\t};\n}\n\nfunction scan(\n\tentries: SessionEntry[],\n\tmodels: ModelPriceSource,\n): { prev: PreviousRequest | undefined; totals: CacheWasteTotals; misses: Map<AssistantMessage, CacheMiss> } {\n\tlet prev: PreviousRequest | undefined;\n\tconst totals: CacheWasteTotals = { missedTokens: 0, missedCost: 0, missCount: 0 };\n\tconst misses = new Map<AssistantMessage, CacheMiss>();\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"compaction\" || entry.type === \"branch_summary\") {\n\t\t\t// The context legitimately changed; the next turn's prompt is new content,\n\t\t\t// not re-billed content. Model switches are NOT exempt: they re-bill the\n\t\t\t// full prompt and should be counted.\n\t\t\tprev = undefined;\n\t\t\tcontinue;\n\t\t}\n\t\tif (entry.type === \"message\" && entry.message.role === \"assistant\") {\n\t\t\tconst miss = detectMiss(prev, entry.message, models);\n\t\t\tif (miss) {\n\t\t\t\ttotals.missedTokens += miss.missedTokens;\n\t\t\t\ttotals.missedCost += miss.missedCost;\n\t\t\t\ttotals.missCount += 1;\n\t\t\t\tmisses.set(entry.message, miss);\n\t\t\t}\n\t\t\tprev = asPreviousRequest(entry.message, prev?.reportedCache ?? false) ?? prev;\n\t\t}\n\t}\n\treturn { prev, totals, misses };\n}\n\n/**\n * Cumulative cache waste across a session: prompt tokens that should have been\n * cache reads (they were in the previous turn's prompt) but were re-billed.\n */\nexport function computeCacheWaste(entries: SessionEntry[], models: ModelPriceSource): CacheWasteTotals {\n\treturn scan(entries, models).totals;\n}\n\n/**\n * All counted cache misses across a session, keyed by the assistant message\n * (by reference) that paid for them. Used to re-derive transcript notices when\n * rebuilding the chat from entries (resume, post-compaction rebuild).\n */\nexport function collectCacheMisses(\n\tentries: SessionEntry[],\n\tmodels: ModelPriceSource,\n): Map<AssistantMessage, CacheMiss> {\n\treturn scan(entries, models).misses;\n}\n\n/**\n * Detect a cache miss on a just-completed assistant message.\n * `entries` must not yet contain `message` (message_end fires before persistence).\n */\nexport function detectCacheMiss(\n\tentries: SessionEntry[],\n\tmessage: AssistantMessage,\n\tmodels: ModelPriceSource,\n): CacheMiss | undefined {\n\treturn detectMiss(scan(entries, models).prev, message, models);\n}\n"]}
+{"version":3,"file":"cache-stats.d.ts","sourceRoot":"","sources":["../../src/core/cache-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAgB,CAAC;AAK1C,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACzB,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,CAAC;CACzF;AAmGD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAErG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,gBAAgB,GACtB,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAElC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,gBAAgB,GACtB,SAAS,GAAG,SAAS,CAEvB"}

package/dist/core/cache-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-stats.js","sourceRoot":"","sources":["../../src/core/cache-stats.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage } from \"@earendil-works/pi-ai\";\nimport type { SessionEntry } from \"./session-manager.ts\";\n\n/**\n * Prompt-cache TTL: idle gaps longer than this are worth mentioning as the\n * likely cause of a miss. Anthropic's default cache TTL is 5 minutes.\n */\nexport const CACHE_TTL_MS = 5 * 60 * 1000;\n\n/** Per-turn misses at or below this are cache breakpoint granularity noise. */\nconst NOISE_FLOOR_TOKENS = 1024;\n\n/** A counted cache miss on a single assistant message. */\nexport interface CacheMiss {\n\t/** Prompt tokens that were in the previous turn's prompt but not read from cache. */\n\tmissedTokens: number;\n\t/** Extra dollars paid vs. a full cache hit; 0 when pricing is unknown. */\n\tmissedCost: number;\n\t/** Milliseconds since the previous request (which last refreshed the cache). */\n\tidleMs: number;\n\t/** True when the model changed relative to the previous request. */\n\tmodelChanged: boolean;\n}\n\nexport interface CacheWasteTotals {\n\tmissedTokens: number;\n\tmissedCost: number;\n\t/** Number of counted misses (turns above the noise floor). */\n\tmissCount: number;\n}\n\n/** Minimal pricing lookup, satisfied by ModelRuntime. Cost is $/million tokens. */\nexport interface ModelPriceSource {\n\tgetModel(provider: string, modelId: string): { cost: { cacheRead: number } } | undefined;\n}\n\n/** The last request seen by the scan; everything in its prompt should be cached. */\ninterface PreviousRequest {\n\tpromptTokens: number;\n\tmodelKey: string;\n\ttimestamp: number;\n\t/**\n\t * Sticky: some earlier request in this scan segment reported cache activity.\n\t * Distinguishes a total miss on a cache-read-only provider (OpenAI-style,\n\t * writes unreported) from a provider that never reports caching at all.\n\t */\n\treportedCache: boolean;\n}\n\n/**\n * Compute the cache miss for one assistant message relative to the previous\n * request. Returns undefined when nothing is counted: first turn, after a\n * reset, no cache activity ever reported (provider without cache support), or\n * miss below the noise floor.\n */\nfunction detectMiss(\n\tprev: PreviousRequest | undefined,\n\tmessage: AssistantMessage,\n\tmodels: ModelPriceSource,\n): CacheMiss | undefined {\n\tconst usage = message.usage;\n\tconst promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;\n\t// A zero-cache turn only counts when cache activity was reported before:\n\t// on cache-read-only providers that is a total miss, while on providers\n\t// that never report caching it means nothing.\n\tif (!prev || promptTokens <= 0 || (usage.cacheRead + usage.cacheWrite === 0 && !prev.reportedCache)) {\n\t\treturn undefined;\n\t}\n\n\tconst missedTokens = Math.min(prev.promptTokens, promptTokens) - usage.cacheRead;\n\tif (missedTokens <= NOISE_FLOOR_TOKENS) return undefined;\n\n\t// Extra cost = missed tokens billed at the actual paid rate (input/cacheWrite,\n\t// incl. write premium) instead of the cache-read rate. Missed tokens can only\n\t// land in the input or cacheWrite buckets, so the paid rate comes straight\n\t// from this message's own cost breakdown.\n\tconst paidTokens = usage.input + usage.cacheWrite;\n\tconst paidPerToken = paidTokens > 0 ? (usage.cost.input + usage.cost.cacheWrite) / paidTokens : 0;\n\tconst readPerToken =\n\t\tusage.cacheRead > 0\n\t\t\t? usage.cost.cacheRead / usage.cacheRead\n\t\t\t: (models.getModel(message.provider, message.model)?.cost.cacheRead ?? 0) / 1_000_000;\n\n\treturn {\n\t\tmissedTokens,\n\t\tmissedCost: missedTokens * Math.max(0, paidPerToken - readPerToken),\n\t\tidleMs: Math.max(0, message.timestamp - prev.timestamp),\n\t\tmodelChanged: `${message.provider}/${message.model}` !== prev.modelKey,\n\t};\n}\n\nfunction asPreviousRequest(message: AssistantMessage, reportedCache: boolean): PreviousRequest | undefined {\n\tconst usage = message.usage;\n\tconst promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;\n\tif (promptTokens <= 0) return undefined;\n\treturn {\n\t\tpromptTokens,\n\t\tmodelKey: `${message.provider}/${message.model}`,\n\t\ttimestamp: message.timestamp,\n\t\treportedCache: reportedCache || usage.cacheRead + usage.cacheWrite > 0,\n\t};\n}\n\nfunction scan(\n\tentries: SessionEntry[],\n\tmodels: ModelPriceSource,\n): { prev: PreviousRequest | undefined; totals: CacheWasteTotals; misses: Map<AssistantMessage, CacheMiss> } {\n\tlet prev: PreviousRequest | undefined;\n\tconst totals: CacheWasteTotals = { missedTokens: 0, missedCost: 0, missCount: 0 };\n\tconst misses = new Map<AssistantMessage, CacheMiss>();\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"compaction\" || entry.type === \"branch_summary\") {\n\t\t\t// The context legitimately changed; the next turn's prompt is new content,\n\t\t\t// not re-billed content. Model switches are NOT exempt: they re-bill the\n\t\t\t// full prompt and should be counted.\n\t\t\tprev = undefined;\n\t\t\tcontinue;\n\t\t}\n\t\tif (entry.type === \"message\" && entry.message.role === \"assistant\") {\n\t\t\tconst miss = detectMiss(prev, entry.message, models);\n\t\t\tif (miss) {\n\t\t\t\ttotals.missedTokens += miss.missedTokens;\n\t\t\t\ttotals.missedCost += miss.missedCost;\n\t\t\t\ttotals.missCount += 1;\n\t\t\t\tmisses.set(entry.message, miss);\n\t\t\t}\n\t\t\tprev = asPreviousRequest(entry.message, prev?.reportedCache ?? false) ?? prev;\n\t\t}\n\t}\n\treturn { prev, totals, misses };\n}\n\n/**\n * Cumulative cache waste across a session: prompt tokens that should have been\n * cache reads (they were in the previous turn's prompt) but were re-billed.\n */\nexport function computeCacheWaste(entries: SessionEntry[], models: ModelPriceSource): CacheWasteTotals {\n\treturn scan(entries, models).totals;\n}\n\n/**\n * All counted cache misses across a session, keyed by the assistant message\n * (by reference) that paid for them. Used to re-derive transcript notices when\n * rebuilding the chat from entries (resume, post-compaction rebuild).\n */\nexport function collectCacheMisses(\n\tentries: SessionEntry[],\n\tmodels: ModelPriceSource,\n): Map<AssistantMessage, CacheMiss> {\n\treturn scan(entries, models).misses;\n}\n\n/**\n * Detect a cache miss on a just-completed assistant message.\n * `entries` must not yet contain `message` (message_end fires before persistence).\n */\nexport function detectCacheMiss(\n\tentries: SessionEntry[],\n\tmessage: AssistantMessage,\n\tmodels: ModelPriceSource,\n): CacheMiss | undefined {\n\treturn detectMiss(scan(entries, models).prev, message, models);\n}\n"]}
+{"version":3,"file":"cache-stats.js","sourceRoot":"","sources":["../../src/core/cache-stats.ts"],"names":[],"mappings":"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"}

package/dist/core/capability/capability.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests del capability registry multi-origen (B01).
+ *
+ * Valida el contrato central: providers priorizados con dedup first-wins,
+ * y las tres semánticas que lo hacen útil en la práctica:
+ * filter (no reclama clave) vs suppress (sí reclama, ensombrece) vs
+ * equivalent (dedup semántico entre claves distintas), más validación
+ * post-dedup. Cada test tiene su mitad que distingue (el mismo setup con la
+ * variante contraria) para que un verde no sea por comparar dos vacíos.
+ */
+export {};
+//# sourceMappingURL=capability.test.d.ts.map

package/dist/core/capability/capability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.test.d.ts","sourceRoot":"","sources":["../../../src/core/capability/capability.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/core/capability/capability.test.js

@@ -0,0 +1,258 @@
+/**
+ * Tests del capability registry multi-origen (B01).
+ *
+ * Valida el contrato central: providers priorizados con dedup first-wins,
+ * y las tres semánticas que lo hacen útil en la práctica:
+ * filter (no reclama clave) vs suppress (sí reclama, ensombrece) vs
+ * equivalent (dedup semántico entre claves distintas), más validación
+ * post-dedup. Cada test tiene su mitad que distingue (el mismo setup con la
+ * variante contraria) para que un verde no sea por comparar dos vacíos.
+ */
+import { describe, expect, it } from "vitest";
+import { clearRegistryForTesting, defineCapability, loadCapabilities, loadCapability, registerProvider, } from "./index.js";
+function source(provider, filePath, level = "project") {
+    return { provider, providerName: provider, path: filePath, level };
+}
+function ctx() {
+    return { cwd: "/tmp/proj", home: "/home/test", repoRoot: "/tmp" };
+}
+function provider(id, priority, items, opts = {}) {
+    return {
+        id,
+        displayName: id,
+        description: `provider ${id}`,
+        priority,
+        async load() {
+            if (opts.fail)
+                throw new Error(`fail ${id}`);
+            return { items, warnings: opts.warnings };
+        },
+    };
+}
+describe("capability registry — B01", () => {
+    it("dedup first-wins: a igualdad de clave gana el de mayor prioridad", async () => {
+        const cap = {
+            id: "test",
+            displayName: "Test",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const low = {
+            name: "shared",
+            value: "from-low",
+            _source: source("low", "/tmp/low.json", "user"),
+        };
+        const high = {
+            name: "shared",
+            value: "from-high",
+            _source: source("high", "/tmp/high.json", "project"),
+        };
+        // Providers desordenados a propósito: el registry debe reordenar por priority.
+        const result = await loadCapabilities(cap, [provider("low", 10, [low]), provider("high", 100, [high])], ctx());
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].value).toBe("from-high");
+        expect(result.items[0]._source.provider).toBe("high");
+        // El duplicado queda en `all` marcado como shadowed.
+        expect(result.all).toHaveLength(2);
+        expect(result.all.find((i) => i.value === "from-low")?._shadowed).toBe(true);
+    });
+    it("prioridad: respeta orden descendente aunque los providers lleguen al revés", async () => {
+        const cap = {
+            id: "prio",
+            displayName: "Prio",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const a = { name: "a", value: "a-low", _source: source("low", "/a.json") };
+        const b = { name: "b", value: "b-mid", _source: source("mid", "/b.json") };
+        const c = { name: "c", value: "c-high", _source: source("high", "/c.json") };
+        const result = await loadCapabilities(cap, [provider("low", 1, [a]), provider("high", 100, [c]), provider("mid", 50, [b])], ctx());
+        // Todos con claves distintas: sobreviven los tres, pero en orden de prioridad.
+        expect(result.items.map((i) => i.name)).toEqual(["c", "b", "a"]);
+        expect(result.providers).toEqual(["high", "mid", "low"]);
+    });
+    it("filter: item filtrado no reclama clave — homónimo de menor prioridad sí sobrevive", async () => {
+        const cap = {
+            id: "filter-test",
+            displayName: "Filter",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const high = {
+            name: "shared",
+            value: "high-filtered",
+            _source: source("high", "/high.json"),
+        };
+        const low = {
+            name: "shared",
+            value: "low-survives",
+            _source: source("low", "/low.json"),
+        };
+        const result = await loadCapabilities(cap, [provider("high", 100, [high]), provider("low", 10, [low])], ctx(), {
+            filter: (item) => item.value !== "high-filtered",
+        });
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].value).toBe("low-survives");
+        // El filtrado no está en `all` (como si nunca hubiera existido).
+        expect(result.all).toHaveLength(1);
+        expect(result.all[0].value).toBe("low-survives");
+    });
+    it("suppress: item suprimido SÍ reclama clave y ensombrece homónimo de menor prioridad", async () => {
+        const cap = {
+            id: "suppress-test",
+            displayName: "Suppress",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const high = {
+            name: "shared",
+            value: "high-suppressed",
+            _source: source("high", "/high.json"),
+        };
+        const low = {
+            name: "shared",
+            value: "low-shadowed",
+            _source: source("low", "/low.json"),
+        };
+        const result = await loadCapabilities(cap, [provider("high", 100, [high]), provider("low", 10, [low])], ctx(), {
+            suppress: (item) => item.value === "high-suppressed",
+        });
+        // Ninguno sobrevive: el de proyecto suprimido ensombrece al de usuario.
+        expect(result.items).toHaveLength(0);
+        // El suprimido no se expone en `all` (igual que omp), el low queda como shadowed.
+        expect(result.all).toHaveLength(1);
+        expect(result.all[0].value).toBe("low-shadowed");
+        expect(result.all[0]._shadowed).toBe(true);
+    });
+    it("suppress no hace equivalence-shadow a survivor con clave distinta", async () => {
+        const cap = {
+            id: "mcp",
+            displayName: "MCP",
+            description: "test",
+            key: (it) => it.name,
+            equivalent: (a, b) => a.url === b.url,
+        };
+        const suppressed = {
+            name: "alias",
+            url: "https://example.com",
+            _source: source("high", "/high.json"),
+        };
+        const survivor = {
+            name: "real",
+            url: "https://example.com",
+            _source: source("low", "/low.json"),
+        };
+        const result = await loadCapabilities(cap, [provider("high", 100, [suppressed]), provider("low", 10, [survivor])], ctx(), {
+            suppress: (item) => {
+                const typed = item;
+                return typed.name === "alias";
+            },
+        });
+        // El suprimido reclama "alias" pero no "real", y no equivalence-shadowea.
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].name).toBe("real");
+    });
+    it("equivalent: dos claves distintas pero conectivamente iguales — solo el primero sobrevive", async () => {
+        const cap = {
+            id: "mcp-equiv",
+            displayName: "MCP",
+            description: "test",
+            key: (it) => it.name,
+            equivalent: (a, b) => a.url === b.url,
+        };
+        const first = {
+            name: "server-a",
+            url: "https://api.example.com",
+            _source: source("high", "/high.json"),
+        };
+        const second = {
+            name: "server-b",
+            url: "https://api.example.com",
+            _source: source("low", "/low.json"),
+        };
+        const result = await loadCapabilities(cap, [provider("high", 100, [first]), provider("low", 10, [second])], ctx());
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].name).toBe("server-a");
+        expect(result.all.find((i) => i.name === "server-b")?._shadowed).toBe(true);
+    });
+    it("key undefined: nunca deduplicar — todos sobreviven aunque compartan contenido", async () => {
+        const cap = {
+            id: "no-dedup",
+            displayName: "NoDedup",
+            description: "test",
+            key: () => undefined,
+        };
+        const a = { name: "x", value: "v", _source: source("p1", "/a.json") };
+        const b = { name: "x", value: "v", _source: source("p2", "/b.json") };
+        const result = await loadCapabilities(cap, [provider("p1", 100, [a]), provider("p2", 10, [b])], ctx());
+        expect(result.items).toHaveLength(2);
+    });
+    it("validación post-dedup: inválidos se descartan con warning y sin abortar", async () => {
+        const cap = {
+            id: "validate",
+            displayName: "Validate",
+            description: "test",
+            key: (it) => it.name,
+            validate: (it) => (it.value === "bad" ? "value no puede ser 'bad'" : undefined),
+        };
+        const good = { name: "ok", value: "good", _source: source("p1", "/ok.json") };
+        const bad = { name: "bad", value: "bad", _source: source("p1", "/bad.json") };
+        const result = await loadCapabilities(cap, [provider("p1", 100, [good, bad])], ctx());
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].name).toBe("ok");
+        expect(result.warnings.some((w) => w.includes("bad"))).toBe(true);
+        // Con includeInvalid, el inválido sí sobrevive.
+        const withInvalid = await loadCapabilities(cap, [provider("p1", 100, [good, bad])], ctx(), {
+            includeInvalid: true,
+        });
+        expect(withInvalid.items).toHaveLength(2);
+    });
+    it("un provider que falla no aborta la carga de los demás (warning y sigue)", async () => {
+        const cap = {
+            id: "resilient",
+            displayName: "Resilient",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const good = { name: "ok", value: "fine", _source: source("good", "/good.json") };
+        const result = await loadCapabilities(cap, [
+            provider("bad", 100, [], { fail: true }),
+            provider("good", 10, [good]),
+        ], ctx());
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].value).toBe("fine");
+        expect(result.warnings.some((w) => w.includes("bad"))).toBe(true);
+    });
+    it("warnings de providers se agregan y se prefijan con el displayName", async () => {
+        const cap = {
+            id: "warnings",
+            displayName: "Warnings",
+            description: "test",
+            key: (it) => it.name,
+        };
+        const item = { name: "x", value: "v", _source: source("p1", "/x.json") };
+        const result = await loadCapabilities(cap, [provider("p1", 10, [item], { warnings: ["algo raro"] })], ctx());
+        expect(result.warnings.some((w) => w.includes("[p1]") && w.includes("algo raro"))).toBe(true);
+    });
+    it("registro global: defineCapability + registerProvider + loadCapability", async () => {
+        clearRegistryForTesting();
+        const cap = {
+            id: "reg-test",
+            displayName: "Reg",
+            description: "test",
+            key: (it) => it.name,
+        };
+        defineCapability(cap);
+        const item = {
+            name: "hello",
+            value: "world",
+            _source: source("native", "/native.json"),
+        };
+        registerProvider("reg-test", provider("native", 100, [item]));
+        const result = await loadCapability("reg-test", { ctx: ctx() });
+        expect(result.items).toHaveLength(1);
+        expect(result.items[0].name).toBe("hello");
+        clearRegistryForTesting();
+    });
+});
+//# sourceMappingURL=capability.test.js.map

package/dist/core/capability/capability.test.js.map

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

package/dist/core/capability/fs.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Helpers de FS para el capability registry (B01).
+ *
+ * Lectura cacheada con guardia FIFO/socket (igual que
+ * `oh-my-pi/packages/coding-agent/src/capability/fs.ts:~22`): antes de leer
+ * con `fs.readFile`, se hace `stat.isFile()` para no colgarse leyendo un
+ * FIFO/socket/char-device — en discovery se escanean directorios ajenos
+ * (~/.claude, ~/.cursor) donde puede haber FIFOs.
+ *
+ * También provee `findRepoRoot` walk-up buscando `.git` (fichero o directorio),
+ * usado para construir `LoadContext.repoRoot`.
+ */
+import * as fs from "node:fs";
+export declare function readFile(filePath: string): Promise<string | null>;
+export declare function readDirEntries(dirPath: string): Promise<fs.Dirent[]>;
+export declare function readDir(dirPath: string): Promise<string[]>;
+export declare function walkUp(startDir: string, name: string, opts?: {
+    file?: boolean;
+    dir?: boolean;
+}): Promise<string | null>;
+/**
+ * Camina hacia arriba desde startDir buscando `.git` (fichero o directorio).
+ * Devuelve el directorio que contiene `.git` o null si no hay repo.
+ */
+export declare function findRepoRoot(startDir: string): Promise<string | null>;
+export declare function cacheStats(): {
+    content: number;
+    dir: number;
+};
+export declare function clearCache(): void;
+export declare function invalidate(filePath: string): void;
+//# sourceMappingURL=fs.d.ts.map

package/dist/core/capability/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/core/capability/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAU9B,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBvE;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAW1E;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGhE;AAED,wBAAsB,MAAM,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS3E;AAED,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAE7D;AAED,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMjD"}