chat-agent-toolkit 1.2.32 → 1.2.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-agent-toolkit",
-  "version": "1.2.32",
+  "version": "1.2.34",
   "description": "Multi-provider AI agent toolkit: generate language responses, search the web, extract content, and manage memory across 10+ LLM providers.",
   "author": "vtempest <grokthiscontact@gmail.com>",
   "license": "AGPL-3.0",

package/src/config/config-manager.ts

@@ -1,295 +1,295 @@
-/**
- * @fileoverview Configuration Manager
- *
- * Manages model providers, MCP servers, and search configuration in memory.
- * Handles environment variable loading, provider hashing, and config updates.
- */
-import type { ConfigModelProvider, MCPServerConfig, Config, UIConfigSections, Model } from "./config-types";
-import { getModelProvidersUIConfigSection } from "./provider-ui-config";
-import { getEnv } from "./environment-variables";
-import { LANGUAGE_MODELS } from "./language-models-database";
-
-// Maps a provider UI key (from provider-ui-config) to the matching
-// `provider` name in the LANGUAGE_MODELS database. Names differ in a few
-// cases (e.g. the "gemini" UI key corresponds to the "Google" model list).
-const PROVIDER_KEY_TO_DB_NAME: Record<string, string> = {
-  openai: "openai",
-  anthropic: "anthropic",
-  gemini: "google",
-  groq: "groq",
-  deepseek: "deepseek",
-  nvidia: "nvidia",
-  openrouter: "openrouter",
-};
-
-/**
- * Returns the default chat models for a provider from the LANGUAGE_MODELS
- * database so that env-based providers expose a usable model list instead of
- * an empty one. Returns [] when no matching provider list exists.
- */
-const getDefaultChatModels = (providerKey: string): Model[] => {
-  const dbName = PROVIDER_KEY_TO_DB_NAME[providerKey] ?? providerKey;
-  const entry = LANGUAGE_MODELS.find(
-    (p) => p.provider.toLowerCase() === dbName.toLowerCase(),
-  );
-  if (!entry?.models) return [];
-
-  return entry.models.map((m: any) => ({
-    name: m.name,
-    key: m.id,
-  }));
-};
-
-const hashObj = (obj: { [key: string]: any }) => {
-  const str = JSON.stringify(obj, Object.keys(obj).sort());
-  let hash = 0;
-  for (let i = 0; i < str.length; i++) {
-    hash = (hash << 5) - hash + str.charCodeAt(i);
-    hash |= 0;
-  }
-  return String(Math.abs(hash).toString(36));
-};
-
-class ConfigManager {
-  configVersion = 1;
-  currentConfig: Config = {
-    version: this.configVersion,
-    setupComplete: getEnv("SETUP_COMPLETE") === "true" || false,
-    preferences: {},
-    personalization: {},
-    modelProviders: [],
-    mcpServers: [],
-    search: {
-      searxngURL: "",
-      tavilyApiKey: "",
-      sourceScrapeCount: 3,
-      sourceScrapeTimeout: 5,
-    },
-  };
-  uiConfigSections: UIConfigSections = {
-    preferences: [],
-    personalization: [],
-    modelProviders: [],
-    mcpServers: [],
-    search: [
-      {
-        name: "SearXNG URL",
-        key: "searxngURL",
-        type: "string",
-        required: false,
-        description: "The URL of your SearXNG instance",
-        placeholder: "http://localhost:4000",
-        default: "",
-        scope: "server",
-        env: "SEARXNG_API_URL",
-      },
-      {
-        name: "Tavily API Key",
-        key: "tavilyApiKey",
-        type: "string",
-        required: false,
-        description: "Your Tavily API key for enhanced search capabilities.",
-        placeholder: "tvly-...",
-        default: "",
-        scope: "server",
-        env: "TAVILY_API_KEY",
-      },
-      {
-        name: "Scrape timeout (seconds)",
-        key: "sourceScrapeTimeout",
-        type: "select",
-        options: [
-          { name: "3 seconds", value: "3" },
-          { name: "5 seconds (default)", value: "5" },
-          { name: "10 seconds", value: "10" },
-          { name: "15 seconds", value: "15" },
-          { name: "20 seconds", value: "20" },
-        ],
-        required: false,
-        description: "Maximum time to wait when scraping each source URL.",
-        default: "5",
-        scope: "server",
-      },
-    ],
-  };
-
-  private initialized = false;
-
-  constructor() {
-    // Don't initialize in constructor to avoid circular dependency
-    // Initialize lazily when config is first accessed
-  }
-
-  private ensureInitialized() {
-    if (this.initialized) return;
-    this.initialize();
-    this.initialized = true;
-  }
-
-  private initialize() {
-    const providerConfigSections = getModelProvidersUIConfigSection();
-    this.uiConfigSections.modelProviders = providerConfigSections;
-
-    const newProviders: ConfigModelProvider[] = [];
-
-    providerConfigSections.forEach((provider) => {
-
-      const tempConfig: Record<string, any> = {};
-      const required: string[] = [];
-
-      provider.fields.forEach((field) => {
-        tempConfig[field.key] =
-          getEnv(field.env!) || field.default || "";
-        if (field.required) required.push(field.key);
-      });
-
-      let configured = true;
-      required.forEach((r) => {
-        if (!tempConfig[r]) configured = false;
-      });
-
-      if (configured) {
-        const hash = hashObj(tempConfig);
-        const exists = this.currentConfig.modelProviders.find(
-          (p) => p.hash === hash,
-        );
-
-        if (!exists) {
-          newProviders.push({
-            id: hash,
-            name: `${provider.name}`,
-            type: provider.key,
-            chatModels: getDefaultChatModels(provider.key),
-            config: tempConfig,
-            hash: hash,
-            isEnvBased: true,
-          });
-        }
-      }
-    });
-
-    if (newProviders.length > 0) {
-      this.currentConfig.modelProviders.push(...newProviders);
-    }
-
-    // Search config from env
-    this.uiConfigSections.search.forEach((f) => {
-      if (f.env && !this.currentConfig.search[f.key]) {
-        this.currentConfig.search[f.key] =
-          getEnv(f.env) ?? f.default ?? "";
-      }
-    });
-  }
-
-  public getConfig(key: string, defaultValue?: any): any {
-    this.ensureInitialized();
-    const nested = key.split(".");
-    let obj: any = this.currentConfig;
-
-    for (let i = 0; i < nested.length; i++) {
-      const part = nested[i];
-      if (obj == null) return defaultValue;
-      obj = obj[part];
-    }
-
-    return obj === undefined ? defaultValue : obj;
-  }
-
-  public updateConfig(key: string, val: any) {
-    const parts = key.split(".");
-    if (parts.length === 0) return;
-
-    let target: any = this.currentConfig;
-    for (let i = 0; i < parts.length - 1; i++) {
-      const part = parts[i];
-      if (target[part] === null || typeof target[part] !== "object") {
-        target[part] = {};
-      }
-      target = target[part];
-    }
-
-    const finalKey = parts[parts.length - 1];
-    target[finalKey] = val;
-  }
-
-  public addModelProvider(type: string, name: string, config: any) {
-    this.ensureInitialized();
-    const hash = hashObj(config);
-
-    const newModelProvider: ConfigModelProvider = {
-      id: hash,
-      name,
-      type,
-      config,
-      chatModels: [],
-      hash: hash,
-    };
-
-    this.currentConfig.modelProviders.push(newModelProvider);
-    return newModelProvider;
-  }
-
-  public removeModelProvider(id: string) {
-    this.currentConfig.modelProviders =
-      this.currentConfig.modelProviders.filter((p) => p.id !== id);
-  }
-
-  public async updateModelProvider(id: string, name: string, config: any) {
-    const provider = this.currentConfig.modelProviders.find(
-      (p) => p.id === id,
-    );
-    if (!provider) throw new Error("Provider not found");
-
-    provider.name = name;
-    provider.config = config;
-    return provider;
-  }
-
-  public addProviderModel(providerId: string, type: "chat", model: any) {
-    const provider = this.currentConfig.modelProviders.find(
-      (p) => p.id === providerId,
-    );
-    if (!provider) throw new Error("Invalid provider id");
-
-    delete model.type;
-    provider.chatModels.push(model);
-    return model;
-  }
-
-  public removeProviderModel(
-    providerId: string,
-    type: "chat",
-    modelKey: string,
-  ) {
-    const provider = this.currentConfig.modelProviders.find(
-      (p) => p.id === providerId,
-    );
-    if (!provider) throw new Error("Invalid provider id");
-
-    provider.chatModels = provider.chatModels.filter((m) => m.key !== modelKey);
-  }
-
-  public isSetupComplete() {
-    return this.currentConfig.setupComplete;
-  }
-
-  public markSetupComplete() {
-    if (!this.currentConfig.setupComplete) {
-      this.currentConfig.setupComplete = true;
-    }
-  }
-
-  public getUIConfigSections(): UIConfigSections {
-    this.ensureInitialized();
-    return this.uiConfigSections;
-  }
-
-  public getCurrentConfig(): Config {
-    this.ensureInitialized();
-    return JSON.parse(JSON.stringify(this.currentConfig));
-  }
-}
-
-const configManager = new ConfigManager();
-
-export default configManager;
+/**
+ * @fileoverview Configuration Manager
+ *
+ * Manages model providers, MCP servers, and search configuration in memory.
+ * Handles environment variable loading, provider hashing, and config updates.
+ */
+import type { ConfigModelProvider, MCPServerConfig, Config, UIConfigSections, Model } from "./config-types";
+import { getModelProvidersUIConfigSection } from "./provider-ui-config";
+import { getEnv } from "./environment-variables";
+import { LANGUAGE_MODELS } from "./language-models-database";
+
+// Maps a provider UI key (from provider-ui-config) to the matching
+// `provider` name in the LANGUAGE_MODELS database. Names differ in a few
+// cases (e.g. the "gemini" UI key corresponds to the "Google" model list).
+const PROVIDER_KEY_TO_DB_NAME: Record<string, string> = {
+  openai: "openai",
+  anthropic: "anthropic",
+  gemini: "google",
+  groq: "groq",
+  deepseek: "deepseek",
+  nvidia: "nvidia",
+  openrouter: "openrouter",
+};
+
+/**
+ * Returns the default chat models for a provider from the LANGUAGE_MODELS
+ * database so that env-based providers expose a usable model list instead of
+ * an empty one. Returns [] when no matching provider list exists.
+ */
+const getDefaultChatModels = (providerKey: string): Model[] => {
+  const dbName = PROVIDER_KEY_TO_DB_NAME[providerKey] ?? providerKey;
+  const entry = LANGUAGE_MODELS.find(
+    (p) => p.provider.toLowerCase() === dbName.toLowerCase(),
+  );
+  if (!entry?.models) return [];
+
+  return entry.models.map((m: any) => ({
+    name: m.name,
+    key: m.id,
+  }));
+};
+
+const hashObj = (obj: { [key: string]: any }) => {
+  const str = JSON.stringify(obj, Object.keys(obj).sort());
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) - hash + str.charCodeAt(i);
+    hash |= 0;
+  }
+  return String(Math.abs(hash).toString(36));
+};
+
+class ConfigManager {
+  configVersion = 1;
+  currentConfig: Config = {
+    version: this.configVersion,
+    setupComplete: getEnv("SETUP_COMPLETE") === "true" || false,
+    preferences: {},
+    personalization: {},
+    modelProviders: [],
+    mcpServers: [],
+    search: {
+      searxngURL: "",
+      tavilyApiKey: "",
+      sourceScrapeCount: 3,
+      sourceScrapeTimeout: 5,
+    },
+  };
+  uiConfigSections: UIConfigSections = {
+    preferences: [],
+    personalization: [],
+    modelProviders: [],
+    mcpServers: [],
+    search: [
+      {
+        name: "SearXNG URL",
+        key: "searxngURL",
+        type: "string",
+        required: false,
+        description: "The URL of your SearXNG instance",
+        placeholder: "http://localhost:4000",
+        default: "",
+        scope: "server",
+        env: "SEARXNG_API_URL",
+      },
+      {
+        name: "Tavily API Key",
+        key: "tavilyApiKey",
+        type: "string",
+        required: false,
+        description: "Your Tavily API key for enhanced search capabilities.",
+        placeholder: "tvly-...",
+        default: "",
+        scope: "server",
+        env: "TAVILY_API_KEY",
+      },
+      {
+        name: "Scrape timeout (seconds)",
+        key: "sourceScrapeTimeout",
+        type: "select",
+        options: [
+          { name: "3 seconds", value: "3" },
+          { name: "5 seconds (default)", value: "5" },
+          { name: "10 seconds", value: "10" },
+          { name: "15 seconds", value: "15" },
+          { name: "20 seconds", value: "20" },
+        ],
+        required: false,
+        description: "Maximum time to wait when scraping each source URL.",
+        default: "5",
+        scope: "server",
+      },
+    ],
+  };
+
+  private initialized = false;
+
+  constructor() {
+    // Don't initialize in constructor to avoid circular dependency
+    // Initialize lazily when config is first accessed
+  }
+
+  private ensureInitialized() {
+    if (this.initialized) return;
+    this.initialize();
+    this.initialized = true;
+  }
+
+  private initialize() {
+    const providerConfigSections = getModelProvidersUIConfigSection();
+    this.uiConfigSections.modelProviders = providerConfigSections;
+
+    const newProviders: ConfigModelProvider[] = [];
+
+    providerConfigSections.forEach((provider) => {
+
+      const tempConfig: Record<string, any> = {};
+      const required: string[] = [];
+
+      provider.fields.forEach((field) => {
+        tempConfig[field.key] =
+          getEnv(field.env!) || field.default || "";
+        if (field.required) required.push(field.key);
+      });
+
+      let configured = true;
+      required.forEach((r) => {
+        if (!tempConfig[r]) configured = false;
+      });
+
+      if (configured) {
+        const hash = hashObj(tempConfig);
+        const exists = this.currentConfig.modelProviders.find(
+          (p) => p.hash === hash,
+        );
+
+        if (!exists) {
+          newProviders.push({
+            id: hash,
+            name: `${provider.name}`,
+            type: provider.key,
+            chatModels: getDefaultChatModels(provider.key),
+            config: tempConfig,
+            hash: hash,
+            isEnvBased: true,
+          });
+        }
+      }
+    });
+
+    if (newProviders.length > 0) {
+      this.currentConfig.modelProviders.push(...newProviders);
+    }
+
+    // Search config from env
+    this.uiConfigSections.search.forEach((f) => {
+      if (f.env && !this.currentConfig.search[f.key]) {
+        this.currentConfig.search[f.key] =
+          getEnv(f.env) ?? f.default ?? "";
+      }
+    });
+  }
+
+  public getConfig(key: string, defaultValue?: any): any {
+    this.ensureInitialized();
+    const nested = key.split(".");
+    let obj: any = this.currentConfig;
+
+    for (let i = 0; i < nested.length; i++) {
+      const part = nested[i];
+      if (obj == null) return defaultValue;
+      obj = obj[part];
+    }
+
+    return obj === undefined ? defaultValue : obj;
+  }
+
+  public updateConfig(key: string, val: any) {
+    const parts = key.split(".");
+    if (parts.length === 0) return;
+
+    let target: any = this.currentConfig;
+    for (let i = 0; i < parts.length - 1; i++) {
+      const part = parts[i];
+      if (target[part] === null || typeof target[part] !== "object") {
+        target[part] = {};
+      }
+      target = target[part];
+    }
+
+    const finalKey = parts[parts.length - 1];
+    target[finalKey] = val;
+  }
+
+  public addModelProvider(type: string, name: string, config: any) {
+    this.ensureInitialized();
+    const hash = hashObj(config);
+
+    const newModelProvider: ConfigModelProvider = {
+      id: hash,
+      name,
+      type,
+      config,
+      chatModels: [],
+      hash: hash,
+    };
+
+    this.currentConfig.modelProviders.push(newModelProvider);
+    return newModelProvider;
+  }
+
+  public removeModelProvider(id: string) {
+    this.currentConfig.modelProviders =
+      this.currentConfig.modelProviders.filter((p) => p.id !== id);
+  }
+
+  public async updateModelProvider(id: string, name: string, config: any) {
+    const provider = this.currentConfig.modelProviders.find(
+      (p) => p.id === id,
+    );
+    if (!provider) throw new Error("Provider not found");
+
+    provider.name = name;
+    provider.config = config;
+    return provider;
+  }
+
+  public addProviderModel(providerId: string, type: "chat", model: any) {
+    const provider = this.currentConfig.modelProviders.find(
+      (p) => p.id === providerId,
+    );
+    if (!provider) throw new Error("Invalid provider id");
+
+    delete model.type;
+    provider.chatModels.push(model);
+    return model;
+  }
+
+  public removeProviderModel(
+    providerId: string,
+    type: "chat",
+    modelKey: string,
+  ) {
+    const provider = this.currentConfig.modelProviders.find(
+      (p) => p.id === providerId,
+    );
+    if (!provider) throw new Error("Invalid provider id");
+
+    provider.chatModels = provider.chatModels.filter((m) => m.key !== modelKey);
+  }
+
+  public isSetupComplete() {
+    return this.currentConfig.setupComplete;
+  }
+
+  public markSetupComplete() {
+    if (!this.currentConfig.setupComplete) {
+      this.currentConfig.setupComplete = true;
+    }
+  }
+
+  public getUIConfigSections(): UIConfigSections {
+    this.ensureInitialized();
+    return this.uiConfigSections;
+  }
+
+  public getCurrentConfig(): Config {
+    this.ensureInitialized();
+    return JSON.parse(JSON.stringify(this.currentConfig));
+  }
+}
+
+const configManager = new ConfigManager();
+
+export default configManager;