@keluhq/sdk

​

Install

npm install @keluhq/sdk

import { VERSION } from "@keluhq/sdk";

​

Example

import { Kelu } from "@keluhq/sdk";

const kelu = new Kelu({
  knowledgeBaseId: "YOUR_KNOWLEDGE_BASE_ID",
  clientKey: "kl_pk_...",
});

const { answer, citations, threadId, messageId } = await kelu.chat(
  "How do I authenticate?",
  { onToken: (t) => render(t) },
);

await kelu.chat("And with SSO?", { threadId });     // follow-up, same conversation
await kelu.feedback({ messageId, rating: "up" });   // rate the first answer

​

CAPTCHA

• Google shows its reCAPTCHA badge in a corner of the page. You may hide it only if your page shows Google’s reCAPTCHA notice instead.
• A page that already runs reCAPTCHA with a site key of its own keeps working. The client adds an invisible reCAPTCHA client for Kelu’s key instead of loading Google’s script a second time.
• If Google’s script cannot load, for example because an ad blocker or a Content Security Policy blocks it, or it takes longer than 12 seconds, the call throws captcha_failed with retryable: true, and the question is not sent.
• With a Content Security Policy, allow https://www.google.com/recaptcha/ and https://www.gstatic.com/recaptcha/ in script-src; https://www.google.com/recaptcha/ and https://recaptcha.google.com/recaptcha/ in frame-src; and https://www.google.com/recaptcha/, https://app.kelu.dev and wss://app.kelu.dev in connect-src. Google’s own list is in the reCAPTCHA FAQ.
• To mint tokens yourself, pass getCaptchaToken. It replaces the automatic one. Return "" from it to send no token.
• Rather not load Google’s script on your page? Send questions from your own server, which calls Kelu with a secret pair and needs no token. Never put the secret pair in browser code: anyone could copy it from the page and spend your question allowance, with no captcha or origin check to stop them.
• A secret pair never needs a token. Code with no browser page, such as a server, React Native or a web worker, gets no automatic token. React Native has no browser to run reCAPTCHA in, so with a public key on app.kelu.dev, send questions through your own server, which calls Kelu with a secret pair.

​

Options

​

Methods

​

chat() options

​

search() options

​

Types

​

Showing the answer

import { renderMarkdown } from "@keluhq/sdk";

let text = "";
await kelu.chat("How do I authenticate?", {
  onToken: (t) => { text += t; el.innerHTML = renderMarkdown(text); },
  onAnswer: (full) => { text = full; el.innerHTML = renderMarkdown(text); },
});

• All text is escaped, so the result is safe for innerHTML. A link whose URL fails safeUrl stays plain text.
• Links open in a new tab (target="_blank" rel="noopener noreferrer").
• [n] becomes <sup class="kl-md-cite">n</sup>.
• Headings move down two levels, # to <h3> and ## to <h4>, so an answer never outranks your page’s headings.
• A code block comes with a Copy button (button.kl-copy). It does nothing until you handle the click:

el.addEventListener("click", (e) => {
  const button = (e.target as Element).closest(".kl-copy");
  const code = button?.closest(".kl-code")?.querySelector("code")?.textContent;
  if (code) navigator.clipboard.writeText(code);
});

​

Transport

​

React Native

npm install react-native-fetch-api web-streams-polyfill

// index.js
import "web-streams-polyfill/polyfill";
import "react-native-fetch-api/polyfill";

​

Errors

import { KeluError } from "@keluhq/sdk";

try {
  await kelu.chat("...");
} catch (err) {
  if (err instanceof KeluError && err.retryable) showRetryButton();
}