@veluai/velu 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veluai/velu",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "bin": "./dist/cli.js",
   "publishConfig": {

package/runtime/velu-ui/components/Chatbot.jsx

@@ -160,8 +160,32 @@ function tokenizeAnswer(answer) {
   return tokens;
 }
 
+/* A citation's in-site target. Real backend sources carry a `url` (and `path`
+   is a route like "/essentials/code"); the demo's `path` is a fake file path,
+   so those stay inert. */
+function sourceHref(s) {
+  if (s?.url) return s.url;
+  if (s?.path && s.path.startsWith('/')) return s.path;
+  return null;
+}
+
+/* Source click: SPA-navigate same-origin targets via onNavigate (keeps the chat
+   panel open + scrolls to the heading); otherwise let the <a href> navigate. */
+function onSourceClick(e, s, onNavigate) {
+  const href = sourceHref(s);
+  if (!href) { e.preventDefault(); return; }
+  if (!onNavigate) return; // no SPA hook → let the browser follow the href
+  try {
+    const u = new URL(href, window.location.origin);
+    if (u.origin === window.location.origin) {
+      e.preventDefault();
+      onNavigate(u.pathname + u.search + u.hash);
+    }
+  } catch { /* malformed — fall back to href */ }
+}
+
 /* Render partial tokens as paragraphs (split on \n\n, single \n → <br>). */
-function renderStream(tokens, sources) {
+function renderStream(tokens, sources, onNavigate) {
   const paragraphs = [[]];
   for (const tk of tokens) {
     if (tk.kind === 't' && tk.v.includes('\n\n')) {
@@ -179,13 +203,14 @@ function renderStream(tokens, sources) {
     <p key={pi}>
       {para.map((tk, i) => {
         if (tk.kind === 'cite') {
+          const src = sources?.find((s) => s.num === tk.n);
           return (
             <a
               key={i}
               className="velu-chatbot__cite"
-              href="#"
-              onClick={(e) => e.preventDefault()}
-              title={sources?.find((s) => s.num === tk.n)?.title}
+              href={sourceHref(src) || '#'}
+              onClick={(e) => onSourceClick(e, src, onNavigate)}
+              title={src?.title}
             >
               {tk.n}
             </a>
@@ -331,6 +356,7 @@ function AiMsg({
   onFollowup,
   messageId,
   onFeedback,
+  onNavigate,
 }) {
   const thinking = tokens.length === 0;
   const [vote, setVote] = useState(null); // 'up' | 'down' | null
@@ -367,7 +393,7 @@ function AiMsg({
 
       {!thinking && (
         <div className="velu-chatbot__answer">
-          {renderStream(tokens, sources)}
+          {renderStream(tokens, sources, onNavigate)}
           {streaming && <span className="velu-chatbot__caret" />}
 
           {!streaming && sources?.length > 0 && (
@@ -377,8 +403,8 @@ function AiMsg({
                 <a
                   key={s.num}
                   className="velu-chatbot__source"
-                  href="#"
-                  onClick={(e) => e.preventDefault()}
+                  href={sourceHref(s) || '#'}
+                  onClick={(e) => onSourceClick(e, s, onNavigate)}
                 >
                   <span className="velu-chatbot__source-num">{s.num}</span>
                   <span className="velu-chatbot__source-meta">
@@ -489,6 +515,7 @@ export default function Chatbot({
   onClose,
   ask,
   onFeedback,
+  onNavigate,
   className = '',
   ...rest
 }) {
@@ -741,6 +768,7 @@ export default function Chatbot({
                   streaming={m.streaming}
                   messageId={m.messageId}
                   onFeedback={onFeedback}
+                  onNavigate={onNavigate}
                   onFollowup={(f) => send(f)}
                 />
               ),

package/runtime/velu-ui/lib/docs-assistant.js

@@ -31,20 +31,23 @@ function siteHost(explicit) {
   return typeof window !== 'undefined' ? window.location.host : '';
 }
 
-// Parse one raw SSE record ("event: x\ndata: {…}") into { event, data }.
+// Parse one raw SSE record ("id: N\nevent: x\ndata: {…}") into { event, data, seq }.
 function parseSseRecord(raw) {
   let event = 'message';
+  let seq = null;
   const dataLines = [];
   for (const line of raw.split('\n')) {
     if (line.startsWith('event:')) event = line.slice(6).trim();
-    else if (line.startsWith('data:')) dataLines.push(line.slice(5).replace(/^ /, ''));
+    else if (line.startsWith('id:')) {
+      const n = Number(line.slice(3).trim());
+      if (Number.isFinite(n)) seq = n;
+    } else if (line.startsWith('data:')) dataLines.push(line.slice(5).replace(/^ /, ''));
   }
-  if (!dataLines.length) return { event, data: null };
-  try {
-    return { event, data: JSON.parse(dataLines.join('\n')) };
-  } catch {
-    return { event, data: null };
+  let data = null;
+  if (dataLines.length) {
+    try { data = JSON.parse(dataLines.join('\n')); } catch { data = null; }
   }
+  return { event, data, seq };
 }
 
 // Backend citation → the Chatbot's Source shape.
@@ -63,6 +66,11 @@ export function createDocsAssistant({ apiBase, host } = {}) {
   if (!base) return null;
   const root = `${base}/api/v1/public/ai-assistant`;
   let bootstrapped = false;
+  // Highest event seq seen per conversation. The events endpoint replays history
+  // after `after_seq`; without this a reused (multi-turn) conversation replays
+  // from 0 and the first (old) assistant.completed is returned for every
+  // follow-up turn — i.e. the answer never updates after the first message.
+  const lastSeqByConv = new Map();
 
   const headers = (extra) => ({
     'X-Velu-Site-Host': siteHost(host),
@@ -98,8 +106,9 @@ export function createDocsAssistant({ apiBase, host } = {}) {
 
     // Manual fetch-stream SSE parse (not EventSource): supports credentials,
     // the X-Velu-Site-Host header, and AbortController cancellation.
+    const afterSeq = lastSeqByConv.get(convId) ?? 0;
     const evRes = await fetch(
-      `${root}/conversations/${convId}/events?after_seq=0&token=${encodeURIComponent(token)}`,
+      `${root}/conversations/${convId}/events?after_seq=${afterSeq}&token=${encodeURIComponent(token)}`,
       { credentials: 'include', headers: headers({ Accept: 'text/event-stream' }), signal },
     );
     if (!evRes.ok || !evRes.body) throw new Error(`ask-ai: stream ${evRes.status}`);
@@ -114,8 +123,11 @@ export function createDocsAssistant({ apiBase, host } = {}) {
         buf += decoder.decode(value, { stream: true });
         let sep;
         while ((sep = buf.indexOf('\n\n')) !== -1) {
-          const { event, data } = parseSseRecord(buf.slice(0, sep));
+          const { event, data, seq } = parseSseRecord(buf.slice(0, sep));
           buf = buf.slice(sep + 2);
+          if (seq != null) {
+            lastSeqByConv.set(convId, Math.max(lastSeqByConv.get(convId) ?? 0, seq));
+          }
           if (event === 'assistant.completed') {
             const m = data?.message || {};
             yield {

package/src/runtime/App.jsx

@@ -1558,7 +1558,7 @@ function DocsPage() {
               approaches (see IntersectionObserver above). */}
           {/* Ask-a-question bar — opens the AI chatbot, which runs on the
               deployed site. Hidden in the local dev preview. */}
-          {!IS_DEV_PREVIEW && (
+          {!IS_DEV_PREVIEW && !chatOpen && (
             <AskBar
               onSubmit={askAI}
               style={{
@@ -1623,6 +1623,7 @@ function DocsPage() {
         onClose={() => setChatOpen(false)}
         ask={assistant?.ask}
         onFeedback={assistant?.sendFeedback}
+        onNavigate={navigate}
       />
     </div>
   );