friend-assistant 0.1.2 → 0.1.4

package/README.md

@@ -51,7 +51,7 @@ Every command starts with `friend`. If you run Friend from the source code, writ
 
 | Command | What it does | Use it when |
 |---|---|---|
-| `friend start` | Starts Friend: the web app, the assistant, the speech engine if installed, and your connectors. Prints the address (and your network address when that is on). Ctrl+C stops it. | Every day. Open the address in a browser and sign in. |
+| `friend start` | Starts Friend: the web app, the assistant, the speech engine if installed, and your connectors. Prints the address (and your network address when that is on). Ctrl+C stops it. Friend's screen works in one browser window at a time: open it in a second place and that window shows "Use here", which moves Friend there and stops the first. | Every day. Open the address in a browser and sign in. |
 | `friend pair` | Prints a one-time pairing code, valid for 5 minutes, and the command to run on the other PC. | You want Friend to also work on a second PC. |
 | `friend node --url ws://HOST:8787/device --code CODE` | Run on the other PC: connects it to your Friend. Add `--roots C:/work,D:/files` for the folders it may use freely and `--name laptop` to name it. | The second step after `friend pair`. |
 | `friend devices list` | Lists the paired PCs and when each was last seen. | Checking what is connected. |
@@ -85,6 +85,10 @@ Every command starts with `friend`. If you run Friend from the source code, writ
 
 | Command | What it does | Use it when |
 |---|---|---|
+| `friend daemon start` | Runs Friend in the background, with no terminal window needed. Prints the address, keeps a log in the data folder (`friend.log`). | You want Friend always available, even after you close the terminal. |
+| `friend daemon stop` | Stops the background Friend and the speech engine with it. | Shutting it down. |
+| `friend daemon restart` | Stops it and starts it again. | After changing a setting such as `friend lan on` or a different model. |
+| `friend daemon status` | Says whether the background Friend is running, for how long, and at which address. Exit code 0 when running, 1 when not. | Checking, or in a script. |
 | `friend lan` (or `friend lan status`) | Shows what Friend listens on and the addresses to open. | Checking, or finding the address for your phone. |
 | `friend lan on` | Lets other devices on your network open Friend. Prints the addresses and the things to know (plain http, no microphone on other devices, firewall prompt). | Using Friend from a phone or another PC. |
 | `friend lan on --https` | The same, with a secure `https://` address (Friend makes its own certificate), so a phone may use the microphone and camera. | Talking to Friend from a phone. |

package/dist/BUILD.json

@@ -1,5 +1,5 @@
 {
   "name": "friend-assistant",
-  "version": "0.1.2",
-  "builtAt": "2026-10-08T15:13:28.077Z"
+  "version": "0.1.4",
+  "builtAt": "2026-10-09T05:21:33.354Z"
 }

package/dist/friend.mjs

@@ -1269,8 +1269,8 @@ function repairDangling(db) {
 }
 function loadHistory(db) {
   const msgs = loadAll(db, WINDOW);
-  const start = msgs.findIndex((m) => m.role === "user" && m.content.some((b) => b.type === "text"));
-  return start === -1 ? [] : msgs.slice(start);
+  const start2 = msgs.findIndex((m) => m.role === "user" && m.content.some((b) => b.type === "text"));
+  return start2 === -1 ? [] : msgs.slice(start2);
 }
 
 // ../server/src/agent/prompt.ts
@@ -3619,9 +3619,9 @@ import { z as z10 } from "zod";
 
 // ../server/src/http-error.ts
 var HttpError = class extends Error {
-  constructor(status, message) {
+  constructor(status2, message) {
     super(message);
-    this.status = status;
+    this.status = status2;
   }
   status;
 };
@@ -4075,6 +4075,7 @@ function createGateway(deps) {
     const fwd = config.trustProxy ? String(req.headers["x-forwarded-for"] ?? "").split(",").at(-1)?.trim() : "";
     return fwd || req.socket.remoteAddress || "unknown";
   };
+  let activeOwner = null;
   function handleClient(ws, req) {
     if (!originAllowed(req)) {
       audit.log("anonymous", "ws.origin_refused", { origin: req.headers.origin });
@@ -4083,6 +4084,19 @@ function createGateway(deps) {
     const token = parseCookies(req.headers.cookie)[COOKIE_NAME];
     const session = token ? auth.resolveSession(token) : null;
     if (!session) return ws.close(4401, "unauthorized");
+    const params = new URL(req.url ?? "/", "http://localhost").searchParams;
+    const tab = (params.get("tab") ?? "").slice(0, 64);
+    if (tab) {
+      if (activeOwner && activeOwner.ws.readyState === WebSocket.OPEN) {
+        if (params.get("takeover") !== "1" && activeOwner.tab !== tab) return ws.close(4409, "in use elsewhere");
+        activeOwner.ws.close(4410, "replaced");
+      }
+      const mine = { ws, tab };
+      activeOwner = mine;
+      ws.on("close", () => {
+        if (activeOwner === mine) activeOwner = null;
+      });
+    }
     const conn = {
       ip: clientIp(req),
       send: (m) => {
@@ -4093,6 +4107,7 @@ function createGateway(deps) {
     const dispose = deps.onClientConnect?.(session, conn);
     ws.on("close", () => dispose?.());
     ws.on("message", (data) => {
+      if (tab && activeOwner?.ws !== ws) return;
       let json;
       try {
         json = JSON.parse(String(data));
@@ -6342,11 +6357,10 @@ async function createApp(opts) {
       camera.cancelAll(broadcast);
       agent.cancel();
       approvals.denyAll("Shutting down");
-      await gateway.close();
-      await provider.close?.().catch(() => {
-      });
-      await hub.close().catch(() => {
-      });
+      await Promise.all([gateway.close().catch(() => {
+      }), provider.close?.().catch(() => {
+      }), hub.close().catch(() => {
+      })]);
       db.close();
     }
   };
@@ -6897,7 +6911,7 @@ function startDeviceNode(opts) {
     state = s;
     opts.onState?.(s);
   };
-  function connect() {
+  function connect2() {
     if (stopped) return;
     setState("connecting");
     const sock = new WebSocket2(opts.url, { headers: { authorization: `Bearer ${opts.token}` }, ...opts.ca ? { ca: opts.ca } : {} });
@@ -6945,10 +6959,10 @@ function startDeviceNode(opts) {
       if (opts.reconnect === false) return;
       const delay = Math.min(base * 2 ** attempt, 1e4);
       attempt += 1;
-      timer = setTimeout(connect, delay);
+      timer = setTimeout(connect2, delay);
     });
   }
-  connect();
+  connect2();
   return {
     connected,
     state: () => state,
@@ -7380,8 +7394,8 @@ async function startFriend(opts) {
     async stop() {
       if (watcher) clearInterval(watcher);
       node.stop();
-      await sidecar?.stop();
-      await app.stop();
+      const wait = (ms) => new Promise((r) => setTimeout(r, ms).unref?.());
+      await Promise.race([Promise.allSettled([sidecar?.stop(), app.stop()]), wait(6e3)]);
     }
   };
 }
@@ -7923,14 +7937,14 @@ async function checkDocker(d) {
 async function checkOllama(d) {
   const base = { id: "ollama", label: "Ollama", need: "optional", unlocks: "a free, private model that runs on this PC" };
   const v = await d.run("ollama", ["--version"]);
-  let running = false;
+  let running2 = false;
   try {
-    running = (await d.fetch("http://127.0.0.1:11434/api/version", { signal: AbortSignal.timeout(2500) })).ok;
+    running2 = (await d.fetch("http://127.0.0.1:11434/api/version", { signal: AbortSignal.timeout(2500) })).ok;
   } catch {
-    running = false;
+    running2 = false;
   }
-  if (v.code === 0) return { ...base, ok: true, detail: `${first(v.stdout).replace(/^.*version is /i, "Ollama ")}${running ? ", running" : ", installed (start the Ollama app if it is not running)"}` };
-  if (running) return { ...base, ok: true, detail: "an Ollama server is running at 127.0.0.1:11434" };
+  if (v.code === 0) return { ...base, ok: true, detail: `${first(v.stdout).replace(/^.*version is /i, "Ollama ")}${running2 ? ", running" : ", installed (start the Ollama app if it is not running)"}` };
+  if (running2) return { ...base, ok: true, detail: "an Ollama server is running at 127.0.0.1:11434" };
   return { ...base, ok: false, detail: "not installed" };
 }
 async function checkClaude(d, command = "claude") {
@@ -8550,6 +8564,175 @@ async function doctorCommand(io2, partial = {}) {
   return requiredMissing ? 1 : 0;
 }
 
+// ../agent-cli/src/commands/daemon.ts
+import { spawn as spawn6, spawnSync as spawnSync2 } from "node:child_process";
+import { closeSync as closeSync2, existsSync as existsSync14, mkdirSync as mkdirSync13, openSync as openSync2, readFileSync as readFileSync10, renameSync as renameSync4, rmSync as rmSync6, statSync as statSync3, writeFileSync as writeFileSync12 } from "node:fs";
+import { connect } from "node:net";
+import { join as join18 } from "node:path";
+var USAGE3 = "Usage: friend daemon start | stop | restart | status";
+var MAX_LOG_BYTES = 5 * 1024 * 1024;
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var realDeps = {
+  launch(logFile) {
+    const fd = openSync2(logFile, "a");
+    try {
+      const child = spawn6(process.execPath, [process.argv[1], "start"], { detached: true, stdio: ["ignore", fd, fd], windowsHide: true });
+      child.unref();
+      return child.pid;
+    } finally {
+      closeSync2(fd);
+    }
+  },
+  alive(pid) {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch (e) {
+      return e.code === "EPERM";
+    }
+  },
+  async kill(pid) {
+    if (process.platform === "win32") {
+      spawnSync2("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
+    } else {
+      try {
+        process.kill(pid, "SIGTERM");
+      } catch {
+        return;
+      }
+      for (let i = 0; i < 40 && realDeps.alive(pid); i++) await sleep(200);
+      if (realDeps.alive(pid)) {
+        try {
+          process.kill(pid, "SIGKILL");
+        } catch {
+        }
+      }
+    }
+    for (let i = 0; i < 25 && realDeps.alive(pid); i++) await sleep(200);
+  },
+  portOpen(port, withinMs) {
+    return new Promise((resolve10) => {
+      const s = connect({ port, host: "127.0.0.1" });
+      const done = (ok) => {
+        s.destroy();
+        resolve10(ok);
+      };
+      s.setTimeout(withinMs, () => done(false));
+      s.once("connect", () => done(true));
+      s.once("error", () => done(false));
+    });
+  },
+  now: Date.now
+};
+var pidFile = (dataDir) => join18(dataDir, "friend.pid");
+var logFileOf = (dataDir) => join18(dataDir, "friend.log");
+function readPid(dataDir) {
+  try {
+    const r = JSON.parse(readFileSync10(pidFile(dataDir), "utf8"));
+    return Number.isInteger(r.pid) && r.pid > 0 ? r : null;
+  } catch {
+    return null;
+  }
+}
+function running(dataDir, deps) {
+  const r = readPid(dataDir);
+  if (r && deps.alive(r.pid)) return r;
+  if (r) rmSync6(pidFile(dataDir), { force: true });
+  return null;
+}
+function since(ms) {
+  const s = Math.max(0, Math.round(ms / 1e3));
+  if (s < 90) return `${s} seconds`;
+  if (s < 5400) return `${Math.round(s / 60)} minutes`;
+  if (s < 129600) return `${Math.round(s / 3600)} hours`;
+  return `${Math.round(s / 86400)} days`;
+}
+async function start(io2, deps) {
+  const existing = running(io2.dataDir, deps);
+  const cfg = loadConfig(io2.dataDir);
+  const urls = urlsFor(cfg.bind, cfg.port, void 0, cfg.https);
+  if (existing) {
+    io2.out(`Friend is already running in the background (pid ${existing.pid}) at ${urls.local}`);
+    return 0;
+  }
+  if (await deps.portOpen(cfg.port, 500)) {
+    io2.err(`Port ${cfg.port} is already in use. Friend may be running in a terminal (stop it with Ctrl+C), or another program uses that port (friend lan port N).`);
+    return 1;
+  }
+  mkdirSync13(io2.dataDir, { recursive: true });
+  const log = logFileOf(io2.dataDir);
+  try {
+    if (existsSync14(log) && statSync3(log).size > MAX_LOG_BYTES) renameSync4(log, `${log}.old`);
+  } catch {
+  }
+  const pid = deps.launch(log);
+  if (!pid) {
+    io2.err("Could not start Friend in the background.");
+    return 1;
+  }
+  writeFileSync12(pidFile(io2.dataDir), JSON.stringify({ pid, startedAt: deps.now() }));
+  for (let i = 0; i < 60; i++) {
+    if (await deps.portOpen(cfg.port, 300)) {
+      io2.out(`Friend is running in the background (pid ${pid}) at ${urls.local}`);
+      for (const n of urls.network) io2.out(`Also on your network: ${n}`);
+      io2.out(`Stop it with: friend daemon stop   (log: ${log})`);
+      return 0;
+    }
+    if (!deps.alive(pid)) break;
+    await sleep(250);
+  }
+  rmSync6(pidFile(io2.dataDir), { force: true });
+  io2.err(`Friend did not start. See the log: ${log}`);
+  return 1;
+}
+async function stop(io2, deps) {
+  const r = running(io2.dataDir, deps);
+  if (!r) {
+    io2.out("Friend is not running in the background.");
+    return 0;
+  }
+  await deps.kill(r.pid);
+  if (deps.alive(r.pid)) {
+    io2.err(`Could not stop Friend (pid ${r.pid}). End that process yourself.`);
+    return 1;
+  }
+  rmSync6(pidFile(io2.dataDir), { force: true });
+  io2.out("Friend stopped.");
+  return 0;
+}
+async function status(io2, deps) {
+  const cfg = loadConfig(io2.dataDir);
+  const urls = urlsFor(cfg.bind, cfg.port, void 0, cfg.https);
+  const r = running(io2.dataDir, deps);
+  if (r) {
+    io2.out(`Friend is running in the background (pid ${r.pid}, for ${since(deps.now() - r.startedAt)}).`);
+    io2.out(`Address: ${urls.local}`);
+    for (const n of urls.network) io2.out(`Also on your network: ${n}`);
+    io2.out(`Log: ${logFileOf(io2.dataDir)}`);
+    return 0;
+  }
+  if (await deps.portOpen(cfg.port, 500)) io2.out(`Friend is not running in the background, but port ${cfg.port} is in use. It may be running in a terminal.`);
+  else io2.out("Friend is not running. Start it in the background with: friend daemon start");
+  return 1;
+}
+async function daemonCommand(args, io2, deps = realDeps) {
+  switch (args[0]) {
+    case "start":
+      return start(io2, deps);
+    case "stop":
+      return stop(io2, deps);
+    case "restart": {
+      const code = await stop(io2, deps);
+      return code === 0 ? start(io2, deps) : code;
+    }
+    case "status":
+      return status(io2, deps);
+    default:
+      io2.err(USAGE3);
+      return 1;
+  }
+}
+
 // ../agent-cli/src/commands/claude.ts
 async function check2(run2, command) {
   const v = await run2(command, ["--version"]);
@@ -8618,7 +8801,7 @@ async function claudeCommand(args, io2, deps = {}) {
 }
 
 // ../agent-cli/src/commands/setup.ts
-import { mkdirSync as mkdirSync13 } from "node:fs";
+import { mkdirSync as mkdirSync14 } from "node:fs";
 import { resolve as resolve9 } from "node:path";
 async function setupCommand3(io2) {
   const db = openDb(io2.dataDir);
@@ -8644,7 +8827,7 @@ async function setupCommand3(io2) {
     const cfg = loadConfig(io2.dataDir);
     if (workspace2) {
       const abs = resolve9(workspace2);
-      mkdirSync13(abs, { recursive: true });
+      mkdirSync14(abs, { recursive: true });
       cfg.roots = [abs];
     }
     if (apiKey) cfg.apiKey = apiKey;
@@ -8680,17 +8863,18 @@ async function statusCommand3(io2) {
 }
 
 // ../agent-cli/src/cli.ts
-var USAGE3 = `Usage: friend <command>
+var USAGE4 = `Usage: friend <command>
 
   onboard                    guided setup, step by step: checks this PC, installs what is missing, asks what you want
   doctor                     check what this PC has and what is missing (changes nothing)
   setup                      create the owner account (password, PIN, assistant name)
   start                      run the gateway and a local device node
+  daemon start|stop|restart|status  run Friend in the background (no terminal needed), stop it, or see if it is running
   pair                       print a one-time code to connect another PC
   node --url <ws-url> --code <code> [--roots a,b] [--name pc]
                              connect this PC to a Friend gateway
   ollama setup|status        use a local model through Ollama (no API key needed)
-  lan status|on|off|port N   let other devices on your network open Friend, or change the port (restart to apply)
+  lan status|on|off|port N|https on|off  let other devices on your network open Friend, change the port, or turn on the secure (https) address a phone needs for the microphone (restart to apply)
   claude setup|status        use your Claude subscription through Claude Code (no API key needed)
   voice setup|list|status|forget  install local speech and choose a female or male voice; check it; forget deletes your saved voice
   memory list|forget <n>|clear  see and delete the notes Friend keeps about you
@@ -8710,6 +8894,8 @@ async function run(argv, io2) {
         return await setupCommand3(io2);
       case "start":
         return await startCommand(io2);
+      case "daemon":
+        return await daemonCommand(rest, io2);
       case "pair":
         return await pairCommand(io2);
       case "node":
@@ -8722,10 +8908,15 @@ async function run(argv, io2) {
         return await onboardCommand(rest, io2);
       case "doctor":
         return await doctorCommand(io2);
+      case "help":
+      case "--help":
+      case "-h":
+        io2.out(USAGE4);
+        return 0;
       case "version":
       case "--version":
       case "-v":
-        io2.out(true ? "0.1.2" : "development");
+        io2.out(true ? "0.1.4" : "development");
         return 0;
       case "lan":
         return await lanCommand(rest, io2);
@@ -8744,7 +8935,7 @@ async function run(argv, io2) {
       case "config":
         return await configCommand(rest, io2);
       default:
-        io2.err(USAGE3);
+        io2.err(USAGE4);
         return 1;
     }
   } catch (e) {
@@ -8805,4 +8996,5 @@ var io = {
 };
 run(process.argv.slice(2), io).then((code) => {
   if (code !== 0) process.exitCode = code;
+  if (process.argv[2] === "start") setTimeout(() => process.exit(), 1e3).unref();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "friend-assistant",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A self-hosted personal AI assistant for your own PC: a full-screen stage, voice, tools with your approval, and your Claude subscription or a local model.",
   "keywords": ["ai", "assistant", "jarvis", "voice", "claude", "ollama", "mcp", "self-hosted"],
   "license": "UNLICENSED",