levix-bot 2.2.0 → 2.3.0

package/src/config/settings.cjs

@@ -48,13 +48,40 @@ const SETTINGS = [
   },
 
   // --- AI ----------------------------------------------------------------
+  //
+  // One provider answers chats, chosen here and configured right below: the
+  // dashboard renders every one of these fields (the provider as a dropdown,
+  // keys as password fields), so a provider switch is a settings change, not a
+  // code change or an env file.
+  {
+    key: "ai_provider",
+    type: "string",
+    default: "gemini",
+    choices: ["gemini", "openai", "anthropic"],
+    choiceLabels: {
+      gemini: "Google Gemini",
+      openai: "OpenAI / compatible",
+      anthropic: "Anthropic Claude",
+    },
+    group: "ai",
+    label: "AI provider",
+    hint: "Which API answers chats. gemini = Google Gemini (the only one that reads media and has built-in Google Search). openai = any OpenAI-compatible chat-completions server. anthropic = Claude.",
+  },
   {
     key: "gemini_api_key",
     type: "secret",
     default: "",
     group: "ai",
     label: "Gemini API key",
-    hint: "Free key from aistudio.google.com/apikey — without it the AI commands stay off.",
+    hint: "Free key from aistudio.google.com/apikey. Needed when the provider is gemini, and by !stt / !generate in every case.",
+  },
+  {
+    key: "gemini_base_url",
+    type: "string",
+    default: "https://generativelanguage.googleapis.com",
+    group: "ai",
+    label: "Google Gemini base URL",
+    hint: "Google Generative Language API root. Change it for a proxy or compatible gateway; do not append /v1beta. Applies live to chat, media uploads, !stt and !generate.",
   },
   {
     key: "gemini_model",
@@ -131,22 +158,54 @@ const SETTINGS = [
     default: true,
     group: "ai",
     label: "Gemini Google Search",
-    hint: "Lets Gemini use Google's own search grounding when a question needs current information. Gemini only — the Groq fallback is unaffected.",
+    hint: "Lets Gemini use Google's own search grounding when a question needs current information. Gemini only — the openai and anthropic providers never see it.",
+  },
+  {
+    key: "openai_api_key",
+    type: "secret",
+    default: "",
+    group: "ai",
+    label: "OpenAI-compatible API key",
+    hint: "Used when the provider is openai. Works with OpenAI itself or any server that speaks the same format: OpenRouter, Together, LM Studio, ...",
   },
   {
-    key: "groq_api_key",
+    key: "openai_base_url",
+    type: "string",
+    default: "https://api.openai.com/v1",
+    group: "ai",
+    label: "OpenAI-compatible base URL",
+    hint: "The /v1 root of a chat-completions server. Examples: https://openrouter.ai/api/v1, https://api.together.xyz/v1, http://127.0.0.1:11434/v1 (Ollama).",
+  },
+  {
+    key: "openai_model",
+    type: "string",
+    default: "gpt-4o-mini",
+    group: "ai",
+    label: "OpenAI-compatible model",
+    hint: "Must exist on the server the base URL points at (e.g. gpt-4o-mini on OpenAI, a llama model on a self-hosted server).",
+  },
+  {
+    key: "anthropic_api_key",
     type: "secret",
     default: "",
     group: "ai",
-    label: "Groq API key (fallback)",
-    hint: "Used only when Gemini is out of quota.",
+    label: "Anthropic API key",
+    hint: "Used when the provider is anthropic. Create one at console.anthropic.com.",
+  },
+  {
+    key: "anthropic_base_url",
+    type: "string",
+    default: "https://api.anthropic.com",
+    group: "ai",
+    label: "Anthropic base URL",
+    hint: "The host root — /v1/messages is appended. Change it only for a proxy or a compatible gateway.",
   },
   {
-    key: "groq_model",
+    key: "anthropic_model",
     type: "string",
-    default: "llama-3.3-70b-versatile",
+    default: "claude-sonnet-4-5",
     group: "ai",
-    label: "Groq model",
+    label: "Anthropic model",
   },
   {
     key: "google_search_api_key",
@@ -466,6 +525,7 @@ function describe() {
       min: definition.min ?? null,
       max: definition.max ?? null,
       choices: definition.choices ?? null,
+      choiceLabels: definition.choiceLabels ?? null,
       restart: definition.restart === true,
       source: sourceOf(definition.key),
     };

package/src/core/proxy.js

@@ -25,9 +25,9 @@
 // WHAT IS NOT PROXIED
 // -------------------
 // Nothing global is patched. The agents are handed to one `makeWASocket()`
-// call by the session manager, so the dashboard's own HTTP server, Gemini,
-// Groq and every other outbound request keep using the direct connection they
-// use today.
+// call by the session manager, so the dashboard's own HTTP server, the AI
+// providers and every other outbound request keep using the direct connection
+// they use today.
 //
 // SECRETS
 // -------

package/src/panel/session-store.cjs

@@ -0,0 +1,100 @@
+const session = require("express-session");
+
+function clone(value) {
+  return value == null ? value : JSON.parse(JSON.stringify(value));
+}
+
+class PanelSessionStore extends session.Store {
+  constructor({ ttlMs = 12 * 60 * 60 * 1000, maxSessions = 128 } = {}) {
+    super();
+    this.ttlMs = ttlMs;
+    this.maxSessions = maxSessions;
+    this.sessions = new Map();
+  }
+
+  _expiresAt(sess) {
+    const expires = Date.parse(sess?.cookie?.expires || "");
+    if (Number.isFinite(expires)) return expires;
+
+    const maxAge = Number(sess?.cookie?.maxAge);
+    if (Number.isFinite(maxAge) && maxAge > 0) return Date.now() + maxAge;
+
+    return Date.now() + this.ttlMs;
+  }
+
+  _prune() {
+    const now = Date.now();
+    for (const [sid, entry] of this.sessions) {
+      if (entry.expiresAt <= now) this.sessions.delete(sid);
+    }
+  }
+
+  _makeRoom(sid) {
+    if (this.sessions.has(sid) || this.sessions.size < this.maxSessions) return;
+
+    let oldestSid = null;
+    let oldestExpiry = Infinity;
+    for (const [candidateSid, entry] of this.sessions) {
+      if (entry.expiresAt < oldestExpiry) {
+        oldestSid = candidateSid;
+        oldestExpiry = entry.expiresAt;
+      }
+    }
+    if (oldestSid) this.sessions.delete(oldestSid);
+  }
+
+  get(sid, callback) {
+    try {
+      this._prune();
+      const entry = this.sessions.get(sid);
+      callback(null, entry ? clone(entry.session) : null);
+    } catch (error) {
+      callback(error);
+    }
+  }
+
+  set(sid, sess, callback = () => {}) {
+    try {
+      this._prune();
+      this._makeRoom(sid);
+      this.sessions.set(sid, {
+        session: clone(sess),
+        expiresAt: this._expiresAt(sess),
+      });
+      callback(null);
+    } catch (error) {
+      callback(error);
+    }
+  }
+
+  touch(sid, sess, callback = () => {}) {
+    try {
+      this._prune();
+      const entry = this.sessions.get(sid);
+      if (entry) {
+        entry.expiresAt = this._expiresAt(sess);
+        if (sess?.cookie) entry.session.cookie = clone(sess.cookie);
+      }
+      callback(null);
+    } catch (error) {
+      callback(error);
+    }
+  }
+
+  destroy(sid, callback = () => {}) {
+    this.sessions.delete(sid);
+    callback(null);
+  }
+
+  clear(callback = () => {}) {
+    this.sessions.clear();
+    callback(null);
+  }
+
+  length(callback) {
+    this._prune();
+    callback(null, this.sessions.size);
+  }
+}
+
+module.exports = { PanelSessionStore };

package/src/routes/dashboard.api.esm.js

@@ -48,7 +48,10 @@ const settings = require("../config/settings.cjs");
 const memory = require("../utils/memory.cjs");
 const secrets = require("../config/secrets.cjs");
 const { DATA_DIR } = require("../config/paths.cjs");
-const { PERSONA_FILE } = require("../services/aiAgent.cjs");
+const {
+  PERSONA_FILE,
+  activeProviderKeySetting,
+} = require("../services/aiAgent.cjs");
 const { deleteScheduledJob, retryScheduledJob } = require("../../scheduler.cjs");
 const { describeScheduledJob } = require("../utils/recurrence.cjs");
 
@@ -140,7 +143,9 @@ router.get("/stats", (req, res) => {
 
         prefix: runtimeConfig.getPrefix(),
         commandCount: getCommandCatalog().length,
-        aiConfigured: !!settings.get("gemini_api_key"),
+        // The active provider's key — "AI key: Not set" must mean what the
+        // bot will actually use, not whatever gemini_api_key happens to hold.
+        aiConfigured: !!settings.get(activeProviderKeySetting()),
 
         uptime: process.uptime(),
         memory: process.memoryUsage(),

package/src/services/aiAgent.cjs

@@ -22,6 +22,10 @@ const aiIdentity = require("../config/ai-identity.cjs");
 const settings = require("../config/settings.cjs");
 const memory = require("../utils/memory.cjs");
 const { toolDeclarations, describeCall, runTool } = require("./aiTools.cjs");
+const {
+  runProviderAgent,
+  activeProviderKeySetting,
+} = require("./aiProviders.cjs");
 
 // Model, key, tool budget and history length all come from config/settings.cjs
 // (what the dashboard saved, else the default) and are read per call, so changing
@@ -36,13 +40,18 @@ const { toolDeclarations, describeCall, runTool } = require("./aiTools.cjs");
 // client whose model and per-request configuration are passed at call time —
 // which suits Levix, because the model and the tool set are settings that may
 // change between one message and the next.
-let clientCache = { key: null, client: null };
+let clientCache = { key: null, baseUrl: null, client: null };
 
 function geminiClient() {
   const key = settings.get("gemini_api_key");
   if (!key) return null;
-  if (clientCache.key !== key) {
-    clientCache = { key, client: new GoogleGenAI({ apiKey: key }) };
+  const baseUrl = String(settings.get("gemini_base_url")).replace(/\/+$/, "");
+  if (clientCache.key !== key || clientCache.baseUrl !== baseUrl) {
+    clientCache = {
+      key,
+      baseUrl,
+      client: new GoogleGenAI({ apiKey: key, httpOptions: { baseUrl } }),
+    };
   }
   return clientCache.client;
 }
@@ -225,7 +234,9 @@ function withTimeout(promise, ms, label) {
 }
 
 function isAgentEnabled() {
-  return Boolean(geminiClient()) && settings.get("ai_agent");
+  // The key that matters is the active provider's: a panel switch from gemini
+  // to openai must not keep the agent gated on (or running on) a Gemini key.
+  return Boolean(settings.get(activeProviderKeySetting())) && settings.get("ai_agent");
 }
 
 // ===========================================================================
@@ -247,7 +258,7 @@ function isAgentEnabled() {
 
 const GOOGLE_SEARCH_TOOL = Object.freeze({ googleSearch: {} });
 
-/** Gemini-only. Nothing here is offered to Groq or any other provider. */
+/** Gemini-only. The openai and anthropic providers are never offered it. */
 function googleSearchEnabled() {
   return settings.get("ai_google_search") === true;
 }
@@ -368,6 +379,10 @@ function formatSources(sources) {
 /**
  * Run one agent turn.
  *
+ * Dispatches on the `ai_provider` setting: gemini runs the native loop below
+ * (built-in Google Search, Files uploads); openai and anthropic run the same
+ * loop over their own wire formats in aiProviders.cjs.
+ *
  * @param {object}   options
  * @param {Array}    options.parts    - the Gemini parts for this message
  * @param {Array}    [options.history]- prior conversation
@@ -384,6 +399,20 @@ async function runAgent({
   useTools = true,
   maxSteps = null,
 } = {}) {
+  const provider = settings.get("ai_provider");
+  if (provider !== "gemini") {
+    const result = await runProviderAgent(provider, {
+      parts,
+      history: trimHistory(history),
+      systemInstruction: buildSystemInstruction(context),
+      status,
+      context,
+      useTools,
+      maxSteps,
+    });
+    return { ...result, history: trimHistory(result.history) };
+  }
+
   const genAI = geminiClient();
   if (!genAI) throw new Error("GEMINI_API_KEY غير معرف");
 
@@ -540,6 +569,7 @@ module.exports = {
   buildSystemInstruction,
   loadPersona,
   isAgentEnabled,
+  activeProviderKeySetting,
   isFileReferenceError,
   sanitizeHistoryForFiles,
   trimHistory,