@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/server/attach.js

@@ -0,0 +1,130 @@
+/**
+ * Cliente de `ada attach` — reconecta a una sesión residente.
+ *
+ * Renderiza el transcript existente y luego sigue en vivo. Salir del attach NO
+ * mata la sesión: el dueño de la ejecución es el proceso que sirve.
+ *
+ * Acepta entrada: lo que escribas se envía como prompt a la sesión remota. No
+ * pretende sustituir al TUI completo (sin editor multilínea, sin @-menciones,
+ * sin atajos) — es un terminal de trabajo sobre una sesión que vive en otro
+ * proceso.
+ *
+ * Se usa `attachSession` (lease compartido) a propósito, no `acquireSession`
+ * exclusivo: reconectar para mirar no debería expulsar a nadie.
+ */
+/** Lector de líneas por defecto sobre stdin. */
+function stdinLines(onLine) {
+    const readline = require("node:readline");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: "› " });
+    rl.on("line", (line) => {
+        const text = line.trim();
+        if (text)
+            onLine(text);
+        rl.prompt();
+    });
+    rl.prompt();
+    return { close: () => rl.close() };
+}
+/** Una línea legible por item del transcript. */
+export function renderItem(item) {
+    if (item.role === "user") {
+        const text = item.content
+            .map((block) => (block.type === "text" ? block.text : "[imagen]"))
+            .join(" ")
+            .trim();
+        return `\n› ${text}`;
+    }
+    if (item.role === "assistant") {
+        const text = item.content
+            .map((block) => {
+            if (block.type === "text")
+                return block.text;
+            if (block.type === "toolCall")
+                return `  ⚙ ${block.toolName}`;
+            return ""; // el thinking no se vuelca en un attach
+        })
+            .filter(Boolean)
+            .join("\n")
+            .trim();
+        const suffix = item.status === "streaming" ? " …" : item.status === "error" ? " [error]" : "";
+        return text ? `${text}${suffix}` : "";
+    }
+    const status = item.status === "error" ? "✗" : "✓";
+    return `  ${status} ${item.toolName}`;
+}
+/** Solo lo NUEVO respecto a lo ya pintado: un attach no repite el transcript. */
+export function renderIncremental(snapshot, alreadyRendered) {
+    const fresh = snapshot.transcript.slice(alreadyRendered);
+    const text = fresh.map(renderItem).filter(Boolean).join("\n");
+    return { text, rendered: snapshot.transcript.length };
+}
+/**
+ * Bucle de attach sobre un lease ya adquirido.
+ *
+ * Separado de la conexión a propósito: así se puede probar el comportamiento
+ * (render, envío, fallos, limpieza) sin levantar un socket.
+ */
+export async function attachWithLease(options) {
+    const { lease, write } = options;
+    let rendered = 0;
+    const paint = (snapshot) => {
+        const { text, rendered: next } = renderIncremental(snapshot, rendered);
+        rendered = next;
+        if (text)
+            write(`${text}\n`);
+    };
+    if (lease.snapshot)
+        paint(lease.snapshot);
+    const unsubscribe = lease.subscribe(paint);
+    write(options.readOnly
+        ? `\n[observando ${options.sessionId}. Ctrl-C se desconecta; la sesión sigue viva]\n`
+        : `\n[adjunto a ${options.sessionId}. Escribe para enviar; Ctrl-C se desconecta y la sesión sigue viva]\n`);
+    let input;
+    await new Promise((resolve) => {
+        // Una señal ya abortada debe resolver de inmediato, no esperar un evento
+        // que nunca llegará.
+        if (options.signal?.aborted) {
+            resolve();
+            return;
+        }
+        const stop = () => resolve();
+        options.signal?.addEventListener("abort", stop, { once: true });
+        process.once("SIGINT", stop);
+        if (!options.readOnly) {
+            const reader = options.readLines ?? stdinLines;
+            input = reader((line) => {
+                // Un fallo al enviar no debe tirar el attach: la sesión sigue viva en
+                // el otro proceso y el usuario puede reintentar.
+                void lease.prompt(line).catch((error) => {
+                    write(`[no se pudo enviar: ${error instanceof Error ? error.message : String(error)}]\n`);
+                });
+            });
+        }
+    });
+    input?.close();
+    unsubscribe();
+}
+export async function attach(options) {
+    const write = options.write ?? ((text) => process.stdout.write(text));
+    const { PiClient } = await import("@earendil-works/pi-client");
+    const { createUnixTransportFactory } = await import("@earendil-works/pi-client/unix");
+    const client = new PiClient({ transportFactory: createUnixTransportFactory({ path: options.socketPath }) });
+    let lease;
+    try {
+        lease = await client.attachSession(options.sessionId);
+        await attachWithLease({
+            lease,
+            sessionId: options.sessionId,
+            write,
+            signal: options.signal,
+            readLines: options.readLines,
+            readOnly: options.readOnly,
+        });
+    }
+    finally {
+        // detach, NO dispose de la sesión: desengancharse no debe matar el trabajo.
+        await lease?.detach().catch(() => { });
+        await client.dispose().catch(() => { });
+    }
+}
+//# sourceMappingURL=attach.js.map

package/dist/server/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/server/attach.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cliente de `ada attach` — reconecta a una sesión residente.\n *\n * Renderiza el transcript existente y luego sigue en vivo. Salir del attach NO\n * mata la sesión: el dueño de la ejecución es el proceso que sirve.\n *\n * Acepta entrada: lo que escribas se envía como prompt a la sesión remota. No\n * pretende sustituir al TUI completo (sin editor multilínea, sin @-menciones,\n * sin atajos) — es un terminal de trabajo sobre una sesión que vive en otro\n * proceso.\n *\n * Se usa `attachSession` (lease compartido) a propósito, no `acquireSession`\n * exclusivo: reconectar para mirar no debería expulsar a nadie.\n */\n\nimport type { PiSessionHandle } from \"@earendil-works/pi-client\";\nimport type { SessionSnapshot, TranscriptItem } from \"@earendil-works/pi-protocol\";\n\nexport interface AttachOptions {\n\tsocketPath: string;\n\tsessionId: string;\n\t/** Salida (inyectable para tests). */\n\twrite?: (text: string) => void;\n\t/** Corta el bucle en vivo (tests). */\n\tsignal?: AbortSignal;\n\t/** Entrada de línea (inyectable para tests). Por defecto, stdin. */\n\treadLines?: (onLine: (line: string) => void) => { close(): void };\n\t/** Solo observar, sin aceptar entrada. */\n\treadOnly?: boolean;\n}\n\n/** Lector de líneas por defecto sobre stdin. */\nfunction stdinLines(onLine: (line: string) => void): { close(): void } {\n\tconst readline = require(\"node:readline\") as typeof import(\"node:readline\");\n\tconst rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: \"› \" });\n\trl.on(\"line\", (line) => {\n\t\tconst text = line.trim();\n\t\tif (text) onLine(text);\n\t\trl.prompt();\n\t});\n\trl.prompt();\n\treturn { close: () => rl.close() };\n}\n\n/** Una línea legible por item del transcript. */\nexport function renderItem(item: TranscriptItem): string {\n\tif (item.role === \"user\") {\n\t\tconst text = item.content\n\t\t\t.map((block) => (block.type === \"text\" ? block.text : \"[imagen]\"))\n\t\t\t.join(\" \")\n\t\t\t.trim();\n\t\treturn `\\n› ${text}`;\n\t}\n\tif (item.role === \"assistant\") {\n\t\tconst text = item.content\n\t\t\t.map((block) => {\n\t\t\t\tif (block.type === \"text\") return block.text;\n\t\t\t\tif (block.type === \"toolCall\") return `  ⚙ ${block.toolName}`;\n\t\t\t\treturn \"\"; // el thinking no se vuelca en un attach\n\t\t\t})\n\t\t\t.filter(Boolean)\n\t\t\t.join(\"\\n\")\n\t\t\t.trim();\n\t\tconst suffix = item.status === \"streaming\" ? \" …\" : item.status === \"error\" ? \" [error]\" : \"\";\n\t\treturn text ? `${text}${suffix}` : \"\";\n\t}\n\tconst status = item.status === \"error\" ? \"✗\" : \"✓\";\n\treturn `  ${status} ${item.toolName}`;\n}\n\n/** Solo lo NUEVO respecto a lo ya pintado: un attach no repite el transcript. */\nexport function renderIncremental(\n\tsnapshot: SessionSnapshot,\n\talreadyRendered: number,\n): { text: string; rendered: number } {\n\tconst fresh = snapshot.transcript.slice(alreadyRendered);\n\tconst text = fresh.map(renderItem).filter(Boolean).join(\"\\n\");\n\treturn { text, rendered: snapshot.transcript.length };\n}\n\nexport interface AttachLoopOptions {\n\tlease: PiSessionHandle;\n\tsessionId: string;\n\twrite: (text: string) => void;\n\tsignal?: AbortSignal;\n\treadLines?: (onLine: (line: string) => void) => { close(): void };\n\treadOnly?: boolean;\n}\n\n/**\n * Bucle de attach sobre un lease ya adquirido.\n *\n * Separado de la conexión a propósito: así se puede probar el comportamiento\n * (render, envío, fallos, limpieza) sin levantar un socket.\n */\nexport async function attachWithLease(options: AttachLoopOptions): Promise<void> {\n\tconst { lease, write } = options;\n\tlet rendered = 0;\n\tconst paint = (snapshot: SessionSnapshot) => {\n\t\tconst { text, rendered: next } = renderIncremental(snapshot, rendered);\n\t\trendered = next;\n\t\tif (text) write(`${text}\\n`);\n\t};\n\n\tif (lease.snapshot) paint(lease.snapshot);\n\tconst unsubscribe = lease.subscribe(paint);\n\n\twrite(\n\t\toptions.readOnly\n\t\t\t? `\\n[observando ${options.sessionId}. Ctrl-C se desconecta; la sesión sigue viva]\\n`\n\t\t\t: `\\n[adjunto a ${options.sessionId}. Escribe para enviar; Ctrl-C se desconecta y la sesión sigue viva]\\n`,\n\t);\n\n\tlet input: { close(): void } | undefined;\n\tawait new Promise<void>((resolve) => {\n\t\t// Una señal ya abortada debe resolver de inmediato, no esperar un evento\n\t\t// que nunca llegará.\n\t\tif (options.signal?.aborted) {\n\t\t\tresolve();\n\t\t\treturn;\n\t\t}\n\t\tconst stop = () => resolve();\n\t\toptions.signal?.addEventListener(\"abort\", stop, { once: true });\n\t\tprocess.once(\"SIGINT\", stop);\n\n\t\tif (!options.readOnly) {\n\t\t\tconst reader = options.readLines ?? stdinLines;\n\t\t\tinput = reader((line) => {\n\t\t\t\t// Un fallo al enviar no debe tirar el attach: la sesión sigue viva en\n\t\t\t\t// el otro proceso y el usuario puede reintentar.\n\t\t\t\tvoid lease.prompt(line).catch((error: unknown) => {\n\t\t\t\t\twrite(`[no se pudo enviar: ${error instanceof Error ? error.message : String(error)}]\\n`);\n\t\t\t\t});\n\t\t\t});\n\t\t}\n\t});\n\tinput?.close();\n\tunsubscribe();\n}\n\nexport async function attach(options: AttachOptions): Promise<void> {\n\tconst write = options.write ?? ((text: string) => process.stdout.write(text));\n\tconst { PiClient } = await import(\"@earendil-works/pi-client\");\n\tconst { createUnixTransportFactory } = await import(\"@earendil-works/pi-client/unix\");\n\n\tconst client = new PiClient({ transportFactory: createUnixTransportFactory({ path: options.socketPath }) });\n\tlet lease: PiSessionHandle | undefined;\n\ttry {\n\t\tlease = await client.attachSession(options.sessionId);\n\t\tawait attachWithLease({\n\t\t\tlease,\n\t\t\tsessionId: options.sessionId,\n\t\t\twrite,\n\t\t\tsignal: options.signal,\n\t\t\treadLines: options.readLines,\n\t\t\treadOnly: options.readOnly,\n\t\t});\n\t} finally {\n\t\t// detach, NO dispose de la sesión: desengancharse no debe matar el trabajo.\n\t\tawait lease?.detach().catch(() => {});\n\t\tawait client.dispose().catch(() => {});\n\t}\n}\n"]}

package/dist/server/extension-ops.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Operaciones de Ada sobre sesiones residentes: `compact`, `rename`, `fork` y
+ * `kill`.
+ *
+ * Viajan por el comando genérico `extension` del protocolo en vez de tener cada
+ * una su propio comando tipado. La razón es de coste, no de pereza:
+ * `packages/protocol` y `packages/server` son de upstream, y cada línea que
+ * añadimos ahí se reaplica en cada sync y se rompe cuando upstream refactoriza
+ * esos ficheros. Un comando genérico se paga una vez; estas cuatro operaciones
+ * y todas las futuras viven aquí, a coste cero.
+ *
+ * Lo que el cable pierde en tipado se recupera AQUÍ: cada op valida su payload
+ * con su propio schema antes de tocar nada. La validación no desaparece, se
+ * mueve a donde no cuesta presupuesto.
+ */
+import type { ExtensionRequest } from "@earendil-works/pi-server";
+export interface ExtensionOpsContext {
+    /** Retira una sesión del servidor tras un `kill`. */
+    forget: (sessionId: string) => void;
+}
+/** Nombres soportados, para que `mcp_list`-style clients puedan descubrirlos. */
+export declare const EXTENSION_OPS: readonly ["ops", "compact", "rename", "fork", "kill"];
+export declare function createExtensionHandler(context: ExtensionOpsContext): (request: ExtensionRequest) => Promise<unknown>;
+/**
+ * Cliente de las operaciones desde el CLI.
+ *
+ * Vive aquí, junto a la definición de las ops, para que añadir una no obligue a
+ * tocar dos sitios distantes ni a recordar que existe un cliente aparte.
+ */
+export declare function runExtensionOp(options: {
+    socketPath: string;
+    op: string;
+    sessionId?: string;
+    payload?: unknown;
+}): Promise<{
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+}>;
+//# sourceMappingURL=extension-ops.d.ts.map

package/dist/server/extension-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-ops.d.ts","sourceRoot":"","sources":["../../src/server/extension-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA8BlE,MAAM,WAAW,mBAAmB;IACnC,sDAAqD;IACrD,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,uDAAwD,CAAC;AAEnF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,mDAyDlE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC3D","sourcesContent":["/**\n * Operaciones de Ada sobre sesiones residentes: `compact`, `rename`, `fork` y\n * `kill`.\n *\n * Viajan por el comando genérico `extension` del protocolo en vez de tener cada\n * una su propio comando tipado. La razón es de coste, no de pereza:\n * `packages/protocol` y `packages/server` son de upstream, y cada línea que\n * añadimos ahí se reaplica en cada sync y se rompe cuando upstream refactoriza\n * esos ficheros. Un comando genérico se paga una vez; estas cuatro operaciones\n * y todas las futuras viven aquí, a coste cero.\n *\n * Lo que el cable pierde en tipado se recupera AQUÍ: cada op valida su payload\n * con su propio schema antes de tocar nada. La validación no desaparece, se\n * mueve a donde no cuesta presupuesto.\n */\n\nimport type { ExtensionRequest } from \"@earendil-works/pi-server\";\nimport { type Static, type TSchema, Type } from \"typebox\";\nimport { Value } from \"typebox/value\";\nimport type { AdaSessionRuntime } from \"./pi-server-service.ts\";\n\nconst NoPayload = Type.Object({});\nconst RenamePayload = Type.Object({ name: Type.String({ minLength: 1 }) });\nconst CompactPayload = Type.Object({ customInstructions: Type.Optional(Type.String()) });\n\n/**\n * Valida el payload opaco contra el schema de la operación.\n *\n * Se lanza con el error de validación real, no un \"argumentos inválidos\"\n * genérico: quien llama por un socket no tiene forma de inspeccionar qué\n * esperaba el otro lado.\n */\nfunction parse<T extends TSchema>(schema: T, payload: unknown): Static<T> {\n\tconst value = payload ?? {};\n\tif (Value.Check(schema, value)) return value as Static<T>;\n\tconst [first] = [...Value.Errors(schema, value)];\n\tthrow new Error(`payload inválido: ${first ? first.message : \"no coincide con el schema\"}`);\n}\n\n/** Exige una sesión viva. Las cuatro ops operan sobre una sesión concreta. */\nfunction requireRuntime(request: ExtensionRequest): AdaSessionRuntime {\n\tif (!request.sessionId) throw new Error(\"falta sessionId\");\n\tif (!request.runtime) throw new Error(`la sesión ${request.sessionId} no está abierta en este servidor`);\n\treturn request.runtime as AdaSessionRuntime;\n}\n\nexport interface ExtensionOpsContext {\n\t/** Retira una sesión del servidor tras un `kill`. */\n\tforget: (sessionId: string) => void;\n}\n\n/** Nombres soportados, para que `mcp_list`-style clients puedan descubrirlos. */\nexport const EXTENSION_OPS = [\"ops\", \"compact\", \"rename\", \"fork\", \"kill\"] as const;\n\nexport function createExtensionHandler(context: ExtensionOpsContext) {\n\treturn async (request: ExtensionRequest): Promise<unknown> => {\n\t\tswitch (request.op) {\n\t\t\t// Descubrimiento: un cliente nuevo contra un servidor viejo necesita\n\t\t\t// poder preguntar qué existe en vez de adivinar.\n\t\t\tcase \"ops\":\n\t\t\t\treturn { ops: [...EXTENSION_OPS] };\n\n\t\t\tcase \"compact\": {\n\t\t\t\tconst { customInstructions } = parse(CompactPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\tconst result = await runtime.session.compact(customInstructions);\n\t\t\t\treturn { compacted: true, result };\n\t\t\t}\n\n\t\t\tcase \"rename\": {\n\t\t\t\tconst { name } = parse(RenamePayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\t// El nombre se persiste como una entrada más del JSONL, que es como\n\t\t\t\t// lo hace el resto del producto: sin estado paralelo que se\n\t\t\t\t// desincronice del fichero de sesión.\n\t\t\t\truntime.sessionManager.appendSessionInfo(name);\n\t\t\t\treturn { renamed: true, name };\n\t\t\t}\n\n\t\t\tcase \"fork\": {\n\t\t\t\tparse(NoPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\tconst sourceFile = runtime.sessionManager.getSessionFile();\n\t\t\t\tif (!sourceFile) throw new Error(\"la sesión aún no se ha persistido; no hay nada que bifurcar\");\n\t\t\t\t// Copia del JSONL a una sesión nueva. NO se abre aquí: bifurcar es\n\t\t\t\t// una operación sobre el historial, y decidir cuándo cargarla es del\n\t\t\t\t// cliente. Abrirla sola dejaría un runtime que nadie pidió.\n\t\t\t\tconst { copyFile } = await import(\"node:fs/promises\");\n\t\t\t\tconst { SessionManager } = await import(\"../core/session-manager.ts\");\n\t\t\t\tconst target = SessionManager.create(runtime.sessionManager.getCwd());\n\t\t\t\tconst targetFile = target.getSessionFile() ?? target.newSession();\n\t\t\t\tif (!targetFile) throw new Error(\"no se pudo crear la sesión destino\");\n\t\t\t\tawait copyFile(sourceFile, targetFile);\n\t\t\t\treturn { forked: true, sessionId: target.getSessionId(), path: targetFile };\n\t\t\t}\n\n\t\t\tcase \"kill\": {\n\t\t\t\tparse(NoPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\t// El historial en disco NO se borra. \"kill\" retira la sesión de la\n\t\t\t\t// memoria del servidor; destruir el JSONL sería irreversible y no es\n\t\t\t\t// lo que nadie espera de un kill.\n\t\t\t\tawait runtime.dispose();\n\t\t\t\tcontext.forget(request.sessionId as string);\n\t\t\t\treturn { killed: true, historyKept: true };\n\t\t\t}\n\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`operación desconocida: ${request.op}. Disponibles: ${EXTENSION_OPS.join(\", \")}`);\n\t\t}\n\t};\n}\n\n/**\n * Cliente de las operaciones desde el CLI.\n *\n * Vive aquí, junto a la definición de las ops, para que añadir una no obligue a\n * tocar dos sitios distantes ni a recordar que existe un cliente aparte.\n */\nexport async function runExtensionOp(options: {\n\tsocketPath: string;\n\top: string;\n\tsessionId?: string;\n\tpayload?: unknown;\n}): Promise<{ ok: boolean; data?: unknown; error?: string }> {\n\tconst { PiClient } = await import(\"@earendil-works/pi-client\");\n\tconst { createUnixTransportFactory } = await import(\"@earendil-works/pi-client/unix\");\n\tconst client = new PiClient({ transportFactory: createUnixTransportFactory({ path: options.socketPath }) });\n\ttry {\n\t\tawait client.connect();\n\t\t// `attachSession` antes de operar: el servidor solo entrega el runtime vivo\n\t\t// de una sesión abierta, y sin esto un `compact` sobre una sesión existente\n\t\t// pero cerrada fallaría con \"no está abierta\" sin explicar que basta con\n\t\t// engancharse.\n\t\tif (options.sessionId) await client.attachSession(options.sessionId).catch(() => undefined);\n\n\t\t// El punto de extensión del protocolo lo añadimos nosotros a\n\t\t// `packages/{client,protocol,server}`, y esos paquetes NO viajan en el\n\t\t// tarball: `@hoilab/ada-cli` los resuelve del registro de npm, así que\n\t\t// quien instala recibe los de upstream, sin este comando.\n\t\t//\n\t\t// Sin esta comprobación, `ada-cli session <id> compact` reventaba con\n\t\t// «client.extension is not a function» —un error que no dice nada de la\n\t\t// causa— en vez de explicar qué falta. Es la diferencia entre «está roto» y\n\t\t// «esto necesita una compilación desde fuentes».\n\t\tif (typeof (client as { extension?: unknown }).extension !== \"function\") {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\t\"Esta operación necesita el punto de extensión del protocolo, que solo está en una \" +\n\t\t\t\t\t\"compilación desde fuentes: el paquete publicado depende de `@earendil-works/pi-client` \" +\n\t\t\t\t\t\"del registro, que no lo trae. Compila desde el repositorio (ver la sección «Building \" +\n\t\t\t\t\t\"from source» del README) o usa el resto de subcomandos, que no lo necesitan.\",\n\t\t\t};\n\t\t}\n\n\t\tconst result = await client.extension(options.op, {\n\t\t\tsessionId: options.sessionId,\n\t\t\tpayload: options.payload,\n\t\t});\n\t\treturn { ok: result.ok, data: result.data, error: result.error };\n\t} finally {\n\t\tawait client.dispose().catch(() => {});\n\t}\n}\n"]}

package/dist/server/extension-ops.js

@@ -0,0 +1,146 @@
+/**
+ * Operaciones de Ada sobre sesiones residentes: `compact`, `rename`, `fork` y
+ * `kill`.
+ *
+ * Viajan por el comando genérico `extension` del protocolo en vez de tener cada
+ * una su propio comando tipado. La razón es de coste, no de pereza:
+ * `packages/protocol` y `packages/server` son de upstream, y cada línea que
+ * añadimos ahí se reaplica en cada sync y se rompe cuando upstream refactoriza
+ * esos ficheros. Un comando genérico se paga una vez; estas cuatro operaciones
+ * y todas las futuras viven aquí, a coste cero.
+ *
+ * Lo que el cable pierde en tipado se recupera AQUÍ: cada op valida su payload
+ * con su propio schema antes de tocar nada. La validación no desaparece, se
+ * mueve a donde no cuesta presupuesto.
+ */
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+const NoPayload = Type.Object({});
+const RenamePayload = Type.Object({ name: Type.String({ minLength: 1 }) });
+const CompactPayload = Type.Object({ customInstructions: Type.Optional(Type.String()) });
+/**
+ * Valida el payload opaco contra el schema de la operación.
+ *
+ * Se lanza con el error de validación real, no un "argumentos inválidos"
+ * genérico: quien llama por un socket no tiene forma de inspeccionar qué
+ * esperaba el otro lado.
+ */
+function parse(schema, payload) {
+    const value = payload ?? {};
+    if (Value.Check(schema, value))
+        return value;
+    const [first] = [...Value.Errors(schema, value)];
+    throw new Error(`payload inválido: ${first ? first.message : "no coincide con el schema"}`);
+}
+/** Exige una sesión viva. Las cuatro ops operan sobre una sesión concreta. */
+function requireRuntime(request) {
+    if (!request.sessionId)
+        throw new Error("falta sessionId");
+    if (!request.runtime)
+        throw new Error(`la sesión ${request.sessionId} no está abierta en este servidor`);
+    return request.runtime;
+}
+/** Nombres soportados, para que `mcp_list`-style clients puedan descubrirlos. */
+export const EXTENSION_OPS = ["ops", "compact", "rename", "fork", "kill"];
+export function createExtensionHandler(context) {
+    return async (request) => {
+        switch (request.op) {
+            // Descubrimiento: un cliente nuevo contra un servidor viejo necesita
+            // poder preguntar qué existe en vez de adivinar.
+            case "ops":
+                return { ops: [...EXTENSION_OPS] };
+            case "compact": {
+                const { customInstructions } = parse(CompactPayload, request.payload);
+                const runtime = requireRuntime(request);
+                const result = await runtime.session.compact(customInstructions);
+                return { compacted: true, result };
+            }
+            case "rename": {
+                const { name } = parse(RenamePayload, request.payload);
+                const runtime = requireRuntime(request);
+                // El nombre se persiste como una entrada más del JSONL, que es como
+                // lo hace el resto del producto: sin estado paralelo que se
+                // desincronice del fichero de sesión.
+                runtime.sessionManager.appendSessionInfo(name);
+                return { renamed: true, name };
+            }
+            case "fork": {
+                parse(NoPayload, request.payload);
+                const runtime = requireRuntime(request);
+                const sourceFile = runtime.sessionManager.getSessionFile();
+                if (!sourceFile)
+                    throw new Error("la sesión aún no se ha persistido; no hay nada que bifurcar");
+                // Copia del JSONL a una sesión nueva. NO se abre aquí: bifurcar es
+                // una operación sobre el historial, y decidir cuándo cargarla es del
+                // cliente. Abrirla sola dejaría un runtime que nadie pidió.
+                const { copyFile } = await import("node:fs/promises");
+                const { SessionManager } = await import("../core/session-manager.js");
+                const target = SessionManager.create(runtime.sessionManager.getCwd());
+                const targetFile = target.getSessionFile() ?? target.newSession();
+                if (!targetFile)
+                    throw new Error("no se pudo crear la sesión destino");
+                await copyFile(sourceFile, targetFile);
+                return { forked: true, sessionId: target.getSessionId(), path: targetFile };
+            }
+            case "kill": {
+                parse(NoPayload, request.payload);
+                const runtime = requireRuntime(request);
+                // El historial en disco NO se borra. "kill" retira la sesión de la
+                // memoria del servidor; destruir el JSONL sería irreversible y no es
+                // lo que nadie espera de un kill.
+                await runtime.dispose();
+                context.forget(request.sessionId);
+                return { killed: true, historyKept: true };
+            }
+            default:
+                throw new Error(`operación desconocida: ${request.op}. Disponibles: ${EXTENSION_OPS.join(", ")}`);
+        }
+    };
+}
+/**
+ * Cliente de las operaciones desde el CLI.
+ *
+ * Vive aquí, junto a la definición de las ops, para que añadir una no obligue a
+ * tocar dos sitios distantes ni a recordar que existe un cliente aparte.
+ */
+export async function runExtensionOp(options) {
+    const { PiClient } = await import("@earendil-works/pi-client");
+    const { createUnixTransportFactory } = await import("@earendil-works/pi-client/unix");
+    const client = new PiClient({ transportFactory: createUnixTransportFactory({ path: options.socketPath }) });
+    try {
+        await client.connect();
+        // `attachSession` antes de operar: el servidor solo entrega el runtime vivo
+        // de una sesión abierta, y sin esto un `compact` sobre una sesión existente
+        // pero cerrada fallaría con "no está abierta" sin explicar que basta con
+        // engancharse.
+        if (options.sessionId)
+            await client.attachSession(options.sessionId).catch(() => undefined);
+        // El punto de extensión del protocolo lo añadimos nosotros a
+        // `packages/{client,protocol,server}`, y esos paquetes NO viajan en el
+        // tarball: `@hoilab/ada-cli` los resuelve del registro de npm, así que
+        // quien instala recibe los de upstream, sin este comando.
+        //
+        // Sin esta comprobación, `ada-cli session <id> compact` reventaba con
+        // «client.extension is not a function» —un error que no dice nada de la
+        // causa— en vez de explicar qué falta. Es la diferencia entre «está roto» y
+        // «esto necesita una compilación desde fuentes».
+        if (typeof client.extension !== "function") {
+            return {
+                ok: false,
+                error: "Esta operación necesita el punto de extensión del protocolo, que solo está en una " +
+                    "compilación desde fuentes: el paquete publicado depende de `@earendil-works/pi-client` " +
+                    "del registro, que no lo trae. Compila desde el repositorio (ver la sección «Building " +
+                    "from source» del README) o usa el resto de subcomandos, que no lo necesitan.",
+            };
+        }
+        const result = await client.extension(options.op, {
+            sessionId: options.sessionId,
+            payload: options.payload,
+        });
+        return { ok: result.ok, data: result.data, error: result.error };
+    }
+    finally {
+        await client.dispose().catch(() => { });
+    }
+}
+//# sourceMappingURL=extension-ops.js.map

package/dist/server/extension-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-ops.js","sourceRoot":"","sources":["../../src/server/extension-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAA6B,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAClC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3E,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAEzF;;;;;;GAMG;AACH,SAAS,KAAK,CAAoB,MAAS,EAAE,OAAgB,EAAa;IACzE,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,KAAkB,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,KAAK,CAAC,sBAAqB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;AAAA,CAC5F;AAED,gFAA8E;AAC9E,SAAS,cAAc,CAAC,OAAyB,EAAqB;IACrE,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,cAAa,OAAO,CAAC,SAAS,oCAAmC,CAAC,CAAC;IACzG,OAAO,OAAO,CAAC,OAA4B,CAAC;AAAA,CAC5C;AAOD,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEnF,MAAM,UAAU,sBAAsB,CAAC,OAA4B,EAAE;IACpE,OAAO,KAAK,EAAE,OAAyB,EAAoB,EAAE,CAAC;QAC7D,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;YACpB,qEAAqE;YACrE,kDAAiD;YACjD,KAAK,KAAK;gBACT,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;YAEpC,KAAK,SAAS,EAAE,CAAC;gBAChB,MAAM,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBACtE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;gBACjE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACpC,CAAC;YAED,KAAK,QAAQ,EAAE,CAAC;gBACf,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBACvD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxC,qEAAoE;gBACpE,4DAA4D;gBAC5D,uCAAsC;gBACtC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChC,CAAC;YAED,KAAK,MAAM,EAAE,CAAC;gBACb,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAClC,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;gBAC3D,IAAI,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,+DAA6D,CAAC,CAAC;gBAChG,qEAAmE;gBACnE,uEAAqE;gBACrE,8DAA4D;gBAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBACtD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;gBACtE,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAClE,IAAI,CAAC,UAAU;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAoC,CAAC,CAAC;gBACvE,MAAM,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC7E,CAAC;YAED,KAAK,MAAM,EAAE,CAAC;gBACb,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAClC,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;gBACxC,oEAAmE;gBACnE,sEAAqE;gBACrE,kCAAkC;gBAClC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAmB,CAAC,CAAC;gBAC5C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC5C,CAAC;YAED;gBACC,MAAM,IAAI,KAAK,CAAC,2BAA0B,OAAO,CAAC,EAAE,kBAAkB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;IAAA,CACD,CAAC;AAAA,CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAKpC,EAA4D;IAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC/D,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,gBAAgB,EAAE,0BAA0B,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5G,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,4EAA4E;QAC5E,8EAA4E;QAC5E,2EAAyE;QACzE,eAAe;QACf,IAAI,OAAO,CAAC,SAAS;YAAE,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE5F,+DAA6D;QAC7D,uEAAuE;QACvE,wEAAuE;QACvE,0DAA0D;QAC1D,EAAE;QACF,uEAAsE;QACtE,4EAAwE;QACxE,kFAA4E;QAC5E,oDAAiD;QACjD,IAAI,OAAQ,MAAkC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACzE,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,KAAK,EACJ,uFAAoF;oBACpF,0FAAyF;oBACzF,yFAAuF;oBACvF,+EAA8E;aAC/E,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE;YACjD,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAClE,CAAC;YAAS,CAAC;QACV,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;IACxC,CAAC;AAAA,CACD","sourcesContent":["/**\n * Operaciones de Ada sobre sesiones residentes: `compact`, `rename`, `fork` y\n * `kill`.\n *\n * Viajan por el comando genérico `extension` del protocolo en vez de tener cada\n * una su propio comando tipado. La razón es de coste, no de pereza:\n * `packages/protocol` y `packages/server` son de upstream, y cada línea que\n * añadimos ahí se reaplica en cada sync y se rompe cuando upstream refactoriza\n * esos ficheros. Un comando genérico se paga una vez; estas cuatro operaciones\n * y todas las futuras viven aquí, a coste cero.\n *\n * Lo que el cable pierde en tipado se recupera AQUÍ: cada op valida su payload\n * con su propio schema antes de tocar nada. La validación no desaparece, se\n * mueve a donde no cuesta presupuesto.\n */\n\nimport type { ExtensionRequest } from \"@earendil-works/pi-server\";\nimport { type Static, type TSchema, Type } from \"typebox\";\nimport { Value } from \"typebox/value\";\nimport type { AdaSessionRuntime } from \"./pi-server-service.ts\";\n\nconst NoPayload = Type.Object({});\nconst RenamePayload = Type.Object({ name: Type.String({ minLength: 1 }) });\nconst CompactPayload = Type.Object({ customInstructions: Type.Optional(Type.String()) });\n\n/**\n * Valida el payload opaco contra el schema de la operación.\n *\n * Se lanza con el error de validación real, no un \"argumentos inválidos\"\n * genérico: quien llama por un socket no tiene forma de inspeccionar qué\n * esperaba el otro lado.\n */\nfunction parse<T extends TSchema>(schema: T, payload: unknown): Static<T> {\n\tconst value = payload ?? {};\n\tif (Value.Check(schema, value)) return value as Static<T>;\n\tconst [first] = [...Value.Errors(schema, value)];\n\tthrow new Error(`payload inválido: ${first ? first.message : \"no coincide con el schema\"}`);\n}\n\n/** Exige una sesión viva. Las cuatro ops operan sobre una sesión concreta. */\nfunction requireRuntime(request: ExtensionRequest): AdaSessionRuntime {\n\tif (!request.sessionId) throw new Error(\"falta sessionId\");\n\tif (!request.runtime) throw new Error(`la sesión ${request.sessionId} no está abierta en este servidor`);\n\treturn request.runtime as AdaSessionRuntime;\n}\n\nexport interface ExtensionOpsContext {\n\t/** Retira una sesión del servidor tras un `kill`. */\n\tforget: (sessionId: string) => void;\n}\n\n/** Nombres soportados, para que `mcp_list`-style clients puedan descubrirlos. */\nexport const EXTENSION_OPS = [\"ops\", \"compact\", \"rename\", \"fork\", \"kill\"] as const;\n\nexport function createExtensionHandler(context: ExtensionOpsContext) {\n\treturn async (request: ExtensionRequest): Promise<unknown> => {\n\t\tswitch (request.op) {\n\t\t\t// Descubrimiento: un cliente nuevo contra un servidor viejo necesita\n\t\t\t// poder preguntar qué existe en vez de adivinar.\n\t\t\tcase \"ops\":\n\t\t\t\treturn { ops: [...EXTENSION_OPS] };\n\n\t\t\tcase \"compact\": {\n\t\t\t\tconst { customInstructions } = parse(CompactPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\tconst result = await runtime.session.compact(customInstructions);\n\t\t\t\treturn { compacted: true, result };\n\t\t\t}\n\n\t\t\tcase \"rename\": {\n\t\t\t\tconst { name } = parse(RenamePayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\t// El nombre se persiste como una entrada más del JSONL, que es como\n\t\t\t\t// lo hace el resto del producto: sin estado paralelo que se\n\t\t\t\t// desincronice del fichero de sesión.\n\t\t\t\truntime.sessionManager.appendSessionInfo(name);\n\t\t\t\treturn { renamed: true, name };\n\t\t\t}\n\n\t\t\tcase \"fork\": {\n\t\t\t\tparse(NoPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\tconst sourceFile = runtime.sessionManager.getSessionFile();\n\t\t\t\tif (!sourceFile) throw new Error(\"la sesión aún no se ha persistido; no hay nada que bifurcar\");\n\t\t\t\t// Copia del JSONL a una sesión nueva. NO se abre aquí: bifurcar es\n\t\t\t\t// una operación sobre el historial, y decidir cuándo cargarla es del\n\t\t\t\t// cliente. Abrirla sola dejaría un runtime que nadie pidió.\n\t\t\t\tconst { copyFile } = await import(\"node:fs/promises\");\n\t\t\t\tconst { SessionManager } = await import(\"../core/session-manager.ts\");\n\t\t\t\tconst target = SessionManager.create(runtime.sessionManager.getCwd());\n\t\t\t\tconst targetFile = target.getSessionFile() ?? target.newSession();\n\t\t\t\tif (!targetFile) throw new Error(\"no se pudo crear la sesión destino\");\n\t\t\t\tawait copyFile(sourceFile, targetFile);\n\t\t\t\treturn { forked: true, sessionId: target.getSessionId(), path: targetFile };\n\t\t\t}\n\n\t\t\tcase \"kill\": {\n\t\t\t\tparse(NoPayload, request.payload);\n\t\t\t\tconst runtime = requireRuntime(request);\n\t\t\t\t// El historial en disco NO se borra. \"kill\" retira la sesión de la\n\t\t\t\t// memoria del servidor; destruir el JSONL sería irreversible y no es\n\t\t\t\t// lo que nadie espera de un kill.\n\t\t\t\tawait runtime.dispose();\n\t\t\t\tcontext.forget(request.sessionId as string);\n\t\t\t\treturn { killed: true, historyKept: true };\n\t\t\t}\n\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`operación desconocida: ${request.op}. Disponibles: ${EXTENSION_OPS.join(\", \")}`);\n\t\t}\n\t};\n}\n\n/**\n * Cliente de las operaciones desde el CLI.\n *\n * Vive aquí, junto a la definición de las ops, para que añadir una no obligue a\n * tocar dos sitios distantes ni a recordar que existe un cliente aparte.\n */\nexport async function runExtensionOp(options: {\n\tsocketPath: string;\n\top: string;\n\tsessionId?: string;\n\tpayload?: unknown;\n}): Promise<{ ok: boolean; data?: unknown; error?: string }> {\n\tconst { PiClient } = await import(\"@earendil-works/pi-client\");\n\tconst { createUnixTransportFactory } = await import(\"@earendil-works/pi-client/unix\");\n\tconst client = new PiClient({ transportFactory: createUnixTransportFactory({ path: options.socketPath }) });\n\ttry {\n\t\tawait client.connect();\n\t\t// `attachSession` antes de operar: el servidor solo entrega el runtime vivo\n\t\t// de una sesión abierta, y sin esto un `compact` sobre una sesión existente\n\t\t// pero cerrada fallaría con \"no está abierta\" sin explicar que basta con\n\t\t// engancharse.\n\t\tif (options.sessionId) await client.attachSession(options.sessionId).catch(() => undefined);\n\n\t\t// El punto de extensión del protocolo lo añadimos nosotros a\n\t\t// `packages/{client,protocol,server}`, y esos paquetes NO viajan en el\n\t\t// tarball: `@hoilab/ada-cli` los resuelve del registro de npm, así que\n\t\t// quien instala recibe los de upstream, sin este comando.\n\t\t//\n\t\t// Sin esta comprobación, `ada-cli session <id> compact` reventaba con\n\t\t// «client.extension is not a function» —un error que no dice nada de la\n\t\t// causa— en vez de explicar qué falta. Es la diferencia entre «está roto» y\n\t\t// «esto necesita una compilación desde fuentes».\n\t\tif (typeof (client as { extension?: unknown }).extension !== \"function\") {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror:\n\t\t\t\t\t\"Esta operación necesita el punto de extensión del protocolo, que solo está en una \" +\n\t\t\t\t\t\"compilación desde fuentes: el paquete publicado depende de `@earendil-works/pi-client` \" +\n\t\t\t\t\t\"del registro, que no lo trae. Compila desde el repositorio (ver la sección «Building \" +\n\t\t\t\t\t\"from source» del README) o usa el resto de subcomandos, que no lo necesitan.\",\n\t\t\t};\n\t\t}\n\n\t\tconst result = await client.extension(options.op, {\n\t\t\tsessionId: options.sessionId,\n\t\t\tpayload: options.payload,\n\t\t});\n\t\treturn { ok: result.ok, data: result.data, error: result.error };\n\t} finally {\n\t\tawait client.dispose().catch(() => {});\n\t}\n}\n"]}

package/dist/server/pi-server-service.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Implementación de `PiServerService` — sesiones residentes de Ada.
+ *
+ * Ada distribuye `packages/server` y `packages/client` de upstream desde hace
+ * versiones y NADIE los implementaba: `PiServerService` es una interfaz de 4
+ * métodos que estaba a cero. Ese era todo el hueco frente a un competidor que,
+ * tras BORRAR esos paquetes de su fork, construyó ~20k líneas de demonio a mano.
+ *
+ * Aquí solo se adapta lo que ya tenemos (SessionManager, AgentSession) a esa
+ * interfaz. El acoplamiento a un esquema que upstream marca como experimental
+ * queda contenido en este fichero y en `serve.ts`: si cambia una firma, se
+ * arregla aquí y en ningún otro sitio.
+ */
+import type { ModelMetadata, ModelRef, SessionMetadata, SessionPhase, SessionSnapshot, ThinkingLevel } from "@earendil-works/pi-protocol";
+import type { CreateSessionOptions, PiServerService, PiSessionRuntime, PiSessionRuntimeEvent, PromptInput, SteerInput } from "@earendil-works/pi-server";
+import type { AgentSession } from "../core/agent-session.ts";
+import { SessionManager } from "../core/session-manager.ts";
+/** Crea la AgentSession subyacente. Inyectable para tests. */
+export type CreateServedSession = (options: {
+    cwd: string;
+    sessionManager: SessionManager;
+    model?: ModelRef;
+    thinkingLevel?: ThinkingLevel;
+}) => Promise<AgentSession>;
+export interface AdaServerServiceOptions {
+    agentDir: string;
+    defaultCwd: string;
+    createSession: CreateServedSession;
+    listModels?: () => Promise<ModelMetadata[]>;
+}
+/**
+ * Un runtime adquirido sobre una AgentSession viva.
+ *
+ * `revision` es monótona y sube en cada evento: es lo que permite a un cliente
+ * saber que su copia está obsoleta sin comparar transcripts enteros.
+ */
+export declare class AdaSessionRuntime implements PiSessionRuntime {
+    private listeners;
+    private revision;
+    private phase;
+    private unsubscribe;
+    private disposed;
+    readonly session: AgentSession;
+    readonly sessionManager: SessionManager;
+    private createdAt;
+    constructor(session: AgentSession, sessionManager: SessionManager, createdAt: number);
+    private emit;
+    snapshot(): SessionSnapshot;
+    getPhase(): SessionPhase;
+    prompt(input: PromptInput): Promise<void>;
+    steer(input: SteerInput): Promise<void>;
+    abort(): Promise<void>;
+    setModel(model: ModelRef): Promise<void>;
+    setThinking(thinkingLevel: ThinkingLevel): Promise<void>;
+    subscribe(listener: (event: PiSessionRuntimeEvent) => void): () => void;
+    dispose(): Promise<void>;
+}
+/**
+ * Servicio de sesiones residentes.
+ *
+ * Exclusividad: una sesión abierta dos veces devuelve el MISMO runtime en vez de
+ * crear un segundo dueño de ejecución. Dos procesos escribiendo el mismo JSONL
+ * es corrupción silenciosa, y con residencia deja de ser hipotético.
+ */
+export declare class AdaServerService implements PiServerService {
+    private open;
+    private extensionHandler;
+    private options;
+    constructor(options: AdaServerServiceOptions);
+    listSessions(): Promise<SessionMetadata[]>;
+    listModels(): Promise<ModelMetadata[]>;
+    createSession(options: CreateSessionOptions): Promise<PiSessionRuntime>;
+    openSession(sessionId: string): Promise<PiSessionRuntime>;
+    /**
+     * Operaciones propias de Ada (compact/rename/fork/kill).
+     *
+     * Se delega en `extension-ops.ts` en vez de crecer aquí: el servicio es la
+     * frontera con el protocolo, no el sitio donde acumular una op por cada cosa
+     * que se le ocurra a un cliente.
+     */
+    extension(request: import("@earendil-works/pi-server").ExtensionRequest): Promise<unknown>;
+    /** Cierra todos los runtimes vivos (apagado del servidor). */
+    disposeAll(): Promise<void>;
+}
+//# sourceMappingURL=pi-server-service.d.ts.map

package/dist/server/pi-server-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-server-service.d.ts","sourceRoot":"","sources":["../../src/server/pi-server-service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Implementación de `PiServerService` — sesiones residentes de Ada.\n *\n * Ada distribuye `packages/server` y `packages/client` de upstream desde hace\n * versiones y NADIE los implementaba: `PiServerService` es una interfaz de 4\n * métodos que estaba a cero. Ese era todo el hueco frente a un competidor que,\n * tras BORRAR esos paquetes de su fork, construyó ~20k líneas de demonio a mano.\n *\n * Aquí solo se adapta lo que ya tenemos (SessionManager, AgentSession) a esa\n * interfaz. El acoplamiento a un esquema que upstream marca como experimental\n * queda contenido en este fichero y en `serve.ts`: si cambia una firma, se\n * arregla aquí y en ningún otro sitio.\n */\n\nimport type {\n\tModelMetadata,\n\tModelRef,\n\tSessionMetadata,\n\tSessionPhase,\n\tSessionSnapshot,\n\tThinkingLevel,\n} from \"@earendil-works/pi-protocol\";\nimport type {\n\tCreateSessionOptions,\n\tPiServerService,\n\tPiSessionRuntime,\n\tPiSessionRuntimeEvent,\n\tPromptInput,\n\tSteerInput,\n} from \"@earendil-works/pi-server\";\nimport type { AgentSession } from \"../core/agent-session.ts\";\nimport { SessionManager } from \"../core/session-manager.ts\";\nimport { createExtensionHandler } from \"./extension-ops.ts\";\nimport { projectTranscript } from \"./transcript.ts\";\n\n/** Crea la AgentSession subyacente. Inyectable para tests. */\nexport type CreateServedSession = (options: {\n\tcwd: string;\n\tsessionManager: SessionManager;\n\tmodel?: ModelRef;\n\tthinkingLevel?: ThinkingLevel;\n}) => Promise<AgentSession>;\n\nexport interface AdaServerServiceOptions {\n\tagentDir: string;\n\tdefaultCwd: string;\n\tcreateSession: CreateServedSession;\n\tlistModels?: () => Promise<ModelMetadata[]>;\n}\n\n/**\n * Un runtime adquirido sobre una AgentSession viva.\n *\n * `revision` es monótona y sube en cada evento: es lo que permite a un cliente\n * saber que su copia está obsoleta sin comparar transcripts enteros.\n */\nexport class AdaSessionRuntime implements PiSessionRuntime {\n\tprivate listeners = new Set<(event: PiSessionRuntimeEvent) => void>();\n\tprivate revision = 0;\n\tprivate phase: SessionPhase = \"idle\";\n\tprivate unsubscribe: (() => void) | null = null;\n\tprivate disposed = false;\n\n\t// Accesibles para las operaciones de extensión (extension-ops.ts), que\n\t// necesitan la sesión y su manager y viven fuera de esta clase para no\n\t// engordarla con una op por cada cosa que se le ocurra a un cliente.\n\treadonly session: AgentSession;\n\treadonly sessionManager: SessionManager;\n\tprivate createdAt: number;\n\n\tconstructor(session: AgentSession, sessionManager: SessionManager, createdAt: number) {\n\t\tthis.session = session;\n\t\tthis.sessionManager = sessionManager;\n\t\tthis.createdAt = createdAt;\n\t\tthis.unsubscribe = this.session.subscribe((event: { type?: string }) => {\n\t\t\t// Fase derivada de los eventos de la sesión: el cliente la pinta.\n\t\t\tif (event.type === \"agent_start\") this.phase = \"turn\";\n\t\t\telse if (event.type === \"agent_end\" || event.type === \"agent_settled\") this.phase = \"idle\";\n\t\t\tthis.revision++;\n\t\t\tthis.emit({ type: \"snapshot\" });\n\t\t});\n\t}\n\n\tprivate emit(event: PiSessionRuntimeEvent): void {\n\t\tfor (const listener of this.listeners) {\n\t\t\ttry {\n\t\t\t\tlistener(event);\n\t\t\t} catch {\n\t\t\t\t// Un cliente que revienta no debe tumbar la sesión.\n\t\t\t}\n\t\t}\n\t}\n\n\tsnapshot(): SessionSnapshot {\n\t\tconst messages = this.session.messages ?? [];\n\t\tconst model = this.session.model;\n\t\treturn {\n\t\t\tid: this.sessionManager.getSessionId(),\n\t\t\t...(this.sessionManager.getSessionName() ? { name: this.sessionManager.getSessionName() as string } : {}),\n\t\t\tcwd: this.sessionManager.getCwd() || process.cwd(),\n\t\t\tcreatedAt: this.createdAt,\n\t\t\tupdatedAt: Date.now(),\n\t\t\tphase: this.phase,\n\t\t\tmodel: { provider: model?.provider ?? \"unknown\", id: model?.id ?? \"unknown\" },\n\t\t\tthinkingLevel: (this.session.thinkingLevel ?? \"off\") as ThinkingLevel,\n\t\t\tattached: this.listeners.size > 0,\n\t\t\tlocked: false,\n\t\t\trevision: this.revision,\n\t\t\ttranscript: projectTranscript(messages as never),\n\t\t\t// El encolado de steering vive en la AgentSession y no se expone; se\n\t\t\t// declara vacío en vez de inventarlo.\n\t\t\tqueuedSteer: [],\n\t\t\tqueuedSteerCount: 0,\n\t\t};\n\t}\n\n\tgetPhase(): SessionPhase {\n\t\treturn this.phase;\n\t}\n\n\tasync prompt(input: PromptInput): Promise<void> {\n\t\tawait this.session.sendUserMessage(input.text);\n\t}\n\n\tasync steer(input: SteerInput): Promise<void> {\n\t\t// `steer` entra en el turno en curso; `prompt` abre uno nuevo.\n\t\tawait this.session.sendUserMessage(input.text, { streamingBehavior: \"steer\" } as never);\n\t}\n\n\tasync abort(): Promise<void> {\n\t\tawait this.session.abort();\n\t}\n\n\tasync setModel(model: ModelRef): Promise<void> {\n\t\t// setModel espera un Model resuelto; el protocolo manda una referencia.\n\t\tconst resolved = this.session.modelRuntime.getModel(model.provider, model.id);\n\t\tif (!resolved) throw new Error(`Modelo desconocido: ${model.provider}/${model.id}`);\n\t\tawait this.session.setModel(resolved);\n\t}\n\n\tasync setThinking(thinkingLevel: ThinkingLevel): Promise<void> {\n\t\tthis.session.setThinkingLevel(thinkingLevel as never);\n\t}\n\n\tsubscribe(listener: (event: PiSessionRuntimeEvent) => void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => {\n\t\t\tthis.listeners.delete(listener);\n\t\t};\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.unsubscribe?.();\n\t\tthis.unsubscribe = null;\n\t\tthis.listeners.clear();\n\t}\n}\n\n/**\n * Servicio de sesiones residentes.\n *\n * Exclusividad: una sesión abierta dos veces devuelve el MISMO runtime en vez de\n * crear un segundo dueño de ejecución. Dos procesos escribiendo el mismo JSONL\n * es corrupción silenciosa, y con residencia deja de ser hipotético.\n */\nexport class AdaServerService implements PiServerService {\n\tprivate open = new Map<string, AdaSessionRuntime>();\n\tprivate extensionHandler: ReturnType<typeof createExtensionHandler> | undefined;\n\n\tprivate options: AdaServerServiceOptions;\n\n\tconstructor(options: AdaServerServiceOptions) {\n\t\tthis.options = options;\n\t}\n\n\tasync listSessions(): Promise<SessionMetadata[]> {\n\t\tconst sessions = await SessionManager.list(this.options.defaultCwd);\n\t\treturn sessions.map((s) => ({\n\t\t\tid: s.id,\n\t\t\tcreatedAt: s.created instanceof Date ? s.created.getTime() : 0,\n\t\t\t...(s.modified instanceof Date ? { updatedAt: s.modified.getTime() } : {}),\n\t\t\t...(s.name ? { sessionName: s.name } : {}),\n\t\t\t...(s.cwd ? { cwd: s.cwd } : {}),\n\t\t}));\n\t}\n\n\tasync listModels(): Promise<ModelMetadata[]> {\n\t\treturn (await this.options.listModels?.()) ?? [];\n\t}\n\n\tasync createSession(options: CreateSessionOptions): Promise<PiSessionRuntime> {\n\t\tconst cwd = options.cwd ?? this.options.defaultCwd;\n\t\tconst sessionManager = SessionManager.create(cwd);\n\t\tconst session = await this.options.createSession({\n\t\t\tcwd,\n\t\t\tsessionManager,\n\t\t\tmodel: options.model,\n\t\t\tthinkingLevel: options.thinkingLevel,\n\t\t});\n\t\tif (options.name) sessionManager.appendSessionInfo(options.name);\n\t\tconst runtime = new AdaSessionRuntime(session, sessionManager, Date.now());\n\t\t// PiServer asigna el id; se persiste ese exacto para poder reabrir.\n\t\tthis.open.set(options.id, runtime);\n\t\tthis.open.set(sessionManager.getSessionId(), runtime);\n\t\treturn runtime;\n\t}\n\n\tasync openSession(sessionId: string): Promise<PiSessionRuntime> {\n\t\tconst existing = this.open.get(sessionId);\n\t\tif (existing) return existing;\n\t\tconst sessions = await SessionManager.list(this.options.defaultCwd);\n\t\tconst found = sessions.find((s) => s.id === sessionId || s.id.startsWith(sessionId));\n\t\tif (!found) throw new Error(`Sesión no encontrada: ${sessionId}`);\n\t\tconst sessionManager = SessionManager.open(found.path, undefined, found.cwd || this.options.defaultCwd);\n\t\tconst session = await this.options.createSession({ cwd: found.cwd || this.options.defaultCwd, sessionManager });\n\t\tconst runtime = new AdaSessionRuntime(session, sessionManager, found.created?.getTime?.() ?? Date.now());\n\t\tthis.open.set(sessionId, runtime);\n\t\treturn runtime;\n\t}\n\n\t/**\n\t * Operaciones propias de Ada (compact/rename/fork/kill).\n\t *\n\t * Se delega en `extension-ops.ts` en vez de crecer aquí: el servicio es la\n\t * frontera con el protocolo, no el sitio donde acumular una op por cada cosa\n\t * que se le ocurra a un cliente.\n\t */\n\tasync extension(request: import(\"@earendil-works/pi-server\").ExtensionRequest): Promise<unknown> {\n\t\tthis.extensionHandler ??= createExtensionHandler({\n\t\t\tforget: (sessionId) => {\n\t\t\t\t// Se retiran TODOS los alias del runtime: `createSession` registra el\n\t\t\t\t// id del servidor y el del SessionManager, y dejar uno colgando haría\n\t\t\t\t// que un `open` posterior devolviera un runtime ya cerrado.\n\t\t\t\tconst runtime = this.open.get(sessionId);\n\t\t\t\tif (!runtime) return;\n\t\t\t\tfor (const [key, value] of [...this.open]) {\n\t\t\t\t\tif (value === runtime) this.open.delete(key);\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\treturn this.extensionHandler(request);\n\t}\n\n\t/** Cierra todos los runtimes vivos (apagado del servidor). */\n\tasync disposeAll(): Promise<void> {\n\t\tconst seen = new Set<AdaSessionRuntime>();\n\t\tfor (const runtime of this.open.values()) {\n\t\t\tif (seen.has(runtime)) continue;\n\t\t\tseen.add(runtime);\n\t\t\tawait runtime.dispose();\n\t\t}\n\t\tthis.open.clear();\n\t}\n}\n"]}