levix-bot 3.0.0-beta → 3.2.0-beta

package/app.cjs

@@ -292,6 +292,12 @@ app.get("/", noStore, (req, res) => {
   return res.render("login", { error: null });
 });
 
+app.get("/login", noStore, (req, res) => {
+  if (!secrets.hasDashboardPassword()) return res.redirect("/setup");
+  if (req.session.loggedIn) return res.redirect("/");
+  return res.render("login", { error: null });
+});
+
 app.post("/login", (req, res, next) => {
   if (!secrets.hasDashboardPassword()) return res.redirect("/setup");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "levix-bot",
-  "version": "3.0.0-beta",
+  "version": "3.2.0-beta",
   "description": "A self-hosted personal WhatsApp bot with an AI agent, group moderation and a web control panel.",
   "main": "src/index.js",
   "scripts": {

package/public/dashboard.js

@@ -391,6 +391,19 @@
 
     $("#conn-detail").textContent = (snapshot.detail || "") + retryHint(snapshot);
 
+    const alertBox = $("#conn-disconnect-alert");
+    const alertText = $("#conn-disconnect-text");
+    if (alertBox && alertText) {
+      if (snapshot.lastDisconnect?.statusCode && snapshot.state !== "connected" && snapshot.state !== "idle") {
+        const code = snapshot.lastDisconnect.statusCode;
+        const reason = snapshot.lastDisconnect.reason || "Unknown";
+        alertText.innerHTML = `⚠️ <strong>Connection failure (${esc(code)}: ${esc(reason)})</strong> — check network connectivity or proxy settings.`;
+        alertBox.style.display = "block";
+      } else {
+        alertBox.style.display = "none";
+      }
+    }
+
     // The proxy line, and the one action that can apply a changed one. The
     // label is already redacted server-side — there is no password to leak
     // here because the browser was never told it.

package/src/bootstrap/panel.js

@@ -7,10 +7,21 @@
 import { createRequire } from "module";
 
 const require = createRequire(import.meta.url);
+const fs = require("node:fs");
 const logger = require("../utils/logger.cjs");
 const settings = require("../config/settings.cjs");
+const paths = require("../config/paths.cjs");
 const { attach } = require("./events.cjs");
 
+/** Unix socket path for the Android host. Bionic Node cannot bind TCP. */
+export function androidPanelSocketPath() {
+  return paths.dataPath("panel.sock");
+}
+
+export function isAndroidHost() {
+  return process.env.LEVIX_ANDROID === "1";
+}
+
 /**
  * Start the panel and bind its port.
  *
@@ -55,6 +66,7 @@ export async function bootstrapPanel({ core } = {}) {
 
   const port = settings.get("port");
   const host = resolveBindAddress();
+  const androidSock = isAndroidHost() ? androidPanelSocketPath() : null;
 
   await new Promise((resolve, reject) => {
     // "EADDRINUSE" plus a stack trace is not an answer anyone can act on, and
@@ -72,10 +84,19 @@ export async function bootstrapPanel({ core } = {}) {
       }
       reject(error);
     });
-    server.listen(port, host, resolve);
+    if (androidSock) {
+      try {
+        fs.unlinkSync(androidSock);
+      } catch {
+        // first run has no leftover socket
+      }
+      server.listen(androidSock, resolve);
+    } else {
+      server.listen(port, host, resolve);
+    }
   });
 
-  return { port, host, server };
+  return { port, host, server, socketPath: androidSock };
 }
 
 /**
@@ -89,15 +110,18 @@ export async function bootstrapPanel({ core } = {}) {
 export function resolveBindAddress() {
   const configured = settings.get("bind_address");
   if (configured) return configured;
-  // The phone is the host: keep the panel on loopback until a later phase
-  // opens it in a WebView. LAN bind stays an explicit setting.
-  if (process.env.LEVIX_ANDROID === "1") return "127.0.0.1";
+  // Desktop / Docker: every interface. Android never reaches this — it
+  // binds a unix socket instead (see androidPanelSocketPath). The WebView
+  // still opens http://127.0.0.1:port and the host serves that over the socket.
   return "0.0.0.0";
 }
 
 /** The address a person should type, given how this install is reachable. */
 export function panelUrl({ port, firstRun = false } = {}) {
   const domain = settings.get("public_domain");
-  const base = domain ? `https://${domain}` : `http://localhost:${port}`;
+  const host =
+    domain ||
+    (isAndroidHost() ? "127.0.0.1" : "localhost");
+  const base = domain ? `https://${host}` : `http://${host}:${port}`;
   return firstRun ? `${base}/setup` : base;
 }

package/src/commands/tts.cjs

@@ -22,15 +22,7 @@ const { sendBotMessage } = require("../utils/sendBotMessage.cjs");
 
 const execFileAsync = promisify(execFile);
 
-let ffmpegStatic = null;
-try {
-  ffmpegStatic = require("ffmpeg-static");
-} catch (err) {
-  logger.warn(
-    { err: err?.message },
-    "[TTS] ffmpeg unavailable — will fall back to raw MP3"
-  );
-}
+const { ffmpegPath } = require("../utils/thumbnail.cjs");
 
 function tmpPath(ext) {
   return path.join(
@@ -56,37 +48,45 @@ async function synthesizeMp3(text, mp3Path) {
 }
 
 async function transcodeToOpus(mp3Path) {
-  if (!ffmpegStatic) return null;
+  const bin = ffmpegPath();
+  if (!bin) return null;
 
   const oggPath = tmpPath("ogg");
-  await execFileAsync(
-    ffmpegStatic,
-    [
-      "-hide_banner",
-      "-loglevel",
-      "error",
-      "-y",
-      "-i",
-      mp3Path,
-      "-vn",
-      "-c:a",
-      "libopus",
-      "-ac",
-      "1",
-      "-ar",
-      "48000",
-      "-b:a",
-      "48k",
-      "-application",
-      "voip",
-      "-f",
-      "ogg",
-      oggPath,
-    ],
-    { windowsHide: true, timeout: 30_000 },
-  );
-
-  return oggPath;
+  try {
+    await execFileAsync(
+      bin,
+      [
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-y",
+        "-i",
+        mp3Path,
+        "-vn",
+        "-c:a",
+        "libopus",
+        "-ac",
+        "1",
+        "-ar",
+        "48000",
+        "-b:a",
+        "48k",
+        "-application",
+        "voip",
+        "-f",
+        "ogg",
+        oggPath,
+      ],
+      { windowsHide: true, timeout: 30_000 },
+    );
+    return oggPath;
+  } catch (err) {
+    logger.warn(
+      { err: err?.message, bin },
+      "[TTS] ffmpeg transcode failed — will fall back to raw MP3"
+    );
+    return null;
+  }
 }
 
 module.exports = {

package/src/core/session.js

@@ -124,6 +124,7 @@ export const SESSION_STATES = Object.freeze({
   LINKING: "linking",
   CONNECTED: "connected",
   RECONNECTING: "reconnecting",
+  PAUSED: "paused",
   DISCONNECTED: "disconnected",
   RETRY_EXHAUSTED: "retry_exhausted",
   LOGGED_OUT: "logged_out",
@@ -139,6 +140,7 @@ const BUSY_STATES = new Set([
   S.LINKING,
   S.CONNECTED,
   S.RECONNECTING,
+  S.PAUSED,
 ]);
 
 /** What the dashboard's status pill has always been told. Kept stable. */
@@ -148,6 +150,7 @@ function legacyStatus(state, hasQr) {
   if (state === S.STARTING) return "Connecting";
   if (state === S.LINKING) return "Linking";
   if (state === S.RECONNECTING) return "Reconnecting";
+  if (state === S.PAUSED) return "Paused (Offline)";
   return "Disconnected";
 }
 
@@ -195,6 +198,8 @@ export class WhatsAppSession {
   #reason = null;
   #detail = null;
   #lastDisconnect = null;
+  #isOnline = true;
+  #wasActiveBeforeOffline = false;
 
   constructor({
     createSocket = createWhatsAppSocket,
@@ -290,6 +295,7 @@ export class WhatsAppSession {
       // answer crosses the wire, never the fingerprint it was computed from.
       proxyChanged: this.#proxyIsStale(),
       connected: this.#state === S.CONNECTED,
+      isOnline: this.#isOnline,
       terminal,
       hasQr: !!this.#qr,
       hasPairingCode: !!this.#pairingCode,
@@ -309,6 +315,52 @@ export class WhatsAppSession {
   // commands
   // -------------------------------------------------------------------------
 
+  /**
+   * Set device internet connectivity state.
+   *
+   * When offline (false):
+   * - Pauses active connection attempts and cancels pending retry timers.
+   * - Transitions to S.PAUSED without exhausting retries.
+   *
+   * When online (true):
+   * - Restores connection if it was active before going offline or currently paused.
+   * - Resets the retry attempt counter so a fresh retry ladder is available.
+   */
+  async setInternetOnline(online, { reason = "network" } = {}) {
+    const isOnline = !!online;
+    if (this.#isOnline === isOnline) return this.getState();
+    this.#isOnline = isOnline;
+
+    if (!isOnline) {
+      this.log.warn("[Session] Device is offline — pausing WhatsApp connection and retries");
+      this.#wasActiveBeforeOffline =
+        BUSY_STATES.has(this.#state) || this.#state === S.PAUSED;
+      this.#cancelRetry();
+
+      if (this.#socket) {
+        await this.#destroySocket();
+      }
+      this.#transition(S.PAUSED, {
+        reason: "offline",
+        detail: "Device is offline. Connection and retries are paused until internet is restored.",
+      });
+      return this.getState();
+    }
+
+    this.log.info("[Session] Device is back online — restoring WhatsApp connection");
+    if (this.#wasActiveBeforeOffline || this.#state === S.PAUSED) {
+      this.#wasActiveBeforeOffline = false;
+      this.#attempt = 0;
+      this.#cancelRetry();
+      await this.start({ reason: "network_restored" });
+    }
+    return this.getState();
+  }
+
+  get isOnline() {
+    return this.#isOnline;
+  }
+
   /**
    * Bring the session up. Idempotent: if a socket exists or is being made, this
    * returns the state it is already in and creates nothing.
@@ -316,11 +368,15 @@ export class WhatsAppSession {
   async start({ reason = "manual", method, phone } = {}) {
     if (this.#shuttingDown) return this.getState();
 
+    if (this.#state === S.PAUSED && !this.#isOnline) {
+      return this.getState();
+    }
+
     if (this.#starting) {
       await this.#starting.catch(() => {});
       return this.getState();
     }
-    if (BUSY_STATES.has(this.#state)) return this.getState();
+    if (BUSY_STATES.has(this.#state) && this.#state !== S.PAUSED) return this.getState();
 
     this.#pairingIntent = parseStartOptions({ method, phone });
 
@@ -451,6 +507,15 @@ export class WhatsAppSession {
   // -------------------------------------------------------------------------
 
   async #open({ reason }) {
+    if (!this.#isOnline) {
+      this.#wasActiveBeforeOffline = true;
+      this.#transition(S.PAUSED, {
+        reason: "offline",
+        detail: "Device is offline. Connection and retries are paused until internet is restored.",
+      });
+      return;
+    }
+
     // Whatever code was on offer belonged to the previous attempt.
     this.#clearQr();
     this.#transition(S.STARTING, { reason });
@@ -790,13 +855,23 @@ export class WhatsAppSession {
 
     if (this.#shuttingDown) return;
 
+    if (!this.#isOnline) {
+      this.#wasActiveBeforeOffline = true;
+      this.#cancelRetry();
+      return this.#transition(S.PAUSED, {
+        reason: "offline",
+        detail: `Connection closed (${statusCode ?? "no status"}: ${reasonText}). Paused until internet is restored.`,
+      });
+    }
+
     if (verdict.loggedOut) return this.#handleLoggedOut(verdict, closedSocket);
     if (verdict.terminal) {
       this.#clearQr();
       this.#pairing = false;
+      const codeInfo = this.#lastDisconnect?.statusCode ? ` (${this.#lastDisconnect.statusCode}: ${this.#lastDisconnect.reason})` : "";
       return this.#transition(S.DISCONNECTED, {
         reason: verdict.reason,
-        detail: verdict.detail,
+        detail: `${verdict.detail || ""}${codeInfo}`.trim(),
       });
     }
 
@@ -805,9 +880,10 @@ export class WhatsAppSession {
     if (this.#pairing && !verdict.restartRequired) {
       this.#pairing = false;
       this.#clearQr();
+      const codeInfo = this.#lastDisconnect?.statusCode ? ` (${this.#lastDisconnect.statusCode}: ${this.#lastDisconnect.reason})` : "";
       return this.#transition(S.DISCONNECTED, {
         reason: "pairing_cancelled",
-        detail: "The pairing attempt ended before the code was scanned. Start a session to try again.",
+        detail: `The pairing attempt ended before the code was scanned${codeInfo}. Start a session to try again.`,
       });
     }
 
@@ -846,6 +922,15 @@ export class WhatsAppSession {
   // -------------------------------------------------------------------------
 
   #scheduleRetry(verdict) {
+    if (!this.#isOnline) {
+      this.#wasActiveBeforeOffline = true;
+      this.#cancelRetry();
+      return this.#transition(S.PAUSED, {
+        reason: "offline",
+        detail: "Device is offline. Connection and retries are paused until internet is restored.",
+      });
+    }
+
     // Never two timers. A close that arrives while one is pending replaces it
     // rather than adding to it.
     this.#cancelRetry();
@@ -855,9 +940,10 @@ export class WhatsAppSession {
         `[Session] ${this.retryDelaysMs.length} reconnect attempts failed. Levix stays up; start the session again from the panel.`
       );
       this.#clearQr();
+      const codeInfo = this.#lastDisconnect?.statusCode ? ` (${this.#lastDisconnect.statusCode}: ${this.#lastDisconnect.reason})` : "";
       return this.#transition(S.RETRY_EXHAUSTED, {
         reason: "retry_exhausted",
-        detail: `Gave up after ${this.retryDelaysMs.length} attempts. Start the session to try again.`,
+        detail: `Gave up after ${this.retryDelaysMs.length} attempts${codeInfo}. Start the session to try again.`,
       });
     }
 
@@ -869,17 +955,12 @@ export class WhatsAppSession {
       `[Session] Reconnecting in ${Math.round(delayMs / 1000)}s (attempt ${this.#attempt}/${this.retryDelaysMs.length})`
     );
 
+    const codeInfo = this.#lastDisconnect?.statusCode ? ` (${this.#lastDisconnect.statusCode}: ${this.#lastDisconnect.reason})` : "";
     this.#transition(S.RECONNECTING, {
       reason: verdict.reason,
-      // The close's own explanation first: a 515 straight after a scan is
-      // WhatsApp asking for a fresh connection, not a failed attempt, and
-      // "attempt 1 of 5" on its own reads like something went wrong.
-      // No countdown in here: this string is baked once, at schedule time, and
-      // would go on claiming "in 5s" for the whole wait. The panel renders the
-      // remaining seconds from nextRetryAt, which actually ticks.
       detail:
         `${verdict.detail ? `${verdict.detail} ` : ""}` +
-        `Reconnecting (attempt ${this.#attempt} of ${this.retryDelaysMs.length}).`,
+        `Reconnecting (attempt ${this.#attempt} of ${this.retryDelaysMs.length})${codeInfo}.`,
     });
 
     this.#retryTimer = setTimeout(() => {

package/src/index.js

@@ -41,6 +41,10 @@ function short(path) {
 // soon as the core is up.
 let liveSession = null;
 
+export function getLiveSession() {
+  return liveSession;
+}
+
 /**
  * Start Levix.
  *
@@ -194,9 +198,16 @@ async function startWithPanel({ open }) {
   try {
     panel = await bootstrapPanel({ core });
   } catch (error) {
-    if (error.code === "EADDRINUSE") {
+    if (error.code === "EADDRINUSE" || error.code === "ECONNREFUSED") {
       console.error(`\n  ${error.message}\n`);
       logger.error(error.message);
+      if (process.env.LEVIX_ANDROID === "1") {
+        // WhatsApp still works without the panel. process.exit here also
+        // trips pino's sonic-boom ("not ready yet") as a second crash.
+        console.log("Panel failed " + (error.code || error.message));
+        console.log("Levix ready");
+        return { ...core, panel: null, url: null };
+      }
       process.exit(1);
     }
     throw error;

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

@@ -912,6 +912,21 @@ router.post(
   })
 );
 
+router.post(
+  "/bot/session/network",
+  asyncRoute(async (req, res) => {
+    if (!session) {
+      return res.status(503).json({ success: false, error: "Session manager is not ready" });
+    }
+    const { online } = req.body || {};
+    if (typeof online !== "boolean") {
+      return badRequest(res, "online (boolean) is required");
+    }
+    const state = await session.setInternetOnline(online);
+    res.json({ success: true, session: state });
+  })
+);
+
 // Unlink the WhatsApp account: WhatsApp drops the companion device and the
 // stored credentials go with it. Levix stays up, and the operator can start a
 // fresh pairing whenever they want one.

package/src/utils/requestOrigin.cjs

@@ -78,7 +78,10 @@ function hasForwardingHeader(headers = {}) {
  * the right key for rate limiting a password or setup-code guess.
  */
 function clientAddress(req) {
-  return req?.socket?.remoteAddress || req?.connection?.remoteAddress || "";
+  const addr = req?.socket?.remoteAddress || req?.connection?.remoteAddress;
+  if (addr) return addr;
+  if (process.env.LEVIX_ANDROID === "1") return "127.0.0.1";
+  return "";
 }
 
 /**

package/src/utils/thumbnail.cjs

@@ -48,9 +48,22 @@ const ffmpegStatic = (() => {
 })();
 
 // Read at call time so the dashboard can point at another binary without a
-// restart; ffmpeg-static is what ships with the bot and works nearly everywhere.
+// restart; ffmpeg-static is what ships with the bot on desktop/docker.
+// On Android, check LEVIX_FFMPEG_PATH or libffmpeg.so in nativeLibraryDir (LD_LIBRARY_PATH).
 function ffmpegBin() {
-  return settings.get("ffmpeg_path") || ffmpegStatic || "ffmpeg";
+  const configured = settings.get("ffmpeg_path");
+  if (configured) return configured;
+  if (process.env.LEVIX_FFMPEG_PATH && fs.existsSync(process.env.LEVIX_FFMPEG_PATH)) {
+    return process.env.LEVIX_FFMPEG_PATH;
+  }
+  if (process.env.FFMPEG_PATH && fs.existsSync(process.env.FFMPEG_PATH)) {
+    return process.env.FFMPEG_PATH;
+  }
+  if (process.env.LEVIX_ANDROID === "1" && process.env.LD_LIBRARY_PATH) {
+    const androidBin = path.join(process.env.LD_LIBRARY_PATH, "libffmpeg.so");
+    if (fs.existsSync(androidBin)) return androidBin;
+  }
+  return ffmpegStatic || "ffmpeg";
 }
 const FFMPEG_TIMEOUT_MS = 20000;
 

package/views/dashboard.ejs

@@ -316,6 +316,9 @@
               </div>
 
               <div class="hint session-detail" id="conn-detail"></div>
+              <div id="conn-disconnect-alert" class="session-error-callout" style="display: none; margin-top: 10px; padding: 10px 14px; border-radius: 8px; background: rgba(239, 68, 68, 0.12); color: #ef4444; font-size: 13px; font-weight: 500; border: 1px solid rgba(239, 68, 68, 0.25);">
+                <span id="conn-disconnect-text"></span>
+              </div>
 
               <div class="hint" id="conn-proxy"></div>