chatbotlite 0.0.1 → 0.3.0

package/dist/client/index.cjs

@@ -0,0 +1,234 @@
+'use strict';
+
+// src/client/types.ts
+var PROVIDER_NAMES = /* @__PURE__ */ new Set([
+  "openai",
+  "deepseek",
+  "groq",
+  "gemini",
+  "anthropic",
+  "cerebras",
+  "sambanova",
+  "fireworks",
+  "mistral",
+  "openrouter",
+  "moonshot"
+]);
+function isKnownProvider(name) {
+  return PROVIDER_NAMES.has(name);
+}
+
+// src/client/providers.ts
+var PROVIDER_ENDPOINTS = {
+  openai: { baseUrl: "https://api.openai.com/v1", defaultModel: "gpt-4o-mini" },
+  deepseek: { baseUrl: "https://api.deepseek.com/v1", defaultModel: "deepseek-chat" },
+  groq: { baseUrl: "https://api.groq.com/openai/v1", defaultModel: "llama-3.3-70b-versatile" },
+  gemini: { baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai", defaultModel: "gemini-2.5-flash" },
+  anthropic: { baseUrl: "https://api.anthropic.com/v1", defaultModel: "claude-haiku-4-5" },
+  cerebras: { baseUrl: "https://api.cerebras.ai/v1", defaultModel: "qwen-3-235b-a22b-instruct-2507" },
+  sambanova: { baseUrl: "https://api.sambanova.ai/v1", defaultModel: "Meta-Llama-3.3-70B-Instruct" },
+  fireworks: { baseUrl: "https://api.fireworks.ai/inference/v1", defaultModel: "accounts/fireworks/models/llama-v3p3-70b-instruct" },
+  mistral: { baseUrl: "https://api.mistral.ai/v1", defaultModel: "mistral-small-latest" },
+  openrouter: { baseUrl: "https://openrouter.ai/api/v1", defaultModel: "deepseek/deepseek-chat" },
+  moonshot: { baseUrl: "https://api.moonshot.ai/v1", defaultModel: "moonshot-v1-32k" }
+};
+function isRetryableError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /\b(429|rate.?limit|quota|exceed|5\d\d|timeout|ECONNRESET|fetch failed)\b/i.test(msg);
+}
+
+// src/core/prompts.ts
+function buildSystemPrompt(knowledge) {
+  return [
+    "You are an AI assistant on a business website. Use ONLY the knowledge below to answer.",
+    "",
+    "## Business knowledge",
+    knowledge.trim(),
+    "",
+    "## Reply rules",
+    "- Reply in 1-2 short sentences, conversational tone.",
+    "- NEVER invent prices, availability, dispatch times, appointment confirmations, or facts not present in the business knowledge above.",
+    "- For anything not covered in the knowledge above, say the owner will follow up \u2014 do NOT guess.",
+    '- If the caller is clearly a vendor/sales pitch, say: "This does not look like a customer service request, so we will not continue this thread."',
+    `- If wrong number or asked to stop, say: "Sorry about that. We won't text again."`,
+    "- Match the caller's language automatically."
+  ].join("\n");
+}
+
+// src/core/guards.ts
+var FORBIDDEN_PHRASES = [
+  "help is coming",
+  "someone is on the way",
+  "technician is on the way",
+  "provider is on the way",
+  "dispatching someone",
+  "i've booked",
+  "i have booked",
+  "reservation confirmed",
+  "your appointment is confirmed",
+  "i've scheduled",
+  "i have scheduled",
+  "we've dispatched",
+  "we have dispatched",
+  "i can confirm",
+  "i guarantee",
+  "guaranteed delivery",
+  "guaranteed arrival",
+  "will arrive at",
+  "arriving at",
+  "i'll send",
+  "i will send"
+];
+function checkForbiddenPhrases(reply) {
+  const lower = reply.toLowerCase();
+  const violations = [];
+  for (const phrase of FORBIDDEN_PHRASES) {
+    if (lower.includes(phrase)) {
+      violations.push(`Forbidden phrase: "${phrase}"`);
+    }
+  }
+  return { ok: violations.length === 0, violations };
+}
+function stripForbidden(reply) {
+  const sentences = reply.split(/(?<=[.!?])\s+/);
+  const kept = sentences.filter((s) => {
+    const lower = s.toLowerCase();
+    return !FORBIDDEN_PHRASES.some((p) => lower.includes(p));
+  });
+  const trimmed = kept.join(" ").trim();
+  if (trimmed.length < 10) {
+    return "Thanks for reaching out \u2014 let me check with the owner and get back to you.";
+  }
+  return trimmed;
+}
+
+// src/client/chatbot.ts
+var ChatBot = class {
+  steps;
+  keys;
+  fetcher;
+  timeoutMs;
+  cachedSystemPrompt;
+  constructor(init) {
+    if (!init.knowledge || typeof init.knowledge !== "string" || init.knowledge.trim().length === 0) {
+      throw new Error("chatbotlite: knowledge is required (a non-empty markdown string).");
+    }
+    this.keys = init.providers.keys ?? {};
+    this.steps = resolveChain(init.providers);
+    this.fetcher = init.options?.fetch ?? globalThis.fetch.bind(globalThis);
+    this.timeoutMs = init.options?.timeoutMs ?? 3e4;
+    this.cachedSystemPrompt = buildSystemPrompt(init.knowledge);
+  }
+  async reply(message, opts = {}) {
+    const systemPrompt = opts.systemPrompt ?? this.cachedSystemPrompt;
+    const messages = [
+      { role: "system", content: systemPrompt },
+      ...opts.history ?? [],
+      { role: "user", content: message }
+    ];
+    const attempts = [];
+    let lastError;
+    for (const step of this.steps) {
+      const t0 = Date.now();
+      try {
+        const result = await this.callProvider(step, messages);
+        attempts.push({ provider: step.provider, model: step.model, status: "ok", latencyMs: Date.now() - t0 });
+        const guard = checkForbiddenPhrases(result.reply);
+        const finalReply = guard.ok ? result.reply : stripForbidden(result.reply);
+        return {
+          reply: finalReply,
+          usedProvider: step.provider,
+          usedModel: step.model,
+          ...result.usage ? { usage: result.usage } : {},
+          guardWarnings: guard.violations,
+          attempts
+        };
+      } catch (err) {
+        lastError = err;
+        const errMsg = err instanceof Error ? err.message : String(err);
+        attempts.push({
+          provider: step.provider,
+          model: step.model,
+          status: "error",
+          error: errMsg,
+          latencyMs: Date.now() - t0
+        });
+        if (!isRetryableError(err)) {
+          throw new Error(`chatbotlite: ${step.label} failed (non-retryable). ${errMsg}`);
+        }
+      }
+    }
+    const summary = attempts.map((a) => `${a.provider}/${a.model}:${a.error ?? "ok"}`).join(" \u2192 ");
+    throw new Error(`chatbotlite: all chain steps failed. Trace: ${summary}. Last error: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  }
+  async callProvider(step, messages) {
+    const endpoint = PROVIDER_ENDPOINTS[step.provider];
+    const key = this.keys[step.provider];
+    if (!key) throw new Error(`Missing API key for provider: ${step.provider}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await this.fetcher(`${endpoint.baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${key}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          model: step.model,
+          messages,
+          temperature: 0.3,
+          max_tokens: 300
+        }),
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`${res.status}: ${body.slice(0, 200)}`);
+      }
+      const data = await res.json();
+      const msg = data.choices?.[0]?.message;
+      const reply = (msg?.content?.trim() || msg?.reasoning_content?.trim()) ?? "";
+      if (!reply) throw new Error("empty reply from provider");
+      const result = { reply };
+      if (data.usage) result.usage = data.usage;
+      return result;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+function resolveChain(providers) {
+  const keys = providers.keys ?? {};
+  const explicit = providers.chain;
+  if (explicit && explicit.length > 0) {
+    return explicit.map((entry) => normalizeChainEntry(entry, keys));
+  }
+  const orderedProviders = Object.keys(keys).filter((k) => isKnownProvider(k) && keys[k]);
+  if (orderedProviders.length === 0) {
+    throw new Error("chatbotlite: at least one provider key is required.");
+  }
+  return orderedProviders.map((provider) => ({
+    provider,
+    model: PROVIDER_ENDPOINTS[provider].defaultModel,
+    label: `${provider}/${PROVIDER_ENDPOINTS[provider].defaultModel}`
+  }));
+}
+function normalizeChainEntry(entry, keys) {
+  if (!isKnownProvider(entry.provider)) {
+    throw new Error(`chatbotlite: unknown provider "${entry.provider}" in chain entry.`);
+  }
+  const provider = entry.provider;
+  const model = entry.model ?? PROVIDER_ENDPOINTS[provider].defaultModel;
+  if (!keys[provider]) {
+    throw new Error(`chatbotlite: chain entry for "${provider}" needs a matching key in providers.keys.`);
+  }
+  return { provider, model, label: `${provider}/${model}` };
+}
+
+exports.ChatBot = ChatBot;
+exports.PROVIDER_ENDPOINTS = PROVIDER_ENDPOINTS;
+exports.isKnownProvider = isKnownProvider;
+exports.isRetryableError = isRetryableError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/types.ts","../../src/client/providers.ts","../../src/core/prompts.ts","../../src/core/guards.ts","../../src/client/chatbot.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Client types — provider + chain config\n\nexport type Provider =\n  | \"openai\"\n  | \"deepseek\"\n  | \"groq\"\n  | \"gemini\"\n  | \"anthropic\"\n  | \"cerebras\"\n  | \"sambanova\"\n  | \"fireworks\"\n  | \"mistral\"\n  | \"openrouter\"\n  | \"moonshot\";\n\n/**\n * One step in the fallback chain. Provider is required; model defaults to the provider's preset.\n */\nexport interface ChainEntry {\n  provider: Provider;\n  model?: string;\n}\n\n/**\n * Provider configuration.\n *\n * `keys` are auth credentials (one key per provider — that key covers all that provider's models).\n * `chain` is the ordered fallback list. Each entry is `{ provider, model? }`.\n *\n * @example\n * ```ts\n * providers: {\n *   keys: {\n *     deepseek: \"sk-...\",\n *     groq:     \"gsk-...\",\n *     openai:   \"sk-...\"\n *   },\n *   chain: [\n *     { provider: \"deepseek\", model: \"deepseek-chat\" },\n *     { provider: \"groq\",     model: \"llama-3.3-70b-versatile\" },\n *     { provider: \"openai\",   model: \"gpt-4o-mini\" }\n *   ]\n * }\n * ```\n *\n * If `chain` is omitted, defaults to one entry per key (in insertion order) using each provider's\n * default model.\n */\nexport interface ProviderConfig {\n  /** API keys per provider. One key covers all that provider's models. */\n  keys: Partial<Record<Provider, string>>;\n  /**\n   * Ordered fallback chain. Each entry: `{ provider, model? }`.\n   * Omit `model` to use the provider's default model.\n   * Omit `chain` entirely to auto-build from keys.\n   */\n  chain?: ChainEntry[];\n}\n\nexport interface ClientOptions {\n  fetch?: typeof globalThis.fetch;\n  timeoutMs?: number;\n}\n\nexport interface ChainStep {\n  provider: Provider;\n  model: string;\n  /** Human-readable label used in attempt traces, e.g. `\"openai/gpt-4o-mini\"`. */\n  label: string;\n}\n\nexport interface AttemptInfo {\n  provider: Provider;\n  model: string;\n  status: \"ok\" | \"error\";\n  error?: string;\n  latencyMs: number;\n}\n\nconst PROVIDER_NAMES: ReadonlySet<string> = new Set([\n  \"openai\", \"deepseek\", \"groq\", \"gemini\", \"anthropic\",\n  \"cerebras\", \"sambanova\", \"fireworks\", \"mistral\", \"openrouter\", \"moonshot\"\n]);\n\nexport function isKnownProvider(name: string): name is Provider {\n  return PROVIDER_NAMES.has(name);\n}\n","import type { Provider } from \"./types.js\";\n\nexport interface ProviderEndpoint {\n  baseUrl: string;\n  defaultModel: string;\n}\n\n/**\n * Built-in OpenAI-compatible providers. All use /v1/chat/completions\n * with response in OpenAI format. Caller supplies API key per provider.\n */\nexport const PROVIDER_ENDPOINTS: Record<Provider, ProviderEndpoint> = {\n  openai:     { baseUrl: \"https://api.openai.com/v1\",                              defaultModel: \"gpt-4o-mini\" },\n  deepseek:   { baseUrl: \"https://api.deepseek.com/v1\",                            defaultModel: \"deepseek-chat\" },\n  groq:       { baseUrl: \"https://api.groq.com/openai/v1\",                         defaultModel: \"llama-3.3-70b-versatile\" },\n  gemini:     { baseUrl: \"https://generativelanguage.googleapis.com/v1beta/openai\", defaultModel: \"gemini-2.5-flash\" },\n  anthropic:  { baseUrl: \"https://api.anthropic.com/v1\",                           defaultModel: \"claude-haiku-4-5\" },\n  cerebras:   { baseUrl: \"https://api.cerebras.ai/v1\",                             defaultModel: \"qwen-3-235b-a22b-instruct-2507\" },\n  sambanova:  { baseUrl: \"https://api.sambanova.ai/v1\",                            defaultModel: \"Meta-Llama-3.3-70B-Instruct\" },\n  fireworks:  { baseUrl: \"https://api.fireworks.ai/inference/v1\",                  defaultModel: \"accounts/fireworks/models/llama-v3p3-70b-instruct\" },\n  mistral:    { baseUrl: \"https://api.mistral.ai/v1\",                              defaultModel: \"mistral-small-latest\" },\n  openrouter: { baseUrl: \"https://openrouter.ai/api/v1\",                           defaultModel: \"deepseek/deepseek-chat\" },\n  moonshot:   { baseUrl: \"https://api.moonshot.ai/v1\",                             defaultModel: \"moonshot-v1-32k\" }\n};\n\nexport function isRetryableError(err: unknown): boolean {\n  const msg = err instanceof Error ? err.message : String(err);\n  return /\\b(429|rate.?limit|quota|exceed|5\\d\\d|timeout|ECONNRESET|fetch failed)\\b/i.test(msg);\n}\n","import type { Knowledge } from \"./types.js\";\n\n/**\n * Build the system prompt by wrapping the user's markdown knowledge\n * with anti-hallucination rules and reply-style guidance.\n *\n * The markdown is injected verbatim — headings, lists, tables all preserved.\n * Works for any vertical because we don't enforce a schema.\n */\nexport function buildSystemPrompt(knowledge: Knowledge): string {\n  return [\n    \"You are an AI assistant on a business website. Use ONLY the knowledge below to answer.\",\n    \"\",\n    \"## Business knowledge\",\n    knowledge.trim(),\n    \"\",\n    \"## Reply rules\",\n    \"- Reply in 1-2 short sentences, conversational tone.\",\n    \"- NEVER invent prices, availability, dispatch times, appointment confirmations, or facts not present in the business knowledge above.\",\n    \"- For anything not covered in the knowledge above, say the owner will follow up — do NOT guess.\",\n    '- If the caller is clearly a vendor/sales pitch, say: \"This does not look like a customer service request, so we will not continue this thread.\"',\n    '- If wrong number or asked to stop, say: \"Sorry about that. We won\\'t text again.\"',\n    \"- Match the caller's language automatically.\"\n  ].join(\"\\n\");\n}\n","import type { GuardResult } from \"./types.js\";\n\n/**\n * Phrases that almost always indicate hallucination for SMB customer service:\n * inventing dispatch promises, fake confirmations, or appointment locks.\n */\nexport const FORBIDDEN_PHRASES: readonly string[] = [\n  \"help is coming\",\n  \"someone is on the way\",\n  \"technician is on the way\",\n  \"provider is on the way\",\n  \"dispatching someone\",\n  \"i've booked\",\n  \"i have booked\",\n  \"reservation confirmed\",\n  \"your appointment is confirmed\",\n  \"i've scheduled\",\n  \"i have scheduled\",\n  \"we've dispatched\",\n  \"we have dispatched\",\n  \"i can confirm\",\n  \"i guarantee\",\n  \"guaranteed delivery\",\n  \"guaranteed arrival\",\n  \"will arrive at\",\n  \"arriving at\",\n  \"i'll send\",\n  \"i will send\"\n];\n\n/**\n * Check a reply against the built-in forbidden phrase list.\n * Returns ok=true when clean, ok=false with violations when not.\n */\nexport function checkForbiddenPhrases(reply: string): GuardResult {\n  const lower = reply.toLowerCase();\n  const violations: string[] = [];\n  for (const phrase of FORBIDDEN_PHRASES) {\n    if (lower.includes(phrase)) {\n      violations.push(`Forbidden phrase: \"${phrase}\"`);\n    }\n  }\n  return { ok: violations.length === 0, violations };\n}\n\n/**\n * Remove forbidden sentences from a reply (best-effort sentence drop).\n * If too much is removed, returns a safe fallback.\n */\nexport function stripForbidden(reply: string): string {\n  const sentences = reply.split(/(?<=[.!?])\\s+/);\n  const kept = sentences.filter((s) => {\n    const lower = s.toLowerCase();\n    return !FORBIDDEN_PHRASES.some((p) => lower.includes(p));\n  });\n  const trimmed = kept.join(\" \").trim();\n  if (trimmed.length < 10) {\n    return \"Thanks for reaching out — let me check with the owner and get back to you.\";\n  }\n  return trimmed;\n}\n","import type { Knowledge, Message } from \"../core/types.js\";\nimport { buildSystemPrompt } from \"../core/prompts.js\";\nimport { checkForbiddenPhrases, stripForbidden } from \"../core/guards.js\";\nimport type { Provider, ProviderConfig, ClientOptions, ChainStep, ChainEntry, AttemptInfo } from \"./types.js\";\nimport { isKnownProvider } from \"./types.js\";\nimport { PROVIDER_ENDPOINTS, isRetryableError } from \"./providers.js\";\n\nexport interface ChatBotInit {\n  /** Markdown describing the business — services, hours, policies, anything. */\n  knowledge: Knowledge;\n  /** Provider keys + fallback chain. */\n  providers: ProviderConfig;\n  /** Optional runtime overrides. */\n  options?: ClientOptions;\n}\n\nexport interface ReplyOptions {\n  /** Conversation history (excluding the new user message). */\n  history?: Message[];\n  /** Override system prompt — advanced use only. */\n  systemPrompt?: string;\n}\n\nexport interface ReplyResult {\n  reply: string;\n  /** Provider/model that produced the final reply (after fallback). */\n  usedProvider: Provider;\n  usedModel: string;\n  /** Token usage if reported by the final provider. */\n  usage?: { prompt_tokens?: number; completion_tokens?: number };\n  /** Guard violations the bot caught and stripped, if any. */\n  guardWarnings: string[];\n  /** Debug trace of every attempt in the chain. */\n  attempts: AttemptInfo[];\n}\n\n/**\n * The main ChatBot entry. Holds knowledge + provider chain.\n *\n * @example\n * const bot = new ChatBot({\n *   knowledge: `# Acme Plumbing\\n## Services\\n- Sink leak: $95`,\n *   providers: {\n *     keys: { deepseek: \"sk-...\", openai: \"sk-...\" },\n *     chain: [\n *       { provider: \"deepseek\", model: \"deepseek-chat\" },\n *       { provider: \"openai\",   model: \"gpt-4o-mini\" }\n *     ]\n *   }\n * });\n * const { reply } = await bot.reply(\"My sink is leaking\");\n */\nexport class ChatBot {\n  private readonly steps: ChainStep[];\n  private readonly keys: Partial<Record<Provider, string>>;\n  private readonly fetcher: typeof globalThis.fetch;\n  private readonly timeoutMs: number;\n  private readonly cachedSystemPrompt: string;\n\n  constructor(init: ChatBotInit) {\n    if (!init.knowledge || typeof init.knowledge !== \"string\" || init.knowledge.trim().length === 0) {\n      throw new Error(\"chatbotlite: knowledge is required (a non-empty markdown string).\");\n    }\n    this.keys = init.providers.keys ?? {};\n    this.steps = resolveChain(init.providers);\n    this.fetcher = init.options?.fetch ?? globalThis.fetch.bind(globalThis);\n    this.timeoutMs = init.options?.timeoutMs ?? 30_000;\n    this.cachedSystemPrompt = buildSystemPrompt(init.knowledge);\n  }\n\n  async reply(message: string, opts: ReplyOptions = {}): Promise<ReplyResult> {\n    const systemPrompt = opts.systemPrompt ?? this.cachedSystemPrompt;\n    const messages: Message[] = [\n      { role: \"system\", content: systemPrompt },\n      ...(opts.history ?? []),\n      { role: \"user\", content: message }\n    ];\n    const attempts: AttemptInfo[] = [];\n    let lastError: unknown;\n    for (const step of this.steps) {\n      const t0 = Date.now();\n      try {\n        const result = await this.callProvider(step, messages);\n        attempts.push({ provider: step.provider, model: step.model, status: \"ok\", latencyMs: Date.now() - t0 });\n        const guard = checkForbiddenPhrases(result.reply);\n        const finalReply = guard.ok ? result.reply : stripForbidden(result.reply);\n        return {\n          reply: finalReply,\n          usedProvider: step.provider,\n          usedModel: step.model,\n          ...(result.usage ? { usage: result.usage } : {}),\n          guardWarnings: guard.violations,\n          attempts\n        };\n      } catch (err) {\n        lastError = err;\n        const errMsg = err instanceof Error ? err.message : String(err);\n        attempts.push({\n          provider: step.provider,\n          model: step.model,\n          status: \"error\",\n          error: errMsg,\n          latencyMs: Date.now() - t0\n        });\n        if (!isRetryableError(err)) {\n          throw new Error(`chatbotlite: ${step.label} failed (non-retryable). ${errMsg}`);\n        }\n      }\n    }\n    const summary = attempts.map((a) => `${a.provider}/${a.model}:${a.error ?? \"ok\"}`).join(\" → \");\n    throw new Error(`chatbotlite: all chain steps failed. Trace: ${summary}. Last error: ${lastError instanceof Error ? lastError.message : String(lastError)}`);\n  }\n\n  private async callProvider(step: ChainStep, messages: Message[]): Promise<{ reply: string; usage?: { prompt_tokens?: number; completion_tokens?: number } }> {\n    const endpoint = PROVIDER_ENDPOINTS[step.provider];\n    const key = this.keys[step.provider];\n    if (!key) throw new Error(`Missing API key for provider: ${step.provider}`);\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      const res = await this.fetcher(`${endpoint.baseUrl}/chat/completions`, {\n        method: \"POST\",\n        headers: {\n          \"Authorization\": `Bearer ${key}`,\n          \"Content-Type\": \"application/json\"\n        },\n        body: JSON.stringify({\n          model: step.model,\n          messages,\n          temperature: 0.3,\n          max_tokens: 300\n        }),\n        signal: controller.signal\n      });\n      if (!res.ok) {\n        const body = await res.text();\n        throw new Error(`${res.status}: ${body.slice(0, 200)}`);\n      }\n      const data = (await res.json()) as {\n        choices?: Array<{ message?: { content?: string; reasoning_content?: string } }>;\n        usage?: { prompt_tokens?: number; completion_tokens?: number };\n      };\n      const msg = data.choices?.[0]?.message;\n      const reply = (msg?.content?.trim() || msg?.reasoning_content?.trim()) ?? \"\";\n      if (!reply) throw new Error(\"empty reply from provider\");\n      const result: { reply: string; usage?: { prompt_tokens?: number; completion_tokens?: number } } = { reply };\n      if (data.usage) result.usage = data.usage;\n      return result;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction resolveChain(providers: ProviderConfig): ChainStep[] {\n  const keys = providers.keys ?? {};\n  const explicit = providers.chain;\n  if (explicit && explicit.length > 0) {\n    return explicit.map((entry) => normalizeChainEntry(entry, keys));\n  }\n  const orderedProviders = Object.keys(keys).filter((k) => isKnownProvider(k) && keys[k as Provider]) as Provider[];\n  if (orderedProviders.length === 0) {\n    throw new Error(\"chatbotlite: at least one provider key is required.\");\n  }\n  return orderedProviders.map((provider) => ({\n    provider,\n    model: PROVIDER_ENDPOINTS[provider].defaultModel,\n    label: `${provider}/${PROVIDER_ENDPOINTS[provider].defaultModel}`\n  }));\n}\n\nfunction normalizeChainEntry(entry: ChainEntry, keys: Partial<Record<Provider, string>>): ChainStep {\n  if (!isKnownProvider(entry.provider)) {\n    throw new Error(`chatbotlite: unknown provider \"${entry.provider}\" in chain entry.`);\n  }\n  const provider = entry.provider;\n  const model = entry.model ?? PROVIDER_ENDPOINTS[provider].defaultModel;\n  if (!keys[provider]) {\n    throw new Error(`chatbotlite: chain entry for \"${provider}\" needs a matching key in providers.keys.`);\n  }\n  return { provider, model, label: `${provider}/${model}` };\n}\n"]}

package/dist/client/index.d.cts

@@ -0,0 +1,72 @@
+import { P as Provider, c as ProviderConfig, b as ClientOptions, A as AttemptInfo } from '../types-J7BXpiRU.cjs';
+export { C as ChainEntry, a as ChainStep, i as isKnownProvider } from '../types-J7BXpiRU.cjs';
+import { K as Knowledge, M as Message } from '../types-4alyzg8O.cjs';
+
+interface ProviderEndpoint {
+    baseUrl: string;
+    defaultModel: string;
+}
+/**
+ * Built-in OpenAI-compatible providers. All use /v1/chat/completions
+ * with response in OpenAI format. Caller supplies API key per provider.
+ */
+declare const PROVIDER_ENDPOINTS: Record<Provider, ProviderEndpoint>;
+declare function isRetryableError(err: unknown): boolean;
+
+interface ChatBotInit {
+    /** Markdown describing the business — services, hours, policies, anything. */
+    knowledge: Knowledge;
+    /** Provider keys + fallback chain. */
+    providers: ProviderConfig;
+    /** Optional runtime overrides. */
+    options?: ClientOptions;
+}
+interface ReplyOptions {
+    /** Conversation history (excluding the new user message). */
+    history?: Message[];
+    /** Override system prompt — advanced use only. */
+    systemPrompt?: string;
+}
+interface ReplyResult {
+    reply: string;
+    /** Provider/model that produced the final reply (after fallback). */
+    usedProvider: Provider;
+    usedModel: string;
+    /** Token usage if reported by the final provider. */
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    };
+    /** Guard violations the bot caught and stripped, if any. */
+    guardWarnings: string[];
+    /** Debug trace of every attempt in the chain. */
+    attempts: AttemptInfo[];
+}
+/**
+ * The main ChatBot entry. Holds knowledge + provider chain.
+ *
+ * @example
+ * const bot = new ChatBot({
+ *   knowledge: `# Acme Plumbing\n## Services\n- Sink leak: $95`,
+ *   providers: {
+ *     keys: { deepseek: "sk-...", openai: "sk-..." },
+ *     chain: [
+ *       { provider: "deepseek", model: "deepseek-chat" },
+ *       { provider: "openai",   model: "gpt-4o-mini" }
+ *     ]
+ *   }
+ * });
+ * const { reply } = await bot.reply("My sink is leaking");
+ */
+declare class ChatBot {
+    private readonly steps;
+    private readonly keys;
+    private readonly fetcher;
+    private readonly timeoutMs;
+    private readonly cachedSystemPrompt;
+    constructor(init: ChatBotInit);
+    reply(message: string, opts?: ReplyOptions): Promise<ReplyResult>;
+    private callProvider;
+}
+
+export { AttemptInfo, ChatBot, type ChatBotInit, ClientOptions, PROVIDER_ENDPOINTS, Provider, ProviderConfig, type ProviderEndpoint, type ReplyOptions, type ReplyResult, isRetryableError };

package/dist/client/index.d.ts

@@ -0,0 +1,72 @@
+import { P as Provider, c as ProviderConfig, b as ClientOptions, A as AttemptInfo } from '../types-J7BXpiRU.js';
+export { C as ChainEntry, a as ChainStep, i as isKnownProvider } from '../types-J7BXpiRU.js';
+import { K as Knowledge, M as Message } from '../types-4alyzg8O.js';
+
+interface ProviderEndpoint {
+    baseUrl: string;
+    defaultModel: string;
+}
+/**
+ * Built-in OpenAI-compatible providers. All use /v1/chat/completions
+ * with response in OpenAI format. Caller supplies API key per provider.
+ */
+declare const PROVIDER_ENDPOINTS: Record<Provider, ProviderEndpoint>;
+declare function isRetryableError(err: unknown): boolean;
+
+interface ChatBotInit {
+    /** Markdown describing the business — services, hours, policies, anything. */
+    knowledge: Knowledge;
+    /** Provider keys + fallback chain. */
+    providers: ProviderConfig;
+    /** Optional runtime overrides. */
+    options?: ClientOptions;
+}
+interface ReplyOptions {
+    /** Conversation history (excluding the new user message). */
+    history?: Message[];
+    /** Override system prompt — advanced use only. */
+    systemPrompt?: string;
+}
+interface ReplyResult {
+    reply: string;
+    /** Provider/model that produced the final reply (after fallback). */
+    usedProvider: Provider;
+    usedModel: string;
+    /** Token usage if reported by the final provider. */
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+    };
+    /** Guard violations the bot caught and stripped, if any. */
+    guardWarnings: string[];
+    /** Debug trace of every attempt in the chain. */
+    attempts: AttemptInfo[];
+}
+/**
+ * The main ChatBot entry. Holds knowledge + provider chain.
+ *
+ * @example
+ * const bot = new ChatBot({
+ *   knowledge: `# Acme Plumbing\n## Services\n- Sink leak: $95`,
+ *   providers: {
+ *     keys: { deepseek: "sk-...", openai: "sk-..." },
+ *     chain: [
+ *       { provider: "deepseek", model: "deepseek-chat" },
+ *       { provider: "openai",   model: "gpt-4o-mini" }
+ *     ]
+ *   }
+ * });
+ * const { reply } = await bot.reply("My sink is leaking");
+ */
+declare class ChatBot {
+    private readonly steps;
+    private readonly keys;
+    private readonly fetcher;
+    private readonly timeoutMs;
+    private readonly cachedSystemPrompt;
+    constructor(init: ChatBotInit);
+    reply(message: string, opts?: ReplyOptions): Promise<ReplyResult>;
+    private callProvider;
+}
+
+export { AttemptInfo, ChatBot, type ChatBotInit, ClientOptions, PROVIDER_ENDPOINTS, Provider, ProviderConfig, type ProviderEndpoint, type ReplyOptions, type ReplyResult, isRetryableError };

package/dist/client/index.js

@@ -0,0 +1,229 @@
+// src/client/types.ts
+var PROVIDER_NAMES = /* @__PURE__ */ new Set([
+  "openai",
+  "deepseek",
+  "groq",
+  "gemini",
+  "anthropic",
+  "cerebras",
+  "sambanova",
+  "fireworks",
+  "mistral",
+  "openrouter",
+  "moonshot"
+]);
+function isKnownProvider(name) {
+  return PROVIDER_NAMES.has(name);
+}
+
+// src/client/providers.ts
+var PROVIDER_ENDPOINTS = {
+  openai: { baseUrl: "https://api.openai.com/v1", defaultModel: "gpt-4o-mini" },
+  deepseek: { baseUrl: "https://api.deepseek.com/v1", defaultModel: "deepseek-chat" },
+  groq: { baseUrl: "https://api.groq.com/openai/v1", defaultModel: "llama-3.3-70b-versatile" },
+  gemini: { baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai", defaultModel: "gemini-2.5-flash" },
+  anthropic: { baseUrl: "https://api.anthropic.com/v1", defaultModel: "claude-haiku-4-5" },
+  cerebras: { baseUrl: "https://api.cerebras.ai/v1", defaultModel: "qwen-3-235b-a22b-instruct-2507" },
+  sambanova: { baseUrl: "https://api.sambanova.ai/v1", defaultModel: "Meta-Llama-3.3-70B-Instruct" },
+  fireworks: { baseUrl: "https://api.fireworks.ai/inference/v1", defaultModel: "accounts/fireworks/models/llama-v3p3-70b-instruct" },
+  mistral: { baseUrl: "https://api.mistral.ai/v1", defaultModel: "mistral-small-latest" },
+  openrouter: { baseUrl: "https://openrouter.ai/api/v1", defaultModel: "deepseek/deepseek-chat" },
+  moonshot: { baseUrl: "https://api.moonshot.ai/v1", defaultModel: "moonshot-v1-32k" }
+};
+function isRetryableError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /\b(429|rate.?limit|quota|exceed|5\d\d|timeout|ECONNRESET|fetch failed)\b/i.test(msg);
+}
+
+// src/core/prompts.ts
+function buildSystemPrompt(knowledge) {
+  return [
+    "You are an AI assistant on a business website. Use ONLY the knowledge below to answer.",
+    "",
+    "## Business knowledge",
+    knowledge.trim(),
+    "",
+    "## Reply rules",
+    "- Reply in 1-2 short sentences, conversational tone.",
+    "- NEVER invent prices, availability, dispatch times, appointment confirmations, or facts not present in the business knowledge above.",
+    "- For anything not covered in the knowledge above, say the owner will follow up \u2014 do NOT guess.",
+    '- If the caller is clearly a vendor/sales pitch, say: "This does not look like a customer service request, so we will not continue this thread."',
+    `- If wrong number or asked to stop, say: "Sorry about that. We won't text again."`,
+    "- Match the caller's language automatically."
+  ].join("\n");
+}
+
+// src/core/guards.ts
+var FORBIDDEN_PHRASES = [
+  "help is coming",
+  "someone is on the way",
+  "technician is on the way",
+  "provider is on the way",
+  "dispatching someone",
+  "i've booked",
+  "i have booked",
+  "reservation confirmed",
+  "your appointment is confirmed",
+  "i've scheduled",
+  "i have scheduled",
+  "we've dispatched",
+  "we have dispatched",
+  "i can confirm",
+  "i guarantee",
+  "guaranteed delivery",
+  "guaranteed arrival",
+  "will arrive at",
+  "arriving at",
+  "i'll send",
+  "i will send"
+];
+function checkForbiddenPhrases(reply) {
+  const lower = reply.toLowerCase();
+  const violations = [];
+  for (const phrase of FORBIDDEN_PHRASES) {
+    if (lower.includes(phrase)) {
+      violations.push(`Forbidden phrase: "${phrase}"`);
+    }
+  }
+  return { ok: violations.length === 0, violations };
+}
+function stripForbidden(reply) {
+  const sentences = reply.split(/(?<=[.!?])\s+/);
+  const kept = sentences.filter((s) => {
+    const lower = s.toLowerCase();
+    return !FORBIDDEN_PHRASES.some((p) => lower.includes(p));
+  });
+  const trimmed = kept.join(" ").trim();
+  if (trimmed.length < 10) {
+    return "Thanks for reaching out \u2014 let me check with the owner and get back to you.";
+  }
+  return trimmed;
+}
+
+// src/client/chatbot.ts
+var ChatBot = class {
+  steps;
+  keys;
+  fetcher;
+  timeoutMs;
+  cachedSystemPrompt;
+  constructor(init) {
+    if (!init.knowledge || typeof init.knowledge !== "string" || init.knowledge.trim().length === 0) {
+      throw new Error("chatbotlite: knowledge is required (a non-empty markdown string).");
+    }
+    this.keys = init.providers.keys ?? {};
+    this.steps = resolveChain(init.providers);
+    this.fetcher = init.options?.fetch ?? globalThis.fetch.bind(globalThis);
+    this.timeoutMs = init.options?.timeoutMs ?? 3e4;
+    this.cachedSystemPrompt = buildSystemPrompt(init.knowledge);
+  }
+  async reply(message, opts = {}) {
+    const systemPrompt = opts.systemPrompt ?? this.cachedSystemPrompt;
+    const messages = [
+      { role: "system", content: systemPrompt },
+      ...opts.history ?? [],
+      { role: "user", content: message }
+    ];
+    const attempts = [];
+    let lastError;
+    for (const step of this.steps) {
+      const t0 = Date.now();
+      try {
+        const result = await this.callProvider(step, messages);
+        attempts.push({ provider: step.provider, model: step.model, status: "ok", latencyMs: Date.now() - t0 });
+        const guard = checkForbiddenPhrases(result.reply);
+        const finalReply = guard.ok ? result.reply : stripForbidden(result.reply);
+        return {
+          reply: finalReply,
+          usedProvider: step.provider,
+          usedModel: step.model,
+          ...result.usage ? { usage: result.usage } : {},
+          guardWarnings: guard.violations,
+          attempts
+        };
+      } catch (err) {
+        lastError = err;
+        const errMsg = err instanceof Error ? err.message : String(err);
+        attempts.push({
+          provider: step.provider,
+          model: step.model,
+          status: "error",
+          error: errMsg,
+          latencyMs: Date.now() - t0
+        });
+        if (!isRetryableError(err)) {
+          throw new Error(`chatbotlite: ${step.label} failed (non-retryable). ${errMsg}`);
+        }
+      }
+    }
+    const summary = attempts.map((a) => `${a.provider}/${a.model}:${a.error ?? "ok"}`).join(" \u2192 ");
+    throw new Error(`chatbotlite: all chain steps failed. Trace: ${summary}. Last error: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+  }
+  async callProvider(step, messages) {
+    const endpoint = PROVIDER_ENDPOINTS[step.provider];
+    const key = this.keys[step.provider];
+    if (!key) throw new Error(`Missing API key for provider: ${step.provider}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await this.fetcher(`${endpoint.baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${key}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          model: step.model,
+          messages,
+          temperature: 0.3,
+          max_tokens: 300
+        }),
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`${res.status}: ${body.slice(0, 200)}`);
+      }
+      const data = await res.json();
+      const msg = data.choices?.[0]?.message;
+      const reply = (msg?.content?.trim() || msg?.reasoning_content?.trim()) ?? "";
+      if (!reply) throw new Error("empty reply from provider");
+      const result = { reply };
+      if (data.usage) result.usage = data.usage;
+      return result;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+function resolveChain(providers) {
+  const keys = providers.keys ?? {};
+  const explicit = providers.chain;
+  if (explicit && explicit.length > 0) {
+    return explicit.map((entry) => normalizeChainEntry(entry, keys));
+  }
+  const orderedProviders = Object.keys(keys).filter((k) => isKnownProvider(k) && keys[k]);
+  if (orderedProviders.length === 0) {
+    throw new Error("chatbotlite: at least one provider key is required.");
+  }
+  return orderedProviders.map((provider) => ({
+    provider,
+    model: PROVIDER_ENDPOINTS[provider].defaultModel,
+    label: `${provider}/${PROVIDER_ENDPOINTS[provider].defaultModel}`
+  }));
+}
+function normalizeChainEntry(entry, keys) {
+  if (!isKnownProvider(entry.provider)) {
+    throw new Error(`chatbotlite: unknown provider "${entry.provider}" in chain entry.`);
+  }
+  const provider = entry.provider;
+  const model = entry.model ?? PROVIDER_ENDPOINTS[provider].defaultModel;
+  if (!keys[provider]) {
+    throw new Error(`chatbotlite: chain entry for "${provider}" needs a matching key in providers.keys.`);
+  }
+  return { provider, model, label: `${provider}/${model}` };
+}
+
+export { ChatBot, PROVIDER_ENDPOINTS, isKnownProvider, isRetryableError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map