totem-llm 0.3.2 → 0.3.4

package/README.md

@@ -27,7 +27,7 @@ This downloads Totem LLM and installs all server and collector dependencies auto
 totem-llm start
 ```
 
-On first run this performs one-time setup (creates `~/totem-llm/`, migrates the database) then launches the server and document collector. Open [http://localhost:3001](http://localhost:3001) to access the UI.
+On first run this performs one-time setup (creates `~/totem-llm/`, migrates the database) then launches the server and document collector. Open [http://localhost:8686](http://localhost:8686) to access the UI.
 
 ### 3. Install to Desktop (optional)
 
@@ -37,7 +37,7 @@ In the browser, click the install icon in the address bar (or use the browser me
 
 ```
 totem-llm --no-collector    Start without the document collector
-totem-llm --port=8080       Override the server port (default: 3001)
+totem-llm --port=8080       Override the server port (default: 8686)
 totem-llm setup             Run first-time setup without starting
 totem-llm --help            Show all options
 ```
@@ -102,7 +102,7 @@ All other settings (LLM provider, embedding model, etc.) can be changed later th
 yarn dev:all
 ```
 
-This starts the server (port `3001`), collector (port `8888`), and frontend dev server (port `5173`) concurrently. Open [http://localhost:5173](http://localhost:5173) to access the UI.
+This starts the server (port `8686`), collector (port `8888`), and frontend dev server (port `5173`) concurrently. Open [http://localhost:5173](http://localhost:5173) to access the UI.
 
 > Alternatively, run each service in its own terminal: `yarn dev:server`, `yarn dev:collector`, `yarn dev:frontend`.
 

package/bin/totem-llm.js

@@ -75,7 +75,7 @@ Commands:
 
 Options:
   --no-collector   Start without the document collector (skips Puppeteer/ffmpeg)
-  --port=<port>    Override the server port (default: 3001)
+  --port=<port>    Override the server port (default: 8686)
   --version, -v    Print Totem LLM version and exit
   --force          (setup only) Regenerate configuration even if it already exists
 

package/lib/launcher.js

@@ -1,18 +1,21 @@
 import { spawn } from "child_process";
 import { join } from "path";
+import { appendFileSync, mkdirSync, writeFileSync } from "fs";
 import { getEnv } from "./config.js";
 import { getPackageVersion } from "./version.js";
 
 /**
  * Spawn a Node.js service and prefix every log line with a fixed-width label.
+ * Also writes all logs to a session log file.
  *
  * @param {string}   nodeExe     Absolute path to the Node binary (process.execPath)
  * @param {string}   cwd         Working directory for the child process
  * @param {object}   env         Environment variables to pass to the child
  * @param {string}   label       Log prefix, e.g. "[server]   "
+ * @param {string}   logFile     Path to the session log file
  * @returns {{ process: import('child_process').ChildProcess }}
  */
-function spawnService(nodeExe, cwd, env, label) {
+function spawnService(nodeExe, cwd, env, label, logFile) {
   const child = spawn(nodeExe, ["index.js"], {
     cwd,
     env,
@@ -22,17 +25,19 @@ function spawnService(nodeExe, cwd, env, label) {
   const pad = label.padEnd(13);
   let buf = "";
 
-  function flush(stream, chunk) {
+  function flush(chunk) {
     buf += chunk.toString();
     const lines = buf.split("\n");
     buf = lines.pop(); // keep any incomplete trailing line
     for (const line of lines) {
-      if (line.trim()) stream.write(`${pad} ${line}\n`);
+      if (line.trim()) {
+        appendFileSync(logFile, `${pad} ${line}\n`);
+      }
     }
   }
 
-  child.stdout.on("data", (c) => flush(process.stdout, c));
-  child.stderr.on("data", (c) => flush(process.stderr, c));
+  child.stdout.on("data", (c) => flush(c));
+  child.stderr.on("data", (c) => flush(c));
 
   return child;
 }
@@ -52,27 +57,43 @@ export async function launch({ packageRoot, noCollector = false, port } = {}) {
     appVersion = getPackageVersion(packageRoot) ?? "unknown";
   } catch {}
 
-  const serverPort = env.SERVER_PORT ?? "3001";
+  const serverPort = env.SERVER_PORT ?? "8686";
   const collectorPort = env.COLLECTOR_PORT ?? "8888";
   const nodeExe = process.execPath; // cross-platform: always the right Node binary
 
   const serverDir = join(packageRoot, "server");
   const collectorDir = join(packageRoot, "collector");
 
-  console.log("Starting Totem LLM…");
-  console.log(`  Version    → ${appVersion}`);
-  console.log(`  Server     → http://localhost:${serverPort}`);
-  if (!noCollector) {
-    console.log(`  Collector  → http://localhost:${collectorPort}`);
-  }
-  console.log(`  Storage    → ${env.STORAGE_DIR}`);
-  console.log("\nPress Ctrl+C to stop.\n");
-
-  const serverProc = spawnService(nodeExe, serverDir, env, "[server]");
+  // Initialize session log file - clear on each startup
+  const logsDir = join(serverDir, "storage", "logs");
+  mkdirSync(logsDir, { recursive: true });
+  const sessionLogFile = join(logsDir, "totem-session.log");
+  writeFileSync(sessionLogFile, `${"=".repeat(80)}\nSession started: ${new Date().toISOString()}\n${"=".repeat(80)}\n`);
+
+  process.stdout.write(`
+████████╗ ██████╗ ████████╗███████╗███╗   ███╗    ██╗     ██╗     ███╗   ███╗
+╚══██╔══╝██╔═══██╗╚══██╔══╝██╔════╝████╗ ████║    ██║     ██║     ████╗ ████║
+   ██║   ██║   ██║   ██║   █████╗  ██╔████╔██║    ██║     ██║     ██╔████╔██║
+   ██║   ██║   ██║   ██║   ██╔══╝  ██║╚██╔╝██║    ██║     ██║     ██║╚██╔╝██║
+   ██║   ╚██████╔╝   ██║   ███████╗██║ ╚═╝ ██║    ███████╗███████╗██║ ╚═╝ ██║
+   ╚═╝    ╚═════╝    ╚═╝   ╚══════╝╚═╝     ╚═╝    ╚══════╝╚══════╝╚═╝     ╚═╝
+
+   Your Private AI
+    
+    
+    Starting Totem LLM…\n
+    ============================================================================\n
+    Logs → ${sessionLogFile}\n
+    LAUNCH UI HERE (ctrl + click)--> http://localhost:${serverPort}/\n
+    
+      Press Ctrl+C to stop.\n
+    `);
+
+  const serverProc = spawnService(nodeExe, serverDir, env, "[server]", sessionLogFile);
 
   let collectorProc = null;
   if (!noCollector) {
-    collectorProc = spawnService(nodeExe, collectorDir, env, "[collector]");
+    collectorProc = spawnService(nodeExe, collectorDir, env, "[collector]", sessionLogFile);
   }
 
   // ── Graceful shutdown ────────────────────────────────────────────────────
@@ -82,7 +103,10 @@ export async function launch({ packageRoot, noCollector = false, port } = {}) {
     if (shuttingDown) return;
     shuttingDown = true;
 
-    console.log(`\nShutting down (${signal})…`);
+    const shutdownMsg = `\nShutting down (${signal})…`;
+    process.stdout.write(`${shutdownMsg}\n`);
+    appendFileSync(sessionLogFile, `${shutdownMsg}\n`);
+    
     serverProc.kill("SIGTERM");
     if (collectorProc) collectorProc.kill("SIGTERM");
 
@@ -102,7 +126,9 @@ export async function launch({ packageRoot, noCollector = false, port } = {}) {
   // Exit this process when the server exits unexpectedly
   serverProc.on("close", (code) => {
     if (!shuttingDown && code !== null && code !== 0) {
-      console.error(`[server] exited unexpectedly with code ${code}`);
+      const errMsg = `[server] exited unexpectedly with code ${code}`;
+      process.stderr.write(`${errMsg}\n`);
+      appendFileSync(sessionLogFile, `${errMsg}\n`);
       shutdown("server-exit");
       setTimeout(() => process.exit(1), 500);
     }
@@ -111,9 +137,9 @@ export async function launch({ packageRoot, noCollector = false, port } = {}) {
   if (collectorProc) {
     collectorProc.on("close", (code) => {
       if (!shuttingDown && code !== null && code !== 0) {
-        console.error(
-          `[collector] exited with code ${code} — document ingestion unavailable`
-        );
+        const errMsg = `[collector] exited with code ${code} — document ingestion unavailable`;
+        process.stderr.write(`${errMsg}\n`);
+        appendFileSync(sessionLogFile, `${errMsg}\n`);
       }
     });
   }

package/lib/setup.js

@@ -28,7 +28,7 @@ function buildEnvFile(storageDir) {
     "# Edit this file to configure your instance, then restart.",
     "",
     `STORAGE_DIR="${storageDir}"`,
-    "SERVER_PORT=3001",
+    "SERVER_PORT=8686",
     "COLLECTOR_PORT=8888",
     "",
     "# Security secrets (auto-generated — do not share these)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "totem-llm",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Totem LLM – Your Private AI. Run a self-hosted AI assistant locally on Linux, macOS, or Windows.",
   "main": "bin/totem-llm.js",
   "type": "module",

package/server/.env

@@ -1,4 +1,4 @@
-SERVER_PORT=3001
+SERVER_PORT=8686
 DATABASE_URL="file:../storage/anythingllm.db"
 JWT_SECRET="my-random-string-for-seeding" # Please generate random string at least 12 chars long.
 # JWT_EXPIRY="30d" # (optional) https://docs.anythingllm.com/configuration#custom-ttl-for-sessions

package/server/endpoints/features.js

@@ -0,0 +1,22 @@
+const { resolveFeatures } = require("../../totem.features.cjs");
+
+function featureEndpoints(app) {
+  if (!app) return;
+
+  /**
+   * GET /api/features
+   * Returns the resolved feature flags for the current build profile.
+   * This is the runtime source of truth for the frontend.
+   */
+  app.get("/features", (_, response) => {
+    try {
+      const features = resolveFeatures();
+      return response.status(200).json({ features });
+    } catch (e) {
+      console.error("[features] Failed to resolve features:", e.message);
+      return response.status(500).json({ features: {}, error: e.message });
+    }
+  });
+}
+
+module.exports = { featureEndpoints };

package/server/index.js

@@ -54,6 +54,7 @@ const {
   googleAgentSkillEndpoints,
 } = require("./endpoints/utils/googleAgentSkillEndpoints");
 const { memoryEndpoints } = require("./endpoints/memory");
+const { featureEndpoints } = require("./endpoints/features");
 const { httpLogger } = require("./middleware/httpLogger");
 const app = express();
 const apiRouter = express.Router();
@@ -81,7 +82,7 @@ app.use(
 );
 
 if (!!process.env.ENABLE_HTTPS) {
-  bootSSL(app, process.env.SERVER_PORT || 3001);
+  bootSSL(app, process.env.SERVER_PORT || 8686);
 } else {
   require("@mintplex-labs/express-ws").default(app); // load WebSockets in non-SSL mode.
 }
@@ -113,6 +114,7 @@ scheduledJobEndpoints(apiRouter);
 outlookAgentEndpoints(apiRouter);
 googleAgentSkillEndpoints(apiRouter);
 memoryEndpoints(apiRouter);
+featureEndpoints(apiRouter);
 // Externally facing embedder endpoints
 embeddedEndpoints(apiRouter);
 
@@ -185,4 +187,4 @@ app.all("*", function (_, response) {
 
 // In non-https mode we need to boot at the end since the server has not yet
 // started and is `.listen`ing.
-if (!process.env.ENABLE_HTTPS) bootHTTP(app, process.env.SERVER_PORT || 3001);
+if (!process.env.ENABLE_HTTPS) bootHTTP(app, process.env.SERVER_PORT || 8686);

package/server/models/mobileDevice.js

@@ -100,7 +100,7 @@ const MobileDevice = {
     let baseUrl = "/api/mobile";
     if (process.env.NODE_ENV === "production") baseUrl = "/api/mobile";
     else
-      baseUrl = `http://${ip.address()}:${process.env.SERVER_PORT || 3001}/api/mobile`;
+      baseUrl = `http://${ip.address()}:${process.env.SERVER_PORT || 8686}/api/mobile`;
 
     const tempToken = this.registerTempToken(user);
     baseUrl = `${baseUrl}?t=${tempToken}`;

package/server/models/systemSettings.js

@@ -36,7 +36,7 @@ function mergeStringField(target, source, fieldName, validator = null) {
 const SystemSettings = {
   /** A default system prompt that is used when no other system prompt is set or available to the function caller. */
   saneDefaultSystemPrompt:
-    "You are Totem LLM. You are an AI that prioritizes consistent behavior with your history.",
+    "You are Totem LLM. You are an AI that prioritizes consistent behavior with your history. The current date and time is {datetime}.",
   protectedFields: ["multi_user_mode", "hub_api_key", "onboarding_complete"],
   publicFields: [
     "footer_data",