@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/server/serve.js

@@ -0,0 +1,83 @@
+/**
+ * `ada serve` — hospeda sesiones residentes sobre un socket unix.
+ *
+ * El trabajo sobrevive al cierre del terminal: el proceso que sirve es el dueño
+ * de la ejecución, y los clientes se enganchan y desenganchan por encima.
+ *
+ * Todo el acoplamiento a `packages/server` (que upstream marca como
+ * experimental) vive aquí y en `pi-server-service.ts`. Si cambia una firma, se
+ * arregla en dos ficheros nuestros y en ningún otro sitio — que es exactamente
+ * la razón de adaptarse a esa interfaz en vez de construir un demonio propio.
+ */
+import { mkdir, rm, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { createUnixServer } from "@earendil-works/pi-server/unix";
+import { killTrackedDetachedChildren } from "../utils/shell.js";
+/** Socket por defecto, dentro del agentDir para respetar ADA_CLI_CODING_AGENT_DIR. */
+export function defaultSocketPath(agentDir) {
+    return join(agentDir, "server.sock");
+}
+/**
+ * Un socket huérfano de un proceso muerto impide escuchar en la misma ruta.
+ * Solo se borra si NADIE responde: si hay un servidor vivo detrás, se respeta y
+ * se falla claro, porque borrarlo dejaría al otro servidor inalcanzable.
+ */
+async function clearStaleSocket(socketPath) {
+    try {
+        await stat(socketPath);
+    }
+    catch {
+        return; // no existe: nada que limpiar
+    }
+    const { createConnection } = await import("node:net");
+    const alive = await new Promise((resolve) => {
+        const socket = createConnection(socketPath);
+        const done = (value) => {
+            socket.destroy();
+            resolve(value);
+        };
+        socket.once("connect", () => done(true));
+        socket.once("error", () => done(false));
+        setTimeout(() => done(false), 500).unref?.();
+    });
+    if (alive) {
+        throw new Error(`Ya hay un servidor de Ada escuchando en ${socketPath}. Usa 'ada-cli attach' o párale primero.`);
+    }
+    await rm(socketPath, { force: true });
+}
+export async function serve(options) {
+    await mkdir(dirname(options.socketPath), { recursive: true });
+    await clearStaleSocket(options.socketPath);
+    const server = createUnixServer(options.service, {
+        path: options.socketPath,
+        // Solo el usuario: el socket da control total sobre las sesiones.
+        mode: 0o600,
+        onError: options.onError,
+    });
+    await server.start();
+    let closed = false;
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        // Los otros tres modos (print/interactive/rpc) matan los detached
+        // children —incluidas las sesiones de bash_interactivo, que se lanzan
+        // `detached: true` a propósito para sobrevivir a un Ctrl-C dentro de la
+        // conversación— en su handler de apagado. `disposeAll()` solo limpia los
+        // runtimes en memoria; sin esto, una sesión interactiva viva sobrevive al
+        // cierre de `ada-cli serve` (SIGINT/SIGTERM/SIGHUP) como huérfano real.
+        killTrackedDetachedChildren();
+        await server.close().catch(() => { });
+        await options.service.disposeAll().catch(() => { });
+        await rm(options.socketPath, { force: true }).catch(() => { });
+    };
+    // El socket debe desaparecer aunque el proceso muera por señal; si no, el
+    // siguiente arranque se encuentra una ruta ocupada por nadie.
+    for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+        process.once(signal, () => {
+            void close().then(() => process.exit(0));
+        });
+    }
+    return { socketPath: options.socketPath, close };
+}
+//# sourceMappingURL=serve.js.map

package/dist/server/serve.js.map

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

package/dist/server/transcript.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Proyección de mensajes de sesión al transcript del protocolo.
+ *
+ * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no
+ * casan es exactamente donde un turno puede desaparecer del transcript sin que
+ * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no
+ * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.
+ *
+ * Los tres desajustes reales:
+ *
+ * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo
+ *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes
+ *    propias, `pending` es streaming, y `deferred` — que no existe en el
+ *    protocolo — se trata como streaming, porque semánticamente el turno
+ *    todavía no ha terminado.
+ *
+ * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el
+ *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el
+ *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una
+ *    dependencia entre mensajes, no una conversión local.
+ *
+ * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de
+ *    forma estable a partir de la posición para que dos snapshots consecutivos
+ *    del mismo transcript den los mismos ids.
+ */
+import type { Message } from "@earendil-works/pi-ai";
+import type { TranscriptItem } from "@earendil-works/pi-protocol";
+/** Id estable por posición: el mismo transcript da siempre los mismos ids. */
+export declare function itemId(index: number): string;
+/**
+ * Proyecta el transcript completo.
+ *
+ * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo
+ * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna
+ * variante, se degrada a algo válido antes que desaparecer.
+ */
+export declare function projectTranscript(messages: readonly Message[]): TranscriptItem[];
+//# sourceMappingURL=transcript.d.ts.map

package/dist/server/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/server/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAEX,OAAO,EAIP,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAGX,cAAc,EAGd,MAAM,6BAA6B,CAAC;AAErC,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAsHD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,EAAE,CA6BhF"}

package/dist/server/transcript.js

@@ -0,0 +1,176 @@
+/**
+ * Proyección de mensajes de sesión al transcript del protocolo.
+ *
+ * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no
+ * casan es exactamente donde un turno puede desaparecer del transcript sin que
+ * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no
+ * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.
+ *
+ * Los tres desajustes reales:
+ *
+ * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo
+ *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes
+ *    propias, `pending` es streaming, y `deferred` — que no existe en el
+ *    protocolo — se trata como streaming, porque semánticamente el turno
+ *    todavía no ha terminado.
+ *
+ * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el
+ *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el
+ *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una
+ *    dependencia entre mensajes, no una conversión local.
+ *
+ * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de
+ *    forma estable a partir de la posición para que dos snapshots consecutivos
+ *    del mismo transcript den los mismos ids.
+ */
+/** Id estable por posición: el mismo transcript da siempre los mismos ids. */
+export function itemId(index) {
+    return `item-${index}`;
+}
+function toUsage(usage) {
+    if (!usage)
+        return undefined;
+    return {
+        input: Math.max(0, Math.trunc(usage.input ?? 0)),
+        output: Math.max(0, Math.trunc(usage.output ?? 0)),
+        cacheRead: Math.max(0, Math.trunc(usage.cacheRead ?? 0)),
+        cacheWrite: Math.max(0, Math.trunc(usage.cacheWrite ?? 0)),
+        ...(usage.reasoning !== undefined ? { reasoning: Math.max(0, Math.trunc(usage.reasoning)) } : {}),
+        totalTokens: Math.max(0, Math.trunc(usage.totalTokens ?? 0)),
+        cost: {
+            input: usage.cost?.input ?? 0,
+            output: usage.cost?.output ?? 0,
+            cacheRead: usage.cost?.cacheRead ?? 0,
+            cacheWrite: usage.cost?.cacheWrite ?? 0,
+            total: usage.cost?.total ?? 0,
+        },
+    };
+}
+function timestampOf(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;
+}
+function projectUser(message, index) {
+    const content = typeof message.content === "string"
+        ? [{ type: "text", text: message.content }]
+        : message.content.map((block) => block.type === "image"
+            ? { type: "image", data: block.data, mimeType: block.mimeType }
+            : { type: "text", text: block.text ?? "" });
+    return { id: itemId(index), role: "user", content, timestamp: timestampOf(message.timestamp) };
+}
+function projectAssistant(message, index) {
+    const content = message.content.map((block) => {
+        if (block.type === "toolCall") {
+            // Renombrado real: id/name/arguments → toolCallId/toolName/input.
+            return {
+                type: "toolCall",
+                toolCallId: block.id,
+                toolName: block.name,
+                input: (block.arguments ?? {}),
+            };
+        }
+        if (block.type === "thinking") {
+            return {
+                type: "thinking",
+                thinking: block.thinking ?? "",
+                ...(block.redacted !== undefined ? { redacted: Boolean(block.redacted) } : {}),
+            };
+        }
+        return { type: "text", text: block.text ?? "" };
+    });
+    const base = {
+        id: itemId(index),
+        role: "assistant",
+        content,
+        model: { provider: message.provider ?? "unknown", id: message.model ?? "unknown" },
+        ...(message.responseModel ? { responseModel: message.responseModel } : {}),
+        ...(toUsage(message.usage) ? { usage: toUsage(message.usage) } : {}),
+        timestamp: timestampOf(message.timestamp),
+    };
+    switch (message.stopReason) {
+        case "stop":
+        case "length":
+        case "toolUse":
+            return { ...base, status: "complete", stopReason: message.stopReason };
+        case "error":
+            return {
+                ...base,
+                status: "error",
+                stopReason: "error",
+                ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+            };
+        case "aborted":
+            return {
+                ...base,
+                status: "aborted",
+                stopReason: "aborted",
+                ...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),
+            };
+        default:
+            // `pending` y `deferred`: el turno aún no ha cerrado. `deferred` no
+            // existe en el protocolo — tratarlo como streaming es lo único que no
+            // pierde el mensaje ni miente sobre su estado.
+            return { ...base, status: "streaming" };
+    }
+}
+function projectTool(message, index, input) {
+    const content = message.content.map((block) => block.type === "image"
+        ? { type: "image", data: block.data, mimeType: block.mimeType }
+        : { type: "text", text: block.text ?? "" });
+    const base = {
+        id: itemId(index),
+        role: "tool",
+        toolCallId: message.toolCallId,
+        toolName: message.toolName,
+        // El resultado NO trae los argumentos: vienen del ToolCall correlacionado.
+        input: (input ?? {}),
+        content,
+        ...(message.details !== undefined ? { details: message.details } : {}),
+        ...(toUsage(message.usage) ? { usage: toUsage(message.usage) } : {}),
+        timestamp: timestampOf(message.timestamp),
+    };
+    return message.isError
+        ? { ...base, status: "error", isError: true }
+        : { ...base, status: "complete", isError: false };
+}
+/**
+ * Proyecta el transcript completo.
+ *
+ * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo
+ * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna
+ * variante, se degrada a algo válido antes que desaparecer.
+ */
+export function projectTranscript(messages) {
+    // Primera pasada: índice de argumentos por toolCallId, para el punto 2.
+    const inputs = new Map();
+    for (const message of messages) {
+        if (message.role !== "assistant")
+            continue;
+        for (const block of message.content) {
+            if (block.type === "toolCall")
+                inputs.set(block.id, block.arguments ?? {});
+        }
+    }
+    const items = [];
+    messages.forEach((message, index) => {
+        if (message.role === "user")
+            items.push(projectUser(message, index));
+        else if (message.role === "assistant")
+            items.push(projectAssistant(message, index));
+        else if (message.role === "toolResult")
+            items.push(projectTool(message, index, inputs.get(message.toolCallId)));
+        // Sin `else`: cualquier rol desconocido se ignoraría en silencio. Se
+        // gestiona abajo para que el invariante siga siendo comprobable.
+        else {
+            items.push({
+                id: itemId(index),
+                role: "user",
+                content: [
+                    { type: "text", text: `[mensaje no reconocido: ${String(message.role)}]` },
+                ],
+                timestamp: timestampOf(message.timestamp),
+            });
+        }
+    });
+    return items;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/server/transcript.js.map

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

package/dist/telegram/api.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Cliente de la Bot API de Telegram. Sin dependencias.
+ *
+ * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`
+ * por la misma razón que el resto del producto evita dependencias: es un CLI
+ * que se instala en máquinas ajenas, y cada paquete añadido es superficie de
+ * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio
+ * cabe en un fichero.
+ *
+ * El long polling es la única forma sensata aquí: un webhook exigiría exponer un
+ * puerto público desde el portátil de alguien.
+ */
+export interface TelegramUser {
+    id: number;
+    is_bot?: boolean;
+    username?: string;
+    first_name?: string;
+}
+export interface TelegramMessage {
+    message_id: number;
+    from?: TelegramUser;
+    chat: {
+        id: number;
+        type: string;
+    };
+    text?: string;
+    date: number;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    callback_query?: {
+        id: string;
+        from: TelegramUser;
+        data?: string;
+        message?: TelegramMessage;
+    };
+}
+export interface ApiOptions {
+    token: string;
+    fetchImpl?: typeof fetch;
+    /** Segundos que el servidor retiene la petición sin novedades. */
+    longPollSeconds?: number;
+}
+export declare class TelegramApiError extends Error {
+    method: string;
+    status: number;
+    description: string;
+    /** Segundos que Telegram pide esperar (429). */
+    retryAfter?: number;
+    constructor(method: string, status: number, description: string, retryAfter?: number);
+}
+export declare class TelegramApi {
+    private token;
+    private fetchImpl;
+    private longPollSeconds;
+    constructor(options: ApiOptions);
+    /**
+     * Llama a un método de la Bot API.
+     *
+     * El token va en la URL porque así lo define Telegram; por eso `toString()`
+     * de esta clase y cualquier traza deben evitar imprimir la URL entera.
+     */
+    private call;
+    /** Identidad del bot. Sirve para validar el token antes de hacer nada. */
+    getMe(signal?: AbortSignal): Promise<TelegramUser>;
+    /**
+     * Long poll. `offset` confirma como recibidas todas las actualizaciones
+     * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.
+     */
+    getUpdates(offset: number, signal?: AbortSignal): Promise<TelegramUpdate[]>;
+    sendMessage(chatId: number, text: string, options?: {
+        replyTo?: number;
+    }): Promise<TelegramMessage>;
+    editMessage(chatId: number, messageId: number, text: string): Promise<unknown>;
+    /** Indicador de "escribiendo…". Caduca solo a los ~5 s. */
+    sendTyping(chatId: number): Promise<unknown>;
+}
+/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */
+export declare function splitForTelegram(text: string, limit?: number): string[];
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/telegram/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC;CAC9F;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAQpF;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,UAAU;IAM/B;;;;;OAKG;YACW,IAAI;IAwBlB,0EAA0E;IAC1E,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIlD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ3E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAWvG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E,2DAA2D;IAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5C;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,MAAM,EAAE,CAcrE"}

package/dist/telegram/api.js

@@ -0,0 +1,104 @@
+/**
+ * Cliente de la Bot API de Telegram. Sin dependencias.
+ *
+ * Se habla HTTP directamente en vez de traer `grammy` o `node-telegram-bot-api`
+ * por la misma razón que el resto del producto evita dependencias: es un CLI
+ * que se instala en máquinas ajenas, y cada paquete añadido es superficie de
+ * suministro que no controlamos. La Bot API es JSON sobre HTTPS; el envoltorio
+ * cabe en un fichero.
+ *
+ * El long polling es la única forma sensata aquí: un webhook exigiría exponer un
+ * puerto público desde el portátil de alguien.
+ */
+const BASE = "https://api.telegram.org";
+export class TelegramApiError extends Error {
+    method;
+    status;
+    description;
+    /** Segundos que Telegram pide esperar (429). */
+    retryAfter;
+    constructor(method, status, description, retryAfter) {
+        super(`${method}: ${description} (HTTP ${status})`);
+        this.name = "TelegramApiError";
+        this.method = method;
+        this.status = status;
+        this.description = description;
+        this.retryAfter = retryAfter;
+    }
+}
+export class TelegramApi {
+    token;
+    fetchImpl;
+    longPollSeconds;
+    constructor(options) {
+        this.token = options.token;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.longPollSeconds = options.longPollSeconds ?? 25;
+    }
+    /**
+     * Llama a un método de la Bot API.
+     *
+     * El token va en la URL porque así lo define Telegram; por eso `toString()`
+     * de esta clase y cualquier traza deben evitar imprimir la URL entera.
+     */
+    async call(method, params, signal) {
+        const response = await this.fetchImpl(`${BASE}/bot${this.token}/${method}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(params),
+            signal,
+        });
+        const body = (await response.json().catch(() => ({})));
+        if (!response.ok || !body.ok) {
+            throw new TelegramApiError(method, response.status, body.description ?? "sin descripción", body.parameters?.retry_after);
+        }
+        return body.result;
+    }
+    /** Identidad del bot. Sirve para validar el token antes de hacer nada. */
+    getMe(signal) {
+        return this.call("getMe", {}, signal);
+    }
+    /**
+     * Long poll. `offset` confirma como recibidas todas las actualizaciones
+     * ANTERIORES — por eso quien llama solo debe avanzarlo tras persistir.
+     */
+    getUpdates(offset, signal) {
+        return this.call("getUpdates", { offset, timeout: this.longPollSeconds, allowed_updates: ["message", "callback_query"] }, signal);
+    }
+    sendMessage(chatId, text, options = {}) {
+        return this.call("sendMessage", {
+            chat_id: chatId,
+            text,
+            // Sin parse_mode: el texto del agente puede contener Markdown roto o
+            // caracteres que Telegram rechazaría, y un 400 por formato perdería el
+            // mensaje entero. Texto plano siempre llega.
+            ...(options.replyTo ? { reply_to_message_id: options.replyTo } : {}),
+        });
+    }
+    editMessage(chatId, messageId, text) {
+        return this.call("editMessageText", { chat_id: chatId, message_id: messageId, text });
+    }
+    /** Indicador de "escribiendo…". Caduca solo a los ~5 s. */
+    sendTyping(chatId) {
+        return this.call("sendChatAction", { chat_id: chatId, action: "typing" }).catch(() => undefined);
+    }
+}
+/** Trocea respetando saltos de línea; Telegram corta a 4096 caracteres. */
+export function splitForTelegram(text, limit = 4000) {
+    if (text.length <= limit)
+        return [text];
+    const partes = [];
+    let resto = text;
+    while (resto.length > limit) {
+        // Se corta en el último salto de línea que quepa para no partir una
+        // palabra ni un bloque de código por la mitad.
+        const corte = resto.lastIndexOf("\n", limit);
+        const en = corte > limit * 0.5 ? corte : limit;
+        partes.push(resto.slice(0, en));
+        resto = resto.slice(en).replace(/^\n/, "");
+    }
+    if (resto)
+        partes.push(resto);
+    return partes;
+}
+//# sourceMappingURL=api.js.map

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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"}

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,gEAAgE;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,8DAA8D;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;gBAE7B,QAAQ,EAAE,cAAc;IAOpC,sEAAsE;IAChE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;YAoBnC,SAAS;YAMT,OAAO;YAsBP,OAAO;YAgEP,MAAM;CAQpB"}