@hoilab/ada-cli 0.84.22 → 0.85.0

package/dist/server/serve.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `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 type { AdaServerService } from "./pi-server-service.ts";
+/** Socket por defecto, dentro del agentDir para respetar ADA_CLI_CODING_AGENT_DIR. */
+export declare function defaultSocketPath(agentDir: string): string;
+export interface ServeOptions {
+    service: AdaServerService;
+    socketPath: string;
+    onError?: (error: Error) => void;
+}
+export interface ServeHandle {
+    socketPath: string;
+    close(): Promise<void>;
+}
+export declare function serve(options: ServeOptions): Promise<ServeHandle>;
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AA8BD,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqCvE","sourcesContent":["/**\n * `ada serve` — hospeda sesiones residentes sobre un socket unix.\n *\n * El trabajo sobrevive al cierre del terminal: el proceso que sirve es el dueño\n * de la ejecución, y los clientes se enganchan y desenganchan por encima.\n *\n * Todo el acoplamiento a `packages/server` (que upstream marca como\n * experimental) vive aquí y en `pi-server-service.ts`. Si cambia una firma, se\n * arregla en dos ficheros nuestros y en ningún otro sitio — que es exactamente\n * la razón de adaptarse a esa interfaz en vez de construir un demonio propio.\n */\n\nimport { mkdir, rm, stat } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport { createUnixServer } from \"@earendil-works/pi-server/unix\";\nimport { killTrackedDetachedChildren } from \"../utils/shell.ts\";\nimport type { AdaServerService } from \"./pi-server-service.ts\";\n\n/** Socket por defecto, dentro del agentDir para respetar ADA_CLI_CODING_AGENT_DIR. */\nexport function defaultSocketPath(agentDir: string): string {\n\treturn join(agentDir, \"server.sock\");\n}\n\nexport interface ServeOptions {\n\tservice: AdaServerService;\n\tsocketPath: string;\n\tonError?: (error: Error) => void;\n}\n\nexport interface ServeHandle {\n\tsocketPath: string;\n\tclose(): Promise<void>;\n}\n\n/**\n * Un socket huérfano de un proceso muerto impide escuchar en la misma ruta.\n * Solo se borra si NADIE responde: si hay un servidor vivo detrás, se respeta y\n * se falla claro, porque borrarlo dejaría al otro servidor inalcanzable.\n */\nasync function clearStaleSocket(socketPath: string): Promise<void> {\n\ttry {\n\t\tawait stat(socketPath);\n\t} catch {\n\t\treturn; // no existe: nada que limpiar\n\t}\n\tconst { createConnection } = await import(\"node:net\");\n\tconst alive = await new Promise<boolean>((resolve) => {\n\t\tconst socket = createConnection(socketPath);\n\t\tconst done = (value: boolean) => {\n\t\t\tsocket.destroy();\n\t\t\tresolve(value);\n\t\t};\n\t\tsocket.once(\"connect\", () => done(true));\n\t\tsocket.once(\"error\", () => done(false));\n\t\tsetTimeout(() => done(false), 500).unref?.();\n\t});\n\tif (alive) {\n\t\tthrow new Error(`Ya hay un servidor de Ada escuchando en ${socketPath}. Usa 'ada-cli attach' o párale primero.`);\n\t}\n\tawait rm(socketPath, { force: true });\n}\n\nexport async function serve(options: ServeOptions): Promise<ServeHandle> {\n\tawait mkdir(dirname(options.socketPath), { recursive: true });\n\tawait clearStaleSocket(options.socketPath);\n\n\tconst server = createUnixServer(options.service, {\n\t\tpath: options.socketPath,\n\t\t// Solo el usuario: el socket da control total sobre las sesiones.\n\t\tmode: 0o600,\n\t\tonError: options.onError,\n\t});\n\tawait server.start();\n\n\tlet closed = false;\n\tconst close = async (): Promise<void> => {\n\t\tif (closed) return;\n\t\tclosed = true;\n\t\t// Los otros tres modos (print/interactive/rpc) matan los detached\n\t\t// children —incluidas las sesiones de bash_interactivo, que se lanzan\n\t\t// `detached: true` a propósito para sobrevivir a un Ctrl-C dentro de la\n\t\t// conversación— en su handler de apagado. `disposeAll()` solo limpia los\n\t\t// runtimes en memoria; sin esto, una sesión interactiva viva sobrevive al\n\t\t// cierre de `ada-cli serve` (SIGINT/SIGTERM/SIGHUP) como huérfano real.\n\t\tkillTrackedDetachedChildren();\n\t\tawait server.close().catch(() => {});\n\t\tawait options.service.disposeAll().catch(() => {});\n\t\tawait rm(options.socketPath, { force: true }).catch(() => {});\n\t};\n\n\t// El socket debe desaparecer aunque el proceso muera por señal; si no, el\n\t// siguiente arranque se encuentra una ruta ocupada por nadie.\n\tfor (const signal of [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const) {\n\t\tprocess.once(signal, () => {\n\t\t\tvoid close().then(() => process.exit(0));\n\t\t});\n\t}\n\n\treturn { socketPath: options.socketPath, close };\n}\n"]}

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

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,+EAA8E;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","sourcesContent":["/**\n * Proyección de mensajes de sesión al transcript del protocolo.\n *\n * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no\n * casan es exactamente donde un turno puede desaparecer del transcript sin que\n * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no\n * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.\n *\n * Los tres desajustes reales:\n *\n * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo\n *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes\n *    propias, `pending` es streaming, y `deferred` — que no existe en el\n *    protocolo — se trata como streaming, porque semánticamente el turno\n *    todavía no ha terminado.\n *\n * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el\n *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el\n *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una\n *    dependencia entre mensajes, no una conversión local.\n *\n * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de\n *    forma estable a partir de la posición para que dos snapshots consecutivos\n *    del mismo transcript den los mismos ids.\n */\n\nimport type {\n\tAssistantMessage,\n\tMessage,\n\tUsage as SourceUsage,\n\tToolResultMessage,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tAssistantTranscriptItem,\n\tToolTranscriptItem,\n\tTranscriptItem,\n\tUsage,\n\tUserTranscriptItem,\n} from \"@earendil-works/pi-protocol\";\n\n/** Id estable por posición: el mismo transcript da siempre los mismos ids. */\nexport function itemId(index: number): string {\n\treturn `item-${index}`;\n}\n\nfunction toUsage(usage: SourceUsage | undefined): Usage | undefined {\n\tif (!usage) return undefined;\n\treturn {\n\t\tinput: Math.max(0, Math.trunc(usage.input ?? 0)),\n\t\toutput: Math.max(0, Math.trunc(usage.output ?? 0)),\n\t\tcacheRead: Math.max(0, Math.trunc(usage.cacheRead ?? 0)),\n\t\tcacheWrite: Math.max(0, Math.trunc(usage.cacheWrite ?? 0)),\n\t\t...(usage.reasoning !== undefined ? { reasoning: Math.max(0, Math.trunc(usage.reasoning)) } : {}),\n\t\ttotalTokens: Math.max(0, Math.trunc(usage.totalTokens ?? 0)),\n\t\tcost: {\n\t\t\tinput: usage.cost?.input ?? 0,\n\t\t\toutput: usage.cost?.output ?? 0,\n\t\t\tcacheRead: usage.cost?.cacheRead ?? 0,\n\t\t\tcacheWrite: usage.cost?.cacheWrite ?? 0,\n\t\t\ttotal: usage.cost?.total ?? 0,\n\t\t},\n\t};\n}\n\nfunction timestampOf(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;\n}\n\nfunction projectUser(message: UserMessage, index: number): UserTranscriptItem {\n\tconst content =\n\t\ttypeof message.content === \"string\"\n\t\t\t? [{ type: \"text\" as const, text: message.content }]\n\t\t\t: message.content.map((block) =>\n\t\t\t\t\tblock.type === \"image\"\n\t\t\t\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t\t\t\t);\n\treturn { id: itemId(index), role: \"user\", content, timestamp: timestampOf(message.timestamp) };\n}\n\nfunction projectAssistant(message: AssistantMessage, index: number): AssistantTranscriptItem {\n\tconst content = message.content.map((block) => {\n\t\tif (block.type === \"toolCall\") {\n\t\t\t// Renombrado real: id/name/arguments → toolCallId/toolName/input.\n\t\t\treturn {\n\t\t\t\ttype: \"toolCall\" as const,\n\t\t\t\ttoolCallId: block.id,\n\t\t\t\ttoolName: block.name,\n\t\t\t\tinput: (block.arguments ?? {}) as never,\n\t\t\t};\n\t\t}\n\t\tif (block.type === \"thinking\") {\n\t\t\treturn {\n\t\t\t\ttype: \"thinking\" as const,\n\t\t\t\tthinking: block.thinking ?? \"\",\n\t\t\t\t...(block.redacted !== undefined ? { redacted: Boolean(block.redacted) } : {}),\n\t\t\t};\n\t\t}\n\t\treturn { type: \"text\" as const, text: block.text ?? \"\" };\n\t});\n\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"assistant\" as const,\n\t\tcontent,\n\t\tmodel: { provider: message.provider ?? \"unknown\", id: message.model ?? \"unknown\" },\n\t\t...(message.responseModel ? { responseModel: message.responseModel } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\n\tswitch (message.stopReason) {\n\t\tcase \"stop\":\n\t\tcase \"length\":\n\t\tcase \"toolUse\":\n\t\t\treturn { ...base, status: \"complete\", stopReason: message.stopReason };\n\t\tcase \"error\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"error\",\n\t\t\t\tstopReason: \"error\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tcase \"aborted\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"aborted\",\n\t\t\t\tstopReason: \"aborted\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tdefault:\n\t\t\t// `pending` y `deferred`: el turno aún no ha cerrado. `deferred` no\n\t\t\t// existe en el protocolo — tratarlo como streaming es lo único que no\n\t\t\t// pierde el mensaje ni miente sobre su estado.\n\t\t\treturn { ...base, status: \"streaming\" };\n\t}\n}\n\nfunction projectTool(message: ToolResultMessage, index: number, input: unknown): ToolTranscriptItem {\n\tconst content = message.content.map((block) =>\n\t\tblock.type === \"image\"\n\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t);\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"tool\" as const,\n\t\ttoolCallId: message.toolCallId,\n\t\ttoolName: message.toolName,\n\t\t// El resultado NO trae los argumentos: vienen del ToolCall correlacionado.\n\t\tinput: (input ?? {}) as never,\n\t\tcontent,\n\t\t...(message.details !== undefined ? { details: message.details as never } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\treturn message.isError\n\t\t? { ...base, status: \"error\", isError: true }\n\t\t: { ...base, status: \"complete\", isError: false };\n}\n\n/**\n * Proyecta el transcript completo.\n *\n * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo\n * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna\n * variante, se degrada a algo válido antes que desaparecer.\n */\nexport function projectTranscript(messages: readonly Message[]): TranscriptItem[] {\n\t// Primera pasada: índice de argumentos por toolCallId, para el punto 2.\n\tconst inputs = new Map<string, unknown>();\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type === \"toolCall\") inputs.set(block.id, block.arguments ?? {});\n\t\t}\n\t}\n\n\tconst items: TranscriptItem[] = [];\n\tmessages.forEach((message, index) => {\n\t\tif (message.role === \"user\") items.push(projectUser(message, index));\n\t\telse if (message.role === \"assistant\") items.push(projectAssistant(message, index));\n\t\telse if (message.role === \"toolResult\") items.push(projectTool(message, index, inputs.get(message.toolCallId)));\n\t\t// Sin `else`: cualquier rol desconocido se ignoraría en silencio. Se\n\t\t// gestiona abajo para que el invariante siga siendo comprobable.\n\t\telse {\n\t\t\titems.push({\n\t\t\t\tid: itemId(index),\n\t\t\t\trole: \"user\",\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: \"text\", text: `[mensaje no reconocido: ${String((message as { role?: unknown }).role)}]` },\n\t\t\t\t],\n\t\t\t\ttimestamp: timestampOf((message as { timestamp?: unknown }).timestamp),\n\t\t\t});\n\t\t}\n\t});\n\treturn items;\n}\n"]}

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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","sourcesContent":["/**\n * Proyección de mensajes de sesión al transcript del protocolo.\n *\n * Es la pieza delicada de `ada serve`: los tipos NO casan uno a uno, y donde no\n * casan es exactamente donde un turno puede desaparecer del transcript sin que\n * nadie se entere. Un `attach` que pierde turnos en silencio es peor que no\n * tener `attach`, así que aquí todo se mapea explícitamente y nada se descarta.\n *\n * Los tres desajustes reales:\n *\n * 1. `StopReason` de origen tiene 7 valores; el item `complete` del protocolo\n *    solo admite `stop|length|toolUse`. `error` y `aborted` son variantes\n *    propias, `pending` es streaming, y `deferred` — que no existe en el\n *    protocolo — se trata como streaming, porque semánticamente el turno\n *    todavía no ha terminado.\n *\n * 2. `ToolResultMessage` NO lleva los argumentos de la llamada, pero el\n *    protocolo exige `input` en cada item de tool. Hay que correlacionar con el\n *    `ToolCall` del mensaje de asistente anterior por `toolCallId`. Es una\n *    dependencia entre mensajes, no una conversión local.\n *\n * 3. Los mensajes de origen no tienen `id`; el protocolo lo exige. Se deriva de\n *    forma estable a partir de la posición para que dos snapshots consecutivos\n *    del mismo transcript den los mismos ids.\n */\n\nimport type {\n\tAssistantMessage,\n\tMessage,\n\tUsage as SourceUsage,\n\tToolResultMessage,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tAssistantTranscriptItem,\n\tToolTranscriptItem,\n\tTranscriptItem,\n\tUsage,\n\tUserTranscriptItem,\n} from \"@earendil-works/pi-protocol\";\n\n/** Id estable por posición: el mismo transcript da siempre los mismos ids. */\nexport function itemId(index: number): string {\n\treturn `item-${index}`;\n}\n\nfunction toUsage(usage: SourceUsage | undefined): Usage | undefined {\n\tif (!usage) return undefined;\n\treturn {\n\t\tinput: Math.max(0, Math.trunc(usage.input ?? 0)),\n\t\toutput: Math.max(0, Math.trunc(usage.output ?? 0)),\n\t\tcacheRead: Math.max(0, Math.trunc(usage.cacheRead ?? 0)),\n\t\tcacheWrite: Math.max(0, Math.trunc(usage.cacheWrite ?? 0)),\n\t\t...(usage.reasoning !== undefined ? { reasoning: Math.max(0, Math.trunc(usage.reasoning)) } : {}),\n\t\ttotalTokens: Math.max(0, Math.trunc(usage.totalTokens ?? 0)),\n\t\tcost: {\n\t\t\tinput: usage.cost?.input ?? 0,\n\t\t\toutput: usage.cost?.output ?? 0,\n\t\t\tcacheRead: usage.cost?.cacheRead ?? 0,\n\t\t\tcacheWrite: usage.cost?.cacheWrite ?? 0,\n\t\t\ttotal: usage.cost?.total ?? 0,\n\t\t},\n\t};\n}\n\nfunction timestampOf(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;\n}\n\nfunction projectUser(message: UserMessage, index: number): UserTranscriptItem {\n\tconst content =\n\t\ttypeof message.content === \"string\"\n\t\t\t? [{ type: \"text\" as const, text: message.content }]\n\t\t\t: message.content.map((block) =>\n\t\t\t\t\tblock.type === \"image\"\n\t\t\t\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t\t\t\t);\n\treturn { id: itemId(index), role: \"user\", content, timestamp: timestampOf(message.timestamp) };\n}\n\nfunction projectAssistant(message: AssistantMessage, index: number): AssistantTranscriptItem {\n\tconst content = message.content.map((block) => {\n\t\tif (block.type === \"toolCall\") {\n\t\t\t// Renombrado real: id/name/arguments → toolCallId/toolName/input.\n\t\t\treturn {\n\t\t\t\ttype: \"toolCall\" as const,\n\t\t\t\ttoolCallId: block.id,\n\t\t\t\ttoolName: block.name,\n\t\t\t\tinput: (block.arguments ?? {}) as never,\n\t\t\t};\n\t\t}\n\t\tif (block.type === \"thinking\") {\n\t\t\treturn {\n\t\t\t\ttype: \"thinking\" as const,\n\t\t\t\tthinking: block.thinking ?? \"\",\n\t\t\t\t...(block.redacted !== undefined ? { redacted: Boolean(block.redacted) } : {}),\n\t\t\t};\n\t\t}\n\t\treturn { type: \"text\" as const, text: block.text ?? \"\" };\n\t});\n\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"assistant\" as const,\n\t\tcontent,\n\t\tmodel: { provider: message.provider ?? \"unknown\", id: message.model ?? \"unknown\" },\n\t\t...(message.responseModel ? { responseModel: message.responseModel } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\n\tswitch (message.stopReason) {\n\t\tcase \"stop\":\n\t\tcase \"length\":\n\t\tcase \"toolUse\":\n\t\t\treturn { ...base, status: \"complete\", stopReason: message.stopReason };\n\t\tcase \"error\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"error\",\n\t\t\t\tstopReason: \"error\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tcase \"aborted\":\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"aborted\",\n\t\t\t\tstopReason: \"aborted\",\n\t\t\t\t...(message.errorMessage ? { errorMessage: message.errorMessage } : {}),\n\t\t\t};\n\t\tdefault:\n\t\t\t// `pending` y `deferred`: el turno aún no ha cerrado. `deferred` no\n\t\t\t// existe en el protocolo — tratarlo como streaming es lo único que no\n\t\t\t// pierde el mensaje ni miente sobre su estado.\n\t\t\treturn { ...base, status: \"streaming\" };\n\t}\n}\n\nfunction projectTool(message: ToolResultMessage, index: number, input: unknown): ToolTranscriptItem {\n\tconst content = message.content.map((block) =>\n\t\tblock.type === \"image\"\n\t\t\t? { type: \"image\" as const, data: block.data, mimeType: block.mimeType }\n\t\t\t: { type: \"text\" as const, text: block.text ?? \"\" },\n\t);\n\tconst base = {\n\t\tid: itemId(index),\n\t\trole: \"tool\" as const,\n\t\ttoolCallId: message.toolCallId,\n\t\ttoolName: message.toolName,\n\t\t// El resultado NO trae los argumentos: vienen del ToolCall correlacionado.\n\t\tinput: (input ?? {}) as never,\n\t\tcontent,\n\t\t...(message.details !== undefined ? { details: message.details as never } : {}),\n\t\t...(toUsage(message.usage) ? { usage: toUsage(message.usage) as Usage } : {}),\n\t\ttimestamp: timestampOf(message.timestamp),\n\t};\n\treturn message.isError\n\t\t? { ...base, status: \"error\", isError: true }\n\t\t: { ...base, status: \"complete\", isError: false };\n}\n\n/**\n * Proyecta el transcript completo.\n *\n * INVARIANTE: devuelve exactamente un item por mensaje de entrada, en el mismo\n * orden. Nada se filtra ni se colapsa — si un mensaje no encaja en ninguna\n * variante, se degrada a algo válido antes que desaparecer.\n */\nexport function projectTranscript(messages: readonly Message[]): TranscriptItem[] {\n\t// Primera pasada: índice de argumentos por toolCallId, para el punto 2.\n\tconst inputs = new Map<string, unknown>();\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const block of message.content) {\n\t\t\tif (block.type === \"toolCall\") inputs.set(block.id, block.arguments ?? {});\n\t\t}\n\t}\n\n\tconst items: TranscriptItem[] = [];\n\tmessages.forEach((message, index) => {\n\t\tif (message.role === \"user\") items.push(projectUser(message, index));\n\t\telse if (message.role === \"assistant\") items.push(projectAssistant(message, index));\n\t\telse if (message.role === \"toolResult\") items.push(projectTool(message, index, inputs.get(message.toolCallId)));\n\t\t// Sin `else`: cualquier rol desconocido se ignoraría en silencio. Se\n\t\t// gestiona abajo para que el invariante siga siendo comprobable.\n\t\telse {\n\t\t\titems.push({\n\t\t\t\tid: itemId(index),\n\t\t\t\trole: \"user\",\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: \"text\", text: `[mensaje no reconocido: ${String((message as { role?: unknown }).role)}]` },\n\t\t\t\t],\n\t\t\t\ttimestamp: timestampOf((message as { timestamp?: unknown }).timestamp),\n\t\t\t});\n\t\t}\n\t});\n\treturn items;\n}\n"]}

package/dist/skills/skill-creator/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: skill-creator
+description: Use when the user asks to create, write or package a new Ada skill. Covers the SKILL.md layout, the frontmatter limits Ada's loader actually enforces, where to place the file so it is discovered, and the two Ada-specific rules a skill must never break.
+---
+
+# Crear una skill de Ada
+
+Una skill es un fichero `SKILL.md` con frontmatter YAML. Ada las carga bajo
+demanda: el modelo ve el `name` y la `description` siempre, y el cuerpo solo
+cuando la invoca.
+
+## Límites que el loader impone de verdad
+
+Estos números salen de `src/core/skills.ts`, no de la especificación genérica.
+Pasarse hace que la skill se rechace con un diagnóstico que el usuario
+normalmente no ve:
+
+| Campo | Límite | Regla |
+|---|---|---|
+| `name` | 64 caracteres | **Debe coincidir con el nombre del directorio.** `skills/mi-skill/SKILL.md` → `name: mi-skill` |
+| `description` | 1024 caracteres | Es lo único que el modelo lee para decidir si la invoca |
+
+## Dónde ponerla
+
+| Ruta | Alcance |
+|---|---|
+| `.ada/agent/skills/<nombre>/SKILL.md` | Solo este proyecto (gana sobre la global) |
+| `~/.ada/agent/skills/<nombre>/SKILL.md` | Todos los proyectos |
+| `~/.agents/skills/<nombre>/SKILL.md` | Compartida con otros agentes compatibles |
+
+Precedencia: proyecto → global → paquete → builtin. Una skill de proyecto con el
+mismo nombre que una builtin la sustituye.
+
+## Escribir la descripción
+
+Es la parte que más se falla. La `description` no describe la skill: describe
+**cuándo usarla**. El modelo la lee sin haber leído el cuerpo.
+
+Mal: `Herramienta para bases de datos.`
+Bien: `Use when reviewing database migrations: checks for missing rollbacks, non-concurrent index creation, and locking DDL on large tables.`
+
+## Dos reglas que una skill de Ada NO debe romper
+
+Esto es lo específico de Ada, y no está en ningún otro sitio:
+
+1. **Nunca instruyas a un subagente para que llame a `goal_*`, `workflow` o
+   `graph_add_nodes`.** No es una convención: esas tools no existen en el
+   registro de un subagente, así que la instrucción fallaría. La orquestación
+   vive solo en la sesión principal, a propósito.
+
+2. **Nunca declares algo como hecho sin una cita `fichero:línea`.** El juez del
+   goal y los gates del grafo exigen evidencia observada. Una skill que enseñe
+   al modelo a afirmar "ya está arreglado" sin cita está enseñándole a saltarse
+   la propiedad central del producto.
+
+## Plantilla
+
+```markdown
+---
+name: revisar-migraciones
+description: Use when reviewing database migration files, before merging schema changes, or when the user mentions Alembic/Flyway/Prisma migrations. Checks rollback coverage, index concurrency and locking DDL.
+---
+
+# Revisar migraciones
+
+## Cuándo aplica
+Ficheros bajo `migrations/`, `alembic/versions/` o `prisma/migrations/`.
+
+## Pasos
+1. Comprueba que cada `up` tiene su `down`. Cita `fichero:línea` de los que no.
+2. Marca los `CREATE INDEX` sin `CONCURRENTLY` sobre tablas de >1M filas.
+3. Marca el DDL que toma un lock exclusivo en horario de producción.
+
+## Salida
+Una lista por severidad, cada hallazgo con su cita `fichero:línea`. Si no hay
+hallazgos, dilo — no rellenes.
+```
+
+## Empaquetar un workflow ya ejecutado
+
+Si lo que quieres reutilizar es un *procedimiento* que ya corrió, no escribas
+una skill: guarda el run.
+
+```
+workflow save-as-skill <runId> <nombre>
+```
+
+Eso guarda el script que **se ejecutó de verdad**, con su procedencia (runId,
+args, resultado) en la cabecera. Solo acepta runs completados. Es más fiable que
+una skill escrita a mano describiendo lo que uno cree que hizo.

package/dist/telegram/api.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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);
+    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,mEAAkE;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;IAEpB,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAOnF;CACD;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,OAAO,EAAE,UAAU,EAI9B;YAQa,IAAI;IAwBlB,0EAA0E;IAC1E,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAEjD;IAED;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAM1E;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAStG;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;IAED,6DAA2D;IAC3D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3C;CACD;AAED,4EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,MAAM,EAAE,CAcrE","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"]}