@huskel/sdk 0.3.2 → 0.3.3

package/dist/index.d.mts

@@ -90,6 +90,14 @@ declare class HuskelAPI {
     ingest(product: Product): Promise<IngestResponse>;
     ingestBatch(products: Product[]): Promise<IngestResponse>;
     search(query: string, limit?: number): Promise<SearchResponse>;
+    searchVector(query: string, limit?: number): Promise<SearchResponse>;
+    chat(query: string, history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>): Promise<{
+        answer: string;
+        sources: any[];
+    }>;
 }
 
 declare class HuskelClient {
@@ -100,6 +108,10 @@ declare class HuskelClient {
     private onlineHandler;
     private shopperId?;
     private sessionId;
+    private static INGEST_CACHE_KEY;
+    private static INGEST_CACHE_TTL;
+    private loadIngestedCache;
+    private saveIngestedCache;
     constructor(config: HuskelConfig);
     setShopperId(id: string | undefined): void;
     getShopperId(): string | undefined;
@@ -158,6 +170,29 @@ declare function useIngest(): UseIngestReturn;
  */
 declare function usePageIngest(product: RawProductInput | null | undefined): void;
 
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatSource {
+    id?: string;
+    name: string;
+    price?: string;
+    currency?: string;
+    category?: string;
+    url?: string;
+    image?: string;
+}
+interface UseChatReturn {
+    messages: ChatMessage[];
+    sources: ChatSource[];
+    loading: boolean;
+    error: string | null;
+    send: (query: string) => Promise<void>;
+    reset: () => void;
+}
+declare function useChat(): UseChatReturn;
+
 interface SearchBarProps {
     placeholder?: string;
     limit?: number;
@@ -178,9 +213,18 @@ interface SparkleProps {
 }
 declare function Sparkle({ productName, limit, onResult, className }: SparkleProps): react_jsx_runtime.JSX.Element;
 
+interface ChatWidgetProps {
+    placeholder?: string;
+    title?: string;
+    className?: string;
+    /** Called when user clicks a product link */
+    onSelectSource?: (source: ChatSource) => void;
+}
+declare function ChatWidget({ placeholder, title, className, onSelectSource }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+
 interface HuskelProviderProps extends HuskelConfig {
     children: React.ReactNode;
 }
 declare function HuskelProvider({ siteId, apiUrl, apiToken, shopperId, children }: HuskelProviderProps): react_jsx_runtime.JSX.Element;
 
-export { HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useHuskel, useIngest, usePageIngest, useSearch };
+export { type ChatMessage, type ChatSource, ChatWidget, HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useChat, useHuskel, useIngest, usePageIngest, useSearch };

package/dist/index.d.ts

@@ -90,6 +90,14 @@ declare class HuskelAPI {
     ingest(product: Product): Promise<IngestResponse>;
     ingestBatch(products: Product[]): Promise<IngestResponse>;
     search(query: string, limit?: number): Promise<SearchResponse>;
+    searchVector(query: string, limit?: number): Promise<SearchResponse>;
+    chat(query: string, history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>): Promise<{
+        answer: string;
+        sources: any[];
+    }>;
 }
 
 declare class HuskelClient {
@@ -100,6 +108,10 @@ declare class HuskelClient {
     private onlineHandler;
     private shopperId?;
     private sessionId;
+    private static INGEST_CACHE_KEY;
+    private static INGEST_CACHE_TTL;
+    private loadIngestedCache;
+    private saveIngestedCache;
     constructor(config: HuskelConfig);
     setShopperId(id: string | undefined): void;
     getShopperId(): string | undefined;
@@ -158,6 +170,29 @@ declare function useIngest(): UseIngestReturn;
  */
 declare function usePageIngest(product: RawProductInput | null | undefined): void;
 
+interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+interface ChatSource {
+    id?: string;
+    name: string;
+    price?: string;
+    currency?: string;
+    category?: string;
+    url?: string;
+    image?: string;
+}
+interface UseChatReturn {
+    messages: ChatMessage[];
+    sources: ChatSource[];
+    loading: boolean;
+    error: string | null;
+    send: (query: string) => Promise<void>;
+    reset: () => void;
+}
+declare function useChat(): UseChatReturn;
+
 interface SearchBarProps {
     placeholder?: string;
     limit?: number;
@@ -178,9 +213,18 @@ interface SparkleProps {
 }
 declare function Sparkle({ productName, limit, onResult, className }: SparkleProps): react_jsx_runtime.JSX.Element;
 
+interface ChatWidgetProps {
+    placeholder?: string;
+    title?: string;
+    className?: string;
+    /** Called when user clicks a product link */
+    onSelectSource?: (source: ChatSource) => void;
+}
+declare function ChatWidget({ placeholder, title, className, onSelectSource }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+
 interface HuskelProviderProps extends HuskelConfig {
     children: React.ReactNode;
 }
 declare function HuskelProvider({ siteId, apiUrl, apiToken, shopperId, children }: HuskelProviderProps): react_jsx_runtime.JSX.Element;
 
-export { HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useHuskel, useIngest, usePageIngest, useSearch };
+export { type ChatMessage, type ChatSource, ChatWidget, HuskelAPI, HuskelClient, type HuskelConfig, type HuskelError, HuskelProvider, type IngestResponse, type Product, type RawProductInput, SearchBar, type SearchRequest, type SearchResponse, type SearchResult, Sparkle, getHuskelClient, initHuskel, useChat, useHuskel, useIngest, usePageIngest, useSearch };

package/dist/index.js

@@ -38,6 +38,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ChatWidget: () => ChatWidget,
   HuskelAPI: () => HuskelAPI,
   HuskelClient: () => HuskelClient,
   HuskelProvider: () => HuskelProvider,
@@ -45,6 +46,7 @@ __export(index_exports, {
   Sparkle: () => Sparkle,
   getHuskelClient: () => getHuskelClient,
   initHuskel: () => initHuskel,
+  useChat: () => useChat,
   useHuskel: () => useHuskel,
   useIngest: () => useIngest,
   usePageIngest: () => usePageIngest,
@@ -134,6 +136,15 @@ var HuskelAPI = class {
     log("info", "search query", query);
     return this.post("/search", { query, siteId: this.siteId, limit });
   }
+  // Pure vector search — no LLM, instant results. This is what the SearchBar uses.
+  async searchVector(query, limit = 10) {
+    return this.post("/search/vector", { query, siteId: this.siteId, limit });
+  }
+  // LLM chat — conversational search with history context.
+  async chat(query, history = []) {
+    log("info", "chat query", query);
+    return this.post("/chat", { query, siteId: this.siteId, history });
+  }
 };
 
 // src/client.ts
@@ -227,7 +238,7 @@ function generateUUID() {
     return v.toString(16);
   });
 }
-var HuskelClient = class {
+var _HuskelClient = class _HuskelClient {
   constructor(config) {
     this.ingestQueue = [];
     this.ingestTimer = null;
@@ -242,6 +253,7 @@ var HuskelClient = class {
     if (!apiToken) console.error('[Huskel] Missing apiToken. Set it via <HuskelProvider apiToken="..."> or NEXT_PUBLIC_HUSKEL_API_TOKEN.');
     this.shopperId = config.shopperId;
     this.initSession();
+    this.loadIngestedCache();
     this.api = new HuskelAPI(
       apiUrl,
       siteId,
@@ -258,6 +270,31 @@ var HuskelClient = class {
       window.addEventListener("online", this.onlineHandler);
     }
   }
+  // 24h
+  loadIngestedCache() {
+    if (typeof window === "undefined") return;
+    try {
+      const raw = localStorage.getItem(_HuskelClient.INGEST_CACHE_KEY);
+      if (!raw) return;
+      const { ts, urls } = JSON.parse(raw);
+      if (Date.now() - ts > _HuskelClient.INGEST_CACHE_TTL) {
+        localStorage.removeItem(_HuskelClient.INGEST_CACHE_KEY);
+        return;
+      }
+      this.ingestedUrls = new Set(urls);
+    } catch (e) {
+    }
+  }
+  saveIngestedCache() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(
+        _HuskelClient.INGEST_CACHE_KEY,
+        JSON.stringify({ ts: Date.now(), urls: [...this.ingestedUrls] })
+      );
+    } catch (e) {
+    }
+  }
   setShopperId(id) {
     this.shopperId = id;
   }
@@ -300,6 +337,7 @@ var HuskelClient = class {
       return;
     }
     this.ingestedUrls.add(product.url);
+    this.saveIngestedCache();
     this.ingestQueue.push(product);
     this.scheduleFlush();
   }
@@ -314,6 +352,7 @@ var HuskelClient = class {
       this.ingestQueue.push(product);
     });
     if (this.ingestQueue.length > 0) {
+      this.saveIngestedCache();
       this.scheduleFlush();
     }
   }
@@ -345,6 +384,9 @@ var HuskelClient = class {
     }
   }
 };
+_HuskelClient.INGEST_CACHE_KEY = "huskel_ingested_v1";
+_HuskelClient.INGEST_CACHE_TTL = 24 * 60 * 60 * 1e3;
+var HuskelClient = _HuskelClient;
 var instance = null;
 function initHuskel(config) {
   instance = new HuskelClient(config);
@@ -425,7 +467,7 @@ function useSearch() {
     setLoading(true);
     setError(null);
     try {
-      const res = await client.api.search(query, limit);
+      const res = await client.api.searchVector(query, limit);
       setResults((_b = res.results) != null ? _b : []);
     } catch (e) {
       setError((_c = e.message) != null ? _c : "Search failed");
@@ -491,8 +533,47 @@ function usePageIngest(product) {
   }, [(_a = product == null ? void 0 : product.url) != null ? _a : product == null ? void 0 : product.name]);
 }
 
-// src/components/SearchBar.tsx
+// src/hooks/useChat.ts
 var import_react6 = require("react");
+function useChat() {
+  const client = useHuskelContext();
+  const [messages, setMessages] = (0, import_react6.useState)([]);
+  const [sources, setSources] = (0, import_react6.useState)([]);
+  const [loading, setLoading] = (0, import_react6.useState)(false);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const abortRef = (0, import_react6.useRef)(null);
+  const send = (0, import_react6.useCallback)(async (query) => {
+    var _a, _b, _c;
+    if (!query.trim() || loading) return;
+    (_a = abortRef.current) == null ? void 0 : _a.abort();
+    abortRef.current = new AbortController();
+    const userMsg = { role: "user", content: query };
+    setMessages((prev) => [...prev, userMsg]);
+    setLoading(true);
+    setError(null);
+    try {
+      const history = messages.map((m) => ({ role: m.role, content: m.content }));
+      const res = await client.api.chat(query, history);
+      const assistantMsg = { role: "assistant", content: res.answer };
+      setMessages((prev) => [...prev, assistantMsg]);
+      setSources((_b = res.sources) != null ? _b : []);
+    } catch (e) {
+      setError((_c = e == null ? void 0 : e.message) != null ? _c : "Chat request failed");
+      setMessages((prev) => prev.slice(0, -1));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, messages, loading]);
+  const reset = (0, import_react6.useCallback)(() => {
+    setMessages([]);
+    setSources([]);
+    setError(null);
+  }, []);
+  return { messages, sources, loading, error, send, reset };
+}
+
+// src/components/SearchBar.tsx
+var import_react7 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var S = `
   .hsk-wrap{position:relative;width:100%;font-family:inherit}
@@ -516,12 +597,12 @@ function SearchBar({
   dropdownClassName,
   renderResult
 }) {
-  const [query, setQuery] = (0, import_react6.useState)("");
-  const [open, setOpen] = (0, import_react6.useState)(false);
+  const [query, setQuery] = (0, import_react7.useState)("");
+  const [open, setOpen] = (0, import_react7.useState)(false);
   const { results, loading, search, clear } = useSearch();
-  const timer = (0, import_react6.useRef)();
-  const wrap = (0, import_react6.useRef)(null);
-  (0, import_react6.useEffect)(() => {
+  const timer = (0, import_react7.useRef)();
+  const wrap = (0, import_react7.useRef)(null);
+  (0, import_react7.useEffect)(() => {
     clearTimeout(timer.current);
     if (!query.trim()) {
       clear();
@@ -534,7 +615,7 @@ function SearchBar({
     }, debounceMs);
     return () => clearTimeout(timer.current);
   }, [query, search, clear, limit, debounceMs]);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const handler = (e) => {
       if (wrap.current && !wrap.current.contains(e.target)) setOpen(false);
     };
@@ -589,7 +670,7 @@ function SearchBar({
 }
 
 // src/components/Sparkle.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var S2 = `
   .hsk-sparkle{display:inline-flex;align-items:center;gap:5px;padding:4px 10px;font-size:12px;font-weight:600;background:#f47c3c;color:#fff;border:none;border-radius:20px;cursor:pointer;transition:opacity .2s,transform .15s}
@@ -598,11 +679,11 @@ var S2 = `
 `;
 function Sparkle({ productName, limit = 5, onResult, className }) {
   const client = useHuskelContext();
-  const [loading, setLoading] = (0, import_react7.useState)(false);
+  const [loading, setLoading] = (0, import_react8.useState)(false);
   const handleClick = async () => {
     setLoading(true);
     try {
-      const res = await client.api.search(productName, limit);
+      const res = await client.api.searchVector(productName, limit);
       onResult == null ? void 0 : onResult(res.results);
     } catch (e) {
       console.error("[Huskel Sparkle]", e);
@@ -618,8 +699,153 @@ function Sparkle({ productName, limit = 5, onResult, className }) {
     ] })
   ] });
 }
+
+// src/components/ChatWidget.tsx
+var import_react9 = require("react");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+var S3 = `
+  .hsk-chat-widget{display:flex;flex-direction:column;height:100%;min-height:320px;font-family:inherit;background:#0f0f10;border:1px solid #2a2a2d;border-radius:12px;overflow:hidden}
+  .hsk-chat-header{display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1px solid #1e1e1f;background:#111112;flex-shrink:0}
+  .hsk-chat-title{font-size:14px;font-weight:600;color:#f3f3f2}
+  .hsk-chat-badge{font-size:10px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:#ff6a33;background:#ff6a3315;border:1px solid #ff6a3330;padding:2px 8px;border-radius:20px}
+  .hsk-chat-messages{flex:1;overflow-y:auto;padding:16px;display:flex;flex-direction:column;gap:12px;scroll-behavior:smooth}
+  .hsk-chat-empty{display:flex;flex-direction:column;align-items:center;justify-content:center;height:100%;gap:8px;color:#555;font-size:13px;text-align:center;padding:24px}
+  .hsk-chat-empty-icon{font-size:28px;margin-bottom:4px}
+  .hsk-msg-row{display:flex;gap:8px;align-items:flex-start}
+  .hsk-msg-row.user{flex-direction:row-reverse}
+  .hsk-msg-avatar{width:28px;height:28px;border-radius:50%;flex-shrink:0;display:flex;align-items:center;justify-content:center;font-size:13px;font-weight:700}
+  .hsk-msg-avatar.ai{background:#ff6a3320;border:1px solid #ff6a3340;color:#ff6a33}
+  .hsk-msg-avatar.user{background:#2a2a2d;color:#9a9aa1}
+  .hsk-msg-bubble{max-width:78%;padding:10px 14px;border-radius:12px;font-size:13px;line-height:1.6}
+  .hsk-msg-bubble.ai{background:#171718;border:1px solid #2a2a2d;color:#e8e8e7;border-radius:4px 12px 12px 12px}
+  .hsk-msg-bubble.user{background:#ff6a33;color:#fff;border-radius:12px 4px 12px 12px}
+  .hsk-sources{margin-top:10px;display:flex;flex-direction:column;gap:6px}
+  .hsk-source-card{display:flex;align-items:center;gap:10px;padding:8px 10px;background:#1a1a1b;border:1px solid #252527;border-radius:8px;cursor:pointer;transition:border-color 0.15s}
+  .hsk-source-card:hover{border-color:#ff6a3360}
+  .hsk-source-img{width:36px;height:36px;object-fit:cover;border-radius:4px;background:#fff}
+  .hsk-source-name{font-size:12px;font-weight:500;color:#e8e8e7;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .hsk-source-price{font-size:11px;color:#ff6a33;font-weight:700;margin-top:2px}
+  .hsk-typing{display:flex;gap:4px;align-items:center;padding:10px 14px;background:#171718;border:1px solid #2a2a2d;border-radius:4px 12px 12px 12px;width:fit-content}
+  .hsk-typing-dot{width:6px;height:6px;background:#ff6a33;border-radius:50%;animation:hsk-chat-bounce 1.2s infinite}
+  .hsk-typing-dot:nth-child(2){animation-delay:0.2s}
+  .hsk-typing-dot:nth-child(3){animation-delay:0.4s}
+  @keyframes hsk-chat-bounce{0%,100%{opacity:0.3;transform:translateY(0)}50%{opacity:1;transform:translateY(-4px)}}
+  .hsk-chat-input-area{display:flex;align-items:center;gap:8px;padding:12px 14px;border-top:1px solid #1e1e1f;background:#111112;flex-shrink:0}
+  .hsk-chat-input{flex:1;background:#1a1a1b;border:1px solid #2a2a2d;border-radius:8px;padding:9px 14px;font-size:13px;color:#f3f3f2;outline:none;font-family:inherit;transition:border-color 0.2s;resize:none;min-height:38px;max-height:120px;line-height:1.5}
+  .hsk-chat-input::placeholder{color:#555}
+  .hsk-chat-input:focus{border-color:#ff6a33}
+  .hsk-chat-send{width:34px;height:34px;border-radius:8px;background:#ff6a33;border:none;color:#fff;cursor:pointer;display:flex;align-items:center;justify-content:center;flex-shrink:0;font-size:16px;transition:opacity 0.15s,transform 0.1s}
+  .hsk-chat-send:hover{opacity:0.88}
+  .hsk-chat-send:active{transform:scale(0.93)}
+  .hsk-chat-send:disabled{opacity:0.4;cursor:not-allowed}
+  .hsk-chat-reset{font-size:11px;color:#555;cursor:pointer;padding:0 4px;transition:color 0.15s;background:none;border:none;font-family:inherit}
+  .hsk-chat-reset:hover{color:#ff6a33}
+`;
+function SourceCard({ source, onSelect }) {
+  var _a;
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-source-card", onClick: () => onSelect == null ? void 0 : onSelect(source), children: [
+    source.image && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("img", { src: source.image, alt: source.name, className: "hsk-source-img" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { flex: 1, minWidth: 0 }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-source-name", children: source.name }),
+      source.price && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-source-price", children: [
+        (_a = source.currency) != null ? _a : "KES",
+        " ",
+        source.price
+      ] })
+    ] })
+  ] });
+}
+function ChatWidget({ placeholder = "Ask about anything in our store\u2026", title = "AI Shopping Assistant", className, onSelectSource }) {
+  const { messages, sources, loading, error, send, reset } = useChat();
+  const [input, setInput] = (0, import_react9.useState)("");
+  const bottomRef = (0, import_react9.useRef)(null);
+  const textareaRef = (0, import_react9.useRef)(null);
+  (0, import_react9.useEffect)(() => {
+    var _a;
+    (_a = bottomRef.current) == null ? void 0 : _a.scrollIntoView({ behavior: "smooth" });
+  }, [messages, loading]);
+  const handleSend = async () => {
+    const q = input.trim();
+    if (!q || loading) return;
+    setInput("");
+    if (textareaRef.current) textareaRef.current.style.height = "auto";
+    await send(q);
+  };
+  const handleKey = (e) => {
+    if (e.key === "Enter" && !e.shiftKey) {
+      e.preventDefault();
+      handleSend();
+    }
+  };
+  const handleInput = (e) => {
+    setInput(e.target.value);
+    const t = e.target;
+    t.style.height = "auto";
+    t.style.height = Math.min(t.scrollHeight, 120) + "px";
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: S3 }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: `hsk-chat-widget ${className != null ? className : ""}`, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-chat-header", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { style: { fontSize: 16, color: "#ff6a33" }, children: "\u2726" }),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "hsk-chat-title", children: title }),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "hsk-chat-badge", children: "AI" }),
+        messages.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("button", { className: "hsk-chat-reset", onClick: reset, style: { marginLeft: "auto" }, children: "Clear" })
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-chat-messages", children: [
+        messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-chat-empty", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-chat-empty-icon", children: "\u2726" }),
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { children: "Ask me anything about our products" }),
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { style: { fontSize: 12, color: "#444", marginTop: 4 }, children: '"Find me headphones under KSh 5,000" \xB7 "Gift ideas for a chef"' })
+        ] }) : messages.map((msg, idx) => /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: `hsk-msg-row ${msg.role}`, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: `hsk-msg-avatar ${msg.role === "assistant" ? "ai" : "user"}`, children: msg.role === "assistant" ? "\u2726" : "\u2191" }),
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: `hsk-msg-bubble ${msg.role === "assistant" ? "ai" : "user"}`, children: msg.content })
+          ] }),
+          msg.role === "assistant" && idx === messages.length - 1 && sources.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { style: { marginLeft: 36 }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-sources", children: sources.map((src, si) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(SourceCard, { source: src, onSelect: onSelectSource }, si)) }) })
+        ] }, idx)),
+        loading && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-msg-row", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-msg-avatar ai", children: "\u2726" }),
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-typing", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-typing-dot" }),
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-typing-dot" }),
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "hsk-typing-dot" })
+          ] })
+        ] }),
+        error && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { style: { fontSize: 12, color: "#ef4444", textAlign: "center", padding: 8 }, children: error }),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { ref: bottomRef })
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "hsk-chat-input-area", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          "textarea",
+          {
+            ref: textareaRef,
+            className: "hsk-chat-input",
+            value: input,
+            onChange: handleInput,
+            onKeyDown: handleKey,
+            placeholder,
+            rows: 1,
+            disabled: loading
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          "button",
+          {
+            className: "hsk-chat-send",
+            onClick: handleSend,
+            disabled: !input.trim() || loading,
+            "aria-label": "Send",
+            children: "\u2191"
+          }
+        )
+      ] })
+    ] })
+  ] });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ChatWidget,
   HuskelAPI,
   HuskelClient,
   HuskelProvider,
@@ -627,6 +853,7 @@ function Sparkle({ productName, limit = 5, onResult, className }) {
   Sparkle,
   getHuskelClient,
   initHuskel,
+  useChat,
   useHuskel,
   useIngest,
   usePageIngest,