@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/advisor/sesion.js

@@ -0,0 +1,139 @@
+/**
+ * El advisor enganchado a una sesión.
+ *
+ * Aquí vive el CUÁNDO y el CON QUÉ; el qué se pregunta está en `runtime.ts` y
+ * lo que puede decir, en `guarda.ts`. Separado en un módulo propio porque
+ * `agent-session.ts` es de upstream y cada región nuestra que viva dentro es un
+ * hunk que se reaplica en cada sincronización: allí solo entran un campo y una
+ * llamada.
+ *
+ * Tres decisiones sobre el coste, que es lo que decide si esto se queda
+ * encendido o lo apaga el usuario a la semana:
+ *
+ * - **No mira cada turno.** Por defecto uno de cada dos. Un observador que
+ *   opina en cada respuesta duplica el gasto y no ve el doble de problemas: los
+ *   errores que importan se cometen y siguen ahí varios turnos.
+ * - **Modelo barato.** El advisor no escribe código, lee. Gastar el modelo
+ *   grande en mirar es pagar el precio del que hace el trabajo por el que
+ *   observa.
+ * - **Solo la cola del transcript.** Mandar la conversación entera en cada
+ *   vuelta crece con la sesión hasta que el observador cuesta más que el
+ *   agente.
+ */
+import { Advisor } from "./runtime.js";
+/**
+ * El transcript que ve el observador: quién dijo qué, sin adornos.
+ *
+ * Se aplanan las llamadas a herramienta a una línea. El advisor no necesita los
+ * argumentos completos de cada `edit` para ver que el agente lleva tres intentos
+ * con el mismo error, y mandárselos multiplica el coste por nada.
+ */
+export function transcriptParaAdvisor(mensajes) {
+    const lineas = [];
+    for (const m of mensajes) {
+        const bloques = Array.isArray(m.content) ? m.content : [];
+        const partes = [];
+        for (const bruto of bloques) {
+            if (bruto?.type === "text" && typeof bruto.text === "string")
+                partes.push(bruto.text);
+            else if (bruto?.type === "toolCall" || bruto?.type === "tool_use")
+                partes.push(`[${String(bruto.name ?? "tool")}]`);
+        }
+        if (typeof m.content === "string")
+            partes.push(m.content);
+        const texto = partes.join(" ").replace(/\s+/g, " ").trim();
+        if (texto)
+            lineas.push(`${m.role}: ${texto.slice(0, 1500)}`);
+    }
+    return lineas.join("\n");
+}
+/** Cuánto transcript ve el observador. Suficiente para el contexto reciente. */
+const COLA_MAXIMA = 12_000;
+export class AdvisorDeSesion {
+    deps;
+    advisor;
+    turnos = 0;
+    /** Evita solapar dos vueltas si el agente va más rápido que el observador. */
+    mirando = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.advisor = new Advisor({
+            consultar: deps.consultar,
+            entregar: deps.entregar,
+            anotar: deps.anotar,
+        });
+    }
+    /** Al compactar, en `/new` y al cambiar de sesión. */
+    reiniciar() {
+        this.turnos = 0;
+        this.advisor.reiniciar();
+    }
+    /**
+     * Un turno ha terminado.
+     *
+     * No devuelve promesa a propósito: el turno del usuario no espera al
+     * observador. Si el advisor tarda, su aviso llega al turno siguiente, que es
+     * lo correcto — bloquear la conversación para opinar sobre ella la
+     * convertiría en el problema que venía a evitar.
+     */
+    trasTurno(transcript) {
+        const { enabled, cadaCuantosTurnos } = this.deps.config();
+        if (!enabled)
+            return;
+        this.turnos++;
+        if (this.turnos % cadaCuantosTurnos !== 0)
+            return;
+        if (this.mirando)
+            return;
+        this.mirando = true;
+        void this.advisor
+            .mirar(transcript.length > COLA_MAXIMA ? transcript.slice(-COLA_MAXIMA) : transcript)
+            .finally(() => {
+            this.mirando = false;
+        });
+    }
+}
+/**
+ * Ata el advisor a una sesión.
+ *
+ * Vive aquí y no en `agent-session.ts` por el presupuesto de fork: allí el
+ * método que llama a esto son doce líneas y una llamada.
+ *
+ * El modelo observador es HOY el mismo de la sesión. Es una decisión consciente
+ * y su coste está acotado por los otros dos lados —mira uno de cada dos turnos
+ * y solo ve la cola del transcript—, pero conviene decirlo en vez de dar a
+ * entender que sale gratis. Cuando el resolvedor de tiers esté expuesto fuera
+ * de los workflows, esto pasa al barato y el coste baja otra vez.
+ */
+export function construirAdvisorDeSesion(entorno) {
+    return new AdvisorDeSesion({
+        config: () => entorno.settings.getEngineConfig().advisor,
+        consultar: async (sistema, transcript) => {
+            const modelo = entorno.modelo();
+            if (!modelo)
+                return "NADA";
+            const respuesta = await entorno.runtime.completeSimple(modelo, {
+                systemPrompt: sistema,
+                messages: [{ role: "user", content: transcript }],
+            });
+            const bloques = respuesta.content;
+            return bloques
+                .filter((b) => b?.type === "text" && typeof b.text === "string")
+                .map((b) => b.text)
+                .join("");
+        },
+        entregar: entorno.entregar,
+        anotar: (resultado) => {
+            // Se anota SIEMPRE, entregue o no. Sin esto no hay forma de saber si el
+            // advisor lleva media hora callado porque no ve nada o porque falla.
+            entorno.libro?.anotar({
+                tipo: "tool",
+                nombre: "advisor",
+                ok: true,
+                decision: resultado.entregado ? "entregada" : "callado",
+                motivo: resultado.descartado ?? resultado.entregado?.severidad,
+            });
+        },
+    });
+}
+//# sourceMappingURL=sesion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sesion.js","sourceRoot":"","sources":["../../../src/core/advisor/sesion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * El advisor enganchado a una sesión.\n *\n * Aquí vive el CUÁNDO y el CON QUÉ; el qué se pregunta está en `runtime.ts` y\n * lo que puede decir, en `guarda.ts`. Separado en un módulo propio porque\n * `agent-session.ts` es de upstream y cada región nuestra que viva dentro es un\n * hunk que se reaplica en cada sincronización: allí solo entran un campo y una\n * llamada.\n *\n * Tres decisiones sobre el coste, que es lo que decide si esto se queda\n * encendido o lo apaga el usuario a la semana:\n *\n * - **No mira cada turno.** Por defecto uno de cada dos. Un observador que\n *   opina en cada respuesta duplica el gasto y no ve el doble de problemas: los\n *   errores que importan se cometen y siguen ahí varios turnos.\n * - **Modelo barato.** El advisor no escribe código, lee. Gastar el modelo\n *   grande en mirar es pagar el precio del que hace el trabajo por el que\n *   observa.\n * - **Solo la cola del transcript.** Mandar la conversación entera en cada\n *   vuelta crece con la sesión hasta que el observador cuesta más que el\n *   agente.\n */\n\nimport type { SeveridadAviso } from \"./guarda.ts\";\nimport { Advisor, type ResultadoVuelta } from \"./runtime.ts\";\n\n/**\n * El transcript que ve el observador: quién dijo qué, sin adornos.\n *\n * Se aplanan las llamadas a herramienta a una línea. El advisor no necesita los\n * argumentos completos de cada `edit` para ver que el agente lleva tres intentos\n * con el mismo error, y mandárselos multiplica el coste por nada.\n */\nexport function transcriptParaAdvisor(mensajes: Array<{ role: string; content?: unknown }>): string {\n\tconst lineas: string[] = [];\n\tfor (const m of mensajes) {\n\t\tconst bloques = Array.isArray(m.content) ? m.content : [];\n\t\tconst partes: string[] = [];\n\t\tfor (const bruto of bloques as Array<Record<string, unknown>>) {\n\t\t\tif (bruto?.type === \"text\" && typeof bruto.text === \"string\") partes.push(bruto.text);\n\t\t\telse if (bruto?.type === \"toolCall\" || bruto?.type === \"tool_use\")\n\t\t\t\tpartes.push(`[${String(bruto.name ?? \"tool\")}]`);\n\t\t}\n\t\tif (typeof m.content === \"string\") partes.push(m.content);\n\t\tconst texto = partes.join(\" \").replace(/\\s+/g, \" \").trim();\n\t\tif (texto) lineas.push(`${m.role}: ${texto.slice(0, 1500)}`);\n\t}\n\treturn lineas.join(\"\\n\");\n}\n\n/** Cuánto transcript ve el observador. Suficiente para el contexto reciente. */\nconst COLA_MAXIMA = 12_000;\n\nexport interface DependenciasAdvisorDeSesion {\n\t/** ¿Está encendido y cada cuántos turnos mira? */\n\tconfig: () => { enabled: boolean; cadaCuantosTurnos: number };\n\t/** Consulta al modelo observador (el barato). */\n\tconsultar: (sistema: string, transcript: string) => Promise<string>;\n\t/** Entrega la observación al agente principal. */\n\tentregar: (texto: string, severidad: SeveridadAviso) => void;\n\t/** Deja constancia en el libro de sesión. */\n\tanotar?: (resultado: ResultadoVuelta) => void;\n}\n\nexport class AdvisorDeSesion {\n\tprivate readonly deps: DependenciasAdvisorDeSesion;\n\tprivate readonly advisor: Advisor;\n\tprivate turnos = 0;\n\t/** Evita solapar dos vueltas si el agente va más rápido que el observador. */\n\tprivate mirando = false;\n\n\tconstructor(deps: DependenciasAdvisorDeSesion) {\n\t\tthis.deps = deps;\n\t\tthis.advisor = new Advisor({\n\t\t\tconsultar: deps.consultar,\n\t\t\tentregar: deps.entregar,\n\t\t\tanotar: deps.anotar,\n\t\t});\n\t}\n\n\t/** Al compactar, en `/new` y al cambiar de sesión. */\n\treiniciar(): void {\n\t\tthis.turnos = 0;\n\t\tthis.advisor.reiniciar();\n\t}\n\n\t/**\n\t * Un turno ha terminado.\n\t *\n\t * No devuelve promesa a propósito: el turno del usuario no espera al\n\t * observador. Si el advisor tarda, su aviso llega al turno siguiente, que es\n\t * lo correcto — bloquear la conversación para opinar sobre ella la\n\t * convertiría en el problema que venía a evitar.\n\t */\n\ttrasTurno(transcript: string): void {\n\t\tconst { enabled, cadaCuantosTurnos } = this.deps.config();\n\t\tif (!enabled) return;\n\t\tthis.turnos++;\n\t\tif (this.turnos % cadaCuantosTurnos !== 0) return;\n\t\tif (this.mirando) return;\n\n\t\tthis.mirando = true;\n\t\tvoid this.advisor\n\t\t\t.mirar(transcript.length > COLA_MAXIMA ? transcript.slice(-COLA_MAXIMA) : transcript)\n\t\t\t.finally(() => {\n\t\t\t\tthis.mirando = false;\n\t\t\t});\n\t}\n}\n\n/** Lo mínimo que hace falta de la sesión para montar el advisor. */\nexport interface EntornoDelAdvisor {\n\tsettings: { getEngineConfig: () => { advisor: { enabled: boolean; cadaCuantosTurnos: number } } };\n\tmodelo: () => unknown;\n\truntime: { completeSimple: (modelo: never, contexto: never) => Promise<{ content: unknown[] }> };\n\tentregar: (texto: string, severidad: SeveridadAviso) => void;\n\t/** Libro de sesión: lo que dijo el advisor también es auditable. */\n\tlibro?: {\n\t\tanotar: (suceso: { tipo: \"tool\"; nombre: string; ok: boolean; decision?: string; motivo?: string }) => void;\n\t};\n}\n\n/**\n * Ata el advisor a una sesión.\n *\n * Vive aquí y no en `agent-session.ts` por el presupuesto de fork: allí el\n * método que llama a esto son doce líneas y una llamada.\n *\n * El modelo observador es HOY el mismo de la sesión. Es una decisión consciente\n * y su coste está acotado por los otros dos lados —mira uno de cada dos turnos\n * y solo ve la cola del transcript—, pero conviene decirlo en vez de dar a\n * entender que sale gratis. Cuando el resolvedor de tiers esté expuesto fuera\n * de los workflows, esto pasa al barato y el coste baja otra vez.\n */\nexport function construirAdvisorDeSesion(entorno: EntornoDelAdvisor): AdvisorDeSesion {\n\treturn new AdvisorDeSesion({\n\t\tconfig: () => entorno.settings.getEngineConfig().advisor,\n\t\tconsultar: async (sistema, transcript) => {\n\t\t\tconst modelo = entorno.modelo();\n\t\t\tif (!modelo) return \"NADA\";\n\t\t\tconst respuesta = await entorno.runtime.completeSimple(\n\t\t\t\tmodelo as never,\n\t\t\t\t{\n\t\t\t\t\tsystemPrompt: sistema,\n\t\t\t\t\tmessages: [{ role: \"user\", content: transcript }],\n\t\t\t\t} as never,\n\t\t\t);\n\t\t\tconst bloques = respuesta.content as Array<{ type?: string; text?: string }>;\n\t\t\treturn bloques\n\t\t\t\t.filter((b) => b?.type === \"text\" && typeof b.text === \"string\")\n\t\t\t\t.map((b) => b.text)\n\t\t\t\t.join(\"\");\n\t\t},\n\t\tentregar: entorno.entregar,\n\t\tanotar: (resultado) => {\n\t\t\t// Se anota SIEMPRE, entregue o no. Sin esto no hay forma de saber si el\n\t\t\t// advisor lleva media hora callado porque no ve nada o porque falla.\n\t\t\tentorno.libro?.anotar({\n\t\t\t\ttipo: \"tool\",\n\t\t\t\tnombre: \"advisor\",\n\t\t\t\tok: true,\n\t\t\t\tdecision: resultado.entregado ? \"entregada\" : \"callado\",\n\t\t\t\tmotivo: resultado.descartado ?? resultado.entregado?.severidad,\n\t\t\t});\n\t\t},\n\t});\n}\n"]}

package/dist/core/agent-session.d.ts

@@ -107,6 +107,13 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "bash_execution_update";
     id?: string;
     delta: string;
+} | {
+    type: "prompt_optimization";
+    decision: "clarify" | "enhance";
+    original: string;
+    enhanced?: string;
+    questions?: string[];
+    summary?: string;
 };
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
@@ -124,6 +131,8 @@ export interface AgentSessionConfig {
     resourceLoader: ResourceLoader;
     /** SDK custom tools registered outside extensions */
     customTools?: ToolDefinition[];
+    /** Subagentes: desactiva la continuación automática del GoalEngine (anti-recursión). */
+    isSubagent?: boolean;
     /** Canonical model/auth runtime used by coding-agent internals. */
     modelRuntime: ModelRuntime;
     /** Initial active built-in tool names. Default: [read, bash, edit, write] */
@@ -167,6 +176,11 @@ export interface PromptOptions {
     /** Internal hook used by RPC mode to observe prompt preflight acceptance or rejection. */
     preflightResult?: (success: boolean) => void;
 }
+/** Options for model/thinking mutations. */
+export interface ModelMutationOptions {
+    /** Persist the new value to global defaults. Defaults to session-only. */
+    persist?: boolean;
+}
 /** Result from cycleModel() */
 export interface ModelCycleResult {
     model: Model<any>;
@@ -176,6 +190,15 @@ export interface ModelCycleResult {
 }
 /** Session statistics for /session command */
 export interface SessionStats {
+    /**
+     * De qué está hecha la ventana de contexto ahora mismo.
+     *
+     * Viaja aquí, dentro de las estadísticas que el desktop ya pide, en vez de
+     * como tipo de mensaje RPC nuevo: añadirlo al protocolo costaba hunks en
+     * `rpc-types.ts` y `rpc-mode.ts`, que son de upstream y hoy están casi
+     * intactos. Undefined cuando el modelo no declara ventana de contexto.
+     */
+    contextBreakdown?: import("./context-breakdown.ts").DesgloseContexto;
     sessionFile: string | undefined;
     sessionId: string;
     userMessages: number;
@@ -237,6 +260,16 @@ export declare class AgentSession {
     private _extensionErrorListener?;
     private _extensionErrorUnsubscriber?;
     private _modelRuntime;
+    private _isSubagentSession;
+    private _graphSync?;
+    private _advisor?;
+    /** Una vuelta del advisor sobre la sesión. Nunca espera ni lanza. */
+    private _mirarConAdvisor;
+    private readonly _registro;
+    /** Optimizador autónomo de prompts: "off" | "auto" | "clarify". */
+    private _promptOptimizerMode;
+    /** Clarificación pendiente (modo "clarify"): original + preguntas ya emitidas. */
+    private _pendingClarification;
     private _toolRegistry;
     private _toolDefinitions;
     private _toolPromptSnippets;
@@ -261,9 +294,18 @@ export declare class AgentSession {
     /** Emit an event to all listeners */
     private _emit;
     private _emitQueueUpdate;
+    private _emitSessionCompactFailed;
     private _getIdleWaitPromise;
     private _resolveIdleWaitIfIdle;
     private _emitAgentSettled;
+    /**
+     * Confirmación fail-closed del lanzamiento de workflows: emite un evento y
+     * espera respuesta humana hasta 15s; sin respuesta → NO lanzar.
+     */
+    private _confirmWorkflowLaunch;
+    /** Respuesta a una confirmación pendiente (la UI la llama). */
+    resolveWorkflowConfirmation(prompt: string, ok: boolean): boolean;
+    private _maybeContinueGoal;
     /**
      * Replace vault-expanded secrets with the redacted form for UI events and
      * persistence (the LLM still receives the expanded values via agent state).
@@ -276,6 +318,7 @@ export declare class AgentSession {
     private _maybeAutoMemorize;
     private _lastAssistantMessage;
     private _lastAutoMemorizeAt;
+    private _confirmResolvers;
     /** Vault expansion redactions by user-message id (frontend + persistence). */
     private _vaultRedactions;
     private _userMessageSeq;
@@ -436,6 +479,13 @@ export declare class AgentSession {
         deliverAs?: "steer" | "followUp";
         expandPromptTemplates?: boolean;
     }): Promise<void>;
+    private _runPromptOptimizer;
+    /** Últimos prompts de usuario (para dar contexto al optimizador). */
+    private _recentUserPrompts;
+    /** Ajusta el modo del optimizador autónomo de prompts. */
+    setPromptOptimizerMode(mode: "off" | "auto" | "clarify"): void;
+    /** Modo actual del optimizador autónomo de prompts. */
+    getPromptOptimizerMode(): "off" | "auto" | "clarify";
     /**
      * Clear all queued messages and return them.
      * Useful for restoring to editor when user aborts.
@@ -460,30 +510,32 @@ export declare class AgentSession {
     private _emitModelSelect;
     /**
      * Set model directly.
-     * Validates that auth is configured, saves to session and settings.
+     * Validates that auth is configured and saves to the session transcript.
+     * Persists to global defaults only when options.persist is true.
      * @throws Error if no auth is configured for the model
      */
-    setModel(model: Model<any>): Promise<void>;
+    setModel(model: Model<any>, options?: ModelMutationOptions): Promise<void>;
     /**
      * Cycle to next/previous model.
      * Uses scoped models (from --models flag) if available, otherwise all available models.
      * @param direction - "forward" (default) or "backward"
      * @returns The new model info, or undefined if only one model available
      */
-    cycleModel(direction?: "forward" | "backward"): Promise<ModelCycleResult | undefined>;
+    cycleModel(direction?: "forward" | "backward", options?: ModelMutationOptions): Promise<ModelCycleResult | undefined>;
     private _cycleScopedModel;
     private _cycleAvailableModel;
     /**
      * Set thinking level.
      * Clamps to model capabilities based on available thinking levels.
-     * Saves to session and settings only if the level actually changes.
+     * Saves the clamped level to the session transcript only if the level actually changes.
+     * Persists the requested level to global defaults only when options.persist is true.
      */
-    setThinkingLevel(level: ThinkingLevel): void;
+    setThinkingLevel(level: ThinkingLevel, options?: ModelMutationOptions): void;
     /**
      * Cycle to next thinking level.
      * @returns New level, or undefined if model doesn't support thinking
      */
-    cycleThinkingLevel(): ThinkingLevel | undefined;
+    cycleThinkingLevel(options?: ModelMutationOptions): ThinkingLevel | undefined;
     /**
      * Get available thinking levels for current model.
      * The provider will clamp to what the specific model supports internally.
@@ -506,9 +558,20 @@ export declare class AgentSession {
      * Saves to settings.
      */
     setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    private _runDefaultCompaction;
     /**
      * Manually compact the session context.
-     * Aborts current agent operation first.
+     *
+     * This is the manual entry point used by `/compact`, RPC, and extensions. It is
+     * separate from automatic threshold/overflow compaction, which enters through
+     * `_checkCompaction()` and `_runAutoCompaction()`. After preparation and the
+     * `session_before_compact` hook, both paths call the lower-level `compact()`
+     * function imported from `./compaction/index.ts`, unless the hook cancels or
+     * supplies a custom result.
+     *
+     * Aborts the current agent operation first. Manual compaction never retries or
+     * continues the interrupted agent turn.
+     *
      * @param customInstructions Optional instructions for the compaction summary
      */
     compact(customInstructions?: string): Promise<CompactionResult>;
@@ -638,6 +701,21 @@ export declare class AgentSession {
      * actually billed across the session.
      */
     getSessionStats(): SessionStats;
+    /**
+     * Desglose de qué llena la ventana de contexto.
+     *
+     * `getContextUsage()` da un único número; esto dice de dónde sale. Con caché
+     * por prefijo eso no es curiosidad: el coste de tocar algo depende de su
+     * posición, así que saber que las definiciones de tools ocupan 11 K y van
+     * delante te dice que cambiarlas invalida todo lo de detrás.
+     *
+     * El total lo aporta el proveedor y es exacto; el reparto se estima. La
+     * distinción viaja en `totalExacto` para que la interfaz no presente
+     * estimaciones como medidas.
+     */
+    getContextBreakdown(): import("./context-breakdown.ts").DesgloseContexto | undefined;
+    /** Tokens de los mensajes del hilo activo, con el mismo estimador que compacta. */
+    private _estimarTokensConversacion;
     getContextUsage(): ContextUsage | undefined;
     /**
      * Export session to HTML.