zevairouter 1.0.103 → 1.0.105

package/src/app/(dashboard)/dashboard/cli-tools/components/DeepSeekTuiToolCard.js

@@ -49,20 +49,25 @@ export default function DeepSeekTuiToolCard({
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but deepseekStatus is also updated independently by fetch/user actions
     if (initialStatus) setDeepseekStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !deepseekStatus) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest deepseekStatus (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {
@@ -79,6 +84,7 @@ export default function DeepSeekTuiToolCard({
     if (deepseekStatus?.installed && !hasInitializedModel.current) {
       hasInitializedModel.current = true;
       const openaiSection = deepseekStatus.settings?.["providers.openai"];
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time pre-fill from fetched tool config, guarded by hasInitializedModel ref
       if (openaiSection?.model) setSelectedModel(openaiSection.model);
     }
   }, [deepseekStatus]);

package/src/app/(dashboard)/dashboard/cli-tools/components/DroidToolCard.js

@@ -56,20 +56,25 @@ export default function DroidToolCard({
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but droidStatus is also updated independently by fetch/user actions
     if (initialStatus) setDroidStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !droidStatus) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkDroidStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest droidStatus (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {
@@ -91,6 +96,7 @@ export default function DroidToolCard({
         .sort((a, b) => (a.index || 0) - (b.index || 0))
         .map(m => m.model);
       if (existingModels.length > 0) {
+        // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time pre-fill from fetched tool config, guarded by hasInitializedModel ref
         setModelList(existingModels);
       } else {
         // Legacy: single model stored as custom:Zevai-0

package/src/app/(dashboard)/dashboard/cli-tools/components/EndpointPresetControl.js

@@ -39,6 +39,7 @@ export default function EndpointPresetControl({
   const [selectedName, setSelectedName] = useState("");
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from localStorage (external store), intentionally client-only
     setPresets(readPresets());
   }, []);
 

package/src/app/(dashboard)/dashboard/cli-tools/components/HermesToolCard.js

@@ -49,20 +49,25 @@ export default function HermesToolCard({
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but hermesStatus is also updated independently by fetch/user actions
     if (initialStatus) setHermesStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !hermesStatus) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest hermesStatus (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {
@@ -79,6 +84,7 @@ export default function HermesToolCard({
     if (hermesStatus?.installed && !hasInitializedModel.current) {
       hasInitializedModel.current = true;
       const cfg = hermesStatus.settings?.model;
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time pre-fill from fetched tool config, guarded by hasInitializedModel ref
       if (cfg?.default) setSelectedModel(cfg.default);
     }
   }, [hermesStatus]);

package/src/app/(dashboard)/dashboard/cli-tools/components/JcodeToolCard.js

@@ -47,20 +47,25 @@ export default function JcodeToolCard({
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but jcodeStatus is also updated independently by fetch/user actions
     if (initialStatus) setJcodeStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !jcodeStatus) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkJcodeStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest jcodeStatus (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {
@@ -79,6 +84,7 @@ export default function JcodeToolCard({
       const provider = jcodeStatus.config?.providers?.["zevai"];
       if (provider) {
         if (provider.default_model) {
+          // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time pre-fill from fetched tool config, guarded by hasInitializedModel ref
           setSelectedModel(provider.default_model);
         }
         // Try to match API key from env file

package/src/app/(dashboard)/dashboard/cli-tools/components/KiloToolCard.js

@@ -22,19 +22,24 @@ export default function KiloToolCard({ tool, isExpanded, onToggle, baseUrl, apiK
   const [customBaseUrl, setCustomBaseUrl] = useState("");
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
     if (apiKeys?.length > 0 && !selectedApiKey) setSelectedApiKey(apiKeys[0].key);
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but status is also updated independently by fetch/user actions
     if (initialStatus) setStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !status) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest status (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {

package/src/app/(dashboard)/dashboard/cli-tools/components/MitmToolCard.js

@@ -41,7 +41,9 @@ export default function MitmToolCard({
   const canRunWithoutPassword = isWin || hasCachedPassword || needsSudoPassword === false;
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     if (isExpanded) loadSavedMappings();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest loadSavedMappings (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const loadSavedMappings = async () => {

package/src/app/(dashboard)/dashboard/cli-tools/components/OpenClawToolCard.js

@@ -48,20 +48,25 @@ export default function OpenClawToolCard({
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but openclawStatus is also updated independently by fetch/user actions
     if (initialStatus) setOpenclawStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !openclawStatus) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkOpenclawStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest openclawStatus (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   const fetchModelAliases = async () => {
@@ -80,6 +85,7 @@ export default function OpenClawToolCard({
       const provider = openclawStatus.settings?.models?.providers?.["zevai"];
       if (provider) {
         const primaryModel = openclawStatus.settings?.agents?.defaults?.model?.primary;
+        // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time pre-fill from fetched tool config, guarded by hasInitializedModel ref
         if (primaryModel) setSelectedModel(primaryModel.replace("zevai/", ""));
         if (provider.apiKey && apiKeys?.some(k => k.key === provider.apiKey)) {
           setSelectedApiKey(provider.apiKey);

package/src/app/(dashboard)/dashboard/cli-tools/components/OpenCodeToolCard.js

@@ -37,25 +37,31 @@ export default function OpenCodeToolCard({ tool, isExpanded, onToggle, baseUrl,
 
   useEffect(() => {
     if (apiKeys?.length > 0 && !selectedApiKey) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- controlled/uncontrolled hybrid: default selection from apiKeys prop, user can change it independently
       setSelectedApiKey(apiKeys[0].key);
     }
   }, [apiKeys, selectedApiKey]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: mirrors initialStatus prop, but status is also updated independently by fetch/user actions
     if (initialStatus) setStatus(initialStatus);
   }, [initialStatus]);
 
   useEffect(() => {
     if (isExpanded && !status) {
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       checkStatus();
+      // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
       fetchModelAliases();
     }
     if (isExpanded) fetchModelAliases();
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [isExpanded]; read latest status (adding it would re-trigger on every change)
   }, [isExpanded]);
 
   // Sync models from existing config
   useEffect(() => {
     if (status?.opencode?.models) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- sync from fetched tool config: pre-fills selectedModels, which the user can also edit independently
       setSelectedModels(status.opencode.models);
     }
     if (status?.opencode?.activeModel) {

package/src/app/(dashboard)/dashboard/combos/page.js

@@ -26,6 +26,7 @@ export default function CombosPage() {
   const { copied, copy } = useCopyToClipboard();
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchData();
   }, []);  
 
@@ -131,6 +132,7 @@ export default function CombosPage() {
   };
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- pagination clamp: keeps page within range when the filtered list shrinks
     setPage((current) => Math.min(current, Math.max(1, Math.ceil(combos.length / pageSize))));
   }, [combos.length, pageSize]);
 
@@ -449,6 +451,7 @@ function ComboFormModal({ isOpen, combo, onClose, onSave, activeProviders, kindF
   };
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- fetch-on-open: fetchModalData sets state only after await, which the rule flags conservatively
     if (isOpen) fetchModalData();
   }, [isOpen]);
 

package/src/app/(dashboard)/dashboard/context/page.js

@@ -38,6 +38,7 @@ export default function ContextPage() {
     }
   }, []);
 
+  // eslint-disable-next-line react-hooks/set-state-in-effect -- mount data fetch; load() sets state only after await, which the rule flags conservatively
   useEffect(() => { load(); }, [load]);
 
   const toggleGlobal = async (val) => {

package/src/app/(dashboard)/dashboard/endpoint/EndpointPageClient.js

@@ -114,6 +114,7 @@ export default function APIPageClient({ machineId }) {
   const [isRemoteHost, setIsRemoteHost] = useState(false);
   useEffect(() => {
     if (typeof window !== "undefined")
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
       setIsRemoteHost(!["localhost", "127.0.0.1", "::1"].includes(window.location.hostname));
   }, []);
 
@@ -131,8 +132,11 @@ export default function APIPageClient({ machineId }) {
   }, [tsInstallLog]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchData();
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     loadSettings();
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- mount-only initial load; fetchData/loadSettings are stable fetch+setState helpers
   }, []);
 
   // Status poll: only while degraded (not yet reachable). Stop once healthy to avoid spam.
@@ -143,6 +147,7 @@ export default function APIPageClient({ machineId }) {
     const tunnelHealthy = !tunnelEnabled || tunnelReachable;
     const tsHealthy = !tsEnabled || tsReachable;
     const allHealthy = tunnelHealthy && tsHealthy;
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     const onVisible = () => { if (!document.hidden) syncTunnelStatus(); };
     document.addEventListener("visibilitychange", onVisible);
     if (allHealthy) return () => document.removeEventListener("visibilitychange", onVisible);
@@ -151,6 +156,7 @@ export default function APIPageClient({ machineId }) {
       clearInterval(timer);
       document.removeEventListener("visibilitychange", onVisible);
     };
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- syncTunnelStatus is a stable fetch+setState helper (reads via refs/setters, no stale state)
   }, [tunnelEnabled, tsEnabled, tunnelReachable, tsReachable]);
 
   // Browser-side periodic ping: probes tunnel/tailscale URLs directly so UI stays
@@ -735,6 +741,7 @@ export default function APIPageClient({ machineId }) {
   // Hydration fix: Only access window on client side
   useEffect(() => {
     if (typeof window !== "undefined") {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
       setBaseUrl(`${window.location.origin}/v1`);
     }
   }, []);

package/src/app/(dashboard)/dashboard/media-providers/[kind]/[id]/page.js

@@ -1,4 +1,5 @@
 "use client";
+/* eslint-disable @next/next/no-img-element -- dynamic/blob/external image src with onError fallback; next/image requires static dims + domain allowlist */
 
 import { useParams, notFound, useRouter } from "next/navigation";
 import Link from "next/link";
@@ -150,6 +151,7 @@ function EmbeddingExampleCard({ providerId, customAlias }) {
   const { copied: copiedRes, copy: copyRes } = useCopyToClipboard();
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
     setLocalEndpoint(window.location.origin);
     fetch("/api/keys")
       .then((r) => r.json())
@@ -413,6 +415,7 @@ function TtsExampleCard({ providerId }) {
   const [languageHint, setLanguageHint]     = useState("");
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
     setLocalEndpoint(window.location.origin);
     fetch("/api/keys")
       .then((r) => r.json())
@@ -451,17 +454,20 @@ function TtsExampleCard({ providerId }) {
     // api-language (edge-tts, local-device, elevenlabs): NO default load, wait for user to pick language
     // config (nvidia, hyperbolic, deepgram, huggingface, cartesia, playht, coqui, tortoise, inworld, qwen):
     // use ttsConfig.models for model selector; voice is empty by default (backend uses provider default)
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [providerId]; read latest latest values (adding it would re-trigger on every change)
   }, [providerId]);
 
   // Update voices when model changes (voicesPerModel providers)
   useEffect(() => {
     if (!config.voicesPerModel || !selectedModel) return;
     const voices = getTtsVoicesForModel(providerId, selectedModel) || [];
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- sync derived voice list when selectedModel changes; voices come from a static config map and also drive selectedVoice reset below
     setCountryVoices(voices);
     if (voices.length) {
       setSelectedVoice(voices[0].id);
       setSelectedVoiceName(voices[0].name || voices[0].id);
     }
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [selectedModel]; read latest config.voicesPerModel (adding it would re-trigger on every change)
   }, [selectedModel]);
 
   // Open modal — load language list
@@ -957,6 +963,7 @@ function GenericExampleCard({ providerId, kind }) {
   const { copied: copiedRes, copy: copyRes } = useCopyToClipboard();
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
     setLocalEndpoint(window.location.origin);
     fetch("/api/keys")
       .then((r) => r.json())
@@ -1453,6 +1460,7 @@ function SttExampleCard({ providerId }) {
   const { copied: copiedRes, copy: copyRes } = useCopyToClipboard();
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
     setLocalEndpoint(window.location.origin);
     fetch("/api/keys")
       .then((r) => r.json())
@@ -1493,6 +1501,7 @@ function SttExampleCard({ providerId }) {
     setRunning(true);
     setError("");
     setResult(null);
+    // eslint-disable-next-line react-hooks/purity -- Date.now() runs inside the handleRun click handler, not during render; needed to measure request latency
     const start = Date.now();
     try {
       const fd = new FormData();
@@ -1506,6 +1515,7 @@ function SttExampleCard({ providerId }) {
       const headers = {};
       if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
       const res = await fetch("/api/v1/audio/transcriptions", { method: "POST", headers, body: fd });
+      // eslint-disable-next-line react-hooks/purity -- Date.now() runs inside the handleRun click handler after fetch resolves, not during render; computes request latency
       setLatency(Date.now() - start);
       const ct = res.headers.get("content-type") || "";
       const data = ct.includes("application/json") ? await res.json() : await res.text();

package/src/app/(dashboard)/dashboard/media-providers/combo/[id]/page.js

@@ -1,4 +1,5 @@
 "use client";
+/* eslint-disable @next/next/no-img-element -- dynamic/blob/external image src with onError fallback; next/image requires static dims + domain allowlist */
 
 import { useParams, notFound, useRouter } from "next/navigation";
 import { useEffect, useState } from "react";
@@ -175,6 +176,7 @@ export default function ComboDetailPage() {
     setTestError("");
     if (testResult?.audioUrl) { try { URL.revokeObjectURL(testResult.audioUrl); } catch {} }
     if (testResult?.imageUrl?.startsWith("blob:")) { try { URL.revokeObjectURL(testResult.imageUrl); } catch {} }
+    // eslint-disable-next-line react-hooks/purity -- Date.now() runs inside the handleTest click handler, not during render; needed to measure request latency
     const start = Date.now();
     try {
       const path = EXAMPLE_PATHS[combo.kind];
@@ -182,6 +184,7 @@ export default function ComboDetailPage() {
       const headers = { "Content-Type": "application/json" };
       if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
       const res = await fetch(`/api${path}`, { method: "POST", headers, body: JSON.stringify(body) });
+      // eslint-disable-next-line react-hooks/purity -- Date.now() runs inside the handleTest click handler after fetch resolves, not during render; computes request latency
       const latencyMs = Date.now() - start;
       if (!res.ok) {
         const d = await res.json().catch(() => ({}));

package/src/app/(dashboard)/dashboard/mitm/MitmPageClient.js

@@ -15,9 +15,13 @@ export default function MitmPageClient() {
   const [mitmStatus, setMitmStatus] = useState({ running: false, certExists: false, dnsStatus: {}, hasCachedPassword: false });
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchConnections();
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchApiKeys();
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchAliases();
+    // eslint-disable-next-line react-hooks/immutability -- false positive: these are local fetch+setState helpers invoked once on effect fire (not during render); defined with const below because all invocations are deferred (effects/events), so no TDZ issue at runtime
     fetchCloudSettings();
   }, []);
 

package/src/app/(dashboard)/dashboard/profile/page.js

@@ -59,6 +59,7 @@ export default function ProfilePage() {
   const [proxyTestLoading, setProxyTestLoading] = useState(false);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- syncs locale from cookie (external store) on mount and whenever the language modal closes
     setLocale(getLocaleFromCookie());
   }, [langOpen]);
 
@@ -91,6 +92,7 @@ export default function ProfilePage() {
 
   useEffect(() => {
     if (typeof window !== "undefined") {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- one-time mount initialization from window.location (external source, client-only, avoids hydration mismatch)
       setOidcRedirectUri(`${window.location.origin}/api/auth/oidc/callback`);
     }
   }, []);

package/src/app/(dashboard)/dashboard/providers/[id]/AddCustomModelModal.js

@@ -12,6 +12,7 @@ export default function AddCustomModelModal({ isOpen, providerAlias, providerDis
 
   // Reset state when modal opens
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- reset-on-open: clears form state each time the modal is reopened
     if (isOpen) { setModelId(""); setTestStatus(null); setTestError(""); }
   }, [isOpen]);
 

package/src/app/(dashboard)/dashboard/providers/[id]/ConnectionRow.js

@@ -101,6 +101,7 @@ export default function ConnectionRow({ connection, proxyPools, isOAuth, isFirst
     return () => {
       if (interval) clearInterval(interval);
     };
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [modelLockUntil]; read latest connection (adding it would re-trigger on every change)
   }, [modelLockUntil]);
 
   // Determine effective status (override unavailable if cooldown expired)

package/src/app/(dashboard)/dashboard/providers/[id]/EditCompatibleNodeModal.js

@@ -19,6 +19,7 @@ export default function EditCompatibleNodeModal({ isOpen, node, onSave, onClose,
 
   useEffect(() => {
     if (node) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: pre-fills form from the node being edited; user edits fields independently afterwards
       setFormData({
         name: node.name || "",
         prefix: node.prefix || "",

package/src/app/(dashboard)/dashboard/providers/[id]/page.js

@@ -467,12 +467,14 @@ export default function ProviderDetailPage() {
   };
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- mount data fetch; these set state only after await, which the rule flags conservatively
     fetchConnections();
     fetchAliases();
     fetchDisabledModels();
   }, [fetchConnections, fetchAliases, fetchDisabledModels]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- reset-on-prop-change: clears paging/filters when switching provider pages
     setConnectionsPage(1);
     setModelsPage(1);
     setConnectionStatusFilter("all");
@@ -480,10 +482,12 @@ export default function ProviderDetailPage() {
   }, [providerId]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- pagination reset: returns to page 1 when filters/page size change
     setConnectionsPage(1);
   }, [connectionStatusFilter, connectionsPageSize, connectionQuery]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- pagination reset: returns to page 1 when the model lists change
     setModelsPage(1);
   }, [modelsPageSize, disabledModelIds.length, models.length, kiloFreeModels.length]);
 

package/src/app/(dashboard)/dashboard/providers/[id]/page.new.js

@@ -178,6 +178,7 @@ export default function ProviderDetailPage() {
   };
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- mount data fetch; these set state only after await, which the rule flags conservatively
     fetchConnections();
     fetchAliases();
   }, [fetchConnections, fetchAliases]);
@@ -187,6 +188,7 @@ export default function ProviderDetailPage() {
       ? []
       : savedEnabledModels;
 
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- syncs selection from server-saved enabled models; functional update with deep-equality bail-out avoids loops
     setSelectedModelIds((prev) => {
       if (
         prev.length === nextSelectedModelIds.length
@@ -246,6 +248,7 @@ export default function ProviderDetailPage() {
   }, [activeConnection, isCompatible, models.length, providerInfo?.passthroughModels]);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- data fetch effect; fetchRemoteModels sets state only after await, which the rule flags conservatively
     fetchRemoteModels();
   }, [fetchRemoteModels]);
 
@@ -1143,12 +1146,7 @@ function ConnectionRow({ connection, isOAuth, isFirst, isLast, onMoveUp, onMoveD
 
   // Use useState + useEffect for impure Date.now() to avoid calling during render
   const [isCooldown, setIsCooldown] = useState(false);
-
-  const modelLockUntil = Object.entries(connection)
-    .filter(([k]) => k.startsWith("modelLock_"))
-    .map(([, v]) => v)
-    .filter(v => v && new Date(v).getTime() > Date.now())
-    .sort()[0] || null;
+  const [modelLockUntil, setModelLockUntil] = useState(null);
 
   useEffect(() => {
     const checkCooldown = () => {
@@ -1158,6 +1156,7 @@ function ConnectionRow({ connection, isOAuth, isFirst, isLast, onMoveUp, onMoveD
         .filter(v => v && new Date(v).getTime() > Date.now())
         .sort()[0] || null;
       setIsCooldown(!!until);
+      setModelLockUntil((prev) => (prev === until ? prev : until));
     };
 
     checkCooldown();
@@ -1165,6 +1164,7 @@ function ConnectionRow({ connection, isOAuth, isFirst, isLast, onMoveUp, onMoveD
     return () => {
       if (interval) clearInterval(interval);
     };
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [modelLockUntil]; read latest connection (adding it would re-trigger on every change)
   }, [modelLockUntil]);
 
   // Determine effective status (override unavailable if cooldown expired)
@@ -1406,6 +1406,7 @@ function EditConnectionModal({ isOpen, connection, onSave, onClose }) {
 
   useEffect(() => {
     if (connection) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: pre-fills form from the connection being edited; user edits fields independently afterwards
       setFormData({
         name: connection.name || "",
         priority: connection.priority || 1,
@@ -1590,6 +1591,7 @@ function EditCompatibleNodeModal({ isOpen, node, onSave, onClose, isAnthropic })
 
   useEffect(() => {
     if (node) {
+      // eslint-disable-next-line react-hooks/set-state-in-effect -- sync-from-props hybrid: pre-fills form from the node being edited; user edits fields independently afterwards
       setFormData({
         name: node.name || "",
         prefix: node.prefix || "",

package/src/app/(dashboard)/dashboard/providers/components/ConnectionsCard.js

@@ -72,6 +72,7 @@ function ConnectionRow({ connection, proxyPools, isOAuth, isFirst, isLast, onMov
     check();
     const t = modelLockUntil ? setInterval(check, 1000) : null;
     return () => { if (t) clearInterval(t); };
+  // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: react only to [modelLockUntil]; read latest connection (adding it would re-trigger on every change)
   }, [modelLockUntil]);
 
   useEffect(() => {
@@ -329,6 +330,7 @@ export default function ConnectionsCard({ providerId, isOAuth }) {
     finally { setLoading(false); }
   }, [providerId]);
 
+  // eslint-disable-next-line react-hooks/set-state-in-effect -- data fetch effect; fetch_ sets state only after await, which the rule flags conservatively
   useEffect(() => { fetch_(); }, [fetch_]);
 
   const saveStrategy = async (strategy, stickyLimit) => {

package/src/app/(dashboard)/dashboard/providers/components/ModelAvailabilityBadge.js

@@ -41,6 +41,7 @@ export default function ModelAvailabilityBadge() {
   }, []);
 
   useEffect(() => {
+    // eslint-disable-next-line react-hooks/set-state-in-effect -- polling data fetch; fetchStatus sets state only after await, which the rule flags conservatively
     fetchStatus();
     const interval = setInterval(fetchStatus, 30000);
     return () => clearInterval(interval);

package/src/app/(dashboard)/dashboard/providers/components/ModelsCard.js

@@ -137,6 +137,7 @@ export default function ModelsCard({ providerId, kindFilter, providerAliasOverri
     } catch (e) { console.log("ModelsCard fetch error:", e); }
   }, [providerId]);
 
+  // eslint-disable-next-line react-hooks/set-state-in-effect -- data fetch effect; fetchData sets state only after await, which the rule flags conservatively
   useEffect(() => { fetchData(); }, [fetchData]);
 
   const handleSetAlias = async (modelId, alias) => {