@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/modes/acp/acp-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-mode.d.ts","sourceRoot":"","sources":["../../../src/modes/acp/acp-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAInF,6EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,iBAAiB,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAwBD,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GAAG,MAAM,CAY7G;AAoBD,mFAAkF;AAClF,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4HvE","sourcesContent":["/**\n * Modo ACP — Ada como agente del Agent Client Protocol.\n *\n * Permite conducir Ada desde cualquier cliente ACP (Zed y compañía) en vez de\n * solo desde nuestro TUI: el editor abre el proceso, habla JSON-RPC por stdio y\n * recibe el streaming del turno.\n *\n * Dos invariantes que no son opcionales:\n *\n * 1. **ACP es el dueño de stdout.** Un solo `console.log` perdido en cualquier\n *    parte del proceso mete texto suelto en medio del stream JSON-RPC y el\n *    cliente se desconecta. Por eso se desvía stdout a stderr antes de abrir la\n *    conexión: los logs siguen siendo visibles, pero fuera del cable.\n *\n * 2. **Una conexión, una sesión.** Un segundo `session/new` se rechaza en vez de\n *    compartir en silencio historial y cwd con el primero, que dejaría eventos\n *    sin poder atribuirse a una sesión concreta.\n *\n * La traducción de eventos vive aparte, en `events.ts`, y se testea sin socket.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { Readable, Writable } from \"node:stream\";\nimport * as acp from \"@agentclientprotocol/sdk\";\nimport type { AgentSession, AgentSessionEvent } from \"../../core/agent-session.ts\";\nimport { killTrackedDetachedChildren } from \"../../utils/shell.ts\";\nimport { type AcpStopReason, stopReasonFor, toAcpUpdates } from \"./events.ts\";\n\n/** Crea la sesión que atenderá la conexión. Inyectable para los tests. */\nexport type AcpSessionFactory = (options: { cwd: string }) => Promise<AgentSession>;\n\nexport interface AcpModeOptions {\n\tcreateSession: AcpSessionFactory;\n\t/** Stream ya montado (tests). Por defecto, stdio del proceso. */\n\tstream?: acp.Stream;\n\t/** Desviar stdout a stderr. Solo se desactiva en tests. */\n\townStdout?: boolean;\n}\n\n/**\n * Desvía `process.stdout` a stderr y devuelve el sink crudo original.\n *\n * Sin esto, cualquier `console.log` del resto del programa —un aviso de\n * actualización, una traza olvidada— se cuela entre dos mensajes JSON-RPC y\n * corrompe el stream. Se desvía en lugar de silenciar para no perder\n * diagnósticos: acaban en stderr, que el cliente ACP no parsea.\n */\nfunction takeOverStdout(): WritableStream<Uint8Array> {\n\tconst write = process.stdout.write.bind(process.stdout);\n\tprocess.stdout.write = ((chunk: string | Uint8Array, ...rest: unknown[]) =>\n\t\t(process.stderr.write as (...args: unknown[]) => boolean)(chunk, ...rest)) as typeof process.stdout.write;\n\treturn Writable.toWeb(\n\t\tnew Writable({\n\t\t\twrite(chunk, _enc, cb) {\n\t\t\t\twrite(chunk);\n\t\t\t\tcb();\n\t\t\t},\n\t\t}),\n\t) as WritableStream<Uint8Array>;\n}\n\n/** Extrae el texto de los bloques de contenido de un prompt ACP. */\nexport function promptText(content: Array<{ type?: string; text?: string; uri?: string }> | undefined): string {\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.map((block) => {\n\t\t\tif (block?.type === \"text\" && typeof block.text === \"string\") return block.text;\n\t\t\t// Un resource_link es una referencia a un fichero: se pasa como ruta\n\t\t\t// para que el agente pueda leerlo con sus propias tools.\n\t\t\tif (block?.type === \"resource_link\" && typeof block.uri === \"string\") return block.uri;\n\t\t\treturn \"\";\n\t\t})\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\");\n}\n\n/**\n * Espera a que el turno se asiente y dice por qué terminó.\n *\n * Se escucha `agent_settled`, no `agent_end`: `agent_end` con `willRetry` no\n * cierra el turno —el agente va a reintentar solo— y anunciar `end_turn` ahí\n * dejaría al cliente creyendo que puede escribir mientras la sesión sigue\n * ocupada.\n */\nfunction settled(session: AgentSession, signal: { aborted: boolean }): Promise<AcpStopReason> {\n\treturn new Promise<AcpStopReason>((resolve) => {\n\t\tconst unsubscribe = session.subscribe((event: AgentSessionEvent) => {\n\t\t\tif (event.type !== \"agent_settled\") return;\n\t\t\tunsubscribe();\n\t\t\tresolve(stopReasonFor({ aborted: signal.aborted }));\n\t\t});\n\t});\n}\n\n/** Arranca el modo ACP. No retorna: el proceso vive mientras dure la conexión. */\nexport async function runAcpMode(options: AcpModeOptions): Promise<void> {\n\tconst stdout = options.ownStdout === false ? undefined : takeOverStdout();\n\tconst stream =\n\t\toptions.stream ??\n\t\tacp.ndJsonStream(\n\t\t\tstdout ?? (Writable.toWeb(process.stdout) as WritableStream<Uint8Array>),\n\t\t\tReadable.toWeb(process.stdin) as ReadableStream<Uint8Array>,\n\t\t);\n\n\tlet session: AgentSession | undefined;\n\tlet sessionId: string | undefined;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet cancelled = false;\n\t/** Reserva síncrona de la única sesión de esta conexión. Ver newSession. */\n\tlet sessionClaimed = false;\n\n\tconst connection = new acp.AgentSideConnection(\n\t\t(conn) => ({\n\t\t\tasync initialize(params: { protocolVersion?: number }) {\n\t\t\t\treturn {\n\t\t\t\t\tprotocolVersion: params?.protocolVersion ?? acp.PROTOCOL_VERSION,\n\t\t\t\t\tagentCapabilities: {\n\t\t\t\t\t\t// `session/load` no está implementado: declararlo y luego fallar\n\t\t\t\t\t\t// es peor que no ofrecerlo.\n\t\t\t\t\t\tloadSession: false,\n\t\t\t\t\t\tpromptCapabilities: { image: false, audio: false, embeddedContext: false },\n\t\t\t\t\t},\n\t\t\t\t\tauthMethods: [],\n\t\t\t\t};\n\t\t\t},\n\n\t\t\tasync authenticate() {\n\t\t\t\t// Las credenciales se configuran fuera del cable (vault, auth.json):\n\t\t\t\t// el cliente ACP no debe manejarlas ni verlas pasar.\n\t\t\t\treturn {};\n\t\t\t},\n\n\t\t\tasync newSession(params: { cwd?: string; mcpServers?: unknown[] }) {\n\t\t\t\t// La reserva se hace ANTES del primer await. Comprobar `session` no\n\t\t\t\t// vale: crear la sesión es asíncrono, así que dos `session/new`\n\t\t\t\t// encadenados —lo normal en un cliente que no espera respuesta antes\n\t\t\t\t// de mandar el siguiente— pasaban los dos la comprobación y acababan\n\t\t\t\t// con dos sesiones sobre una conexión.\n\t\t\t\tif (sessionClaimed) {\n\t\t\t\t\tthrow acp.RequestError.invalidRequest(\n\t\t\t\t\t\t\"Esta conexión ya tiene una sesión. Abre otra conexión para una sesión nueva.\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tsessionClaimed = true;\n\t\t\t\t// El cliente puede proponer servidores MCP para la sesión. No los\n\t\t\t\t// conectamos: los nuestros salen de la configuración del proyecto y\n\t\t\t\t// sus credenciales del Vault, y aceptar un servidor arbitrario por el\n\t\t\t\t// cable saltaría ese control. Se avisa por stderr en vez de callar,\n\t\t\t\t// porque si no el editor esperaría tools que nunca aparecerán.\n\t\t\t\tif (Array.isArray(params?.mcpServers) && params.mcpServers.length > 0) {\n\t\t\t\t\tprocess.stderr.write(\n\t\t\t\t\t\t`[acp] ${params.mcpServers.length} servidor(es) MCP propuestos por el cliente: ignorados. ` +\n\t\t\t\t\t\t\t\"Declara los servidores MCP en la configuración de Ada.\\n\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tsession = await options.createSession({ cwd: params?.cwd ?? process.cwd() });\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Liberar la reserva: si crear la sesión falló, la conexión debe\n\t\t\t\t\t// poder reintentar en vez de quedarse inservible para siempre.\n\t\t\t\t\tsessionClaimed = false;\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tsessionId = randomUUID();\n\t\t\t\tconst id = sessionId;\n\t\t\t\tunsubscribe = session.subscribe((event: AgentSessionEvent) => {\n\t\t\t\t\tfor (const update of toAcpUpdates(event)) {\n\t\t\t\t\t\t// Notificación: si el cliente se cae a mitad de turno no debe\n\t\t\t\t\t\t// tumbar la sesión, solo dejar de recibir.\n\t\t\t\t\t\tvoid conn.sessionUpdate({ sessionId: id, update } as never).catch(() => {});\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\treturn { sessionId: id };\n\t\t\t},\n\n\t\t\tasync prompt(params: { sessionId?: string; prompt?: Array<{ type?: string; text?: string }> }) {\n\t\t\t\tconst active = session;\n\t\t\t\tif (!active || params?.sessionId !== sessionId) {\n\t\t\t\t\tthrow acp.RequestError.invalidParams(\"sessionId desconocido\");\n\t\t\t\t}\n\t\t\t\tconst text = promptText(params.prompt);\n\t\t\t\tif (!text) return { stopReason: \"end_turn\" as AcpStopReason };\n\t\t\t\tcancelled = false;\n\t\t\t\tconst done = settled(active, {\n\t\t\t\t\tget aborted() {\n\t\t\t\t\t\treturn cancelled;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tawait active.prompt(text);\n\t\t\t\treturn { stopReason: await done };\n\t\t\t},\n\n\t\t\tasync cancel(params: { sessionId?: string }) {\n\t\t\t\tif (!session || params?.sessionId !== sessionId) return;\n\t\t\t\tcancelled = true;\n\t\t\t\tawait session.abort();\n\t\t\t},\n\t\t}),\n\t\tstream,\n\t);\n\n\t// El proceso vive mientras la conexión. Se espera a `connection.closed`, del\n\t// propio SDK, no al evento `end` de stdin: `end` salta en cuanto se agota la\n\t// entrada, antes de que el SDK haya despachado los mensajes ya recibidos.\n\t//\n\t// Cuando el cliente cierra la conexión, el transporte se cierra con ella y\n\t// una respuesta que todavía se estuviera calculando ya no tiene a dónde ir.\n\t// No se intenta rescatarla: no hay nadie escuchando. Un cliente ACP real\n\t// mantiene la conexión abierta mientras dure la sesión.\n\tawait connection.closed;\n\tunsubscribe?.();\n\t// Abortar el turno en curso: si el editor se fue, seguir llamando al modelo\n\t// solo gasta dinero para nadie.\n\tawait session?.abort().catch(() => {});\n\t// Igual que print/interactive/rpc al recibir su señal de apagado: una\n\t// sesión de bash_interactivo se lanza `detached` a propósito para\n\t// sobrevivir a un Ctrl-C dentro del turno, así que necesita este kill\n\t// explícito o sobrevive al editor que cerró la conexión.\n\tkillTrackedDetachedChildren();\n}\n"]}

package/dist/modes/acp/acp-mode.js

@@ -0,0 +1,190 @@
+/**
+ * Modo ACP — Ada como agente del Agent Client Protocol.
+ *
+ * Permite conducir Ada desde cualquier cliente ACP (Zed y compañía) en vez de
+ * solo desde nuestro TUI: el editor abre el proceso, habla JSON-RPC por stdio y
+ * recibe el streaming del turno.
+ *
+ * Dos invariantes que no son opcionales:
+ *
+ * 1. **ACP es el dueño de stdout.** Un solo `console.log` perdido en cualquier
+ *    parte del proceso mete texto suelto en medio del stream JSON-RPC y el
+ *    cliente se desconecta. Por eso se desvía stdout a stderr antes de abrir la
+ *    conexión: los logs siguen siendo visibles, pero fuera del cable.
+ *
+ * 2. **Una conexión, una sesión.** Un segundo `session/new` se rechaza en vez de
+ *    compartir en silencio historial y cwd con el primero, que dejaría eventos
+ *    sin poder atribuirse a una sesión concreta.
+ *
+ * La traducción de eventos vive aparte, en `events.ts`, y se testea sin socket.
+ */
+import { randomUUID } from "node:crypto";
+import { Readable, Writable } from "node:stream";
+import * as acp from "@agentclientprotocol/sdk";
+import { killTrackedDetachedChildren } from "../../utils/shell.js";
+import { stopReasonFor, toAcpUpdates } from "./events.js";
+/**
+ * Desvía `process.stdout` a stderr y devuelve el sink crudo original.
+ *
+ * Sin esto, cualquier `console.log` del resto del programa —un aviso de
+ * actualización, una traza olvidada— se cuela entre dos mensajes JSON-RPC y
+ * corrompe el stream. Se desvía en lugar de silenciar para no perder
+ * diagnósticos: acaban en stderr, que el cliente ACP no parsea.
+ */
+function takeOverStdout() {
+    const write = process.stdout.write.bind(process.stdout);
+    process.stdout.write = ((chunk, ...rest) => process.stderr.write(chunk, ...rest));
+    return Writable.toWeb(new Writable({
+        write(chunk, _enc, cb) {
+            write(chunk);
+            cb();
+        },
+    }));
+}
+/** Extrae el texto de los bloques de contenido de un prompt ACP. */
+export function promptText(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((block) => {
+        if (block?.type === "text" && typeof block.text === "string")
+            return block.text;
+        // Un resource_link es una referencia a un fichero: se pasa como ruta
+        // para que el agente pueda leerlo con sus propias tools.
+        if (block?.type === "resource_link" && typeof block.uri === "string")
+            return block.uri;
+        return "";
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+/**
+ * Espera a que el turno se asiente y dice por qué terminó.
+ *
+ * Se escucha `agent_settled`, no `agent_end`: `agent_end` con `willRetry` no
+ * cierra el turno —el agente va a reintentar solo— y anunciar `end_turn` ahí
+ * dejaría al cliente creyendo que puede escribir mientras la sesión sigue
+ * ocupada.
+ */
+function settled(session, signal) {
+    return new Promise((resolve) => {
+        const unsubscribe = session.subscribe((event) => {
+            if (event.type !== "agent_settled")
+                return;
+            unsubscribe();
+            resolve(stopReasonFor({ aborted: signal.aborted }));
+        });
+    });
+}
+/** Arranca el modo ACP. No retorna: el proceso vive mientras dure la conexión. */
+export async function runAcpMode(options) {
+    const stdout = options.ownStdout === false ? undefined : takeOverStdout();
+    const stream = options.stream ??
+        acp.ndJsonStream(stdout ?? Writable.toWeb(process.stdout), Readable.toWeb(process.stdin));
+    let session;
+    let sessionId;
+    let unsubscribe;
+    let cancelled = false;
+    /** Reserva síncrona de la única sesión de esta conexión. Ver newSession. */
+    let sessionClaimed = false;
+    const connection = new acp.AgentSideConnection((conn) => ({
+        async initialize(params) {
+            return {
+                protocolVersion: params?.protocolVersion ?? acp.PROTOCOL_VERSION,
+                agentCapabilities: {
+                    // `session/load` no está implementado: declararlo y luego fallar
+                    // es peor que no ofrecerlo.
+                    loadSession: false,
+                    promptCapabilities: { image: false, audio: false, embeddedContext: false },
+                },
+                authMethods: [],
+            };
+        },
+        async authenticate() {
+            // Las credenciales se configuran fuera del cable (vault, auth.json):
+            // el cliente ACP no debe manejarlas ni verlas pasar.
+            return {};
+        },
+        async newSession(params) {
+            // La reserva se hace ANTES del primer await. Comprobar `session` no
+            // vale: crear la sesión es asíncrono, así que dos `session/new`
+            // encadenados —lo normal en un cliente que no espera respuesta antes
+            // de mandar el siguiente— pasaban los dos la comprobación y acababan
+            // con dos sesiones sobre una conexión.
+            if (sessionClaimed) {
+                throw acp.RequestError.invalidRequest("Esta conexión ya tiene una sesión. Abre otra conexión para una sesión nueva.");
+            }
+            sessionClaimed = true;
+            // El cliente puede proponer servidores MCP para la sesión. No los
+            // conectamos: los nuestros salen de la configuración del proyecto y
+            // sus credenciales del Vault, y aceptar un servidor arbitrario por el
+            // cable saltaría ese control. Se avisa por stderr en vez de callar,
+            // porque si no el editor esperaría tools que nunca aparecerán.
+            if (Array.isArray(params?.mcpServers) && params.mcpServers.length > 0) {
+                process.stderr.write(`[acp] ${params.mcpServers.length} servidor(es) MCP propuestos por el cliente: ignorados. ` +
+                    "Declara los servidores MCP en la configuración de Ada.\n");
+            }
+            try {
+                session = await options.createSession({ cwd: params?.cwd ?? process.cwd() });
+            }
+            catch (error) {
+                // Liberar la reserva: si crear la sesión falló, la conexión debe
+                // poder reintentar en vez de quedarse inservible para siempre.
+                sessionClaimed = false;
+                throw error;
+            }
+            sessionId = randomUUID();
+            const id = sessionId;
+            unsubscribe = session.subscribe((event) => {
+                for (const update of toAcpUpdates(event)) {
+                    // Notificación: si el cliente se cae a mitad de turno no debe
+                    // tumbar la sesión, solo dejar de recibir.
+                    void conn.sessionUpdate({ sessionId: id, update }).catch(() => { });
+                }
+            });
+            return { sessionId: id };
+        },
+        async prompt(params) {
+            const active = session;
+            if (!active || params?.sessionId !== sessionId) {
+                throw acp.RequestError.invalidParams("sessionId desconocido");
+            }
+            const text = promptText(params.prompt);
+            if (!text)
+                return { stopReason: "end_turn" };
+            cancelled = false;
+            const done = settled(active, {
+                get aborted() {
+                    return cancelled;
+                },
+            });
+            await active.prompt(text);
+            return { stopReason: await done };
+        },
+        async cancel(params) {
+            if (!session || params?.sessionId !== sessionId)
+                return;
+            cancelled = true;
+            await session.abort();
+        },
+    }), stream);
+    // El proceso vive mientras la conexión. Se espera a `connection.closed`, del
+    // propio SDK, no al evento `end` de stdin: `end` salta en cuanto se agota la
+    // entrada, antes de que el SDK haya despachado los mensajes ya recibidos.
+    //
+    // Cuando el cliente cierra la conexión, el transporte se cierra con ella y
+    // una respuesta que todavía se estuviera calculando ya no tiene a dónde ir.
+    // No se intenta rescatarla: no hay nadie escuchando. Un cliente ACP real
+    // mantiene la conexión abierta mientras dure la sesión.
+    await connection.closed;
+    unsubscribe?.();
+    // Abortar el turno en curso: si el editor se fue, seguir llamando al modelo
+    // solo gasta dinero para nadie.
+    await session?.abort().catch(() => { });
+    // Igual que print/interactive/rpc al recibir su señal de apagado: una
+    // sesión de bash_interactivo se lanza `detached` a propósito para
+    // sobrevivir a un Ctrl-C dentro del turno, así que necesita este kill
+    // explícito o sobrevive al editor que cerró la conexión.
+    killTrackedDetachedChildren();
+}
+//# sourceMappingURL=acp-mode.js.map

package/dist/modes/acp/acp-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-mode.js","sourceRoot":"","sources":["../../../src/modes/acp/acp-mode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Modo ACP — Ada como agente del Agent Client Protocol.\n *\n * Permite conducir Ada desde cualquier cliente ACP (Zed y compañía) en vez de\n * solo desde nuestro TUI: el editor abre el proceso, habla JSON-RPC por stdio y\n * recibe el streaming del turno.\n *\n * Dos invariantes que no son opcionales:\n *\n * 1. **ACP es el dueño de stdout.** Un solo `console.log` perdido en cualquier\n *    parte del proceso mete texto suelto en medio del stream JSON-RPC y el\n *    cliente se desconecta. Por eso se desvía stdout a stderr antes de abrir la\n *    conexión: los logs siguen siendo visibles, pero fuera del cable.\n *\n * 2. **Una conexión, una sesión.** Un segundo `session/new` se rechaza en vez de\n *    compartir en silencio historial y cwd con el primero, que dejaría eventos\n *    sin poder atribuirse a una sesión concreta.\n *\n * La traducción de eventos vive aparte, en `events.ts`, y se testea sin socket.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { Readable, Writable } from \"node:stream\";\nimport * as acp from \"@agentclientprotocol/sdk\";\nimport type { AgentSession, AgentSessionEvent } from \"../../core/agent-session.ts\";\nimport { killTrackedDetachedChildren } from \"../../utils/shell.ts\";\nimport { type AcpStopReason, stopReasonFor, toAcpUpdates } from \"./events.ts\";\n\n/** Crea la sesión que atenderá la conexión. Inyectable para los tests. */\nexport type AcpSessionFactory = (options: { cwd: string }) => Promise<AgentSession>;\n\nexport interface AcpModeOptions {\n\tcreateSession: AcpSessionFactory;\n\t/** Stream ya montado (tests). Por defecto, stdio del proceso. */\n\tstream?: acp.Stream;\n\t/** Desviar stdout a stderr. Solo se desactiva en tests. */\n\townStdout?: boolean;\n}\n\n/**\n * Desvía `process.stdout` a stderr y devuelve el sink crudo original.\n *\n * Sin esto, cualquier `console.log` del resto del programa —un aviso de\n * actualización, una traza olvidada— se cuela entre dos mensajes JSON-RPC y\n * corrompe el stream. Se desvía en lugar de silenciar para no perder\n * diagnósticos: acaban en stderr, que el cliente ACP no parsea.\n */\nfunction takeOverStdout(): WritableStream<Uint8Array> {\n\tconst write = process.stdout.write.bind(process.stdout);\n\tprocess.stdout.write = ((chunk: string | Uint8Array, ...rest: unknown[]) =>\n\t\t(process.stderr.write as (...args: unknown[]) => boolean)(chunk, ...rest)) as typeof process.stdout.write;\n\treturn Writable.toWeb(\n\t\tnew Writable({\n\t\t\twrite(chunk, _enc, cb) {\n\t\t\t\twrite(chunk);\n\t\t\t\tcb();\n\t\t\t},\n\t\t}),\n\t) as WritableStream<Uint8Array>;\n}\n\n/** Extrae el texto de los bloques de contenido de un prompt ACP. */\nexport function promptText(content: Array<{ type?: string; text?: string; uri?: string }> | undefined): string {\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.map((block) => {\n\t\t\tif (block?.type === \"text\" && typeof block.text === \"string\") return block.text;\n\t\t\t// Un resource_link es una referencia a un fichero: se pasa como ruta\n\t\t\t// para que el agente pueda leerlo con sus propias tools.\n\t\t\tif (block?.type === \"resource_link\" && typeof block.uri === \"string\") return block.uri;\n\t\t\treturn \"\";\n\t\t})\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\");\n}\n\n/**\n * Espera a que el turno se asiente y dice por qué terminó.\n *\n * Se escucha `agent_settled`, no `agent_end`: `agent_end` con `willRetry` no\n * cierra el turno —el agente va a reintentar solo— y anunciar `end_turn` ahí\n * dejaría al cliente creyendo que puede escribir mientras la sesión sigue\n * ocupada.\n */\nfunction settled(session: AgentSession, signal: { aborted: boolean }): Promise<AcpStopReason> {\n\treturn new Promise<AcpStopReason>((resolve) => {\n\t\tconst unsubscribe = session.subscribe((event: AgentSessionEvent) => {\n\t\t\tif (event.type !== \"agent_settled\") return;\n\t\t\tunsubscribe();\n\t\t\tresolve(stopReasonFor({ aborted: signal.aborted }));\n\t\t});\n\t});\n}\n\n/** Arranca el modo ACP. No retorna: el proceso vive mientras dure la conexión. */\nexport async function runAcpMode(options: AcpModeOptions): Promise<void> {\n\tconst stdout = options.ownStdout === false ? undefined : takeOverStdout();\n\tconst stream =\n\t\toptions.stream ??\n\t\tacp.ndJsonStream(\n\t\t\tstdout ?? (Writable.toWeb(process.stdout) as WritableStream<Uint8Array>),\n\t\t\tReadable.toWeb(process.stdin) as ReadableStream<Uint8Array>,\n\t\t);\n\n\tlet session: AgentSession | undefined;\n\tlet sessionId: string | undefined;\n\tlet unsubscribe: (() => void) | undefined;\n\tlet cancelled = false;\n\t/** Reserva síncrona de la única sesión de esta conexión. Ver newSession. */\n\tlet sessionClaimed = false;\n\n\tconst connection = new acp.AgentSideConnection(\n\t\t(conn) => ({\n\t\t\tasync initialize(params: { protocolVersion?: number }) {\n\t\t\t\treturn {\n\t\t\t\t\tprotocolVersion: params?.protocolVersion ?? acp.PROTOCOL_VERSION,\n\t\t\t\t\tagentCapabilities: {\n\t\t\t\t\t\t// `session/load` no está implementado: declararlo y luego fallar\n\t\t\t\t\t\t// es peor que no ofrecerlo.\n\t\t\t\t\t\tloadSession: false,\n\t\t\t\t\t\tpromptCapabilities: { image: false, audio: false, embeddedContext: false },\n\t\t\t\t\t},\n\t\t\t\t\tauthMethods: [],\n\t\t\t\t};\n\t\t\t},\n\n\t\t\tasync authenticate() {\n\t\t\t\t// Las credenciales se configuran fuera del cable (vault, auth.json):\n\t\t\t\t// el cliente ACP no debe manejarlas ni verlas pasar.\n\t\t\t\treturn {};\n\t\t\t},\n\n\t\t\tasync newSession(params: { cwd?: string; mcpServers?: unknown[] }) {\n\t\t\t\t// La reserva se hace ANTES del primer await. Comprobar `session` no\n\t\t\t\t// vale: crear la sesión es asíncrono, así que dos `session/new`\n\t\t\t\t// encadenados —lo normal en un cliente que no espera respuesta antes\n\t\t\t\t// de mandar el siguiente— pasaban los dos la comprobación y acababan\n\t\t\t\t// con dos sesiones sobre una conexión.\n\t\t\t\tif (sessionClaimed) {\n\t\t\t\t\tthrow acp.RequestError.invalidRequest(\n\t\t\t\t\t\t\"Esta conexión ya tiene una sesión. Abre otra conexión para una sesión nueva.\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tsessionClaimed = true;\n\t\t\t\t// El cliente puede proponer servidores MCP para la sesión. No los\n\t\t\t\t// conectamos: los nuestros salen de la configuración del proyecto y\n\t\t\t\t// sus credenciales del Vault, y aceptar un servidor arbitrario por el\n\t\t\t\t// cable saltaría ese control. Se avisa por stderr en vez de callar,\n\t\t\t\t// porque si no el editor esperaría tools que nunca aparecerán.\n\t\t\t\tif (Array.isArray(params?.mcpServers) && params.mcpServers.length > 0) {\n\t\t\t\t\tprocess.stderr.write(\n\t\t\t\t\t\t`[acp] ${params.mcpServers.length} servidor(es) MCP propuestos por el cliente: ignorados. ` +\n\t\t\t\t\t\t\t\"Declara los servidores MCP en la configuración de Ada.\\n\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tsession = await options.createSession({ cwd: params?.cwd ?? process.cwd() });\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Liberar la reserva: si crear la sesión falló, la conexión debe\n\t\t\t\t\t// poder reintentar en vez de quedarse inservible para siempre.\n\t\t\t\t\tsessionClaimed = false;\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\tsessionId = randomUUID();\n\t\t\t\tconst id = sessionId;\n\t\t\t\tunsubscribe = session.subscribe((event: AgentSessionEvent) => {\n\t\t\t\t\tfor (const update of toAcpUpdates(event)) {\n\t\t\t\t\t\t// Notificación: si el cliente se cae a mitad de turno no debe\n\t\t\t\t\t\t// tumbar la sesión, solo dejar de recibir.\n\t\t\t\t\t\tvoid conn.sessionUpdate({ sessionId: id, update } as never).catch(() => {});\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\treturn { sessionId: id };\n\t\t\t},\n\n\t\t\tasync prompt(params: { sessionId?: string; prompt?: Array<{ type?: string; text?: string }> }) {\n\t\t\t\tconst active = session;\n\t\t\t\tif (!active || params?.sessionId !== sessionId) {\n\t\t\t\t\tthrow acp.RequestError.invalidParams(\"sessionId desconocido\");\n\t\t\t\t}\n\t\t\t\tconst text = promptText(params.prompt);\n\t\t\t\tif (!text) return { stopReason: \"end_turn\" as AcpStopReason };\n\t\t\t\tcancelled = false;\n\t\t\t\tconst done = settled(active, {\n\t\t\t\t\tget aborted() {\n\t\t\t\t\t\treturn cancelled;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tawait active.prompt(text);\n\t\t\t\treturn { stopReason: await done };\n\t\t\t},\n\n\t\t\tasync cancel(params: { sessionId?: string }) {\n\t\t\t\tif (!session || params?.sessionId !== sessionId) return;\n\t\t\t\tcancelled = true;\n\t\t\t\tawait session.abort();\n\t\t\t},\n\t\t}),\n\t\tstream,\n\t);\n\n\t// El proceso vive mientras la conexión. Se espera a `connection.closed`, del\n\t// propio SDK, no al evento `end` de stdin: `end` salta en cuanto se agota la\n\t// entrada, antes de que el SDK haya despachado los mensajes ya recibidos.\n\t//\n\t// Cuando el cliente cierra la conexión, el transporte se cierra con ella y\n\t// una respuesta que todavía se estuviera calculando ya no tiene a dónde ir.\n\t// No se intenta rescatarla: no hay nadie escuchando. Un cliente ACP real\n\t// mantiene la conexión abierta mientras dure la sesión.\n\tawait connection.closed;\n\tunsubscribe?.();\n\t// Abortar el turno en curso: si el editor se fue, seguir llamando al modelo\n\t// solo gasta dinero para nadie.\n\tawait session?.abort().catch(() => {});\n\t// Igual que print/interactive/rpc al recibir su señal de apagado: una\n\t// sesión de bash_interactivo se lanza `detached` a propósito para\n\t// sobrevivir a un Ctrl-C dentro del turno, así que necesita este kill\n\t// explícito o sobrevive al editor que cerró la conexión.\n\tkillTrackedDetachedChildren();\n}\n"]}

package/dist/modes/acp/events.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Traducción de eventos de `AgentSession` a notificaciones `session/update` de ACP.
+ *
+ * Se mantiene PURA y aparte del transporte a propósito: es la parte con lógica
+ * real (qué es un delta de texto, qué es pensamiento, cuándo una tool pasa a
+ * fallida) y así se puede testear entera sin abrir un socket ni arrancar una
+ * sesión. El fichero de al lado solo mueve bytes.
+ *
+ * Ver https://agentclientprotocol.com/protocol/overview
+ */
+import type { AgentSessionEvent } from "../../core/agent-session.ts";
+/**
+ * Los tipos del schema no se reexportan desde la raíz del SDK, así que se
+ * declara aquí la unión ESTRECHA de lo que realmente emitimos. Sale mejor que
+ * importar la unión entera: el contrato de este módulo queda legible, y el SDK
+ * la sigue validando estructuralmente en la frontera (ver acp-mode.ts).
+ */
+export type AcpToolKind = "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "other";
+export type AcpToolCallStatus = "pending" | "in_progress" | "completed" | "failed";
+export type AcpContentBlock = {
+    type: "text";
+    text: string;
+};
+export type AcpToolCallContent = {
+    type: "content";
+    content: AcpContentBlock;
+};
+export type AcpStopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
+export type AcpSessionUpdate = {
+    sessionUpdate: "agent_message_chunk";
+    content: AcpContentBlock;
+} | {
+    sessionUpdate: "agent_thought_chunk";
+    content: AcpContentBlock;
+} | {
+    sessionUpdate: "tool_call";
+    toolCallId: string;
+    title: string;
+    kind: AcpToolKind;
+    status: AcpToolCallStatus;
+    rawInput?: Record<string, unknown>;
+} | {
+    sessionUpdate: "tool_call_update";
+    toolCallId: string;
+    status: AcpToolCallStatus;
+    content: AcpToolCallContent[];
+};
+/**
+ * Clasifica una tool para que el cliente pinte el icono correcto.
+ *
+ * ACP usa esto solo para presentación, así que ante la duda `other` es una
+ * respuesta honesta: mejor un icono genérico que insinuar que algo escribe
+ * cuando solo lee.
+ */
+export declare function toolKindFor(toolName: string): AcpToolKind;
+/**
+ * Traduce un evento de sesión a cero o más `session/update`.
+ *
+ * Devuelve una lista, no un único update, porque la relación no es 1:1: la
+ * mayoría de eventos internos no tienen nada que decirle al cliente y se
+ * traducen a lista vacía.
+ */
+export declare function toAcpUpdates(event: AgentSessionEvent): AcpSessionUpdate[];
+/**
+ * Por qué terminó el turno, en el vocabulario de ACP.
+ *
+ * `agent_end` con `willRetry` NO cierra el turno: el agente va a reintentar
+ * solo, y anunciar `end_turn` dejaría al cliente creyendo que puede escribir
+ * mientras la sesión sigue ocupada.
+ */
+export declare function stopReasonFor(options: {
+    aborted: boolean;
+}): AcpStopReason;
+//# sourceMappingURL=events.d.ts.map

package/dist/modes/acp/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/modes/acp/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AACnH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AACnF,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,mBAAmB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtG,MAAM,MAAM,gBAAgB,GACzB;IAAE,aAAa,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAClE;IAAE,aAAa,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAClE;IACA,aAAa,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GACD;IACA,aAAa,EAAE,kBAAkB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC7B,CAAC;AAEL;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAmBzD;AAyBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,CA2CzE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAE1E","sourcesContent":["/**\n * Traducción de eventos de `AgentSession` a notificaciones `session/update` de ACP.\n *\n * Se mantiene PURA y aparte del transporte a propósito: es la parte con lógica\n * real (qué es un delta de texto, qué es pensamiento, cuándo una tool pasa a\n * fallida) y así se puede testear entera sin abrir un socket ni arrancar una\n * sesión. El fichero de al lado solo mueve bytes.\n *\n * Ver https://agentclientprotocol.com/protocol/overview\n */\n\nimport type { AgentSessionEvent } from \"../../core/agent-session.ts\";\n\n/**\n * Los tipos del schema no se reexportan desde la raíz del SDK, así que se\n * declara aquí la unión ESTRECHA de lo que realmente emitimos. Sale mejor que\n * importar la unión entera: el contrato de este módulo queda legible, y el SDK\n * la sigue validando estructuralmente en la frontera (ver acp-mode.ts).\n */\nexport type AcpToolKind = \"read\" | \"edit\" | \"delete\" | \"move\" | \"search\" | \"execute\" | \"think\" | \"fetch\" | \"other\";\nexport type AcpToolCallStatus = \"pending\" | \"in_progress\" | \"completed\" | \"failed\";\nexport type AcpContentBlock = { type: \"text\"; text: string };\nexport type AcpToolCallContent = { type: \"content\"; content: AcpContentBlock };\nexport type AcpStopReason = \"end_turn\" | \"max_tokens\" | \"max_turn_requests\" | \"refusal\" | \"cancelled\";\n\nexport type AcpSessionUpdate =\n\t| { sessionUpdate: \"agent_message_chunk\"; content: AcpContentBlock }\n\t| { sessionUpdate: \"agent_thought_chunk\"; content: AcpContentBlock }\n\t| {\n\t\t\tsessionUpdate: \"tool_call\";\n\t\t\ttoolCallId: string;\n\t\t\ttitle: string;\n\t\t\tkind: AcpToolKind;\n\t\t\tstatus: AcpToolCallStatus;\n\t\t\trawInput?: Record<string, unknown>;\n\t  }\n\t| {\n\t\t\tsessionUpdate: \"tool_call_update\";\n\t\t\ttoolCallId: string;\n\t\t\tstatus: AcpToolCallStatus;\n\t\t\tcontent: AcpToolCallContent[];\n\t  };\n\n/**\n * Clasifica una tool para que el cliente pinte el icono correcto.\n *\n * ACP usa esto solo para presentación, así que ante la duda `other` es una\n * respuesta honesta: mejor un icono genérico que insinuar que algo escribe\n * cuando solo lee.\n */\nexport function toolKindFor(toolName: string): AcpToolKind {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\tcase \"ls\":\n\t\t\treturn \"read\";\n\t\tcase \"grep\":\n\t\tcase \"find\":\n\t\t\treturn \"search\";\n\t\tcase \"edit\":\n\t\tcase \"write\":\n\t\t\treturn \"edit\";\n\t\tcase \"bash\":\n\t\t\treturn \"execute\";\n\t\tcase \"web_search\":\n\t\tcase \"web_fetch\":\n\t\t\treturn \"fetch\";\n\t\tdefault:\n\t\t\treturn \"other\";\n\t}\n}\n\n/** Texto plano como bloque de contenido ACP. */\nfunction text(value: string): AcpContentBlock {\n\treturn { type: \"text\", text: value };\n}\n\n/**\n * Resultado de una tool como contenido mostrable.\n *\n * El resultado de una tool nuestra es `AgentToolResult`, con `content` ya en\n * bloques compatibles con MCP. Se filtra a texto porque es lo único que todo\n * cliente ACP sabe pintar; un cliente que no entienda una imagen no debe\n * quedarse sin ver que la tool terminó.\n */\nfunction toolResultContent(result: unknown): AcpToolCallContent[] {\n\tconst blocks = (result as { content?: Array<{ type?: string; text?: string }> } | undefined)?.content;\n\tif (!Array.isArray(blocks)) return [];\n\treturn blocks\n\t\t.filter(\n\t\t\t(block): block is { type: \"text\"; text: string } => block?.type === \"text\" && typeof block.text === \"string\",\n\t\t)\n\t\t.map((block) => ({ type: \"content\", content: text(block.text) }));\n}\n\n/**\n * Traduce un evento de sesión a cero o más `session/update`.\n *\n * Devuelve una lista, no un único update, porque la relación no es 1:1: la\n * mayoría de eventos internos no tienen nada que decirle al cliente y se\n * traducen a lista vacía.\n */\nexport function toAcpUpdates(event: AgentSessionEvent): AcpSessionUpdate[] {\n\tswitch (event.type) {\n\t\tcase \"message_update\": {\n\t\t\tconst inner = event.assistantMessageEvent;\n\t\t\t// Solo los deltas: `partial` trae el mensaje acumulado entero, y\n\t\t\t// reenviarlo en cada token haría que el cliente pintara el texto\n\t\t\t// duplicándose a cada paso.\n\t\t\tif (inner.type === \"text_delta\") {\n\t\t\t\treturn inner.delta ? [{ sessionUpdate: \"agent_message_chunk\", content: text(inner.delta) }] : [];\n\t\t\t}\n\t\t\tif (inner.type === \"thinking_delta\") {\n\t\t\t\treturn inner.delta ? [{ sessionUpdate: \"agent_thought_chunk\", content: text(inner.delta) }] : [];\n\t\t\t}\n\t\t\treturn [];\n\t\t}\n\n\t\tcase \"tool_execution_start\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tsessionUpdate: \"tool_call\",\n\t\t\t\t\ttoolCallId: event.toolCallId,\n\t\t\t\t\ttitle: event.toolName,\n\t\t\t\t\tkind: toolKindFor(event.toolName),\n\t\t\t\t\tstatus: \"in_progress\",\n\t\t\t\t\trawInput: event.args as Record<string, unknown>,\n\t\t\t\t},\n\t\t\t];\n\n\t\tcase \"tool_execution_end\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tsessionUpdate: \"tool_call_update\",\n\t\t\t\t\ttoolCallId: event.toolCallId,\n\t\t\t\t\t// `isError` viene del resultado de la tool, no de una excepción: una\n\t\t\t\t\t// tool puede fallar limpiamente y el cliente debe verlo en rojo.\n\t\t\t\t\tstatus: event.isError ? \"failed\" : \"completed\",\n\t\t\t\t\tcontent: toolResultContent(event.result),\n\t\t\t\t},\n\t\t\t];\n\n\t\tdefault:\n\t\t\treturn [];\n\t}\n}\n\n/**\n * Por qué terminó el turno, en el vocabulario de ACP.\n *\n * `agent_end` con `willRetry` NO cierra el turno: el agente va a reintentar\n * solo, y anunciar `end_turn` dejaría al cliente creyendo que puede escribir\n * mientras la sesión sigue ocupada.\n */\nexport function stopReasonFor(options: { aborted: boolean }): AcpStopReason {\n\treturn options.aborted ? \"cancelled\" : \"end_turn\";\n}\n"]}

package/dist/modes/acp/events.js

@@ -0,0 +1,116 @@
+/**
+ * Traducción de eventos de `AgentSession` a notificaciones `session/update` de ACP.
+ *
+ * Se mantiene PURA y aparte del transporte a propósito: es la parte con lógica
+ * real (qué es un delta de texto, qué es pensamiento, cuándo una tool pasa a
+ * fallida) y así se puede testear entera sin abrir un socket ni arrancar una
+ * sesión. El fichero de al lado solo mueve bytes.
+ *
+ * Ver https://agentclientprotocol.com/protocol/overview
+ */
+/**
+ * Clasifica una tool para que el cliente pinte el icono correcto.
+ *
+ * ACP usa esto solo para presentación, así que ante la duda `other` es una
+ * respuesta honesta: mejor un icono genérico que insinuar que algo escribe
+ * cuando solo lee.
+ */
+export function toolKindFor(toolName) {
+    switch (toolName) {
+        case "read":
+        case "ls":
+            return "read";
+        case "grep":
+        case "find":
+            return "search";
+        case "edit":
+        case "write":
+            return "edit";
+        case "bash":
+            return "execute";
+        case "web_search":
+        case "web_fetch":
+            return "fetch";
+        default:
+            return "other";
+    }
+}
+/** Texto plano como bloque de contenido ACP. */
+function text(value) {
+    return { type: "text", text: value };
+}
+/**
+ * Resultado de una tool como contenido mostrable.
+ *
+ * El resultado de una tool nuestra es `AgentToolResult`, con `content` ya en
+ * bloques compatibles con MCP. Se filtra a texto porque es lo único que todo
+ * cliente ACP sabe pintar; un cliente que no entienda una imagen no debe
+ * quedarse sin ver que la tool terminó.
+ */
+function toolResultContent(result) {
+    const blocks = result?.content;
+    if (!Array.isArray(blocks))
+        return [];
+    return blocks
+        .filter((block) => block?.type === "text" && typeof block.text === "string")
+        .map((block) => ({ type: "content", content: text(block.text) }));
+}
+/**
+ * Traduce un evento de sesión a cero o más `session/update`.
+ *
+ * Devuelve una lista, no un único update, porque la relación no es 1:1: la
+ * mayoría de eventos internos no tienen nada que decirle al cliente y se
+ * traducen a lista vacía.
+ */
+export function toAcpUpdates(event) {
+    switch (event.type) {
+        case "message_update": {
+            const inner = event.assistantMessageEvent;
+            // Solo los deltas: `partial` trae el mensaje acumulado entero, y
+            // reenviarlo en cada token haría que el cliente pintara el texto
+            // duplicándose a cada paso.
+            if (inner.type === "text_delta") {
+                return inner.delta ? [{ sessionUpdate: "agent_message_chunk", content: text(inner.delta) }] : [];
+            }
+            if (inner.type === "thinking_delta") {
+                return inner.delta ? [{ sessionUpdate: "agent_thought_chunk", content: text(inner.delta) }] : [];
+            }
+            return [];
+        }
+        case "tool_execution_start":
+            return [
+                {
+                    sessionUpdate: "tool_call",
+                    toolCallId: event.toolCallId,
+                    title: event.toolName,
+                    kind: toolKindFor(event.toolName),
+                    status: "in_progress",
+                    rawInput: event.args,
+                },
+            ];
+        case "tool_execution_end":
+            return [
+                {
+                    sessionUpdate: "tool_call_update",
+                    toolCallId: event.toolCallId,
+                    // `isError` viene del resultado de la tool, no de una excepción: una
+                    // tool puede fallar limpiamente y el cliente debe verlo en rojo.
+                    status: event.isError ? "failed" : "completed",
+                    content: toolResultContent(event.result),
+                },
+            ];
+        default:
+            return [];
+    }
+}
+/**
+ * Por qué terminó el turno, en el vocabulario de ACP.
+ *
+ * `agent_end` con `willRetry` NO cierra el turno: el agente va a reintentar
+ * solo, y anunciar `end_turn` dejaría al cliente creyendo que puede escribir
+ * mientras la sesión sigue ocupada.
+ */
+export function stopReasonFor(options) {
+    return options.aborted ? "cancelled" : "end_turn";
+}
+//# sourceMappingURL=events.js.map

package/dist/modes/acp/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/modes/acp/events.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Traducción de eventos de `AgentSession` a notificaciones `session/update` de ACP.\n *\n * Se mantiene PURA y aparte del transporte a propósito: es la parte con lógica\n * real (qué es un delta de texto, qué es pensamiento, cuándo una tool pasa a\n * fallida) y así se puede testear entera sin abrir un socket ni arrancar una\n * sesión. El fichero de al lado solo mueve bytes.\n *\n * Ver https://agentclientprotocol.com/protocol/overview\n */\n\nimport type { AgentSessionEvent } from \"../../core/agent-session.ts\";\n\n/**\n * Los tipos del schema no se reexportan desde la raíz del SDK, así que se\n * declara aquí la unión ESTRECHA de lo que realmente emitimos. Sale mejor que\n * importar la unión entera: el contrato de este módulo queda legible, y el SDK\n * la sigue validando estructuralmente en la frontera (ver acp-mode.ts).\n */\nexport type AcpToolKind = \"read\" | \"edit\" | \"delete\" | \"move\" | \"search\" | \"execute\" | \"think\" | \"fetch\" | \"other\";\nexport type AcpToolCallStatus = \"pending\" | \"in_progress\" | \"completed\" | \"failed\";\nexport type AcpContentBlock = { type: \"text\"; text: string };\nexport type AcpToolCallContent = { type: \"content\"; content: AcpContentBlock };\nexport type AcpStopReason = \"end_turn\" | \"max_tokens\" | \"max_turn_requests\" | \"refusal\" | \"cancelled\";\n\nexport type AcpSessionUpdate =\n\t| { sessionUpdate: \"agent_message_chunk\"; content: AcpContentBlock }\n\t| { sessionUpdate: \"agent_thought_chunk\"; content: AcpContentBlock }\n\t| {\n\t\t\tsessionUpdate: \"tool_call\";\n\t\t\ttoolCallId: string;\n\t\t\ttitle: string;\n\t\t\tkind: AcpToolKind;\n\t\t\tstatus: AcpToolCallStatus;\n\t\t\trawInput?: Record<string, unknown>;\n\t  }\n\t| {\n\t\t\tsessionUpdate: \"tool_call_update\";\n\t\t\ttoolCallId: string;\n\t\t\tstatus: AcpToolCallStatus;\n\t\t\tcontent: AcpToolCallContent[];\n\t  };\n\n/**\n * Clasifica una tool para que el cliente pinte el icono correcto.\n *\n * ACP usa esto solo para presentación, así que ante la duda `other` es una\n * respuesta honesta: mejor un icono genérico que insinuar que algo escribe\n * cuando solo lee.\n */\nexport function toolKindFor(toolName: string): AcpToolKind {\n\tswitch (toolName) {\n\t\tcase \"read\":\n\t\tcase \"ls\":\n\t\t\treturn \"read\";\n\t\tcase \"grep\":\n\t\tcase \"find\":\n\t\t\treturn \"search\";\n\t\tcase \"edit\":\n\t\tcase \"write\":\n\t\t\treturn \"edit\";\n\t\tcase \"bash\":\n\t\t\treturn \"execute\";\n\t\tcase \"web_search\":\n\t\tcase \"web_fetch\":\n\t\t\treturn \"fetch\";\n\t\tdefault:\n\t\t\treturn \"other\";\n\t}\n}\n\n/** Texto plano como bloque de contenido ACP. */\nfunction text(value: string): AcpContentBlock {\n\treturn { type: \"text\", text: value };\n}\n\n/**\n * Resultado de una tool como contenido mostrable.\n *\n * El resultado de una tool nuestra es `AgentToolResult`, con `content` ya en\n * bloques compatibles con MCP. Se filtra a texto porque es lo único que todo\n * cliente ACP sabe pintar; un cliente que no entienda una imagen no debe\n * quedarse sin ver que la tool terminó.\n */\nfunction toolResultContent(result: unknown): AcpToolCallContent[] {\n\tconst blocks = (result as { content?: Array<{ type?: string; text?: string }> } | undefined)?.content;\n\tif (!Array.isArray(blocks)) return [];\n\treturn blocks\n\t\t.filter(\n\t\t\t(block): block is { type: \"text\"; text: string } => block?.type === \"text\" && typeof block.text === \"string\",\n\t\t)\n\t\t.map((block) => ({ type: \"content\", content: text(block.text) }));\n}\n\n/**\n * Traduce un evento de sesión a cero o más `session/update`.\n *\n * Devuelve una lista, no un único update, porque la relación no es 1:1: la\n * mayoría de eventos internos no tienen nada que decirle al cliente y se\n * traducen a lista vacía.\n */\nexport function toAcpUpdates(event: AgentSessionEvent): AcpSessionUpdate[] {\n\tswitch (event.type) {\n\t\tcase \"message_update\": {\n\t\t\tconst inner = event.assistantMessageEvent;\n\t\t\t// Solo los deltas: `partial` trae el mensaje acumulado entero, y\n\t\t\t// reenviarlo en cada token haría que el cliente pintara el texto\n\t\t\t// duplicándose a cada paso.\n\t\t\tif (inner.type === \"text_delta\") {\n\t\t\t\treturn inner.delta ? [{ sessionUpdate: \"agent_message_chunk\", content: text(inner.delta) }] : [];\n\t\t\t}\n\t\t\tif (inner.type === \"thinking_delta\") {\n\t\t\t\treturn inner.delta ? [{ sessionUpdate: \"agent_thought_chunk\", content: text(inner.delta) }] : [];\n\t\t\t}\n\t\t\treturn [];\n\t\t}\n\n\t\tcase \"tool_execution_start\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tsessionUpdate: \"tool_call\",\n\t\t\t\t\ttoolCallId: event.toolCallId,\n\t\t\t\t\ttitle: event.toolName,\n\t\t\t\t\tkind: toolKindFor(event.toolName),\n\t\t\t\t\tstatus: \"in_progress\",\n\t\t\t\t\trawInput: event.args as Record<string, unknown>,\n\t\t\t\t},\n\t\t\t];\n\n\t\tcase \"tool_execution_end\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tsessionUpdate: \"tool_call_update\",\n\t\t\t\t\ttoolCallId: event.toolCallId,\n\t\t\t\t\t// `isError` viene del resultado de la tool, no de una excepción: una\n\t\t\t\t\t// tool puede fallar limpiamente y el cliente debe verlo en rojo.\n\t\t\t\t\tstatus: event.isError ? \"failed\" : \"completed\",\n\t\t\t\t\tcontent: toolResultContent(event.result),\n\t\t\t\t},\n\t\t\t];\n\n\t\tdefault:\n\t\t\treturn [];\n\t}\n}\n\n/**\n * Por qué terminó el turno, en el vocabulario de ACP.\n *\n * `agent_end` con `willRetry` NO cierra el turno: el agente va a reintentar\n * solo, y anunciar `end_turn` dejaría al cliente creyendo que puede escribir\n * mientras la sesión sigue ocupada.\n */\nexport function stopReasonFor(options: { aborted: boolean }): AcpStopReason {\n\treturn options.aborted ? \"cancelled\" : \"end_turn\";\n}\n"]}

package/dist/modes/interactive/components/home-screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home-screen.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/home-screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAwD,MAAM,wBAAwB,CAAC;AACzH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKzF,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAEzF,KAAK,cAAc,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAwDnF;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAU,YAAW,SAAS;IACtE,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAwB;IAExC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,kEAAkE;IAC3D,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAEhC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvC;IAED,YAAY,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAMxD;IAGD,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAW5B;IAED,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,SAAS;YAQH,WAAW;IAczB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkD9B;IAED,UAAU,IAAI,IAAI,CAAG;IAErB,gBAAgB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAErC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2H9B;IAED,8DAA8D;IAC9D,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;CAGnB","sourcesContent":["import { type Component, Container, Input, getKeybindings, truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\nimport type { SessionInfo, SessionListProgress } from \"../../../core/session-manager.ts\";\nimport { checkForNewPiVersion } from \"../../../utils/version-check.ts\";\nimport { theme } from \"../theme/theme.ts\";\nimport { filterAndSortSessions } from \"./session-selector-search.ts\";\n\nexport type HomeScreenResult = { kind: \"new\" } | { kind: \"resume\"; path: string } | null;\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\nconst ASCII_LOGO = [\n\t\"  █████╗ ██████╗  █████╗\",\n\t\" ██╔══██╗██╔══██╗██╔══██╗\",\n\t\" ███████║██║  ██║███████║\",\n\t\" ██╔══██║██║  ██║██╔══██║\",\n\t\" ██║  ██║██████╔╝██║  ██║\",\n\t\" ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝\",\n].join(\"\\n\");\n\n/** Vertical teal-to-gray gradient for the ASCII logo. */\nconst LOGO_GRADIENT = [\"accent\", \"accent\", \"borderAccent\", \"border\", \"borderMuted\", \"muted\"] as const;\n\n/** Draw a rounded box around centered content with an optional title. */\nfunction box(\n\tcontentLines: string[],\n\twidth: number,\n\toptions: { title?: string; color?: (str: string) => string } = {},\n): string[] {\n\tconst color = options.color ?? ((str: string) => theme.fg(\"border\", str));\n\tconst innerWidth = Math.max(10, width - 4);\n\tconst top =\n\t\toptions.title !== undefined\n\t\t\t? color(`╭─ ${options.title} `) + \"─\".repeat(Math.max(1, innerWidth - options.title.length - 2)) + color(\"─╮\")\n\t\t\t: color(`╭${\"─\".repeat(innerWidth)}╮`);\n\tconst bottom = color(`╰${\"─\".repeat(innerWidth)}╯`);\n\tconst pad = (line: string) => {\n\t\tconst visible = visibleWidth(line);\n\t\tconst left = Math.max(0, Math.floor((innerWidth - visible) / 2));\n\t\tconst right = Math.max(0, innerWidth - visible - left);\n\t\treturn color(\"│ \") + \" \".repeat(left) + line + \" \".repeat(right) + color(\" │\");\n\t};\n\treturn [top, ...contentLines.map(pad), bottom];\n}\n\nfunction sessionTitle(session: SessionInfo): string {\n\tif (session.name) return session.name;\n\tconst first = (session.firstMessage ?? \"\").replace(/\\s+/g, \" \").trim();\n\tif (first.length > 0) return first.length > 60 ? `${first.slice(0, 60)}…` : first;\n\treturn \"Conversation\";\n}\n\nfunction relativeTime(iso: string): string {\n\tconst diffMs = Date.now() - new Date(iso).getTime();\n\tconst mins = Math.floor(diffMs / 60000);\n\tif (mins < 1) return \"now\";\n\tif (mins < 60) return `${mins}m`;\n\tconst hours = Math.floor(mins / 60);\n\tif (hours < 24) return `${hours}h`;\n\tconst days = Math.floor(hours / 24);\n\tif (days < 7) return `${days}d`;\n\tif (days < 30) return `${Math.floor(days / 7)}w`;\n\treturn `${Math.floor(days / 30)}mo`;\n}\n\n/**\n * Central welcome flow (opencode style) shown when the CLI starts:\n *  1) entry screen: \"Enter as guest\" (login is disabled for now)\n *  2) home screen: welcome banner, update notice, recent conversations and\n *     a \"New conversation\" action.\n */\nexport class HomeScreenComponent extends Container implements Component {\n\tprivate phase: \"login\" | \"home\" = \"login\";\n\tprivate sessions: SessionInfo[] = [];\n\tprivate filtered: SessionInfo[] = [];\n\tprivate selectedIndex = 0; // 0 = \"New conversation\", then sessions\n\tprivate query = \"\";\n\tprivate loading = false;\n\tprivate updateAvailable: string | null = null;\n\tprivate updateChecked = false;\n\tprivate searchInput: Input;\n\tprivate loadSessions: SessionsLoader;\n\tprivate version: string;\n\tprivate modelLabel: string | null = null;\n\tprivate cwdLabelValue: string | null = null;\n\tprivate memoryEnabled = true;\n\tprivate _focused = false;\n\tprivate requestRenderFn: () => void = () => {};\n\n\tpublic onNew?: () => void;\n\tpublic onResume?: (path: string) => void;\n\tpublic onExit?: () => void;\n\tpublic onUpdate?: () => void;\n\t/** Fired when the entry screen transitions to the home screen. */\n\tpublic onEnterHome?: () => void;\n\n\tsetModelLabel(label: string | null): void {\n\t\tthis.modelLabel = label;\n\t}\n\n\tsetCwdLabel(label: string): void {\n\t\tthis.cwdLabelValue = label;\n\t}\n\n\tsetMemoryEnabled(enabled: boolean): void {\n\t\tthis.memoryEnabled = enabled;\n\t}\n\n\tconstructor(loadSessions: SessionsLoader, version: string) {\n\t\tsuper();\n\t\tthis.loadSessions = loadSessions;\n\t\tthis.version = version;\n\t\tthis.searchInput = new Input();\n\t\tthis.searchInput.onSubmit = () => this.confirmSelection();\n\t}\n\n\t// Focusable\n\tget focused(): boolean {\n\t\treturn this._focused;\n\t}\n\tset focused(value: boolean) {\n\t\tthis._focused = value;\n\t\tthis.searchInput.focused = value;\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tthis.loading = true;\n\t\tthis.requestRenderFn();\n\t\ttry {\n\t\t\tthis.sessions = await this.loadSessions();\n\t\t} catch {\n\t\t\tthis.sessions = [];\n\t\t}\n\t\tthis.loading = false;\n\t\tthis.applyFilter();\n\t\tthis.requestRenderFn();\n\t}\n\n\tprivate applyFilter(): void {\n\t\tconst q = this.query.trim();\n\t\tthis.filtered = q\n\t\t\t? filterAndSortSessions(this.sessions, q, \"recent\", \"all\")\n\t\t\t: [...this.sessions].sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\tthis.selectedIndex = Math.min(this.selectedIndex, this.filtered.length);\n\t}\n\n\tprivate confirmSelection(): void {\n\t\tif (this.phase === \"login\") {\n\t\t\tthis.enterHome();\n\t\t\treturn;\n\t\t}\n\t\tif (this.selectedIndex === 0) {\n\t\t\tthis.onNew?.();\n\t\t} else {\n\t\t\tconst session = this.filtered[this.selectedIndex - 1];\n\t\t\tif (session) this.onResume?.(session.path);\n\t\t}\n\t}\n\n\tprivate enterHome(): void {\n\t\tthis.phase = \"home\";\n\t\tthis.selectedIndex = 0;\n\t\tthis.onEnterHome?.();\n\t\tvoid this.reload();\n\t\tvoid this.checkUpdate();\n\t}\n\n\tprivate async checkUpdate(): Promise<void> {\n\t\tif (this.updateChecked) return;\n\t\tthis.updateChecked = true;\n\t\ttry {\n\t\t\tconst release = await checkForNewPiVersion(this.version);\n\t\t\tif (release) {\n\t\t\t\tthis.updateAvailable = release.version;\n\t\t\t\tthis.requestRenderFn();\n\t\t\t}\n\t\t} catch {\n\t\t\t// Offline or unreachable — ignore silently.\n\t\t}\n\t}\n\n\thandleInput(data: string): void {\n\t\tconst kb = getKeybindings();\n\t\tif (this.phase === \"login\") {\n\t\t\tif (kb.matches(data, \"tui.select.confirm\") || data === \"\\r\" || data === \"\\n\") {\n\t\t\t\tthis.enterHome();\n\t\t\t} else if (kb.matches(data, \"tui.select.cancel\") || data === \"q\" || data === \"Q\") {\n\t\t\t\tthis.onExit?.();\n\t\t\t} else if (kb.matches(data, \"tui.select.down\")) {\n\t\t\t\t// Only one actionable option on the login screen; ignore.\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (kb.matches(data, \"tui.select.up\")) {\n\t\t\tthis.selectedIndex = Math.max(0, this.selectedIndex - 1);\n\t\t\tthis.requestRenderFn();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.down\")) {\n\t\t\tthis.selectedIndex = Math.min(this.filtered.length, this.selectedIndex + 1);\n\t\t\tthis.requestRenderFn();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.confirm\") || data === \"\\r\" || data === \"\\n\") {\n\t\t\tthis.confirmSelection();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.cancel\")) {\n\t\t\tthis.onExit?.();\n\t\t\treturn;\n\t\t}\n\t\tif (data === \"n\" || data === \"N\") {\n\t\t\tthis.onNew?.();\n\t\t\treturn;\n\t\t}\n\t\tif (data === \"u\" || data === \"U\") {\n\t\t\tif (this.updateAvailable) {\n\t\t\t\tthis.onUpdate?.();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tif (data === \"q\" || data === \"Q\") {\n\t\t\tthis.onExit?.();\n\t\t\treturn;\n\t\t}\n\t\t// Anything else goes to the search input (filters sessions)\n\t\tthis.searchInput.handleInput(data);\n\t\tthis.query = this.searchInput.getValue();\n\t\tthis.applyFilter();\n\t\tthis.requestRenderFn();\n\t}\n\n\tinvalidate(): void {}\n\n\tsetRequestRender(fn: () => void): void {\n\t\tthis.requestRenderFn = fn;\n\t}\n\n\trender(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tconst center = (text: string) => {\n\t\t\tconst pad = Math.max(0, Math.floor((width - visibleWidth(text)) / 2));\n\t\t\treturn \" \".repeat(pad) + text;\n\t\t};\n\t\tconst dim = (t: string) => theme.fg(\"dim\", t);\n\t\tconst muted = (t: string) => theme.fg(\"muted\", t);\n\t\tconst accent = (t: string) => theme.fg(\"accent\", t);\n\t\tconst border = (t: string) => theme.fg(\"border\", t);\n\t\tconst success = (t: string) => theme.fg(\"success\", t);\n\t\tconst warning = (t: string) => theme.fg(\"warning\", t);\n\n\t\t// Gradient logo (teal -> gray)\n\t\tconst logoLines = ASCII_LOGO.split(\"\\n\").map((line, i) =>\n\t\t\ttheme.fg(LOGO_GRADIENT[Math.min(i, LOGO_GRADIENT.length - 1)], line),\n\t\t);\n\t\tconst tagline =\n\t\t\taccent(\"Ada\") + dim(\" · coding agent · HOILAB TECH\") + muted(`  v${this.version}`);\n\n\t\tlines.push(\"\");\n\n\t\tif (this.phase === \"login\") {\n\t\t\t// ---- Entry screen -------------------------------------------\n\t\t\tconst boxW = Math.min(56, width - 4);\n\t\t\tconst boxLines = box(\n\t\t\t\t[\n\t\t\t\t\t\"\",\n\t\t\t\t\t...logoLines,\n\t\t\t\t\ttagline,\n\t\t\t\t\t\"\",\n\t\t\t\t\tdim(\"Bienvenido a Ada — el agente de codificación de HOILAB TECH\"),\n\t\t\t\t\t\"\",\n\t\t\t\t\taccent(\"▸  \") + theme.bold(\"Entrar como invitado\"),\n\t\t\t\t\tmuted(\"    Loguearme\") + dim(\"   (próximamente)\"),\n\t\t\t\t\t\"\",\n\t\t\t\t],\n\t\t\t\tboxW,\n\t\t\t\t{ title: \" ✦ HOILAB TECH ✦ \" },\n\t\t\t);\n\t\t\tlines.push(...boxLines.map((l) => center(l)));\n\t\t\tlines.push(\"\");\n\t\t\tlines.push(center(success(\"●\") + dim(\"  En línea · sin conexión a cuentas\") + muted(\"  ·  todo queda en tu máquina\")));\n\t\t\tlines.push(\"\");\n\t\t\tlines.push(\n\t\t\t\tcenter(muted([\"Enter para continuar\", \"q para salir\"].join(\"   ·   \"))),\n\t\t\t);\n\t\t\treturn this.finishRender(lines, width);\n\t\t}\n\n\t\t// ---- Home screen ------------------------------------------------\n\t\tconst boxW = Math.min(width - 4, 72);\n\n\t\t// Header box: logo + status\n\t\tconst statusParts = [\n\t\t\tdim(`model: ${this.defaultModelLabel()}`),\n\t\t\tdim(`cwd: ${this.cwdLabel()}`),\n\t\t\tdim(`memoria: ${this.memoryLabel()}`),\n\t\t\t\"\",\n\t\t];\n\t\tif (this.updateAvailable) {\n\t\t\tstatusParts.push(\n\t\t\t\twarning(\n\t\t\t\t\t`⚠  Nueva versión disponible: v${this.updateAvailable}  ` +\n\t\t\t\t\t\taccent(\"[u] actualizar\") +\n\t\t\t\t\t\tdim(\"  ·  q para ignorar\"),\n\t\t\t\t),\n\t\t\t);\n\t\t} else if (this.updateChecked) {\n\t\t\tstatusParts.push(success(\"✓  Sistema actualizado\"));\n\t\t}\n\t\tlines.push(...box([\"\", ...logoLines, tagline, \"\", ...statusParts], boxW, { title: \" ✦ HOILAB TECH ✦ \" }).map((l) => center(l)));\n\t\tlines.push(\"\");\n\n\t\t// Conversations box\n\t\tconst convLines: string[] = [\"\"];\n\t\tconst isNew = this.selectedIndex === 0;\n\t\tconvLines.push(\n\t\t\t`${isNew ? accent(\"▸ \") : \"  \"}${accent(\"✦\")} ${isNew ? theme.bold(\"Nueva conversación\") : \"Nueva conversación\"}`,\n\t\t);\n\t\tconvLines.push(\"\");\n\n\t\tif (this.loading) {\n\t\t\tconvLines.push(dim(\"Cargando conversaciones…\"));\n\t\t} else if (this.filtered.length === 0) {\n\t\t\tconvLines.push(\n\t\t\t\tmuted(\n\t\t\t\t\tthis.query\n\t\t\t\t\t\t? \"No hay conversaciones que coincidan con tu búsqueda\"\n\t\t\t\t\t\t: \"Todavía no hay conversaciones anteriores\",\n\t\t\t\t),\n\t\t\t);\n\t\t} else {\n\t\t\tconst maxVisible = Math.max(1, Math.min(12, Math.floor((width * 2) / 3)));\n\t\t\tconst visible = this.filtered.slice(0, maxVisible);\n\t\t\tfor (let i = 0; i < visible.length; i++) {\n\t\t\t\tconst session = visible[i];\n\t\t\t\tconst isSelected = this.selectedIndex === i + 1;\n\t\t\t\tconst title = sessionTitle(session);\n\t\t\t\tconst meta = muted(\n\t\t\t\t\t`${relativeTime(session.modified.toISOString())} · ${session.messageCount} msgs`,\n\t\t\t\t);\n\t\t\t\tconst arrow = isSelected ? accent(\"▸ \") : \"  \";\n\t\t\t\tconst titleStyled = isSelected ? theme.bold(accent(title)) : title;\n\t\t\t\tconvLines.push(`${arrow}${titleStyled} ${meta}`);\n\t\t\t}\n\t\t\tif (this.filtered.length > maxVisible) {\n\t\t\t\tconvLines.push(dim(`… y ${this.filtered.length - maxVisible} más`));\n\t\t\t}\n\t\t}\n\t\tconvLines.push(\"\");\n\t\tlines.push(...box(convLines, boxW, { title: \" Conversaciones \" }).map((l) => center(l)));\n\t\tlines.push(\"\");\n\n\t\tconst hints = [\n\t\t\t\"↑/↓ navegar\",\n\t\t\t\"Enter seleccionar\",\n\t\t\t\"n nueva\",\n\t\t\tthis.updateAvailable ? \"u actualizar\" : null,\n\t\t\t\"q salir\",\n\t\t].filter((h): h is string => h !== null);\n\t\tlines.push(center(muted(hints.join(\"   ·   \"))));\n\t\treturn this.finishRender(lines, width);\n\t}\n\n\t/** Vertical centering + truncation of every rendered line. */\n\tprivate finishRender(lines: string[], width: number): string[] {\n\t\tconst rows = process.stdout.rows ?? 24;\n\t\tconst contentHeight = lines.length;\n\t\tconst topPad = Math.min(3, Math.max(0, Math.floor((rows - contentHeight) / 3)));\n\t\treturn [...Array<string>(topPad).fill(\"\"), ...lines.map((line) => truncateToWidth(line, width))];\n\t}\n\n\tprivate defaultModelLabel(): string {\n\t\treturn this.modelLabel ?? \"no configurado (/model)\";\n\t}\n\n\tprivate cwdLabel(): string {\n\t\treturn this.cwdLabelValue ?? process.cwd();\n\t}\n\n\tprivate memoryLabel(): string {\n\t\treturn this.memoryEnabled ? \"activada\" : \"desactivada\";\n\t}\n}\n"]}
+{"version":3,"file":"home-screen.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/home-screen.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,SAAS,EACd,SAAS,EAKT,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKzF,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAEzF,KAAK,cAAc,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAwDnF;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAU,YAAW,SAAS;IACtE,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAwB;IAExC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,kEAAkE;IAC3D,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IAEhC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvC;IAED,YAAY,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAMxD;IAGD,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAW5B;IAED,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,SAAS;YAQH,WAAW;IAczB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkD9B;IAED,UAAU,IAAI,IAAI,CAAG;IAErB,gBAAgB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAErC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4H9B;IAED,8DAA8D;IAC9D,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;CAGnB","sourcesContent":["import {\n\ttype Component,\n\tContainer,\n\tgetKeybindings,\n\tInput,\n\ttruncateToWidth,\n\tvisibleWidth,\n} from \"@earendil-works/pi-tui\";\nimport type { SessionInfo, SessionListProgress } from \"../../../core/session-manager.ts\";\nimport { checkForNewPiVersion } from \"../../../utils/version-check.ts\";\nimport { theme } from \"../theme/theme.ts\";\nimport { filterAndSortSessions } from \"./session-selector-search.ts\";\n\nexport type HomeScreenResult = { kind: \"new\" } | { kind: \"resume\"; path: string } | null;\n\ntype SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;\n\nconst ASCII_LOGO = [\n\t\"  █████╗ ██████╗  █████╗\",\n\t\" ██╔══██╗██╔══██╗██╔══██╗\",\n\t\" ███████║██║  ██║███████║\",\n\t\" ██╔══██║██║  ██║██╔══██║\",\n\t\" ██║  ██║██████╔╝██║  ██║\",\n\t\" ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝\",\n].join(\"\\n\");\n\n/** Vertical teal-to-gray gradient for the ASCII logo. */\nconst LOGO_GRADIENT = [\"accent\", \"accent\", \"borderAccent\", \"border\", \"borderMuted\", \"muted\"] as const;\n\n/** Draw a rounded box around centered content with an optional title. */\nfunction box(\n\tcontentLines: string[],\n\twidth: number,\n\toptions: { title?: string; color?: (str: string) => string } = {},\n): string[] {\n\tconst color = options.color ?? ((str: string) => theme.fg(\"border\", str));\n\tconst innerWidth = Math.max(10, width - 4);\n\tconst top =\n\t\toptions.title !== undefined\n\t\t\t? color(`╭─ ${options.title} `) + \"─\".repeat(Math.max(1, innerWidth - options.title.length - 2)) + color(\"─╮\")\n\t\t\t: color(`╭${\"─\".repeat(innerWidth)}╮`);\n\tconst bottom = color(`╰${\"─\".repeat(innerWidth)}╯`);\n\tconst pad = (line: string) => {\n\t\tconst visible = visibleWidth(line);\n\t\tconst left = Math.max(0, Math.floor((innerWidth - visible) / 2));\n\t\tconst right = Math.max(0, innerWidth - visible - left);\n\t\treturn color(\"│ \") + \" \".repeat(left) + line + \" \".repeat(right) + color(\" │\");\n\t};\n\treturn [top, ...contentLines.map(pad), bottom];\n}\n\nfunction sessionTitle(session: SessionInfo): string {\n\tif (session.name) return session.name;\n\tconst first = (session.firstMessage ?? \"\").replace(/\\s+/g, \" \").trim();\n\tif (first.length > 0) return first.length > 60 ? `${first.slice(0, 60)}…` : first;\n\treturn \"Conversation\";\n}\n\nfunction relativeTime(iso: string): string {\n\tconst diffMs = Date.now() - new Date(iso).getTime();\n\tconst mins = Math.floor(diffMs / 60000);\n\tif (mins < 1) return \"now\";\n\tif (mins < 60) return `${mins}m`;\n\tconst hours = Math.floor(mins / 60);\n\tif (hours < 24) return `${hours}h`;\n\tconst days = Math.floor(hours / 24);\n\tif (days < 7) return `${days}d`;\n\tif (days < 30) return `${Math.floor(days / 7)}w`;\n\treturn `${Math.floor(days / 30)}mo`;\n}\n\n/**\n * Central welcome flow (opencode style) shown when the CLI starts:\n *  1) entry screen: \"Enter as guest\" (login is disabled for now)\n *  2) home screen: welcome banner, update notice, recent conversations and\n *     a \"New conversation\" action.\n */\nexport class HomeScreenComponent extends Container implements Component {\n\tprivate phase: \"login\" | \"home\" = \"login\";\n\tprivate sessions: SessionInfo[] = [];\n\tprivate filtered: SessionInfo[] = [];\n\tprivate selectedIndex = 0; // 0 = \"New conversation\", then sessions\n\tprivate query = \"\";\n\tprivate loading = false;\n\tprivate updateAvailable: string | null = null;\n\tprivate updateChecked = false;\n\tprivate searchInput: Input;\n\tprivate loadSessions: SessionsLoader;\n\tprivate version: string;\n\tprivate modelLabel: string | null = null;\n\tprivate cwdLabelValue: string | null = null;\n\tprivate memoryEnabled = true;\n\tprivate _focused = false;\n\tprivate requestRenderFn: () => void = () => {};\n\n\tpublic onNew?: () => void;\n\tpublic onResume?: (path: string) => void;\n\tpublic onExit?: () => void;\n\tpublic onUpdate?: () => void;\n\t/** Fired when the entry screen transitions to the home screen. */\n\tpublic onEnterHome?: () => void;\n\n\tsetModelLabel(label: string | null): void {\n\t\tthis.modelLabel = label;\n\t}\n\n\tsetCwdLabel(label: string): void {\n\t\tthis.cwdLabelValue = label;\n\t}\n\n\tsetMemoryEnabled(enabled: boolean): void {\n\t\tthis.memoryEnabled = enabled;\n\t}\n\n\tconstructor(loadSessions: SessionsLoader, version: string) {\n\t\tsuper();\n\t\tthis.loadSessions = loadSessions;\n\t\tthis.version = version;\n\t\tthis.searchInput = new Input();\n\t\tthis.searchInput.onSubmit = () => this.confirmSelection();\n\t}\n\n\t// Focusable\n\tget focused(): boolean {\n\t\treturn this._focused;\n\t}\n\tset focused(value: boolean) {\n\t\tthis._focused = value;\n\t\tthis.searchInput.focused = value;\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tthis.loading = true;\n\t\tthis.requestRenderFn();\n\t\ttry {\n\t\t\tthis.sessions = await this.loadSessions();\n\t\t} catch {\n\t\t\tthis.sessions = [];\n\t\t}\n\t\tthis.loading = false;\n\t\tthis.applyFilter();\n\t\tthis.requestRenderFn();\n\t}\n\n\tprivate applyFilter(): void {\n\t\tconst q = this.query.trim();\n\t\tthis.filtered = q\n\t\t\t? filterAndSortSessions(this.sessions, q, \"recent\", \"all\")\n\t\t\t: [...this.sessions].sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\tthis.selectedIndex = Math.min(this.selectedIndex, this.filtered.length);\n\t}\n\n\tprivate confirmSelection(): void {\n\t\tif (this.phase === \"login\") {\n\t\t\tthis.enterHome();\n\t\t\treturn;\n\t\t}\n\t\tif (this.selectedIndex === 0) {\n\t\t\tthis.onNew?.();\n\t\t} else {\n\t\t\tconst session = this.filtered[this.selectedIndex - 1];\n\t\t\tif (session) this.onResume?.(session.path);\n\t\t}\n\t}\n\n\tprivate enterHome(): void {\n\t\tthis.phase = \"home\";\n\t\tthis.selectedIndex = 0;\n\t\tthis.onEnterHome?.();\n\t\tvoid this.reload();\n\t\tvoid this.checkUpdate();\n\t}\n\n\tprivate async checkUpdate(): Promise<void> {\n\t\tif (this.updateChecked) return;\n\t\tthis.updateChecked = true;\n\t\ttry {\n\t\t\tconst release = await checkForNewPiVersion(this.version);\n\t\t\tif (release) {\n\t\t\t\tthis.updateAvailable = release.version;\n\t\t\t\tthis.requestRenderFn();\n\t\t\t}\n\t\t} catch {\n\t\t\t// Offline or unreachable — ignore silently.\n\t\t}\n\t}\n\n\thandleInput(data: string): void {\n\t\tconst kb = getKeybindings();\n\t\tif (this.phase === \"login\") {\n\t\t\tif (kb.matches(data, \"tui.select.confirm\") || data === \"\\r\" || data === \"\\n\") {\n\t\t\t\tthis.enterHome();\n\t\t\t} else if (kb.matches(data, \"tui.select.cancel\") || data === \"q\" || data === \"Q\") {\n\t\t\t\tthis.onExit?.();\n\t\t\t} else if (kb.matches(data, \"tui.select.down\")) {\n\t\t\t\t// Only one actionable option on the login screen; ignore.\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tif (kb.matches(data, \"tui.select.up\")) {\n\t\t\tthis.selectedIndex = Math.max(0, this.selectedIndex - 1);\n\t\t\tthis.requestRenderFn();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.down\")) {\n\t\t\tthis.selectedIndex = Math.min(this.filtered.length, this.selectedIndex + 1);\n\t\t\tthis.requestRenderFn();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.confirm\") || data === \"\\r\" || data === \"\\n\") {\n\t\t\tthis.confirmSelection();\n\t\t\treturn;\n\t\t}\n\t\tif (kb.matches(data, \"tui.select.cancel\")) {\n\t\t\tthis.onExit?.();\n\t\t\treturn;\n\t\t}\n\t\tif (data === \"n\" || data === \"N\") {\n\t\t\tthis.onNew?.();\n\t\t\treturn;\n\t\t}\n\t\tif (data === \"u\" || data === \"U\") {\n\t\t\tif (this.updateAvailable) {\n\t\t\t\tthis.onUpdate?.();\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tif (data === \"q\" || data === \"Q\") {\n\t\t\tthis.onExit?.();\n\t\t\treturn;\n\t\t}\n\t\t// Anything else goes to the search input (filters sessions)\n\t\tthis.searchInput.handleInput(data);\n\t\tthis.query = this.searchInput.getValue();\n\t\tthis.applyFilter();\n\t\tthis.requestRenderFn();\n\t}\n\n\tinvalidate(): void {}\n\n\tsetRequestRender(fn: () => void): void {\n\t\tthis.requestRenderFn = fn;\n\t}\n\n\trender(width: number): string[] {\n\t\tconst lines: string[] = [];\n\t\tconst center = (text: string) => {\n\t\t\tconst pad = Math.max(0, Math.floor((width - visibleWidth(text)) / 2));\n\t\t\treturn \" \".repeat(pad) + text;\n\t\t};\n\t\tconst dim = (t: string) => theme.fg(\"dim\", t);\n\t\tconst muted = (t: string) => theme.fg(\"muted\", t);\n\t\tconst accent = (t: string) => theme.fg(\"accent\", t);\n\t\tconst _border = (t: string) => theme.fg(\"border\", t);\n\t\tconst success = (t: string) => theme.fg(\"success\", t);\n\t\tconst warning = (t: string) => theme.fg(\"warning\", t);\n\n\t\t// Gradient logo (teal -> gray)\n\t\tconst logoLines = ASCII_LOGO.split(\"\\n\").map((line, i) =>\n\t\t\ttheme.fg(LOGO_GRADIENT[Math.min(i, LOGO_GRADIENT.length - 1)], line),\n\t\t);\n\t\tconst tagline = accent(\"Ada\") + dim(\" · coding agent · HOILAB TECH\") + muted(`  v${this.version}`);\n\n\t\tlines.push(\"\");\n\n\t\tif (this.phase === \"login\") {\n\t\t\t// ---- Entry screen -------------------------------------------\n\t\t\tconst boxW = Math.min(56, width - 4);\n\t\t\tconst boxLines = box(\n\t\t\t\t[\n\t\t\t\t\t\"\",\n\t\t\t\t\t...logoLines,\n\t\t\t\t\ttagline,\n\t\t\t\t\t\"\",\n\t\t\t\t\tdim(\"Bienvenido a Ada — el agente de codificación de HOILAB TECH\"),\n\t\t\t\t\t\"\",\n\t\t\t\t\taccent(\"▸  \") + theme.bold(\"Entrar como invitado\"),\n\t\t\t\t\tmuted(\"    Loguearme\") + dim(\"   (próximamente)\"),\n\t\t\t\t\t\"\",\n\t\t\t\t],\n\t\t\t\tboxW,\n\t\t\t\t{ title: \" ✦ HOILAB TECH ✦ \" },\n\t\t\t);\n\t\t\tlines.push(...boxLines.map((l) => center(l)));\n\t\t\tlines.push(\"\");\n\t\t\tlines.push(\n\t\t\t\tcenter(success(\"●\") + dim(\"  En línea · sin conexión a cuentas\") + muted(\"  ·  todo queda en tu máquina\")),\n\t\t\t);\n\t\t\tlines.push(\"\");\n\t\t\tlines.push(center(muted([\"Enter para continuar\", \"q para salir\"].join(\"   ·   \"))));\n\t\t\treturn this.finishRender(lines, width);\n\t\t}\n\n\t\t// ---- Home screen ------------------------------------------------\n\t\tconst boxW = Math.min(width - 4, 72);\n\n\t\t// Header box: logo + status\n\t\tconst statusParts = [\n\t\t\tdim(`model: ${this.defaultModelLabel()}`),\n\t\t\tdim(`cwd: ${this.cwdLabel()}`),\n\t\t\tdim(`memoria: ${this.memoryLabel()}`),\n\t\t\t\"\",\n\t\t];\n\t\tif (this.updateAvailable) {\n\t\t\tstatusParts.push(\n\t\t\t\twarning(\n\t\t\t\t\t`⚠  Nueva versión disponible: v${this.updateAvailable}  ` +\n\t\t\t\t\t\taccent(\"[u] actualizar\") +\n\t\t\t\t\t\tdim(\"  ·  q para ignorar\"),\n\t\t\t\t),\n\t\t\t);\n\t\t} else if (this.updateChecked) {\n\t\t\tstatusParts.push(success(\"✓  Sistema actualizado\"));\n\t\t}\n\t\tlines.push(\n\t\t\t...box([\"\", ...logoLines, tagline, \"\", ...statusParts], boxW, { title: \" ✦ HOILAB TECH ✦ \" }).map((l) =>\n\t\t\t\tcenter(l),\n\t\t\t),\n\t\t);\n\t\tlines.push(\"\");\n\n\t\t// Conversations box\n\t\tconst convLines: string[] = [\"\"];\n\t\tconst isNew = this.selectedIndex === 0;\n\t\tconvLines.push(\n\t\t\t`${isNew ? accent(\"▸ \") : \"  \"}${accent(\"✦\")} ${isNew ? theme.bold(\"Nueva conversación\") : \"Nueva conversación\"}`,\n\t\t);\n\t\tconvLines.push(\"\");\n\n\t\tif (this.loading) {\n\t\t\tconvLines.push(dim(\"Cargando conversaciones…\"));\n\t\t} else if (this.filtered.length === 0) {\n\t\t\tconvLines.push(\n\t\t\t\tmuted(\n\t\t\t\t\tthis.query\n\t\t\t\t\t\t? \"No hay conversaciones que coincidan con tu búsqueda\"\n\t\t\t\t\t\t: \"Todavía no hay conversaciones anteriores\",\n\t\t\t\t),\n\t\t\t);\n\t\t} else {\n\t\t\tconst maxVisible = Math.max(1, Math.min(12, Math.floor((width * 2) / 3)));\n\t\t\tconst visible = this.filtered.slice(0, maxVisible);\n\t\t\tfor (let i = 0; i < visible.length; i++) {\n\t\t\t\tconst session = visible[i];\n\t\t\t\tconst isSelected = this.selectedIndex === i + 1;\n\t\t\t\tconst title = sessionTitle(session);\n\t\t\t\tconst meta = muted(`${relativeTime(session.modified.toISOString())} · ${session.messageCount} msgs`);\n\t\t\t\tconst arrow = isSelected ? accent(\"▸ \") : \"  \";\n\t\t\t\tconst titleStyled = isSelected ? theme.bold(accent(title)) : title;\n\t\t\t\tconvLines.push(`${arrow}${titleStyled} ${meta}`);\n\t\t\t}\n\t\t\tif (this.filtered.length > maxVisible) {\n\t\t\t\tconvLines.push(dim(`… y ${this.filtered.length - maxVisible} más`));\n\t\t\t}\n\t\t}\n\t\tconvLines.push(\"\");\n\t\tlines.push(...box(convLines, boxW, { title: \" Conversaciones \" }).map((l) => center(l)));\n\t\tlines.push(\"\");\n\n\t\tconst hints = [\n\t\t\t\"↑/↓ navegar\",\n\t\t\t\"Enter seleccionar\",\n\t\t\t\"n nueva\",\n\t\t\tthis.updateAvailable ? \"u actualizar\" : null,\n\t\t\t\"q salir\",\n\t\t].filter((h): h is string => h !== null);\n\t\tlines.push(center(muted(hints.join(\"   ·   \"))));\n\t\treturn this.finishRender(lines, width);\n\t}\n\n\t/** Vertical centering + truncation of every rendered line. */\n\tprivate finishRender(lines: string[], width: number): string[] {\n\t\tconst rows = process.stdout.rows ?? 24;\n\t\tconst contentHeight = lines.length;\n\t\tconst topPad = Math.min(3, Math.max(0, Math.floor((rows - contentHeight) / 3)));\n\t\treturn [...Array<string>(topPad).fill(\"\"), ...lines.map((line) => truncateToWidth(line, width))];\n\t}\n\n\tprivate defaultModelLabel(): string {\n\t\treturn this.modelLabel ?? \"no configurado (/model)\";\n\t}\n\n\tprivate cwdLabel(): string {\n\t\treturn this.cwdLabelValue ?? process.cwd();\n\t}\n\n\tprivate memoryLabel(): string {\n\t\treturn this.memoryEnabled ? \"activada\" : \"desactivada\";\n\t}\n}\n"]}

package/dist/modes/interactive/components/home-screen.js

@@ -1,4 +1,4 @@
-import { Container, Input, getKeybindings, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { Container, getKeybindings, Input, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
 import { checkForNewPiVersion } from "../../../utils/version-check.js";
 import { theme } from "../theme/theme.js";
 import { filterAndSortSessions } from "./session-selector-search.js";
@@ -227,7 +227,7 @@ export class HomeScreenComponent extends Container {
         const dim = (t) => theme.fg("dim", t);
         const muted = (t) => theme.fg("muted", t);
         const accent = (t) => theme.fg("accent", t);
-        const border = (t) => theme.fg("border", t);
+        const _border = (t) => theme.fg("border", t);
         const success = (t) => theme.fg("success", t);
         const warning = (t) => theme.fg("warning", t);
         // Gradient logo (teal -> gray)