@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/server/pi-server-service.js

@@ -0,0 +1,213 @@
+/**
+ * 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 { SessionManager } from "../core/session-manager.js";
+import { createExtensionHandler } from "./extension-ops.js";
+import { projectTranscript } from "./transcript.js";
+/**
+ * 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 class AdaSessionRuntime {
+    listeners = new Set();
+    revision = 0;
+    phase = "idle";
+    unsubscribe = null;
+    disposed = false;
+    // Accesibles para las operaciones de extensión (extension-ops.ts), que
+    // necesitan la sesión y su manager y viven fuera de esta clase para no
+    // engordarla con una op por cada cosa que se le ocurra a un cliente.
+    session;
+    sessionManager;
+    createdAt;
+    constructor(session, sessionManager, createdAt) {
+        this.session = session;
+        this.sessionManager = sessionManager;
+        this.createdAt = createdAt;
+        this.unsubscribe = this.session.subscribe((event) => {
+            // Fase derivada de los eventos de la sesión: el cliente la pinta.
+            if (event.type === "agent_start")
+                this.phase = "turn";
+            else if (event.type === "agent_end" || event.type === "agent_settled")
+                this.phase = "idle";
+            this.revision++;
+            this.emit({ type: "snapshot" });
+        });
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Un cliente que revienta no debe tumbar la sesión.
+            }
+        }
+    }
+    snapshot() {
+        const messages = this.session.messages ?? [];
+        const model = this.session.model;
+        return {
+            id: this.sessionManager.getSessionId(),
+            ...(this.sessionManager.getSessionName() ? { name: this.sessionManager.getSessionName() } : {}),
+            cwd: this.sessionManager.getCwd() || process.cwd(),
+            createdAt: this.createdAt,
+            updatedAt: Date.now(),
+            phase: this.phase,
+            model: { provider: model?.provider ?? "unknown", id: model?.id ?? "unknown" },
+            thinkingLevel: (this.session.thinkingLevel ?? "off"),
+            attached: this.listeners.size > 0,
+            locked: false,
+            revision: this.revision,
+            transcript: projectTranscript(messages),
+            // El encolado de steering vive en la AgentSession y no se expone; se
+            // declara vacío en vez de inventarlo.
+            queuedSteer: [],
+            queuedSteerCount: 0,
+        };
+    }
+    getPhase() {
+        return this.phase;
+    }
+    async prompt(input) {
+        await this.session.sendUserMessage(input.text);
+    }
+    async steer(input) {
+        // `steer` entra en el turno en curso; `prompt` abre uno nuevo.
+        await this.session.sendUserMessage(input.text, { streamingBehavior: "steer" });
+    }
+    async abort() {
+        await this.session.abort();
+    }
+    async setModel(model) {
+        // setModel espera un Model resuelto; el protocolo manda una referencia.
+        const resolved = this.session.modelRuntime.getModel(model.provider, model.id);
+        if (!resolved)
+            throw new Error(`Modelo desconocido: ${model.provider}/${model.id}`);
+        await this.session.setModel(resolved);
+    }
+    async setThinking(thinkingLevel) {
+        this.session.setThinkingLevel(thinkingLevel);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.listeners.clear();
+    }
+}
+/**
+ * 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 class AdaServerService {
+    open = new Map();
+    extensionHandler;
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async listSessions() {
+        const sessions = await SessionManager.list(this.options.defaultCwd);
+        return sessions.map((s) => ({
+            id: s.id,
+            createdAt: s.created instanceof Date ? s.created.getTime() : 0,
+            ...(s.modified instanceof Date ? { updatedAt: s.modified.getTime() } : {}),
+            ...(s.name ? { sessionName: s.name } : {}),
+            ...(s.cwd ? { cwd: s.cwd } : {}),
+        }));
+    }
+    async listModels() {
+        return (await this.options.listModels?.()) ?? [];
+    }
+    async createSession(options) {
+        const cwd = options.cwd ?? this.options.defaultCwd;
+        const sessionManager = SessionManager.create(cwd);
+        const session = await this.options.createSession({
+            cwd,
+            sessionManager,
+            model: options.model,
+            thinkingLevel: options.thinkingLevel,
+        });
+        if (options.name)
+            sessionManager.appendSessionInfo(options.name);
+        const runtime = new AdaSessionRuntime(session, sessionManager, Date.now());
+        // PiServer asigna el id; se persiste ese exacto para poder reabrir.
+        this.open.set(options.id, runtime);
+        this.open.set(sessionManager.getSessionId(), runtime);
+        return runtime;
+    }
+    async openSession(sessionId) {
+        const existing = this.open.get(sessionId);
+        if (existing)
+            return existing;
+        const sessions = await SessionManager.list(this.options.defaultCwd);
+        const found = sessions.find((s) => s.id === sessionId || s.id.startsWith(sessionId));
+        if (!found)
+            throw new Error(`Sesión no encontrada: ${sessionId}`);
+        const sessionManager = SessionManager.open(found.path, undefined, found.cwd || this.options.defaultCwd);
+        const session = await this.options.createSession({ cwd: found.cwd || this.options.defaultCwd, sessionManager });
+        const runtime = new AdaSessionRuntime(session, sessionManager, found.created?.getTime?.() ?? Date.now());
+        this.open.set(sessionId, runtime);
+        return runtime;
+    }
+    /**
+     * 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.
+     */
+    async extension(request) {
+        this.extensionHandler ??= createExtensionHandler({
+            forget: (sessionId) => {
+                // Se retiran TODOS los alias del runtime: `createSession` registra el
+                // id del servidor y el del SessionManager, y dejar uno colgando haría
+                // que un `open` posterior devolviera un runtime ya cerrado.
+                const runtime = this.open.get(sessionId);
+                if (!runtime)
+                    return;
+                for (const [key, value] of [...this.open]) {
+                    if (value === runtime)
+                        this.open.delete(key);
+                }
+            },
+        });
+        return this.extensionHandler(request);
+    }
+    /** Cierra todos los runtimes vivos (apagado del servidor). */
+    async disposeAll() {
+        const seen = new Set();
+        for (const runtime of this.open.values()) {
+            if (seen.has(runtime))
+                continue;
+            seen.add(runtime);
+            await runtime.dispose();
+        }
+        this.open.clear();
+    }
+}
+//# sourceMappingURL=pi-server-service.js.map

package/dist/server/pi-server-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-server-service.js","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"]}

package/dist/server/scheduler-tick.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Reloj del scheduler dentro de `ada-cli serve`.
+ *
+ * El `Scheduler` sabe qué toca ejecutar (`claimDue`) y cómo cerrar una ejecución
+ * (`complete`), pero no ejecuta nada: necesita un proceso vivo que le pregunte.
+ * Ese proceso es el servidor, que es justamente el que ya mantiene sesiones
+ * residentes.
+ *
+ * Cada job entrega su prompt a una sesión propia. No se reutiliza una sesión
+ * compartida a propósito: dos jobs recurrentes escribiendo en el mismo historial
+ * se contaminarían el contexto mutuamente.
+ */
+import type { Scheduler } from "../core/scheduler/scheduler.ts";
+export interface SchedulerTickOptions {
+    scheduler: Scheduler;
+    /** Entrega el prompt de un job. Devuelve false si falló. */
+    dispatch: (job: {
+        id: string;
+        prompt: string;
+    }) => Promise<boolean>;
+    intervalMs?: number;
+    /** Reloj inyectable para los tests. */
+    now?: () => string;
+    onError?: (error: Error) => void;
+}
+export interface SchedulerTickHandle {
+    stop: () => void;
+    /** Ejecuta un ciclo ahora mismo. Para tests y para el arranque. */
+    tick: () => Promise<number>;
+}
+export declare function startSchedulerTick(options: SchedulerTickOptions): SchedulerTickHandle;
+//# sourceMappingURL=scheduler-tick.d.ts.map

package/dist/server/scheduler-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-tick.d.ts","sourceRoot":"","sources":["../../src/server/scheduler-tick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,6DAA4D;IAC5D,QAAQ,EAAE,CAAC,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mEAAmE;IACnE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAmCrF","sourcesContent":["/**\n * Reloj del scheduler dentro de `ada-cli serve`.\n *\n * El `Scheduler` sabe qué toca ejecutar (`claimDue`) y cómo cerrar una ejecución\n * (`complete`), pero no ejecuta nada: necesita un proceso vivo que le pregunte.\n * Ese proceso es el servidor, que es justamente el que ya mantiene sesiones\n * residentes.\n *\n * Cada job entrega su prompt a una sesión propia. No se reutiliza una sesión\n * compartida a propósito: dos jobs recurrentes escribiendo en el mismo historial\n * se contaminarían el contexto mutuamente.\n */\n\nimport type { Scheduler } from \"../core/scheduler/scheduler.ts\";\n\nexport interface SchedulerTickOptions {\n\tscheduler: Scheduler;\n\t/** Entrega el prompt de un job. Devuelve false si falló. */\n\tdispatch: (job: { id: string; prompt: string }) => Promise<boolean>;\n\tintervalMs?: number;\n\t/** Reloj inyectable para los tests. */\n\tnow?: () => string;\n\tonError?: (error: Error) => void;\n}\n\nexport interface SchedulerTickHandle {\n\tstop: () => void;\n\t/** Ejecuta un ciclo ahora mismo. Para tests y para el arranque. */\n\ttick: () => Promise<number>;\n}\n\nexport function startSchedulerTick(options: SchedulerTickOptions): SchedulerTickHandle {\n\tconst now = options.now ?? (() => new Date().toISOString());\n\tconst intervalMs = options.intervalMs ?? 30_000;\n\n\t// Al arrancar se liberan las ejecuciones que murieron con el proceso\n\t// anterior: sin esto un crash deja el job marcado \"en vuelo\" para siempre y\n\t// no se vuelve a entregar nunca.\n\toptions.scheduler.reconcile(now());\n\n\tconst tick = async (): Promise<number> => {\n\t\tlet dispatched = 0;\n\t\tfor (const { dispatchId, job } of options.scheduler.claimDue(now())) {\n\t\t\ttry {\n\t\t\t\tconst ok = await options.dispatch({ id: job.id, prompt: job.prompt });\n\t\t\t\toptions.scheduler.complete(dispatchId, ok);\n\t\t\t\tif (ok) dispatched++;\n\t\t\t} catch (error) {\n\t\t\t\t// Un job que revienta se cierra como fallo y NO tumba el reloj: el\n\t\t\t\t// resto de trabajos programados no tienen la culpa.\n\t\t\t\toptions.scheduler.complete(dispatchId, false);\n\t\t\t\toptions.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t}\n\t\treturn dispatched;\n\t};\n\n\tconst timer = setInterval(() => {\n\t\tvoid tick().catch((error: unknown) => {\n\t\t\toptions.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t});\n\t}, intervalMs);\n\t// El reloj no debe impedir que el proceso termine si todo lo demás acabó.\n\ttimer.unref?.();\n\n\treturn { stop: () => clearInterval(timer), tick };\n}\n"]}

package/dist/server/scheduler-tick.js

@@ -0,0 +1,47 @@
+/**
+ * Reloj del scheduler dentro de `ada-cli serve`.
+ *
+ * El `Scheduler` sabe qué toca ejecutar (`claimDue`) y cómo cerrar una ejecución
+ * (`complete`), pero no ejecuta nada: necesita un proceso vivo que le pregunte.
+ * Ese proceso es el servidor, que es justamente el que ya mantiene sesiones
+ * residentes.
+ *
+ * Cada job entrega su prompt a una sesión propia. No se reutiliza una sesión
+ * compartida a propósito: dos jobs recurrentes escribiendo en el mismo historial
+ * se contaminarían el contexto mutuamente.
+ */
+export function startSchedulerTick(options) {
+    const now = options.now ?? (() => new Date().toISOString());
+    const intervalMs = options.intervalMs ?? 30_000;
+    // Al arrancar se liberan las ejecuciones que murieron con el proceso
+    // anterior: sin esto un crash deja el job marcado "en vuelo" para siempre y
+    // no se vuelve a entregar nunca.
+    options.scheduler.reconcile(now());
+    const tick = async () => {
+        let dispatched = 0;
+        for (const { dispatchId, job } of options.scheduler.claimDue(now())) {
+            try {
+                const ok = await options.dispatch({ id: job.id, prompt: job.prompt });
+                options.scheduler.complete(dispatchId, ok);
+                if (ok)
+                    dispatched++;
+            }
+            catch (error) {
+                // Un job que revienta se cierra como fallo y NO tumba el reloj: el
+                // resto de trabajos programados no tienen la culpa.
+                options.scheduler.complete(dispatchId, false);
+                options.onError?.(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        return dispatched;
+    };
+    const timer = setInterval(() => {
+        void tick().catch((error) => {
+            options.onError?.(error instanceof Error ? error : new Error(String(error)));
+        });
+    }, intervalMs);
+    // El reloj no debe impedir que el proceso termine si todo lo demás acabó.
+    timer.unref?.();
+    return { stop: () => clearInterval(timer), tick };
+}
+//# sourceMappingURL=scheduler-tick.js.map

package/dist/server/scheduler-tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-tick.js","sourceRoot":"","sources":["../../src/server/scheduler-tick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,MAAM,UAAU,kBAAkB,CAAC,OAA6B,EAAuB;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;IAEhD,qEAAqE;IACrE,4EAA4E;IAC5E,iCAAiC;IACjC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,KAAK,IAAqB,EAAE,CAAC;QACzC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC;gBACJ,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBACtE,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,EAAE;oBAAE,UAAU,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,mEAAmE;gBACnE,oDAAoD;gBACpD,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC9C,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9E,CAAC;QACF,CAAC;QACD,OAAO,UAAU,CAAC;IAAA,CAClB,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC/B,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC;YACrC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAAA,CAC7E,CAAC,CAAC;IAAA,CACH,EAAE,UAAU,CAAC,CAAC;IACf,4EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAEhB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;AAAA,CAClD","sourcesContent":["/**\n * Reloj del scheduler dentro de `ada-cli serve`.\n *\n * El `Scheduler` sabe qué toca ejecutar (`claimDue`) y cómo cerrar una ejecución\n * (`complete`), pero no ejecuta nada: necesita un proceso vivo que le pregunte.\n * Ese proceso es el servidor, que es justamente el que ya mantiene sesiones\n * residentes.\n *\n * Cada job entrega su prompt a una sesión propia. No se reutiliza una sesión\n * compartida a propósito: dos jobs recurrentes escribiendo en el mismo historial\n * se contaminarían el contexto mutuamente.\n */\n\nimport type { Scheduler } from \"../core/scheduler/scheduler.ts\";\n\nexport interface SchedulerTickOptions {\n\tscheduler: Scheduler;\n\t/** Entrega el prompt de un job. Devuelve false si falló. */\n\tdispatch: (job: { id: string; prompt: string }) => Promise<boolean>;\n\tintervalMs?: number;\n\t/** Reloj inyectable para los tests. */\n\tnow?: () => string;\n\tonError?: (error: Error) => void;\n}\n\nexport interface SchedulerTickHandle {\n\tstop: () => void;\n\t/** Ejecuta un ciclo ahora mismo. Para tests y para el arranque. */\n\ttick: () => Promise<number>;\n}\n\nexport function startSchedulerTick(options: SchedulerTickOptions): SchedulerTickHandle {\n\tconst now = options.now ?? (() => new Date().toISOString());\n\tconst intervalMs = options.intervalMs ?? 30_000;\n\n\t// Al arrancar se liberan las ejecuciones que murieron con el proceso\n\t// anterior: sin esto un crash deja el job marcado \"en vuelo\" para siempre y\n\t// no se vuelve a entregar nunca.\n\toptions.scheduler.reconcile(now());\n\n\tconst tick = async (): Promise<number> => {\n\t\tlet dispatched = 0;\n\t\tfor (const { dispatchId, job } of options.scheduler.claimDue(now())) {\n\t\t\ttry {\n\t\t\t\tconst ok = await options.dispatch({ id: job.id, prompt: job.prompt });\n\t\t\t\toptions.scheduler.complete(dispatchId, ok);\n\t\t\t\tif (ok) dispatched++;\n\t\t\t} catch (error) {\n\t\t\t\t// Un job que revienta se cierra como fallo y NO tumba el reloj: el\n\t\t\t\t// resto de trabajos programados no tienen la culpa.\n\t\t\t\toptions.scheduler.complete(dispatchId, false);\n\t\t\t\toptions.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t}\n\t\treturn dispatched;\n\t};\n\n\tconst timer = setInterval(() => {\n\t\tvoid tick().catch((error: unknown) => {\n\t\t\toptions.onError?.(error instanceof Error ? error : new Error(String(error)));\n\t\t});\n\t}, intervalMs);\n\t// El reloj no debe impedir que el proceso termine si todo lo demás acabó.\n\ttimer.unref?.();\n\n\treturn { stop: () => clearInterval(timer), tick };\n}\n"]}

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