@thegitai/cli 1.0.0-preview.39 → 1.0.0-preview.40

package/dist/src/api/chat.js

@@ -4,7 +4,7 @@ import { applySessionSnapshot, saveSessionState, snapshotFromSession, } from '..
 import { executeLocalToolCall } from '../tool-executor.js';
 import { saveGeneratedImage } from '../tools/save-generated-image.js';
 import { isUserInputQuestionArray } from './contracts.js';
-import { createTraceContext, gatewayFailureCategory, normalizeServerUrl, readErrorResponse, } from './http.js';
+import { createTraceContext, gatewayFailureCategory, transportFailureDetail, normalizeServerUrl, readErrorResponse, } from './http.js';
 import { collectClientEnvironment } from '../client-environment.js';
 import { collectProjectOrientation } from '../project-orientation.js';
 import { describeSessionImageStore } from '../core/session-image-store.js';
@@ -126,6 +126,18 @@ function preserveFailedTurnInput(session, input, category) {
     });
     appendTurnFailureMarker(session, category);
 }
+function tagTurnPhase(phase, run) {
+    return run().catch((error) => {
+        if (error && typeof error === 'object' && !error.thegitaiPhase) {
+            error.thegitaiPhase = phase;
+        }
+        throw error;
+    });
+}
+function turnPhaseOf(error) {
+    const phase = error?.thegitaiPhase;
+    return typeof phase === 'string' ? phase : null;
+}
 function historyHasToolCall(session, callId) {
     return session.history.some((entry) => (entry.parts ?? []).some((part) => String(part?.functionCall?.id ?? '') === callId));
 }
@@ -216,7 +228,7 @@ async function postToolResult({ config, turnId, event, result, session, fetchImp
         toolStateSeq: ++toolStateSeqCounter,
     };
     const trace = createTraceContext(traceId);
-    const response = await fetchImpl(`${normalizeServerUrl(config.serverUrl)}/v1/chat/turn/${encodeURIComponent(turnId)}/tool-result`, {
+    const response = await tagTurnPhase('posting a tool result', () => fetchImpl(`${normalizeServerUrl(config.serverUrl)}/v1/chat/turn/${encodeURIComponent(turnId)}/tool-result`, {
         method: 'POST',
         headers: {
             authorization: `Bearer ${config.token}`,
@@ -224,7 +236,7 @@ async function postToolResult({ config, turnId, event, result, session, fetchImp
             ...trace.headers,
         },
         body: JSON.stringify(payload),
-    });
+    }));
     if (response.status === 410) {
         return;
     }
@@ -566,7 +578,7 @@ export async function sendServerUserMessage({ config, session, input, imageAttac
         signal?.addEventListener('abort', preserveOnAbort, { once: true });
     }
     try {
-        const response = await fetchImpl(`${normalizeServerUrl(config.serverUrl)}/v1/chat/turn`, {
+        const response = await tagTurnPhase('opening the turn', () => fetchImpl(`${normalizeServerUrl(config.serverUrl)}/v1/chat/turn`, {
             method: 'POST',
             headers: {
                 accept: 'text/event-stream',
@@ -576,11 +588,11 @@ export async function sendServerUserMessage({ config, session, input, imageAttac
             },
             body: JSON.stringify(request),
             signal,
-        });
+        }));
         if (!response.ok) {
             throw await readErrorResponse(response, trace.traceId);
         }
-        const result = await consumeTurnStream({
+        const result = await tagTurnPhase('reading the turn stream', () => consumeTurnStream({
             response,
             config,
             session,
@@ -590,7 +602,7 @@ export async function sendServerUserMessage({ config, session, input, imageAttac
             traceId: trace.traceId,
             onTurnStart,
             onInterjectionDelivered,
-        });
+        }));
         applySessionSnapshot(session, result.snapshot, { preserveAgentMode: true });
         return {
             text: result.text,
@@ -606,6 +618,11 @@ export async function sendServerUserMessage({ config, session, input, imageAttac
                 ? error
                 : new TurnCancelledError();
         }
+        const transportDetail = error instanceof ChatTurnFailedError ? null : transportFailureDetail(error);
+        if (transportDetail && error instanceof Error) {
+            const phase = turnPhaseOf(error) ?? 'reaching the server';
+            error.message = `connection lost while ${phase}: ${transportDetail} [trace ${trace.traceId}]`;
+        }
         const category = error instanceof ChatTurnFailedError
             ? error.category
             :

package/dist/src/api/http.js

@@ -126,7 +126,65 @@ export function nonJsonErrorMessage(body, status) {
     const base = gateway ?? (summary || `Request failed with ${status}`);
     return rayId ? `${base} (Cloudflare Ray ID: ${rayId})` : base;
 }
+const TRANSPORT_CODES = new Set([
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ECONNABORTED',
+    'EPIPE',
+    'ETIMEDOUT',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'EPROTO',
+    'ERR_STREAM_PREMATURE_CLOSE',
+]);
+const TRANSPORT_PHRASES = [
+    [/\bsocket hang up\b/i, 'socket hang up'],
+    [/\bother side closed\b/i, 'other side closed'],
+    [/\bpremature close\b/i, 'premature close'],
+    [/\bterminated\b/i, 'terminated'],
+    [/\bfetch failed\b/i, 'fetch failed'],
+    [/\bnetwork timeout\b/i, 'network timeout'],
+    [/\bnetwork error\b/i, 'network error'],
+    [/\bheaders timeout\b/i, 'headers timeout'],
+    [/\bbody timeout\b/i, 'body timeout'],
+];
+export function transportFailureDetail(error) {
+    if (error instanceof ServerApiError)
+        return null;
+    const parts = [];
+    const seen = new Set();
+    const queue = [error];
+    while (queue.length && seen.size < 24) {
+        const current = queue.shift();
+        if (!current || typeof current !== 'object' || seen.has(current))
+            continue;
+        seen.add(current);
+        const code = String(current.code ?? '');
+        if (TRANSPORT_CODES.has(code) || /^UND_ERR_[A-Z_]+$/.test(code)) {
+            if (!parts.includes(code))
+                parts.push(code);
+        }
+        const message = String(current.message ?? '');
+        for (const [pattern, label] of TRANSPORT_PHRASES) {
+            if (pattern.test(message) && !parts.includes(label))
+                parts.push(label);
+        }
+        if (current.cause)
+            queue.push(current.cause);
+        const nested = current.errors;
+        if (Array.isArray(nested))
+            queue.push(...nested);
+    }
+    return parts.length ? parts.slice(0, 3).join(' <- ') : null;
+}
+function isTransportFailure(error) {
+    return transportFailureDetail(error) !== null;
+}
 export function gatewayFailureCategory(error) {
+    if (isTransportFailure(error))
+        return 'connection_error';
     if (!(error instanceof ServerApiError))
         return null;
     return error.status in GATEWAY_STATUS_MESSAGES ? 'gateway_error' : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegitai/cli",
-  "version": "1.0.0-preview.39",
+  "version": "1.0.0-preview.40",
   "description": "TheGitAI is an agentic AI coding tool for your terminal. It reads and searches your repository, writes and edits files, runs your tests, and verifies the change before handing it back.",
   "keywords": [
     "agentic-ai",
@@ -44,11 +44,11 @@
     "@lydell/node-pty-linux-x64": "1.1.0",
     "@lydell/node-pty-win32-arm64": "1.1.0",
     "@lydell/node-pty-win32-x64": "1.1.0",
-    "@thegitai/tui-darwin-arm64": "1.0.0-preview.39",
-    "@thegitai/tui-darwin-x64": "1.0.0-preview.39",
-    "@thegitai/tui-linux-arm64": "1.0.0-preview.39",
-    "@thegitai/tui-linux-x64": "1.0.0-preview.39",
-    "@thegitai/tui-win32-x64": "1.0.0-preview.39",
+    "@thegitai/tui-darwin-arm64": "1.0.0-preview.40",
+    "@thegitai/tui-darwin-x64": "1.0.0-preview.40",
+    "@thegitai/tui-linux-arm64": "1.0.0-preview.40",
+    "@thegitai/tui-linux-x64": "1.0.0-preview.40",
+    "@thegitai/tui-win32-x64": "1.0.0-preview.40",
     "@vscode/ripgrep": "1.18.0"
   },
   "repository": {