gitnexus 1.4.0 → 1.4.1

package/dist/core/wiki/html-viewer.js

@@ -100,198 +100,198 @@ const BOOK_SVG = '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" st
     '<path d="M2 3h6a4 4 0 014 4v14a3 3 0 00-3-3H2z"/>' +
     '<path d="M22 3h-6a4 4 0 00-4 4v14a3 3 0 013-3h7z"/>' +
     '</svg>';
-const CSS = `
-*{margin:0;padding:0;box-sizing:border-box}
-:root{
-  --bg:#ffffff;--sidebar-bg:#f8f9fb;--border:#e5e7eb;
-  --text:#1e293b;--text-muted:#64748b;--primary:#2563eb;
-  --primary-soft:#eff6ff;--hover:#f1f5f9;--code-bg:#f1f5f9;
-  --radius:8px;--shadow:0 1px 3px rgba(0,0,0,.08);
-}
-body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;
-  line-height:1.65;color:var(--text);background:var(--bg)}
-
-.layout{display:flex;min-height:100vh}
-.sidebar{width:280px;background:var(--sidebar-bg);border-right:1px solid var(--border);
-  position:fixed;top:0;left:0;bottom:0;overflow-y:auto;padding:24px 16px;
-  display:flex;flex-direction:column;z-index:10}
-.content{margin-left:280px;flex:1;padding:48px 64px;max-width:960px}
-
-.sidebar-header{margin-bottom:20px;padding-bottom:16px;border-bottom:1px solid var(--border)}
-.sidebar-title{font-size:16px;font-weight:700;color:var(--text);display:flex;align-items:center;gap:8px}
-.sidebar-title svg{flex-shrink:0}
-.sidebar-meta{font-size:11px;color:var(--text-muted);margin-top:6px}
-.nav-section{margin-bottom:2px}
-.nav-item{display:block;padding:7px 12px;border-radius:var(--radius);cursor:pointer;
-  font-size:13px;color:var(--text);text-decoration:none;transition:all .15s;
-  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.nav-item:hover{background:var(--hover)}
-.nav-item.active{background:var(--primary-soft);color:var(--primary);font-weight:600}
-.nav-item.overview{font-weight:600;margin-bottom:4px}
-.nav-children{padding-left:14px;border-left:1px solid var(--border);margin-left:12px}
-.nav-group-label{font-size:11px;font-weight:600;color:var(--text-muted);
-  text-transform:uppercase;letter-spacing:.5px;padding:12px 12px 4px;user-select:none}
-.sidebar-footer{margin-top:auto;padding-top:16px;border-top:1px solid var(--border);
-  font-size:11px;color:var(--text-muted);text-align:center}
-
-.content h1{font-size:28px;font-weight:700;margin-bottom:8px;line-height:1.3}
-.content h2{font-size:22px;font-weight:600;margin:32px 0 12px;padding-bottom:6px;border-bottom:1px solid var(--border)}
-.content h3{font-size:17px;font-weight:600;margin:24px 0 8px}
-.content h4{font-size:15px;font-weight:600;margin:20px 0 6px}
-.content p{margin:12px 0}
-.content ul,.content ol{margin:12px 0 12px 24px}
-.content li{margin:4px 0}
-.content a{color:var(--primary);text-decoration:none}
-.content a:hover{text-decoration:underline}
-.content blockquote{border-left:3px solid var(--primary);padding:8px 16px;margin:16px 0;
-  background:var(--primary-soft);border-radius:0 var(--radius) var(--radius) 0;
-  color:var(--text-muted);font-size:14px}
-.content code{font-family:'SF Mono',Consolas,'Courier New',monospace;font-size:13px;
-  background:var(--code-bg);padding:2px 6px;border-radius:4px}
-.content pre{background:#1e293b;color:#e2e8f0;border-radius:var(--radius);padding:16px;
-  overflow-x:auto;margin:16px 0}
-.content pre code{background:none;padding:0;font-size:13px;line-height:1.6;color:inherit}
-.content table{border-collapse:collapse;width:100%;margin:16px 0}
-.content th,.content td{border:1px solid var(--border);padding:8px 12px;text-align:left;font-size:14px}
-.content th{background:var(--sidebar-bg);font-weight:600}
-.content img{max-width:100%;border-radius:var(--radius)}
-.content hr{border:none;border-top:1px solid var(--border);margin:32px 0}
-.content .mermaid{margin:20px 0;text-align:center}
-
-.menu-toggle{display:none;position:fixed;top:12px;left:12px;z-index:20;
-  background:var(--bg);border:1px solid var(--border);border-radius:var(--radius);
-  padding:8px 12px;cursor:pointer;font-size:18px;box-shadow:var(--shadow)}
-@media(max-width:768px){
-  .sidebar{transform:translateX(-100%);transition:transform .2s}
-  .sidebar.open{transform:translateX(0);box-shadow:2px 0 12px rgba(0,0,0,.1)}
-  .content{margin-left:0;padding:24px 20px;padding-top:56px}
-  .menu-toggle{display:block}
-}
-.empty-state{text-align:center;padding:80px 20px;color:var(--text-muted)}
-.empty-state h2{font-size:20px;margin-bottom:8px;border:none}
+const CSS = `
+*{margin:0;padding:0;box-sizing:border-box}
+:root{
+  --bg:#ffffff;--sidebar-bg:#f8f9fb;--border:#e5e7eb;
+  --text:#1e293b;--text-muted:#64748b;--primary:#2563eb;
+  --primary-soft:#eff6ff;--hover:#f1f5f9;--code-bg:#f1f5f9;
+  --radius:8px;--shadow:0 1px 3px rgba(0,0,0,.08);
+}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;
+  line-height:1.65;color:var(--text);background:var(--bg)}
+
+.layout{display:flex;min-height:100vh}
+.sidebar{width:280px;background:var(--sidebar-bg);border-right:1px solid var(--border);
+  position:fixed;top:0;left:0;bottom:0;overflow-y:auto;padding:24px 16px;
+  display:flex;flex-direction:column;z-index:10}
+.content{margin-left:280px;flex:1;padding:48px 64px;max-width:960px}
+
+.sidebar-header{margin-bottom:20px;padding-bottom:16px;border-bottom:1px solid var(--border)}
+.sidebar-title{font-size:16px;font-weight:700;color:var(--text);display:flex;align-items:center;gap:8px}
+.sidebar-title svg{flex-shrink:0}
+.sidebar-meta{font-size:11px;color:var(--text-muted);margin-top:6px}
+.nav-section{margin-bottom:2px}
+.nav-item{display:block;padding:7px 12px;border-radius:var(--radius);cursor:pointer;
+  font-size:13px;color:var(--text);text-decoration:none;transition:all .15s;
+  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.nav-item:hover{background:var(--hover)}
+.nav-item.active{background:var(--primary-soft);color:var(--primary);font-weight:600}
+.nav-item.overview{font-weight:600;margin-bottom:4px}
+.nav-children{padding-left:14px;border-left:1px solid var(--border);margin-left:12px}
+.nav-group-label{font-size:11px;font-weight:600;color:var(--text-muted);
+  text-transform:uppercase;letter-spacing:.5px;padding:12px 12px 4px;user-select:none}
+.sidebar-footer{margin-top:auto;padding-top:16px;border-top:1px solid var(--border);
+  font-size:11px;color:var(--text-muted);text-align:center}
+
+.content h1{font-size:28px;font-weight:700;margin-bottom:8px;line-height:1.3}
+.content h2{font-size:22px;font-weight:600;margin:32px 0 12px;padding-bottom:6px;border-bottom:1px solid var(--border)}
+.content h3{font-size:17px;font-weight:600;margin:24px 0 8px}
+.content h4{font-size:15px;font-weight:600;margin:20px 0 6px}
+.content p{margin:12px 0}
+.content ul,.content ol{margin:12px 0 12px 24px}
+.content li{margin:4px 0}
+.content a{color:var(--primary);text-decoration:none}
+.content a:hover{text-decoration:underline}
+.content blockquote{border-left:3px solid var(--primary);padding:8px 16px;margin:16px 0;
+  background:var(--primary-soft);border-radius:0 var(--radius) var(--radius) 0;
+  color:var(--text-muted);font-size:14px}
+.content code{font-family:'SF Mono',Consolas,'Courier New',monospace;font-size:13px;
+  background:var(--code-bg);padding:2px 6px;border-radius:4px}
+.content pre{background:#1e293b;color:#e2e8f0;border-radius:var(--radius);padding:16px;
+  overflow-x:auto;margin:16px 0}
+.content pre code{background:none;padding:0;font-size:13px;line-height:1.6;color:inherit}
+.content table{border-collapse:collapse;width:100%;margin:16px 0}
+.content th,.content td{border:1px solid var(--border);padding:8px 12px;text-align:left;font-size:14px}
+.content th{background:var(--sidebar-bg);font-weight:600}
+.content img{max-width:100%;border-radius:var(--radius)}
+.content hr{border:none;border-top:1px solid var(--border);margin:32px 0}
+.content .mermaid{margin:20px 0;text-align:center}
+
+.menu-toggle{display:none;position:fixed;top:12px;left:12px;z-index:20;
+  background:var(--bg);border:1px solid var(--border);border-radius:var(--radius);
+  padding:8px 12px;cursor:pointer;font-size:18px;box-shadow:var(--shadow)}
+@media(max-width:768px){
+  .sidebar{transform:translateX(-100%);transition:transform .2s}
+  .sidebar.open{transform:translateX(0);box-shadow:2px 0 12px rgba(0,0,0,.1)}
+  .content{margin-left:0;padding:24px 20px;padding-top:56px}
+  .menu-toggle{display:block}
+}
+.empty-state{text-align:center;padding:80px 20px;color:var(--text-muted)}
+.empty-state h2{font-size:20px;margin-bottom:8px;border:none}
 `;
 // The client-side JS is kept as a plain string to avoid template literal conflicts
-const JS_APP = `
-(function() {
-  var activePage = 'overview';
-
-  document.addEventListener('DOMContentLoaded', function() {
-    mermaid.initialize({ startOnLoad: false, theme: 'neutral', securityLevel: 'loose' });
-    renderMeta();
-    renderNav();
-    document.getElementById('menu-toggle').addEventListener('click', function() {
-      document.getElementById('sidebar').classList.toggle('open');
-    });
-    if (location.hash && location.hash.length > 1) {
-      activePage = decodeURIComponent(location.hash.slice(1));
-    }
-    navigateTo(activePage);
-  });
-
-  function renderMeta() {
-    if (!META) return;
-    var el = document.getElementById('meta-info');
-    var parts = [];
-    if (META.generatedAt) {
-      parts.push(new Date(META.generatedAt).toLocaleDateString());
-    }
-    if (META.model) parts.push(META.model);
-    if (META.fromCommit) parts.push(META.fromCommit.slice(0, 8));
-    el.textContent = parts.join(' \\u00b7 ');
-  }
-
-  function renderNav() {
-    var container = document.getElementById('nav-tree');
-    var html = '<div class="nav-section">';
-    html += '<a class="nav-item overview" data-page="overview" href="#overview">Overview</a>';
-    html += '</div>';
-    if (TREE.length > 0) {
-      html += '<div class="nav-group-label">Modules</div>';
-      html += buildNavTree(TREE);
-    }
-    container.innerHTML = html;
-    container.addEventListener('click', function(e) {
-      var target = e.target;
-      while (target && !target.dataset.page) { target = target.parentElement; }
-      if (target && target.dataset.page) {
-        e.preventDefault();
-        navigateTo(target.dataset.page);
-      }
-    });
-  }
-
-  function buildNavTree(nodes) {
-    var html = '';
-    for (var i = 0; i < nodes.length; i++) {
-      var node = nodes[i];
-      html += '<div class="nav-section">';
-      html += '<a class="nav-item" data-page="' + escH(node.slug) + '" href="#' + encodeURIComponent(node.slug) + '">' + escH(node.name) + '</a>';
-      if (node.children && node.children.length > 0) {
-        html += '<div class="nav-children">' + buildNavTree(node.children) + '</div>';
-      }
-      html += '</div>';
-    }
-    return html;
-  }
-
-  function escH(s) {
-    var d = document.createElement('div');
-    d.textContent = s;
-    return d.innerHTML;
-  }
-
-  function navigateTo(page) {
-    activePage = page;
-    location.hash = encodeURIComponent(page);
-
-    var items = document.querySelectorAll('.nav-item');
-    for (var i = 0; i < items.length; i++) {
-      if (items[i].dataset.page === page) {
-        items[i].classList.add('active');
-      } else {
-        items[i].classList.remove('active');
-      }
-    }
-
-    var contentEl = document.getElementById('content');
-    var md = PAGES[page];
-
-    if (!md) {
-      contentEl.innerHTML = '<div class="empty-state"><h2>Page not found</h2><p>' + escH(page) + '.md does not exist.</p></div>';
-      return;
-    }
-
-    contentEl.innerHTML = marked.parse(md);
-
-    // Rewrite .md links to hash navigation
-    var links = contentEl.querySelectorAll('a[href]');
-    for (var i = 0; i < links.length; i++) {
-      var href = links[i].getAttribute('href');
-      if (href && href.endsWith('.md') && href.indexOf('://') === -1) {
-        var slug = href.replace(/\\.md$/, '');
-        links[i].setAttribute('href', '#' + encodeURIComponent(slug));
-        (function(s) {
-          links[i].addEventListener('click', function(e) {
-            e.preventDefault();
-            navigateTo(s);
-          });
-        })(slug);
-      }
-    }
-
-    // Convert mermaid code blocks into mermaid divs
-    var mermaidBlocks = contentEl.querySelectorAll('pre code.language-mermaid');
-    for (var i = 0; i < mermaidBlocks.length; i++) {
-      var pre = mermaidBlocks[i].parentElement;
-      var div = document.createElement('div');
-      div.className = 'mermaid';
-      div.textContent = mermaidBlocks[i].textContent;
-      pre.parentNode.replaceChild(div, pre);
-    }
-    try { mermaid.run({ querySelector: '.mermaid' }); } catch(e) {}
-
-    window.scrollTo(0, 0);
-    document.getElementById('sidebar').classList.remove('open');
-  }
-})();
+const JS_APP = `
+(function() {
+  var activePage = 'overview';
+
+  document.addEventListener('DOMContentLoaded', function() {
+    mermaid.initialize({ startOnLoad: false, theme: 'neutral', securityLevel: 'loose' });
+    renderMeta();
+    renderNav();
+    document.getElementById('menu-toggle').addEventListener('click', function() {
+      document.getElementById('sidebar').classList.toggle('open');
+    });
+    if (location.hash && location.hash.length > 1) {
+      activePage = decodeURIComponent(location.hash.slice(1));
+    }
+    navigateTo(activePage);
+  });
+
+  function renderMeta() {
+    if (!META) return;
+    var el = document.getElementById('meta-info');
+    var parts = [];
+    if (META.generatedAt) {
+      parts.push(new Date(META.generatedAt).toLocaleDateString());
+    }
+    if (META.model) parts.push(META.model);
+    if (META.fromCommit) parts.push(META.fromCommit.slice(0, 8));
+    el.textContent = parts.join(' \\u00b7 ');
+  }
+
+  function renderNav() {
+    var container = document.getElementById('nav-tree');
+    var html = '<div class="nav-section">';
+    html += '<a class="nav-item overview" data-page="overview" href="#overview">Overview</a>';
+    html += '</div>';
+    if (TREE.length > 0) {
+      html += '<div class="nav-group-label">Modules</div>';
+      html += buildNavTree(TREE);
+    }
+    container.innerHTML = html;
+    container.addEventListener('click', function(e) {
+      var target = e.target;
+      while (target && !target.dataset.page) { target = target.parentElement; }
+      if (target && target.dataset.page) {
+        e.preventDefault();
+        navigateTo(target.dataset.page);
+      }
+    });
+  }
+
+  function buildNavTree(nodes) {
+    var html = '';
+    for (var i = 0; i < nodes.length; i++) {
+      var node = nodes[i];
+      html += '<div class="nav-section">';
+      html += '<a class="nav-item" data-page="' + escH(node.slug) + '" href="#' + encodeURIComponent(node.slug) + '">' + escH(node.name) + '</a>';
+      if (node.children && node.children.length > 0) {
+        html += '<div class="nav-children">' + buildNavTree(node.children) + '</div>';
+      }
+      html += '</div>';
+    }
+    return html;
+  }
+
+  function escH(s) {
+    var d = document.createElement('div');
+    d.textContent = s;
+    return d.innerHTML;
+  }
+
+  function navigateTo(page) {
+    activePage = page;
+    location.hash = encodeURIComponent(page);
+
+    var items = document.querySelectorAll('.nav-item');
+    for (var i = 0; i < items.length; i++) {
+      if (items[i].dataset.page === page) {
+        items[i].classList.add('active');
+      } else {
+        items[i].classList.remove('active');
+      }
+    }
+
+    var contentEl = document.getElementById('content');
+    var md = PAGES[page];
+
+    if (!md) {
+      contentEl.innerHTML = '<div class="empty-state"><h2>Page not found</h2><p>' + escH(page) + '.md does not exist.</p></div>';
+      return;
+    }
+
+    contentEl.innerHTML = marked.parse(md);
+
+    // Rewrite .md links to hash navigation
+    var links = contentEl.querySelectorAll('a[href]');
+    for (var i = 0; i < links.length; i++) {
+      var href = links[i].getAttribute('href');
+      if (href && href.endsWith('.md') && href.indexOf('://') === -1) {
+        var slug = href.replace(/\\.md$/, '');
+        links[i].setAttribute('href', '#' + encodeURIComponent(slug));
+        (function(s) {
+          links[i].addEventListener('click', function(e) {
+            e.preventDefault();
+            navigateTo(s);
+          });
+        })(slug);
+      }
+    }
+
+    // Convert mermaid code blocks into mermaid divs
+    var mermaidBlocks = contentEl.querySelectorAll('pre code.language-mermaid');
+    for (var i = 0; i < mermaidBlocks.length; i++) {
+      var pre = mermaidBlocks[i].parentElement;
+      var div = document.createElement('div');
+      div.className = 'mermaid';
+      div.textContent = mermaidBlocks[i].textContent;
+      pre.parentNode.replaceChild(div, pre);
+    }
+    try { mermaid.run({ querySelector: '.mermaid' }); } catch(e) {}
+
+    window.scrollTo(0, 0);
+    document.getElementById('sidebar').classList.remove('open');
+  }
+})();
 `;

package/dist/core/wiki/llm-client.js

@@ -62,8 +62,11 @@ export async function callLLM(prompt, config, systemPrompt, options) {
     if (useStream)
         body.stream = true;
     const MAX_RETRIES = 3;
+    const FETCH_TIMEOUT_MS = 60_000; // 60s max to get response headers
     let lastError = null;
     for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        const controller = new AbortController();
+        const fetchTimer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
         try {
             const response = await fetch(url, {
                 method: 'POST',
@@ -72,17 +75,20 @@ export async function callLLM(prompt, config, systemPrompt, options) {
                     'Authorization': `Bearer ${config.apiKey}`,
                 },
                 body: JSON.stringify(body),
+                signal: controller.signal,
             });
+            clearTimeout(fetchTimer);
             if (!response.ok) {
                 const errorText = await response.text().catch(() => 'unknown error');
-                // Rate limit — wait with exponential backoff and retry
+                // Rate limit — use retry-after if available, otherwise short fixed delay
+                // (the caller's runParallel handles concurrency reduction + re-queuing)
                 if (response.status === 429 && attempt < MAX_RETRIES - 1) {
                     const retryAfter = parseInt(response.headers.get('retry-after') || '0', 10);
-                    const delay = retryAfter > 0 ? retryAfter * 1000 : (2 ** attempt) * 3000;
+                    const delay = retryAfter > 0 ? Math.min(retryAfter * 1000, 30_000) : 3_000;
                     await sleep(delay);
                     continue;
                 }
-                // Server error — retry with backoff
+                // Server error — retry with short backoff
                 if (response.status >= 500 && attempt < MAX_RETRIES - 1) {
                     await sleep((attempt + 1) * 2000);
                     continue;
@@ -106,9 +112,16 @@ export async function callLLM(prompt, config, systemPrompt, options) {
             };
         }
         catch (err) {
+            clearTimeout(fetchTimer);
             lastError = err;
-            // Network error — retry with backoff
-            if (attempt < MAX_RETRIES - 1 && (err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT' || err.message?.includes('fetch'))) {
+            // Network/timeout error — retry with backoff
+            const isRetryable = err.code === 'ECONNREFUSED'
+                || err.code === 'ETIMEDOUT'
+                || err.name === 'AbortError'
+                || err.message?.includes('abort')
+                || err.message?.includes('fetch');
+            if (attempt < MAX_RETRIES - 1 && isRetryable) {
+                console.warn(`[llm] Attempt ${attempt + 1} failed (${err.message?.slice(0, 100)}), retrying...`);
                 await sleep((attempt + 1) * 3000);
                 continue;
             }
@@ -119,38 +132,79 @@ export async function callLLM(prompt, config, systemPrompt, options) {
 }
 /**
  * Read an SSE stream from an OpenAI-compatible streaming response.
+ * Aborts if no chunk is received within STREAM_CHUNK_TIMEOUT_MS.
  */
+const STREAM_READ_TIMEOUT_MS = 90_000; // 90s max wait for any bytes from connection
+const CONTENT_STALL_TIMEOUT_MS = 120_000; // 120s max without new content tokens
 async function readSSEStream(body, onChunk) {
     const decoder = new TextDecoder();
     const reader = body.getReader();
     let content = '';
     let buffer = '';
+    let lastContentTime = Date.now();
     while (true) {
-        const { done, value } = await reader.read();
-        if (done)
+        let result;
+        try {
+            result = await withTimeout(reader.read(), STREAM_READ_TIMEOUT_MS, `LLM stream stalled — no data received for ${STREAM_READ_TIMEOUT_MS / 1000}s ` +
+                `(received ${content.length} chars so far). ` +
+                'This may indicate the model is overloaded or the connection was dropped.');
+        }
+        catch (err) {
+            reader.cancel().catch(() => { });
+            throw err;
+        }
+        const { done, value } = result;
+        if (done) {
+            const elapsed = ((Date.now() - lastContentTime) / 1000).toFixed(1);
+            console.log(`[sse] stream done — ${content.length} chars total, ${elapsed}s since last content`);
             break;
-        buffer += decoder.decode(value, { stream: true });
+        }
+        const rawChunk = decoder.decode(value, { stream: true });
+        buffer += rawChunk;
         const lines = buffer.split('\n');
         buffer = lines.pop() || '';
+        let gotContent = false;
         for (const line of lines) {
             const trimmed = line.trim();
-            if (!trimmed || !trimmed.startsWith('data: '))
+            if (!trimmed)
+                continue;
+            // Log non-data lines (keep-alives, comments, errors)
+            if (!trimmed.startsWith('data: ')) {
+                console.log(`[sse] non-data line: ${trimmed.slice(0, 200)}`);
                 continue;
+            }
             const data = trimmed.slice(6);
-            if (data === '[DONE]')
+            if (data === '[DONE]') {
+                console.log(`[sse] received [DONE] — ${content.length} chars total`);
                 continue;
+            }
             try {
                 const parsed = JSON.parse(data);
                 const delta = parsed.choices?.[0]?.delta?.content;
+                const finishReason = parsed.choices?.[0]?.finish_reason;
+                if (finishReason) {
+                    console.log(`[sse] finish_reason: ${finishReason} — ${content.length} chars`);
+                }
                 if (delta) {
                     content += delta;
+                    gotContent = true;
                     onChunk(content.length);
                 }
             }
             catch {
-                // Skip malformed SSE chunks
+                console.log(`[sse] malformed chunk: ${data.slice(0, 200)}`);
             }
         }
+        if (gotContent) {
+            lastContentTime = Date.now();
+        }
+        else if (Date.now() - lastContentTime > CONTENT_STALL_TIMEOUT_MS) {
+            // Connection is alive (keep-alives arriving) but no actual tokens for too long
+            reader.cancel().catch(() => { });
+            throw new Error(`LLM stream content stalled — receiving keep-alives but no new tokens for ` +
+                `${CONTENT_STALL_TIMEOUT_MS / 1000}s (received ${content.length} chars total). ` +
+                'The model may have hit an internal limit or the provider dropped the generation.');
+        }
     }
     if (!content) {
         throw new Error('LLM returned empty streaming response');
@@ -160,3 +214,11 @@ async function readSSEStream(body, onChunk) {
 function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+/** Race a promise against a timeout. Cleans up the timer on resolve to avoid leaks. */
+function withTimeout(promise, ms, message) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(message)), ms);
+    });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}