@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/core/higiene/withHostGuard.js

@@ -0,0 +1,79 @@
+/**
+ * withHostGuard — kit higiene B06.
+ * Envuelve Promise de código de terceros (hooks, providers, extensiones)
+ * para que nunca propague throw al host. Clasifica error.hostGuard=true,
+ * loggea y retorna undefined. Si el host muere, el guard no bloquea
+ * (no deja promesas colgando sin resolver).
+ */
+function makeHostGuardError(message, cause) {
+    const err = new Error(message);
+    err.hostGuard = true;
+    err.cause = cause;
+    if (cause instanceof Error && cause.stack) {
+        err.stack = `${err.stack}\nCaused by: ${cause.stack}`;
+    }
+    return err;
+}
+/**
+ * Ejecuta fn() bajo guard. Nunca lanza al caller: cualquier throw
+ * o timeout se clasifica con hostGuard y se retorna undefined.
+ * El timeout no bloquea: si fn tarda más, se abandona y se resuelve undefined.
+ */
+export async function withHostGuard(fn, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 5000;
+    const name = opts.name ?? "hostGuard";
+    let timer;
+    try {
+        const guarded = (async () => {
+            try {
+                return await fn();
+            }
+            catch (cause) {
+                throw makeHostGuardError(`[${name}] hostGuard capturó throw`, cause);
+            }
+        })();
+        if (timeoutMs <= 0) {
+            return await guarded;
+        }
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(makeHostGuardError(`[${name}] hostGuard timeout ${timeoutMs}ms`, undefined));
+            }, timeoutMs);
+            const maybeUnref = timer; // Node Timeout has unref
+            maybeUnref.unref?.();
+        });
+        const result = await Promise.race([guarded, timeoutPromise]);
+        return result;
+    }
+    catch (error) {
+        const hostErr = error;
+        if (!hostErr.hostGuard) {
+            const wrapped = makeHostGuardError(`[${name}] hostGuard fallo no clasificado`, error);
+            opts.onError?.(wrapped);
+            console.error(wrapped.message, wrapped.cause ?? wrapped);
+            return undefined;
+        }
+        opts.onError?.(hostErr);
+        console.error(hostErr.message, hostErr.cause ?? "");
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Totem síncrono para callbacks que no son Promise.
+ */
+export function withHostGuardSync(fn, opts = {}) {
+    const name = opts.name ?? "hostGuardSync";
+    try {
+        return fn();
+    }
+    catch (cause) {
+        const err = makeHostGuardError(`[${name}] hostGuardSync capturó throw`, cause);
+        opts.onError?.(err);
+        console.error(err.message, err.cause ?? "");
+        return undefined;
+    }
+}
+//# sourceMappingURL=withHostGuard.js.map

package/dist/core/higiene/withHostGuard.js.map

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

package/dist/core/hooks/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yDAAyD;AACzD,eAAO,MAAM,YAAY,4HAQf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC5B,2EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC7B,iEAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAYrH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAiB1E;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,OAAO,GACjB;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBlD;AAED,iFAAgF;AAChF,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAEtE","sourcesContent":["/**\n * Contrato de los hooks: qué se dispara, y qué puede decidir.\n *\n * Este fichero es PURO a propósito — no lanza procesos ni toca disco. Aquí vive\n * la parte que hay que poder probar sin montar nada: qué hooks casan con un\n * evento, y cómo se combinan sus respuestas.\n *\n * La regla que nos separa del contrato que copiamos: **un hook solo puede\n * estrechar permisos, nunca ampliarlos**. Si un hook pudiera responder \"allow\"\n * y saltarse el modo activo, instalar un plugin de terceros equivaldría a\n * desactivar la gobernanza del producto — que es justo lo que vendemos. Un\n * \"deny\" siempre vale; un \"allow\" solo vale donde el modo ya permitía.\n */\n\n/** Los 7 momentos en los que se puede enganchar algo. */\nexport const EVENTOS_HOOK = [\n\t\"session_start\",\n\t\"user_prompt_submit\",\n\t\"pre_tool_use\",\n\t\"post_tool_use\",\n\t\"notification\",\n\t\"stop\",\n\t\"subagent_stop\",\n] as const;\n\nexport type EventoHook = (typeof EVENTOS_HOOK)[number];\n\nexport type NivelPermiso = \"plan\" | \"manual\" | \"auto\" | \"yolo\";\n\nexport type DecisionPermiso = \"allow\" | \"deny\" | \"ask\";\n\nexport interface HookDefinido {\n\t/** Expresión regular contra el nombre de la herramienta (o el evento). */\n\tmatcher?: string;\n\tcommand: string;\n\ttimeoutMs?: number;\n}\n\nexport interface ConfigHooks {\n\tenabled?: boolean;\n\t/** Sin terminal donde preguntar, un hook que falla debe bloquear, no colar. */\n\tfailClosedHeadless?: boolean;\n\tevents?: Partial<Record<EventoHook, HookDefinido[]>>;\n}\n\nexport interface RespuestaHook {\n\t/** 0 = siguió; 2 = bloquea; cualquier otro = el hook falló. */\n\texitCode: number;\n\tstdout?: string;\n\tstderr?: string;\n}\n\nexport interface DecisionHook {\n\tpermissionDecision?: DecisionPermiso;\n\treason?: string;\n}\n\n/**\n * Qué hooks corren para un evento.\n *\n * El matcher se prueba contra `objetivo` — el nombre de la herramienta en\n * `pre_tool_use`/`post_tool_use`, y el propio evento en los demás. Un matcher\n * ausente casa con todo.\n *\n * Un matcher con una expresión regular inválida NO casa y no revienta: un\n * `settings.json` con una errata no puede tumbar la sesión, y tampoco puede\n * convertirse en un comodín silencioso que dispare hooks de más.\n */\nexport function planificarHooks(config: ConfigHooks | undefined, evento: EventoHook, objetivo: string): HookDefinido[] {\n\tif (!config || config.enabled === false) return [];\n\tconst definidos = config.events?.[evento] ?? [];\n\treturn definidos.filter((hook) => {\n\t\tif (!hook.command) return false;\n\t\tif (!hook.matcher) return true;\n\t\ttry {\n\t\t\treturn new RegExp(hook.matcher).test(objetivo);\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t});\n}\n\n/**\n * Lee la decisión que un hook escribe en stdout.\n *\n * Devuelve `null` si no dijo nada legible, que es el caso normal: la mayoría de\n * los hooks solo quieren correr y salir con 0.\n */\nexport function leerDecision(respuesta: RespuestaHook): DecisionHook | null {\n\tconst texto = (respuesta.stdout ?? \"\").trim();\n\tif (!texto) return null;\n\ttry {\n\t\tconst dato = JSON.parse(texto) as Record<string, unknown>;\n\t\tconst decision = dato.permissionDecision;\n\t\tif (decision !== \"allow\" && decision !== \"deny\" && decision !== \"ask\") {\n\t\t\treturn typeof dato.reason === \"string\" ? { reason: dato.reason } : null;\n\t\t}\n\t\treturn {\n\t\t\tpermissionDecision: decision,\n\t\t\treason: typeof dato.reason === \"string\" ? dato.reason : undefined,\n\t\t};\n\t} catch {\n\t\t// stdout que no es JSON es solo registro del hook, no una decisión.\n\t\treturn null;\n\t}\n}\n\n/** Lo que el modo activo concede por sí solo, sin hooks de por medio. */\nfunction techoDelModo(nivel: NivelPermiso): DecisionPermiso {\n\tswitch (nivel) {\n\t\tcase \"plan\":\n\t\t\treturn \"deny\";\n\t\tcase \"manual\":\n\t\t\treturn \"ask\";\n\t\tdefault:\n\t\t\treturn \"allow\";\n\t}\n}\n\nconst ORDEN: Record<DecisionPermiso, number> = { allow: 0, ask: 1, deny: 2 };\n\n/**\n * Combina las respuestas de todos los hooks de un evento con el modo activo.\n *\n * Gana siempre la más restrictiva, incluido el techo del modo. Por eso un hook\n * que responde \"allow\" en modo manual acaba en \"ask\", y en modo plan en \"deny\":\n * puede apretar, no aflojar.\n *\n * Salir con 2 equivale a \"deny\" aunque el hook no escriba JSON — es el atajo\n * del contrato para un script de una línea. Salir con cualquier otro código\n * distinto de 0 es un hook roto: bloquea si `failClosed`, y si no se ignora\n * (pero el motivo se devuelve para poder registrarlo).\n */\nexport function resolverDecision(\n\trespuestas: RespuestaHook[],\n\tnivel: NivelPermiso,\n\tfailClosed: boolean,\n): { decision: DecisionPermiso; motivos: string[] } {\n\tlet peor: DecisionPermiso = techoDelModo(nivel);\n\tconst motivos: string[] = [];\n\n\tfor (const respuesta of respuestas) {\n\t\tconst leida = leerDecision(respuesta);\n\t\tif (leida?.reason) motivos.push(leida.reason);\n\n\t\tlet candidata: DecisionPermiso | null = null;\n\t\tif (respuesta.exitCode === 2) {\n\t\t\tcandidata = \"deny\";\n\t\t\tif (!leida?.reason && respuesta.stderr?.trim()) motivos.push(respuesta.stderr.trim());\n\t\t} else if (respuesta.exitCode !== 0) {\n\t\t\tif (failClosed) {\n\t\t\t\tcandidata = \"deny\";\n\t\t\t\tmotivos.push(`hook falló con código ${respuesta.exitCode}`);\n\t\t\t}\n\t\t} else if (leida?.permissionDecision) {\n\t\t\tcandidata = leida.permissionDecision;\n\t\t}\n\n\t\tif (candidata && ORDEN[candidata] > ORDEN[peor]) peor = candidata;\n\t}\n\n\treturn { decision: peor, motivos };\n}\n\n/** Cuántas veces seguidas puede un hook `stop` impedir que el turno termine. */\nexport const MAX_BLOQUEOS_STOP = 3;\n\n/**\n * ¿Se honra este bloqueo de `stop`?\n *\n * Con tope, porque sin él un hook mal escrito deja al agente dando vueltas para\n * siempre y consumiendo dinero. A la cuarta se ignora y el turno termina.\n */\nexport function permiteBloquearParada(bloqueosPrevios: number): boolean {\n\treturn bloqueosPrevios < MAX_BLOQUEOS_STOP;\n}\n"]}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yDAAyD;AACzD,eAAO,MAAM,YAAY,4HAQf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC7B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAYrH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAiB1E;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,OAAO,GACjB;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBlD;AAED,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAEtE"}

package/dist/core/hooks/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/core/hooks/contract.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Contrato de los hooks: qué se dispara, y qué puede decidir.\n *\n * Este fichero es PURO a propósito — no lanza procesos ni toca disco. Aquí vive\n * la parte que hay que poder probar sin montar nada: qué hooks casan con un\n * evento, y cómo se combinan sus respuestas.\n *\n * La regla que nos separa del contrato que copiamos: **un hook solo puede\n * estrechar permisos, nunca ampliarlos**. Si un hook pudiera responder \"allow\"\n * y saltarse el modo activo, instalar un plugin de terceros equivaldría a\n * desactivar la gobernanza del producto — que es justo lo que vendemos. Un\n * \"deny\" siempre vale; un \"allow\" solo vale donde el modo ya permitía.\n */\n\n/** Los 7 momentos en los que se puede enganchar algo. */\nexport const EVENTOS_HOOK = [\n\t\"session_start\",\n\t\"user_prompt_submit\",\n\t\"pre_tool_use\",\n\t\"post_tool_use\",\n\t\"notification\",\n\t\"stop\",\n\t\"subagent_stop\",\n] as const;\n\nexport type EventoHook = (typeof EVENTOS_HOOK)[number];\n\nexport type NivelPermiso = \"plan\" | \"manual\" | \"auto\" | \"yolo\";\n\nexport type DecisionPermiso = \"allow\" | \"deny\" | \"ask\";\n\nexport interface HookDefinido {\n\t/** Expresión regular contra el nombre de la herramienta (o el evento). */\n\tmatcher?: string;\n\tcommand: string;\n\ttimeoutMs?: number;\n}\n\nexport interface ConfigHooks {\n\tenabled?: boolean;\n\t/** Sin terminal donde preguntar, un hook que falla debe bloquear, no colar. */\n\tfailClosedHeadless?: boolean;\n\tevents?: Partial<Record<EventoHook, HookDefinido[]>>;\n}\n\nexport interface RespuestaHook {\n\t/** 0 = siguió; 2 = bloquea; cualquier otro = el hook falló. */\n\texitCode: number;\n\tstdout?: string;\n\tstderr?: string;\n}\n\nexport interface DecisionHook {\n\tpermissionDecision?: DecisionPermiso;\n\treason?: string;\n}\n\n/**\n * Qué hooks corren para un evento.\n *\n * El matcher se prueba contra `objetivo` — el nombre de la herramienta en\n * `pre_tool_use`/`post_tool_use`, y el propio evento en los demás. Un matcher\n * ausente casa con todo.\n *\n * Un matcher con una expresión regular inválida NO casa y no revienta: un\n * `settings.json` con una errata no puede tumbar la sesión, y tampoco puede\n * convertirse en un comodín silencioso que dispare hooks de más.\n */\nexport function planificarHooks(config: ConfigHooks | undefined, evento: EventoHook, objetivo: string): HookDefinido[] {\n\tif (!config || config.enabled === false) return [];\n\tconst definidos = config.events?.[evento] ?? [];\n\treturn definidos.filter((hook) => {\n\t\tif (!hook.command) return false;\n\t\tif (!hook.matcher) return true;\n\t\ttry {\n\t\t\treturn new RegExp(hook.matcher).test(objetivo);\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t});\n}\n\n/**\n * Lee la decisión que un hook escribe en stdout.\n *\n * Devuelve `null` si no dijo nada legible, que es el caso normal: la mayoría de\n * los hooks solo quieren correr y salir con 0.\n */\nexport function leerDecision(respuesta: RespuestaHook): DecisionHook | null {\n\tconst texto = (respuesta.stdout ?? \"\").trim();\n\tif (!texto) return null;\n\ttry {\n\t\tconst dato = JSON.parse(texto) as Record<string, unknown>;\n\t\tconst decision = dato.permissionDecision;\n\t\tif (decision !== \"allow\" && decision !== \"deny\" && decision !== \"ask\") {\n\t\t\treturn typeof dato.reason === \"string\" ? { reason: dato.reason } : null;\n\t\t}\n\t\treturn {\n\t\t\tpermissionDecision: decision,\n\t\t\treason: typeof dato.reason === \"string\" ? dato.reason : undefined,\n\t\t};\n\t} catch {\n\t\t// stdout que no es JSON es solo registro del hook, no una decisión.\n\t\treturn null;\n\t}\n}\n\n/** Lo que el modo activo concede por sí solo, sin hooks de por medio. */\nfunction techoDelModo(nivel: NivelPermiso): DecisionPermiso {\n\tswitch (nivel) {\n\t\tcase \"plan\":\n\t\t\treturn \"deny\";\n\t\tcase \"manual\":\n\t\t\treturn \"ask\";\n\t\tdefault:\n\t\t\treturn \"allow\";\n\t}\n}\n\nconst ORDEN: Record<DecisionPermiso, number> = { allow: 0, ask: 1, deny: 2 };\n\n/**\n * Combina las respuestas de todos los hooks de un evento con el modo activo.\n *\n * Gana siempre la más restrictiva, incluido el techo del modo. Por eso un hook\n * que responde \"allow\" en modo manual acaba en \"ask\", y en modo plan en \"deny\":\n * puede apretar, no aflojar.\n *\n * Salir con 2 equivale a \"deny\" aunque el hook no escriba JSON — es el atajo\n * del contrato para un script de una línea. Salir con cualquier otro código\n * distinto de 0 es un hook roto: bloquea si `failClosed`, y si no se ignora\n * (pero el motivo se devuelve para poder registrarlo).\n */\nexport function resolverDecision(\n\trespuestas: RespuestaHook[],\n\tnivel: NivelPermiso,\n\tfailClosed: boolean,\n): { decision: DecisionPermiso; motivos: string[] } {\n\tlet peor: DecisionPermiso = techoDelModo(nivel);\n\tconst motivos: string[] = [];\n\n\tfor (const respuesta of respuestas) {\n\t\tconst leida = leerDecision(respuesta);\n\t\tif (leida?.reason) motivos.push(leida.reason);\n\n\t\tlet candidata: DecisionPermiso | null = null;\n\t\tif (respuesta.exitCode === 2) {\n\t\t\tcandidata = \"deny\";\n\t\t\tif (!leida?.reason && respuesta.stderr?.trim()) motivos.push(respuesta.stderr.trim());\n\t\t} else if (respuesta.exitCode !== 0) {\n\t\t\tif (failClosed) {\n\t\t\t\tcandidata = \"deny\";\n\t\t\t\tmotivos.push(`hook falló con código ${respuesta.exitCode}`);\n\t\t\t}\n\t\t} else if (leida?.permissionDecision) {\n\t\t\tcandidata = leida.permissionDecision;\n\t\t}\n\n\t\tif (candidata && ORDEN[candidata] > ORDEN[peor]) peor = candidata;\n\t}\n\n\treturn { decision: peor, motivos };\n}\n\n/** Cuántas veces seguidas puede un hook `stop` impedir que el turno termine. */\nexport const MAX_BLOQUEOS_STOP = 3;\n\n/**\n * ¿Se honra este bloqueo de `stop`?\n *\n * Con tope, porque sin él un hook mal escrito deja al agente dando vueltas para\n * siempre y consumiendo dinero. A la cuarta se ignora y el turno termina.\n */\nexport function permiteBloquearParada(bloqueosPrevios: number): boolean {\n\treturn bloqueosPrevios < MAX_BLOQUEOS_STOP;\n}\n"]}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/core/hooks/contract.ts"],"names":[],"mappings":"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"}

package/dist/core/hooks/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAM7E,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,EACtB,QAAQ,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxC,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,QAAQ,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxC,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B","sourcesContent":["/**\n * Ejecuta los hooks. Todo lo que decide vive en `contract.ts`; aquí solo se\n * lanzan procesos y se recogen sus respuestas.\n *\n * El contrato con el proceso es deliberadamente pobre, para que escribir un\n * hook sea cosa de tres líneas de shell: recibe un JSON por stdin, y contesta\n * con su código de salida (0 sigue, 2 bloquea) y, si quiere afinar, un JSON por\n * stdout.\n */\n\nimport { spawn } from \"node:child_process\";\nimport type { EventoHook, HookDefinido, RespuestaHook } from \"./contract.ts\";\n\n/** Un hook que escupe sin parar no puede tumbar el proceso del agente. */\nconst MAX_SALIDA = 64 * 1024;\nconst TIMEOUT_POR_DEFECTO_MS = 10_000;\n\nexport interface ContextoHook {\n\tevento: EventoHook;\n\tsessionId: string;\n\tcwd: string;\n\ttoolName?: string;\n\ttoolInput?: unknown;\n\ttoolResult?: unknown;\n\tprompt?: string;\n\tmessage?: string;\n}\n\n/**\n * Lanza un hook y espera su respuesta.\n *\n * Nunca lanza excepción: un hook que no existe, que peta o que se cuelga se\n * traduce a un `exitCode` distinto de 0, y es `resolverDecision` quien decide\n * si eso bloquea o se ignora. Si esto lanzara, un hook roto tumbaría el turno\n * saltándose la política de `failClosed`.\n */\nexport async function ejecutarHook(\n\thook: HookDefinido,\n\tcontexto: ContextoHook,\n\topciones: { env?: NodeJS.ProcessEnv } = {},\n): Promise<RespuestaHook> {\n\tconst entrada = JSON.stringify(contexto);\n\tconst timeoutMs = hook.timeoutMs && hook.timeoutMs > 0 ? hook.timeoutMs : TIMEOUT_POR_DEFECTO_MS;\n\n\treturn new Promise<RespuestaHook>((resolve) => {\n\t\tlet hijo: ReturnType<typeof spawn>;\n\t\ttry {\n\t\t\thijo = spawn(hook.command, {\n\t\t\t\tshell: true,\n\t\t\t\tcwd: contexto.cwd,\n\t\t\t\t// El evento va también por entorno: un hook de una línea puede\n\t\t\t\t// ramificar con `$ADA_HOOK_EVENT` sin parsear el JSON.\n\t\t\t\tenv: { ...process.env, ...opciones.env, ADA_HOOK_EVENT: contexto.evento },\n\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tresolve({ exitCode: 127, stderr: error instanceof Error ? error.message : String(error) });\n\t\t\treturn;\n\t\t}\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet resuelto = false;\n\t\tconst terminar = (respuesta: RespuestaHook) => {\n\t\t\tif (resuelto) return;\n\t\t\tresuelto = true;\n\t\t\tclearTimeout(reloj);\n\t\t\tresolve(respuesta);\n\t\t};\n\n\t\tconst reloj = setTimeout(() => {\n\t\t\thijo.kill(\"SIGKILL\");\n\t\t\tterminar({ exitCode: 124, stdout, stderr: `${stderr}\\nhook agotó su tiempo (${timeoutMs} ms)` });\n\t\t}, timeoutMs);\n\n\t\thijo.stdout?.on(\"data\", (trozo: Buffer) => {\n\t\t\tif (stdout.length < MAX_SALIDA) stdout += trozo.toString(\"utf8\");\n\t\t});\n\t\thijo.stderr?.on(\"data\", (trozo: Buffer) => {\n\t\t\tif (stderr.length < MAX_SALIDA) stderr += trozo.toString(\"utf8\");\n\t\t});\n\t\thijo.on(\"error\", (error) => terminar({ exitCode: 127, stdout, stderr: error.message }));\n\t\thijo.on(\"close\", (codigo) => terminar({ exitCode: codigo ?? 0, stdout, stderr }));\n\n\t\t// Cerrar stdin siempre: sin esto, un hook que lea hasta EOF se cuelga\n\t\t// hasta agotar el temporizador y todo el turno espera con él.\n\t\thijo.stdin?.on(\"error\", () => {});\n\t\thijo.stdin?.end(entrada);\n\t});\n}\n\n/**\n * Ejecuta varios hooks en serie.\n *\n * En serie y no en paralelo a propósito: los hooks de `pre_tool_use` existen\n * para vetar, y dos vetos concurrentes sobre el mismo fichero se pisan. El\n * coste es aceptable porque cada uno tiene su propio tope de tiempo.\n */\nexport async function ejecutarHooks(\n\thooks: HookDefinido[],\n\tcontexto: ContextoHook,\n\topciones: { env?: NodeJS.ProcessEnv } = {},\n): Promise<RespuestaHook[]> {\n\tconst respuestas: RespuestaHook[] = [];\n\tfor (const hook of hooks) {\n\t\trespuestas.push(await ejecutarHook(hook, contexto, opciones));\n\t}\n\treturn respuestas;\n}\n"]}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAM7E,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,EACtB,QAAQ,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxC,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,YAAY,EACtB,QAAQ,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxC,OAAO,CAAC,aAAa,EAAE,CAAC,CAM1B"}

package/dist/core/hooks/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/core/hooks/runner.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ejecuta los hooks. Todo lo que decide vive en `contract.ts`; aquí solo se\n * lanzan procesos y se recogen sus respuestas.\n *\n * El contrato con el proceso es deliberadamente pobre, para que escribir un\n * hook sea cosa de tres líneas de shell: recibe un JSON por stdin, y contesta\n * con su código de salida (0 sigue, 2 bloquea) y, si quiere afinar, un JSON por\n * stdout.\n */\n\nimport { spawn } from \"node:child_process\";\nimport type { EventoHook, HookDefinido, RespuestaHook } from \"./contract.ts\";\n\n/** Un hook que escupe sin parar no puede tumbar el proceso del agente. */\nconst MAX_SALIDA = 64 * 1024;\nconst TIMEOUT_POR_DEFECTO_MS = 10_000;\n\nexport interface ContextoHook {\n\tevento: EventoHook;\n\tsessionId: string;\n\tcwd: string;\n\ttoolName?: string;\n\ttoolInput?: unknown;\n\ttoolResult?: unknown;\n\tprompt?: string;\n\tmessage?: string;\n}\n\n/**\n * Lanza un hook y espera su respuesta.\n *\n * Nunca lanza excepción: un hook que no existe, que peta o que se cuelga se\n * traduce a un `exitCode` distinto de 0, y es `resolverDecision` quien decide\n * si eso bloquea o se ignora. Si esto lanzara, un hook roto tumbaría el turno\n * saltándose la política de `failClosed`.\n */\nexport async function ejecutarHook(\n\thook: HookDefinido,\n\tcontexto: ContextoHook,\n\topciones: { env?: NodeJS.ProcessEnv } = {},\n): Promise<RespuestaHook> {\n\tconst entrada = JSON.stringify(contexto);\n\tconst timeoutMs = hook.timeoutMs && hook.timeoutMs > 0 ? hook.timeoutMs : TIMEOUT_POR_DEFECTO_MS;\n\n\treturn new Promise<RespuestaHook>((resolve) => {\n\t\tlet hijo: ReturnType<typeof spawn>;\n\t\ttry {\n\t\t\thijo = spawn(hook.command, {\n\t\t\t\tshell: true,\n\t\t\t\tcwd: contexto.cwd,\n\t\t\t\t// El evento va también por entorno: un hook de una línea puede\n\t\t\t\t// ramificar con `$ADA_HOOK_EVENT` sin parsear el JSON.\n\t\t\t\tenv: { ...process.env, ...opciones.env, ADA_HOOK_EVENT: contexto.evento },\n\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tresolve({ exitCode: 127, stderr: error instanceof Error ? error.message : String(error) });\n\t\t\treturn;\n\t\t}\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet resuelto = false;\n\t\tconst terminar = (respuesta: RespuestaHook) => {\n\t\t\tif (resuelto) return;\n\t\t\tresuelto = true;\n\t\t\tclearTimeout(reloj);\n\t\t\tresolve(respuesta);\n\t\t};\n\n\t\tconst reloj = setTimeout(() => {\n\t\t\thijo.kill(\"SIGKILL\");\n\t\t\tterminar({ exitCode: 124, stdout, stderr: `${stderr}\\nhook agotó su tiempo (${timeoutMs} ms)` });\n\t\t}, timeoutMs);\n\n\t\thijo.stdout?.on(\"data\", (trozo: Buffer) => {\n\t\t\tif (stdout.length < MAX_SALIDA) stdout += trozo.toString(\"utf8\");\n\t\t});\n\t\thijo.stderr?.on(\"data\", (trozo: Buffer) => {\n\t\t\tif (stderr.length < MAX_SALIDA) stderr += trozo.toString(\"utf8\");\n\t\t});\n\t\thijo.on(\"error\", (error) => terminar({ exitCode: 127, stdout, stderr: error.message }));\n\t\thijo.on(\"close\", (codigo) => terminar({ exitCode: codigo ?? 0, stdout, stderr }));\n\n\t\t// Cerrar stdin siempre: sin esto, un hook que lea hasta EOF se cuelga\n\t\t// hasta agotar el temporizador y todo el turno espera con él.\n\t\thijo.stdin?.on(\"error\", () => {});\n\t\thijo.stdin?.end(entrada);\n\t});\n}\n\n/**\n * Ejecuta varios hooks en serie.\n *\n * En serie y no en paralelo a propósito: los hooks de `pre_tool_use` existen\n * para vetar, y dos vetos concurrentes sobre el mismo fichero se pisan. El\n * coste es aceptable porque cada uno tiene su propio tope de tiempo.\n */\nexport async function ejecutarHooks(\n\thooks: HookDefinido[],\n\tcontexto: ContextoHook,\n\topciones: { env?: NodeJS.ProcessEnv } = {},\n): Promise<RespuestaHook[]> {\n\tconst respuestas: RespuestaHook[] = [];\n\tfor (const hook of hooks) {\n\t\trespuestas.push(await ejecutarHook(hook, contexto, opciones));\n\t}\n\treturn respuestas;\n}\n"]}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/core/hooks/runner.ts"],"names":[],"mappings":"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"}

package/dist/core/hooks/session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;KAC1F,CAAC;IACF,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAarE;AAED,MAAM,WAAW,cAAc;IAC9B,4CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC,CAqBzB","sourcesContent":["/**\n * Pegamento entre la sesión y los hooks.\n *\n * Vive aparte de `agent-session.ts` a propósito: ese fichero es de upstream y\n * cada línea que le añadimos se paga en cada sincronización. Aquí cabe toda la\n * lógica y allí queda una llamada.\n *\n * Regla de oro del enganche: **si no hay hooks configurados para este evento,\n * esto no debe cambiar absolutamente nada**. `resolverDecision` devuelve el\n * techo del modo cuando no hay respuestas, y aplicar ese techo aquí bloquearía\n * cada herramienta en modo manual aunque el usuario no haya configurado un solo\n * hook. Por eso se sale antes de consultar nada.\n */\n\nimport type { EventoHook, NivelPermiso } from \"./contract.ts\";\nimport { planificarHooks, resolverDecision } from \"./contract.ts\";\nimport { type ContextoHook, ejecutarHooks } from \"./runner.ts\";\n\ninterface ConfigDelMotor {\n\thooks?: {\n\t\tenabled?: boolean;\n\t\tfailClosedHeadless?: boolean;\n\t\tevents?: Record<string, Array<{ matcher?: string; command: string; timeoutMs?: number }>>;\n\t};\n\tpermissions?: { level?: string };\n\tgoalEngine?: { planOnly?: boolean };\n}\n\n/** Los cuatro que existen de verdad. Si esta lista crece, crece el tipo. */\nconst NIVELES: readonly NivelPermiso[] = [\"plan\", \"manual\", \"auto\", \"yolo\"];\n\n/**\n * Nombres que la gente escribe esperando otra cosa, con su equivalente real.\n *\n * `ask` y `full` estaban en nuestro README y NO existen en el código. Un\n * comprador que ponía `level: \"full\"` esperando plena autonomía se quedaba en\n * `auto` —que aún pregunta en `bash`— y uno que ponía `\"ask\"` esperando\n * confirmación por acción también. Se traducen en vez de rechazarlos porque el\n * README los prometió: romperle la configuración a quien nos creyó sería\n * cobrarle nuestro error.\n */\nconst SINONIMOS: Readonly<Record<string, NivelPermiso>> = { ask: \"manual\", full: \"yolo\" };\n\n/**\n * El nivel de permisos efectivo.\n *\n * UN VALOR DESCONOCIDO NO SE LEE COMO EL POR DEFECTO. Antes, cualquier cosa que\n * no fuera `manual` ni `yolo` caía a `auto` en silencio: una errata como\n * `\"manaul\"` dejaba al usuario con más permisos de los que pidió y sin ningún\n * aviso. En una configuración de permisos, «no te he entendido» y «has elegido\n * el valor por defecto» son cosas distintas, y confundirlas es la familia de\n * fallos que más cara nos ha salido.\n *\n * Se avisa por `stderr` y se cae al MÁS RESTRICTIVO de los dos —`manual`, no\n * `auto`—: ante la duda, preguntar antes de escribir.\n */\nexport function nivelDesdeConfig(config: ConfigDelMotor): NivelPermiso {\n\tif (config.goalEngine?.planOnly === true) return \"plan\";\n\tconst nivel = config.permissions?.level;\n\tif (nivel === undefined || nivel === \"\") return \"auto\";\n\tif ((NIVELES as readonly string[]).includes(nivel)) return nivel as NivelPermiso;\n\tconst sinonimo = SINONIMOS[nivel];\n\tif (sinonimo) return sinonimo;\n\tconsole.error(\n\t\t`Ada: \"permissions.level\" vale \"${nivel}\", que no es ninguno de ${NIVELES.join(\", \")}. ` +\n\t\t\t'Se usa \"manual\" (pregunta antes de cada escritura) por ser el más restrictivo: un valor que no ' +\n\t\t\t\"se entiende no puede dar más permisos de los que pediste.\",\n\t);\n\treturn \"manual\";\n}\n\nexport interface ResultadoHooks {\n\t/** `true` si hay que impedir la acción. */\n\tbloquea: boolean;\n\tmotivo: string;\n}\n\nconst SIN_HOOKS: ResultadoHooks = { bloquea: false, motivo: \"\" };\n\n/**\n * Dispara los hooks de un evento y dice si hay que parar.\n *\n * `ask` se trata como bloqueo: aquí no hay a quién preguntar —el enganche corre\n * dentro de la llamada a la herramienta, no en el bucle de la interfaz—, y ante\n * la duda se cierra. El motivo lo explica al usuario, que puede reintentar tras\n * ajustar el hook o el modo.\n */\nexport async function dispararHooks(\n\tconfig: ConfigDelMotor,\n\tevento: EventoHook,\n\tobjetivo: string,\n\tcontexto: Omit<ContextoHook, \"evento\">,\n): Promise<ResultadoHooks> {\n\tconst hooks = planificarHooks(config.hooks, evento, objetivo);\n\t// Salida temprana: sin hooks configurados, ni se mira el modo. Ver cabecera.\n\tif (hooks.length === 0) return SIN_HOOKS;\n\n\tconst respuestas = await ejecutarHooks(hooks, { ...contexto, evento });\n\tconst { decision, motivos } = resolverDecision(\n\t\trespuestas,\n\t\tnivelDesdeConfig(config),\n\t\tconfig.hooks?.failClosedHeadless ?? true,\n\t);\n\tif (decision === \"allow\") return SIN_HOOKS;\n\n\tconst explicacion = motivos.filter(Boolean).join(\"; \");\n\treturn {\n\t\tbloquea: true,\n\t\tmotivo:\n\t\t\tdecision === \"deny\"\n\t\t\t\t? `Bloqueado por un hook${explicacion ? `: ${explicacion}` : \"\"}`\n\t\t\t\t: `Un hook pide aprobación explícita${explicacion ? `: ${explicacion}` : \"\"}`,\n\t};\n}\n"]}
+{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;KAC1F,CAAC;IACF,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAarE;AAED,MAAM,WAAW,cAAc;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/core/hooks/session-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../../../src/core/hooks/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAqB,aAAa,EAAE,MAAM,aAAa,CAAC;AAY/D,4EAA4E;AAC5E,MAAM,OAAO,GAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,SAAS,GAA2C,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE1F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAgB;IACtE,IAAI,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACvD,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAqB,CAAC;IACjF,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,CAAC,KAAK,CACZ,kCAAkC,KAAK,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACvF,kGAAiG;QACjG,4DAA2D,CAC5D,CAAC;IACF,OAAO,QAAQ,CAAC;AAAA,CAChB;AAQD,MAAM,SAAS,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAsB,EACtB,MAAkB,EAClB,QAAgB,EAChB,QAAsC,EACZ;IAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9D,6EAA6E;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAC7C,UAAU,EACV,gBAAgB,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,KAAK,EAAE,kBAAkB,IAAI,IAAI,CACxC,CAAC;IACF,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO;QACN,OAAO,EAAE,IAAI;QACb,MAAM,EACL,QAAQ,KAAK,MAAM;YAClB,CAAC,CAAC,wBAAwB,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACjE,CAAC,CAAC,sCAAoC,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC/E,CAAC;AAAA,CACF","sourcesContent":["/**\n * Pegamento entre la sesión y los hooks.\n *\n * Vive aparte de `agent-session.ts` a propósito: ese fichero es de upstream y\n * cada línea que le añadimos se paga en cada sincronización. Aquí cabe toda la\n * lógica y allí queda una llamada.\n *\n * Regla de oro del enganche: **si no hay hooks configurados para este evento,\n * esto no debe cambiar absolutamente nada**. `resolverDecision` devuelve el\n * techo del modo cuando no hay respuestas, y aplicar ese techo aquí bloquearía\n * cada herramienta en modo manual aunque el usuario no haya configurado un solo\n * hook. Por eso se sale antes de consultar nada.\n */\n\nimport type { EventoHook, NivelPermiso } from \"./contract.ts\";\nimport { planificarHooks, resolverDecision } from \"./contract.ts\";\nimport { type ContextoHook, ejecutarHooks } from \"./runner.ts\";\n\ninterface ConfigDelMotor {\n\thooks?: {\n\t\tenabled?: boolean;\n\t\tfailClosedHeadless?: boolean;\n\t\tevents?: Record<string, Array<{ matcher?: string; command: string; timeoutMs?: number }>>;\n\t};\n\tpermissions?: { level?: string };\n\tgoalEngine?: { planOnly?: boolean };\n}\n\n/** Los cuatro que existen de verdad. Si esta lista crece, crece el tipo. */\nconst NIVELES: readonly NivelPermiso[] = [\"plan\", \"manual\", \"auto\", \"yolo\"];\n\n/**\n * Nombres que la gente escribe esperando otra cosa, con su equivalente real.\n *\n * `ask` y `full` estaban en nuestro README y NO existen en el código. Un\n * comprador que ponía `level: \"full\"` esperando plena autonomía se quedaba en\n * `auto` —que aún pregunta en `bash`— y uno que ponía `\"ask\"` esperando\n * confirmación por acción también. Se traducen en vez de rechazarlos porque el\n * README los prometió: romperle la configuración a quien nos creyó sería\n * cobrarle nuestro error.\n */\nconst SINONIMOS: Readonly<Record<string, NivelPermiso>> = { ask: \"manual\", full: \"yolo\" };\n\n/**\n * El nivel de permisos efectivo.\n *\n * UN VALOR DESCONOCIDO NO SE LEE COMO EL POR DEFECTO. Antes, cualquier cosa que\n * no fuera `manual` ni `yolo` caía a `auto` en silencio: una errata como\n * `\"manaul\"` dejaba al usuario con más permisos de los que pidió y sin ningún\n * aviso. En una configuración de permisos, «no te he entendido» y «has elegido\n * el valor por defecto» son cosas distintas, y confundirlas es la familia de\n * fallos que más cara nos ha salido.\n *\n * Se avisa por `stderr` y se cae al MÁS RESTRICTIVO de los dos —`manual`, no\n * `auto`—: ante la duda, preguntar antes de escribir.\n */\nexport function nivelDesdeConfig(config: ConfigDelMotor): NivelPermiso {\n\tif (config.goalEngine?.planOnly === true) return \"plan\";\n\tconst nivel = config.permissions?.level;\n\tif (nivel === undefined || nivel === \"\") return \"auto\";\n\tif ((NIVELES as readonly string[]).includes(nivel)) return nivel as NivelPermiso;\n\tconst sinonimo = SINONIMOS[nivel];\n\tif (sinonimo) return sinonimo;\n\tconsole.error(\n\t\t`Ada: \"permissions.level\" vale \"${nivel}\", que no es ninguno de ${NIVELES.join(\", \")}. ` +\n\t\t\t'Se usa \"manual\" (pregunta antes de cada escritura) por ser el más restrictivo: un valor que no ' +\n\t\t\t\"se entiende no puede dar más permisos de los que pediste.\",\n\t);\n\treturn \"manual\";\n}\n\nexport interface ResultadoHooks {\n\t/** `true` si hay que impedir la acción. */\n\tbloquea: boolean;\n\tmotivo: string;\n}\n\nconst SIN_HOOKS: ResultadoHooks = { bloquea: false, motivo: \"\" };\n\n/**\n * Dispara los hooks de un evento y dice si hay que parar.\n *\n * `ask` se trata como bloqueo: aquí no hay a quién preguntar —el enganche corre\n * dentro de la llamada a la herramienta, no en el bucle de la interfaz—, y ante\n * la duda se cierra. El motivo lo explica al usuario, que puede reintentar tras\n * ajustar el hook o el modo.\n */\nexport async function dispararHooks(\n\tconfig: ConfigDelMotor,\n\tevento: EventoHook,\n\tobjetivo: string,\n\tcontexto: Omit<ContextoHook, \"evento\">,\n): Promise<ResultadoHooks> {\n\tconst hooks = planificarHooks(config.hooks, evento, objetivo);\n\t// Salida temprana: sin hooks configurados, ni se mira el modo. Ver cabecera.\n\tif (hooks.length === 0) return SIN_HOOKS;\n\n\tconst respuestas = await ejecutarHooks(hooks, { ...contexto, evento });\n\tconst { decision, motivos } = resolverDecision(\n\t\trespuestas,\n\t\tnivelDesdeConfig(config),\n\t\tconfig.hooks?.failClosedHeadless ?? true,\n\t);\n\tif (decision === \"allow\") return SIN_HOOKS;\n\n\tconst explicacion = motivos.filter(Boolean).join(\"; \");\n\treturn {\n\t\tbloquea: true,\n\t\tmotivo:\n\t\t\tdecision === \"deny\"\n\t\t\t\t? `Bloqueado por un hook${explicacion ? `: ${explicacion}` : \"\"}`\n\t\t\t\t: `Un hook pide aprobación explícita${explicacion ? `: ${explicacion}` : \"\"}`,\n\t};\n}\n"]}
+{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../../../src/core/hooks/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAqB,aAAa,EAAE,MAAM,aAAa,CAAC;AAY/D,4EAA4E;AAC5E,MAAM,OAAO,GAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,SAAS,GAA2C,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE1F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACtD,IAAI,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACvD,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAqB,CAAC;IACjF,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,CAAC,KAAK,CACZ,kCAAkC,KAAK,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACvF,iGAAiG;QACjG,2DAA2D,CAC5D,CAAC;IACF,OAAO,QAAQ,CAAC;AACjB,CAAC;AAQD,MAAM,SAAS,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAsB,EACtB,MAAkB,EAClB,QAAgB,EAChB,QAAsC;IAEtC,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9D,6EAA6E;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAC7C,UAAU,EACV,gBAAgB,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,KAAK,EAAE,kBAAkB,IAAI,IAAI,CACxC,CAAC;IACF,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO;QACN,OAAO,EAAE,IAAI;QACb,MAAM,EACL,QAAQ,KAAK,MAAM;YAClB,CAAC,CAAC,wBAAwB,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACjE,CAAC,CAAC,oCAAoC,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC/E,CAAC;AACH,CAAC"}

package/dist/core/hooks-ts/cargador.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cargador de hooks TypeScript in-process — B05.
+ *
+ * Usa jiti, el mismo cargador que las extensions: un hook es un fichero .ts
+ * que se compila al vuelo y se importa como módulo. La diferencia con una
+ * extensión es el contrato: aquí no hay factory con API, solo un objeto
+ * `{matcher?, onToolCall}` validado con `esModuloHookTs` ANTES de usarse.
+ *
+ * Fail-closed: este módulo nunca lanza. Un hook que no existe, que no
+ * compila o que exporta otra cosa se traduce en `null` (o en el error
+ * legible del resultado), y es cosa del runner decidir qué hacer con él.
+ */
+import { type HookTsCargado } from "./tipos.ts";
+/** Timeout por defecto por hook; igual que el runner de hooks de shell. */
+export declare const TIMEOUT_HOOK_TS_POR_DEFECTO_MS = 10000;
+export interface ResultadoCargaHook {
+    hook: HookTsCargado | null;
+    /** Motivo legible cuando `hook` es null: compilación, forma o export vacío. */
+    error: string | null;
+}
+/**
+ * Carga un hook TS desde disco y valida su forma.
+ *
+ * Acepta default export y named export (`hook`): ambos son cómodos de
+ * escribir a mano y ninguno puede confundirse con otra cosa, porque después
+ * pasa el mismo `esModuloHookTs`.
+ */
+export declare function cargarHookTs(rutaAbsoluta: string): Promise<ResultadoCargaHook>;
+//# sourceMappingURL=cargador.d.ts.map

package/dist/core/hooks-ts/cargador.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cargador.d.ts","sourceRoot":"","sources":["../../../src/core/hooks-ts/cargador.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAaD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiBpF"}

package/dist/core/hooks-ts/cargador.js

@@ -0,0 +1,51 @@
+/**
+ * Cargador de hooks TypeScript in-process — B05.
+ *
+ * Usa jiti, el mismo cargador que las extensions: un hook es un fichero .ts
+ * que se compila al vuelo y se importa como módulo. La diferencia con una
+ * extensión es el contrato: aquí no hay factory con API, solo un objeto
+ * `{matcher?, onToolCall}` validado con `esModuloHookTs` ANTES de usarse.
+ *
+ * Fail-closed: este módulo nunca lanza. Un hook que no existe, que no
+ * compila o que exporta otra cosa se traduce en `null` (o en el error
+ * legible del resultado), y es cosa del runner decidir qué hacer con él.
+ */
+import { createJiti } from "jiti/static";
+import { esModuloHookTs } from "./tipos.js";
+/** Timeout por defecto por hook; igual que el runner de hooks de shell. */
+export const TIMEOUT_HOOK_TS_POR_DEFECTO_MS = 10_000;
+let _jiti = null;
+function jitiDelCargador() {
+    if (!_jiti) {
+        // moduleCache: false — editar el .ts del hook debe surtir efecto sin
+        // reiniciar, igual que las extensions.
+        _jiti = createJiti(import.meta.url, { moduleCache: false });
+    }
+    return _jiti;
+}
+/**
+ * Carga un hook TS desde disco y valida su forma.
+ *
+ * Acepta default export y named export (`hook`): ambos son cómodos de
+ * escribir a mano y ninguno puede confundirse con otra cosa, porque después
+ * pasa el mismo `esModuloHookTs`.
+ */
+export async function cargarHookTs(rutaAbsoluta) {
+    let modulo;
+    try {
+        modulo = await jitiDelCargador().import(rutaAbsoluta);
+    }
+    catch (err) {
+        return { hook: null, error: `No se pudo cargar el hook ${rutaAbsoluta}: ${String(err)}` };
+    }
+    const candidatos = typeof modulo === "object" && modulo !== null
+        ? [modulo.default, modulo.hook, modulo]
+        : [modulo];
+    for (const candidato of candidatos) {
+        if (esModuloHookTs(candidato)) {
+            return { hook: { origen: rutaAbsoluta, hook: candidato }, error: null };
+        }
+    }
+    return { hook: null, error: `${rutaAbsoluta} no exporta un hook TS válido ({matcher?, onToolCall})` };
+}
+//# sourceMappingURL=cargador.js.map

package/dist/core/hooks-ts/cargador.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cargador.js","sourceRoot":"","sources":["../../../src/core/hooks-ts/cargador.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAsB,MAAM,YAAY,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAQrD,IAAI,KAAK,GAAyC,IAAI,CAAC;AAEvD,SAAS,eAAe;IACvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,qEAAqE;QACrE,uCAAuC;QACvC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACtD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,YAAY,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC3F,CAAC;IACD,MAAM,UAAU,GACf,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAC5C,CAAC,CAAC,CAAE,MAAkC,CAAC,OAAO,EAAG,MAAkC,CAAC,IAAI,EAAE,MAAM,CAAC;QACjG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACb,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,wDAAwD,EAAE,CAAC;AACvG,CAAC"}

package/dist/core/hooks-ts/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hooks TypeScript in-process — B05.
+ *
+ * Complementa (no sustituye) los hooks de shell de `core/hooks/`: mismos
+ * reflejos — matcher con la semántica de `planificarHooks`, fail-closed por
+ * defecto, nunca lanzar desde el runner — pero recibiendo objetos tipados y
+ * pudiendo REESCRIBIR el input de una tool.
+ *
+ * Contrato del consumidor (invariante de seguridad, ver runner.ts):
+ *
+ *   const r = await ejecutarHooksTs(hooks, entrada);
+ *   if (r.bloquea) return bloquear(r.motivo);
+ *   let input = entrada.input;
+ *   if (r.requiereAprobacion) {
+ *     // «approve one thing, run another»: re-aprobar SIEMPRE sobre
+ *     // effectiveParams, nunca sobre el input original que se aprobó antes.
+ *     input = await reaprobar(entrada.toolName, r.effectiveParams!);
+ *   }
+ *   // ejecutar con `input`
+ *
+ */
+export { cargarHookTs, TIMEOUT_HOOK_TS_POR_DEFECTO_MS } from "./cargador.ts";
+export { ejecutarHooksTs, type OpcionesRunnerHooksTs, type ResultadoHooksTs } from "./runner.ts";
+export { casaMatcher, type EntradaToolCall, esModuloHookTs, esVeredictoHookTs, type HookTsCargado, type ModuloHookTs, VEREDICTOS_HOOK_TS, type Veredicto, type VeredictoHookTs, } from "./tipos.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/hooks-ts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/hooks-ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EACN,WAAW,EACX,KAAK,eAAe,EACpB,cAAc,EACd,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,eAAe,GACpB,MAAM,YAAY,CAAC"}

package/dist/core/hooks-ts/index.js

@@ -0,0 +1,25 @@
+/**
+ * Hooks TypeScript in-process — B05.
+ *
+ * Complementa (no sustituye) los hooks de shell de `core/hooks/`: mismos
+ * reflejos — matcher con la semántica de `planificarHooks`, fail-closed por
+ * defecto, nunca lanzar desde el runner — pero recibiendo objetos tipados y
+ * pudiendo REESCRIBIR el input de una tool.
+ *
+ * Contrato del consumidor (invariante de seguridad, ver runner.ts):
+ *
+ *   const r = await ejecutarHooksTs(hooks, entrada);
+ *   if (r.bloquea) return bloquear(r.motivo);
+ *   let input = entrada.input;
+ *   if (r.requiereAprobacion) {
+ *     // «approve one thing, run another»: re-aprobar SIEMPRE sobre
+ *     // effectiveParams, nunca sobre el input original que se aprobó antes.
+ *     input = await reaprobar(entrada.toolName, r.effectiveParams!);
+ *   }
+ *   // ejecutar con `input`
+ *
+ */
+export { cargarHookTs, TIMEOUT_HOOK_TS_POR_DEFECTO_MS } from "./cargador.js";
+export { ejecutarHooksTs } from "./runner.js";
+export { casaMatcher, esModuloHookTs, esVeredictoHookTs, VEREDICTOS_HOOK_TS, } from "./tipos.js";
+//# sourceMappingURL=index.js.map

package/dist/core/hooks-ts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/hooks-ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAqD,MAAM,aAAa,CAAC;AACjG,OAAO,EACN,WAAW,EAEX,cAAc,EACd,iBAAiB,EAGjB,kBAAkB,GAGlB,MAAM,YAAY,CAAC"}

package/dist/core/hooks-ts/runner.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Runner de los hooks TypeScript in-process — B05.
+ *
+ * Ejecuta los hooks en orden determinista (ordenados por `origen`, el primer
+ * veredicto que bloquea gana) y compite cada `onToolCall` contra un timer con
+ * `raceHandlerWithTimeout` del kit de higiene: un hook colgado o que revienta
+ * queda aislado y se resuelve según `failClosed` (por defecto, cerrar).
+ *
+ * El invariante que da nombre a la brecha que cierra («approve one thing,
+ * run another»): una reescritura NUNCA sale de aquí lista para aplicar. Si
+ * `effectiveParams` difiere del input recibido, el resultado lleva
+ * `requiereAprobacion: true` y el consumidor está obligado a re-aprobar SOBRE
+ * LOS PARÁMETROS EFECTIVOS antes de ejecutar nada. No existe camino por el
+ * que este runner devuelva `effectiveParams` sin esa marca.
+ */
+import { type EntradaToolCall, type HookTsCargado } from "./tipos.ts";
+export interface ResultadoHooksTs {
+    /** true = no ejecutar la herramienta. */
+    bloquea: boolean;
+    motivo: string;
+    /**
+     * Invariante de seguridad B05. true ⇔ algún hook propuso `effectiveParams`
+     * distinto del input con el que entró la llamada. El consumidor debe
+     * re-aprobar sobre esos parámetros antes de usarlos; aplicarlos directo
+     * ejecutaría algo que nadie aprobó.
+     */
+    requiereAprobacion: boolean;
+    effectiveParams?: Record<string, unknown>;
+}
+export interface OpcionesRunnerHooksTs {
+    timeoutMs?: number;
+    /** Un hook que se cuelga o revienta cierra el paso. Por defecto true. */
+    failClosed?: boolean;
+}
+/**
+ * Ejecuta los hooks TS sobre una llamada a tool y devuelve la decisión
+ * agregada. Nunca lanza: un módulo dinámico no puede tumbar el turno.
+ */
+export declare function ejecutarHooksTs(hooks: readonly HookTsCargado[], entrada: EntradaToolCall, opciones?: OpcionesRunnerHooksTs): Promise<ResultadoHooksTs>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/core/hooks-ts/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/core/hooks-ts/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAEN,KAAK,eAAe,EAEpB,KAAK,aAAa,EAGlB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD;;;GAGG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,EAAE,eAAe,EACxB,QAAQ,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAqE3B"}

package/dist/core/hooks-ts/runner.js

@@ -0,0 +1,95 @@
+/**
+ * Runner de los hooks TypeScript in-process — B05.
+ *
+ * Ejecuta los hooks en orden determinista (ordenados por `origen`, el primer
+ * veredicto que bloquea gana) y compite cada `onToolCall` contra un timer con
+ * `raceHandlerWithTimeout` del kit de higiene: un hook colgado o que revienta
+ * queda aislado y se resuelve según `failClosed` (por defecto, cerrar).
+ *
+ * El invariante que da nombre a la brecha que cierra («approve one thing,
+ * run another»): una reescritura NUNCA sale de aquí lista para aplicar. Si
+ * `effectiveParams` difiere del input recibido, el resultado lleva
+ * `requiereAprobacion: true` y el consumidor está obligado a re-aprobar SOBRE
+ * LOS PARÁMETROS EFECTIVOS antes de ejecutar nada. No existe camino por el
+ * que este runner devuelva `effectiveParams` sin esa marca.
+ */
+import { raceHandlerWithTimeout } from "../higiene/race-handler.js";
+import { TIMEOUT_HOOK_TS_POR_DEFECTO_MS } from "./cargador.js";
+import { casaMatcher, esVeredictoHookTs, igualesProfundo, } from "./tipos.js";
+const SIN_HOOKS = { bloquea: false, motivo: "", requiereAprobacion: false };
+/** Centinela interno: distingue «el handler llegó tarde o revientó» de un veredicto real. */
+const FALLO_INTERNO = Symbol("hook-ts-fallo");
+function ordenDeterminista(hooks) {
+    return [...hooks].sort((a, b) => (a.origen < b.origen ? -1 : a.origen > b.origen ? 1 : 0));
+}
+/**
+ * Ejecuta los hooks TS sobre una llamada a tool y devuelve la decisión
+ * agregada. Nunca lanza: un módulo dinámico no puede tumbar el turno.
+ */
+export async function ejecutarHooksTs(hooks, entrada, opciones = {}) {
+    if (hooks.length === 0)
+        return SIN_HOOKS;
+    const failClosed = opciones.failClosed ?? true;
+    const timeoutMs = opciones.timeoutMs ?? TIMEOUT_HOOK_TS_POR_DEFECTO_MS;
+    // Los hooks posteriores ven lo que va a ejecutarse DE VERDAD: tras una
+    // reescritura pendiente de aprobar, evalúan sobre effectiveParams.
+    let inputVigente = entrada.input;
+    let reescrituraPendiente = null;
+    for (const cargado of ordenDeterminista(hooks)) {
+        const { hook, origen } = cargado;
+        if (!casaMatcher(hook.matcher, entrada.toolName))
+            continue;
+        let veredicto;
+        try {
+            const promesa = Promise.resolve(hook.onToolCall({ ...entrada, input: inputVigente }));
+            veredicto = await raceHandlerWithTimeout(promesa, timeoutMs, FALLO_INTERNO);
+        }
+        catch {
+            veredicto = FALLO_INTERNO;
+        }
+        if (veredicto === FALLO_INTERNO || !esVeredictoHookTs(veredicto)) {
+            if (!failClosed)
+                continue;
+            return {
+                bloquea: true,
+                motivo: `Hook TS ${origen} falló o excedió ${timeoutMs}ms — fail-closed`,
+                requiereAprobacion: false,
+            };
+        }
+        switch (veredicto.veredicto) {
+            case "rechazar":
+                return {
+                    bloquea: true,
+                    motivo: veredicto.motivo ?? `Rechazado por hook TS ${origen}`,
+                    requiereAprobacion: false,
+                };
+            case "permitir":
+                continue;
+            case "reescribir": {
+                if (!veredicto.effectiveParams) {
+                    // Reescribir sin parámetros es un veredicto ilegible: ni pasar
+                    // silenciosamente ni fabricar un input vacío.
+                    if (!failClosed)
+                        continue;
+                    return {
+                        bloquea: true,
+                        motivo: `Hook TS ${origen} pidió reescribir sin effectiveParams — fail-closed`,
+                        requiereAprobacion: false,
+                    };
+                }
+                if (igualesProfundo(veredicto.effectiveParams, inputVigente))
+                    continue;
+                reescrituraPendiente = {
+                    bloquea: false,
+                    motivo: veredicto.motivo ?? `Reescritura propuesta por hook TS ${origen}`,
+                    requiereAprobacion: true,
+                    effectiveParams: veredicto.effectiveParams,
+                };
+                inputVigente = veredicto.effectiveParams;
+                continue;
+            }
+        }
+    }
+    return reescrituraPendiente ?? SIN_HOOKS;
+}
+//# sourceMappingURL=runner.js.map

package/dist/core/hooks-ts/runner.js.map

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

package/dist/core/hooks-ts/tipos.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Contrato de los hooks TypeScript in-process — B05.
+ *
+ * Este fichero es PURO a propósito: tipos, validación y comparación. Nada
+ * carga módulos ni toca el reloj, igual que `core/hooks/contract.ts` para los
+ * hooks de shell.
+ *
+ * Diferencia clave con los hooks de shell: aquí el hook recibe objetos
+ * tipados y puede REESCRIBIR el input que ejecutará la tool. Ese poder es
+ * exactamente la brecha «approve one thing, run another»: si un hook
+ * reescribe `{file: "a.txt"}` a `{file: ".env"}`, la aprobación que el humano
+ * dio fue para `a.txt`. Por eso la reescritura NUNCA se aplica directa: el
+ * runner marca `requiereAprobacion` y el consumidor está obligado a
+ * re-aprobar sobre `effectiveParams` antes de ejecutar nada.
+ */
+/** Los tres veredictos que un hook TS puede emitir. */
+export declare const VEREDICTOS_HOOK_TS: readonly ["permitir", "rechazar", "reescribir"];
+export type Veredicto = (typeof VEREDICTOS_HOOK_TS)[number];
+/** Lo que el hook ve de la llamada a tool. */
+export interface EntradaToolCall {
+    toolName: string;
+    toolCallId?: string;
+    /** Input tal cual llegará a la tool si nadie lo toca. */
+    input: Record<string, unknown>;
+    sessionId?: string;
+    cwd?: string;
+}
+/** Lo que un hook TS responde a onToolCall. */
+export interface VeredictoHookTs {
+    veredicto: Veredicto;
+    effectiveParams?: Record<string, unknown>;
+    motivo?: string;
+}
+/**
+ * Un hook TS: un módulo que exporta esto.
+ *
+ * `matcher` es una expresión regular contra `toolName`; ausente casa con todo;
+ * inválida NO casa y no revienta (misma regla que `planificarHooks`).
+ */
+export interface ModuloHookTs {
+    matcher?: string;
+    onToolCall(entrada: EntradaToolCall): VeredictoHookTs | Promise<VeredictoHookTs>;
+}
+/** Hook ya cargado, con su origen para orden determinista y diagnóstico. */
+export interface HookTsCargado {
+    origen: string;
+    hook: ModuloHookTs;
+}
+/**
+ * Validación fail-closed de un módulo cargado dinámicamente: cualquier cosa
+ * que no sea exactamente un hook devuelve false y el runner lo ignora (o
+ * bloquea, según su política), nunca lo invoca a ciegas.
+ */
+export declare function esModuloHookTs(valor: unknown): valor is ModuloHookTs;
+/**
+ * Validación del VEREDICTO que devuelve un módulo dinámico. El módulo pasó
+ * jiti y no es de confianza estructural: un `veredicto` que no sea uno de los
+ * tres, o una reescritura cuyo `effectiveParams` no sea un objeto plano, es
+ * un veredicto ilegible y el runner lo trata como fallo del hook.
+ */
+export declare function esVeredictoHookTs(valor: unknown): valor is VeredictoHookTs;
+/**
+ * ¿Casa este matcher con el nombre de la tool? Misma semántica que los hooks
+ * de shell: matcher ausente casa con todo; regex inválida no casa ni revienta.
+ */
+export declare function casaMatcher(matcher: string | undefined, toolName: string): boolean;
+/** Igualdad estructural estable: la usamos para saber si la reescritura cambia algo de verdad. */
+export declare function igualesProfundo(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=tipos.d.ts.map

package/dist/core/hooks-ts/tipos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.d.ts","sourceRoot":"","sources":["../../../src/core/hooks-ts/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,iDAAkD,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjF;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACnB;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAIpE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOlF;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAe/D"}