@nac3/forge-cli 1.23.2 → 1.23.4

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/chat/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/chat/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAKjG,OAAO,EAAoD,KAAK,aAAa,EAAoB,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAczB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsBjD,OAAO,EAAyD,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAwC1H,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;;;;wDAQoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAAC;IACnD;;2DAEuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;+CAC2C;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;kEAG8D;IAC9D,OAAO,CAAC,EAAE,OAAO,sBAAsB,EAAE,OAAO,CAAC;IACjD;;;;;;;iDAO6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;oDAEgD;IAChD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ;qEACiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B;;;oCAGgC;IAChC,MAAM,CAAC,EAAE,OAAO,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnD;;;;sCAIkC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;KAC/D,CAAC,CAAC;CACJ;AAqBD,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAytBhF;AAED,UAAU,GAAG;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IAIvB,OAAO,CAAC,EAAE,OAAO,sBAAsB,EAAE,OAAO,CAAC;IAMjD,YAAY,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAKnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAG3G,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlE,MAAM,CAAC,EAAE,OAAO,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;CACpD;AAwJD;;;;+EAI+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAOV;AAqrMD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,IAAI,GAAE,SAAuB,EAC7B,UAAU,GAAE;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAErF;AACD;;;qDAGqD;AACrD,KAAK,CAAC,EAAE;IAAE,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACrE;;;;;2CAK2C;AAC3C,sBAAsB,GAAE,MAAW;AACnC;;;;;;;4DAO4D;AAC5D,YAAY,GAAE,OAAe;AAC7B;;;;;;;uDAOuD;AACvD,mBAAmB,GAAE,MAAW;AAChC;;;;kEAIkE;AAClE,gBAAgB,GAAE,MAAW;AAC7B;;;;;;;;;;;+BAW+B;AAC/B,SAAS,GAAE,QAAQ,GAAG,YAAY,GAAG,MAAiB;AACtD;;;;;mEAKmE;AACnE,eAAe,CAAC,EAAE,eAAe;AACjC;;;yEAGyE;AACzE,iBAAiB,GAAE,OAAe,GACjC,MAAM,CAojBR;AAED;;;;2EAI2E;AAC3E,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,OAAO,EAClB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GACzC,MAAM,CAgCR"}

package/dist/chat/server.js

@@ -58,6 +58,9 @@ import { getInstanceIdentity } from '../relay/instance_identity.js';
 import { isMobilePaired, relayGate } from '../core/mobile_pairing_state.js';
 import { relayPoll } from '../relay/relay_client.js';
 import { startCommandConsumer } from '../relay/command_consumer.js';
+import { postChatTurn } from '../relay/loopback_turn.js';
+import { forgeErrorOf } from '../core/error_catalog.js';
+import { formatForgeErrorText } from '../core/error_formatter.js';
 import { getSessionStore, DEFAULT_SESSION_ID } from './session_store.js';
 import { getSessionProject, setSessionProject } from './session_projects.js';
 import { beginTurn, endTurn, interruptActiveTurn, interruptAllTurns, isTurnActive, activeTurnId, activeTurns, } from './turn_control.js';
@@ -1163,10 +1166,15 @@ function startDesktopCommandConsumer(port, coord = {}) {
         void pub.flush(); /* push the reply promptly, do not wait the window */
     };
     const runTurn = async (text, sessionId, projectSlug) => {
-        const resp = await fetch('http://127.0.0.1:' + port + '/api/chat', {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify({
+        /* El POST va por node:http y no por fetch, y con un presupuesto de turno
+         * y no de llamada corta: las cabeceras de esta respuesta recien salen
+         * cuando el turno TERMINO, y el limite que fetch hereda de undici son
+         * cinco minutos medidos, asi que todo turno mas largo moria con "fetch
+         * failed" aunque el escritorio lo terminara bien (PND-234). El porque
+         * completo, con la medicion, esta en src/relay/loopback_turn.ts. */
+        const resp = await postChatTurn({
+            port,
+            payload: {
                 messages: [{ role: 'user', content: text }],
                 ...(sessionId ? { session_id: sessionId } : {}),
                 /* Bind the turn to the project the phone composed it against
@@ -1178,13 +1186,33 @@ function startDesktopCommandConsumer(port, coord = {}) {
                  * the unified-thread ones to the panel (the laptop sees what was
                  * asked from the phone). */
                 origin: 'mobile',
-            }),
+            },
         });
-        const j = await resp.json();
+        /* Un cuerpo que no es JSON no se puede reportar como "turn failed": eso
+         * esconderia un 500 con una pagina de error adentro. Se dice que la
+         * respuesta no se pudo leer y se deja el status, que es lo que permite
+         * diagnosticarlo. */
+        let j;
+        try {
+            j = JSON.parse(resp.body);
+        }
+        catch {
+            throw new Error('respuesta no interpretable del servidor de chat (HTTP '
+                + resp.status + ')');
+        }
         if (!j || j.ok === false)
             throw new Error(j?.error || 'turn failed');
         return String(j.message?.text ?? '');
     };
+    /* Como se le cuenta al telefono un turno que fallo. El consumidor no
+     * importa el catalogo de i18n a proposito (no toca el disco, para poder
+     * probarse sin red ni servidor), asi que el renderizado se inyecta desde
+     * aca, que ya lo tiene cargado. Devolver null significa "no tengo nada
+     * mejor": el consumidor cae a su texto de siempre. */
+    const describeError = (e) => {
+        const forge = forgeErrorOf(e);
+        return forge ? formatForgeErrorText(forge) : null;
+    };
     const onControl = async (action, args) => {
         /* Control commands from the phone (tasks #33, #29) go through the
          * same loopback the chat turns use -- no extra coupling. */
@@ -1313,7 +1341,7 @@ function startDesktopCommandConsumer(port, coord = {}) {
          * slug names a peer's project (board.activeProject races between instances),
          * so no instance ran it and the phone hung on "working". */
         accept: (c) => !c.control && (!!c.targetInstance || ownsChatCommand(c.projectSlug)),
-        pollCommands, runTurn, reply,
+        pollCommands, runTurn, reply, describeError,
         ackImmediate: true, /* confirm receipt before the turn runs */
         onError: () => { },
     });
@@ -1321,7 +1349,7 @@ function startDesktopCommandConsumer(port, coord = {}) {
         enabled: relayEnabled, intervalMs: 1200,
         instanceId: selfInstanceId,
         accept: (c) => !!c.control,
-        pollCommands, runTurn, onControl, reply,
+        pollCommands, runTurn, onControl, reply, describeError,
         onError: () => { },
     });
     /* Item 2 (cross-machine): advertise this instance's presence so the phone
@@ -1571,11 +1599,25 @@ async function handleForgeTaskDelete(req, res, ctx) {
  * is thinking (Pablo 2026-09-02). Replaces the per-tool activity stream, which
  * was the bulk of the relay's Cloudflare appends and only calmed anxiety. The
  * pizarron (board) still refreshes -- THAT is the signal that adds value. */
-let _relayHeartbeat = null;
-function stopRelayHeartbeat() {
-    if (_relayHeartbeat) {
-        clearInterval(_relayHeartbeat);
-        _relayHeartbeat = null;
+/* UN latido POR TURNO, no uno por proceso (PND-237). Era un solo timer de
+ * modulo y `startRelayHeartbeat()` arrancaba con un `stop()`, asi que con
+ * turnos solapados -- que es lo normal en un panel -- el arranque de B mataba
+ * el latido de A, y el cierre de A mataba el de B. Un turno sin latido deja de
+ * dar senal de vida, y como la senal es lo unico que lo sostiene en el
+ * registro, el anuncio quedaba a merced de cual timer sobrevivio. */
+const _relayHeartbeats = new Map();
+/** Para el latido de `id`; sin `id`, TODOS (apagado del servidor). */
+function stopRelayHeartbeat(id) {
+    if (!id) {
+        for (const t of _relayHeartbeats.values())
+            clearInterval(t);
+        _relayHeartbeats.clear();
+        return;
+    }
+    const t = _relayHeartbeats.get(id);
+    if (t) {
+        clearInterval(t);
+        _relayHeartbeats.delete(id);
     }
 }
 /**
@@ -1608,19 +1650,28 @@ function turnoVivoSinAnunciar() {
         return null;
     }
 }
-function startRelayHeartbeat() {
-    stopRelayHeartbeat();
-    _relayHeartbeat = setInterval(() => {
+/**
+ * Arranca el latido DE ESTE turno. El id no es decorativo: es lo que ata la
+ * senal de vida a quien la produce (PND-237). Sin turno identificado no hay
+ * latido -- un pulso anonimo es justo el que mantenia vivo el anuncio de un
+ * turno ajeno.
+ */
+function startRelayHeartbeat(turnId) {
+    if (!turnId)
+        return;
+    stopRelayHeartbeat(turnId);
+    const t = setInterval(() => {
         /* SENAL DE VIDA del turno, antes que cualquier otra cosa. Este timer corre
-         * SOLO entre turn_start y turn_complete, asi que su pulso ES la prueba de
-         * que el turno sigue vivo -- y es lo que hace que un turno de tres horas se
-         * siga anunciando. Va primero y fuera del try del publisher: que no haya
-         * telefono pareado no significa que el turno este muerto. */
-        touchInFlightTurn();
+         * SOLO entre el turn_start y el turn_complete DE ESTE turno, asi que su
+         * pulso ES la prueba de que el turno sigue vivo -- y es lo que hace que un
+         * turno de tres horas se siga anunciando. Va primero y fuera del try del
+         * publisher: que no haya telefono pareado no significa que el turno este
+         * muerto. */
+        touchInFlightTurn(turnId);
         try {
             const pub = getRelayPublisher();
             if (!pub) {
-                stopRelayHeartbeat();
+                stopRelayHeartbeat(turnId);
                 return;
             }
             pub.activity('remote running...', { kind: 'heartbeat' });
@@ -1628,8 +1679,9 @@ function startRelayHeartbeat() {
         }
         catch { /* best-effort */ }
     }, PULSO_DE_PROGRESO_MS);
-    if (typeof _relayHeartbeat.unref === 'function')
-        _relayHeartbeat.unref();
+    _relayHeartbeats.set(turnId, t);
+    if (typeof t.unref === 'function')
+        t.unref();
 }
 function relayForward(event, data) {
     const pub = getRelayPublisher();
@@ -1637,19 +1689,24 @@ function relayForward(event, data) {
         return;
     try {
         const d = (data && typeof data === 'object') ? data : {};
+        /* El id del turno viaja en el evento (PND-237): el latido y el registro de
+         * turnos vivos son POR TURNO, asi que hay que saber de cual se habla. Un
+         * evento sin id no toca ningun timer -- antes que matar el latido de otro
+         * turno, preferimos dejar que este venza por silencio. */
+        const tid = typeof d.turn_id === 'string' ? d.turn_id : '';
         /* tool_round_start: intentionally NO relay activity anymore -- the granular
          * per-tool feed was the append-heavy part; the phone now gets a heartbeat. */
         if (event === 'turn_start') {
             pub.status('working', { tier: d.tier, provider: d.provider, model: d.model });
             pub.activity('remote running...', { kind: 'heartbeat' }); /* first line now; then every 60s */
-            startRelayHeartbeat();
+            startRelayHeartbeat(tid);
             /* El turno en vuelo viaja DENTRO del latido (in_flight_turn.ts): hay que
              * publicarlo ya, sin esperar el tick, o el telefono no sabe que hay algo
              * corriendo hasta la proxima evaluacion. */
             forcePresenceBeat();
         }
         else if (event === 'turn_complete') {
-            stopRelayHeartbeat();
+            stopRelayHeartbeat(tid);
             pub.status('round_done');
             /* Simetrico: el latido tiene que dejar de anunciar el turno, o el
              * telefono sigue mostrando la burbuja "pensando" hasta el proximo. */
@@ -1659,7 +1716,7 @@ function relayForward(event, data) {
             publishBoardSnapshot();
         }
         else if (event === 'error') {
-            stopRelayHeartbeat();
+            stopRelayHeartbeat(tid);
             pub.status('error', { message: d.message ?? d.error ?? '' });
         }
     }
@@ -6119,6 +6176,11 @@ async function handleChat(req, res, ctx) {
      * del turno en vuelo -- y lo que se declara dentro del try no se ve desde
      * ahi. Mismo motivo por el que turnId vive en este nivel. */
     let turnEcho = null;
+    /* El id del turno para el LATIDO, en este nivel por el mismo motivo que
+     * turnEcho: el finally tiene que poder apagarlo y `_xTurnId` se declara
+     * dentro del try. Y no alcanza con turnEcho: ese se saltea los turnos de
+     * origen mobile, pero el latido se arranca para TODOS (PND-237). */
+    let latidoTurnId = null;
     /* alpha.59e -- SSE streaming mode. Client opts in via
      * body.stream=true. We keep the response open + emit events
      * during the tool loop instead of bundling everything in a
@@ -6294,6 +6356,7 @@ async function handleChat(req, res, ctx) {
          *    the END remoteTurn (same id) fills the reply. Old phones ignore
          *    the extra fields and keep their current end-of-turn behavior. */
         const _xTurnId = (body.origin === 'mobile' ? 'mb-' : body.origin === 'bridge' ? 'br-' : 'dt-') + Date.now().toString(36);
+        latidoTurnId = _xTurnId;
         /* Queda registrado como ESTADO para que el latido de presencia lo
          * repita: ver el comentario largo en RelayPublisher.presence().
          *
@@ -6460,6 +6523,11 @@ async function handleChat(req, res, ctx) {
                 /* PND-132 -- so the relay activity feed shows what is being processed
                  * (a per-turn heartbeat), not just tool rounds. */
                 user_text: lastUserText.slice(0, 80),
+                /* PND-237 -- QUIEN arranca. El latido del relay y el registro de turnos
+                 * vivos son por turno; sin el id, relayForward no sabe a cual atar el
+                 * pulso y el panel vuelve a tener un unico timer que los turnos
+                 * solapados se pisan entre si. */
+                turn_id: _xTurnId,
             });
         }
         /* alpha.59e -- loop detection counter. We track (verb_id +
@@ -7446,6 +7514,10 @@ async function handleChat(req, res, ctx) {
         const responsePayload = {
             ok: true,
             message: { role: 'assistant', text: reply.text },
+            /* PND-237 -- QUIEN termina. Simetrico al turn_start: relayForward para el
+             * latido DE ESTE turno y no el del turno de al lado, que es lo que pasaba
+             * con un unico timer de modulo. */
+            turn_id: _xTurnId,
             /* Interrupt (task #27): tell the panel the turn was stopped
              * mid-flight so it can render the partial answer with a
              * "(interrumpido)" marker instead of treating it as complete. */
@@ -7604,6 +7676,15 @@ async function handleChat(req, res, ctx) {
          * de un turno que ya arranco despues. */
         if (turnEcho)
             clearInFlightTurn(turnEcho.id);
+        /* Y el LATIDO de este turno, por el mismo motivo y en el mismo lugar
+         * (PND-237). Va aca y no en cada rama de error -- son cinco emisores de
+         * `error` y la quinta se iba a olvidar -- porque el finally es el unico
+         * punto por el que pasan TODAS las salidas. Un latido que sobrevive a su
+         * turno sigue dando senal de vida por el, y entonces el tope de silencio
+         * nunca lo saca del registro: es la mitad que convierte un turno colgado
+         * en un turno que se anuncia para siempre. */
+        if (latidoTurnId)
+            stopRelayHeartbeat(latidoTurnId);
         /* Interrupt (task #27): always clear this turn from the active
          * registry, no matter how the turn exits. endTurn is a no-op if a
          * newer turn has already replaced us, so it never clobbers a