@schmitech/chatbot-api 2.1.5 → 2.2.0

package/dist/api.mjs

@@ -1,40 +1,88 @@
-var j = Object.defineProperty;
-var D = (l, r, e) => r in l ? j(l, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : l[r] = e;
-var P = (l, r, e) => D(l, typeof r != "symbol" ? r + "" : r, e);
-let I = null, $ = null;
+var x = Object.defineProperty;
+var M = (o, e, t) => e in o ? x(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
+var g = (o, e, t) => M(o, typeof e != "symbol" ? e + "" : e, t);
+let b = null, $ = null;
 typeof window > "u" && Promise.all([
   // @ts-expect-error - Dynamic import of Node.js built-in module (only available in Node.js runtime)
   import("http").catch(() => null),
   // @ts-expect-error - Dynamic import of Node.js built-in module (only available in Node.js runtime)
   import("https").catch(() => null)
-]).then(([l, r]) => {
-  var e, t;
-  (e = l == null ? void 0 : l.default) != null && e.Agent ? I = new l.default.Agent({ keepAlive: !0 }) : l != null && l.Agent && (I = new l.Agent({ keepAlive: !0 })), (t = r == null ? void 0 : r.default) != null && t.Agent ? $ = new r.default.Agent({ keepAlive: !0 }) : r != null && r.Agent && ($ = new r.Agent({ keepAlive: !0 }));
-}).catch((l) => {
-  console.warn("Failed to initialize HTTP agents:", l.message);
+]).then(([o, e]) => {
+  var t, s;
+  (t = o == null ? void 0 : o.default) != null && t.Agent ? b = new o.default.Agent({ keepAlive: !0 }) : o != null && o.Agent && (b = new o.Agent({ keepAlive: !0 })), (s = e == null ? void 0 : e.default) != null && s.Agent ? $ = new e.default.Agent({ keepAlive: !0 }) : e != null && e.Agent && ($ = new e.Agent({ keepAlive: !0 }));
+}).catch((o) => {
+  console.warn("Failed to initialize HTTP agents:", o.message);
 });
-class N {
+const T = "Could not connect to the server. Please check if the server is running.", J = 6e4, D = 1e6, H = 5e5;
+class B {
   // Session ID can be mutable
-  constructor(r) {
-    P(this, "apiUrl");
-    P(this, "apiKey");
-    P(this, "sessionId");
-    if (!r.apiUrl || typeof r.apiUrl != "string")
+  constructor(e) {
+    g(this, "apiUrl");
+    g(this, "apiKey");
+    g(this, "adapterName");
+    g(this, "middlewareBaseUrl");
+    g(this, "middlewareMode");
+    g(this, "sessionId");
+    if (!e.apiUrl || typeof e.apiUrl != "string")
       throw new Error("API URL must be a valid string");
-    if (r.apiKey !== void 0 && r.apiKey !== null && typeof r.apiKey != "string")
+    if (e.apiKey !== void 0 && e.apiKey !== null && typeof e.apiKey != "string")
       throw new Error("API key must be a valid string or null");
-    if (r.sessionId !== void 0 && r.sessionId !== null && typeof r.sessionId != "string")
+    if (e.sessionId !== void 0 && e.sessionId !== null && typeof e.sessionId != "string")
       throw new Error("Session ID must be a valid string or null");
-    this.apiUrl = r.apiUrl, this.apiKey = r.apiKey ?? null, this.sessionId = r.sessionId ?? null;
+    if (e.adapterName !== void 0 && e.adapterName !== null && typeof e.adapterName != "string")
+      throw new Error("Adapter name must be a valid string or null");
+    if (e.middlewareBaseUrl !== void 0 && e.middlewareBaseUrl !== null && typeof e.middlewareBaseUrl != "string")
+      throw new Error("Middleware base URL must be a valid string or null");
+    this.apiUrl = e.apiUrl, this.apiKey = e.apiKey ?? null, this.sessionId = e.sessionId ?? null;
+    const t = typeof e.adapterName == "string" ? e.adapterName.trim() : "";
+    this.adapterName = t && t.length > 0 ? t : null;
+    const s = typeof e.middlewareBaseUrl == "string" ? e.middlewareBaseUrl.trim() : "";
+    this.middlewareBaseUrl = s.endsWith("/") ? s.slice(0, -1) : s;
+    const i = e.useMiddleware ?? (!this.apiKey && !!this.adapterName);
+    this.middlewareMode = !!(this.adapterName && i);
   }
-  setSessionId(r) {
-    if (r !== null && typeof r != "string")
+  setSessionId(e) {
+    if (e !== null && typeof e != "string")
       throw new Error("Session ID must be a valid string or null");
-    this.sessionId = r;
+    this.sessionId = e;
   }
   getSessionId() {
     return this.sessionId;
   }
+  hasFailedToFetch(e) {
+    var t;
+    return (e == null ? void 0 : e.name) === "TypeError" && ((t = e == null ? void 0 : e.message) == null ? void 0 : t.includes("Failed to fetch"));
+  }
+  rethrowNetworkError(e) {
+    if (this.hasFailedToFetch(e))
+      throw new Error(T);
+  }
+  async fetchWithNetworkErrorHandling(e, t) {
+    try {
+      return await fetch(e, t);
+    } catch (s) {
+      throw this.rethrowNetworkError(s), s;
+    }
+  }
+  async requestJsonOrThrow(e, t, s) {
+    try {
+      const i = await fetch(e, {
+        ...this.getFetchOptions(t)
+      });
+      if (!i.ok) {
+        const r = await i.text();
+        throw new Error(`${s}: ${i.status} ${r}`);
+      }
+      return await i.json();
+    } catch (i) {
+      throw this.rethrowNetworkError(i), i;
+    }
+  }
+  getRequiredApiKey(e) {
+    if (!this.apiKey)
+      throw new Error(e);
+    return this.apiKey;
+  }
   /**
    * Validate that the API key exists and is active.
    *
@@ -42,63 +90,59 @@ class N {
    * @throws Error if API key is not provided, invalid, inactive, or validation fails
    */
   async validateApiKey() {
-    var r;
-    if (!this.apiKey)
-      throw new Error("API key is required for validation");
+    const e = this.getRequiredApiKey("API key is required for validation");
     try {
-      const e = await fetch(`${this.apiUrl}/admin/api-keys/${this.apiKey}/status`, {
+      const t = await this.fetchWithNetworkErrorHandling(`${this.apiUrl}/admin/api-keys/${e}/status`, {
         ...this.getFetchOptions({
           method: "GET"
         })
-      }).catch((s) => {
-        throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : s;
       });
-      if (!e.ok) {
-        let s = "";
+      if (!t.ok) {
+        let i = "";
         try {
-          s = await e.text();
+          i = await t.text();
         } catch {
-          s = `HTTP ${e.status}`;
+          i = `HTTP ${t.status}`;
         }
-        let i, n;
+        let r, a;
         try {
-          const o = JSON.parse(s);
-          i = o.detail || o.message || s;
+          const d = JSON.parse(i);
+          r = d.detail || d.message || i;
         } catch {
-          i = s || `HTTP ${e.status}`;
+          r = i || `HTTP ${t.status}`;
         }
-        switch (e.status) {
+        switch (t.status) {
           case 401:
-            n = "API key is invalid or expired";
+            a = "API key is invalid or expired";
             break;
           case 403:
-            n = "Access denied: API key does not have required permissions";
+            a = "Access denied: API key does not have required permissions";
             break;
           case 404:
-            n = "API key not found";
+            a = "API key not found";
             break;
           case 503:
-            n = "API key management is not available in inference-only mode";
+            a = "API key management is not available in inference-only mode";
             break;
           default:
-            n = `Failed to validate API key: ${i}`;
+            a = `Failed to validate API key: ${r}`;
             break;
         }
-        throw new Error(n);
+        throw new Error(a);
       }
-      const t = await e.json();
-      if (!t.exists) {
-        const s = "API key does not exist";
-        throw new Error(s);
+      const s = await t.json();
+      if (!s.exists) {
+        const i = "API key does not exist";
+        throw new Error(i);
       }
-      if (!t.active) {
-        const s = "API key is inactive";
-        throw new Error(s);
+      if (!s.active) {
+        const i = "API key is inactive";
+        throw new Error(i);
       }
-      return t;
-    } catch (e) {
-      let t;
-      throw e instanceof Error && e.message ? e.message.includes("API key") || e.message.includes("Access denied") || e.message.includes("invalid") || e.message.includes("expired") || e.message.includes("inactive") || e.message.includes("not found") || e.message.includes("Could not connect") ? t = e.message : t = `API key validation failed: ${e.message}` : e.name === "TypeError" && ((r = e.message) != null && r.includes("Failed to fetch")) ? t = "Could not connect to the server. Please check if the server is running." : t = "API key validation failed. Please check your API key and try again.", console.warn(`[ApiClient] ${t}`), new Error(t);
+      return s;
+    } catch (t) {
+      let s;
+      throw t instanceof Error && t.message ? t.message.includes("API key") || t.message.includes("Access denied") || t.message.includes("invalid") || t.message.includes("expired") || t.message.includes("inactive") || t.message.includes("not found") || t.message.includes("Could not connect") ? s = t.message : s = `API key validation failed: ${t.message}` : this.hasFailedToFetch(t) ? s = T : s = "API key validation failed. Please check your API key and try again.", console.warn(`[ApiClient] ${s}`), new Error(s);
     }
   }
   /**
@@ -111,16 +155,12 @@ class N {
    * @throws Error if API key is not provided, invalid, disabled, or request fails
    */
   async getAdapterInfo() {
-    var r;
-    if (!this.apiKey)
-      throw new Error("API key is required to get adapter information");
+    this.getRequiredApiKey("API key is required to get adapter information");
     try {
-      const e = await fetch(`${this.apiUrl}/admin/adapters/info`, {
+      const e = await this.fetchWithNetworkErrorHandling(`${this.apiUrl}/admin/adapters/info`, {
         ...this.getFetchOptions({
           method: "GET"
         })
-      }).catch((s) => {
-        throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : s;
       });
       if (!e.ok) {
         let s = "";
@@ -129,185 +169,231 @@ class N {
         } catch {
           s = `HTTP ${e.status}`;
         }
-        let i, n;
+        let i, r;
         try {
-          const o = JSON.parse(s);
-          i = o.detail || o.message || s;
+          const a = JSON.parse(s);
+          i = a.detail || a.message || s;
         } catch {
           i = s || `HTTP ${e.status}`;
         }
         switch (e.status) {
           case 401:
-            n = "API key is invalid, disabled, or has no associated adapter";
+            r = "API key is invalid, disabled, or has no associated adapter";
             break;
           case 404:
-            n = "Adapter configuration not found";
+            r = "Adapter configuration not found";
             break;
           case 503:
-            n = "Service is not available";
+            r = "Service is not available";
             break;
           default:
-            n = `Failed to get adapter info: ${i}`;
+            r = `Failed to get adapter info: ${i}`;
             break;
         }
-        throw new Error(n);
+        throw new Error(r);
       }
       return await e.json();
     } catch (e) {
       let t;
-      throw e instanceof Error && e.message ? e.message.includes("API key") || e.message.includes("Adapter") || e.message.includes("invalid") || e.message.includes("disabled") || e.message.includes("not found") || e.message.includes("Could not connect") ? t = e.message : t = `Failed to get adapter info: ${e.message}` : e.name === "TypeError" && ((r = e.message) != null && r.includes("Failed to fetch")) ? t = "Could not connect to the server. Please check if the server is running." : t = "Failed to get adapter information. Please try again.", console.warn(`[ApiClient] ${t}`), new Error(t);
+      throw e instanceof Error && e.message ? e.message.includes("API key") || e.message.includes("Adapter") || e.message.includes("invalid") || e.message.includes("disabled") || e.message.includes("not found") || e.message.includes("Could not connect") ? t = e.message : t = `Failed to get adapter info: ${e.message}` : this.hasFailedToFetch(e) ? t = T : t = "Failed to get adapter information. Please try again.", console.warn(`[ApiClient] ${t}`), new Error(t);
+    }
+  }
+  /**
+   * Get autocomplete suggestions based on query prefix.
+   *
+   * Returns query suggestions based on nl_examples from intent adapter templates.
+   * This is useful for helping users discover available queries.
+   *
+   * @param query - The query prefix (minimum 3 characters)
+   * @param limit - Maximum number of suggestions (default: 5)
+   * @returns Promise resolving to autocomplete suggestions
+   */
+  async getAutocompleteSuggestions(e, t = 5) {
+    if (e.length < 3)
+      return { suggestions: [], query: e };
+    const s = this.middlewareMode && !!this.adapterName;
+    if (!s && !this.apiKey)
+      return { suggestions: [], query: e };
+    try {
+      const i = new URLSearchParams();
+      i.set("q", e), i.set("limit", String(t));
+      let r, a;
+      if (s) {
+        if (!this.middlewareBaseUrl && typeof window > "u")
+          throw new Error("middlewareBaseUrl must be set when using middleware outside the browser environment.");
+        r = `${this.middlewareBaseUrl ? this.middlewareBaseUrl : ""}/api/v1/autocomplete?${i.toString()}`;
+        const u = {
+          "X-Adapter-Name": this.adapterName,
+          "X-Request-ID": Date.now().toString(36) + Math.random().toString(36).substring(2)
+        };
+        this.sessionId && (u["X-Session-ID"] = this.sessionId), a = {
+          method: "GET",
+          headers: u
+        };
+      } else {
+        const l = new URL(`${this.apiUrl}/v1/autocomplete`);
+        l.searchParams.set("q", e), l.searchParams.set("limit", String(t)), r = l.toString(), a = {
+          ...this.getFetchOptions({
+            method: "GET"
+          })
+        };
+      }
+      const d = await fetch(r, a);
+      return d.ok ? await d.json() : (console.warn("[ApiClient] Autocomplete request failed:", d.status), { suggestions: [], query: e });
+    } catch (i) {
+      return console.warn("[ApiClient] Autocomplete error:", i.message), { suggestions: [], query: e };
     }
   }
   // Helper to get fetch options with connection pooling if available
-  getFetchOptions(r = {}) {
-    const e = {};
+  getFetchOptions(e = {}) {
+    const t = {};
     if (typeof window > "u") {
-      const i = this.apiUrl.startsWith("https:") ? $ : I;
-      i && (e.agent = i);
+      const r = this.apiUrl.startsWith("https:") ? $ : b;
+      r && (t.agent = r);
     } else
-      e.headers = { Connection: "keep-alive" };
-    const t = {
+      t.headers = { Connection: "keep-alive" };
+    const s = {
       "X-Request-ID": Date.now().toString(36) + Math.random().toString(36).substring(2)
     };
-    if (e.headers && Object.assign(t, e.headers), r.headers) {
-      const s = r.headers;
-      for (const [i, n] of Object.entries(s))
-        (i.toLowerCase() !== "x-api-key" || !this.apiKey) && (t[i] = n);
+    if (t.headers && Object.assign(s, t.headers), e.headers) {
+      const i = e.headers;
+      for (const [r, a] of Object.entries(i))
+        (r.toLowerCase() !== "x-api-key" || !this.apiKey) && (s[r] = a);
     }
-    return this.apiKey && (t["X-API-Key"] = this.apiKey), this.sessionId && (t["X-Session-ID"] = this.sessionId), {
-      ...r,
+    return this.apiKey && (s["X-API-Key"] = this.apiKey), this.sessionId && (s["X-Session-ID"] = this.sessionId), {
       ...e,
-      headers: t
+      ...t,
+      headers: s
     };
   }
   // Create Chat request
-  createChatRequest(r, e = !0, t, s, i, n, o, d, u, f, g) {
+  createChatRequest(e, t = !0, s, i, r, a, d, l, w, u, m) {
     const c = {
       messages: [
-        { role: "user", content: r }
+        { role: "user", content: e }
       ],
-      stream: e
+      stream: t
     };
-    return t && t.length > 0 && (c.file_ids = t), s && (c.thread_id = s), i && (c.audio_input = i), n && (c.audio_format = n), o && (c.language = o), d !== void 0 && (c.return_audio = d), u && (c.tts_voice = u), f && (c.source_language = f), g && (c.target_language = g), c;
+    return s && s.length > 0 && (c.file_ids = s), i && (c.thread_id = i), r && (c.audio_input = r), a && (c.audio_format = a), d && (c.language = d), l !== void 0 && (c.return_audio = l), w && (c.tts_voice = w), u && (c.source_language = u), m && (c.target_language = m), c;
   }
-  async *streamChat(r, e = !0, t, s, i, n, o, d, u, f, g, c) {
-    var C, x, b;
+  async *streamChat(e, t = !0, s, i, r, a, d, l, w, u, m, c) {
+    var q, U, K;
     try {
-      const w = new AbortController(), S = setTimeout(() => w.abort(), 6e4);
-      c && c.addEventListener("abort", () => w.abort());
-      const m = await fetch(`${this.apiUrl}/v1/chat`, {
+      const y = new AbortController(), S = setTimeout(() => y.abort(), J);
+      c && c.addEventListener("abort", () => y.abort());
+      const A = await fetch(`${this.apiUrl}/v1/chat`, {
         ...this.getFetchOptions({
           method: "POST",
           headers: {
             "Content-Type": "application/json",
-            Accept: e ? "text/event-stream" : "application/json"
+            Accept: t ? "text/event-stream" : "application/json"
           },
           body: JSON.stringify(this.createChatRequest(
-            r,
             e,
             t,
             s,
             i,
-            n,
-            o,
+            r,
+            a,
             d,
+            l,
+            w,
             u,
-            f,
-            g
+            m
           ))
         }),
-        signal: w.signal
+        signal: y.signal
       });
-      if (clearTimeout(S), !m.ok) {
-        const p = await m.text();
-        throw new Error(`Network response was not ok: ${m.status} ${p}`);
+      if (clearTimeout(S), !A.ok) {
+        const f = await A.text();
+        throw new Error(`Network response was not ok: ${A.status} ${f}`);
       }
-      if (!e) {
-        const p = await m.json();
-        p.response && (yield {
-          text: p.response,
+      if (!t) {
+        const f = await A.json();
+        f.response && (yield {
+          text: f.response,
           done: !0,
-          audio: p.audio,
-          audioFormat: p.audio_format
+          audio: f.audio,
+          audioFormat: f.audio_format
         });
         return;
       }
-      const T = (C = m.body) == null ? void 0 : C.getReader();
-      if (!T) throw new Error("No reader available");
-      const _ = new TextDecoder();
-      let y = "", k = !1;
+      const P = (q = A.body) == null ? void 0 : q.getReader();
+      if (!P) throw new Error("No reader available");
+      const N = new TextDecoder();
+      let p = "", E = !1;
       try {
         for (; ; ) {
-          const { done: p, value: U } = await T.read();
-          if (p)
+          const { done: f, value: _ } = await P.read();
+          if (f)
             break;
-          const q = _.decode(U, { stream: !0 });
-          y += q;
-          let A = 0, F;
-          for (; (F = y.indexOf(`
-`, A)) !== -1; ) {
-            const v = y.slice(A, F).trim();
-            if (A = F + 1, v && v.startsWith("data: ")) {
-              const h = v.slice(6).trim();
+          const R = N.decode(_, { stream: !0 });
+          p += R;
+          let k = 0, F;
+          for (; (F = p.indexOf(`
+`, k)) !== -1; ) {
+            const I = p.slice(k, F).trim();
+            if (k = F + 1, I && I.startsWith("data: ")) {
+              const h = I.slice(6).trim();
               if (!h || h === "[DONE]") {
                 yield { text: "", done: !0 };
                 return;
               }
               try {
-                const a = JSON.parse(h);
-                if (a.error) {
-                  const K = `Server error: ${((x = a.error) == null ? void 0 : x.message) || a.error || "Unknown server error"}`;
-                  throw console.warn(`[ApiClient] ${K}`), new Error(K);
+                const n = JSON.parse(h);
+                if (n.error) {
+                  const C = `Server error: ${((U = n.error) == null ? void 0 : U.message) || n.error || "Unknown server error"}`;
+                  throw console.warn(`[ApiClient] ${C}`), new Error(C);
                 }
-                if (a.request_id && !a.response && !a.done) {
+                if (n.request_id && !n.response && !n.done) {
                   yield {
                     text: "",
                     done: !1,
-                    request_id: a.request_id
+                    request_id: n.request_id
                   };
                   continue;
                 }
-                if (a.done === !0) {
-                  k = !0, yield {
+                if (n.done === !0) {
+                  E = !0, yield {
                     text: "",
                     done: !0,
-                    audio: a.audio,
-                    audioFormat: a.audio_format || a.audioFormat,
-                    threading: a.threading
+                    audio: n.audio,
+                    audioFormat: n.audio_format || n.audioFormat,
+                    threading: n.threading
                     // Pass through threading metadata
                   };
                   return;
                 }
-                const O = a.response || "";
-                a.audio_chunk !== void 0 && (yield {
+                const O = n.response || "";
+                n.audio_chunk !== void 0 && (yield {
                   text: "",
                   done: !1,
-                  audio_chunk: a.audio_chunk,
-                  audioFormat: a.audioFormat || a.audio_format || "opus",
-                  chunk_index: a.chunk_index ?? 0
-                }), (O || a.audio) && (k = !0, yield {
+                  audio_chunk: n.audio_chunk,
+                  audioFormat: n.audioFormat || n.audio_format || "opus",
+                  chunk_index: n.chunk_index ?? 0
+                }), (O || n.audio) && (E = !0, yield {
                   text: O,
-                  done: a.done || !1,
-                  audio: a.audio,
-                  audioFormat: a.audio_format || a.audioFormat,
-                  threading: a.threading
+                  done: n.done || !1,
+                  audio: n.audio,
+                  audioFormat: n.audio_format || n.audioFormat,
+                  threading: n.threading
                   // Include threading if present
                 });
-              } catch (a) {
-                if ((b = a == null ? void 0 : a.message) != null && b.startsWith("Server error:"))
-                  throw a;
-                console.warn("[ApiClient] Unable to parse server response. This may be a temporary issue."), console.warn("[ApiClient] Parse error details:", a == null ? void 0 : a.message), console.warn("[ApiClient] JSON text length:", h == null ? void 0 : h.length), console.warn("[ApiClient] JSON text preview (first 200 chars):", h == null ? void 0 : h.substring(0, 200)), console.warn("[ApiClient] JSON text preview (last 200 chars):", h == null ? void 0 : h.substring(h.length - 200));
+              } catch (n) {
+                if ((K = n == null ? void 0 : n.message) != null && K.startsWith("Server error:"))
+                  throw n;
+                console.warn("[ApiClient] Unable to parse server response. This may be a temporary issue."), console.warn("[ApiClient] Parse error details:", n == null ? void 0 : n.message), console.warn("[ApiClient] JSON text length:", h == null ? void 0 : h.length), console.warn("[ApiClient] JSON text preview (first 200 chars):", h == null ? void 0 : h.substring(0, 200)), console.warn("[ApiClient] JSON text preview (last 200 chars):", h == null ? void 0 : h.substring(h.length - 200));
               }
-            } else v && (k = !0, yield { text: v, done: !1 });
+            } else I && (E = !0, yield { text: I, done: !1 });
           }
-          y = y.slice(A), y.length > 1e6 && (console.warn("[ApiClient] Buffer too large, truncating..."), y = y.slice(-5e5));
+          p = p.slice(k), p.length > D && (console.warn("[ApiClient] Buffer too large, truncating..."), p = p.slice(-H));
         }
-        k && (yield { text: "", done: !0 });
+        E && (yield { text: "", done: !0 });
       } finally {
-        T.releaseLock();
+        P.releaseLock();
       }
-    } catch (w) {
-      throw w.name === "AbortError" ? c != null && c.aborted ? new Error("Stream cancelled by user") : new Error("Connection timed out. Please check if the server is running.") : w.name === "TypeError" && w.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : w;
+    } catch (y) {
+      throw y.name === "AbortError" ? c != null && c.aborted ? new Error("Stream cancelled by user") : new Error("Connection timed out. Please check if the server is running.") : this.hasFailedToFetch(y) ? new Error(T) : y;
     }
   }
   /**
@@ -317,107 +403,82 @@ class N {
    * @param requestId - The request identifier (from first stream chunk)
    * @returns Promise resolving to true if stream was cancelled, false otherwise
    */
-  async stopChat(r, e) {
+  async stopChat(e, t) {
     try {
-      const t = await fetch(`${this.apiUrl}/v1/chat/stop`, {
+      const s = await fetch(`${this.apiUrl}/v1/chat/stop`, {
         ...this.getFetchOptions({
           method: "POST",
           headers: {
             "Content-Type": "application/json"
           },
           body: JSON.stringify({
-            session_id: r,
-            request_id: e
+            session_id: e,
+            request_id: t
           })
         })
       });
-      return t.ok ? (await t.json()).status === "cancelled" : (console.warn("[ApiClient] Failed to stop stream:", t.status), !1);
-    } catch (t) {
-      return console.error("[ApiClient] Error stopping stream:", t), !1;
+      return s.ok ? (await s.json()).status === "cancelled" : (console.warn("[ApiClient] Failed to stop stream:", s.status), !1);
+    } catch (s) {
+      return console.error("[ApiClient] Error stopping stream:", s), !1;
     }
   }
-  async getConversationHistory(r, e) {
-    const t = r || this.sessionId;
-    if (!t)
+  async getConversationHistory(e, t) {
+    const s = e || this.sessionId;
+    if (!s)
       throw new Error("No session ID provided and no current session available");
-    const s = {};
-    this.apiKey && (s["X-API-Key"] = this.apiKey);
-    try {
-      const i = new URL(`${this.apiUrl}/admin/chat-history/${t}`);
-      typeof e == "number" && Number.isFinite(e) && e > 0 && i.searchParams.set("limit", String(Math.floor(e)));
-      const n = await fetch(i.toString(), {
-        ...this.getFetchOptions({
-          method: "GET",
-          headers: s
-        })
-      });
-      if (!n.ok) {
-        const f = await n.text();
-        throw new Error(`Failed to fetch conversation history: ${n.status} ${f}`);
-      }
-      const o = await n.json(), d = Array.isArray(o == null ? void 0 : o.messages) ? o.messages : [], u = typeof (o == null ? void 0 : o.count) == "number" ? o.count : d.length;
-      return {
-        session_id: (o == null ? void 0 : o.session_id) || t,
-        messages: d,
-        count: u
-      };
-    } catch (i) {
-      throw i.name === "TypeError" && i.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : i;
-    }
+    const i = {};
+    this.apiKey && (i["X-API-Key"] = this.apiKey);
+    const r = new URL(`${this.apiUrl}/admin/chat-history/${s}`);
+    typeof t == "number" && Number.isFinite(t) && t > 0 && r.searchParams.set("limit", String(Math.floor(t)));
+    const a = await this.requestJsonOrThrow(
+      r.toString(),
+      {
+        method: "GET",
+        headers: i
+      },
+      "Failed to fetch conversation history"
+    ), d = Array.isArray(a == null ? void 0 : a.messages) ? a.messages : [], l = typeof (a == null ? void 0 : a.count) == "number" ? a.count : d.length;
+    return {
+      session_id: (a == null ? void 0 : a.session_id) || s,
+      messages: d,
+      count: l
+    };
   }
-  async clearConversationHistory(r) {
-    const e = r || this.sessionId;
-    if (!e)
+  async clearConversationHistory(e) {
+    const t = e || this.sessionId;
+    if (!t)
       throw new Error("No session ID provided and no current session available");
-    if (!this.apiKey)
-      throw new Error("API key is required for clearing conversation history");
-    const t = {
+    const s = this.getRequiredApiKey("API key is required for clearing conversation history"), i = {
       "Content-Type": "application/json",
-      "X-Session-ID": e,
-      "X-API-Key": this.apiKey
+      "X-Session-ID": t,
+      "X-API-Key": s
     };
-    try {
-      const s = await fetch(`${this.apiUrl}/admin/chat-history/${e}`, {
-        ...this.getFetchOptions({
-          method: "DELETE",
-          headers: t
-        })
-      });
-      if (!s.ok) {
-        const n = await s.text();
-        throw new Error(`Failed to clear conversation history: ${s.status} ${n}`);
-      }
-      return await s.json();
-    } catch (s) {
-      throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : s;
-    }
+    return await this.requestJsonOrThrow(
+      `${this.apiUrl}/admin/chat-history/${t}`,
+      {
+        method: "DELETE",
+        headers: i
+      },
+      "Failed to clear conversation history"
+    );
   }
-  async deleteConversationWithFiles(r, e) {
-    const t = r || this.sessionId;
-    if (!t)
+  async deleteConversationWithFiles(e, t) {
+    const s = e || this.sessionId;
+    if (!s)
       throw new Error("No session ID provided and no current session available");
-    if (!this.apiKey)
-      throw new Error("API key is required for deleting conversation");
-    const s = {
+    const i = this.getRequiredApiKey("API key is required for deleting conversation"), r = {
       "Content-Type": "application/json",
-      "X-Session-ID": t,
-      "X-API-Key": this.apiKey
-    }, i = e && e.length > 0 ? `?file_ids=${e.join(",")}` : "", n = `${this.apiUrl}/admin/conversations/${t}${i}`;
-    try {
-      const o = await fetch(n, {
-        ...this.getFetchOptions({
-          method: "DELETE",
-          headers: s
-        })
-      });
-      if (!o.ok) {
-        const u = await o.text();
-        throw new Error(`Failed to delete conversation: ${o.status} ${u}`);
-      }
-      return await o.json();
-    } catch (o) {
-      throw o.name === "TypeError" && o.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : o;
-    }
+      "X-Session-ID": s,
+      "X-API-Key": i
+    }, a = t && t.length > 0 ? `?file_ids=${t.join(",")}` : "", d = `${this.apiUrl}/admin/conversations/${s}${a}`;
+    return await this.requestJsonOrThrow(
+      d,
+      {
+        method: "DELETE",
+        headers: r
+      },
+      "Failed to delete conversation"
+    );
   }
   /**
    * Create a conversation thread from a parent message.
@@ -427,32 +488,23 @@ class N {
    * @returns Promise resolving to thread information
    * @throws Error if the operation fails
    */
-  async createThread(r, e) {
-    if (!this.apiKey)
-      throw new Error("API key is required for creating threads");
-    const t = {
+  async createThread(e, t) {
+    const i = {
       "Content-Type": "application/json",
-      "X-API-Key": this.apiKey
+      "X-API-Key": this.getRequiredApiKey("API key is required for creating threads")
     };
-    try {
-      const s = await fetch(`${this.apiUrl}/api/threads`, {
-        ...this.getFetchOptions({
-          method: "POST",
-          headers: t,
-          body: JSON.stringify({
-            message_id: r,
-            session_id: e
-          })
+    return await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/threads`,
+      {
+        method: "POST",
+        headers: i,
+        body: JSON.stringify({
+          message_id: e,
+          session_id: t
         })
-      });
-      if (!s.ok) {
-        const n = await s.text();
-        throw new Error(`Failed to create thread: ${s.status} ${n}`);
-      }
-      return await s.json();
-    } catch (s) {
-      throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : s;
-    }
+      },
+      "Failed to create thread"
+    );
   }
   /**
    * Get thread information by thread ID.
@@ -461,27 +513,18 @@ class N {
    * @returns Promise resolving to thread information
    * @throws Error if the operation fails
    */
-  async getThreadInfo(r) {
-    if (!this.apiKey)
-      throw new Error("API key is required for getting thread info");
-    const e = {
-      "X-API-Key": this.apiKey
+  async getThreadInfo(e) {
+    const s = {
+      "X-API-Key": this.getRequiredApiKey("API key is required for getting thread info")
     };
-    try {
-      const t = await fetch(`${this.apiUrl}/api/threads/${r}`, {
-        ...this.getFetchOptions({
-          method: "GET",
-          headers: e
-        })
-      });
-      if (!t.ok) {
-        const i = await t.text();
-        throw new Error(`Failed to get thread info: ${t.status} ${i}`);
-      }
-      return await t.json();
-    } catch (t) {
-      throw t.name === "TypeError" && t.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : t;
-    }
+    return await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/threads/${e}`,
+      {
+        method: "GET",
+        headers: s
+      },
+      "Failed to get thread info"
+    );
   }
   /**
    * Delete a thread and its associated dataset.
@@ -490,27 +533,18 @@ class N {
    * @returns Promise resolving to deletion result
    * @throws Error if the operation fails
    */
-  async deleteThread(r) {
-    if (!this.apiKey)
-      throw new Error("API key is required for deleting threads");
-    const e = {
-      "X-API-Key": this.apiKey
+  async deleteThread(e) {
+    const s = {
+      "X-API-Key": this.getRequiredApiKey("API key is required for deleting threads")
     };
-    try {
-      const t = await fetch(`${this.apiUrl}/api/threads/${r}`, {
-        ...this.getFetchOptions({
-          method: "DELETE",
-          headers: e
-        })
-      });
-      if (!t.ok) {
-        const i = await t.text();
-        throw new Error(`Failed to delete thread: ${t.status} ${i}`);
-      }
-      return await t.json();
-    } catch (t) {
-      throw t.name === "TypeError" && t.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : t;
-    }
+    return await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/threads/${e}`,
+      {
+        method: "DELETE",
+        headers: s
+      },
+      "Failed to delete thread"
+    );
   }
   /**
    * Upload a file for processing and indexing.
@@ -519,26 +553,17 @@ class N {
    * @returns Promise resolving to upload response with file_id
    * @throws Error if upload fails
    */
-  async uploadFile(r) {
-    if (!this.apiKey)
-      throw new Error("API key is required for file upload");
-    const e = new FormData();
-    e.append("file", r);
-    try {
-      const t = await fetch(`${this.apiUrl}/api/files/upload`, {
-        ...this.getFetchOptions({
-          method: "POST",
-          body: e
-        })
-      });
-      if (!t.ok) {
-        const s = await t.text();
-        throw new Error(`Failed to upload file: ${t.status} ${s}`);
-      }
-      return await t.json();
-    } catch (t) {
-      throw t.name === "TypeError" && t.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : t;
-    }
+  async uploadFile(e) {
+    this.getRequiredApiKey("API key is required for file upload");
+    const t = new FormData();
+    return t.append("file", e), await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/files/upload`,
+      {
+        method: "POST",
+        body: t
+      },
+      "Failed to upload file"
+    );
   }
   /**
    * List all files for the current API key.
@@ -547,22 +572,13 @@ class N {
    * @throws Error if request fails
    */
   async listFiles() {
-    if (!this.apiKey)
-      throw new Error("API key is required for listing files");
-    try {
-      const r = await fetch(`${this.apiUrl}/api/files`, {
-        ...this.getFetchOptions({
-          method: "GET"
-        })
-      });
-      if (!r.ok) {
-        const e = await r.text();
-        throw new Error(`Failed to list files: ${r.status} ${e}`);
-      }
-      return await r.json();
-    } catch (r) {
-      throw r.name === "TypeError" && r.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : r;
-    }
+    return this.getRequiredApiKey("API key is required for listing files"), await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/files`,
+      {
+        method: "GET"
+      },
+      "Failed to list files"
+    );
   }
   /**
    * Get information about a specific file.
@@ -571,23 +587,14 @@ class N {
    * @returns Promise resolving to file information
    * @throws Error if file not found or request fails
    */
-  async getFileInfo(r) {
-    if (!this.apiKey)
-      throw new Error("API key is required for getting file info");
-    try {
-      const e = await fetch(`${this.apiUrl}/api/files/${r}`, {
-        ...this.getFetchOptions({
-          method: "GET"
-        })
-      });
-      if (!e.ok) {
-        const t = await e.text();
-        throw new Error(`Failed to get file info: ${e.status} ${t}`);
-      }
-      return await e.json();
-    } catch (e) {
-      throw e.name === "TypeError" && e.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : e;
-    }
+  async getFileInfo(e) {
+    return this.getRequiredApiKey("API key is required for getting file info"), await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/files/${e}`,
+      {
+        method: "GET"
+      },
+      "Failed to get file info"
+    );
   }
   /**
    * Query a specific file using semantic search.
@@ -598,27 +605,18 @@ class N {
    * @returns Promise resolving to query results
    * @throws Error if query fails
    */
-  async queryFile(r, e, t = 10) {
-    if (!this.apiKey)
-      throw new Error("API key is required for querying files");
-    try {
-      const s = await fetch(`${this.apiUrl}/api/files/${r}/query`, {
-        ...this.getFetchOptions({
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({ query: e, max_results: t })
-        })
-      });
-      if (!s.ok) {
-        const i = await s.text();
-        throw new Error(`Failed to query file: ${s.status} ${i}`);
-      }
-      return await s.json();
-    } catch (s) {
-      throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? new Error("Could not connect to the server. Please check if the server is running.") : s;
-    }
+  async queryFile(e, t, s = 10) {
+    return this.getRequiredApiKey("API key is required for querying files"), await this.requestJsonOrThrow(
+      `${this.apiUrl}/api/files/${e}/query`,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ query: t, max_results: s })
+      },
+      "Failed to query file"
+    );
   }
   /**
    * Delete a specific file.
@@ -627,63 +625,62 @@ class N {
    * @returns Promise resolving to deletion result
    * @throws Error if deletion fails
    */
-  async deleteFile(r) {
-    if (!this.apiKey)
-      throw new Error("API key is required for deleting files");
-    const e = `${this.apiUrl}/api/files/${r}`, t = this.getFetchOptions({
+  async deleteFile(e) {
+    this.getRequiredApiKey("API key is required for deleting files");
+    const t = `${this.apiUrl}/api/files/${e}`, s = this.getFetchOptions({
       method: "DELETE"
     });
     try {
-      const s = await fetch(e, t);
-      if (!s.ok) {
-        const n = await s.text();
-        let o;
+      const i = await fetch(t, s);
+      if (!i.ok) {
+        const a = await i.text();
+        let d;
         try {
-          const d = JSON.parse(n);
-          o = d.detail || d.message || `Failed to delete file (HTTP ${s.status})`;
+          const l = JSON.parse(a);
+          d = l.detail || l.message || `Failed to delete file (HTTP ${i.status})`;
         } catch {
-          o = `Failed to delete file (HTTP ${s.status})`;
+          d = `Failed to delete file (HTTP ${i.status})`;
         }
-        throw console.warn(`[ApiClient] ${o}`), new Error(o);
+        throw console.warn(`[ApiClient] ${d}`), new Error(d);
       }
-      return await s.json();
-    } catch (s) {
-      let i;
-      throw s.name === "TypeError" && s.message.includes("Failed to fetch") ? i = "Could not connect to the server. Please check if the server is running." : s.message && !s.message.includes("Failed to delete file") ? i = s.message : i = "Failed to delete file. Please try again.", console.warn(`[ApiClient] ${i}`), new Error(i);
+      return await i.json();
+    } catch (i) {
+      let r;
+      throw this.hasFailedToFetch(i) ? r = T : i.message && !i.message.includes("Failed to delete file") ? r = i.message : r = "Failed to delete file. Please try again.", console.warn(`[ApiClient] ${r}`), new Error(r);
     }
   }
 }
-let E = null;
-const H = (l, r = null, e = null) => {
-  E = new N({ apiUrl: l, apiKey: r, sessionId: e });
+let v = null;
+const j = (o, e = null, t = null) => {
+  v = new B({ apiUrl: o, apiKey: e, sessionId: t });
 };
-async function* X(l, r = !0, e, t, s, i, n, o, d, u, f, g) {
-  if (!E)
+async function* G(o, e = !0, t, s, i, r, a, d, l, w, u, m) {
+  if (!v)
     throw new Error("API not configured. Please call configureApi() with your server URL before using any API functions.");
-  yield* E.streamChat(
-    l,
-    r,
+  yield* v.streamChat(
+    o,
     e,
     t,
     s,
     i,
-    n,
-    o,
+    r,
+    a,
     d,
+    l,
+    w,
     u,
-    f,
-    g
+    m
   );
 }
-async function L(l, r) {
-  if (!E)
+async function W(o, e) {
+  if (!v)
     throw new Error("API not configured. Please call configureApi() with your server URL before using any API functions.");
-  return E.stopChat(l, r);
+  return v.stopChat(o, e);
 }
 export {
-  N as ApiClient,
-  H as configureApi,
-  L as stopChat,
-  X as streamChat
+  B as ApiClient,
+  j as configureApi,
+  W as stopChat,
+  G as streamChat
 };
 //# sourceMappingURL=api.mjs.map