jamdesk 1.1.28 → 1.1.30

package/vendored/app/api/chat/[project]/route.ts

@@ -22,11 +22,15 @@
  */
 import { NextRequest } from 'next/server';
 import { querySimilarChunks } from '@/lib/vector-store';
-import { buildSystemPrompt, buildCannedIdentityReply, resolveSiteName } from '@/lib/chat-prompt';
+import { buildSystemPrompt, isCannedIdentityReply, resolveSiteName } from '@/lib/chat-prompt';
+import { stripHedge, isHedgeReply } from '@/lib/hedge-strip';
 import { getDocsPath, getBaseUrl, trackChatAnalytics } from '@/lib/route-helpers';
 import { getAnthropicClient } from '@/lib/anthropic-client';
+import { rewriteQueryForSearch } from '@/lib/query-rewriter';
 import { fetchDocsConfig } from '@/lib/r2-content';
 import { redis } from '@/lib/redis';
+import { CHAT_TOOLS } from '@/lib/chat-tools';
+import { log } from '@/lib/logger';
 
 export const runtime = 'nodejs';
 export const maxDuration = 30;
@@ -35,115 +39,11 @@ const CHAT_MODEL = 'claude-haiku-4-5-20251001';
 const RATE_LIMIT = 10;
 const RATE_WINDOW_SECONDS = 60;
 const MAX_HISTORY = 10;
+/** Messages shorter than this with prior history are treated as follow-ups.
+ *  Used both for searchQuery enrichment and to skip the rewriter. */
+const SHORT_FOLLOWUP_LEN = 60;
 const VALID_ROLES = new Set<string>(['user', 'assistant']);
 
-/**
- * Extract citations from Claude's response by matching [Title] references
- * against the vector search chunks. Deduplicates by page slug.
- * Falls back to top 2 unique pages by score if Claude didn't cite anything.
- */
-type Citation = { title: string; slug: string; section?: string };
-type ScoredChunk = { pageSlug: string; pageTitle: string; sectionHeading: string; score: number };
-
-function extractCitations(
-  responseText: string,
-  chunks: ScoredChunk[],
-): { sources: Citation[]; hadExplicitCitations: boolean } {
-  // Match [Title] but not markdown links [text](url)
-  const referencedTitles = new Set(
-    Array.from(responseText.matchAll(/\[([^\]]+)\](?!\()/g), (m) => m[1]),
-  );
-
-  const seen = new Set<string>();
-  const sources: Citation[] = [];
-
-  function addUniqueChunk(c: (typeof chunks)[number]): void {
-    if (seen.has(c.pageSlug)) return;
-    seen.add(c.pageSlug);
-    sources.push({ title: c.pageTitle, slug: c.pageSlug, section: c.sectionHeading });
-  }
-
-  // Filter chunks to only those Claude referenced, deduplicate by slug
-  for (const c of chunks) {
-    if (referencedTitles.has(c.pageTitle)) addUniqueChunk(c);
-  }
-
-  // Record whether Claude explicitly cited sources before the fallback
-  const hadExplicitCitations = sources.length > 0;
-
-  // Fallback: if Claude didn't cite anything explicitly, show top 2 unique pages by score
-  if (sources.length === 0) {
-    for (const c of chunks) {
-      addUniqueChunk(c);
-      if (sources.length >= 2) break;
-    }
-  }
-
-  return { sources, hadExplicitCitations };
-}
-
-/**
- * Detect option lists in Claude's response that indicate a clarification question.
- * Returns extracted option strings, or null if the response is a normal answer.
- *
- * Heuristic guards to avoid false positives on instructional lists:
- * - Response must contain a question mark or colon (clarification Qs ask something)
- * - Response must be short (< 500 chars — clarification Qs are brief)
- * - Must be 2-3 items (instructional lists tend to be longer)
- * - List must be at the END of the response
- *
- * Supports numbered (1. 2. 3.) and unnumbered (plain lines) formats.
- * Strips markdown formatting (bold, backticks) from option text.
- */
-export function extractClarificationOptions(responseText: string): string[] | null {
-  // Trim trailing whitespace/newlines so the $ anchor in option-list regexes
-  // matches reliably — SSE text deltas can include trailing newlines.
-  const text = responseText.trimEnd();
-
-  // Must indicate a question. A `?` always qualifies. A `:` only qualifies when
-  // the preamble contains clarification words (to avoid false positives on
-  // instructional lists like "To enable dark mode:\n\n1. Open Settings").
-  const hasQuestion = text.includes('?');
-  const hasClarificationColon = !hasQuestion
-    && text.includes(':')
-    && /\b(which|what|clarify|interested|looking for|asking|type of|kind of)\b/i.test(text);
-  if (!hasQuestion && !hasClarificationColon) return null;
-
-  // Only short responses are likely clarification questions
-  if (text.length > 500) return null;
-
-  // Strip markdown formatting (bold, italic, backticks) from option labels
-  function cleanOption(text: string): string {
-    return text.trim().replace(/[*`]/g, '');
-  }
-
-  // Primary: numbered list (1. 2. 3.) at the end
-  const numbered = text.match(
-    /\n\n1\.\s+(.+)\n2\.\s+(.+)(?:\n3\.\s+(.+))?$/,
-  );
-  if (numbered) {
-    const options = [cleanOption(numbered[1]), cleanOption(numbered[2])];
-    if (numbered[3]) options.push(cleanOption(numbered[3]));
-    return options;
-  }
-
-  // Fallback: unnumbered list (2-3 short lines at the end, after a blank line)
-  // Each line must be short (< 80 chars) and non-empty to distinguish from paragraphs
-  const unnumbered = text.match(
-    /\n\n([^\n]{2,80})\n([^\n]{2,80})(?:\n([^\n]{2,80}))?$/,
-  );
-  if (unnumbered) {
-    // Extra guard: lines must NOT look like sentences (no periods at end)
-    const lines = [unnumbered[1], unnumbered[2], unnumbered[3]].filter(Boolean) as string[];
-    const looksLikeOptions = lines.every(l => !l.trim().endsWith('.') && l.trim().length < 80);
-    if (looksLikeOptions && lines.length >= 2) {
-      return lines.map(cleanOption);
-    }
-  }
-
-  return null;
-}
-
 export async function POST(
   request: NextRequest,
   context: { params: Promise<{ project: string }> },
@@ -197,11 +97,12 @@ export async function POST(
     })
     .map((h) => ({ role: h.role, content: h.content.slice(0, 4000) }));
 
-  // Enrich short messages with conversation context for better vector search.
-  // When user picks a clarification option (e.g., "Post Analytics"), the message
-  // alone is too short for good retrieval. Combine with the preceding question.
+  const isShortFollowUp = message.length < SHORT_FOLLOWUP_LEN && history.length > 0;
+
+  // When a user picks a clarification option (e.g. "Post Analytics"), the
+  // message alone is too short for good retrieval — combine with the prior turn.
   let searchQuery = message;
-  if (message.length < 60 && history.length > 0) {
+  if (isShortFollowUp) {
     const prevUserMsg = [...history].reverse().find(
       h => h.role === 'user' && h.content !== message,
     );
@@ -221,9 +122,39 @@ export async function POST(
     fetchDocsConfig(project).catch(() => null),
   ]);
 
-  let chunks: Awaited<ReturnType<typeof querySimilarChunks>>;
+  // Fully parallel retrieval:
+  //   - Original vector query runs immediately.
+  //   - Rewriter + rewritten-query vector search are chained into ONE promise,
+  //     then Promise.all'd with the original. Critical path is
+  //     max(original_query_time, rewriter_time + rewritten_query_time), not
+  //     max(original, rewriter) + rewritten_query_time.
+  // Any failure in the rewrite path resolves to an empty chunk list — the
+  // original query still returns results so chat doesn't fail.
+  const originalQueryPromise = querySimilarChunks(project, searchQuery, 15);
+
+  // Skipping the rewriter on short follow-ups avoids 500-2000ms of serial
+  // Anthropic latency — `searchQuery` above is already enriched with prior-turn
+  // context using the same threshold, so the rewrite has no retrieval benefit.
+  const rewrittenPathPromise: Promise<Awaited<ReturnType<typeof querySimilarChunks>>> =
+    isShortFollowUp
+      ? Promise.resolve([])
+      : rewriteQueryForSearch(message, history)
+          .catch(() => null)
+          .then(rewritten => {
+            // Compare against `message` (the rewriter's input), not `searchQuery`
+            // (which is enriched with prior-turn context for short follow-ups).
+            // The rewriter only sees `message`, so a no-op rewrite equals `message`.
+            if (!rewritten || rewritten === message) return [];
+            return querySimilarChunks(project, rewritten, 15).catch(() => []);
+          });
+
+  let originalChunks: Awaited<ReturnType<typeof querySimilarChunks>>;
+  let rewrittenChunks: Awaited<ReturnType<typeof querySimilarChunks>>;
   try {
-    chunks = await querySimilarChunks(project, searchQuery, 8);
+    [originalChunks, rewrittenChunks] = await Promise.all([
+      originalQueryPromise,
+      rewrittenPathPromise,
+    ]);
   } catch {
     return Response.json(
       { error: 'AI chat is not available for this project.' },
@@ -231,6 +162,21 @@ export async function POST(
     );
   }
 
+  // Merge: original chunks first (they match the user's literal phrasing),
+  // then unique chunks from the rewritten query. Dedup by pageSlug +
+  // sectionHeading — chunks with the same identity are interchangeable across
+  // queries.
+  const seenKeys = new Set(originalChunks.map(c => `${c.pageSlug}#${c.sectionHeading}`));
+  const chunks = [
+    ...originalChunks,
+    ...rewrittenChunks.filter(c => {
+      const key = `${c.pageSlug}#${c.sectionHeading}`;
+      if (seenKeys.has(key)) return false;
+      seenKeys.add(key);
+      return true;
+    }),
+  ];
+
   if (chunks.length === 0) {
     return Response.json(
       { error: 'No documentation content found for this project.' },
@@ -257,6 +203,8 @@ export async function POST(
     max_tokens: 2048,
     temperature: 0.3,
     system: systemPrompt,
+    tools: CHAT_TOOLS,
+    tool_choice: { type: 'any' },
     messages: [
       ...history.slice(-MAX_HISTORY),
       { role: 'user', content: message },
@@ -268,43 +216,157 @@ export async function POST(
     return encoder.encode(`data: ${JSON.stringify(data)}\n\n`);
   }
 
+  type Citation = { title: string; slug: string; section?: string };
+  type AnswerInput = { markdown?: string; cited_page_slugs?: string[] };
+  type ClarificationInput = { question?: string; options?: string[] };
+
+  function topChunksAsCitations(limit = 2, skip?: Set<string>): Citation[] {
+    const out: Citation[] = [];
+    const seen = new Set<string>(skip);
+    for (const c of chunks) {
+      if (seen.has(c.pageSlug)) continue;
+      seen.add(c.pageSlug);
+      out.push({ title: c.pageTitle, slug: c.pageSlug, section: c.sectionHeading });
+      if (out.length >= limit) break;
+    }
+    return out;
+  }
+
   const readable = new ReadableStream({
     async start(controller) {
-      let fullText = '';
+      let toolName: string | null = null;
+      let emittedMarkdownLength = 0;
+      let emittedQuestionLength = 0;
+
+      // Incrementally extract a still-open string field from partial tool_use JSON.
+      // The SDK's jsonSnapshot only exposes a field once its string literal closes,
+      // so a ~1000-char answer lands in one snapshot update and the client sees it
+      // in one flash. Instead, accumulate the raw partial_json and close the string
+      // + object ourselves to read the in-progress value.
+      let accumulatedJson = '';
+      function extractPartialString(field: 'markdown' | 'question'): string | null {
+        // A trailing odd number of backslashes means we're mid-escape. Appending
+        // `"}` would turn `\` into `\"` — a valid escaped quote — producing a
+        // bogus literal `"` in the extracted string that gets streamed as text.
+        const trailing = accumulatedJson.match(/\\+$/)?.[0].length ?? 0;
+        if (trailing % 2 !== 0) return null;
+        try {
+          const parsed = JSON.parse(accumulatedJson + '"}') as Record<string, unknown>;
+          const value = parsed[field];
+          return typeof value === 'string' ? value : null;
+        } catch {
+          return null;
+        }
+      }
+
+      stream.on('inputJson', (partialJson, jsonSnapshot) => {
+        accumulatedJson += typeof partialJson === 'string' ? partialJson : '';
+
+        // Gate on toolName — emitting before content_block_start resolves
+        // would leak clarification JSON into the answer text channel.
+        if (toolName === 'answer') {
+          const snap = jsonSnapshot as AnswerInput | null | undefined;
+          const md = typeof snap?.markdown === 'string'
+            ? snap.markdown
+            : extractPartialString('markdown');
+          if (md !== null) {
+            const trimmed = stripHedge(md);
+            if (trimmed.length > emittedMarkdownLength) {
+              const newContent = trimmed.slice(emittedMarkdownLength);
+              emittedMarkdownLength = trimmed.length;
+              controller.enqueue(sendEvent({ type: 'text', content: newContent }));
+            }
+          }
+        } else if (toolName === 'ask_clarification') {
+          const snap = jsonSnapshot as ClarificationInput | null | undefined;
+          const q = typeof snap?.question === 'string'
+            ? snap.question
+            : extractPartialString('question');
+          if (q !== null && q.length > emittedQuestionLength) {
+            const newContent = q.slice(emittedQuestionLength);
+            emittedQuestionLength = q.length;
+            controller.enqueue(sendEvent({ type: 'text', content: newContent }));
+          }
+        }
+      });
 
       try {
+        // Watch for content_block_start to learn which tool Claude picked.
         for await (const event of stream) {
-          if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
-            fullText += event.delta.text;
-            controller.enqueue(sendEvent({ type: 'text', content: event.delta.text }));
+          if (event.type === 'content_block_start' && event.content_block.type === 'tool_use') {
+            toolName = event.content_block.name;
           }
         }
 
-        // After streaming completes, get token usage
         const finalMessage = await stream.finalMessage();
         const inputTokens = finalMessage.usage?.input_tokens ?? 0;
         const outputTokens = finalMessage.usage?.output_tokens ?? 0;
 
-        // Extract clarification options (if Claude asked a disambiguation question)
-        const options = extractClarificationOptions(fullText);
-        if (options) {
+        // With tool_choice: 'any' there is exactly one tool_use block.
+        const toolUse = finalMessage.content.find(c => c.type === 'tool_use');
+        if (!toolUse || toolUse.type !== 'tool_use') {
+          throw new Error('Expected tool_use block in final message');
+        }
+
+        let sources: Citation[];
+        let hadExplicitCitations: boolean;
+        const hasClarification = toolUse.name === 'ask_clarification';
+
+        if (toolUse.name === 'answer') {
+          const input = toolUse.input as AnswerInput;
+          const slugs = Array.isArray(input.cited_page_slugs) ? input.cited_page_slugs : [];
+          const rawMarkdown = typeof input.markdown === 'string' ? input.markdown : '';
+          const markdownText = stripHedge(rawMarkdown);
+          // Suppress citations on identity + hedge replies — the top-2 fallback
+          // would otherwise attach unrelated docs under "I'm the documentation
+          // assistant…" or under "I don't have information…".
+          const suppressCitations =
+            isCannedIdentityReply(markdownText, siteName) || isHedgeReply(rawMarkdown);
+
+          const seen = new Set<string>();
+          const explicitSources: Citation[] = [];
+          if (!suppressCitations) {
+            for (const slug of slugs) {
+              const chunk = chunks.find(c => c.pageSlug === slug);
+              if (chunk && !seen.has(chunk.pageSlug)) {
+                seen.add(chunk.pageSlug);
+                explicitSources.push({
+                  title: chunk.pageTitle,
+                  slug: chunk.pageSlug,
+                  section: chunk.sectionHeading,
+                });
+              }
+            }
+          }
+          hadExplicitCitations = suppressCitations || explicitSources.length > 0;
+          sources = suppressCitations
+            ? []
+            : explicitSources.length > 0
+              ? explicitSources
+              : topChunksAsCitations(2, seen);
+        } else if (toolUse.name === 'ask_clarification') {
+          const input = toolUse.input as ClarificationInput;
+          const options = Array.isArray(input.options) ? input.options : [];
+          const question = typeof input.question === 'string' ? input.question.trim() : '';
+          // Missing question → UI shows buttons with no prompt.
+          // <2 options → dead-end UI. Interrupt so the user can retry.
+          if (!question) {
+            throw new Error('ask_clarification returned no question');
+          }
+          if (options.length < 2) {
+            throw new Error(`ask_clarification returned ${options.length} options; minimum is 2`);
+          }
           controller.enqueue(sendEvent({ type: 'clarification', options }));
+          // Surface top chunks so users see where the disambiguation candidates come from.
+          sources = topChunksAsCitations();
+          hadExplicitCitations = false;
+        } else {
+          throw new Error(`Unexpected tool name: ${toolUse.name}`);
         }
 
-        // Extract [Title] references from Claude's response (skip markdown links [text](url))
-        const { sources, hadExplicitCitations } = extractCitations(fullText, chunks);
-
-        // If Claude returned the canned identity reply, suppress citations — otherwise
-        // the "top 2 by score" fallback in extractCitations would attach unrelated
-        // docs sources under "I'm the documentation assistant for …".
-        const isIdentityReply = fullText.trim() === buildCannedIdentityReply(siteName);
-        controller.enqueue(sendEvent({
-          type: 'citations',
-          sources: isIdentityReply ? [] : sources,
-        }));
+        controller.enqueue(sendEvent({ type: 'citations', sources }));
         controller.enqueue(sendEvent({ type: 'done' }));
 
-        // Fire-and-forget analytics — only on success (finalMessage unreliable on error)
         trackChatAnalytics({
           projectSlug: project,
           query: message,
@@ -312,12 +374,17 @@ export async function POST(
           inputTokens,
           outputTokens,
           model: CHAT_MODEL,
-          hadExplicitCitations: isIdentityReply || hadExplicitCitations,
-          hasClarification: options !== null,
+          hadExplicitCitations,
+          hasClarification,
           durationMs: Date.now() - startTime,
           userAgent: request.headers.get('user-agent') || undefined,
         }).catch(() => {});
-      } catch {
+      } catch (err) {
+        log('warn', 'chat: stream interrupted', {
+          projectSlug: project,
+          toolName,
+          error: err instanceof Error ? err.message : String(err),
+        });
         controller.enqueue(sendEvent({ type: 'error', message: 'The response was interrupted. Please try again.' }));
       }
       controller.close();
@@ -327,8 +394,9 @@ export async function POST(
   return new Response(readable, {
     headers: {
       'Content-Type': 'text/event-stream',
-      'Cache-Control': 'no-cache',
+      'Cache-Control': 'no-cache, no-transform',
       'Connection': 'keep-alive',
+      'X-Accel-Buffering': 'no',
     },
   });
 }

package/vendored/app/api/isr-health/route.ts

@@ -9,6 +9,7 @@ import { NextResponse } from 'next/server';
 import { getConfigCacheSize } from '@/lib/r2-content';
 import { getSnippetCacheSize } from '@/lib/snippet-compiler-isr';
 import { getOpenApiCacheSize } from '@/lib/openapi-isr';
+import { isIsrMode } from '@/lib/page-isr-helpers';
 
 interface HealthCheck {
   status: 'ok' | 'degraded' | 'unhealthy';
@@ -31,8 +32,6 @@ interface HealthCheck {
 const startTime = Date.now();
 
 export async function GET() {
-  const isIsrMode = process.env.ISR_MODE === 'true';
-
   // Memory usage
   const memUsage = process.memoryUsage();
   const memory = {
@@ -54,7 +53,7 @@ export async function GET() {
     memory,
     uptime: Math.round((Date.now() - startTime) / 1000),
     timestamp: new Date().toISOString(),
-    isrMode: isIsrMode,
+    isrMode: isIsrMode(),
   };
 
   return NextResponse.json(health, {

package/vendored/app/layout.tsx

@@ -7,6 +7,7 @@ import { LayoutWrapper } from '@/components/layout/LayoutWrapper';
 import { CodeBlockCopyButton } from '@/components/CodeBlockCopyButton';
 import { HeaderLinkCopy } from '@/components/HeaderLinkCopy';
 import { FontAwesomeLoader } from '@/components/FontAwesomeLoader';
+import { JdReadySentinel } from '@/components/JdReadySentinel';
 import { FA_CSS_HREF } from '@/lib/font-awesome';
 import { getDocsConfig } from '@/lib/docs';
 import { getDocsConfig as getIsrDocsConfig } from '@/lib/docs-isr';
@@ -580,6 +581,7 @@ export default async function RootLayout({
         {config.integrations?.ga4?.measurementId && (
           <ConditionalGA gaId={config.integrations.ga4.measurementId} />
         )}
+        <JdReadySentinel />
       </body>
     </html>
   );

package/vendored/components/JdReadySentinel.tsx

@@ -0,0 +1,25 @@
+'use client';
+
+import { useEffect } from 'react';
+
+/**
+ * Sets document.body.dataset.jdReady = 'true' after window.load so the
+ * pdf-service (and any future browser automation) can wait on a reliable
+ * signal that the page is fully rendered and resources have settled.
+ */
+export function JdReadySentinel(): null {
+  useEffect(() => {
+    const mark = () => {
+      document.body.dataset.jdReady = 'true';
+    };
+    if (document.readyState === 'complete') {
+      mark();
+    } else {
+      window.addEventListener('load', mark, { once: true });
+    }
+    // removeEventListener with an unregistered listener is a no-op, so the
+    // cleanup is safe whether or not the branch above registered it.
+    return () => window.removeEventListener('load', mark);
+  }, []);
+  return null;
+}

package/vendored/components/chat/ChatEmptyState.tsx

@@ -5,6 +5,9 @@ import { memo, useMemo, useState, useCallback } from 'react';
 interface ChatEmptyStateProps {
   starterQuestions?: string[];
   onSelectQuestion: (question: string) => void;
+  /** Escape-hatch to hand the visitor off to Crisp. Omit to hide the button
+   *  (e.g. when Crisp isn't loaded). Detection happens in ChatPanel. */
+  onTalkToHuman?: () => void;
 }
 
 const STARTER_BASE = 'w-full text-left px-4 py-3 rounded-xl border text-sm transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--color-accent)]';
@@ -25,7 +28,7 @@ function starterButtonClass(question: string, selectedQuestion: string | null):
  * Starter questions are auto-generated by Haiku during builds when not
  * defined in docs.json — see lib/generate-starter-questions.ts.
  */
-export const ChatEmptyState = memo(function ChatEmptyState({ starterQuestions, onSelectQuestion }: ChatEmptyStateProps) {
+export const ChatEmptyState = memo(function ChatEmptyState({ starterQuestions, onSelectQuestion, onTalkToHuman }: ChatEmptyStateProps) {
   const shortcutKey = useMemo(
     () => typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.userAgent) ? '⌘' : 'Ctrl+',
     [],
@@ -74,6 +77,15 @@ export const ChatEmptyState = memo(function ChatEmptyState({ starterQuestions, o
           ))}
         </div>
       )}
+      {onTalkToHuman && (
+        <button
+          type="button"
+          onClick={onTalkToHuman}
+          className="mt-6 text-xs text-[var(--color-text-secondary)] hover:text-[var(--color-accent)] transition-colors cursor-pointer focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--color-accent)] rounded-md"
+        >
+          Need to talk to a human? <span className="font-medium text-[var(--color-accent)]">Start a chat →</span>
+        </button>
+      )}
     </div>
   );
 });

package/vendored/components/chat/ChatPanel.tsx

@@ -1,11 +1,12 @@
 'use client';
 
-import { useRef, useEffect, useLayoutEffect, useCallback } from 'react';
+import { useRef, useEffect, useLayoutEffect, useCallback, useState } from 'react';
 import { useChat } from '@/hooks/useChat';
 import { useBodyScrollLock } from '@/hooks/useBodyScrollLock';
 import { ChatMessage } from './ChatMessage';
 import { ChatInput } from './ChatInput';
 import { ChatEmptyState } from './ChatEmptyState';
+import { crispAvailable, hideCrispLauncher, openCrispChat, showCrispLauncher } from '../../lib/crisp-bridge';
 
 const SOMETHING_ELSE_PATTERNS = ['something else', 'none of the above', 'none of these'];
 
@@ -41,6 +42,15 @@ interface ChatPanelProps {
  */
 export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mode = 'overlay' }: ChatPanelProps) {
   const { messages, sendMessage, isLoading, abort, retry, clearChat, error, markClarificationSelected } = useChat(chatEndpoint);
+
+  const [hasCrisp, setHasCrisp] = useState(false);
+  useEffect(() => { setHasCrisp(crispAvailable()); }, []);
+
+  const handleTalkToHuman = useCallback(() => {
+    onClose();
+    openCrispChat();
+  }, [onClose]);
+
   const messagesContainerRef = useRef<HTMLDivElement>(null);
   const inputRef = useRef<HTMLDivElement>(null);
   const overlayPanelRef = useRef<HTMLDivElement>(null);
@@ -50,6 +60,17 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
   // Lock body scroll when mobile overlay is open
   useBodyScrollLock(!isInline && isOpen);
 
+  // Coordinate visibility with Crisp so the two chats don't overlap in the
+  // bottom-right corner. Applies to both modes — Crisp's fixed launcher sits
+  // behind the inline chat column's send button on desktop too.
+  useEffect(() => {
+    if (!isOpen) return;
+    hideCrispLauncher();
+    return () => {
+      showCrispLauncher();
+    };
+  }, [isOpen]);
+
   // On iOS, the virtual keyboard doesn't resize the layout viewport, so the
   // panel's max-h-[80dvh] can extend behind the keyboard. When the user taps the
   // textarea, iOS scrolls the page to reveal it — pushing the fixed panel off-screen.
@@ -171,6 +192,7 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
           <ChatEmptyState
             starterQuestions={starterQuestions}
             onSelectQuestion={sendMessage}
+            onTalkToHuman={hasCrisp ? handleTalkToHuman : undefined}
           />
         )}
       </div>
@@ -181,12 +203,24 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
           <p className="text-xs text-red-600 dark:text-red-400">
             {error}
           </p>
-          <button
-            onClick={retry}
-            className="text-xs font-medium text-red-600 dark:text-red-400 hover:underline flex-shrink-0 cursor-pointer"
-          >
-            Try again
-          </button>
+          <div className="flex items-center gap-3 flex-shrink-0">
+            {hasCrisp && (
+              <button
+                type="button"
+                onClick={handleTalkToHuman}
+                className="text-xs font-medium text-red-600 dark:text-red-400 hover:underline cursor-pointer"
+              >
+                Talk to a human
+              </button>
+            )}
+            <button
+              type="button"
+              onClick={retry}
+              className="text-xs font-medium text-red-600 dark:text-red-400 hover:underline cursor-pointer"
+            >
+              Try again
+            </button>
+          </div>
         </div>
       )}
 
@@ -220,7 +254,7 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
       {/* Mobile backdrop (<lg) */}
       {isOpen && (
         <div
-          className="fixed inset-0 bg-black/50 backdrop-blur-sm z-[54] lg:hidden"
+          className="fixed inset-0 bg-black/50 backdrop-blur-sm z-[1000003] lg:hidden"
           onClick={onClose}
           aria-hidden="true"
         />
@@ -236,7 +270,7 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
         data-open={isOpen}
         data-chat-panel
         className={`
-          fixed z-[55] flex flex-col overflow-hidden
+          fixed z-[1000004] flex flex-col overflow-hidden
           transition-all duration-200
           inset-x-2 top-4 max-h-[80dvh] rounded-2xl shadow-xl border border-[var(--color-border)]
           lg:inset-x-auto lg:top-0 lg:max-h-none lg:rounded-none lg:shadow-none lg:border-0

package/vendored/components/navigation/Breadcrumb.tsx

@@ -267,7 +267,7 @@ export function Breadcrumb({ slug, config }: BreadcrumbProps) {
       {/* Home link */}
       <Link
         href={homeLink}
-        prefetch={false}
+        prefetch={true}
         className="text-[var(--color-marker)] hover:text-[var(--color-text-primary)] transition-colors flex items-center"
         aria-label="Home"
       >
@@ -284,7 +284,7 @@ export function Breadcrumb({ slug, config }: BreadcrumbProps) {
           ) : item.path ? (
             <Link
               href={`${linkPrefix}/${item.path}`}
-              prefetch={false}
+              prefetch={true}
               className="text-[var(--color-marker)] hover:text-[var(--color-text-primary)] transition-colors"
             >
               {item.label}