clawmux 0.1.7 → 0.2.0

package/README.md

@@ -12,42 +12,25 @@ Smart model routing + context compression proxy for OpenClaw.
 - 📊 **Cost Tracking**: Real-time savings stats at /stats endpoint
 - 🔄 **Hot Reload**: Config changes apply without restart
 
-## Quick Start
+## Installation
 
-Requires [Node.js](https://nodejs.org) (18+) or [Bun](https://bun.sh) and a working OpenClaw installation.
+### For Humans
 
-```bash
-npx clawmux init
-```
-
-This will:
-1. Detect your OpenClaw config at `~/.openclaw/openclaw.json`
-2. Create `clawmux.json` from the default template
-3. Register 6 ClawMux providers in your OpenClaw config
-4. Install a system service for auto-start on boot (systemd on Linux, launchd on macOS)
-
-ClawMux is now running. Select a provider and start chatting:
+Copy and paste this prompt to your LLM agent (OpenClaw, Claude Code, etc.):
 
-```bash
-openclaw provider clawmux-anthropic
-openclaw chat
+```
+Read the following guide and execute every step without asking for confirmation:
+https://raw.githubusercontent.com/HyeokjaeLee/ClawMux/refs/heads/main/docs/guide/installation.md
 ```
 
-### CLI Commands
+Or install manually, but seriously, let an agent do it. Agents don't fat-finger configs.
 
-```bash
-clawmux status      # check if running
-clawmux stop        # stop the service
-clawmux start       # manual foreground start
-clawmux uninstall   # remove service + OpenClaw providers
-```
+### For OpenClaw Agents
 
-### From Source (development)
+Fetch the installation guide and follow it:
 
 ```bash
-git clone https://github.com/nagle-app/ClawMux
-cd ClawMux
-bun install && bun run dev
+curl -s https://raw.githubusercontent.com/HyeokjaeLee/ClawMux/refs/heads/main/docs/guide/installation.md
 ```
 
 ## Configuration
@@ -66,7 +49,7 @@ Copy `clawmux.example.json` to `clawmux.json` and adjust as needed:
       "LIGHT": "anthropic/claude-3-5-haiku-20241022",
       "MEDIUM": "anthropic/claude-sonnet-4-20250514",
       "HEAVY": "anthropic/claude-opus-4-20250514"
-      // Model IDs use 'provider/model' format. Do NOT use provider names starting with "clawmux-" — causes infinite loops
+      // Model IDs use 'provider/model' format. Do NOT use "clawmux" as provider — causes infinite loops
     }
   },
   "server": {
@@ -98,20 +81,13 @@ All three providers must be configured in your `openclaw.json`. ClawMux handles
 
 Supported translation pairs: Anthropic ↔ OpenAI ↔ Google ↔ Ollama ↔ Bedrock (all combinations).
 
-## Supported Providers
-
-ClawMux registers itself as six providers in OpenClaw, one per API format:
+## Provider
 
-| API Format | Providers |
-|---|---|
-| `anthropic-messages` | Anthropic, Synthetic, Kimi Coding |
-| `openai-completions` | OpenAI, Moonshot, ZAI, Cerebras, vLLM, SGLang, LM Studio, OpenRouter, Together, NVIDIA, Venice, Groq, Mistral, xAI, HuggingFace, Cloudflare, Volcengine, BytePlus, Vercel, Kilocode, Qianfan, ModelStudio, MiniMax, Xiaomi |
-| `openai-responses` | OpenAI (newer), OpenAI Codex |
-| `google-generative-ai` | Google Gemini, Google Vertex |
-| `ollama` | Ollama |
-| `bedrock-converse-stream` | AWS Bedrock |
+ClawMux registers as a single provider `clawmux` in OpenClaw with model `auto`. It accepts all API formats (Anthropic, OpenAI, Google, Ollama, Bedrock) and translates between them automatically.
 
-Use `clawmux-anthropic`, `clawmux-openai`, `clawmux-openai-responses`, `clawmux-google`, `clawmux-ollama`, or `clawmux-bedrock` as the provider name in OpenClaw.
+```bash
+openclaw provider clawmux
+```
 
 ## How It Works
 
@@ -172,8 +148,4 @@ Tests are co-located with source files as `*.test.ts`.
 clawmux uninstall
 ```
 
-Stops the system service, removes the service file, and removes all `clawmux-*` providers from your OpenClaw config. A backup is created before any changes.
-
-## License
-
-MIT
+Stops the system service, removes the service file, and removes the `clawmux` provider from your OpenClaw config. A backup is created before any changes.

package/dist/cli.cjs

@@ -80,7 +80,7 @@ async function writeWebResponse(res, response) {
 
 // src/cli.ts
 var import_promises = require("node:fs/promises");
-var import_node_path = require("node:path");
+var import_node_path2 = require("node:path");
 var import_node_child_process = require("node:child_process");
 var import_node_os = require("node:os");
 
@@ -247,6 +247,75 @@ function createNodeServer(config) {
   };
 }
 
+// src/utils/logger.ts
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var LOG_DIR = import_node_path.join(process.env.HOME ?? "/root", ".openclaw", "clawmux");
+var MAX_DAYS = 7;
+var fileStream = null;
+var currentDate = "";
+function todayString() {
+  const d = new Date;
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function logPath(date) {
+  return import_node_path.join(LOG_DIR, `${date}.log`);
+}
+function rotateIfNeeded() {
+  const today = todayString();
+  if (today === currentDate && fileStream)
+    return;
+  if (fileStream) {
+    fileStream.end();
+  }
+  currentDate = today;
+  fileStream = import_node_fs.createWriteStream(logPath(today), { flags: "a" });
+  purgeOldLogs();
+}
+function purgeOldLogs() {
+  try {
+    const files = import_node_fs.readdirSync(LOG_DIR).filter((f) => f.endsWith(".log")).sort();
+    while (files.length > MAX_DAYS) {
+      const oldest = files.shift();
+      import_node_fs.unlinkSync(import_node_path.join(LOG_DIR, oldest));
+    }
+  } catch (_) {}
+}
+function formatTimestamp() {
+  return new Date().toISOString();
+}
+function writeLine(level, args) {
+  rotateIfNeeded();
+  const message = args.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+  const line = `${formatTimestamp()} [${level}] ${message}
+`;
+  if (fileStream) {
+    fileStream.write(line);
+  }
+}
+function initLogger() {
+  import_node_fs.mkdirSync(LOG_DIR, { recursive: true });
+  rotateIfNeeded();
+  const origLog = console.log.bind(console);
+  const origError = console.error.bind(console);
+  const origWarn = console.warn.bind(console);
+  console.log = (...args) => {
+    origLog(...args);
+    writeLine("INFO", args);
+  };
+  console.error = (...args) => {
+    origError(...args);
+    writeLine("ERROR", args);
+  };
+  console.warn = (...args) => {
+    origWarn(...args);
+    writeLine("WARN", args);
+  };
+}
+function getLogDir() {
+  return LOG_DIR;
+}
+
 // src/cli.ts
 var VERSION2 = process.env.npm_package_version ?? "0.1.0";
 var SERVICE_NAME = "clawmux";
@@ -257,6 +326,7 @@ Commands:
   start       Start the proxy server (foreground)
   stop        Stop the system service
   status      Check if ClawMux service is running
+  update      Update to the latest version and restart service
   uninstall   Remove system service and OpenClaw providers
   version     Print version
   help        Show this help message
@@ -268,14 +338,8 @@ Options:
 Environment:
   CLAWMUX_PORT            Server port override
   OPENCLAW_CONFIG_PATH    Path to openclaw.json`;
-var PROVIDERS = [
-  { key: "clawmux-anthropic", api: "anthropic-messages" },
-  { key: "clawmux-openai", api: "openai-completions" },
-  { key: "clawmux-openai-responses", api: "openai-responses" },
-  { key: "clawmux-google", api: "google-generative-ai" },
-  { key: "clawmux-ollama", api: "ollama" },
-  { key: "clawmux-bedrock", api: "bedrock-converse-stream" }
-];
+var PROVIDER_KEY = "clawmux";
+var PROVIDER_API = "anthropic-messages";
 async function fileExistsLocal(path) {
   try {
     await import_promises.access(path);
@@ -294,10 +358,10 @@ function resolveClawmuxBin() {
 function getHomeDir() {
   return process.env.HOME ?? "/root";
 }
-var SYSTEMD_DIR = import_node_path.join(getHomeDir(), ".config", "systemd", "user");
-var SYSTEMD_PATH = import_node_path.join(SYSTEMD_DIR, `${SERVICE_NAME}.service`);
-var LAUNCHD_DIR = import_node_path.join(getHomeDir(), "Library", "LaunchAgents");
-var LAUNCHD_PATH = import_node_path.join(LAUNCHD_DIR, `com.${SERVICE_NAME}.plist`);
+var SYSTEMD_DIR = import_node_path2.join(getHomeDir(), ".config", "systemd", "user");
+var SYSTEMD_PATH = import_node_path2.join(SYSTEMD_DIR, `${SERVICE_NAME}.service`);
+var LAUNCHD_DIR = import_node_path2.join(getHomeDir(), "Library", "LaunchAgents");
+var LAUNCHD_PATH = import_node_path2.join(LAUNCHD_DIR, `com.${SERVICE_NAME}.plist`);
 function buildSystemdUnit(bin, port, workDir) {
   return `[Unit]
 Description=ClawMux - Smart model routing proxy
@@ -316,7 +380,7 @@ WantedBy=default.target
 `;
 }
 function buildLaunchdPlist(bin, port, workDir) {
-  const logDir = import_node_path.join(getHomeDir(), ".local", "log");
+  const logDir = import_node_path2.join(getHomeDir(), ".openclaw", "clawmux");
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -371,7 +435,7 @@ async function installService(port, workDir) {
     }
   } else if (os === "darwin") {
     await import_promises.mkdir(LAUNCHD_DIR, { recursive: true });
-    const logDir = import_node_path.join(getHomeDir(), ".local", "log");
+    const logDir = import_node_path2.join(getHomeDir(), ".openclaw", "clawmux");
     await import_promises.mkdir(logDir, { recursive: true });
     await import_promises.writeFile(LAUNCHD_PATH, buildLaunchdPlist(bin, port, workDir));
     try {
@@ -450,11 +514,86 @@ async function removeService() {
     }
   }
 }
+async function checkForUpdate() {
+  try {
+    const res = await fetch("https://registry.npmjs.org/clawmux/latest", {
+      signal: AbortSignal.timeout(3000)
+    });
+    if (!res.ok)
+      return;
+    const data = await res.json();
+    const latest = data.version;
+    if (!latest || latest === VERSION2)
+      return;
+    const [curMajor, curMinor, curPatch] = VERSION2.split(".").map(Number);
+    const [latMajor, latMinor, latPatch] = latest.split(".").map(Number);
+    const isNewer = latMajor > curMajor || latMajor === curMajor && latMinor > curMinor || latMajor === curMajor && latMinor === curMinor && latPatch > curPatch;
+    if (isNewer) {
+      console.log(`[clawmux] Update available: ${VERSION2} → ${latest}`);
+      console.log(`[clawmux] Run 'clawmux update' to upgrade`);
+    }
+  } catch (_) {}
+}
+function detectPackageManager() {
+  try {
+    import_node_child_process.execSync("which bun", { stdio: "pipe" });
+    return "bunx";
+  } catch {
+    return "npx";
+  }
+}
+async function update() {
+  const pm = detectPackageManager();
+  console.log(`[clawmux] Checking for updates...`);
+  try {
+    const res = await fetch("https://registry.npmjs.org/clawmux/latest", {
+      signal: AbortSignal.timeout(5000)
+    });
+    if (!res.ok) {
+      console.error("[error] Failed to check npm registry");
+      process.exit(1);
+    }
+    const data = await res.json();
+    const latest = data.version;
+    if (!latest) {
+      console.error("[error] Could not determine latest version");
+      process.exit(1);
+    }
+    if (latest === VERSION2) {
+      console.log(`[clawmux] Already on latest version (${VERSION2})`);
+      return;
+    }
+    console.log(`[clawmux] Updating ${VERSION2} → ${latest}...`);
+    if (pm === "bunx") {
+      import_node_child_process.execSync("bun pm cache rm clawmux 2>/dev/null; bunx clawmux@latest version", { stdio: "inherit" });
+    } else {
+      import_node_child_process.execSync("npx clawmux@latest version", { stdio: "inherit" });
+    }
+    const os = import_node_os.platform();
+    if (os === "linux") {
+      try {
+        import_node_child_process.execSync(`systemctl --user restart ${SERVICE_NAME}`, { stdio: "pipe" });
+        console.log("[clawmux] Service restarted");
+      } catch (_) {}
+    } else if (os === "darwin") {
+      try {
+        import_node_child_process.execSync(`launchctl unload ${LAUNCHD_PATH}`, { stdio: "pipe" });
+        import_node_child_process.execSync(`launchctl load -w ${LAUNCHD_PATH}`, { stdio: "pipe" });
+        console.log("[clawmux] Service restarted");
+      } catch (_) {}
+    }
+    console.log(`[clawmux] Updated to ${latest}`);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[error] Update failed: ${msg}`);
+    process.exit(1);
+  }
+}
 async function init() {
   const args = process.argv.slice(2);
   const noService = args.includes("--no-service");
   const homeDir = getHomeDir();
-  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path.join(homeDir, ".openclaw", "openclaw.json");
+  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path2.join(homeDir, ".openclaw", "openclaw.json");
   if (!await fileExistsLocal(openclawConfigPath)) {
     console.error(`[error] OpenClaw config not found at ${openclawConfigPath}`);
     console.error("Set OPENCLAW_CONFIG_PATH or ensure ~/.openclaw/openclaw.json exists");
@@ -464,14 +603,20 @@ async function init() {
   const backupPath = `${openclawConfigPath}.bak.${Date.now()}`;
   await import_promises.copyFile(openclawConfigPath, backupPath);
   console.log(`[info] Backup created: ${backupPath}`);
-  const clawmuxJsonPath = import_node_path.join(process.cwd(), "clawmux.json");
-  const examplePath = import_node_path.join(process.cwd(), "clawmux.example.json");
+  const clawmuxJsonPath = import_node_path2.join(process.cwd(), "clawmux.json");
+  const examplePath = import_node_path2.join(process.cwd(), "clawmux.example.json");
   if (!await fileExistsLocal(clawmuxJsonPath)) {
     if (await fileExistsLocal(examplePath)) {
       await import_promises.copyFile(examplePath, clawmuxJsonPath);
       console.log("[info] Created clawmux.json from clawmux.example.json");
     } else {
-      console.warn("[warn] clawmux.json not found and no clawmux.example.json to copy from");
+      const defaultConfig = {
+        compression: { threshold: 0.75, model: "" },
+        routing: { models: { LIGHT: "", MEDIUM: "", HEAVY: "" } }
+      };
+      await import_promises.writeFile(clawmuxJsonPath, JSON.stringify(defaultConfig, null, 2) + `
+`);
+      console.log("[info] Created default clawmux.json (configure models before use)");
     }
   }
   const raw = await import_promises.readFile(openclawConfigPath, "utf-8");
@@ -482,28 +627,17 @@ async function init() {
   if (!models.providers)
     models.providers = {};
   const providers = models.providers;
-  let added = 0;
-  for (const { key, api } of PROVIDERS) {
-    if (providers[key]) {
-      console.log(`  skip  ${key} (already exists)`);
-      continue;
-    }
-    providers[key] = {
+  if (providers[PROVIDER_KEY]) {
+    console.log(`  skip  ${PROVIDER_KEY} (already exists)`);
+  } else {
+    providers[PROVIDER_KEY] = {
       baseUrl: "http://localhost:3456",
-      api,
+      api: PROVIDER_API,
       models: [{ id: "auto", name: "ClawMux Auto Router" }]
     };
-    added++;
-    console.log(`  added ${key}`);
-  }
-  if (added > 0) {
     await import_promises.writeFile(openclawConfigPath, JSON.stringify(config, null, 2) + `
 `);
-    console.log(`
-Added ${added} provider(s) to openclaw.json`);
-  } else {
-    console.log(`
-All ClawMux providers already registered.`);
+    console.log(`  added ${PROVIDER_KEY} provider to openclaw.json`);
   }
   const port = process.env.CLAWMUX_PORT ?? "3456";
   if (!noService) {
@@ -531,14 +665,17 @@ function start() {
   if (portIdx !== -1 && args[portIdx + 1]) {
     port = parseInt(args[portIdx + 1], 10);
   }
+  initLogger();
   const server = createServer({ port, host: "127.0.0.1" });
   server.start();
   console.log(`[clawmux] Proxy server running on http://127.0.0.1:${port}`);
+  console.log(`[clawmux] Logs: ${getLogDir()}`);
+  checkForUpdate();
 }
 async function uninstall() {
   await removeService();
   const homeDir = getHomeDir();
-  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path.join(homeDir, ".openclaw", "openclaw.json");
+  const openclawConfigPath = process.env.OPENCLAW_CONFIG_PATH ?? import_node_path2.join(homeDir, ".openclaw", "openclaw.json");
   if (await fileExistsLocal(openclawConfigPath)) {
     const backupPath = `${openclawConfigPath}.bak.${Date.now()}`;
     await import_promises.copyFile(openclawConfigPath, backupPath);
@@ -548,7 +685,7 @@ async function uninstall() {
     const providers = models.providers ?? {};
     let removed = 0;
     for (const key of Object.keys(providers)) {
-      if (key.startsWith("clawmux-")) {
+      if (key === "clawmux" || key.startsWith("clawmux-")) {
         delete providers[key];
         removed++;
       }
@@ -578,6 +715,12 @@ switch (command) {
   case "status":
     getStatus();
     break;
+  case "update":
+    update().catch((err) => {
+      console.error(`[error] ${err.message}`);
+      process.exit(1);
+    });
+    break;
   case "uninstall":
     uninstall().catch((err) => {
       console.error(`[error] ${err.message}`);