nextclaw 0.2.9 → 0.3.1

package/dist/cli/index.js

@@ -2,27 +2,14 @@
 
 // src/cli/index.ts
 import { Command } from "commander";
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  writeFileSync,
-  cpSync,
-  rmSync,
-  openSync,
-  closeSync
-} from "fs";
-import { join, resolve } from "path";
-import { spawn, spawnSync } from "child_process";
-import { createInterface } from "readline";
-import { fileURLToPath } from "url";
-import { createServer } from "net";
-import chokidar from "chokidar";
+import { APP_NAME as APP_NAME2, APP_TAGLINE } from "nextclaw-core";
+
+// src/cli/runtime.ts
 import {
   loadConfig,
   saveConfig,
   getConfigPath,
-  getDataDir,
+  getDataDir as getDataDir2,
   ConfigSchema,
   getApiBase,
   getProvider,
@@ -33,485 +20,38 @@ import {
   MessageBus,
   AgentLoop,
   LiteLLMProvider,
+  ProviderManager,
   ChannelManager,
   SessionManager,
   CronService,
   HeartbeatService,
   PROVIDERS,
-  APP_NAME,
-  APP_TAGLINE
+  APP_NAME
 } from "nextclaw-core";
 import { startUiServer } from "nextclaw-server";
-var LOGO = "\u{1F916}";
-var EXIT_COMMANDS = /* @__PURE__ */ new Set(["exit", "quit", "/exit", "/quit", ":q"]);
-var VERSION = getPackageVersion();
-var program = new Command();
-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 (existsSync(configPath)) {
-    console.log(`Config already exists at ${configPath}`);
-  }
-  const config = ConfigSchema.parse({});
-  saveConfig(config);
-  console.log(`\u2713 Created config at ${configPath}`);
-  const workspace = getWorkspacePath();
-  console.log(`\u2713 Created workspace at ${workspace}`);
-  createWorkspaceTemplates(workspace);
-  console.log(`
-${LOGO} ${APP_NAME} is ready!`);
-  console.log("\nNext steps:");
-  console.log(`  1. Add your API key to ${configPath}`);
-  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("start").description(`Start the ${APP_NAME} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).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 devMode = isDevRuntime();
-  if (devMode) {
-    const requestedUiPort = Number.isFinite(Number(opts.uiPort)) ? Number(opts.uiPort) : 18792;
-    const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : 5174;
-    const uiHost = uiOverrides.host ?? "127.0.0.1";
-    const devUiPort = await findAvailablePort(requestedUiPort, uiHost);
-    const shouldStartFrontend = opts.frontend === void 0 ? true : Boolean(opts.frontend);
-    const devFrontendPort = shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
-    uiOverrides.port = devUiPort;
-    if (requestedUiPort !== devUiPort) {
-      console.log(`Dev mode: UI port ${requestedUiPort} is in use, switched to ${devUiPort}.`);
-    }
-    if (shouldStartFrontend && requestedFrontendPort !== devFrontendPort) {
-      console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${devFrontendPort}.`);
-    }
-    console.log(`Dev mode: UI ${devUiPort}, Frontend ${devFrontendPort}`);
-    console.log("Dev mode runs in the foreground (Ctrl+C to stop).");
-    await runForeground({
-      uiOverrides,
-      frontend: shouldStartFrontend,
-      frontendPort: devFrontendPort,
-      open: Boolean(opts.open)
-    });
-    return;
-  }
-  await startService({
-    uiOverrides,
-    frontend: Boolean(opts.frontend),
-    frontendPort: Number(opts.frontendPort),
-    open: Boolean(opts.open)
-  });
-});
-program.command("serve").description(`Run the ${APP_NAME} gateway + UI in the foreground`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).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 devMode = isDevRuntime();
-  if (devMode && uiOverrides.port === void 0) {
-    uiOverrides.port = 18792;
-  }
-  const shouldStartFrontend = Boolean(opts.frontend);
-  const defaultFrontendPort = devMode ? 5174 : 5173;
-  const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : defaultFrontendPort;
-  if (devMode && uiOverrides.port !== void 0) {
-    const uiHost = uiOverrides.host ?? "127.0.0.1";
-    const uiPort = await findAvailablePort(uiOverrides.port, uiHost);
-    if (uiPort !== uiOverrides.port) {
-      console.log(`Dev mode: UI port ${uiOverrides.port} is in use, switched to ${uiPort}.`);
-      uiOverrides.port = uiPort;
-    }
-  }
-  const frontendPort = devMode && shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
-  if (devMode && shouldStartFrontend && frontendPort !== requestedFrontendPort) {
-    console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${frontendPort}.`);
-  }
-  await runForeground({
-    uiOverrides,
-    frontend: shouldStartFrontend,
-    frontendPort,
-    open: Boolean(opts.open)
-  });
-});
-program.command("stop").description(`Stop the ${APP_NAME} background service`).action(async () => {
-  await stopService();
-});
-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();
-  const bus = new MessageBus();
-  const provider = makeProvider(config);
-  const agentLoop = new AgentLoop({
-    bus,
-    provider,
-    workspace: getWorkspacePath(config.agents.defaults.workspace),
-    braveApiKey: config.tools.web.search.apiKey || void 0,
-    execConfig: config.tools.exec,
-    restrictToWorkspace: config.tools.restrictToWorkspace
-  });
-  if (opts.message) {
-    const response = await agentLoop.processDirect({
-      content: opts.message,
-      sessionKey: opts.session,
-      channel: "cli",
-      chatId: "direct"
-    });
-    printAgentResponse(response);
-    return;
-  }
-  console.log(`${LOGO} Interactive mode (type exit or Ctrl+C to quit)
-`);
-  const historyFile = join(getDataDir(), "history", "cli_history");
-  const historyDir = resolve(historyFile, "..");
-  mkdirSync(historyDir, { recursive: true });
-  const history = existsSync(historyFile) ? readFileSync(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 ?? []);
-    writeFileSync(historyFile, merged.join("\n"));
-    process.exit(0);
-  });
-  let running = true;
-  while (running) {
-    const line = await prompt(rl, "You: ");
-    const trimmed = line.trim();
-    if (!trimmed) {
-      continue;
-    }
-    if (EXIT_COMMANDS.has(trimmed.toLowerCase())) {
-      rl.close();
-      running = false;
-      break;
-    }
-    const response = await agentLoop.processDirect({ content: trimmed, sessionKey: opts.session });
-    printAgentResponse(response);
-  }
-});
-var channels = program.command("channels").description("Manage channels");
-channels.command("status").description("Show channel status").action(() => {
-  const config = loadConfig();
-  console.log("Channel Status");
-  console.log(`WhatsApp: ${config.channels.whatsapp.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`Discord: ${config.channels.discord.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`Feishu: ${config.channels.feishu.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`Mochat: ${config.channels.mochat.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`Telegram: ${config.channels.telegram.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`Slack: ${config.channels.slack.enabled ? "\u2713" : "\u2717"}`);
-  console.log(`QQ: ${config.channels.qq.enabled ? "\u2713" : "\u2717"}`);
-});
-channels.command("login").description("Link device via QR code").action(() => {
-  const bridgeDir = getBridgeDir();
-  console.log(`${LOGO} Starting bridge...`);
-  console.log("Scan the QR code to connect.\n");
-  const result = spawnSync("npm", ["start"], { cwd: bridgeDir, stdio: "inherit" });
-  if (result.status !== 0) {
-    console.error(`Bridge failed: ${result.status ?? 1}`);
-  }
-});
-var cron = program.command("cron").description("Manage scheduled tasks");
-cron.command("list").option("-a, --all", "Include disabled jobs").action((opts) => {
-  const storePath = join(getDataDir(), "cron", "jobs.json");
-  const service = new CronService(storePath);
-  const jobs = service.listJobs(Boolean(opts.all));
-  if (!jobs.length) {
-    console.log("No scheduled jobs.");
-    return;
-  }
-  for (const job of jobs) {
-    let schedule = "";
-    if (job.schedule.kind === "every") {
-      schedule = `every ${Math.round((job.schedule.everyMs ?? 0) / 1e3)}s`;
-    } else if (job.schedule.kind === "cron") {
-      schedule = job.schedule.expr ?? "";
-    } else {
-      schedule = job.schedule.atMs ? new Date(job.schedule.atMs).toISOString() : "";
-    }
-    console.log(`${job.id} ${job.name} ${schedule}`);
-  }
-});
-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 = join(getDataDir(), "cron", "jobs.json");
-  const service = new CronService(storePath);
-  let schedule = null;
-  if (opts.every) {
-    schedule = { kind: "every", everyMs: Number(opts.every) * 1e3 };
-  } else if (opts.cron) {
-    schedule = { kind: "cron", expr: String(opts.cron) };
-  } else if (opts.at) {
-    schedule = { kind: "at", atMs: Date.parse(String(opts.at)) };
-  }
-  if (!schedule) {
-    console.error("Error: Must specify --every, --cron, or --at");
-    return;
-  }
-  const job = service.addJob({
-    name: opts.name,
-    schedule,
-    message: opts.message,
-    deliver: Boolean(opts.deliver),
-    channel: opts.channel,
-    to: opts.to
-  });
-  console.log(`\u2713 Added job '${job.name}' (${job.id})`);
-});
-cron.command("remove <jobId>").action((jobId) => {
-  const storePath = join(getDataDir(), "cron", "jobs.json");
-  const service = new CronService(storePath);
-  if (service.removeJob(jobId)) {
-    console.log(`\u2713 Removed job ${jobId}`);
-  } else {
-    console.log(`Job ${jobId} not found`);
-  }
-});
-cron.command("enable <jobId>").option("--disable", "Disable instead of enable").action((jobId, opts) => {
-  const storePath = join(getDataDir(), "cron", "jobs.json");
-  const service = new CronService(storePath);
-  const job = service.enableJob(jobId, !opts.disable);
-  if (job) {
-    console.log(`\u2713 Job '${job.name}' ${opts.disable ? "disabled" : "enabled"}`);
-  } else {
-    console.log(`Job ${jobId} not found`);
-  }
-});
-cron.command("run <jobId>").option("-f, --force", "Run even if disabled").action(async (jobId, opts) => {
-  const storePath = join(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}`);
-});
-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} ${APP_NAME} Status
-`);
-  console.log(`Config: ${configPath} ${existsSync(configPath) ? "\u2713" : "\u2717"}`);
-  console.log(`Workspace: ${workspace} ${existsSync(workspace) ? "\u2713" : "\u2717"}`);
-  console.log(`Model: ${config.agents.defaults.model}`);
-  for (const spec of PROVIDERS) {
-    const provider = config.providers[spec.name];
-    if (!provider) {
-      continue;
-    }
-    if (spec.isLocal) {
-      console.log(`${spec.displayName ?? spec.name}: ${provider.apiBase ? `\u2713 ${provider.apiBase}` : "not set"}`);
-    } else {
-      console.log(`${spec.displayName ?? spec.name}: ${provider.apiKey ? "\u2713" : "not set"}`);
-    }
-  }
-});
-program.parseAsync(process.argv);
-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 = join(getDataDir(), "cron", "jobs.json");
-  const cron2 = new CronService(cronStorePath);
-  const uiConfig = resolveUiConfig(config, options.uiOverrides);
-  const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
-  if (!provider) {
-    if (uiConfig.enabled) {
-      const uiServer = startUiServer({
-        host: uiConfig.host,
-        port: uiConfig.port,
-        configPath: getConfigPath(),
-        staticDir: uiStaticDir ?? void 0
-      });
-      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
-  );
-  let currentConfig = config;
-  let channels2 = new ChannelManager(currentConfig, bus, sessionManager);
-  let reloadTask = null;
-  const reloadChannels = async (nextConfig) => {
-    if (reloadTask) {
-      await reloadTask;
-      return;
-    }
-    reloadTask = (async () => {
-      await channels2.stopAll();
-      channels2 = new ChannelManager(nextConfig, bus, sessionManager);
-      await channels2.startAll();
-    })();
-    try {
-      await reloadTask;
-    } finally {
-      reloadTask = null;
-    }
-  };
-  const applyReloadPlan = async (nextConfig) => {
-    const changedPaths = diffConfigPaths(currentConfig, nextConfig);
-    if (!changedPaths.length) {
-      return;
-    }
-    currentConfig = nextConfig;
-    const plan = buildReloadPlan(changedPaths);
-    if (plan.restartChannels) {
-      await reloadChannels(nextConfig);
-    }
-    if (plan.restartRequired.length > 0) {
-      console.warn(`Config changes require restart: ${plan.restartRequired.join(", ")}`);
-    }
-  };
-  let reloadTimer = null;
-  let reloadRunning = false;
-  let reloadPending = false;
-  const scheduleConfigReload = (reason) => {
-    if (reloadTimer) {
-      clearTimeout(reloadTimer);
-    }
-    reloadTimer = setTimeout(() => {
-      void runConfigReload(reason);
-    }, 300);
-  };
-  const runConfigReload = async (reason) => {
-    if (reloadRunning) {
-      reloadPending = true;
-      return;
-    }
-    reloadRunning = true;
-    if (reloadTimer) {
-      clearTimeout(reloadTimer);
-      reloadTimer = null;
-    }
-    try {
-      const nextConfig = loadConfig();
-      await applyReloadPlan(nextConfig);
-    } catch (error) {
-      console.error(`Config reload failed (${reason}): ${String(error)}`);
-    } finally {
-      reloadRunning = false;
-      if (reloadPending) {
-        reloadPending = false;
-        scheduleConfigReload("pending");
-      }
-    }
-  };
-  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
-    });
-    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");
-  const configPath = getConfigPath();
-  const watcher = chokidar.watch(configPath, {
-    ignoreInitial: true,
-    awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }
-  });
-  watcher.on("add", () => scheduleConfigReload("config add"));
-  watcher.on("change", () => scheduleConfigReload("config change"));
-  watcher.on("unlink", () => scheduleConfigReload("config unlink"));
-  await cron2.start();
-  await heartbeat.start();
-  await Promise.allSettled([agent.run(), channels2.startAll()]);
-}
+import {
+  closeSync,
+  cpSync,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  openSync,
+  readFileSync as readFileSync2,
+  rmSync as rmSync2,
+  writeFileSync as writeFileSync2
+} from "fs";
+import { join as join2, resolve as resolve2 } from "path";
+import { spawn as spawn2, spawnSync } from "child_process";
+import { createInterface } from "readline";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import chokidar from "chokidar";
+
+// src/cli/utils.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
+import { join, resolve } from "path";
+import { spawn } from "child_process";
+import { createServer } from "net";
+import { fileURLToPath } from "url";
+import { getDataDir } from "nextclaw-core";
 function resolveUiConfig(config, overrides) {
   const base = config.ui ?? { enabled: false, host: "127.0.0.1", port: 18791, open: false };
   return { ...base, ...overrides ?? {} };
@@ -546,149 +86,26 @@ async function isPortAvailable(port, host) {
   } else if (checkHost === "::1") {
     hostsToCheck.push("127.0.0.1");
   }
-  for (const hostToCheck of hostsToCheck) {
-    const ok = await canBindPort(port, hostToCheck);
-    if (!ok) {
-      return false;
+  for (const candidate of hostsToCheck) {
+    const ok = await canBindPort(port, candidate);
+    if (ok) {
+      return true;
     }
   }
-  return true;
+  return false;
 }
 async function canBindPort(port, host) {
-  return await new Promise((resolve2) => {
+  return await new Promise((resolve3) => {
     const server = createServer();
     server.unref();
-    server.once("error", () => resolve2(false));
+    server.once("error", () => resolve3(false));
     server.listen({ port, host }, () => {
-      server.close(() => resolve2(true));
+      server.close(() => resolve3(true));
     });
   });
 }
-async function runForeground(options) {
-  const config = loadConfig();
-  const uiConfig = resolveUiConfig(config, options.uiOverrides);
-  const shouldStartFrontend = options.frontend;
-  const frontendPort = Number.isFinite(options.frontendPort) ? options.frontendPort : 5173;
-  const frontendDir = shouldStartFrontend ? resolveUiFrontendDir() : null;
-  const staticDir = resolveUiStaticDir();
-  let frontendUrl = null;
-  if (shouldStartFrontend && frontendDir) {
-    const frontend = startUiFrontend({
-      apiBase: resolveUiApiBase(uiConfig.host, uiConfig.port),
-      port: frontendPort,
-      dir: frontendDir
-    });
-    frontendUrl = frontend?.url ?? null;
-  } else if (shouldStartFrontend && !frontendDir) {
-    console.log("Warning: UI frontend not found. Start it separately.");
-  }
-  if (!frontendUrl && staticDir) {
-    frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
-  }
-  if (options.open && frontendUrl) {
-    openBrowser(frontendUrl);
-  } else if (options.open && !frontendUrl) {
-    console.log("Warning: UI frontend not started. Browser not opened.");
-  }
-  const uiStaticDir = shouldStartFrontend && frontendDir ? null : staticDir;
-  await startGateway({
-    uiOverrides: options.uiOverrides,
-    allowMissingProvider: true,
-    uiStaticDir
-  });
-}
-async function startService(options) {
-  const config = loadConfig();
-  const uiConfig = resolveUiConfig(config, options.uiOverrides);
-  const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
-  const apiUrl = `${uiUrl}/api`;
-  const staticDir = resolveUiStaticDir();
-  const existing = readServiceState();
-  if (existing && isProcessRunning(existing.pid)) {
-    console.log(`\u2713 ${APP_NAME} is already running (PID ${existing.pid})`);
-    console.log(`UI: ${existing.uiUrl}`);
-    console.log(`API: ${existing.apiUrl}`);
-    console.log(`Logs: ${existing.logPath}`);
-    console.log(`Stop: ${APP_NAME} stop`);
-    return;
-  }
-  if (existing) {
-    clearServiceState();
-  }
-  if (!staticDir && !options.frontend) {
-    console.log("Warning: UI frontend not found. Use --frontend to start the dev server.");
-  }
-  const logPath = resolveServiceLogPath();
-  const logDir = resolve(logPath, "..");
-  mkdirSync(logDir, { recursive: true });
-  const logFd = openSync(logPath, "a");
-  const serveArgs = buildServeArgs({
-    uiHost: uiConfig.host,
-    uiPort: uiConfig.port,
-    frontend: options.frontend,
-    frontendPort: options.frontendPort
-  });
-  const child = spawn(process.execPath, [...process.execArgv, ...serveArgs], {
-    env: process.env,
-    stdio: ["ignore", logFd, logFd],
-    detached: true
-  });
-  closeSync(logFd);
-  if (!child.pid) {
-    console.error("Error: Failed to start background service.");
-    return;
-  }
-  child.unref();
-  const state = {
-    pid: child.pid,
-    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    uiUrl,
-    apiUrl,
-    logPath
-  };
-  writeServiceState(state);
-  console.log(`\u2713 ${APP_NAME} started in background (PID ${state.pid})`);
-  console.log(`UI: ${uiUrl}`);
-  console.log(`API: ${apiUrl}`);
-  console.log(`Logs: ${logPath}`);
-  console.log(`Stop: ${APP_NAME} stop`);
-  if (options.open) {
-    openBrowser(uiUrl);
-  }
-}
-async function stopService() {
-  const state = readServiceState();
-  if (!state) {
-    console.log("No running service found.");
-    return;
-  }
-  if (!isProcessRunning(state.pid)) {
-    console.log("Service is not running. Cleaning up state.");
-    clearServiceState();
-    return;
-  }
-  console.log(`Stopping ${APP_NAME} (PID ${state.pid})...`);
-  try {
-    process.kill(state.pid, "SIGTERM");
-  } catch (error) {
-    console.error(`Failed to stop service: ${String(error)}`);
-    return;
-  }
-  const stopped = await waitForExit(state.pid, 3e3);
-  if (!stopped) {
-    try {
-      process.kill(state.pid, "SIGKILL");
-    } catch (error) {
-      console.error(`Failed to force stop service: ${String(error)}`);
-      return;
-    }
-    await waitForExit(state.pid, 2e3);
-  }
-  clearServiceState();
-  console.log(`\u2713 ${APP_NAME} stopped`);
-}
 function buildServeArgs(options) {
-  const cliPath = fileURLToPath(import.meta.url);
+  const cliPath = fileURLToPath(new URL("./index.js", import.meta.url));
   const args = [cliPath, "serve", "--ui-host", options.uiHost, "--ui-port", String(options.uiPort)];
   if (options.frontend) {
     args.push("--frontend");
@@ -741,7 +158,7 @@ async function waitForExit(pid, timeoutMs) {
     if (!isProcessRunning(pid)) {
       return true;
     }
-    await new Promise((resolve2) => setTimeout(resolve2, 200));
+    await new Promise((resolve3) => setTimeout(resolve3, 200));
   }
   return !isProcessRunning(pid);
 }
@@ -787,125 +204,6 @@ function openBrowser(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 ${getConfigPath()} under providers section`);
-    process.exit(1);
-  }
-  return new LiteLLMProvider({
-    apiKey: provider?.apiKey ?? null,
-    apiBase: getApiBase(config),
-    defaultModel: model,
-    extraHeaders: provider?.extraHeaders ?? null,
-    providerName: getProviderName(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
-
-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 = join(workspace, filename);
-    if (!existsSync(filePath)) {
-      writeFileSync(filePath, content);
-    }
-  }
-  const memoryDir = join(workspace, "memory");
-  mkdirSync(memoryDir, { recursive: true });
-  const memoryFile = join(memoryDir, "MEMORY.md");
-  if (!existsSync(memoryFile)) {
-    writeFileSync(
-      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 = join(workspace, "skills");
-  mkdirSync(skillsDir, { recursive: true });
-}
-function printAgentResponse(response) {
-  console.log("\n" + response + "\n");
-}
-async function prompt(rl, question) {
-  rl.setPrompt(question);
-  rl.prompt();
-  return new Promise((resolve2) => {
-    rl.once("line", (line) => resolve2(line));
-  });
-}
-function getBridgeDir() {
-  const userBridge = join(getDataDir(), "bridge");
-  if (existsSync(join(userBridge, "dist", "index.js"))) {
-    return userBridge;
-  }
-  if (!which("npm")) {
-    console.error("npm not found. Please install Node.js >= 18.");
-    process.exit(1);
-  }
-  const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
-  const pkgRoot = resolve(cliDir, "..", "..");
-  const pkgBridge = join(pkgRoot, "bridge");
-  const srcBridge = join(pkgRoot, "..", "..", "bridge");
-  let source = null;
-  if (existsSync(join(pkgBridge, "package.json"))) {
-    source = pkgBridge;
-  } else if (existsSync(join(srcBridge, "package.json"))) {
-    source = srcBridge;
-  }
-  if (!source) {
-    console.error(`Bridge source not found. Try reinstalling ${APP_NAME}.`);
-    process.exit(1);
-  }
-  console.log(`${LOGO} Setting up bridge...`);
-  mkdirSync(resolve(userBridge, ".."), { recursive: true });
-  if (existsSync(userBridge)) {
-    rmSync(userBridge, { recursive: true, force: true });
-  }
-  cpSync(source, userBridge, {
-    recursive: true,
-    filter: (src) => !src.includes("node_modules") && !src.includes("dist")
-  });
-  const install = spawnSync("npm", ["install"], { cwd: userBridge, stdio: "pipe" });
-  if (install.status !== 0) {
-    console.error(`Bridge install failed: ${install.status ?? 1}`);
-    if (install.stderr) {
-      console.error(String(install.stderr).slice(0, 500));
-    }
-    process.exit(1);
-  }
-  const build = spawnSync("npm", ["run", "build"], { cwd: userBridge, stdio: "pipe" });
-  if (build.status !== 0) {
-    console.error(`Bridge build failed: ${build.status ?? 1}`);
-    if (build.stderr) {
-      console.error(String(build.stderr).slice(0, 500));
-    }
-    process.exit(1);
-  }
-  console.log("\u2713 Bridge ready\n");
-  return userBridge;
-}
 function getPackageVersion() {
   try {
     const cliDir = resolve(fileURLToPath(new URL(".", import.meta.url)));
@@ -985,3 +283,776 @@ function resolveUiFrontendDir() {
   }
   return null;
 }
+function printAgentResponse(response) {
+  console.log("\n" + response + "\n");
+}
+async function prompt(rl, question) {
+  rl.setPrompt(question);
+  rl.prompt();
+  return new Promise((resolve3) => {
+    rl.once("line", (line) => resolve3(line));
+  });
+}
+
+// src/cli/runtime.ts
+var LOGO = "\u{1F916}";
+var EXIT_COMMANDS = /* @__PURE__ */ new Set(["exit", "quit", "/exit", "/quit", ":q"]);
+var CliRuntime = class {
+  logo;
+  constructor(options = {}) {
+    this.logo = options.logo ?? LOGO;
+  }
+  get version() {
+    return getPackageVersion();
+  }
+  async onboard() {
+    const configPath = getConfigPath();
+    if (existsSync2(configPath)) {
+      console.log(`Config already exists at ${configPath}`);
+    }
+    const config = ConfigSchema.parse({});
+    saveConfig(config);
+    console.log(`\u2713 Created config at ${configPath}`);
+    const workspace = getWorkspacePath();
+    console.log(`\u2713 Created workspace at ${workspace}`);
+    this.createWorkspaceTemplates(workspace);
+    console.log(`
+${this.logo} ${APP_NAME} is ready!`);
+    console.log("\nNext steps:");
+    console.log(`  1. Add your API key to ${configPath}`);
+    console.log(`  2. Chat: ${APP_NAME} agent -m "Hello!"`);
+  }
+  async gateway(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 this.startGateway({ uiOverrides });
+  }
+  async ui(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 this.startGateway({ uiOverrides, allowMissingProvider: true });
+  }
+  async start(opts) {
+    const uiOverrides = {
+      enabled: true,
+      open: false
+    };
+    if (opts.uiHost) {
+      uiOverrides.host = String(opts.uiHost);
+    }
+    if (opts.uiPort) {
+      uiOverrides.port = Number(opts.uiPort);
+    }
+    const devMode = isDevRuntime();
+    if (devMode) {
+      const requestedUiPort = Number.isFinite(Number(opts.uiPort)) ? Number(opts.uiPort) : 18792;
+      const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : 5174;
+      const uiHost = uiOverrides.host ?? "127.0.0.1";
+      const devUiPort = await findAvailablePort(requestedUiPort, uiHost);
+      const shouldStartFrontend = opts.frontend === void 0 ? true : Boolean(opts.frontend);
+      const devFrontendPort = shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
+      uiOverrides.port = devUiPort;
+      if (requestedUiPort !== devUiPort) {
+        console.log(`Dev mode: UI port ${requestedUiPort} is in use, switched to ${devUiPort}.`);
+      }
+      if (shouldStartFrontend && requestedFrontendPort !== devFrontendPort) {
+        console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${devFrontendPort}.`);
+      }
+      console.log(`Dev mode: UI ${devUiPort}, Frontend ${devFrontendPort}`);
+      console.log("Dev mode runs in the foreground (Ctrl+C to stop).");
+      await this.runForeground({
+        uiOverrides,
+        frontend: shouldStartFrontend,
+        frontendPort: devFrontendPort,
+        open: Boolean(opts.open)
+      });
+      return;
+    }
+    await this.startService({
+      uiOverrides,
+      frontend: Boolean(opts.frontend),
+      frontendPort: Number(opts.frontendPort),
+      open: Boolean(opts.open)
+    });
+  }
+  async serve(opts) {
+    const uiOverrides = {
+      enabled: true,
+      open: false
+    };
+    if (opts.uiHost) {
+      uiOverrides.host = String(opts.uiHost);
+    }
+    if (opts.uiPort) {
+      uiOverrides.port = Number(opts.uiPort);
+    }
+    const devMode = isDevRuntime();
+    if (devMode && uiOverrides.port === void 0) {
+      uiOverrides.port = 18792;
+    }
+    const shouldStartFrontend = Boolean(opts.frontend);
+    const defaultFrontendPort = devMode ? 5174 : 5173;
+    const requestedFrontendPort = Number.isFinite(Number(opts.frontendPort)) ? Number(opts.frontendPort) : defaultFrontendPort;
+    if (devMode && uiOverrides.port !== void 0) {
+      const uiHost = uiOverrides.host ?? "127.0.0.1";
+      const uiPort = await findAvailablePort(uiOverrides.port, uiHost);
+      if (uiPort !== uiOverrides.port) {
+        console.log(`Dev mode: UI port ${uiOverrides.port} is in use, switched to ${uiPort}.`);
+        uiOverrides.port = uiPort;
+      }
+    }
+    const frontendPort = devMode && shouldStartFrontend ? await findAvailablePort(requestedFrontendPort, "127.0.0.1") : requestedFrontendPort;
+    if (devMode && shouldStartFrontend && frontendPort !== requestedFrontendPort) {
+      console.log(`Dev mode: Frontend port ${requestedFrontendPort} is in use, switched to ${frontendPort}.`);
+    }
+    await this.runForeground({
+      uiOverrides,
+      frontend: shouldStartFrontend,
+      frontendPort,
+      open: Boolean(opts.open)
+    });
+  }
+  async stop() {
+    await this.stopService();
+  }
+  async agent(opts) {
+    const config = loadConfig();
+    const bus = new MessageBus();
+    const provider = this.makeProvider(config);
+    const providerManager = new ProviderManager(provider);
+    const agentLoop = new AgentLoop({
+      bus,
+      providerManager,
+      workspace: getWorkspacePath(config.agents.defaults.workspace),
+      braveApiKey: config.tools.web.search.apiKey || void 0,
+      execConfig: config.tools.exec,
+      restrictToWorkspace: config.tools.restrictToWorkspace
+    });
+    if (opts.message) {
+      const response = await agentLoop.processDirect({
+        content: opts.message,
+        sessionKey: opts.session ?? "cli:default",
+        channel: "cli",
+        chatId: "direct"
+      });
+      printAgentResponse(response);
+      return;
+    }
+    console.log(`${this.logo} Interactive mode (type exit or Ctrl+C to quit)
+`);
+    const historyFile = join2(getDataDir2(), "history", "cli_history");
+    const historyDir = resolve2(historyFile, "..");
+    mkdirSync2(historyDir, { recursive: true });
+    const history = existsSync2(historyFile) ? readFileSync2(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 ?? []);
+      writeFileSync2(historyFile, merged.join("\n"));
+      process.exit(0);
+    });
+    let running = true;
+    while (running) {
+      const line = await prompt(rl, "You: ");
+      const trimmed = line.trim();
+      if (!trimmed) {
+        continue;
+      }
+      if (EXIT_COMMANDS.has(trimmed.toLowerCase())) {
+        rl.close();
+        running = false;
+        break;
+      }
+      const response = await agentLoop.processDirect({
+        content: trimmed,
+        sessionKey: opts.session ?? "cli:default"
+      });
+      printAgentResponse(response);
+    }
+  }
+  channelsStatus() {
+    const config = loadConfig();
+    console.log("Channel Status");
+    console.log(`WhatsApp: ${config.channels.whatsapp.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`Discord: ${config.channels.discord.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`Feishu: ${config.channels.feishu.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`Mochat: ${config.channels.mochat.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`Telegram: ${config.channels.telegram.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`Slack: ${config.channels.slack.enabled ? "\u2713" : "\u2717"}`);
+    console.log(`QQ: ${config.channels.qq.enabled ? "\u2713" : "\u2717"}`);
+  }
+  channelsLogin() {
+    const bridgeDir = this.getBridgeDir();
+    console.log(`${this.logo} Starting bridge...`);
+    console.log("Scan the QR code to connect.\n");
+    const result = spawnSync("npm", ["start"], { cwd: bridgeDir, stdio: "inherit" });
+    if (result.status !== 0) {
+      console.error(`Bridge failed: ${result.status ?? 1}`);
+    }
+  }
+  cronList(opts) {
+    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const service = new CronService(storePath);
+    const jobs = service.listJobs(Boolean(opts.all));
+    if (!jobs.length) {
+      console.log("No scheduled jobs.");
+      return;
+    }
+    for (const job of jobs) {
+      let schedule = "";
+      if (job.schedule.kind === "every") {
+        schedule = `every ${Math.round((job.schedule.everyMs ?? 0) / 1e3)}s`;
+      } else if (job.schedule.kind === "cron") {
+        schedule = job.schedule.expr ?? "";
+      } else {
+        schedule = job.schedule.atMs ? new Date(job.schedule.atMs).toISOString() : "";
+      }
+      console.log(`${job.id} ${job.name} ${schedule}`);
+    }
+  }
+  cronAdd(opts) {
+    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const service = new CronService(storePath);
+    let schedule = null;
+    if (opts.every) {
+      schedule = { kind: "every", everyMs: Number(opts.every) * 1e3 };
+    } else if (opts.cron) {
+      schedule = { kind: "cron", expr: String(opts.cron) };
+    } else if (opts.at) {
+      schedule = { kind: "at", atMs: Date.parse(String(opts.at)) };
+    }
+    if (!schedule) {
+      console.error("Error: Must specify --every, --cron, or --at");
+      return;
+    }
+    const job = service.addJob({
+      name: opts.name,
+      schedule,
+      message: opts.message,
+      deliver: Boolean(opts.deliver),
+      channel: opts.channel,
+      to: opts.to
+    });
+    console.log(`\u2713 Added job '${job.name}' (${job.id})`);
+  }
+  cronRemove(jobId) {
+    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const service = new CronService(storePath);
+    if (service.removeJob(jobId)) {
+      console.log(`\u2713 Removed job ${jobId}`);
+    } else {
+      console.log(`Job ${jobId} not found`);
+    }
+  }
+  cronEnable(jobId, opts) {
+    const storePath = join2(getDataDir2(), "cron", "jobs.json");
+    const service = new CronService(storePath);
+    const job = service.enableJob(jobId, !opts.disable);
+    if (job) {
+      console.log(`\u2713 Job '${job.name}' ${opts.disable ? "disabled" : "enabled"}`);
+    } else {
+      console.log(`Job ${jobId} not found`);
+    }
+  }
+  async cronRun(jobId, opts) {
+    const storePath = join2(getDataDir2(), "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}`);
+  }
+  status() {
+    const configPath = getConfigPath();
+    const config = loadConfig();
+    const workspace = getWorkspacePath(config.agents.defaults.workspace);
+    console.log(`${this.logo} ${APP_NAME} Status
+`);
+    console.log(`Config: ${configPath} ${existsSync2(configPath) ? "\u2713" : "\u2717"}`);
+    console.log(`Workspace: ${workspace} ${existsSync2(workspace) ? "\u2713" : "\u2717"}`);
+    console.log(`Model: ${config.agents.defaults.model}`);
+    for (const spec of PROVIDERS) {
+      const provider = config.providers[spec.name];
+      if (!provider) {
+        continue;
+      }
+      if (spec.isLocal) {
+        console.log(`${spec.displayName ?? spec.name}: ${provider.apiBase ? `\u2713 ${provider.apiBase}` : "not set"}`);
+      } else {
+        console.log(`${spec.displayName ?? spec.name}: ${provider.apiKey ? "\u2713" : "not set"}`);
+      }
+    }
+  }
+  async startGateway(options = {}) {
+    const config = loadConfig();
+    const bus = new MessageBus();
+    const provider = options.allowMissingProvider === true ? this.makeProvider(config, { allowMissing: true }) : this.makeProvider(config);
+    const providerManager = provider ? new ProviderManager(provider) : null;
+    const sessionManager = new SessionManager(getWorkspacePath(config.agents.defaults.workspace));
+    const cronStorePath = join2(getDataDir2(), "cron", "jobs.json");
+    const cron2 = new CronService(cronStorePath);
+    const uiConfig = resolveUiConfig(config, options.uiOverrides);
+    const uiStaticDir = options.uiStaticDir === void 0 ? resolveUiStaticDir() : options.uiStaticDir;
+    if (!provider) {
+      if (uiConfig.enabled) {
+        const uiServer = startUiServer({
+          host: uiConfig.host,
+          port: uiConfig.port,
+          configPath: getConfigPath(),
+          staticDir: uiStaticDir ?? void 0
+        });
+        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,
+      providerManager: providerManager ?? new ProviderManager(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 (promptText) => agent.processDirect({ content: promptText, sessionKey: "heartbeat" }),
+      30 * 60,
+      true
+    );
+    let currentConfig = config;
+    let channels2 = new ChannelManager(currentConfig, bus, sessionManager);
+    let reloadTask = null;
+    const reloadChannels = async (nextConfig) => {
+      if (reloadTask) {
+        await reloadTask;
+        return;
+      }
+      reloadTask = (async () => {
+        await channels2.stopAll();
+        channels2 = new ChannelManager(nextConfig, bus, sessionManager);
+        await channels2.startAll();
+      })();
+      try {
+        await reloadTask;
+      } finally {
+        reloadTask = null;
+      }
+    };
+    let providerReloadTask = null;
+    const reloadProvider = async (nextConfig) => {
+      if (!providerManager) {
+        return;
+      }
+      if (providerReloadTask) {
+        await providerReloadTask;
+        return;
+      }
+      providerReloadTask = (async () => {
+        const nextProvider = this.makeProvider(nextConfig, { allowMissing: true });
+        if (!nextProvider) {
+          console.warn("Provider reload skipped: missing API key.");
+          return;
+        }
+        providerManager.set(nextProvider);
+      })();
+      try {
+        await providerReloadTask;
+      } finally {
+        providerReloadTask = null;
+      }
+    };
+    const applyReloadPlan = async (nextConfig) => {
+      const changedPaths = diffConfigPaths(currentConfig, nextConfig);
+      if (!changedPaths.length) {
+        return;
+      }
+      currentConfig = nextConfig;
+      const plan = buildReloadPlan(changedPaths);
+      if (plan.restartChannels) {
+        await reloadChannels(nextConfig);
+      }
+      if (plan.reloadProviders) {
+        await reloadProvider(nextConfig);
+      }
+      if (plan.restartRequired.length > 0) {
+        console.warn(`Config changes require restart: ${plan.restartRequired.join(", ")}`);
+      }
+    };
+    let reloadTimer = null;
+    let reloadRunning = false;
+    let reloadPending = false;
+    const scheduleConfigReload = (reason) => {
+      if (reloadTimer) {
+        clearTimeout(reloadTimer);
+      }
+      reloadTimer = setTimeout(() => {
+        void runConfigReload(reason);
+      }, 300);
+    };
+    const runConfigReload = async (reason) => {
+      if (reloadRunning) {
+        reloadPending = true;
+        return;
+      }
+      reloadRunning = true;
+      if (reloadTimer) {
+        clearTimeout(reloadTimer);
+        reloadTimer = null;
+      }
+      try {
+        const nextConfig = loadConfig();
+        await applyReloadPlan(nextConfig);
+      } catch (error) {
+        console.error(`Config reload failed (${reason}): ${String(error)}`);
+      } finally {
+        reloadRunning = false;
+        if (reloadPending) {
+          reloadPending = false;
+          scheduleConfigReload("pending");
+        }
+      }
+    };
+    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
+      });
+      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");
+    const configPath = getConfigPath();
+    const watcher = chokidar.watch(configPath, {
+      ignoreInitial: true,
+      awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }
+    });
+    watcher.on("add", () => scheduleConfigReload("config add"));
+    watcher.on("change", () => scheduleConfigReload("config change"));
+    watcher.on("unlink", () => scheduleConfigReload("config unlink"));
+    await cron2.start();
+    await heartbeat.start();
+    await Promise.allSettled([agent.run(), channels2.startAll()]);
+  }
+  async runForeground(options) {
+    const config = loadConfig();
+    const uiConfig = resolveUiConfig(config, options.uiOverrides);
+    const shouldStartFrontend = options.frontend;
+    const frontendPort = Number.isFinite(options.frontendPort) ? options.frontendPort : 5173;
+    const frontendDir = shouldStartFrontend ? resolveUiFrontendDir() : null;
+    const staticDir = resolveUiStaticDir();
+    let frontendUrl = null;
+    if (shouldStartFrontend && frontendDir) {
+      const frontend = startUiFrontend({
+        apiBase: resolveUiApiBase(uiConfig.host, uiConfig.port),
+        port: frontendPort,
+        dir: frontendDir
+      });
+      frontendUrl = frontend?.url ?? null;
+    } else if (shouldStartFrontend && !frontendDir) {
+      console.log("Warning: UI frontend not found. Start it separately.");
+    }
+    if (!frontendUrl && staticDir) {
+      frontendUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+    }
+    if (options.open && frontendUrl) {
+      openBrowser(frontendUrl);
+    } else if (options.open && !frontendUrl) {
+      console.log("Warning: UI frontend not started. Browser not opened.");
+    }
+    const uiStaticDir = shouldStartFrontend && frontendDir ? null : staticDir;
+    await this.startGateway({
+      uiOverrides: options.uiOverrides,
+      allowMissingProvider: true,
+      uiStaticDir
+    });
+  }
+  async startService(options) {
+    const config = loadConfig();
+    const uiConfig = resolveUiConfig(config, options.uiOverrides);
+    const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);
+    const apiUrl = `${uiUrl}/api`;
+    const staticDir = resolveUiStaticDir();
+    const existing = readServiceState();
+    if (existing && isProcessRunning(existing.pid)) {
+      console.log(`\u2713 ${APP_NAME} is already running (PID ${existing.pid})`);
+      console.log(`UI: ${existing.uiUrl}`);
+      console.log(`API: ${existing.apiUrl}`);
+      console.log(`Logs: ${existing.logPath}`);
+      console.log(`Stop: ${APP_NAME} stop`);
+      return;
+    }
+    if (existing) {
+      clearServiceState();
+    }
+    if (!staticDir && !options.frontend) {
+      console.log("Warning: UI frontend not found. Use --frontend to start the dev server.");
+    }
+    const logPath = resolveServiceLogPath();
+    const logDir = resolve2(logPath, "..");
+    mkdirSync2(logDir, { recursive: true });
+    const logFd = openSync(logPath, "a");
+    const serveArgs = buildServeArgs({
+      uiHost: uiConfig.host,
+      uiPort: uiConfig.port,
+      frontend: options.frontend,
+      frontendPort: options.frontendPort
+    });
+    const child = spawn2(process.execPath, [...process.execArgv, ...serveArgs], {
+      env: process.env,
+      stdio: ["ignore", logFd, logFd],
+      detached: true
+    });
+    closeSync(logFd);
+    if (!child.pid) {
+      console.error("Error: Failed to start background service.");
+      return;
+    }
+    child.unref();
+    const state = {
+      pid: child.pid,
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      uiUrl,
+      apiUrl,
+      logPath
+    };
+    writeServiceState(state);
+    console.log(`\u2713 ${APP_NAME} started in background (PID ${state.pid})`);
+    console.log(`UI: ${uiUrl}`);
+    console.log(`API: ${apiUrl}`);
+    console.log(`Logs: ${logPath}`);
+    console.log(`Stop: ${APP_NAME} stop`);
+    if (options.open) {
+      openBrowser(uiUrl);
+    }
+  }
+  async stopService() {
+    const state = readServiceState();
+    if (!state) {
+      console.log("No running service found.");
+      return;
+    }
+    if (!isProcessRunning(state.pid)) {
+      console.log("Service is not running. Cleaning up state.");
+      clearServiceState();
+      return;
+    }
+    console.log(`Stopping ${APP_NAME} (PID ${state.pid})...`);
+    try {
+      process.kill(state.pid, "SIGTERM");
+    } catch (error) {
+      console.error(`Failed to stop service: ${String(error)}`);
+      return;
+    }
+    const stopped = await waitForExit(state.pid, 3e3);
+    if (!stopped) {
+      try {
+        process.kill(state.pid, "SIGKILL");
+      } catch (error) {
+        console.error(`Failed to force stop service: ${String(error)}`);
+        return;
+      }
+      await waitForExit(state.pid, 2e3);
+    }
+    clearServiceState();
+    console.log(`\u2713 ${APP_NAME} stopped`);
+  }
+  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 ${getConfigPath()} under providers section`);
+      process.exit(1);
+    }
+    return new LiteLLMProvider({
+      apiKey: provider?.apiKey ?? null,
+      apiBase: getApiBase(config),
+      defaultModel: model,
+      extraHeaders: provider?.extraHeaders ?? null,
+      providerName: getProviderName(config),
+      wireApi: provider?.wireApi ?? null
+    });
+  }
+  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
+
+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 = join2(workspace, filename);
+      if (!existsSync2(filePath)) {
+        writeFileSync2(filePath, content);
+      }
+    }
+    const memoryDir = join2(workspace, "memory");
+    mkdirSync2(memoryDir, { recursive: true });
+    const memoryFile = join2(memoryDir, "MEMORY.md");
+    if (!existsSync2(memoryFile)) {
+      writeFileSync2(
+        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 = join2(workspace, "skills");
+    mkdirSync2(skillsDir, { recursive: true });
+  }
+  getBridgeDir() {
+    const userBridge = join2(getDataDir2(), "bridge");
+    if (existsSync2(join2(userBridge, "dist", "index.js"))) {
+      return userBridge;
+    }
+    if (!which("npm")) {
+      console.error("npm not found. Please install Node.js >= 18.");
+      process.exit(1);
+    }
+    const cliDir = resolve2(fileURLToPath2(new URL(".", import.meta.url)));
+    const pkgRoot = resolve2(cliDir, "..", "..");
+    const pkgBridge = join2(pkgRoot, "bridge");
+    const srcBridge = join2(pkgRoot, "..", "..", "bridge");
+    let source = null;
+    if (existsSync2(join2(pkgBridge, "package.json"))) {
+      source = pkgBridge;
+    } else if (existsSync2(join2(srcBridge, "package.json"))) {
+      source = srcBridge;
+    }
+    if (!source) {
+      console.error(`Bridge source not found. Try reinstalling ${APP_NAME}.`);
+      process.exit(1);
+    }
+    console.log(`${this.logo} Setting up bridge...`);
+    mkdirSync2(resolve2(userBridge, ".."), { recursive: true });
+    if (existsSync2(userBridge)) {
+      rmSync2(userBridge, { recursive: true, force: true });
+    }
+    cpSync(source, userBridge, {
+      recursive: true,
+      filter: (src) => !src.includes("node_modules") && !src.includes("dist")
+    });
+    const install = spawnSync("npm", ["install"], { cwd: userBridge, stdio: "pipe" });
+    if (install.status !== 0) {
+      console.error(`Bridge install failed: ${install.status ?? 1}`);
+      if (install.stderr) {
+        console.error(String(install.stderr).slice(0, 500));
+      }
+      process.exit(1);
+    }
+    const build = spawnSync("npm", ["run", "build"], { cwd: userBridge, stdio: "pipe" });
+    if (build.status !== 0) {
+      console.error(`Bridge build failed: ${build.status ?? 1}`);
+      if (build.stderr) {
+        console.error(String(build.stderr).slice(0, 500));
+      }
+      process.exit(1);
+    }
+    console.log("\u2713 Bridge ready\n");
+    return userBridge;
+  }
+};
+
+// src/cli/index.ts
+var program = new Command();
+var runtime = new CliRuntime({ logo: LOGO });
+program.name(APP_NAME2).description(`${LOGO} ${APP_NAME2} - ${APP_TAGLINE}`).version(getPackageVersion(), "-v, --version", "show version");
+program.command("onboard").description(`Initialize ${APP_NAME2} configuration and workspace`).action(async () => runtime.onboard());
+program.command("gateway").description(`Start the ${APP_NAME2} 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) => runtime.gateway(opts));
+program.command("ui").description(`Start the ${APP_NAME2} UI with gateway`).option("--host <host>", "UI host").option("--port <port>", "UI port").option("--no-open", "Disable opening browser").action(async (opts) => runtime.ui(opts));
+program.command("start").description(`Start the ${APP_NAME2} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => runtime.start(opts));
+program.command("serve").description(`Run the ${APP_NAME2} gateway + UI in the foreground`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => runtime.serve(opts));
+program.command("stop").description(`Stop the ${APP_NAME2} background service`).action(async () => runtime.stop());
+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) => runtime.agent(opts));
+var channels = program.command("channels").description("Manage channels");
+channels.command("status").description("Show channel status").action(() => runtime.channelsStatus());
+channels.command("login").description("Link device via QR code").action(() => runtime.channelsLogin());
+var cron = program.command("cron").description("Manage scheduled tasks");
+cron.command("list").option("-a, --all", "Include disabled jobs").action((opts) => runtime.cronList(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) => runtime.cronAdd(opts));
+cron.command("remove <jobId>").action((jobId) => runtime.cronRemove(jobId));
+cron.command("enable <jobId>").option("--disable", "Disable instead of enable").action((jobId, opts) => runtime.cronEnable(jobId, opts));
+cron.command("run <jobId>").option("-f, --force", "Run even if disabled").action(async (jobId, opts) => runtime.cronRun(jobId, opts));
+program.command("status").description(`Show ${APP_NAME2} status`).action(() => runtime.status());
+program.parseAsync(process.argv);