@ik-firewall/core 1.0.0 → 1.0.2

package/dist/index.cjs

@@ -31,6 +31,7 @@ __export(index_exports, {
   IKFirewallCore: () => IKFirewallCore,
   LocalProvider: () => LocalProvider,
   OpenAIProvider: () => OpenAIProvider,
+  PerplexityProvider: () => PerplexityProvider,
   StressTester: () => StressTester,
   SurgicalTester: () => SurgicalTester
 });
@@ -47,6 +48,8 @@ if (typeof window === "undefined") {
 var Registry = class _Registry {
   static instance;
   registryPath;
+  hasWarnedNoFs = false;
+  hasWarnedSaveError = false;
   constructor() {
     this.registryPath = "";
     if (typeof process !== "undefined" && process.versions && process.versions.node) {
@@ -56,7 +59,12 @@ var Registry = class _Registry {
         this.registryPath = path.join(process.cwd(), ".ik-adapter", "registry.json");
         this.ensureDirectory();
       } catch (e) {
-        console.warn("[IK_REGISTRY] Node.js environment detected but modules failed to load. Falling back to in-memory.");
+        if (!this.hasWarnedNoFs) {
+          console.warn("\n[IK_REGISTRY] \u26A0\uFE0F WARNING: Node.js environment detected but fs/path modules failed to load. Falling back to in-memory mode.");
+          console.warn("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Custom configurations (metaprompts, instances) will be LOST upon server restart or lambda spin-down.");
+          console.warn("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: Host on a traditional VPS (Node/Docker) or migrate settings to your database if you need persistence on Serverless runtimes.\n");
+          this.hasWarnedNoFs = true;
+        }
       }
     }
   }
@@ -93,13 +101,26 @@ var Registry = class _Registry {
   }
   save(data) {
     if (!fs || !this.registryPath) {
+      if (!this.hasWarnedNoFs) {
+        console.warn("\n[IK_REGISTRY] \u26A0\uFE0F WARNING: No File System (fs) detected. Running in in-memory mode.");
+        console.warn("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Custom configurations (metaprompts, instances) will be LOST upon server restart or lambda spin-down.");
+        console.warn("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: If hosting on Vercel/Serverless or Edge runtimes, do not rely on local JSON for dynamic config changes.");
+        console.warn("[IK_REGISTRY] \u{1F449} Consider migrating user-generated adapter settings to your database or host on a traditional VPS (Node/Docker) to ensure persistence.\n");
+        this.hasWarnedNoFs = true;
+      }
       return;
     }
     try {
       this.ensureDirectory();
       fs.writeFileSync(this.registryPath, JSON.stringify(data, null, 2), "utf8");
     } catch (error) {
-      console.error("[IK_REGISTRY] Save error:", error);
+      if (!this.hasWarnedSaveError) {
+        console.error("\n[IK_REGISTRY] \u{1F6A8} ERROR saving registry.json. Your environment likely has a read-only filesystem (e.g. Vercel Serverless).");
+        console.error("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Serverless environments wipe or restrict file writes!");
+        console.error("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: Host on a traditional VPS (Node/Docker) or intercept state changes via Events/Database to ensure persistence.");
+        console.error("[IK_REGISTRY] Actual Error:", error.message, "\n");
+        this.hasWarnedSaveError = true;
+      }
     }
   }
   /**
@@ -1129,6 +1150,18 @@ var GeminiProvider = class extends BaseProvider {
   }
 };
 
+// src/providers/PerplexityProvider.ts
+var PerplexityProvider = class extends BaseProvider {
+  functionalProvider;
+  constructor(provider) {
+    super();
+    this.functionalProvider = provider;
+  }
+  async call(prompt, role) {
+    return this.functionalProvider(prompt, role);
+  }
+};
+
 // src/Orchestrator.ts
 var Orchestrator = class {
   config;
@@ -1147,6 +1180,7 @@ var Orchestrator = class {
       if (mode === "anthropic") return { provider: "anthropic", model: "claude-3-5-sonnet-20241022", tier: 4 };
       if (mode === "deepseek") return { provider: "deepseek", model: "deepseek-reasoner", tier: 4 };
       if (mode === "gemini") return { provider: "gemini", model: "gemini-1.5-pro", tier: 4 };
+      if (mode === "perplexity") return { provider: "perplexity", model: "sonar-large-online", tier: 4 };
       return { provider: "openai", model: "gpt-4o", tier: 4 };
     }
     if (mode === "local") {
@@ -1173,6 +1207,13 @@ var Orchestrator = class {
         tier: isHighComplexity ? 3 : 2
       };
     }
+    if (mode === "perplexity") {
+      return {
+        provider: "perplexity",
+        model: isHighComplexity ? "sonar-large-online" : "sonar-small-online",
+        tier: isHighComplexity ? 3 : 2
+      };
+    }
     if (mode === "cloud" || mode === "openai") {
       return {
         provider: "openai",
@@ -1417,6 +1458,8 @@ var IKFirewallCore = class _IKFirewallCore {
           this.cloudProvider = new DeepSeekProvider(cloudProvider);
         } else if (mode === "gemini") {
           this.cloudProvider = new GeminiProvider(cloudProvider);
+        } else if (mode === "perplexity") {
+          this.cloudProvider = new PerplexityProvider(cloudProvider);
         } else {
           this.cloudProvider = new OpenAIProvider(cloudProvider);
         }
@@ -1487,6 +1530,10 @@ var IKFirewallCore = class _IKFirewallCore {
       available: !!process.env.GEMINI_API_KEY,
       reason: !!process.env.GEMINI_API_KEY ? void 0 : "Missing GEMINI_API_KEY inside environment."
     };
+    providers["perplexity"] = {
+      available: !!process.env.PERPLEXITY_API_KEY,
+      reason: !!process.env.PERPLEXITY_API_KEY ? void 0 : "Missing PERPLEXITY_API_KEY inside environment."
+    };
     return providers;
   }
   /**
@@ -1545,6 +1592,8 @@ var IKFirewallCore = class _IKFirewallCore {
           overrideProvider = new DeepSeekProvider(provider);
         } else if (mode === "gemini") {
           overrideProvider = new GeminiProvider(provider);
+        } else if (mode === "perplexity") {
+          overrideProvider = new PerplexityProvider(provider);
         } else {
           overrideProvider = new OpenAIProvider(provider);
         }
@@ -1694,6 +1743,8 @@ var IKFirewallCore = class _IKFirewallCore {
           overrideProvider = new DeepSeekProvider(provider);
         } else if (mode === "gemini") {
           overrideProvider = new GeminiProvider(provider);
+        } else if (mode === "perplexity") {
+          overrideProvider = new PerplexityProvider(provider);
         } else {
           overrideProvider = new OpenAIProvider(provider);
         }
@@ -2420,6 +2471,7 @@ var IKBenchmarks = {
   IKFirewallCore,
   LocalProvider,
   OpenAIProvider,
+  PerplexityProvider,
   StressTester,
   SurgicalTester
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 type ModelRole = 'high_performance' | 'cost_optimized' | 'audit_layer';
-type ProviderMode = 'openai' | 'anthropic' | 'deepseek' | 'gemini' | 'local' | 'hybrid';
+type ProviderMode = 'openai' | 'anthropic' | 'deepseek' | 'gemini' | 'perplexity' | 'local' | 'hybrid';
 type RuntimeStrategy = 'internal' | 'sidecar' | 'wasm';
 type ContextMode = 'FIRST_MESSAGE' | 'EVERY_MESSAGE' | 'SYSTEM_ONLY';
 type PromptLength = 'SHORT' | 'MEDIUM' | 'LONG';
@@ -224,6 +224,16 @@ declare class GeminiProvider extends BaseProvider {
     call(prompt: string, role: ModelRole): Promise<AIResponse>;
 }
 
+/**
+ * PerplexityProvider ensures compatibility with Perplexity API (Sonar online models)
+ * while connecting to the core firewall logic.
+ */
+declare class PerplexityProvider extends BaseProvider {
+    private functionalProvider;
+    constructor(provider: AIProvider);
+    call(prompt: string, role: ModelRole): Promise<AIResponse>;
+}
+
 /**
  * IK FIREWALL: THE CORE ALGORITHM (STANDALONE VERSION)
  * Version: 2.1.0 (Modular & Provider-Agnostic)
@@ -680,4 +690,4 @@ declare const IKBenchmarks: {
     BIG_TEST: TestPrompt[];
 };
 
-export { type AIProvider, type AIResponse, AnthropicProvider, BaseProvider, type ContextMode, DeepSeekProvider, Dictionaries, DictionaryRegex, GeminiProvider, HeuristicGatekeeper, IKBenchmarks, type IKConfig, IKFirewallCore, type IKHooks, type IKMetrics, type IKPluginInfo, LocalProvider, type ModelRole, OpenAIProvider, type PromptLength, type PromptType, type ProviderMode, type RuntimeStrategy, type StressReport, type StressTestCase, StressTester, SurgicalTester, type TestCase, type TestPrompt, type TestResult, type UsageData };
+export { type AIProvider, type AIResponse, AnthropicProvider, BaseProvider, type ContextMode, DeepSeekProvider, Dictionaries, DictionaryRegex, GeminiProvider, HeuristicGatekeeper, IKBenchmarks, type IKConfig, IKFirewallCore, type IKHooks, type IKMetrics, type IKPluginInfo, LocalProvider, type ModelRole, OpenAIProvider, PerplexityProvider, type PromptLength, type PromptType, type ProviderMode, type RuntimeStrategy, type StressReport, type StressTestCase, StressTester, SurgicalTester, type TestCase, type TestPrompt, type TestResult, type UsageData };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type ModelRole = 'high_performance' | 'cost_optimized' | 'audit_layer';
-type ProviderMode = 'openai' | 'anthropic' | 'deepseek' | 'gemini' | 'local' | 'hybrid';
+type ProviderMode = 'openai' | 'anthropic' | 'deepseek' | 'gemini' | 'perplexity' | 'local' | 'hybrid';
 type RuntimeStrategy = 'internal' | 'sidecar' | 'wasm';
 type ContextMode = 'FIRST_MESSAGE' | 'EVERY_MESSAGE' | 'SYSTEM_ONLY';
 type PromptLength = 'SHORT' | 'MEDIUM' | 'LONG';
@@ -224,6 +224,16 @@ declare class GeminiProvider extends BaseProvider {
     call(prompt: string, role: ModelRole): Promise<AIResponse>;
 }
 
+/**
+ * PerplexityProvider ensures compatibility with Perplexity API (Sonar online models)
+ * while connecting to the core firewall logic.
+ */
+declare class PerplexityProvider extends BaseProvider {
+    private functionalProvider;
+    constructor(provider: AIProvider);
+    call(prompt: string, role: ModelRole): Promise<AIResponse>;
+}
+
 /**
  * IK FIREWALL: THE CORE ALGORITHM (STANDALONE VERSION)
  * Version: 2.1.0 (Modular & Provider-Agnostic)
@@ -680,4 +690,4 @@ declare const IKBenchmarks: {
     BIG_TEST: TestPrompt[];
 };
 
-export { type AIProvider, type AIResponse, AnthropicProvider, BaseProvider, type ContextMode, DeepSeekProvider, Dictionaries, DictionaryRegex, GeminiProvider, HeuristicGatekeeper, IKBenchmarks, type IKConfig, IKFirewallCore, type IKHooks, type IKMetrics, type IKPluginInfo, LocalProvider, type ModelRole, OpenAIProvider, type PromptLength, type PromptType, type ProviderMode, type RuntimeStrategy, type StressReport, type StressTestCase, StressTester, SurgicalTester, type TestCase, type TestPrompt, type TestResult, type UsageData };
+export { type AIProvider, type AIResponse, AnthropicProvider, BaseProvider, type ContextMode, DeepSeekProvider, Dictionaries, DictionaryRegex, GeminiProvider, HeuristicGatekeeper, IKBenchmarks, type IKConfig, IKFirewallCore, type IKHooks, type IKMetrics, type IKPluginInfo, LocalProvider, type ModelRole, OpenAIProvider, PerplexityProvider, type PromptLength, type PromptType, type ProviderMode, type RuntimeStrategy, type StressReport, type StressTestCase, StressTester, SurgicalTester, type TestCase, type TestPrompt, type TestResult, type UsageData };

package/dist/index.js

@@ -16,6 +16,8 @@ if (typeof window === "undefined") {
 var Registry = class _Registry {
   static instance;
   registryPath;
+  hasWarnedNoFs = false;
+  hasWarnedSaveError = false;
   constructor() {
     this.registryPath = "";
     if (typeof process !== "undefined" && process.versions && process.versions.node) {
@@ -25,7 +27,12 @@ var Registry = class _Registry {
         this.registryPath = path.join(process.cwd(), ".ik-adapter", "registry.json");
         this.ensureDirectory();
       } catch (e) {
-        console.warn("[IK_REGISTRY] Node.js environment detected but modules failed to load. Falling back to in-memory.");
+        if (!this.hasWarnedNoFs) {
+          console.warn("\n[IK_REGISTRY] \u26A0\uFE0F WARNING: Node.js environment detected but fs/path modules failed to load. Falling back to in-memory mode.");
+          console.warn("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Custom configurations (metaprompts, instances) will be LOST upon server restart or lambda spin-down.");
+          console.warn("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: Host on a traditional VPS (Node/Docker) or migrate settings to your database if you need persistence on Serverless runtimes.\n");
+          this.hasWarnedNoFs = true;
+        }
       }
     }
   }
@@ -62,13 +69,26 @@ var Registry = class _Registry {
   }
   save(data) {
     if (!fs || !this.registryPath) {
+      if (!this.hasWarnedNoFs) {
+        console.warn("\n[IK_REGISTRY] \u26A0\uFE0F WARNING: No File System (fs) detected. Running in in-memory mode.");
+        console.warn("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Custom configurations (metaprompts, instances) will be LOST upon server restart or lambda spin-down.");
+        console.warn("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: If hosting on Vercel/Serverless or Edge runtimes, do not rely on local JSON for dynamic config changes.");
+        console.warn("[IK_REGISTRY] \u{1F449} Consider migrating user-generated adapter settings to your database or host on a traditional VPS (Node/Docker) to ensure persistence.\n");
+        this.hasWarnedNoFs = true;
+      }
       return;
     }
     try {
       this.ensureDirectory();
       fs.writeFileSync(this.registryPath, JSON.stringify(data, null, 2), "utf8");
     } catch (error) {
-      console.error("[IK_REGISTRY] Save error:", error);
+      if (!this.hasWarnedSaveError) {
+        console.error("\n[IK_REGISTRY] \u{1F6A8} ERROR saving registry.json. Your environment likely has a read-only filesystem (e.g. Vercel Serverless).");
+        console.error("[IK_REGISTRY] \u{1F4DD} INTEGRATOR NOTICE: Serverless environments wipe or restrict file writes!");
+        console.error("[IK_REGISTRY] \u{1F4A1} BEST PRACTICE: Host on a traditional VPS (Node/Docker) or intercept state changes via Events/Database to ensure persistence.");
+        console.error("[IK_REGISTRY] Actual Error:", error.message, "\n");
+        this.hasWarnedSaveError = true;
+      }
     }
   }
   /**
@@ -1098,6 +1118,18 @@ var GeminiProvider = class extends BaseProvider {
   }
 };
 
+// src/providers/PerplexityProvider.ts
+var PerplexityProvider = class extends BaseProvider {
+  functionalProvider;
+  constructor(provider) {
+    super();
+    this.functionalProvider = provider;
+  }
+  async call(prompt, role) {
+    return this.functionalProvider(prompt, role);
+  }
+};
+
 // src/Orchestrator.ts
 var Orchestrator = class {
   config;
@@ -1116,6 +1148,7 @@ var Orchestrator = class {
       if (mode === "anthropic") return { provider: "anthropic", model: "claude-3-5-sonnet-20241022", tier: 4 };
       if (mode === "deepseek") return { provider: "deepseek", model: "deepseek-reasoner", tier: 4 };
       if (mode === "gemini") return { provider: "gemini", model: "gemini-1.5-pro", tier: 4 };
+      if (mode === "perplexity") return { provider: "perplexity", model: "sonar-large-online", tier: 4 };
       return { provider: "openai", model: "gpt-4o", tier: 4 };
     }
     if (mode === "local") {
@@ -1142,6 +1175,13 @@ var Orchestrator = class {
         tier: isHighComplexity ? 3 : 2
       };
     }
+    if (mode === "perplexity") {
+      return {
+        provider: "perplexity",
+        model: isHighComplexity ? "sonar-large-online" : "sonar-small-online",
+        tier: isHighComplexity ? 3 : 2
+      };
+    }
     if (mode === "cloud" || mode === "openai") {
       return {
         provider: "openai",
@@ -1386,6 +1426,8 @@ var IKFirewallCore = class _IKFirewallCore {
           this.cloudProvider = new DeepSeekProvider(cloudProvider);
         } else if (mode === "gemini") {
           this.cloudProvider = new GeminiProvider(cloudProvider);
+        } else if (mode === "perplexity") {
+          this.cloudProvider = new PerplexityProvider(cloudProvider);
         } else {
           this.cloudProvider = new OpenAIProvider(cloudProvider);
         }
@@ -1456,6 +1498,10 @@ var IKFirewallCore = class _IKFirewallCore {
       available: !!process.env.GEMINI_API_KEY,
       reason: !!process.env.GEMINI_API_KEY ? void 0 : "Missing GEMINI_API_KEY inside environment."
     };
+    providers["perplexity"] = {
+      available: !!process.env.PERPLEXITY_API_KEY,
+      reason: !!process.env.PERPLEXITY_API_KEY ? void 0 : "Missing PERPLEXITY_API_KEY inside environment."
+    };
     return providers;
   }
   /**
@@ -1514,6 +1560,8 @@ var IKFirewallCore = class _IKFirewallCore {
           overrideProvider = new DeepSeekProvider(provider);
         } else if (mode === "gemini") {
           overrideProvider = new GeminiProvider(provider);
+        } else if (mode === "perplexity") {
+          overrideProvider = new PerplexityProvider(provider);
         } else {
           overrideProvider = new OpenAIProvider(provider);
         }
@@ -1663,6 +1711,8 @@ var IKFirewallCore = class _IKFirewallCore {
           overrideProvider = new DeepSeekProvider(provider);
         } else if (mode === "gemini") {
           overrideProvider = new GeminiProvider(provider);
+        } else if (mode === "perplexity") {
+          overrideProvider = new PerplexityProvider(provider);
         } else {
           overrideProvider = new OpenAIProvider(provider);
         }
@@ -2388,6 +2438,7 @@ export {
   IKFirewallCore,
   LocalProvider,
   OpenAIProvider,
+  PerplexityProvider,
   StressTester,
   SurgicalTester
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ik-firewall/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "The core IK Firewall engine for semantic-driven AI optimization.",
   "main": "./dist/index.js",