@staticn0va/wigolo 0.1.0 → 0.1.2

package/dist/searxng/process.js

@@ -1,188 +1,255 @@
-import { spawn } from 'node:child_process';
-import { createServer as createNetServer } from 'node:net';
-import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { getConfig } from '../config.js';
-import { createLogger } from '../logger.js';
-const log = createLogger('searxng');
+import { spawn } from "node:child_process";
+import { createServer as createNetServer } from "node:net";
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getConfig } from "../config.js";
+import { createLogger } from "../logger.js";
+const log = createLogger("searxng");
 const PORT_RANGE_START = 8888;
 const PORT_RANGE_END = 8899;
-const HEALTH_TIMEOUT_MS = 10000;
+const HEALTH_TIMEOUT_MS = 1e4;
 const HEALTH_POLL_MS = 500;
 const MAX_CRASH_RESTARTS = 3;
-const CRASH_WINDOW_MS = 60000;
-const SHUTDOWN_GRACE_MS = 5000;
-export function findAvailablePort(startPort) {
-    return new Promise((resolve, reject) => {
-        let port = startPort;
-        function tryPort() {
-            if (port > PORT_RANGE_END) {
-                reject(new Error(`No available port in range ${PORT_RANGE_START}-${PORT_RANGE_END}`));
-                return;
-            }
-            const server = createNetServer();
-            server.on('error', () => {
-                port++;
-                tryPort();
-            });
-            server.listen(port, () => {
-                const addr = server.address();
-                const foundPort = typeof addr === 'object' && addr ? addr.port : port;
-                server.close(() => resolve(foundPort));
-            });
-        }
+const CRASH_WINDOW_MS = 6e4;
+const SHUTDOWN_GRACE_MS = 5e3;
+function findAvailablePort(startPort) {
+  return new Promise((resolve, reject) => {
+    let port = startPort;
+    function tryPort() {
+      if (port > PORT_RANGE_END) {
+        reject(new Error(`No available port in range ${PORT_RANGE_START}-${PORT_RANGE_END}`));
+        return;
+      }
+      const server = createNetServer();
+      server.on("error", () => {
+        port++;
         tryPort();
-    });
+      });
+      server.listen(port, () => {
+        const addr = server.address();
+        const foundPort = typeof addr === "object" && addr ? addr.port : port;
+        server.close(() => resolve(foundPort));
+      });
+    }
+    tryPort();
+  });
 }
 function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
 }
-export function acquireLock(dataDir) {
-    const lockFile = join(dataDir, 'searxng.lock');
-    if (existsSync(lockFile)) {
-        try {
-            const data = JSON.parse(readFileSync(lockFile, 'utf-8'));
-            if (data.pid && isProcessAlive(data.pid)) {
-                return { acquired: false, existingPid: data.pid, existingPort: data.port };
-            }
-            log.info('cleaning stale lock file', { stalePid: data.pid });
-            unlinkSync(lockFile);
-        }
-        catch {
-            unlinkSync(lockFile);
-        }
+function tryUnlink(path) {
+  try {
+    unlinkSync(path);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") {
+      log.debug("unable to remove file", { path, code: code ?? "unknown" });
     }
-    mkdirSync(dataDir, { recursive: true });
-    writeFileSync(lockFile, JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() }));
-    return { acquired: true };
+  }
 }
-export function releaseLock(dataDir) {
-    const lockFile = join(dataDir, 'searxng.lock');
-    if (existsSync(lockFile)) {
-        try {
-            unlinkSync(lockFile);
-        }
-        catch { }
-    }
-    const portFile = join(dataDir, 'searxng.port');
-    if (existsSync(portFile)) {
-        try {
-            unlinkSync(portFile);
-        }
-        catch { }
+function acquireLock(dataDir) {
+  const lockFile = join(dataDir, "searxng.lock");
+  if (existsSync(lockFile)) {
+    try {
+      const data = JSON.parse(readFileSync(lockFile, "utf-8"));
+      if (data.pid && isProcessAlive(data.pid)) {
+        return { acquired: false, existingPid: data.pid, existingPort: data.port };
+      }
+      log.info("cleaning stale lock file", { stalePid: data.pid });
+      tryUnlink(lockFile);
+    } catch {
+      tryUnlink(lockFile);
     }
+  }
+  mkdirSync(dataDir, { recursive: true });
+  writeFileSync(lockFile, JSON.stringify({ pid: process.pid, startedAt: (/* @__PURE__ */ new Date()).toISOString() }));
+  return { acquired: true };
+}
+function releaseLock(dataDir) {
+  const lockFile = join(dataDir, "searxng.lock");
+  if (existsSync(lockFile)) tryUnlink(lockFile);
+  const portFile = join(dataDir, "searxng.port");
+  if (existsSync(portFile)) tryUnlink(portFile);
 }
 async function waitForHealth(url, timeoutMs) {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        try {
-            const response = await fetch(`${url}/healthz`, { signal: AbortSignal.timeout(2000) });
-            if (response.ok)
-                return true;
-        }
-        catch { }
-        await new Promise(r => setTimeout(r, HEALTH_POLL_MS));
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const response = await fetch(`${url}/healthz`, { signal: AbortSignal.timeout(2e3) });
+      if (response.ok) return true;
+    } catch {
     }
-    return false;
+    await new Promise((r) => setTimeout(r, HEALTH_POLL_MS));
+  }
+  return false;
 }
-export class SearxngProcess {
-    searxngPath;
-    dataDir;
-    child = null;
-    port = null;
-    crashTimes = [];
-    stopped = false;
-    constructor(searxngPath, dataDir) {
-        this.searxngPath = searxngPath;
-        this.dataDir = dataDir;
+class SearxngProcess {
+  constructor(searxngPath, dataDir, callbacks = {}) {
+    this.searxngPath = searxngPath;
+    this.dataDir = dataDir;
+    this.callbacks = callbacks;
+  }
+  searxngPath;
+  dataDir;
+  callbacks;
+  child = null;
+  port = null;
+  crashTimes = [];
+  stopped = false;
+  isCurrentlyUnhealthy = false;
+  healthProbeFailures = 0;
+  healthProbeTimer = null;
+  getUrl() {
+    return this.port ? `http://127.0.0.1:${this.port}` : null;
+  }
+  async start() {
+    const config = getConfig();
+    const lock = acquireLock(this.dataDir);
+    if (!lock.acquired) {
+      if (lock.existingPort) {
+        log.info("connecting to existing SearXNG instance", { port: lock.existingPort });
+        this.port = lock.existingPort;
+        return this.getUrl();
+      }
+      log.warn("could not acquire lock", { existingPid: lock.existingPid });
+      return null;
     }
-    getUrl() {
-        return this.port ? `http://127.0.0.1:${this.port}` : null;
+    try {
+      this.port = await findAvailablePort(config.searxngPort);
+    } catch (err) {
+      log.error("no available port", { error: String(err) });
+      releaseLock(this.dataDir);
+      return null;
     }
-    async start() {
-        const config = getConfig();
-        const lock = acquireLock(this.dataDir);
-        if (!lock.acquired) {
-            if (lock.existingPort) {
-                log.info('connecting to existing SearXNG instance', { port: lock.existingPort });
-                this.port = lock.existingPort;
-                return this.getUrl();
-            }
-            log.warn('could not acquire lock', { existingPid: lock.existingPid });
-            return null;
-        }
-        try {
-            this.port = await findAvailablePort(config.searxngPort);
-        }
-        catch (err) {
-            log.error('no available port', { error: String(err) });
-            releaseLock(this.dataDir);
-            return null;
+    const settingsPath = join(this.searxngPath, "settings.yml");
+    const pythonBin = join(this.searxngPath, "venv", "bin", "python");
+    if (!existsSync(pythonBin)) {
+      log.error("SearXNG python not found \u2014 run warmup first", { path: pythonBin });
+      releaseLock(this.dataDir);
+      return null;
+    }
+    this.child = spawn(pythonBin, ["-m", "searx.webapp"], {
+      env: { ...process.env, SEARXNG_SETTINGS_PATH: settingsPath },
+      stdio: ["ignore", "ignore", "pipe"]
+    });
+    this.child.on("error", (err) => {
+      log.error("SearXNG spawn error", { error: String(err) });
+    });
+    let stderrTail = "";
+    this.child.stderr?.on("data", (chunk) => {
+      stderrTail = (stderrTail + chunk.toString("utf8")).slice(-4096);
+    });
+    this.child.on("exit", (code) => {
+      if (code !== 0 && code !== null && stderrTail) {
+        log.warn("SearXNG stderr tail", { code, stderrTail: stderrTail.slice(-1024) });
+      }
+    });
+    writeFileSync(join(this.dataDir, "searxng.port"), String(this.port));
+    writeFileSync(
+      join(this.dataDir, "searxng.lock"),
+      JSON.stringify({ pid: process.pid, port: this.port, startedAt: (/* @__PURE__ */ new Date()).toISOString() })
+    );
+    const url = this.getUrl();
+    const healthy = await waitForHealth(url, HEALTH_TIMEOUT_MS);
+    if (!healthy) {
+      log.error("SearXNG failed to start within timeout");
+      await this.stop();
+      return null;
+    }
+    this.monitorCrashes();
+    this.startHealthProbe();
+    log.info("SearXNG started", { port: this.port, url });
+    return url;
+  }
+  monitorCrashes() {
+    if (!this.child) return;
+    this.child.on("exit", (code) => {
+      if (this.stopped) return;
+      log.warn("SearXNG process exited unexpectedly", { code });
+      this.crashTimes.push(Date.now());
+      const cutoff = Date.now() - CRASH_WINDOW_MS;
+      this.crashTimes = this.crashTimes.filter((t) => t > cutoff);
+      if (this.crashTimes.length >= MAX_CRASH_RESTARTS) {
+        log.error("too many crashes, giving up on SearXNG", { crashes: this.crashTimes.length });
+        releaseLock(this.dataDir);
+        if (!this.isCurrentlyUnhealthy) {
+          this.isCurrentlyUnhealthy = true;
+          this.callbacks.onUnhealthy?.(
+            `SearXNG process crashed ${this.crashTimes.length} times in ${CRASH_WINDOW_MS / 1e3}s`
+          );
         }
-        const settingsPath = join(this.searxngPath, 'settings.yml');
-        const pythonBin = join(this.searxngPath, 'venv', 'bin', 'python');
-        this.child = spawn(pythonBin, ['-m', 'searx.webapp'], {
-            env: { ...process.env, SEARXNG_SETTINGS_PATH: settingsPath },
-            stdio: 'pipe',
-        });
-        writeFileSync(join(this.dataDir, 'searxng.port'), String(this.port));
-        // Update lock file with the resolved port so other instances can connect
-        writeFileSync(join(this.dataDir, 'searxng.lock'), JSON.stringify({ pid: process.pid, port: this.port, startedAt: new Date().toISOString() }));
-        const url = this.getUrl();
-        const healthy = await waitForHealth(url, HEALTH_TIMEOUT_MS);
-        if (!healthy) {
-            log.error('SearXNG failed to start within timeout');
-            await this.stop();
-            return null;
+        return;
+      }
+      const backoff = Math.min(1e3 * Math.pow(2, this.crashTimes.length - 1), 3e4);
+      log.info("restarting SearXNG after backoff", { backoffMs: backoff });
+      setTimeout(() => {
+        if (!this.stopped) this.start();
+      }, backoff);
+    });
+  }
+  startHealthProbe() {
+    if (this.healthProbeTimer) clearInterval(this.healthProbeTimer);
+    const config = getConfig();
+    const intervalMs = config.healthProbeIntervalMs;
+    this.healthProbeTimer = setInterval(() => {
+      void this.probeOnce();
+    }, intervalMs);
+  }
+  async probeOnce() {
+    if (this.stopped || !this.port) return;
+    try {
+      const r = await fetch(`http://127.0.0.1:${this.port}/healthz`, { signal: AbortSignal.timeout(2e3) });
+      if (r.ok) {
+        this.healthProbeFailures = 0;
+        if (this.isCurrentlyUnhealthy) {
+          this.isCurrentlyUnhealthy = false;
+          this.callbacks.onHealthy?.();
         }
-        this.monitorCrashes();
-        log.info('SearXNG started', { port: this.port, url });
-        return url;
+      } else {
+        this.notePotentialFailure();
+      }
+    } catch {
+      this.notePotentialFailure();
     }
-    monitorCrashes() {
-        if (!this.child)
-            return;
-        this.child.on('exit', (code) => {
-            if (this.stopped)
-                return;
-            log.warn('SearXNG process exited unexpectedly', { code });
-            this.crashTimes.push(Date.now());
-            const cutoff = Date.now() - CRASH_WINDOW_MS;
-            this.crashTimes = this.crashTimes.filter(t => t > cutoff);
-            if (this.crashTimes.length >= MAX_CRASH_RESTARTS) {
-                log.error('too many crashes, giving up on SearXNG', { crashes: this.crashTimes.length });
-                releaseLock(this.dataDir);
-                return;
-            }
-            const backoff = Math.min(1000 * Math.pow(2, this.crashTimes.length - 1), 30000);
-            log.info('restarting SearXNG after backoff', { backoffMs: backoff });
-            setTimeout(() => {
-                if (!this.stopped)
-                    this.start();
-            }, backoff);
-        });
+  }
+  notePotentialFailure() {
+    this.healthProbeFailures++;
+    if (this.healthProbeFailures === 3 && !this.isCurrentlyUnhealthy) {
+      this.isCurrentlyUnhealthy = true;
+      this.callbacks.onUnhealthy?.("SearXNG /healthz unreachable for 3 consecutive probes");
     }
-    async stop() {
-        this.stopped = true;
-        if (this.child) {
-            this.child.kill('SIGTERM');
-            await Promise.race([
-                new Promise((resolve) => this.child.on('exit', resolve)),
-                new Promise((resolve) => setTimeout(() => {
-                    this.child?.kill('SIGKILL');
-                    resolve();
-                }, SHUTDOWN_GRACE_MS)),
-            ]);
-            this.child = null;
-        }
-        releaseLock(this.dataDir);
-        this.port = null;
+  }
+  async stop() {
+    if (this.healthProbeTimer) {
+      clearInterval(this.healthProbeTimer);
+      this.healthProbeTimer = null;
+    }
+    this.stopped = true;
+    if (this.child) {
+      this.child.kill("SIGTERM");
+      await Promise.race([
+        new Promise((resolve) => this.child.on("exit", resolve)),
+        new Promise((resolve) => setTimeout(() => {
+          this.child?.kill("SIGKILL");
+          resolve();
+        }, SHUTDOWN_GRACE_MS))
+      ]);
+      this.child = null;
     }
+    releaseLock(this.dataDir);
+    this.port = null;
+  }
 }
+export {
+  SearxngProcess,
+  acquireLock,
+  findAvailablePort,
+  isProcessAlive,
+  releaseLock
+};
 //# sourceMappingURL=process.js.map

package/dist/searxng/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/searxng/process.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../src/searxng/process.ts"],"sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process';\nimport { createServer as createNetServer } from 'node:net';\nimport { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { getConfig } from '../config.js';\nimport { createLogger } from '../logger.js';\n\nconst log = createLogger('searxng');\n\nconst PORT_RANGE_START = 8888;\nconst PORT_RANGE_END = 8899;\nconst HEALTH_TIMEOUT_MS = 10000;\nconst HEALTH_POLL_MS = 500;\nconst MAX_CRASH_RESTARTS = 3;\nconst CRASH_WINDOW_MS = 60000;\nconst SHUTDOWN_GRACE_MS = 5000;\n\nexport interface ProcessCallbacks {\n  onUnhealthy?: (reason: string) => void;\n  onHealthy?: () => void;\n}\n\nexport function findAvailablePort(startPort: number): Promise<number> {\n  return new Promise((resolve, reject) => {\n    let port = startPort;\n\n    function tryPort() {\n      if (port > PORT_RANGE_END) {\n        reject(new Error(`No available port in range ${PORT_RANGE_START}-${PORT_RANGE_END}`));\n        return;\n      }\n      const server = createNetServer();\n      server.on('error', () => {\n        port++;\n        tryPort();\n      });\n      server.listen(port, () => {\n        const addr = server.address();\n        const foundPort = typeof addr === 'object' && addr ? addr.port : port;\n        server.close(() => resolve(foundPort));\n      });\n    }\n\n    tryPort();\n  });\n}\n\ninterface LockResult {\n  acquired: boolean;\n  existingPid?: number;\n  existingPort?: number;\n}\n\nexport function isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// Best-effort unlink. Surfacing EPERM/EACCES every boot in a read-only or\n// permission-restricted data dir was noisy — log once at debug and continue.\nfunction tryUnlink(path: string): void {\n  try {\n    unlinkSync(path);\n  } catch (err) {\n    const code = (err as { code?: string }).code;\n    if (code !== 'ENOENT') {\n      log.debug('unable to remove file', { path, code: code ?? 'unknown' });\n    }\n  }\n}\n\nexport function acquireLock(dataDir: string): LockResult {\n  const lockFile = join(dataDir, 'searxng.lock');\n\n  if (existsSync(lockFile)) {\n    try {\n      const data = JSON.parse(readFileSync(lockFile, 'utf-8'));\n      if (data.pid && isProcessAlive(data.pid)) {\n        return { acquired: false, existingPid: data.pid, existingPort: data.port };\n      }\n      log.info('cleaning stale lock file', { stalePid: data.pid });\n      tryUnlink(lockFile);\n    } catch {\n      tryUnlink(lockFile);\n    }\n  }\n\n  mkdirSync(dataDir, { recursive: true });\n  writeFileSync(lockFile, JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() }));\n  return { acquired: true };\n}\n\nexport function releaseLock(dataDir: string): void {\n  const lockFile = join(dataDir, 'searxng.lock');\n  if (existsSync(lockFile)) tryUnlink(lockFile);\n  const portFile = join(dataDir, 'searxng.port');\n  if (existsSync(portFile)) tryUnlink(portFile);\n}\n\nasync function waitForHealth(url: string, timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    try {\n      const response = await fetch(`${url}/healthz`, { signal: AbortSignal.timeout(2000) });\n      if (response.ok) return true;\n    } catch {}\n    await new Promise(r => setTimeout(r, HEALTH_POLL_MS));\n  }\n  return false;\n}\n\nexport class SearxngProcess {\n  private child: ChildProcess | null = null;\n  private port: number | null = null;\n  private crashTimes: number[] = [];\n  private stopped = false;\n  private isCurrentlyUnhealthy = false;\n  private healthProbeFailures = 0;\n  private healthProbeTimer: NodeJS.Timeout | null = null;\n\n  constructor(\n    private readonly searxngPath: string,\n    private readonly dataDir: string,\n    private readonly callbacks: ProcessCallbacks = {},\n  ) {}\n\n  getUrl(): string | null {\n    return this.port ? `http://127.0.0.1:${this.port}` : null;\n  }\n\n  async start(): Promise<string | null> {\n    const config = getConfig();\n    const lock = acquireLock(this.dataDir);\n\n    if (!lock.acquired) {\n      if (lock.existingPort) {\n        log.info('connecting to existing SearXNG instance', { port: lock.existingPort });\n        this.port = lock.existingPort;\n        return this.getUrl();\n      }\n      log.warn('could not acquire lock', { existingPid: lock.existingPid });\n      return null;\n    }\n\n    try {\n      this.port = await findAvailablePort(config.searxngPort);\n    } catch (err) {\n      log.error('no available port', { error: String(err) });\n      releaseLock(this.dataDir);\n      return null;\n    }\n\n    const settingsPath = join(this.searxngPath, 'settings.yml');\n    const pythonBin = join(this.searxngPath, 'venv', 'bin', 'python');\n\n    if (!existsSync(pythonBin)) {\n      log.error('SearXNG python not found — run warmup first', { path: pythonBin });\n      releaseLock(this.dataDir);\n      return null;\n    }\n\n    this.child = spawn(pythonBin, ['-m', 'searx.webapp'], {\n      env: { ...process.env, SEARXNG_SETTINGS_PATH: settingsPath },\n      stdio: ['ignore', 'ignore', 'pipe'],\n    });\n\n    this.child.on('error', (err) => {\n      log.error('SearXNG spawn error', { error: String(err) });\n    });\n\n    let stderrTail = '';\n    this.child.stderr?.on('data', (chunk: Buffer) => {\n      stderrTail = (stderrTail + chunk.toString('utf8')).slice(-4096);\n    });\n    this.child.on('exit', (code) => {\n      if (code !== 0 && code !== null && stderrTail) {\n        log.warn('SearXNG stderr tail', { code, stderrTail: stderrTail.slice(-1024) });\n      }\n    });\n\n    writeFileSync(join(this.dataDir, 'searxng.port'), String(this.port));\n    // Update lock file with the resolved port so other instances can connect\n    writeFileSync(\n      join(this.dataDir, 'searxng.lock'),\n      JSON.stringify({ pid: process.pid, port: this.port, startedAt: new Date().toISOString() }),\n    );\n\n    const url = this.getUrl()!;\n    const healthy = await waitForHealth(url, HEALTH_TIMEOUT_MS);\n\n    if (!healthy) {\n      log.error('SearXNG failed to start within timeout');\n      await this.stop();\n      return null;\n    }\n\n    this.monitorCrashes();\n    this.startHealthProbe();\n    log.info('SearXNG started', { port: this.port, url });\n    return url;\n  }\n\n  private monitorCrashes(): void {\n    if (!this.child) return;\n\n    this.child.on('exit', (code) => {\n      if (this.stopped) return;\n\n      log.warn('SearXNG process exited unexpectedly', { code });\n      this.crashTimes.push(Date.now());\n\n      const cutoff = Date.now() - CRASH_WINDOW_MS;\n      this.crashTimes = this.crashTimes.filter(t => t > cutoff);\n\n      if (this.crashTimes.length >= MAX_CRASH_RESTARTS) {\n        log.error('too many crashes, giving up on SearXNG', { crashes: this.crashTimes.length });\n        releaseLock(this.dataDir);\n        if (!this.isCurrentlyUnhealthy) {\n          this.isCurrentlyUnhealthy = true;\n          this.callbacks.onUnhealthy?.(\n            `SearXNG process crashed ${this.crashTimes.length} times in ${CRASH_WINDOW_MS / 1000}s`,\n          );\n        }\n        return;\n      }\n\n      const backoff = Math.min(1000 * Math.pow(2, this.crashTimes.length - 1), 30000);\n      log.info('restarting SearXNG after backoff', { backoffMs: backoff });\n      setTimeout(() => {\n        if (!this.stopped) this.start();\n      }, backoff);\n    });\n  }\n\n  private startHealthProbe(): void {\n    if (this.healthProbeTimer) clearInterval(this.healthProbeTimer);\n    const config = getConfig();\n    const intervalMs = config.healthProbeIntervalMs;\n    this.healthProbeTimer = setInterval(() => {\n      void this.probeOnce();\n    }, intervalMs);\n  }\n\n  private async probeOnce(): Promise<void> {\n    if (this.stopped || !this.port) return;\n    try {\n      const r = await fetch(`http://127.0.0.1:${this.port}/healthz`, { signal: AbortSignal.timeout(2000) });\n      if (r.ok) {\n        this.healthProbeFailures = 0;\n        if (this.isCurrentlyUnhealthy) {\n          this.isCurrentlyUnhealthy = false;\n          this.callbacks.onHealthy?.();\n        }\n      } else {\n        this.notePotentialFailure();\n      }\n    } catch {\n      this.notePotentialFailure();\n    }\n  }\n\n  private notePotentialFailure(): void {\n    this.healthProbeFailures++;\n    if (this.healthProbeFailures === 3 && !this.isCurrentlyUnhealthy) {\n      this.isCurrentlyUnhealthy = true;\n      this.callbacks.onUnhealthy?.('SearXNG /healthz unreachable for 3 consecutive probes');\n    }\n  }\n\n  async stop(): Promise<void> {\n    if (this.healthProbeTimer) {\n      clearInterval(this.healthProbeTimer);\n      this.healthProbeTimer = null;\n    }\n    this.stopped = true;\n\n    if (this.child) {\n      this.child.kill('SIGTERM');\n\n      await Promise.race([\n        new Promise<void>((resolve) => this.child!.on('exit', resolve)),\n        new Promise<void>((resolve) => setTimeout(() => {\n          this.child?.kill('SIGKILL');\n          resolve();\n        }, SHUTDOWN_GRACE_MS)),\n      ]);\n\n      this.child = null;\n    }\n\n    releaseLock(this.dataDir);\n    this.port = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/server/backend-status.d.ts

@@ -0,0 +1,13 @@
+export declare class BackendStatus {
+    private _active;
+    private _reason;
+    private _warned;
+    private _bootstrapping;
+    get isActive(): boolean;
+    markUnhealthy(reason: string): void;
+    markBootstrapping(): void;
+    markHealthy(): void;
+    /** Returns warning text once per fallback session, then undefined. */
+    consumeWarning(): string | undefined;
+}
+//# sourceMappingURL=backend-status.d.ts.map

package/dist/server/backend-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-status.d.ts","sourceRoot":"","sources":["../../src/server/backend-status.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAE/B,IAAI,QAAQ,IAAI,OAAO,CAAyB;IAEhD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOnC,iBAAiB,IAAI,IAAI;IAOzB,WAAW,IAAI,IAAI;IAOnB,sEAAsE;IACtE,cAAc,IAAI,MAAM,GAAG,SAAS;CAgBrC"}

package/dist/server/backend-status.js

@@ -0,0 +1,40 @@
+class BackendStatus {
+  _active = false;
+  _reason;
+  _warned = false;
+  _bootstrapping = false;
+  get isActive() {
+    return this._active;
+  }
+  markUnhealthy(reason) {
+    this._active = false;
+    this._reason = reason;
+    this._warned = false;
+    this._bootstrapping = false;
+  }
+  markBootstrapping() {
+    this._active = false;
+    this._reason = "bootstrap in progress";
+    this._warned = false;
+    this._bootstrapping = true;
+  }
+  markHealthy() {
+    this._active = true;
+    this._reason = void 0;
+    this._warned = false;
+    this._bootstrapping = false;
+  }
+  /** Returns warning text once per fallback session, then undefined. */
+  consumeWarning() {
+    if (this._active || this._warned) return void 0;
+    this._warned = true;
+    if (this._bootstrapping) {
+      return `Search engine is still starting up. Results may be lower quality until setup finishes. For best results, run: \`npx @staticn0va/wigolo warmup --all\` before connecting your agent.`;
+    }
+    return `Multi-engine search is unavailable; using fallback engines (lower quality). Reason: ${this._reason ?? "unknown"}. To retry: \`npx @staticn0va/wigolo warmup --force\`. For details: \`npx @staticn0va/wigolo doctor\`.`;
+  }
+}
+export {
+  BackendStatus
+};
+//# sourceMappingURL=backend-status.js.map

package/dist/server/backend-status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/backend-status.ts"],"sourcesContent":["export class BackendStatus {\n  private _active = false;\n  private _reason: string | undefined;\n  private _warned = false;\n  private _bootstrapping = false;\n\n  get isActive(): boolean { return this._active; }\n\n  markUnhealthy(reason: string): void {\n    this._active = false;\n    this._reason = reason;\n    this._warned = false;\n    this._bootstrapping = false;\n  }\n\n  markBootstrapping(): void {\n    this._active = false;\n    this._reason = 'bootstrap in progress';\n    this._warned = false;\n    this._bootstrapping = true;\n  }\n\n  markHealthy(): void {\n    this._active = true;\n    this._reason = undefined;\n    this._warned = false;\n    this._bootstrapping = false;\n  }\n\n  /** Returns warning text once per fallback session, then undefined. */\n  consumeWarning(): string | undefined {\n    if (this._active || this._warned) return undefined;\n    this._warned = true;\n    if (this._bootstrapping) {\n      return (\n        `Search engine is still starting up. Results may be lower quality until setup finishes. ` +\n        `For best results, run: \\`npx @staticn0va/wigolo warmup --all\\` before connecting your agent.`\n      );\n    }\n    return (\n      `Multi-engine search is unavailable; using fallback engines (lower quality). ` +\n      `Reason: ${this._reason ?? 'unknown'}. ` +\n      `To retry: \\`npx @staticn0va/wigolo warmup --force\\`. ` +\n      `For details: \\`npx @staticn0va/wigolo doctor\\`.`\n    );\n  }\n}\n"],"mappings":"AAAO,MAAM,cAAc;AAAA,EACjB,UAAU;AAAA,EACV;AAAA,EACA,UAAU;AAAA,EACV,iBAAiB;AAAA,EAEzB,IAAI,WAAoB;AAAE,WAAO,KAAK;AAAA,EAAS;AAAA,EAE/C,cAAc,QAAsB;AAClC,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,oBAA0B;AACxB,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,cAAoB;AAClB,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA;AAAA,EAGA,iBAAqC;AACnC,QAAI,KAAK,WAAW,KAAK,QAAS,QAAO;AACzC,SAAK,UAAU;AACf,QAAI,KAAK,gBAAgB;AACvB,aACE;AAAA,IAGJ;AACA,WACE,uFACW,KAAK,WAAW,SAAS;AAAA,EAIxC;AACF;","names":[]}