@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/telegram/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/telegram/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cliente de la Bot API de Telegram. Sin dependencias.\n *\n * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`\n * por la misma razón que el resto del producto evita dependencias: es un CLI\n * que se instala en máquinas ajenas, y cada paquete añadido es superficie de\n * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio\n * cabe en un fichero.\n *\n * El long polling es la única forma sensata aquí: un webhook exigiría exponer un\n * puerto público desde el portátil de alguien.\n */\n\nconst BASE = \"https://api.telegram.org\";\n\nexport interface TelegramUser {\n\tid: number;\n\tis_bot?: boolean;\n\tusername?: string;\n\tfirst_name?: string;\n}\n\nexport interface TelegramMessage {\n\tmessage_id: number;\n\tfrom?: TelegramUser;\n\tchat: { id: number; type: string };\n\ttext?: string;\n\tdate: number;\n}\n\nexport interface TelegramUpdate {\n\tupdate_id: number;\n\tmessage?: TelegramMessage;\n\tcallback_query?: { id: string; from: TelegramUser; data?: string; message?: TelegramMessage };\n}\n\nexport interface ApiOptions {\n\ttoken: string;\n\tfetchImpl?: typeof fetch;\n\t/** Segundos que el servidor retiene la petición sin novedades. */\n\tlongPollSeconds?: number;\n}\n\nexport class TelegramApiError extends Error {\n\tmethod: string;\n\tstatus: number;\n\tdescription: string;\n\t/** Segundos que Telegram pide esperar (429). */\n\tretryAfter?: number;\n\n\tconstructor(method: string, status: number, description: string, retryAfter?: number) {\n\t\tsuper(`${method}: ${description} (HTTP ${status})`);\n\t\tthis.name = \"TelegramApiError\";\n\t\tthis.method = method;\n\t\tthis.status = status;\n\t\tthis.description = description;\n\t\tthis.retryAfter = retryAfter;\n\t}\n}\n\nexport class TelegramApi {\n\tprivate token: string;\n\tprivate fetchImpl: typeof fetch;\n\tprivate longPollSeconds: number;\n\n\tconstructor(options: ApiOptions) {\n\t\tthis.token = options.token;\n\t\tthis.fetchImpl = options.fetchImpl ?? fetch;\n\t\tthis.longPollSeconds = options.longPollSeconds ?? 25;\n\t}\n\n\t/**\n\t * Llama a un método de la Bot API.\n\t *\n\t * El token va en la URL porque así lo define Telegram; por eso `toString()`\n\t * de esta clase y cualquier traza deben evitar imprimir la URL entera.\n\t */\n\tprivate async call<T>(method: string, params: Record<string, unknown>, signal?: AbortSignal): Promise<T> {\n\t\tconst response = await this.fetchImpl(`${BASE}/bot${this.token}/${method}`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(params),\n\t\t\tsignal,\n\t\t});\n\t\tconst body = (await response.json().catch(() => ({}))) as {\n\t\t\tok?: boolean;\n\t\t\tresult?: T;\n\t\t\tdescription?: string;\n\t\t\tparameters?: { retry_after?: number };\n\t\t};\n\t\tif (!response.ok || !body.ok) {\n\t\t\tthrow new TelegramApiError(\n\t\t\t\tmethod,\n\t\t\t\tresponse.status,\n\t\t\t\tbody.description ?? \"sin descripción\",\n\t\t\t\tbody.parameters?.retry_after,\n\t\t\t);\n\t\t}\n\t\treturn body.result as T;\n\t}\n\n\t/** Identidad del bot. Sirve para validar el token antes de hacer nada. */\n\tgetMe(signal?: AbortSignal): Promise<TelegramUser> {\n\t\treturn this.call<TelegramUser>(\"getMe\", {}, signal);\n\t}\n\n\t/**\n\t * Long poll. `offset` confirma como recibidas todas las actualizaciones\n\t * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.\n\t */\n\tgetUpdates(offset: number, signal?: AbortSignal): Promise<TelegramUpdate[]> {\n\t\treturn this.call<TelegramUpdate[]>(\n\t\t\t\"getUpdates\",\n\t\t\t{ offset, timeout: this.longPollSeconds, allowed_updates: [\"message\", \"callback_query\"] },\n\t\t\tsignal,\n\t\t);\n\t}\n\n\tsendMessage(chatId: number, text: string, options: { replyTo?: number } = {}): Promise<TelegramMessage> {\n\t\treturn this.call<TelegramMessage>(\"sendMessage\", {\n\t\t\tchat_id: chatId,\n\t\t\ttext,\n\t\t\t// Sin parse_mode: el texto del agente puede contener Markdown roto o\n\t\t\t// caracteres que Telegram rechazaría, y un 400 por formato perdería el\n\t\t\t// mensaje entero. Texto plano siempre llega.\n\t\t\t...(options.replyTo ? { reply_to_message_id: options.replyTo } : {}),\n\t\t});\n\t}\n\n\teditMessage(chatId: number, messageId: number, text: string): Promise<unknown> {\n\t\treturn this.call(\"editMessageText\", { chat_id: chatId, message_id: messageId, text });\n\t}\n\n\t/** Indicador de \"escribiendo…\". Caduca solo a los ~5 s. */\n\tsendTyping(chatId: number): Promise<unknown> {\n\t\treturn this.call(\"sendChatAction\", { chat_id: chatId, action: \"typing\" }).catch(() => undefined);\n\t}\n}\n\n/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */\nexport function splitForTelegram(text: string, limit = 4000): string[] {\n\tif (text.length <= limit) return [text];\n\tconst partes: string[] = [];\n\tlet resto = text;\n\twhile (resto.length > limit) {\n\t\t// Se corta en el último salto de línea que quepa para no partir una\n\t\t// palabra ni un bloque de código por la mitad.\n\t\tconst corte = resto.lastIndexOf(\"\\n\", limit);\n\t\tconst en = corte > limit * 0.5 ? corte : limit;\n\t\tpartes.push(resto.slice(0, en));\n\t\tresto = resto.slice(en).replace(/^\\n/, \"\");\n\t}\n\tif (resto) partes.push(resto);\n\treturn partes;\n}\n"]}

package/dist/telegram/bridge.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Puente entre Telegram y una sesión residente de Ada.
+ *
+ * ARQUITECTURA, Y POR QUÉ NO ES LA DEL PAQUETE DE REFERENCIA.
+ *
+ * `@llblab/pi-telegram` corre como extensión DENTRO de un proceso TUI, así que
+ * solo alcanza "la sesión activa" de ese proceso. De ahí sale casi toda su
+ * complejidad: varios TUI compitiendo por un mismo token obligan a un bus
+ * leader/follower, locks de propiedad, epochs, heartbeats y cuarentena de
+ * estado corrupto. Su propia documentación lo dice: un demonio supervisor
+ * "sería otro modo de producto".
+ *
+ * Nosotros TENEMOS ese demonio: `ada-cli serve`. Un servidor, un dueño del
+ * transporte por construcción. Eso elimina el bus entero y además nos da lo que
+ * ellos no pueden ofrecer: varias sesiones, no solo la activa, y funcionamiento
+ * con el terminal cerrado.
+ *
+ * REGLA DE SEGURIDAD NO NEGOCIABLE: desde el chat NO se conceden permisos. Un
+ * mensaje de Telegram no es una confirmación informada — quien lo lee está en el
+ * móvil, sin ver el diff. Las aprobaciones siguen ocurriendo donde se ve lo que
+ * se aprueba.
+ */
+import { type TelegramApi, type TelegramUpdate } from "./api.ts";
+import { type TelegramStore } from "./journal.ts";
+/** Lo que el puente necesita del servidor. Inyectable para poder testear. */
+export interface PuenteServidor {
+    listarSesiones(): Promise<Array<{
+        id: string;
+        name?: string;
+    }>>;
+    /** Envía un prompt y devuelve la respuesta final del agente. */
+    enviarPrompt(sessionId: string | undefined, texto: string): Promise<string>;
+    /** Operación de sesión (compact, rename, fork, kill, ops). */
+    operar(sessionId: string, op: string, payload?: unknown): Promise<{
+        ok: boolean;
+        data?: unknown;
+        error?: string;
+    }>;
+}
+export interface OpcionesPuente {
+    api: TelegramApi;
+    store: TelegramStore;
+    servidor: PuenteServidor;
+    onError?: (error: Error) => void;
+}
+/**
+ * Traduce una actualización a una acción. Puro: sin red ni disco, para poder
+ * probar el enrutado y la autorización sin levantar nada.
+ */
+export type Accion = {
+    tipo: "ignorar";
+    motivo: string;
+} | {
+    tipo: "rechazar";
+    chatId: number;
+    texto: string;
+} | {
+    tipo: "emparejar";
+    chatId: number;
+    userId: number;
+} | {
+    tipo: "comando";
+    chatId: number;
+    nombre: string;
+    args: string;
+} | {
+    tipo: "prompt";
+    chatId: number;
+    texto: string;
+};
+export declare function planificar(update: TelegramUpdate, estado: ReturnType<TelegramStore["snapshot"]>): Accion;
+export declare class TelegramBridge {
+    private api;
+    private store;
+    private servidor;
+    private onError?;
+    constructor(opciones: OpcionesPuente);
+    /** Una vuelta del bucle. Devuelve cuántas actualizaciones atendió. */
+    tick(signal?: AbortSignal): Promise<number>;
+    private responder;
+    private atender;
+    private comando;
+    private prompt;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/telegram/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/telegram/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7D,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC9B,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAChE,iEAAgE;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,gEAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnH;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,WAAW,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAcD;;;GAGG;AACH,MAAM,MAAM,MAAM,GACf;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,CAwBxG;AAED,qBAAa,cAAc;IAC1B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAAC,CAAyB;IAEzC,YAAY,QAAQ,EAAE,cAAc,EAKnC;IAED,wEAAsE;IAChE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBhD;YAEa,SAAS;YAMT,OAAO;YAsBP,OAAO;YAgEP,MAAM;CAQpB","sourcesContent":["/**\n * Puente entre Telegram y una sesión residente de Ada.\n *\n * ARQUITECTURA, Y POR QUÉ NO ES LA DEL PAQUETE DE REFERENCIA.\n *\n * `@llblab/pi-telegram` corre como extensión DENTRO de un proceso TUI, así que\n * solo alcanza \"la sesión activa\" de ese proceso. De ahí sale casi toda su\n * complejidad: varios TUI compitiendo por un mismo token obligan a un bus\n * leader/follower, locks de propiedad, epochs, heartbeats y cuarentena de\n * estado corrupto. Su propia documentación lo dice: un demonio supervisor\n * \"sería otro modo de producto\".\n *\n * Nosotros TENEMOS ese demonio: `ada-cli serve`. Un servidor, un dueño del\n * transporte por construcción. Eso elimina el bus entero y además nos da lo que\n * ellos no pueden ofrecer: varias sesiones, no solo la activa, y funcionamiento\n * con el terminal cerrado.\n *\n * REGLA DE SEGURIDAD NO NEGOCIABLE: desde el chat NO se conceden permisos. Un\n * mensaje de Telegram no es una confirmación informada — quien lo lee está en el\n * móvil, sin ver el diff. Las aprobaciones siguen ocurriendo donde se ve lo que\n * se aprueba.\n */\n\nimport { splitForTelegram, type TelegramApi, type TelegramUpdate } from \"./api.ts\";\nimport { autorizar, type TelegramStore } from \"./journal.ts\";\n\n/** Lo que el puente necesita del servidor. Inyectable para poder testear. */\nexport interface PuenteServidor {\n\tlistarSesiones(): Promise<Array<{ id: string; name?: string }>>;\n\t/** Envía un prompt y devuelve la respuesta final del agente. */\n\tenviarPrompt(sessionId: string | undefined, texto: string): Promise<string>;\n\t/** Operación de sesión (compact, rename, fork, kill, ops). */\n\toperar(sessionId: string, op: string, payload?: unknown): Promise<{ ok: boolean; data?: unknown; error?: string }>;\n}\n\nexport interface OpcionesPuente {\n\tapi: TelegramApi;\n\tstore: TelegramStore;\n\tservidor: PuenteServidor;\n\tonError?: (error: Error) => void;\n}\n\nconst AYUDA = `Comandos:\n/sesiones — lista las sesiones del servidor\n/usar <id> — enruta tus mensajes a esa sesión\n/compactar — compacta la sesión actual\n/estado — qué sesión está activa\n/desvincular — desconecta este chat del bot\n\nCualquier otro texto se envía como prompt a la sesión activa.\n\nLas aprobaciones de permisos NO se conceden desde aquí: se piden donde puedas\nver qué estás aprobando.`;\n\n/**\n * Traduce una actualización a una acción. Puro: sin red ni disco, para poder\n * probar el enrutado y la autorización sin levantar nada.\n */\nexport type Accion =\n\t| { tipo: \"ignorar\"; motivo: string }\n\t| { tipo: \"rechazar\"; chatId: number; texto: string }\n\t| { tipo: \"emparejar\"; chatId: number; userId: number }\n\t| { tipo: \"comando\"; chatId: number; nombre: string; args: string }\n\t| { tipo: \"prompt\"; chatId: number; texto: string };\n\nexport function planificar(update: TelegramUpdate, estado: ReturnType<TelegramStore[\"snapshot\"]>): Accion {\n\tconst mensaje = update.message;\n\tif (!mensaje?.text) return { tipo: \"ignorar\", motivo: \"sin texto\" };\n\tconst chatId = mensaje.chat.id;\n\n\tconst veredicto = autorizar(estado, mensaje.from);\n\tif (!veredicto.permitido) {\n\t\t// Se responde en vez de callar: quien se ha equivocado de bot merece\n\t\t// saberlo, y quien intenta colarse ya sabe que el bot existe. Lo que NO\n\t\t// se hace es ejecutar nada.\n\t\tconst texto =\n\t\t\tveredicto.motivo === \"otro-usuario\" ? \"Este bot ya está vinculado a otra cuenta.\" : \"No puedo atenderte.\";\n\t\treturn { tipo: \"rechazar\", chatId, texto };\n\t}\n\tif (veredicto.primerEmparejamiento) {\n\t\treturn { tipo: \"emparejar\", chatId, userId: mensaje.from?.id ?? 0 };\n\t}\n\n\tconst texto = mensaje.text.trim();\n\tif (texto.startsWith(\"/\")) {\n\t\tconst [nombre, ...resto] = texto.slice(1).split(/\\s+/);\n\t\treturn { tipo: \"comando\", chatId, nombre: (nombre ?? \"\").toLowerCase(), args: resto.join(\" \") };\n\t}\n\treturn { tipo: \"prompt\", chatId, texto };\n}\n\nexport class TelegramBridge {\n\tprivate api: TelegramApi;\n\tprivate store: TelegramStore;\n\tprivate servidor: PuenteServidor;\n\tprivate onError?: (error: Error) => void;\n\n\tconstructor(opciones: OpcionesPuente) {\n\t\tthis.api = opciones.api;\n\t\tthis.store = opciones.store;\n\t\tthis.servidor = opciones.servidor;\n\t\tthis.onError = opciones.onError;\n\t}\n\n\t/** Una vuelta del bucle. Devuelve cuántas actualizaciones atendió. */\n\tasync tick(signal?: AbortSignal): Promise<number> {\n\t\tconst updates = await this.api.getUpdates(this.store.offset(), signal);\n\t\tlet atendidas = 0;\n\t\tfor (const update of updates) {\n\t\t\t// Reentrega tras un fallo: si ya se atendió, se salta sin repetir el\n\t\t\t// efecto pero avanzando igual el offset.\n\t\t\tif (this.store.yaProcesada(update.update_id)) continue;\n\t\t\ttry {\n\t\t\t\tawait this.atender(update);\n\t\t\t} catch (error) {\n\t\t\t\tthis.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t\t// SIEMPRE después de atender. Confirmar antes perdería el mensaje si el\n\t\t\t// proceso muere en medio: Telegram no lo reenvía nunca más.\n\t\t\tthis.store.confirmar(update.update_id);\n\t\t\tatendidas++;\n\t\t}\n\t\treturn atendidas;\n\t}\n\n\tprivate async responder(chatId: number, texto: string): Promise<void> {\n\t\tfor (const parte of splitForTelegram(texto)) {\n\t\t\tawait this.api.sendMessage(chatId, parte);\n\t\t}\n\t}\n\n\tprivate async atender(update: TelegramUpdate): Promise<void> {\n\t\tconst accion = planificar(update, this.store.snapshot());\n\t\tswitch (accion.tipo) {\n\t\t\tcase \"ignorar\":\n\t\t\t\treturn;\n\t\t\tcase \"rechazar\":\n\t\t\t\tawait this.responder(accion.chatId, accion.texto);\n\t\t\t\treturn;\n\t\t\tcase \"emparejar\": {\n\t\t\t\tthis.store.emparejar(accion.userId, accion.chatId);\n\t\t\t\tawait this.responder(accion.chatId, `Vinculado. Este chat controla Ada en esta máquina.\\n\\n${AYUDA}`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"comando\":\n\t\t\t\tawait this.comando(accion.chatId, accion.nombre, accion.args);\n\t\t\t\treturn;\n\t\t\tcase \"prompt\":\n\t\t\t\tawait this.prompt(accion.chatId, accion.texto);\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\tprivate async comando(chatId: number, nombre: string, args: string): Promise<void> {\n\t\tconst estado = this.store.snapshot();\n\t\tswitch (nombre) {\n\t\t\tcase \"start\":\n\t\t\tcase \"ayuda\":\n\t\t\tcase \"help\":\n\t\t\t\tawait this.responder(chatId, AYUDA);\n\t\t\t\treturn;\n\t\t\tcase \"sesiones\": {\n\t\t\t\tconst sesiones = await this.servidor.listarSesiones();\n\t\t\t\tif (sesiones.length === 0) {\n\t\t\t\t\tawait this.responder(chatId, \"No hay sesiones en el servidor.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst lista = sesiones\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(s) => `${s.id === estado.sessionId ? \"▸ \" : \"  \"}${s.id.slice(0, 8)}${s.name ? ` — ${s.name}` : \"\"}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\tawait this.responder(chatId, `Sesiones:\\n${lista}\\n\\nUsa /usar <id> para elegir.`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"usar\": {\n\t\t\t\tif (!args) {\n\t\t\t\t\tawait this.responder(chatId, \"Falta el id. Míralos con /sesiones.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst sesiones = await this.servidor.listarSesiones();\n\t\t\t\tconst elegida = sesiones.find((s) => s.id === args || s.id.startsWith(args));\n\t\t\t\tif (!elegida) {\n\t\t\t\t\tawait this.responder(chatId, `No encuentro la sesión '${args}'.`);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.store.fijarSesion(elegida.id);\n\t\t\t\tawait this.responder(\n\t\t\t\t\tchatId,\n\t\t\t\t\t`Activa: ${elegida.id.slice(0, 8)}${elegida.name ? ` — ${elegida.name}` : \"\"}`,\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"compactar\": {\n\t\t\t\tif (!estado.sessionId) {\n\t\t\t\t\tawait this.responder(chatId, \"No hay sesión activa. Elige una con /usar.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst r = await this.servidor.operar(estado.sessionId, \"compact\");\n\t\t\t\tawait this.responder(chatId, r.ok ? \"Contexto compactado.\" : `No se pudo: ${r.error ?? \"error\"}`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"estado\":\n\t\t\t\tawait this.responder(\n\t\t\t\t\tchatId,\n\t\t\t\t\testado.sessionId ? `Sesión activa: ${estado.sessionId.slice(0, 8)}` : \"Sin sesión activa.\",\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\tcase \"desvincular\":\n\t\t\t\tthis.store.desemparejar();\n\t\t\t\tawait this.responder(chatId, \"Desvinculado. Escribe /start para volver a vincular.\");\n\t\t\t\treturn;\n\t\t\tdefault:\n\t\t\t\tawait this.responder(chatId, `No conozco /${nombre}.\\n\\n${AYUDA}`);\n\t\t}\n\t}\n\n\tprivate async prompt(chatId: number, texto: string): Promise<void> {\n\t\tconst estado = this.store.snapshot();\n\t\t// El indicador de \"escribiendo\" da señal de vida mientras el modelo piensa;\n\t\t// sin él, un turno largo parece que se ha colgado.\n\t\tvoid this.api.sendTyping(chatId);\n\t\tconst respuesta = await this.servidor.enviarPrompt(estado.sessionId, texto);\n\t\tawait this.responder(chatId, respuesta || \"(sin respuesta)\");\n\t}\n}\n"]}

package/dist/telegram/bridge.js

@@ -0,0 +1,182 @@
+/**
+ * Puente entre Telegram y una sesión residente de Ada.
+ *
+ * ARQUITECTURA, Y POR QUÉ NO ES LA DEL PAQUETE DE REFERENCIA.
+ *
+ * `@llblab/pi-telegram` corre como extensión DENTRO de un proceso TUI, así que
+ * solo alcanza "la sesión activa" de ese proceso. De ahí sale casi toda su
+ * complejidad: varios TUI compitiendo por un mismo token obligan a un bus
+ * leader/follower, locks de propiedad, epochs, heartbeats y cuarentena de
+ * estado corrupto. Su propia documentación lo dice: un demonio supervisor
+ * "sería otro modo de producto".
+ *
+ * Nosotros TENEMOS ese demonio: `ada-cli serve`. Un servidor, un dueño del
+ * transporte por construcción. Eso elimina el bus entero y además nos da lo que
+ * ellos no pueden ofrecer: varias sesiones, no solo la activa, y funcionamiento
+ * con el terminal cerrado.
+ *
+ * REGLA DE SEGURIDAD NO NEGOCIABLE: desde el chat NO se conceden permisos. Un
+ * mensaje de Telegram no es una confirmación informada — quien lo lee está en el
+ * móvil, sin ver el diff. Las aprobaciones siguen ocurriendo donde se ve lo que
+ * se aprueba.
+ */
+import { splitForTelegram } from "./api.js";
+import { autorizar } from "./journal.js";
+const AYUDA = `Comandos:
+/sesiones — lista las sesiones del servidor
+/usar <id> — enruta tus mensajes a esa sesión
+/compactar — compacta la sesión actual
+/estado — qué sesión está activa
+/desvincular — desconecta este chat del bot
+
+Cualquier otro texto se envía como prompt a la sesión activa.
+
+Las aprobaciones de permisos NO se conceden desde aquí: se piden donde puedas
+ver qué estás aprobando.`;
+export function planificar(update, estado) {
+    const mensaje = update.message;
+    if (!mensaje?.text)
+        return { tipo: "ignorar", motivo: "sin texto" };
+    const chatId = mensaje.chat.id;
+    const veredicto = autorizar(estado, mensaje.from);
+    if (!veredicto.permitido) {
+        // Se responde en vez de callar: quien se ha equivocado de bot merece
+        // saberlo, y quien intenta colarse ya sabe que el bot existe. Lo que NO
+        // se hace es ejecutar nada.
+        const texto = veredicto.motivo === "otro-usuario" ? "Este bot ya está vinculado a otra cuenta." : "No puedo atenderte.";
+        return { tipo: "rechazar", chatId, texto };
+    }
+    if (veredicto.primerEmparejamiento) {
+        return { tipo: "emparejar", chatId, userId: mensaje.from?.id ?? 0 };
+    }
+    const texto = mensaje.text.trim();
+    if (texto.startsWith("/")) {
+        const [nombre, ...resto] = texto.slice(1).split(/\s+/);
+        return { tipo: "comando", chatId, nombre: (nombre ?? "").toLowerCase(), args: resto.join(" ") };
+    }
+    return { tipo: "prompt", chatId, texto };
+}
+export class TelegramBridge {
+    api;
+    store;
+    servidor;
+    onError;
+    constructor(opciones) {
+        this.api = opciones.api;
+        this.store = opciones.store;
+        this.servidor = opciones.servidor;
+        this.onError = opciones.onError;
+    }
+    /** Una vuelta del bucle. Devuelve cuántas actualizaciones atendió. */
+    async tick(signal) {
+        const updates = await this.api.getUpdates(this.store.offset(), signal);
+        let atendidas = 0;
+        for (const update of updates) {
+            // Reentrega tras un fallo: si ya se atendió, se salta sin repetir el
+            // efecto pero avanzando igual el offset.
+            if (this.store.yaProcesada(update.update_id))
+                continue;
+            try {
+                await this.atender(update);
+            }
+            catch (error) {
+                this.onError?.(error instanceof Error ? error : new Error(String(error)));
+            }
+            // SIEMPRE después de atender. Confirmar antes perdería el mensaje si el
+            // proceso muere en medio: Telegram no lo reenvía nunca más.
+            this.store.confirmar(update.update_id);
+            atendidas++;
+        }
+        return atendidas;
+    }
+    async responder(chatId, texto) {
+        for (const parte of splitForTelegram(texto)) {
+            await this.api.sendMessage(chatId, parte);
+        }
+    }
+    async atender(update) {
+        const accion = planificar(update, this.store.snapshot());
+        switch (accion.tipo) {
+            case "ignorar":
+                return;
+            case "rechazar":
+                await this.responder(accion.chatId, accion.texto);
+                return;
+            case "emparejar": {
+                this.store.emparejar(accion.userId, accion.chatId);
+                await this.responder(accion.chatId, `Vinculado. Este chat controla Ada en esta máquina.\n\n${AYUDA}`);
+                return;
+            }
+            case "comando":
+                await this.comando(accion.chatId, accion.nombre, accion.args);
+                return;
+            case "prompt":
+                await this.prompt(accion.chatId, accion.texto);
+                return;
+        }
+    }
+    async comando(chatId, nombre, args) {
+        const estado = this.store.snapshot();
+        switch (nombre) {
+            case "start":
+            case "ayuda":
+            case "help":
+                await this.responder(chatId, AYUDA);
+                return;
+            case "sesiones": {
+                const sesiones = await this.servidor.listarSesiones();
+                if (sesiones.length === 0) {
+                    await this.responder(chatId, "No hay sesiones en el servidor.");
+                    return;
+                }
+                const lista = sesiones
+                    .map((s) => `${s.id === estado.sessionId ? "▸ " : "  "}${s.id.slice(0, 8)}${s.name ? ` — ${s.name}` : ""}`)
+                    .join("\n");
+                await this.responder(chatId, `Sesiones:\n${lista}\n\nUsa /usar <id> para elegir.`);
+                return;
+            }
+            case "usar": {
+                if (!args) {
+                    await this.responder(chatId, "Falta el id. Míralos con /sesiones.");
+                    return;
+                }
+                const sesiones = await this.servidor.listarSesiones();
+                const elegida = sesiones.find((s) => s.id === args || s.id.startsWith(args));
+                if (!elegida) {
+                    await this.responder(chatId, `No encuentro la sesión '${args}'.`);
+                    return;
+                }
+                this.store.fijarSesion(elegida.id);
+                await this.responder(chatId, `Activa: ${elegida.id.slice(0, 8)}${elegida.name ? ` — ${elegida.name}` : ""}`);
+                return;
+            }
+            case "compactar": {
+                if (!estado.sessionId) {
+                    await this.responder(chatId, "No hay sesión activa. Elige una con /usar.");
+                    return;
+                }
+                const r = await this.servidor.operar(estado.sessionId, "compact");
+                await this.responder(chatId, r.ok ? "Contexto compactado." : `No se pudo: ${r.error ?? "error"}`);
+                return;
+            }
+            case "estado":
+                await this.responder(chatId, estado.sessionId ? `Sesión activa: ${estado.sessionId.slice(0, 8)}` : "Sin sesión activa.");
+                return;
+            case "desvincular":
+                this.store.desemparejar();
+                await this.responder(chatId, "Desvinculado. Escribe /start para volver a vincular.");
+                return;
+            default:
+                await this.responder(chatId, `No conozco /${nombre}.\n\n${AYUDA}`);
+        }
+    }
+    async prompt(chatId, texto) {
+        const estado = this.store.snapshot();
+        // El indicador de "escribiendo" da señal de vida mientras el modelo piensa;
+        // sin él, un turno largo parece que se ha colgado.
+        void this.api.sendTyping(chatId);
+        const respuesta = await this.servidor.enviarPrompt(estado.sessionId, texto);
+        await this.responder(chatId, respuesta || "(sin respuesta)");
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/telegram/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/telegram/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Puente entre Telegram y una sesión residente de Ada.\n *\n * ARQUITECTURA, Y POR QUÉ NO ES LA DEL PAQUETE DE REFERENCIA.\n *\n * `@llblab/pi-telegram` corre como extensión DENTRO de un proceso TUI, así que\n * solo alcanza \"la sesión activa\" de ese proceso. De ahí sale casi toda su\n * complejidad: varios TUI compitiendo por un mismo token obligan a un bus\n * leader/follower, locks de propiedad, epochs, heartbeats y cuarentena de\n * estado corrupto. Su propia documentación lo dice: un demonio supervisor\n * \"sería otro modo de producto\".\n *\n * Nosotros TENEMOS ese demonio: `ada-cli serve`. Un servidor, un dueño del\n * transporte por construcción. Eso elimina el bus entero y además nos da lo que\n * ellos no pueden ofrecer: varias sesiones, no solo la activa, y funcionamiento\n * con el terminal cerrado.\n *\n * REGLA DE SEGURIDAD NO NEGOCIABLE: desde el chat NO se conceden permisos. Un\n * mensaje de Telegram no es una confirmación informada — quien lo lee está en el\n * móvil, sin ver el diff. Las aprobaciones siguen ocurriendo donde se ve lo que\n * se aprueba.\n */\n\nimport { splitForTelegram, type TelegramApi, type TelegramUpdate } from \"./api.ts\";\nimport { autorizar, type TelegramStore } from \"./journal.ts\";\n\n/** Lo que el puente necesita del servidor. Inyectable para poder testear. */\nexport interface PuenteServidor {\n\tlistarSesiones(): Promise<Array<{ id: string; name?: string }>>;\n\t/** Envía un prompt y devuelve la respuesta final del agente. */\n\tenviarPrompt(sessionId: string | undefined, texto: string): Promise<string>;\n\t/** Operación de sesión (compact, rename, fork, kill, ops). */\n\toperar(sessionId: string, op: string, payload?: unknown): Promise<{ ok: boolean; data?: unknown; error?: string }>;\n}\n\nexport interface OpcionesPuente {\n\tapi: TelegramApi;\n\tstore: TelegramStore;\n\tservidor: PuenteServidor;\n\tonError?: (error: Error) => void;\n}\n\nconst AYUDA = `Comandos:\n/sesiones — lista las sesiones del servidor\n/usar <id> — enruta tus mensajes a esa sesión\n/compactar — compacta la sesión actual\n/estado — qué sesión está activa\n/desvincular — desconecta este chat del bot\n\nCualquier otro texto se envía como prompt a la sesión activa.\n\nLas aprobaciones de permisos NO se conceden desde aquí: se piden donde puedas\nver qué estás aprobando.`;\n\n/**\n * Traduce una actualización a una acción. Puro: sin red ni disco, para poder\n * probar el enrutado y la autorización sin levantar nada.\n */\nexport type Accion =\n\t| { tipo: \"ignorar\"; motivo: string }\n\t| { tipo: \"rechazar\"; chatId: number; texto: string }\n\t| { tipo: \"emparejar\"; chatId: number; userId: number }\n\t| { tipo: \"comando\"; chatId: number; nombre: string; args: string }\n\t| { tipo: \"prompt\"; chatId: number; texto: string };\n\nexport function planificar(update: TelegramUpdate, estado: ReturnType<TelegramStore[\"snapshot\"]>): Accion {\n\tconst mensaje = update.message;\n\tif (!mensaje?.text) return { tipo: \"ignorar\", motivo: \"sin texto\" };\n\tconst chatId = mensaje.chat.id;\n\n\tconst veredicto = autorizar(estado, mensaje.from);\n\tif (!veredicto.permitido) {\n\t\t// Se responde en vez de callar: quien se ha equivocado de bot merece\n\t\t// saberlo, y quien intenta colarse ya sabe que el bot existe. Lo que NO\n\t\t// se hace es ejecutar nada.\n\t\tconst texto =\n\t\t\tveredicto.motivo === \"otro-usuario\" ? \"Este bot ya está vinculado a otra cuenta.\" : \"No puedo atenderte.\";\n\t\treturn { tipo: \"rechazar\", chatId, texto };\n\t}\n\tif (veredicto.primerEmparejamiento) {\n\t\treturn { tipo: \"emparejar\", chatId, userId: mensaje.from?.id ?? 0 };\n\t}\n\n\tconst texto = mensaje.text.trim();\n\tif (texto.startsWith(\"/\")) {\n\t\tconst [nombre, ...resto] = texto.slice(1).split(/\\s+/);\n\t\treturn { tipo: \"comando\", chatId, nombre: (nombre ?? \"\").toLowerCase(), args: resto.join(\" \") };\n\t}\n\treturn { tipo: \"prompt\", chatId, texto };\n}\n\nexport class TelegramBridge {\n\tprivate api: TelegramApi;\n\tprivate store: TelegramStore;\n\tprivate servidor: PuenteServidor;\n\tprivate onError?: (error: Error) => void;\n\n\tconstructor(opciones: OpcionesPuente) {\n\t\tthis.api = opciones.api;\n\t\tthis.store = opciones.store;\n\t\tthis.servidor = opciones.servidor;\n\t\tthis.onError = opciones.onError;\n\t}\n\n\t/** Una vuelta del bucle. Devuelve cuántas actualizaciones atendió. */\n\tasync tick(signal?: AbortSignal): Promise<number> {\n\t\tconst updates = await this.api.getUpdates(this.store.offset(), signal);\n\t\tlet atendidas = 0;\n\t\tfor (const update of updates) {\n\t\t\t// Reentrega tras un fallo: si ya se atendió, se salta sin repetir el\n\t\t\t// efecto pero avanzando igual el offset.\n\t\t\tif (this.store.yaProcesada(update.update_id)) continue;\n\t\t\ttry {\n\t\t\t\tawait this.atender(update);\n\t\t\t} catch (error) {\n\t\t\t\tthis.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t\t// SIEMPRE después de atender. Confirmar antes perdería el mensaje si el\n\t\t\t// proceso muere en medio: Telegram no lo reenvía nunca más.\n\t\t\tthis.store.confirmar(update.update_id);\n\t\t\tatendidas++;\n\t\t}\n\t\treturn atendidas;\n\t}\n\n\tprivate async responder(chatId: number, texto: string): Promise<void> {\n\t\tfor (const parte of splitForTelegram(texto)) {\n\t\t\tawait this.api.sendMessage(chatId, parte);\n\t\t}\n\t}\n\n\tprivate async atender(update: TelegramUpdate): Promise<void> {\n\t\tconst accion = planificar(update, this.store.snapshot());\n\t\tswitch (accion.tipo) {\n\t\t\tcase \"ignorar\":\n\t\t\t\treturn;\n\t\t\tcase \"rechazar\":\n\t\t\t\tawait this.responder(accion.chatId, accion.texto);\n\t\t\t\treturn;\n\t\t\tcase \"emparejar\": {\n\t\t\t\tthis.store.emparejar(accion.userId, accion.chatId);\n\t\t\t\tawait this.responder(accion.chatId, `Vinculado. Este chat controla Ada en esta máquina.\\n\\n${AYUDA}`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"comando\":\n\t\t\t\tawait this.comando(accion.chatId, accion.nombre, accion.args);\n\t\t\t\treturn;\n\t\t\tcase \"prompt\":\n\t\t\t\tawait this.prompt(accion.chatId, accion.texto);\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\tprivate async comando(chatId: number, nombre: string, args: string): Promise<void> {\n\t\tconst estado = this.store.snapshot();\n\t\tswitch (nombre) {\n\t\t\tcase \"start\":\n\t\t\tcase \"ayuda\":\n\t\t\tcase \"help\":\n\t\t\t\tawait this.responder(chatId, AYUDA);\n\t\t\t\treturn;\n\t\t\tcase \"sesiones\": {\n\t\t\t\tconst sesiones = await this.servidor.listarSesiones();\n\t\t\t\tif (sesiones.length === 0) {\n\t\t\t\t\tawait this.responder(chatId, \"No hay sesiones en el servidor.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst lista = sesiones\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(s) => `${s.id === estado.sessionId ? \"▸ \" : \"  \"}${s.id.slice(0, 8)}${s.name ? ` — ${s.name}` : \"\"}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\");\n\t\t\t\tawait this.responder(chatId, `Sesiones:\\n${lista}\\n\\nUsa /usar <id> para elegir.`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"usar\": {\n\t\t\t\tif (!args) {\n\t\t\t\t\tawait this.responder(chatId, \"Falta el id. Míralos con /sesiones.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst sesiones = await this.servidor.listarSesiones();\n\t\t\t\tconst elegida = sesiones.find((s) => s.id === args || s.id.startsWith(args));\n\t\t\t\tif (!elegida) {\n\t\t\t\t\tawait this.responder(chatId, `No encuentro la sesión '${args}'.`);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.store.fijarSesion(elegida.id);\n\t\t\t\tawait this.responder(\n\t\t\t\t\tchatId,\n\t\t\t\t\t`Activa: ${elegida.id.slice(0, 8)}${elegida.name ? ` — ${elegida.name}` : \"\"}`,\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"compactar\": {\n\t\t\t\tif (!estado.sessionId) {\n\t\t\t\t\tawait this.responder(chatId, \"No hay sesión activa. Elige una con /usar.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst r = await this.servidor.operar(estado.sessionId, \"compact\");\n\t\t\t\tawait this.responder(chatId, r.ok ? \"Contexto compactado.\" : `No se pudo: ${r.error ?? \"error\"}`);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"estado\":\n\t\t\t\tawait this.responder(\n\t\t\t\t\tchatId,\n\t\t\t\t\testado.sessionId ? `Sesión activa: ${estado.sessionId.slice(0, 8)}` : \"Sin sesión activa.\",\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\tcase \"desvincular\":\n\t\t\t\tthis.store.desemparejar();\n\t\t\t\tawait this.responder(chatId, \"Desvinculado. Escribe /start para volver a vincular.\");\n\t\t\t\treturn;\n\t\t\tdefault:\n\t\t\t\tawait this.responder(chatId, `No conozco /${nombre}.\\n\\n${AYUDA}`);\n\t\t}\n\t}\n\n\tprivate async prompt(chatId: number, texto: string): Promise<void> {\n\t\tconst estado = this.store.snapshot();\n\t\t// El indicador de \"escribiendo\" da señal de vida mientras el modelo piensa;\n\t\t// sin él, un turno largo parece que se ha colgado.\n\t\tvoid this.api.sendTyping(chatId);\n\t\tconst respuesta = await this.servidor.enviarPrompt(estado.sessionId, texto);\n\t\tawait this.responder(chatId, respuesta || \"(sin respuesta)\");\n\t}\n}\n"]}

package/dist/telegram/journal.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Journal de actualizaciones y emparejamiento de un solo usuario.
+ *
+ * Dos cosas que parecen menores y no lo son:
+ *
+ * 1. **El offset se confirma DESPUÉS de persistir, nunca antes.** Telegram
+ *    borra una actualización en cuanto avanzas el offset y no la reenvía jamás.
+ *    Si el proceso muere entre recibir y procesar, ese mensaje se pierde para
+ *    siempre. Por eso aquí se escribe primero y se confirma después.
+ *
+ * 2. **Un solo usuario, el primero que se empareja.** Un bot de Telegram es
+ *    alcanzable por cualquiera que sepa su nombre. Sin esta puerta, cualquier
+ *    desconocido podría escribirle a tu bot y ejecutar comandos en tu máquina.
+ */
+export interface EstadoTelegram {
+    version: 1;
+    /** Última actualización PROCESADA. El offset se calcula a partir de esto. */
+    lastUpdateId: number;
+    /** Id del usuario emparejado. Nadie más puede hablar con el bot. */
+    allowedUserId?: number;
+    /** Chat donde vive la conversación con ese usuario. */
+    chatId?: number;
+    /** Sesión de Ada a la que se enrutan los prompts. */
+    sessionId?: string;
+    pairedAt?: string;
+}
+export declare class TelegramStore {
+    private path;
+    private estado;
+    private cargado;
+    constructor(agentDir: string);
+    private cargar;
+    private guardar;
+    snapshot(): EstadoTelegram;
+    /** Offset para `getUpdates`: la siguiente a la última procesada. */
+    offset(): number;
+    /**
+     * Marca una actualización como procesada. Se llama SIEMPRE después de
+     * haberla atendido, nunca antes: ese es el contrato que evita perderla.
+     */
+    confirmar(updateId: number): void;
+    /** True si esa actualización ya se atendió (reentrega tras un fallo). */
+    yaProcesada(updateId: number): boolean;
+    emparejar(userId: number, chatId: number): void;
+    desemparejar(): void;
+    fijarSesion(sessionId: string | undefined): void;
+}
+export type Veredicto = {
+    permitido: true;
+    primerEmparejamiento: boolean;
+} | {
+    permitido: false;
+    motivo: "sin-usuario" | "otro-usuario" | "es-bot";
+};
+/**
+ * Decide si un mensaje puede actuar sobre la máquina.
+ *
+ * Se empareja el PRIMERO que escribe y se rechaza a todos los demás en
+ * silencio-hacia-fuera (se responde, pero no se ejecuta nada). Rechazar sin
+ * responder sería peor: quien se equivoca de bot merece saberlo, y quien
+ * intenta colarse ya sabe que el bot existe.
+ */
+export declare function autorizar(estado: EstadoTelegram, from: {
+    id: number;
+    is_bot?: boolean;
+} | undefined): Veredicto;
+//# sourceMappingURL=journal.d.ts.map

package/dist/telegram/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/telegram/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,+EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,aAAa;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,QAAQ,EAAE,MAAM,EAE3B;IAED,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,OAAO;IAYf,QAAQ,IAAI,cAAc,CAGzB;IAED,qEAAoE;IACpE,MAAM,IAAI,MAAM,CAGf;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKhC;IAED,2EAAyE;IACzE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrC;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9C;IAED,YAAY,IAAI,IAAI,CAOnB;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI/C;CACD;AAED,MAAM,MAAM,SAAS,GAClB;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,oBAAoB,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,SAAS,CAO/G","sourcesContent":["/**\n * Journal de actualizaciones y emparejamiento de un solo usuario.\n *\n * Dos cosas que parecen menores y no lo son:\n *\n * 1. **El offset se confirma DESPUÉS de persistir, nunca antes.** Telegram\n *    borra una actualización en cuanto avanzas el offset y no la reenvía jamás.\n *    Si el proceso muere entre recibir y procesar, ese mensaje se pierde para\n *    siempre. Por eso aquí se escribe primero y se confirma después.\n *\n * 2. **Un solo usuario, el primero que se empareja.** Un bot de Telegram es\n *    alcanzable por cualquiera que sepa su nombre. Sin esta puerta, cualquier\n *    desconocido podría escribirle a tu bot y ejecutar comandos en tu máquina.\n */\n\nimport { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nexport interface EstadoTelegram {\n\tversion: 1;\n\t/** Última actualización PROCESADA. El offset se calcula a partir de esto. */\n\tlastUpdateId: number;\n\t/** Id del usuario emparejado. Nadie más puede hablar con el bot. */\n\tallowedUserId?: number;\n\t/** Chat donde vive la conversación con ese usuario. */\n\tchatId?: number;\n\t/** Sesión de Ada a la que se enrutan los prompts. */\n\tsessionId?: string;\n\tpairedAt?: string;\n}\n\nconst VACIO: EstadoTelegram = { version: 1, lastUpdateId: 0 };\n\nexport class TelegramStore {\n\tprivate path: string;\n\tprivate estado: EstadoTelegram = { ...VACIO };\n\tprivate cargado = false;\n\n\tconstructor(agentDir: string) {\n\t\tthis.path = join(agentDir, \"telegram\", \"state.json\");\n\t}\n\n\tprivate cargar(): void {\n\t\tif (this.cargado) return;\n\t\tthis.cargado = true;\n\t\tif (!existsSync(this.path)) return;\n\t\ttry {\n\t\t\tconst leido = JSON.parse(readFileSync(this.path, \"utf-8\")) as EstadoTelegram;\n\t\t\t// Una versión futura se ignora en vez de interpretarse a medias: mejor\n\t\t\t// re-emparejar que enrutar mensajes con un formato que no entendemos.\n\t\t\tif (leido?.version === 1) this.estado = { ...VACIO, ...leido };\n\t\t} catch {\n\t\t\t// Fichero corrupto: se arranca limpio en vez de impedir el arranque.\n\t\t}\n\t}\n\n\tprivate guardar(): void {\n\t\tmkdirSync(dirname(this.path), { recursive: true });\n\t\tconst tmp = `${this.path}.tmp`;\n\t\t// Escritura atómica: un corte a mitad no puede dejar un estado ilegible\n\t\t// que obligue a re-emparejar.\n\t\twriteFileSync(tmp, JSON.stringify(this.estado, null, 2), { mode: 0o600 });\n\t\t// `mode` solo se aplica al CREAR: si un corte anterior dejó el temporal con\n\t\t// permisos laxos, el rename se los pasaría al estado definitivo.\n\t\tchmodSync(tmp, 0o600);\n\t\trenameSync(tmp, this.path);\n\t}\n\n\tsnapshot(): EstadoTelegram {\n\t\tthis.cargar();\n\t\treturn { ...this.estado };\n\t}\n\n\t/** Offset para `getUpdates`: la siguiente a la última procesada. */\n\toffset(): number {\n\t\tthis.cargar();\n\t\treturn this.estado.lastUpdateId > 0 ? this.estado.lastUpdateId + 1 : 0;\n\t}\n\n\t/**\n\t * Marca una actualización como procesada. Se llama SIEMPRE después de\n\t * haberla atendido, nunca antes: ese es el contrato que evita perderla.\n\t */\n\tconfirmar(updateId: number): void {\n\t\tthis.cargar();\n\t\tif (updateId <= this.estado.lastUpdateId) return; // duplicado o reintento\n\t\tthis.estado.lastUpdateId = updateId;\n\t\tthis.guardar();\n\t}\n\n\t/** True si esa actualización ya se atendió (reentrega tras un fallo). */\n\tyaProcesada(updateId: number): boolean {\n\t\tthis.cargar();\n\t\treturn updateId <= this.estado.lastUpdateId;\n\t}\n\n\temparejar(userId: number, chatId: number): void {\n\t\tthis.cargar();\n\t\tthis.estado.allowedUserId = userId;\n\t\tthis.estado.chatId = chatId;\n\t\tthis.estado.pairedAt = new Date().toISOString();\n\t\tthis.guardar();\n\t}\n\n\tdesemparejar(): void {\n\t\tthis.cargar();\n\t\tthis.estado.allowedUserId = undefined;\n\t\tthis.estado.chatId = undefined;\n\t\tthis.estado.sessionId = undefined;\n\t\tthis.estado.pairedAt = undefined;\n\t\tthis.guardar();\n\t}\n\n\tfijarSesion(sessionId: string | undefined): void {\n\t\tthis.cargar();\n\t\tthis.estado.sessionId = sessionId;\n\t\tthis.guardar();\n\t}\n}\n\nexport type Veredicto =\n\t| { permitido: true; primerEmparejamiento: boolean }\n\t| { permitido: false; motivo: \"sin-usuario\" | \"otro-usuario\" | \"es-bot\" };\n\n/**\n * Decide si un mensaje puede actuar sobre la máquina.\n *\n * Se empareja el PRIMERO que escribe y se rechaza a todos los demás en\n * silencio-hacia-fuera (se responde, pero no se ejecuta nada). Rechazar sin\n * responder sería peor: quien se equivoca de bot merece saberlo, y quien\n * intenta colarse ya sabe que el bot existe.\n */\nexport function autorizar(estado: EstadoTelegram, from: { id: number; is_bot?: boolean } | undefined): Veredicto {\n\tif (!from) return { permitido: false, motivo: \"sin-usuario\" };\n\t// Un bot escribiendo a otro bot es un bucle o un intento de abuso.\n\tif (from.is_bot) return { permitido: false, motivo: \"es-bot\" };\n\tif (estado.allowedUserId === undefined) return { permitido: true, primerEmparejamiento: true };\n\tif (estado.allowedUserId === from.id) return { permitido: true, primerEmparejamiento: false };\n\treturn { permitido: false, motivo: \"otro-usuario\" };\n}\n"]}

package/dist/telegram/journal.js

@@ -0,0 +1,119 @@
+/**
+ * Journal de actualizaciones y emparejamiento de un solo usuario.
+ *
+ * Dos cosas que parecen menores y no lo son:
+ *
+ * 1. **El offset se confirma DESPUÉS de persistir, nunca antes.** Telegram
+ *    borra una actualización en cuanto avanzas el offset y no la reenvía jamás.
+ *    Si el proceso muere entre recibir y procesar, ese mensaje se pierde para
+ *    siempre. Por eso aquí se escribe primero y se confirma después.
+ *
+ * 2. **Un solo usuario, el primero que se empareja.** Un bot de Telegram es
+ *    alcanzable por cualquiera que sepa su nombre. Sin esta puerta, cualquier
+ *    desconocido podría escribirle a tu bot y ejecutar comandos en tu máquina.
+ */
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const VACIO = { version: 1, lastUpdateId: 0 };
+export class TelegramStore {
+    path;
+    estado = { ...VACIO };
+    cargado = false;
+    constructor(agentDir) {
+        this.path = join(agentDir, "telegram", "state.json");
+    }
+    cargar() {
+        if (this.cargado)
+            return;
+        this.cargado = true;
+        if (!existsSync(this.path))
+            return;
+        try {
+            const leido = JSON.parse(readFileSync(this.path, "utf-8"));
+            // Una versión futura se ignora en vez de interpretarse a medias: mejor
+            // re-emparejar que enrutar mensajes con un formato que no entendemos.
+            if (leido?.version === 1)
+                this.estado = { ...VACIO, ...leido };
+        }
+        catch {
+            // Fichero corrupto: se arranca limpio en vez de impedir el arranque.
+        }
+    }
+    guardar() {
+        mkdirSync(dirname(this.path), { recursive: true });
+        const tmp = `${this.path}.tmp`;
+        // Escritura atómica: un corte a mitad no puede dejar un estado ilegible
+        // que obligue a re-emparejar.
+        writeFileSync(tmp, JSON.stringify(this.estado, null, 2), { mode: 0o600 });
+        // `mode` solo se aplica al CREAR: si un corte anterior dejó el temporal con
+        // permisos laxos, el rename se los pasaría al estado definitivo.
+        chmodSync(tmp, 0o600);
+        renameSync(tmp, this.path);
+    }
+    snapshot() {
+        this.cargar();
+        return { ...this.estado };
+    }
+    /** Offset para `getUpdates`: la siguiente a la última procesada. */
+    offset() {
+        this.cargar();
+        return this.estado.lastUpdateId > 0 ? this.estado.lastUpdateId + 1 : 0;
+    }
+    /**
+     * Marca una actualización como procesada. Se llama SIEMPRE después de
+     * haberla atendido, nunca antes: ese es el contrato que evita perderla.
+     */
+    confirmar(updateId) {
+        this.cargar();
+        if (updateId <= this.estado.lastUpdateId)
+            return; // duplicado o reintento
+        this.estado.lastUpdateId = updateId;
+        this.guardar();
+    }
+    /** True si esa actualización ya se atendió (reentrega tras un fallo). */
+    yaProcesada(updateId) {
+        this.cargar();
+        return updateId <= this.estado.lastUpdateId;
+    }
+    emparejar(userId, chatId) {
+        this.cargar();
+        this.estado.allowedUserId = userId;
+        this.estado.chatId = chatId;
+        this.estado.pairedAt = new Date().toISOString();
+        this.guardar();
+    }
+    desemparejar() {
+        this.cargar();
+        this.estado.allowedUserId = undefined;
+        this.estado.chatId = undefined;
+        this.estado.sessionId = undefined;
+        this.estado.pairedAt = undefined;
+        this.guardar();
+    }
+    fijarSesion(sessionId) {
+        this.cargar();
+        this.estado.sessionId = sessionId;
+        this.guardar();
+    }
+}
+/**
+ * Decide si un mensaje puede actuar sobre la máquina.
+ *
+ * Se empareja el PRIMERO que escribe y se rechaza a todos los demás en
+ * silencio-hacia-fuera (se responde, pero no se ejecuta nada). Rechazar sin
+ * responder sería peor: quien se equivoca de bot merece saberlo, y quien
+ * intenta colarse ya sabe que el bot existe.
+ */
+export function autorizar(estado, from) {
+    if (!from)
+        return { permitido: false, motivo: "sin-usuario" };
+    // Un bot escribiendo a otro bot es un bucle o un intento de abuso.
+    if (from.is_bot)
+        return { permitido: false, motivo: "es-bot" };
+    if (estado.allowedUserId === undefined)
+        return { permitido: true, primerEmparejamiento: true };
+    if (estado.allowedUserId === from.id)
+        return { permitido: true, primerEmparejamiento: false };
+    return { permitido: false, motivo: "otro-usuario" };
+}
+//# sourceMappingURL=journal.js.map

package/dist/telegram/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/telegram/journal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Journal de actualizaciones y emparejamiento de un solo usuario.\n *\n * Dos cosas que parecen menores y no lo son:\n *\n * 1. **El offset se confirma DESPUÉS de persistir, nunca antes.** Telegram\n *    borra una actualización en cuanto avanzas el offset y no la reenvía jamás.\n *    Si el proceso muere entre recibir y procesar, ese mensaje se pierde para\n *    siempre. Por eso aquí se escribe primero y se confirma después.\n *\n * 2. **Un solo usuario, el primero que se empareja.** Un bot de Telegram es\n *    alcanzable por cualquiera que sepa su nombre. Sin esta puerta, cualquier\n *    desconocido podría escribirle a tu bot y ejecutar comandos en tu máquina.\n */\n\nimport { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nexport interface EstadoTelegram {\n\tversion: 1;\n\t/** Última actualización PROCESADA. El offset se calcula a partir de esto. */\n\tlastUpdateId: number;\n\t/** Id del usuario emparejado. Nadie más puede hablar con el bot. */\n\tallowedUserId?: number;\n\t/** Chat donde vive la conversación con ese usuario. */\n\tchatId?: number;\n\t/** Sesión de Ada a la que se enrutan los prompts. */\n\tsessionId?: string;\n\tpairedAt?: string;\n}\n\nconst VACIO: EstadoTelegram = { version: 1, lastUpdateId: 0 };\n\nexport class TelegramStore {\n\tprivate path: string;\n\tprivate estado: EstadoTelegram = { ...VACIO };\n\tprivate cargado = false;\n\n\tconstructor(agentDir: string) {\n\t\tthis.path = join(agentDir, \"telegram\", \"state.json\");\n\t}\n\n\tprivate cargar(): void {\n\t\tif (this.cargado) return;\n\t\tthis.cargado = true;\n\t\tif (!existsSync(this.path)) return;\n\t\ttry {\n\t\t\tconst leido = JSON.parse(readFileSync(this.path, \"utf-8\")) as EstadoTelegram;\n\t\t\t// Una versión futura se ignora en vez de interpretarse a medias: mejor\n\t\t\t// re-emparejar que enrutar mensajes con un formato que no entendemos.\n\t\t\tif (leido?.version === 1) this.estado = { ...VACIO, ...leido };\n\t\t} catch {\n\t\t\t// Fichero corrupto: se arranca limpio en vez de impedir el arranque.\n\t\t}\n\t}\n\n\tprivate guardar(): void {\n\t\tmkdirSync(dirname(this.path), { recursive: true });\n\t\tconst tmp = `${this.path}.tmp`;\n\t\t// Escritura atómica: un corte a mitad no puede dejar un estado ilegible\n\t\t// que obligue a re-emparejar.\n\t\twriteFileSync(tmp, JSON.stringify(this.estado, null, 2), { mode: 0o600 });\n\t\t// `mode` solo se aplica al CREAR: si un corte anterior dejó el temporal con\n\t\t// permisos laxos, el rename se los pasaría al estado definitivo.\n\t\tchmodSync(tmp, 0o600);\n\t\trenameSync(tmp, this.path);\n\t}\n\n\tsnapshot(): EstadoTelegram {\n\t\tthis.cargar();\n\t\treturn { ...this.estado };\n\t}\n\n\t/** Offset para `getUpdates`: la siguiente a la última procesada. */\n\toffset(): number {\n\t\tthis.cargar();\n\t\treturn this.estado.lastUpdateId > 0 ? this.estado.lastUpdateId + 1 : 0;\n\t}\n\n\t/**\n\t * Marca una actualización como procesada. Se llama SIEMPRE después de\n\t * haberla atendido, nunca antes: ese es el contrato que evita perderla.\n\t */\n\tconfirmar(updateId: number): void {\n\t\tthis.cargar();\n\t\tif (updateId <= this.estado.lastUpdateId) return; // duplicado o reintento\n\t\tthis.estado.lastUpdateId = updateId;\n\t\tthis.guardar();\n\t}\n\n\t/** True si esa actualización ya se atendió (reentrega tras un fallo). */\n\tyaProcesada(updateId: number): boolean {\n\t\tthis.cargar();\n\t\treturn updateId <= this.estado.lastUpdateId;\n\t}\n\n\temparejar(userId: number, chatId: number): void {\n\t\tthis.cargar();\n\t\tthis.estado.allowedUserId = userId;\n\t\tthis.estado.chatId = chatId;\n\t\tthis.estado.pairedAt = new Date().toISOString();\n\t\tthis.guardar();\n\t}\n\n\tdesemparejar(): void {\n\t\tthis.cargar();\n\t\tthis.estado.allowedUserId = undefined;\n\t\tthis.estado.chatId = undefined;\n\t\tthis.estado.sessionId = undefined;\n\t\tthis.estado.pairedAt = undefined;\n\t\tthis.guardar();\n\t}\n\n\tfijarSesion(sessionId: string | undefined): void {\n\t\tthis.cargar();\n\t\tthis.estado.sessionId = sessionId;\n\t\tthis.guardar();\n\t}\n}\n\nexport type Veredicto =\n\t| { permitido: true; primerEmparejamiento: boolean }\n\t| { permitido: false; motivo: \"sin-usuario\" | \"otro-usuario\" | \"es-bot\" };\n\n/**\n * Decide si un mensaje puede actuar sobre la máquina.\n *\n * Se empareja el PRIMERO que escribe y se rechaza a todos los demás en\n * silencio-hacia-fuera (se responde, pero no se ejecuta nada). Rechazar sin\n * responder sería peor: quien se equivoca de bot merece saberlo, y quien\n * intenta colarse ya sabe que el bot existe.\n */\nexport function autorizar(estado: EstadoTelegram, from: { id: number; is_bot?: boolean } | undefined): Veredicto {\n\tif (!from) return { permitido: false, motivo: \"sin-usuario\" };\n\t// Un bot escribiendo a otro bot es un bucle o un intento de abuso.\n\tif (from.is_bot) return { permitido: false, motivo: \"es-bot\" };\n\tif (estado.allowedUserId === undefined) return { permitido: true, primerEmparejamiento: true };\n\tif (estado.allowedUserId === from.id) return { permitido: true, primerEmparejamiento: false };\n\treturn { permitido: false, motivo: \"otro-usuario\" };\n}\n"]}

package/dist/telegram/servidor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Adaptador del puente contra el servidor de sesiones residentes.
+ *
+ * Aquí vive la ventaja arquitectónica frente al paquete de referencia: como
+ * `ada-cli serve` es el único dueño del transporte, el puente NO necesita bus
+ * leader/follower, locks de propiedad, epochs ni heartbeats. Se conecta como un
+ * cliente más.
+ *
+ * Y como el servidor conoce TODAS las sesiones, desde Telegram se puede elegir
+ * cuál usar — no solo "la activa del proceso", que es a lo único que llega una
+ * extensión atrapada dentro de un TUI.
+ */
+import type { PuenteServidor } from "./bridge.ts";
+export declare function crearServidorPuente(socketPath: string): Promise<PuenteServidor>;
+//# sourceMappingURL=servidor.d.ts.map

package/dist/telegram/servidor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servidor.d.ts","sourceRoot":"","sources":["../../src/telegram/servidor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6DrF","sourcesContent":["/**\n * Adaptador del puente contra el servidor de sesiones residentes.\n *\n * Aquí vive la ventaja arquitectónica frente al paquete de referencia: como\n * `ada-cli serve` es el único dueño del transporte, el puente NO necesita bus\n * leader/follower, locks de propiedad, epochs ni heartbeats. Se conecta como un\n * cliente más.\n *\n * Y como el servidor conoce TODAS las sesiones, desde Telegram se puede elegir\n * cuál usar — no solo \"la activa del proceso\", que es a lo único que llega una\n * extensión atrapada dentro de un TUI.\n */\n\nimport { renderIncremental } from \"../server/attach.ts\";\nimport type { PuenteServidor } from \"./bridge.ts\";\n\n/** Cuánto se espera a que un turno se asiente antes de rendirse. */\nconst TIMEOUT_TURNO_MS = 10 * 60 * 1000;\n\nexport async function crearServidorPuente(socketPath: string): Promise<PuenteServidor> {\n\tconst { PiClient } = await import(\"@earendil-works/pi-client\");\n\tconst { createUnixTransportFactory } = await import(\"@earendil-works/pi-client/unix\");\n\tconst { runExtensionOp } = await import(\"../server/extension-ops.ts\");\n\n\tconst nuevoCliente = () => new PiClient({ transportFactory: createUnixTransportFactory({ path: socketPath }) });\n\n\treturn {\n\t\tasync listarSesiones() {\n\t\t\tconst cliente = nuevoCliente();\n\t\t\ttry {\n\t\t\t\tawait cliente.connect();\n\t\t\t\tconst sesiones = await cliente.listSessions();\n\t\t\t\treturn sesiones.map((s) => ({ id: s.id, name: s.sessionName }));\n\t\t\t} finally {\n\t\t\t\tawait cliente.dispose().catch(() => {});\n\t\t\t}\n\t\t},\n\n\t\tasync enviarPrompt(sessionId, texto) {\n\t\t\tconst cliente = nuevoCliente();\n\t\t\ttry {\n\t\t\t\tawait cliente.connect();\n\t\t\t\t// Sin sesión elegida se crea una: es más útil que rechazar el mensaje\n\t\t\t\t// y obligar a abrir el portátil para poder empezar.\n\t\t\t\tconst lease = sessionId ? await cliente.attachSession(sessionId) : await cliente.createSession({});\n\n\t\t\t\t// Se parte del transcript ACTUAL para no reenviar por Telegram lo que\n\t\t\t\t// ya se dijo antes de este prompt.\n\t\t\t\tlet yaVisto = lease.snapshot?.transcript.length ?? 0;\n\t\t\t\tconst nuevas: string[] = [];\n\n\t\t\t\tconst listo = new Promise<void>((resolve) => {\n\t\t\t\t\tconst temporizador = setTimeout(resolve, TIMEOUT_TURNO_MS);\n\t\t\t\t\tconst cancelar = lease.subscribe((snapshot) => {\n\t\t\t\t\t\tconst { text, rendered } = renderIncremental(snapshot, yaVisto);\n\t\t\t\t\t\tyaVisto = rendered;\n\t\t\t\t\t\tif (text.trim()) nuevas.push(text);\n\t\t\t\t\t\t// `idle` marca el turno asentado. Sin esperarlo, la respuesta\n\t\t\t\t\t\t// llegaría a Telegram a medias.\n\t\t\t\t\t\tif (snapshot.phase === \"idle\") {\n\t\t\t\t\t\t\tclearTimeout(temporizador);\n\t\t\t\t\t\t\tcancelar();\n\t\t\t\t\t\t\tresolve();\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t});\n\n\t\t\t\tawait lease.prompt(texto);\n\t\t\t\tawait listo;\n\t\t\t\tawait lease.detach().catch(() => {});\n\t\t\t\treturn nuevas.join(\"\\n\").trim();\n\t\t\t} finally {\n\t\t\t\tawait cliente.dispose().catch(() => {});\n\t\t\t}\n\t\t},\n\n\t\tasync operar(sessionId, op, payload) {\n\t\t\treturn runExtensionOp({ socketPath, op, sessionId, payload });\n\t\t},\n\t};\n}\n"]}