mslxdff 0.1.3 → 0.1.5

package/README.md

@@ -46,16 +46,21 @@ Priority: `-port` arg > persisted port > `PORT` env > default `8989`.
 
 ### Daemon (background, stays resident)
 
+Just run `mslxdff` (no args): if no daemon is running yet, it **starts a background
+daemon and exits** — the command never holds your terminal, so `npx mslxdff` works
+the same way. If a daemon is already up, the bare command shows status + help.
+
 ```
-mslxdff -d        # start detached background daemon
-mslxdff -stop     # stop it
+mslxdff        # starts the background daemon (if none running); exits immediately
+mslxdff -d     # same, explicit
+mslxdff -stop  # stop it
 ```
 
 Logs go to `~/.config/mslxdff/daemon.log`, the daemon pid to `daemon.pid` (both overridable via `MSLXDFF_DAEMON_DIR`). The daemon keeps running after your shell exits.
 
 ### Status
 
-Running `mslxdff` with no args shows a status panel when a daemon is already up (or use `mslxdff -status` anytime): the free model list, the last 5 calls (model/status/latency), and the most recent error. Call and error history are stored as JSON-lines at `calls.log` / `errors.log` in the state dir.
+Running `mslxdff` with no args shows a status panel when a daemon is already up: joined groups with their members, failover targets, the free model list, the last 5 calls (model/status/latency), and the most recent error (`mslxdff -status` for status only, `mslxdff -help` for the full command reference). Call and error history are stored as JSON-lines at `calls.log` / `errors.log` in the state dir.
 
 ```
 $ mslxdff -status

package/bin/mslxdff.js

@@ -55,6 +55,60 @@ if (args.includes("-status") || args.includes("--status") || args.includes("-s")
   process.exit(0);
 }
 
+// -model list | -models : show the free models this proxy serves (cache-first)
+// -model refresh : force a fresh fetch from the upstream and update the cache
+if (args.includes("-model") || args.includes("-models")) {
+  const idx = args.findIndex((x) => x === "-model" || x === "-models");
+  const sub = args[idx + 1];
+  if (sub === "refresh") {
+    const models = createModelsService({
+      baseUrl: process.env.UPSTREAM_BASE_URL || "https://opencode.ai",
+      headers: createUpstreamClient({}).headers,
+      refreshMs: 0,
+      cacheFile: join(logDir(), "models.json"),
+    });
+    try {
+      const list = await models.get();
+      const ids = (list.data || []).map((m) => m.id).filter(Boolean);
+      console.log(`refreshed: ${ids.length} free model(s)`);
+      for (const id of ids) console.log(`  ${id}`);
+    } catch (err) {
+      console.error(`could not refresh models: ${String(err?.message || err)}`);
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+  if (sub !== undefined && sub !== "list") {
+    console.error("usage: mslxdff -model list | mslxdff -model refresh");
+    process.exit(1);
+  }
+  const cacheFile = join(logDir(), "models.json");
+  try {
+    const cached = readModelsCache(cacheFile);
+    if (cached) {
+      const ids = (cached.data || []).map((m) => m.id).filter(Boolean);
+      const at = cached.cachedAt ? ` (cached ${new Date(cached.cachedAt).toISOString().slice(0, 16).replace("T", " ")})` : "";
+      console.log(`${ids.length} free model(s)${at}:`);
+      for (const id of ids) console.log(`  ${id}`);
+    } else {
+      const models = createModelsService({
+        baseUrl: process.env.UPSTREAM_BASE_URL || "https://opencode.ai",
+        headers: createUpstreamClient({}).headers,
+        refreshMs: 0,
+        cacheFile,
+      });
+      const list = await models.get();
+      const ids = (list.data || []).map((m) => m.id).filter(Boolean);
+      console.log(`${ids.length} free model(s):`);
+      for (const id of ids) console.log(`  ${id}`);
+    }
+  } catch (err) {
+    console.error(`could not fetch models: ${String(err?.message || err)}`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
 // -creategroup <name> | -group create <name> | -group sync | -group leave <name> | -group list |
 // -addtogroup <leader-host> <name> | -resetban [ip]
 const createGroupArg = argValue("-creategroup", "--creategroup") || groupIs("create", args);
@@ -178,6 +232,14 @@ function markJoined(entry) {
 
 const errMsg = (err) => String(err?.message || err);
 
+function readModelsCache(cacheFile) {
+  try {
+    return JSON.parse(readFileSync(cacheFile, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
 // Sync every joined group into the local peer list. Leaders read their local
 // groups state; members re-register with the leader (idempotent) to get the
 // freshest member list. Returns per-group results.
@@ -250,10 +312,22 @@ if (args.includes("-d") || args.includes("--daemon")) {
   // we ARE the daemon; stdout/stderr already point at the log file via startDaemon stdio
 }
 
-// Bare run: if a daemon is already running, show status + help instead of starting another.
-if (!process.env.MSLXDFF_DAEMON && readPid()) {
-  await printStatus();
-  printHelp();
+// Bare run: show status + help when the daemon is already up; otherwise spawn it
+// as a background daemon and exit — never holds the terminal (npx-friendly).
+if (!process.env.MSLXDFF_DAEMON) {
+  if (readPid()) {
+    await printStatus();
+    printHelp();
+    process.exit(0);
+  }
+  const port = effectivePort();
+  const spawnedPid = startDaemon([]);
+  await waitForHealth(port, 4000);
+  console.log(`mslxdff v${VERSION} started as a background daemon (pid ${spawnedPid})`);
+  console.log(`endpoint:   http://localhost:${port}/v1`);
+  console.log(`log:        ${logFile()}`);
+  console.log(`pid:        ${pidFile()}`);
+  console.log(`status:     run \`mslxdff\` again (or \`mslxdff -status\`)`);
   process.exit(0);
 }
 
@@ -383,9 +457,11 @@ function printHelp() {
   console.log(`mslxdff v${VERSION} — OpenCode Free OpenAI-compatible proxy
 
 Usage:
-  mslxdff                          start the server (if none running); shows status when a daemon is already up
+  mslxdff                          start as a background daemon and exit (status + help if one is already running)
   mslxdff -d                       start as a background daemon
   mslxdff -status                  show current status (daemon, models, recent calls, last error)
+  mslxdff -model list              list the free models this proxy serves (cached)
+  mslxdff -model refresh           force-refresh the model cache from the upstream
   mslxdff -stop                    stop the running daemon
   mslxdff -port N                  persist the listen port (restarts the daemon on it if running)
   mslxdff -update                  update mslxdff to the latest published version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/mslxdff.js",
-    "test": "node --test test/"
+    "test": "node --test test/*.test.js"
   },
   "engines": {
     "node": ">=20"