nextclaw 0.1.0 → 0.2.1

package/dist/cli/index.js

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
 import {
+  APP_NAME,
+  APP_REPLY_SUBJECT,
+  APP_TAGLINE,
+  APP_TITLE,
   AgentLoop,
   ConfigSchema,
   LiteLLMProvider,
@@ -14,13 +18,13 @@ import {
   getWorkspacePath,
   loadConfig,
   saveConfig
-} from "../chunk-RTVGGPPW.js";
+} from "../chunk-HXRBJNWA.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4, cpSync, rmSync } from "fs";
-import { join as join5, resolve } from "path";
-import { spawnSync } from "child_process";
+import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4, cpSync, rmSync } from "fs";
+import { join as join6, resolve } from "path";
+import { spawn, spawnSync } from "child_process";
 import { createInterface } from "readline";
 import { fileURLToPath } from "url";
 
@@ -79,8 +83,8 @@ var MessageBus = class {
       for (const callback of subscribers) {
         try {
           await callback(msg);
-        } catch (err) {
-          console.error(`Error dispatching to ${msg.channel}: ${String(err)}`);
+        } catch (err2) {
+          console.error(`Error dispatching to ${msg.channel}: ${String(err2)}`);
         }
       }
     }
@@ -205,14 +209,20 @@ var TelegramChannel = class extends BaseChannel {
     this.bot.onText(/^\/start$/, async (msg) => {
       await this.bot?.sendMessage(
         msg.chat.id,
-        `\u{1F44B} Hi ${msg.from?.first_name ?? ""}! I'm nextclaw.
+        `\u{1F44B} Hi ${msg.from?.first_name ?? ""}! I'm ${APP_NAME}.
 
 Send me a message and I'll respond!
 Type /help to see available commands.`
       );
     });
     this.bot.onText(/^\/help$/, async (msg) => {
-      const helpText = "\u{1F916} <b>nextclaw commands</b>\n\n/start \u2014 Start the bot\n/reset \u2014 Reset conversation history\n/help \u2014 Show this help message\n\nJust send me a text message to chat!";
+      const helpText = `\u{1F916} <b>${APP_NAME} commands</b>
+
+/start \u2014 Start the bot
+/reset \u2014 Reset conversation history
+/help \u2014 Show this help message
+
+Just send me a text message to chat!`;
       await this.bot?.sendMessage(msg.chat.id, helpText, { parse_mode: "HTML" });
     });
     this.bot.onText(/^\/reset$/, async (msg) => {
@@ -1074,12 +1084,12 @@ var MochatChannel = class extends BaseChannel {
   async subscribeAll() {
     const sessions = Array.from(this.sessionSet).sort();
     const panels = Array.from(this.panelSet).sort();
-    let ok = await this.subscribeSessions(sessions);
-    ok = await this.subscribePanels(panels) && ok;
+    let ok2 = await this.subscribeSessions(sessions);
+    ok2 = await this.subscribePanels(panels) && ok2;
     if (this.autoDiscoverSessions || this.autoDiscoverPanels) {
       await this.refreshTargets(true);
     }
-    return ok;
+    return ok2;
   }
   async subscribeSessions(sessionIds) {
     if (!sessionIds.length) {
@@ -1130,9 +1140,9 @@ var MochatChannel = class extends BaseChannel {
       return { result: false, message: "socket not connected" };
     }
     return new Promise((resolve2) => {
-      this.socket?.timeout(1e4).emit(eventName, payload, (err, response) => {
-        if (err) {
-          resolve2({ result: false, message: String(err) });
+      this.socket?.timeout(1e4).emit(eventName, payload, (err2, response) => {
+        if (err2) {
+          resolve2({ result: false, message: String(err2) });
           return;
         }
         if (response && typeof response === "object") {
@@ -1844,7 +1854,7 @@ var DingTalkChannel = class extends BaseChannel {
       msgKey: "sampleMarkdown",
       msgParam: JSON.stringify({
         text: msg.content,
-        title: "Nextclaw Reply"
+        title: `${APP_TITLE} Reply`
       })
     };
     const response = await fetch4(url, {
@@ -1985,7 +1995,7 @@ var EmailChannel = class extends BaseChannel {
     if (!toAddr) {
       return;
     }
-    const baseSubject = this.lastSubjectByChat.get(toAddr) ?? "nextclaw reply";
+    const baseSubject = this.lastSubjectByChat.get(toAddr) ?? APP_REPLY_SUBJECT;
     const subject = msg.metadata?.subject?.trim() || this.replySubject(baseSubject);
     const transporter = nodemailer.createTransport({
       host: this.config.smtpHost,
@@ -2378,8 +2388,8 @@ var ChannelManager = class {
   async startChannel(name, channel) {
     try {
       await channel.start();
-    } catch (err) {
-      console.error(`Failed to start channel ${name}: ${String(err)}`);
+    } catch (err2) {
+      console.error(`Failed to start channel ${name}: ${String(err2)}`);
     }
   }
   async startAll() {
@@ -2399,8 +2409,8 @@ var ChannelManager = class {
     const tasks = Object.entries(this.channels).map(async ([name, channel]) => {
       try {
         await channel.stop();
-      } catch (err) {
-        console.error(`Error stopping ${name}: ${String(err)}`);
+      } catch (err2) {
+        console.error(`Error stopping ${name}: ${String(err2)}`);
       }
     });
     await Promise.allSettled(tasks);
@@ -2414,8 +2424,8 @@ var ChannelManager = class {
       }
       try {
         await channel.send(msg);
-      } catch (err) {
-        console.error(`Error sending to ${msg.channel}: ${String(err)}`);
+      } catch (err2) {
+        console.error(`Error sending to ${msg.channel}: ${String(err2)}`);
       }
     }
   }
@@ -2574,9 +2584,9 @@ var CronService = class {
       }
       job.state.lastStatus = "ok";
       job.state.lastError = null;
-    } catch (err) {
+    } catch (err2) {
       job.state.lastStatus = "error";
-      job.state.lastError = String(err);
+      job.state.lastError = String(err2);
     }
     job.state.lastRunAtMs = start;
     job.updatedAtMs = nowMs();
@@ -2756,15 +2766,298 @@ var HeartbeatService = class {
   }
 };
 
+// src/ui/server.ts
+import { Hono as Hono2 } from "hono";
+import { cors } from "hono/cors";
+import { serve } from "@hono/node-server";
+import { WebSocketServer, WebSocket as WebSocket2 } from "ws";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
+import { readFile, stat } from "fs/promises";
+import { join as join5 } from "path";
+
+// src/ui/router.ts
+import { Hono } from "hono";
+
+// src/ui/config.ts
+var MASK_MIN_LENGTH = 8;
+function maskApiKey(value) {
+  if (!value) {
+    return { apiKeySet: false };
+  }
+  if (value.length < MASK_MIN_LENGTH) {
+    return { apiKeySet: true, apiKeyMasked: "****" };
+  }
+  return {
+    apiKeySet: true,
+    apiKeyMasked: `${value.slice(0, 2)}****${value.slice(-4)}`
+  };
+}
+function toProviderView(provider) {
+  const masked = maskApiKey(provider.apiKey);
+  return {
+    apiKeySet: masked.apiKeySet,
+    apiKeyMasked: masked.apiKeyMasked,
+    apiBase: provider.apiBase ?? null,
+    extraHeaders: provider.extraHeaders ?? null
+  };
+}
+function buildConfigView(config) {
+  const providers = {};
+  for (const [name, provider] of Object.entries(config.providers)) {
+    providers[name] = toProviderView(provider);
+  }
+  return {
+    agents: config.agents,
+    providers,
+    channels: config.channels,
+    tools: config.tools,
+    gateway: config.gateway,
+    ui: config.ui
+  };
+}
+function buildConfigMeta(config) {
+  const providers = PROVIDERS.map((spec) => ({
+    name: spec.name,
+    displayName: spec.displayName,
+    keywords: spec.keywords,
+    envKey: spec.envKey,
+    isGateway: spec.isGateway,
+    isLocal: spec.isLocal,
+    defaultApiBase: spec.defaultApiBase
+  }));
+  const channels2 = Object.keys(config.channels).map((name) => ({
+    name,
+    displayName: name,
+    enabled: Boolean(config.channels[name]?.enabled)
+  }));
+  return { providers, channels: channels2 };
+}
+function loadConfigOrDefault(configPath) {
+  return loadConfig(configPath);
+}
+function updateModel(configPath, model) {
+  const config = loadConfigOrDefault(configPath);
+  config.agents.defaults.model = model;
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  return buildConfigView(next);
+}
+function updateProvider(configPath, providerName, patch) {
+  const config = loadConfigOrDefault(configPath);
+  const provider = config.providers[providerName];
+  if (!provider) {
+    return null;
+  }
+  if (Object.prototype.hasOwnProperty.call(patch, "apiKey")) {
+    provider.apiKey = patch.apiKey ?? "";
+  }
+  if (Object.prototype.hasOwnProperty.call(patch, "apiBase")) {
+    provider.apiBase = patch.apiBase ?? null;
+  }
+  if (Object.prototype.hasOwnProperty.call(patch, "extraHeaders")) {
+    provider.extraHeaders = patch.extraHeaders ?? null;
+  }
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  const updated = next.providers[providerName];
+  return toProviderView(updated);
+}
+function updateChannel(configPath, channelName, patch) {
+  const config = loadConfigOrDefault(configPath);
+  const channel = config.channels[channelName];
+  if (!channel) {
+    return null;
+  }
+  config.channels[channelName] = { ...channel, ...patch };
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  return next.channels[channelName];
+}
+function updateUi(configPath, patch) {
+  const config = loadConfigOrDefault(configPath);
+  config.ui = { ...config.ui, ...patch };
+  const next = ConfigSchema.parse(config);
+  saveConfig(next, configPath);
+  return next.ui;
+}
+
+// src/ui/router.ts
+function ok(data) {
+  return { ok: true, data };
+}
+function err(code, message, details) {
+  return { ok: false, error: { code, message, details } };
+}
+async function readJson(req) {
+  try {
+    const data = await req.json();
+    return { ok: true, data };
+  } catch {
+    return { ok: false };
+  }
+}
+function createUiRouter(options) {
+  const app = new Hono();
+  app.get("/api/health", (c) => c.json(ok({ status: "ok" })));
+  app.get("/api/config", (c) => {
+    const config = loadConfigOrDefault(options.configPath);
+    return c.json(ok(buildConfigView(config)));
+  });
+  app.get("/api/config/meta", (c) => {
+    const config = loadConfigOrDefault(options.configPath);
+    return c.json(ok(buildConfigMeta(config)));
+  });
+  app.put("/api/config/model", async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok || !body.data.model) {
+      return c.json(err("INVALID_BODY", "model is required"), 400);
+    }
+    const view = updateModel(options.configPath, body.data.model);
+    options.publish({ type: "config.updated", payload: { path: "agents.defaults.model" } });
+    return c.json(ok({ model: view.agents.defaults.model }));
+  });
+  app.put("/api/config/providers/:provider", async (c) => {
+    const provider = c.req.param("provider");
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = updateProvider(options.configPath, provider, body.data);
+    if (!result) {
+      return c.json(err("NOT_FOUND", `unknown provider: ${provider}`), 404);
+    }
+    options.publish({ type: "config.updated", payload: { path: `providers.${provider}` } });
+    return c.json(ok(result));
+  });
+  app.put("/api/config/channels/:channel", async (c) => {
+    const channel = c.req.param("channel");
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = updateChannel(options.configPath, channel, body.data);
+    if (!result) {
+      return c.json(err("NOT_FOUND", `unknown channel: ${channel}`), 404);
+    }
+    options.publish({ type: "config.updated", payload: { path: `channels.${channel}` } });
+    return c.json(ok(result));
+  });
+  app.put("/api/config/ui", async (c) => {
+    const body = await readJson(c.req.raw);
+    if (!body.ok) {
+      return c.json(err("INVALID_BODY", "invalid json body"), 400);
+    }
+    const result = updateUi(options.configPath, body.data);
+    options.publish({ type: "config.updated", payload: { path: "ui" } });
+    return c.json(ok(result));
+  });
+  app.post("/api/config/reload", async (c) => {
+    options.publish({ type: "config.reload.started" });
+    try {
+      await options.onReload?.();
+      options.publish({ type: "config.reload.finished" });
+      return c.json(ok({ status: "ok" }));
+    } catch (error) {
+      options.publish({
+        type: "error",
+        payload: { message: "reload failed", code: "RELOAD_FAILED" }
+      });
+      return c.json(err("RELOAD_FAILED", String(error ?? "reload failed")), 500);
+    }
+  });
+  return app;
+}
+
+// src/ui/server.ts
+import { serveStatic } from "hono/serve-static";
+var DEFAULT_CORS_ORIGINS = ["http://localhost:5173", "http://127.0.0.1:5173"];
+function startUiServer(options) {
+  const app = new Hono2();
+  const origin = options.corsOrigins ?? DEFAULT_CORS_ORIGINS;
+  app.use("/api/*", cors({ origin }));
+  const clients = /* @__PURE__ */ new Set();
+  const publish = (event) => {
+    const payload = JSON.stringify(event);
+    for (const client of clients) {
+      if (client.readyState === WebSocket2.OPEN) {
+        client.send(payload);
+      }
+    }
+  };
+  app.route(
+    "/",
+    createUiRouter({
+      configPath: options.configPath,
+      publish,
+      onReload: options.onReload
+    })
+  );
+  const staticDir = options.staticDir;
+  if (staticDir && existsSync5(join5(staticDir, "index.html"))) {
+    const indexHtml = readFileSync4(join5(staticDir, "index.html"), "utf-8");
+    app.use(
+      "/*",
+      serveStatic({
+        root: staticDir,
+        join: join5,
+        getContent: async (path) => {
+          try {
+            return await readFile(path);
+          } catch {
+            return null;
+          }
+        },
+        isDir: async (path) => {
+          try {
+            return (await stat(path)).isDirectory();
+          } catch {
+            return false;
+          }
+        }
+      })
+    );
+    app.get("*", (c) => {
+      const path = c.req.path;
+      if (path.startsWith("/api") || path.startsWith("/ws")) {
+        return c.notFound();
+      }
+      return c.html(indexHtml);
+    });
+  }
+  const server = serve({
+    fetch: app.fetch,
+    port: options.port,
+    hostname: options.host
+  });
+  const wss = new WebSocketServer({
+    server,
+    path: "/ws"
+  });
+  wss.on("connection", (socket) => {
+    clients.add(socket);
+    socket.on("close", () => clients.delete(socket));
+  });
+  return {
+    host: options.host,
+    port: options.port,
+    publish,
+    close: () => new Promise((resolve2) => {
+      wss.close(() => {
+        server.close(() => resolve2());
+      });
+    })
+  };
+}
+
 // src/cli/index.ts
 var LOGO = "\u{1F916}";
 var EXIT_COMMANDS = /* @__PURE__ */ new Set(["exit", "quit", "/exit", "/quit", ":q"]);
 var VERSION = getPackageVersion();
 var program = new Command();
-program.name("nextclaw").description(`${LOGO} nextclaw - Personal AI Assistant`).version(VERSION, "-v, --version", "show version");
-program.command("onboard").description("Initialize nextclaw configuration and workspace").action(() => {
+program.name(APP_NAME).description(`${LOGO} ${APP_NAME} - ${APP_TAGLINE}`).version(VERSION, "-v, --version", "show version");
+program.command("onboard").description(`Initialize ${APP_NAME} configuration and workspace`).action(() => {
   const configPath = getConfigPath();
-  if (existsSync5(configPath)) {
+  if (existsSync6(configPath)) {
     console.log(`Config already exists at ${configPath}`);
   }
   const config = ConfigSchema.parse({});
@@ -2774,68 +3067,77 @@ program.command("onboard").description("Initialize nextclaw configuration and wo
   console.log(`\u2713 Created workspace at ${workspace}`);
   createWorkspaceTemplates(workspace);
   console.log(`
-${LOGO} nextclaw is ready!`);
+${LOGO} ${APP_NAME} is ready!`);
   console.log("\nNext steps:");
   console.log(`  1. Add your API key to ${configPath}`);
-  console.log('  2. Chat: nextclaw agent -m "Hello!"');
+  console.log(`  2. Chat: ${APP_NAME} agent -m "Hello!"`);
+});
+program.command("gateway").description(`Start the ${APP_NAME} gateway`).option("-p, --port <port>", "Gateway port", "18790").option("-v, --verbose", "Verbose output", false).option("--ui", "Enable UI server", false).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--ui-open", "Open browser when UI starts", false).action(async (opts) => {
+  const uiOverrides = {};
+  if (opts.ui) {
+    uiOverrides.enabled = true;
+  }
+  if (opts.uiHost) {
+    uiOverrides.host = String(opts.uiHost);
+  }
+  if (opts.uiPort) {
+    uiOverrides.port = Number(opts.uiPort);
+  }
+  if (opts.uiOpen) {
+    uiOverrides.open = true;
+  }
+  await startGateway({ uiOverrides });
+});
+program.command("ui").description(`Start the ${APP_NAME} UI with gateway`).option("--host <host>", "UI host").option("--port <port>", "UI port").option("--no-open", "Disable opening browser").action(async (opts) => {
+  const uiOverrides = {
+    enabled: true,
+    open: Boolean(opts.open)
+  };
+  if (opts.host) {
+    uiOverrides.host = String(opts.host);
+  }
+  if (opts.port) {
+    uiOverrides.port = Number(opts.port);
+  }
+  await startGateway({ uiOverrides, allowMissingProvider: true });
 });
-program.command("gateway").description("Start the nextclaw gateway").option("-p, --port <port>", "Gateway port", "18790").option("-v, --verbose", "Verbose output", false).action(async (_opts) => {
+program.command("start").description(`Start the ${APP_NAME} gateway + UI (backend + frontend)`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend-port <port>", "UI frontend dev server port").option("--no-frontend", "Disable UI frontend dev server").option("--no-open", "Disable opening browser").action(async (opts) => {
+  const uiOverrides = {
+    enabled: true,
+    open: false
+  };
+  if (opts.uiHost) {
+    uiOverrides.host = String(opts.uiHost);
+  }
+  if (opts.uiPort) {
+    uiOverrides.port = Number(opts.uiPort);
+  }
   const config = loadConfig();
-  const bus = new MessageBus();
-  const provider = makeProvider(config);
-  const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
-  const cronStorePath = join5(getDataDir(), "cron", "jobs.json");
-  const cron2 = new CronService(cronStorePath);
-  const agent = new AgentLoop({
-    bus,
-    provider,
-    workspace: getWorkspacePath(config.agents.defaults.workspace),
-    model: config.agents.defaults.model,
-    maxIterations: config.agents.defaults.maxToolIterations,
-    braveApiKey: config.tools.web.search.apiKey || void 0,
-    execConfig: config.tools.exec,
-    cronService: cron2,
-    restrictToWorkspace: config.tools.restrictToWorkspace,
-    sessionManager
-  });
-  cron2.onJob = async (job) => {
-    const response = await agent.processDirect({
-      content: job.payload.message,
-      sessionKey: `cron:${job.id}`,
-      channel: job.payload.channel ?? "cli",
-      chatId: job.payload.to ?? "direct"
+  const uiConfig = resolveUiConfig(config, uiOverrides);
+  const staticDir = resolveUiStaticDir();
+  const frontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : 5173;
+  const shouldStartFrontend = opts.frontend !== false;
+  const frontendDir = shouldStartFrontend ? resolveUiFrontendDir() : null;
+  let frontendUrl = null;
+  if (shouldStartFrontend && frontendDir) {
+    const frontend = startUiFrontend({
+      apiBase: resolveUiApiBase(uiConfig.host, uiConfig.port),
+      port: frontendPort,
+      dir: frontendDir
     });
-    if (job.payload.deliver && job.payload.to) {
-      await bus.publishOutbound({
-        channel: job.payload.channel ?? "cli",
-        chatId: job.payload.to,
-        content: response,
-        media: [],
-        metadata: {}
-      });
-    }
-    return response;
-  };
-  const heartbeat = new HeartbeatService(
-    getWorkspacePath(config.agents.defaults.workspace),
-    async (prompt2) => agent.processDirect({ content: prompt2, sessionKey: "heartbeat" }),
-    30 * 60,
-    true
-  );
-  const channels2 = new ChannelManager(config, bus, sessionManager);
-  if (channels2.enabledChannels.length) {
-    console.log(`\u2713 Channels enabled: ${channels2.enabledChannels.join(", ")}`);
-  } else {
-    console.log("Warning: No channels enabled");
+    frontendUrl = frontend?.url ?? null;
+  } else if (shouldStartFrontend && !frontendDir && !staticDir) {
+    console.log("Warning: UI frontend not found. Start it separately.");
   }
-  const cronStatus = cron2.status();
-  if (cronStatus.jobs > 0) {
-    console.log(`\u2713 Cron: ${cronStatus.jobs} scheduled jobs`);
+  if (!frontendUrl && staticDir) {
+    frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
   }
-  console.log("\u2713 Heartbeat: every 30m");
-  await cron2.start();
-  await heartbeat.start();
-  await Promise.allSettled([agent.run(), channels2.startAll()]);
+  if (opts.open && frontendUrl) {
+    openBrowser(frontendUrl);
+  } else if (opts.open && !frontendUrl) {
+    console.log("Warning: UI frontend not started. Browser not opened.");
+  }
+  await startGateway({ uiOverrides, allowMissingProvider: true, uiStaticDir: staticDir ?? void 0 });
 });
 program.command("agent").description("Interact with the agent directly").option("-m, --message <message>", "Message to send to the agent").option("-s, --session <session>", "Session ID", "cli:default").option("--no-markdown", "Disable Markdown rendering").action(async (opts) => {
   const config = loadConfig();
@@ -2861,10 +3163,10 @@ program.command("agent").description("Interact with the agent directly").option(
   }
   console.log(`${LOGO} Interactive mode (type exit or Ctrl+C to quit)
 `);
-  const historyFile = join5(getDataDir(), "history", "cli_history");
+  const historyFile = join6(getDataDir(), "history", "cli_history");
   const historyDir = resolve(historyFile, "..");
   mkdirSync5(historyDir, { recursive: true });
-  const history = existsSync5(historyFile) ? readFileSync4(historyFile, "utf-8").split("\n").filter(Boolean) : [];
+  const history = existsSync6(historyFile) ? readFileSync5(historyFile, "utf-8").split("\n").filter(Boolean) : [];
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   rl.on("close", () => {
     const merged = history.concat(rl.history ?? []);
@@ -2910,7 +3212,7 @@ channels.command("login").description("Link device via QR code").action(() => {
 });
 var cron = program.command("cron").description("Manage scheduled tasks");
 cron.command("list").option("-a, --all", "Include disabled jobs").action((opts) => {
-  const storePath = join5(getDataDir(), "cron", "jobs.json");
+  const storePath = join6(getDataDir(), "cron", "jobs.json");
   const service = new CronService(storePath);
   const jobs = service.listJobs(Boolean(opts.all));
   if (!jobs.length) {
@@ -2930,7 +3232,7 @@ cron.command("list").option("-a, --all", "Include disabled jobs").action((opts)
   }
 });
 cron.command("add").requiredOption("-n, --name <name>", "Job name").requiredOption("-m, --message <message>", "Message for agent").option("-e, --every <seconds>", "Run every N seconds").option("-c, --cron <expr>", "Cron expression").option("--at <iso>", "Run once at time (ISO format)").option("-d, --deliver", "Deliver response to channel").option("--to <recipient>", "Recipient for delivery").option("--channel <channel>", "Channel for delivery").action((opts) => {
-  const storePath = join5(getDataDir(), "cron", "jobs.json");
+  const storePath = join6(getDataDir(), "cron", "jobs.json");
   const service = new CronService(storePath);
   let schedule = null;
   if (opts.every) {
@@ -2955,7 +3257,7 @@ cron.command("add").requiredOption("-n, --name <name>", "Job name").requiredOpti
   console.log(`\u2713 Added job '${job.name}' (${job.id})`);
 });
 cron.command("remove <jobId>").action((jobId) => {
-  const storePath = join5(getDataDir(), "cron", "jobs.json");
+  const storePath = join6(getDataDir(), "cron", "jobs.json");
   const service = new CronService(storePath);
   if (service.removeJob(jobId)) {
     console.log(`\u2713 Removed job ${jobId}`);
@@ -2964,7 +3266,7 @@ cron.command("remove <jobId>").action((jobId) => {
   }
 });
 cron.command("enable <jobId>").option("--disable", "Disable instead of enable").action((jobId, opts) => {
-  const storePath = join5(getDataDir(), "cron", "jobs.json");
+  const storePath = join6(getDataDir(), "cron", "jobs.json");
   const service = new CronService(storePath);
   const job = service.enableJob(jobId, !opts.disable);
   if (job) {
@@ -2974,19 +3276,19 @@ cron.command("enable <jobId>").option("--disable", "Disable instead of enable").
   }
 });
 cron.command("run <jobId>").option("-f, --force", "Run even if disabled").action(async (jobId, opts) => {
-  const storePath = join5(getDataDir(), "cron", "jobs.json");
+  const storePath = join6(getDataDir(), "cron", "jobs.json");
   const service = new CronService(storePath);
-  const ok = await service.runJob(jobId, Boolean(opts.force));
-  console.log(ok ? "\u2713 Job executed" : `Failed to run job ${jobId}`);
+  const ok2 = await service.runJob(jobId, Boolean(opts.force));
+  console.log(ok2 ? "\u2713 Job executed" : `Failed to run job ${jobId}`);
 });
-program.command("status").description("Show nextclaw status").action(() => {
+program.command("status").description(`Show ${APP_NAME} status`).action(() => {
   const configPath = getConfigPath();
   const config = loadConfig();
   const workspace = getWorkspacePath(config.agents.defaults.workspace);
-  console.log(`${LOGO} nextclaw Status
+  console.log(`${LOGO} ${APP_NAME} Status
 `);
-  console.log(`Config: ${configPath} ${existsSync5(configPath) ? "\u2713" : "\u2717"}`);
-  console.log(`Workspace: ${workspace} ${existsSync5(workspace) ? "\u2713" : "\u2717"}`);
+  console.log(`Config: ${configPath} ${existsSync6(configPath) ? "\u2713" : "\u2717"}`);
+  console.log(`Workspace: ${workspace} ${existsSync6(workspace) ? "\u2713" : "\u2717"}`);
   console.log(`Model: ${config.agents.defaults.model}`);
   for (const spec of PROVIDERS) {
     const provider = config.providers[spec.name];
@@ -3001,12 +3303,169 @@ program.command("status").description("Show nextclaw status").action(() => {
   }
 });
 program.parseAsync(process.argv);
-function makeProvider(config) {
+async function startGateway(options = {}) {
+  const config = loadConfig();
+  const bus = new MessageBus();
+  const provider = options.allowMissingProvider === true ? makeProvider(config, { allowMissing: true }) : makeProvider(config);
+  const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
+  const cronStorePath = join6(getDataDir(), "cron", "jobs.json");
+  const cron2 = new CronService(cronStorePath);
+  const uiConfig = resolveUiConfig(config, options.uiOverrides);
+  const uiStaticDir = options.uiStaticDir ?? resolveUiStaticDir();
+  if (!provider) {
+    if (uiConfig.enabled) {
+      const uiServer = startUiServer({
+        host: uiConfig.host,
+        port: uiConfig.port,
+        configPath: getConfigPath(),
+        staticDir: uiStaticDir ?? void 0,
+        onReload: async () => {
+          return;
+        }
+      });
+      const uiUrl = `http://${uiServer.host}:${uiServer.port}`;
+      console.log(`\u2713 UI API: ${uiUrl}/api`);
+      if (uiStaticDir) {
+        console.log(`\u2713 UI frontend: ${uiUrl}`);
+      }
+      if (uiConfig.open) {
+        openBrowser(uiUrl);
+      }
+    }
+    console.log("Warning: No API key configured. UI server only.");
+    await new Promise(() => {
+    });
+    return;
+  }
+  const agent = new AgentLoop({
+    bus,
+    provider,
+    workspace: getWorkspacePath(config.agents.defaults.workspace),
+    model: config.agents.defaults.model,
+    maxIterations: config.agents.defaults.maxToolIterations,
+    braveApiKey: config.tools.web.search.apiKey || void 0,
+    execConfig: config.tools.exec,
+    cronService: cron2,
+    restrictToWorkspace: config.tools.restrictToWorkspace,
+    sessionManager
+  });
+  cron2.onJob = async (job) => {
+    const response = await agent.processDirect({
+      content: job.payload.message,
+      sessionKey: `cron:${job.id}`,
+      channel: job.payload.channel ?? "cli",
+      chatId: job.payload.to ?? "direct"
+    });
+    if (job.payload.deliver && job.payload.to) {
+      await bus.publishOutbound({
+        channel: job.payload.channel ?? "cli",
+        chatId: job.payload.to,
+        content: response,
+        media: [],
+        metadata: {}
+      });
+    }
+    return response;
+  };
+  const heartbeat = new HeartbeatService(
+    getWorkspacePath(config.agents.defaults.workspace),
+    async (prompt2) => agent.processDirect({ content: prompt2, sessionKey: "heartbeat" }),
+    30 * 60,
+    true
+  );
+  const channels2 = new ChannelManager(config, bus, sessionManager);
+  if (channels2.enabledChannels.length) {
+    console.log(`\u2713 Channels enabled: ${channels2.enabledChannels.join(", ")}`);
+  } else {
+    console.log("Warning: No channels enabled");
+  }
+  if (uiConfig.enabled) {
+    const uiServer = startUiServer({
+      host: uiConfig.host,
+      port: uiConfig.port,
+      configPath: getConfigPath(),
+      staticDir: uiStaticDir ?? void 0,
+      onReload: async () => {
+        return;
+      }
+    });
+    const uiUrl = `http://${uiServer.host}:${uiServer.port}`;
+    console.log(`\u2713 UI API: ${uiUrl}/api`);
+    if (uiStaticDir) {
+      console.log(`\u2713 UI frontend: ${uiUrl}`);
+    }
+    if (uiConfig.open) {
+      openBrowser(uiUrl);
+    }
+  }
+  const cronStatus = cron2.status();
+  if (cronStatus.jobs > 0) {
+    console.log(`\u2713 Cron: ${cronStatus.jobs} scheduled jobs`);
+  }
+  console.log("\u2713 Heartbeat: every 30m");
+  await cron2.start();
+  await heartbeat.start();
+  await Promise.allSettled([agent.run(), channels2.startAll()]);
+}
+function resolveUiConfig(config, overrides) {
+  const base = config.ui ?? { enabled: false, host: "127.0.0.1", port: 18791, open: false };
+  return { ...base, ...overrides ?? {} };
+}
+function resolveUiApiBase(host, port) {
+  const normalizedHost = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
+  return `http://${normalizedHost}:${port}`;
+}
+function resolveUiStaticDir() {
+  const candidates = [];
+  const envDir = process.env.NEXTCLAW_UI_STATIC_DIR;
+  if (envDir) {
+    candidates.push(envDir);
+  }
+  const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
+  const pkgRoot = resolve(cliDir, "..", "..");
+  candidates.push(join6(pkgRoot, "ui-dist"));
+  candidates.push(join6(pkgRoot, "ui"));
+  candidates.push(join6(pkgRoot, "..", "ui-dist"));
+  candidates.push(join6(pkgRoot, "..", "ui"));
+  const cwd = process.cwd();
+  candidates.push(join6(cwd, "packages", "nextclaw-ui", "dist"));
+  candidates.push(join6(cwd, "nextclaw-ui", "dist"));
+  candidates.push(join6(pkgRoot, "..", "nextclaw-ui", "dist"));
+  candidates.push(join6(pkgRoot, "..", "..", "packages", "nextclaw-ui", "dist"));
+  candidates.push(join6(pkgRoot, "..", "..", "nextclaw-ui", "dist"));
+  for (const dir of candidates) {
+    if (existsSync6(join6(dir, "index.html"))) {
+      return dir;
+    }
+  }
+  return null;
+}
+function openBrowser(url) {
+  const platform = process.platform;
+  let command;
+  let args;
+  if (platform === "darwin") {
+    command = "open";
+    args = [url];
+  } else if (platform === "win32") {
+    command = "cmd";
+    args = ["/c", "start", "", url];
+  } else {
+    command = "xdg-open";
+    args = [url];
+  }
+  const child = spawn(command, args, { stdio: "ignore", detached: true });
+  child.unref();
+}
+function makeProvider(config, options) {
   const provider = getProvider(config);
   const model = config.agents.defaults.model;
   if (!provider?.apiKey && !model.startsWith("bedrock/")) {
+    if (options?.allowMissing) {
+      return null;
+    }
     console.error("Error: No API key configured.");
-    console.error("Set one in ~/.nextclaw/config.json under providers section");
+    console.error(`Set one in ${getConfigPath()} under providers section`);
     process.exit(1);
   }
   return new LiteLLMProvider({
@@ -3020,25 +3479,40 @@ function makeProvider(config) {
 function createWorkspaceTemplates(workspace) {
   const templates = {
     "AGENTS.md": "# Agent Instructions\n\nYou are a helpful AI assistant. Be concise, accurate, and friendly.\n\n## Guidelines\n\n- Always explain what you're doing before taking actions\n- Ask for clarification when the request is ambiguous\n- Use tools to help accomplish tasks\n- Remember important information in your memory files\n",
-    "SOUL.md": "# Soul\n\nI am nextclaw, a lightweight AI assistant.\n\n## Personality\n\n- Helpful and friendly\n- Concise and to the point\n- Curious and eager to learn\n\n## Values\n\n- Accuracy over speed\n- User privacy and safety\n- Transparency in actions\n",
+    "SOUL.md": `# Soul
+
+I am ${APP_NAME}, a lightweight AI assistant.
+
+## Personality
+
+- Helpful and friendly
+- Concise and to the point
+- Curious and eager to learn
+
+## Values
+
+- Accuracy over speed
+- User privacy and safety
+- Transparency in actions
+`,
     "USER.md": "# User\n\nInformation about the user goes here.\n\n## Preferences\n\n- Communication style: (casual/formal)\n- Timezone: (your timezone)\n- Language: (your preferred language)\n"
   };
   for (const [filename, content] of Object.entries(templates)) {
-    const filePath = join5(workspace, filename);
-    if (!existsSync5(filePath)) {
+    const filePath = join6(workspace, filename);
+    if (!existsSync6(filePath)) {
       writeFileSync4(filePath, content);
     }
   }
-  const memoryDir = join5(workspace, "memory");
+  const memoryDir = join6(workspace, "memory");
   mkdirSync5(memoryDir, { recursive: true });
-  const memoryFile = join5(memoryDir, "MEMORY.md");
-  if (!existsSync5(memoryFile)) {
+  const memoryFile = join6(memoryDir, "MEMORY.md");
+  if (!existsSync6(memoryFile)) {
     writeFileSync4(
       memoryFile,
       "# Long-term Memory\n\nThis file stores important information that should persist across sessions.\n\n## User Information\n\n(Important facts about the user)\n\n## Preferences\n\n(User preferences learned over time)\n\n## Important Notes\n\n(Things to remember)\n"
     );
   }
-  const skillsDir = join5(workspace, "skills");
+  const skillsDir = join6(workspace, "skills");
   mkdirSync5(skillsDir, { recursive: true });
 }
 function printAgentResponse(response) {
@@ -3052,8 +3526,8 @@ async function prompt(rl, question) {
   });
 }
 function getBridgeDir() {
-  const userBridge = join5(getDataDir(), "bridge");
-  if (existsSync5(join5(userBridge, "dist", "index.js"))) {
+  const userBridge = join6(getDataDir(), "bridge");
+  if (existsSync6(join6(userBridge, "dist", "index.js"))) {
     return userBridge;
   }
   if (!which("npm")) {
@@ -3062,21 +3536,21 @@ function getBridgeDir() {
   }
   const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
   const pkgRoot = resolve(cliDir, "..", "..");
-  const pkgBridge = join5(pkgRoot, "bridge");
-  const srcBridge = join5(pkgRoot, "..", "..", "bridge");
+  const pkgBridge = join6(pkgRoot, "bridge");
+  const srcBridge = join6(pkgRoot, "..", "..", "bridge");
   let source = null;
-  if (existsSync5(join5(pkgBridge, "package.json"))) {
+  if (existsSync6(join6(pkgBridge, "package.json"))) {
     source = pkgBridge;
-  } else if (existsSync5(join5(srcBridge, "package.json"))) {
+  } else if (existsSync6(join6(srcBridge, "package.json"))) {
     source = srcBridge;
   }
   if (!source) {
-    console.error("Bridge source not found. Try reinstalling nextclaw.");
+    console.error(`Bridge source not found. Try reinstalling ${APP_NAME}.`);
     process.exit(1);
   }
   console.log(`${LOGO} Setting up bridge...`);
   mkdirSync5(resolve(userBridge, ".."), { recursive: true });
-  if (existsSync5(userBridge)) {
+  if (existsSync6(userBridge)) {
     rmSync(userBridge, { recursive: true, force: true });
   }
   cpSync(source, userBridge, {
@@ -3106,7 +3580,7 @@ function getPackageVersion() {
   try {
     const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
     const pkgPath = resolve(cliDir, "..", "..", "package.json");
-    const raw = readFileSync4(pkgPath, "utf-8");
+    const raw = readFileSync5(pkgPath, "utf-8");
     const parsed = JSON.parse(raw);
     return typeof parsed.version === "string" ? parsed.version : "0.0.0";
   } catch {
@@ -3116,10 +3590,65 @@ function getPackageVersion() {
 function which(binary) {
   const paths = (process.env.PATH ?? "").split(":");
   for (const dir of paths) {
-    const full = join5(dir, binary);
-    if (existsSync5(full)) {
+    const full = join6(dir, binary);
+    if (existsSync6(full)) {
       return true;
     }
   }
   return false;
 }
+function startUiFrontend(options) {
+  const uiDir = options.dir ?? resolveUiFrontendDir();
+  if (!uiDir) {
+    return null;
+  }
+  const runner = resolveUiFrontendRunner();
+  if (!runner) {
+    console.log("Warning: pnpm/npm not found. Skipping UI frontend.");
+    return null;
+  }
+  const args = [...runner.args];
+  if (options.port) {
+    args.push("--", "--port", String(options.port));
+  }
+  const env = { ...process.env, VITE_API_BASE: options.apiBase };
+  const child = spawn(runner.cmd, args, { cwd: uiDir, stdio: "inherit", env });
+  child.on("exit", (code) => {
+    if (code && code !== 0) {
+      console.log(`UI frontend exited with code ${code}`);
+    }
+  });
+  const url = `http://127.0.0.1:${options.port}`;
+  console.log(`\u2713 UI frontend: ${url}`);
+  return { url, dir: uiDir };
+}
+function resolveUiFrontendRunner() {
+  if (which("pnpm")) {
+    return { cmd: "pnpm", args: ["dev"] };
+  }
+  if (which("npm")) {
+    return { cmd: "npm", args: ["run", "dev"] };
+  }
+  return null;
+}
+function resolveUiFrontendDir() {
+  const candidates = [];
+  const envDir = process.env.NEXTCLAW_UI_DIR;
+  if (envDir) {
+    candidates.push(envDir);
+  }
+  const cwd = process.cwd();
+  candidates.push(join6(cwd, "packages", "nextclaw-ui"));
+  candidates.push(join6(cwd, "nextclaw-ui"));
+  const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
+  const pkgRoot = resolve(cliDir, "..", "..");
+  candidates.push(join6(pkgRoot, "..", "nextclaw-ui"));
+  candidates.push(join6(pkgRoot, "..", "..", "packages", "nextclaw-ui"));
+  candidates.push(join6(pkgRoot, "..", "..", "nextclaw-ui"));
+  for (const dir of candidates) {
+    if (existsSync6(join6(dir, "package.json"))) {
+      return dir;
+    }
+  }
+  return null;
+}