@questionbase/deskfree 0.6.10 → 0.7.1

package/dist/bin.js

@@ -33,8 +33,8 @@ var __commonJS = (cb, mod) => function __require3() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
-  for (var name2 in all)
-    __defProp(target, name2, { get: all[name2], enumerable: true });
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -52,16 +52,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   __defProp(target, "default", { value: mod, enumerable: true }) ,
   mod
 ));
-function getPlistLabel(name2) {
-  return `com.deskfree.agent.${name2}`;
+function getPlistLabel(botId) {
+  return `com.deskfree.agent.${botId}`;
 }
-function getServiceName(name2) {
-  return `deskfree-${name2}`;
+function getServiceName(botId) {
+  return `deskfree-${botId}`;
 }
-function getMacPaths(name2) {
+function getMacPaths(botId) {
   const home = homedir();
-  const deskfreeDir = join(home, ".deskfree", name2);
-  const plistLabel = getPlistLabel(name2);
+  const deskfreeDir = join(home, ".deskfree", botId);
+  const plistLabel = getPlistLabel(botId);
   return {
     deskfreeDir,
     envFile: join(deskfreeDir, ".env"),
@@ -70,8 +70,8 @@ function getMacPaths(name2) {
     plist: join(home, "Library", "LaunchAgents", `${plistLabel}.plist`)
   };
 }
-function getLinuxPaths(name2) {
-  const serviceName = getServiceName(name2);
+function getLinuxPaths(botId) {
+  const serviceName = getServiceName(botId);
   return {
     serviceName,
     serviceFile: `/etc/systemd/system/${serviceName}.service`,
@@ -80,57 +80,40 @@ function getLinuxPaths(name2) {
     logDir: `/var/log/${serviceName}`
   };
 }
-function parseName(args) {
-  const idx = args.indexOf("--name");
-  if (idx === -1) return [DEFAULT_NAME, args];
-  const name2 = args[idx + 1];
-  if (!name2 || name2.startsWith("-")) {
-    console.error("Error: --name requires a value (e.g. --name kasper)");
-    process.exit(1);
-  }
-  if (!/^[a-z0-9-]+$/i.test(name2)) {
-    console.error(
-      "Error: --name must contain only letters, numbers, and hyphens"
-    );
-    process.exit(1);
-  }
-  const remaining = [...args.slice(0, idx), ...args.slice(idx + 2)];
-  return [name2, remaining];
-}
-var DEFAULT_NAME;
 var init_paths = __esm({
   "src/cli/paths.ts"() {
-    DEFAULT_NAME = "main";
   }
 });
 
-// src/cli/install.ts
-var install_exports = {};
-__export(install_exports, {
-  install: () => install
+// src/cli/start.ts
+var start_exports = {};
+__export(start_exports, {
+  start: () => start
 });
-function installMac(botId, name2, stage) {
-  const paths = getMacPaths(name2);
-  const plistLabel = getPlistLabel(name2);
-  let nodeBinDir;
-  try {
-    const nodePath = execSync("which node", { encoding: "utf8" }).trim();
-    nodeBinDir = dirname(nodePath);
-  } catch {
-    console.error("Error: node not found in PATH");
-    process.exit(1);
-  }
-  const extraPathDirs = (process.env["PATH"] ?? "").split(":").filter((d) => d && d !== nodeBinDir);
-  const fullPath = [nodeBinDir, ...extraPathDirs].join(":");
-  mkdirSync(paths.deskfreeDir, { recursive: true });
-  mkdirSync(paths.logDir, { recursive: true });
-  mkdirSync(dirname(paths.plist), { recursive: true });
-  const envLines = [`BOT=${botId}`, `DESKFREE_INSTANCE_NAME=${name2}`];
-  if (stage) envLines.push(`STAGE=${stage}`);
-  writeFileSync(paths.envFile, envLines.join("\n") + "\n", { mode: 384 });
-  chmodSync(paths.envFile, 384);
-  console.log(`Wrote ${paths.envFile}`);
-  const launcher = `#!/bin/bash
+function startMac(botId, stage) {
+  const paths = getMacPaths(botId);
+  const plistLabel = getPlistLabel(botId);
+  const isInstalled = existsSync(paths.plist);
+  if (!isInstalled) {
+    let nodeBinDir;
+    try {
+      const nodePath = execSync("which node", { encoding: "utf8" }).trim();
+      nodeBinDir = dirname(nodePath);
+    } catch {
+      console.error("Error: node not found in PATH");
+      process.exit(1);
+    }
+    const extraPathDirs = (process.env["PATH"] ?? "").split(":").filter((d) => d && d !== nodeBinDir);
+    const fullPath = [nodeBinDir, ...extraPathDirs].join(":");
+    mkdirSync(paths.deskfreeDir, { recursive: true });
+    mkdirSync(paths.logDir, { recursive: true });
+    mkdirSync(dirname(paths.plist), { recursive: true });
+    const envLines = [`BOT=${botId}`];
+    if (stage) envLines.push(`STAGE=${stage}`);
+    writeFileSync(paths.envFile, envLines.join("\n") + "\n", { mode: 384 });
+    chmodSync(paths.envFile, 384);
+    console.log(`Wrote ${paths.envFile}`);
+    const launcher = `#!/bin/bash
 set -euo pipefail
 
 export PATH="${fullPath}"
@@ -143,12 +126,12 @@ set -a
 source "${paths.envFile}"
 set +a
 
-exec deskfree start
+exec deskfree run "$BOT"
 `;
-  writeFileSync(paths.launcher, launcher, { mode: 493 });
-  chmodSync(paths.launcher, 493);
-  console.log(`Wrote ${paths.launcher}`);
-  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+    writeFileSync(paths.launcher, launcher, { mode: 493 });
+    chmodSync(paths.launcher, 493);
+    console.log(`Wrote ${paths.launcher}`);
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
@@ -171,8 +154,9 @@ exec deskfree start
 </dict>
 </plist>
 `;
-  writeFileSync(paths.plist, plist);
-  console.log(`Wrote ${paths.plist}`);
+    writeFileSync(paths.plist, plist);
+    console.log(`Wrote ${paths.plist}`);
+  }
   try {
     execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {
       stdio: "ignore"
@@ -180,49 +164,54 @@ exec deskfree start
   } catch {
   }
   execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);
-  console.log(`
-Service ${plistLabel} installed and started.`);
-  console.log(`Check status: launchctl print gui/$(id -u)/${plistLabel}`);
+  if (isInstalled) {
+    console.log(`Bot ${botId} started.`);
+  } else {
+    console.log(`
+Bot ${botId} installed and started.`);
+  }
   console.log(`Logs: tail -f ${join(paths.logDir, "stdout.log")}`);
 }
-function installLinux(botId, name2, stage) {
-  if (process.getuid?.() !== 0) {
-    console.error("Error: install must be run as root (use sudo)");
-    process.exit(1);
-  }
-  const paths = getLinuxPaths(name2);
-  const serviceName = getServiceName(name2);
-  const systemUser = serviceName;
-  let npmPath;
-  let nodeBinDir;
-  try {
-    npmPath = execSync("which npm", { encoding: "utf8" }).trim();
-    nodeBinDir = dirname(npmPath);
-  } catch {
-    console.error("Error: npm not found in PATH");
-    process.exit(1);
-  }
-  try {
-    execSync(`id ${systemUser}`, { stdio: "ignore" });
-  } catch {
+function startLinux(botId, stage) {
+  const paths = getLinuxPaths(botId);
+  const serviceName = getServiceName(botId);
+  const isInstalled = existsSync(paths.serviceFile);
+  if (!isInstalled) {
+    if (process.getuid?.() !== 0) {
+      console.error("Error: first-time setup must be run as root (use sudo)");
+      process.exit(1);
+    }
+    const systemUser = serviceName;
+    let npmPath;
+    let nodeBinDir;
+    try {
+      npmPath = execSync("which npm", { encoding: "utf8" }).trim();
+      nodeBinDir = dirname(npmPath);
+    } catch {
+      console.error("Error: npm not found in PATH");
+      process.exit(1);
+    }
+    try {
+      execSync(`id ${systemUser}`, { stdio: "ignore" });
+    } catch {
+      execSync(
+        `useradd --system --no-create-home --shell /usr/sbin/nologin ${systemUser}`
+      );
+      console.log(`Created system user: ${systemUser}`);
+    }
+    mkdirSync(paths.stateDir, { recursive: true });
+    mkdirSync(paths.logDir, { recursive: true });
     execSync(
-      `useradd --system --no-create-home --shell /usr/sbin/nologin ${systemUser}`
+      `chown ${systemUser}:${systemUser} ${paths.stateDir} ${paths.logDir}`
     );
-    console.log(`Created system user: ${systemUser}`);
-  }
-  mkdirSync(paths.stateDir, { recursive: true });
-  mkdirSync(paths.logDir, { recursive: true });
-  execSync(
-    `chown ${systemUser}:${systemUser} ${paths.stateDir} ${paths.logDir}`
-  );
-  console.log(`Created ${paths.stateDir} and ${paths.logDir}`);
-  const envLines = [`BOT=${botId}`, `DESKFREE_INSTANCE_NAME=${name2}`];
-  if (stage) envLines.push(`STAGE=${stage}`);
-  writeFileSync(paths.envFile, envLines.join("\n") + "\n", { mode: 384 });
-  chmodSync(paths.envFile, 384);
-  console.log(`Wrote ${paths.envFile}`);
-  const unit = `[Unit]
-Description=DeskFree Agent (${name2})
+    console.log(`Created ${paths.stateDir} and ${paths.logDir}`);
+    const envLines = [`BOT=${botId}`];
+    if (stage) envLines.push(`STAGE=${stage}`);
+    writeFileSync(paths.envFile, envLines.join("\n") + "\n", { mode: 384 });
+    chmodSync(paths.envFile, 384);
+    console.log(`Wrote ${paths.envFile}`);
+    const unit = `[Unit]
+Description=DeskFree Agent (${botId})
 After=network-online.target
 Wants=network-online.target
 
@@ -233,7 +222,7 @@ Group=${systemUser}
 WorkingDirectory=${paths.stateDir}
 Environment=PATH=${nodeBinDir}:/usr/local/bin:/usr/bin:/bin
 ExecStartPre=+${npmPath} install -g ${PACKAGE}
-ExecStart=${nodeBinDir}/deskfree start
+ExecStart=${nodeBinDir}/deskfree run ${botId}
 EnvironmentFile=${paths.envFile}
 Environment=NODE_ENV=production
 Environment=DESKFREE_STATE_DIR=${paths.stateDir}
@@ -246,42 +235,98 @@ StandardError=append:${paths.logDir}/stderr.log
 [Install]
 WantedBy=multi-user.target
 `;
-  writeFileSync(paths.serviceFile, unit);
-  console.log(`Wrote ${paths.serviceFile}`);
-  execSync("systemctl daemon-reload");
-  execSync(`systemctl enable ${serviceName}`);
+    writeFileSync(paths.serviceFile, unit);
+    console.log(`Wrote ${paths.serviceFile}`);
+    execSync("systemctl daemon-reload");
+    execSync(`systemctl enable ${serviceName}`);
+  }
   execSync(`systemctl start ${serviceName}`);
-  console.log(`
-Service ${serviceName} installed and started.`);
-  console.log(`Check status: systemctl status ${serviceName}`);
+  if (isInstalled) {
+    console.log(`Bot ${botId} started.`);
+  } else {
+    console.log(`
+Bot ${botId} installed and started.`);
+  }
   console.log(`Logs: tail -f ${paths.logDir}/stdout.log`);
 }
-function install(botId, name2, stage) {
+function start(botId, stage) {
   if (process.platform === "darwin") {
-    installMac(botId, name2, stage);
+    startMac(botId, stage);
   } else if (process.platform === "linux") {
-    installLinux(botId, name2, stage);
+    startLinux(botId, stage);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);
   }
 }
 var PACKAGE;
-var init_install = __esm({
-  "src/cli/install.ts"() {
+var init_start = __esm({
+  "src/cli/start.ts"() {
     init_paths();
     PACKAGE = "@questionbase/deskfree@latest";
   }
 });
 
+// src/cli/stop.ts
+var stop_exports = {};
+__export(stop_exports, {
+  stop: () => stop
+});
+function stopMac(botId) {
+  const paths = getMacPaths(botId);
+  if (!existsSync(paths.plist)) {
+    console.error(`Bot ${botId} is not installed.`);
+    console.error(`Run: deskfree start ${botId}`);
+    process.exit(1);
+  }
+  try {
+    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {
+      stdio: "ignore"
+    });
+    console.log(`Bot ${botId} stopped.`);
+  } catch {
+    console.log(`Bot ${botId} is not running.`);
+  }
+}
+function stopLinux(botId) {
+  const paths = getLinuxPaths(botId);
+  const serviceName = getServiceName(botId);
+  if (!existsSync(paths.serviceFile)) {
+    console.error(`Bot ${botId} is not installed.`);
+    console.error(`Run: deskfree start ${botId}`);
+    process.exit(1);
+  }
+  try {
+    execSync(`systemctl stop ${serviceName}`, { stdio: "inherit" });
+    console.log(`Bot ${botId} stopped.`);
+  } catch {
+    console.log(`Bot ${botId} is not running.`);
+  }
+}
+function stop(botId) {
+  if (process.platform === "darwin") {
+    stopMac(botId);
+  } else if (process.platform === "linux") {
+    stopLinux(botId);
+  } else {
+    console.error(`Unsupported platform: ${process.platform}`);
+    process.exit(1);
+  }
+}
+var init_stop = __esm({
+  "src/cli/stop.ts"() {
+    init_paths();
+  }
+});
+
 // src/cli/uninstall.ts
 var uninstall_exports = {};
 __export(uninstall_exports, {
   uninstall: () => uninstall
 });
-function uninstallMac(name2) {
-  const paths = getMacPaths(name2);
-  const plistLabel = getPlistLabel(name2);
+function uninstallMac(botId) {
+  const paths = getMacPaths(botId);
+  const plistLabel = getPlistLabel(botId);
   try {
     execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {
       stdio: "ignore"
@@ -294,18 +339,18 @@ function uninstallMac(name2) {
       console.log(`Removed ${file}`);
     }
   }
-  console.log(`Service ${plistLabel} uninstalled.`);
+  console.log(`Bot ${botId} (${plistLabel}) uninstalled.`);
   console.log(
     `Note: logs and state in ${paths.deskfreeDir} were preserved. Remove manually if desired.`
   );
 }
-function uninstallLinux(name2) {
+function uninstallLinux(botId) {
   if (process.getuid?.() !== 0) {
     console.error("Error: uninstall must be run as root (use sudo)");
     process.exit(1);
   }
-  const paths = getLinuxPaths(name2);
-  const serviceName = getServiceName(name2);
+  const paths = getLinuxPaths(botId);
+  const serviceName = getServiceName(botId);
   try {
     execSync(`systemctl stop ${serviceName}`, { stdio: "ignore" });
   } catch {
@@ -323,13 +368,13 @@ function uninstallLinux(name2) {
     console.log(`Removed ${paths.envFile}`);
   }
   execSync("systemctl daemon-reload");
-  console.log(`Service ${serviceName} uninstalled.`);
+  console.log(`Bot ${botId} (${serviceName}) uninstalled.`);
 }
-function uninstall(name2) {
+function uninstall(botId) {
   if (process.platform === "darwin") {
-    uninstallMac(name2);
+    uninstallMac(botId);
   } else if (process.platform === "linux") {
-    uninstallLinux(name2);
+    uninstallLinux(botId);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);
@@ -346,15 +391,15 @@ var status_exports = {};
 __export(status_exports, {
   status: () => status
 });
-function statusMac(name2) {
-  const paths = getMacPaths(name2);
-  const plistLabel = getPlistLabel(name2);
+function statusMac(botId) {
+  const paths = getMacPaths(botId);
+  const plistLabel = getPlistLabel(botId);
   if (!existsSync(paths.plist)) {
-    console.log(`DeskFree Agent "${name2}" is not installed.`);
-    console.log(`Run: deskfree install <token> --name ${name2}`);
+    console.log(`Bot ${botId} is not installed.`);
+    console.log(`Run: deskfree start ${botId}`);
     return;
   }
-  console.log(`DeskFree Agent "${name2}" (macOS LaunchAgent)
+  console.log(`Bot ${botId} (macOS LaunchAgent)
 `);
   try {
     const output = execSync(`launchctl print gui/$(id -u)/${plistLabel} 2>&1`, {
@@ -370,17 +415,15 @@ function statusMac(name2) {
     console.log("  Status: not running (service may be unloaded)");
   }
 }
-function statusLinux(name2) {
-  const paths = getLinuxPaths(name2);
-  const serviceName = getServiceName(name2);
+function statusLinux(botId) {
+  const paths = getLinuxPaths(botId);
+  const serviceName = getServiceName(botId);
   if (!existsSync(paths.serviceFile)) {
-    console.log(`DeskFree Agent "${name2}" is not installed.`);
-    console.log(
-      `Run: sudo npx @questionbase/deskfree@latest install <token> --name ${name2}`
-    );
+    console.log(`Bot ${botId} is not installed.`);
+    console.log(`Run: sudo deskfree start ${botId}`);
     return;
   }
-  console.log(`DeskFree Agent "${name2}" (systemd service)
+  console.log(`Bot ${botId} (systemd service)
 `);
   try {
     const output = execSync(`systemctl status ${serviceName} --no-pager 2>&1`, {
@@ -396,11 +439,11 @@ function statusLinux(name2) {
   }
   console.log(`  Logs: ${paths.logDir}/stdout.log`);
 }
-function status(name2) {
+function status(botId) {
   if (process.platform === "darwin") {
-    statusMac(name2);
+    statusMac(botId);
   } else if (process.platform === "linux") {
-    statusLinux(name2);
+    statusLinux(botId);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);
@@ -417,11 +460,11 @@ var restart_exports = {};
 __export(restart_exports, {
   restart: () => restart
 });
-function restartMac(name2) {
-  const paths = getMacPaths(name2);
+function restartMac(botId) {
+  const paths = getMacPaths(botId);
   if (!existsSync(paths.plist)) {
-    console.error(`DeskFree Agent "${name2}" is not installed.`);
-    console.error(`Run: deskfree install <token> --name ${name2}`);
+    console.error(`Bot ${botId} is not installed.`);
+    console.error(`Run: deskfree start ${botId}`);
     process.exit(1);
   }
   try {
@@ -431,28 +474,26 @@ function restartMac(name2) {
   } catch {
   }
   execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);
-  console.log(`DeskFree Agent "${name2}" restarted.`);
+  console.log(`Bot ${botId} restarted.`);
   console.log(`Logs: tail -f ${paths.logDir}/stdout.log`);
 }
-function restartLinux(name2) {
-  const paths = getLinuxPaths(name2);
-  const serviceName = getServiceName(name2);
+function restartLinux(botId) {
+  const paths = getLinuxPaths(botId);
+  const serviceName = getServiceName(botId);
   if (!existsSync(paths.serviceFile)) {
-    console.error(`DeskFree Agent "${name2}" is not installed.`);
-    console.error(
-      `Run: sudo npx @questionbase/deskfree@latest install <token> --name ${name2}`
-    );
+    console.error(`Bot ${botId} is not installed.`);
+    console.error(`Run: sudo deskfree start ${botId}`);
     process.exit(1);
   }
   execSync(`systemctl restart ${serviceName}`, { stdio: "inherit" });
-  console.log(`DeskFree Agent "${name2}" restarted.`);
+  console.log(`Bot ${botId} restarted.`);
   console.log(`Logs: tail -f ${paths.logDir}/stdout.log`);
 }
-function restart(name2) {
+function restart(botId) {
   if (process.platform === "darwin") {
-    restartMac(name2);
+    restartMac(botId);
   } else if (process.platform === "linux") {
-    restartLinux(name2);
+    restartLinux(botId);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);
@@ -469,30 +510,30 @@ var logs_exports = {};
 __export(logs_exports, {
   logs: () => logs
 });
-function getLogPath(name2) {
+function getLogPath(botId) {
   if (process.platform === "darwin") {
-    const logFile = join(getMacPaths(name2).logDir, "stdout.log");
+    const logFile = join(getMacPaths(botId).logDir, "stdout.log");
     return existsSync(logFile) ? logFile : null;
   } else if (process.platform === "linux") {
-    const logFile = join(getLinuxPaths(name2).logDir, "stdout.log");
+    const logFile = join(getLinuxPaths(botId).logDir, "stdout.log");
     return existsSync(logFile) ? logFile : null;
   }
   return null;
 }
-function logs(follow, name2) {
+function logs(follow, botId) {
   if (process.platform !== "darwin" && process.platform !== "linux") {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);
   }
-  const logPath = getLogPath(name2);
+  const logPath = getLogPath(botId);
   if (!logPath) {
     console.error(
-      `No log file found for "${name2}". Is DeskFree Agent installed with --name ${name2}?`
+      `No log file found for bot ${botId}. Is it installed? Run: deskfree start ${botId}`
     );
     process.exit(1);
   }
-  const args = follow ? ["-f", "-n", "50", logPath] : ["-n", "50", logPath];
-  const child = spawn("tail", args, { stdio: "inherit" });
+  const args2 = follow ? ["-f", "-n", "50", logPath] : ["-n", "50", logPath];
+  const child = spawn("tail", args2, { stdio: "inherit" });
   child.on("error", (err) => {
     console.error(`Failed to read logs: ${err.message}`);
     process.exit(1);
@@ -1098,7 +1139,7 @@ function IsPrecedenceAnd(pattern) {
   return false;
 }
 function Or(pattern) {
-  let [count, start] = [0, 0];
+  let [count, start2] = [0, 0];
   const expressions = [];
   for (let index = 0; index < pattern.length; index++) {
     if (IsOpenParen(pattern, index))
@@ -1106,13 +1147,13 @@ function Or(pattern) {
     if (IsCloseParen(pattern, index))
       count -= 1;
     if (IsSeparator(pattern, index) && count === 0) {
-      const range2 = pattern.slice(start, index);
+      const range2 = pattern.slice(start2, index);
       if (range2.length > 0)
         expressions.push(TemplateLiteralParse(range2));
-      start = index + 1;
+      start2 = index + 1;
     }
   }
-  const range = pattern.slice(start);
+  const range = pattern.slice(start2);
   if (range.length > 0)
     expressions.push(TemplateLiteralParse(range));
   if (expressions.length === 0)
@@ -1146,13 +1187,13 @@ function And(pattern) {
   const expressions = [];
   for (let index = 0; index < pattern.length; index++) {
     if (IsOpenParen(pattern, index)) {
-      const [start, end] = Group(pattern, index);
-      const range = pattern.slice(start, end + 1);
+      const [start2, end] = Group(pattern, index);
+      const range = pattern.slice(start2, end + 1);
       expressions.push(TemplateLiteralParse(range));
       index = end;
     } else {
-      const [start, end] = Range(pattern, index);
-      const range = pattern.slice(start, end);
+      const [start2, end] = Range(pattern, index);
+      const range = pattern.slice(start2, end);
       if (range.length > 0)
         expressions.push(TemplateLiteralParse(range));
       index = end - 1;
@@ -1534,8 +1575,8 @@ function Intersect(types, options) {
     throw new Error("Cannot intersect transform types");
   return IntersectCreate(types, options);
 }
-function Ref(...args) {
-  const [$ref, options] = typeof args[0] === "string" ? [args[0], args[1]] : [args[0].$id, args[1]];
+function Ref(...args2) {
+  const [$ref, options] = typeof args2[0] === "string" ? [args2[0], args2[1]] : [args2[0].$id, args2[1]];
   if (typeof $ref !== "string")
     throw new TypeBoxError("Ref: $ref must be a string");
   return CreateType({ [Kind]: "Ref", $ref }, options);
@@ -2094,78 +2135,78 @@ function RecordKey2(type) {
 function RecordValue2(type) {
   return type.patternProperties[RecordPattern(type)];
 }
-function FromConstructor2(args, type) {
-  type.parameters = FromTypes(args, type.parameters);
-  type.returns = FromType(args, type.returns);
+function FromConstructor2(args2, type) {
+  type.parameters = FromTypes(args2, type.parameters);
+  type.returns = FromType(args2, type.returns);
   return type;
 }
-function FromFunction2(args, type) {
-  type.parameters = FromTypes(args, type.parameters);
-  type.returns = FromType(args, type.returns);
+function FromFunction2(args2, type) {
+  type.parameters = FromTypes(args2, type.parameters);
+  type.returns = FromType(args2, type.returns);
   return type;
 }
-function FromIntersect5(args, type) {
-  type.allOf = FromTypes(args, type.allOf);
+function FromIntersect5(args2, type) {
+  type.allOf = FromTypes(args2, type.allOf);
   return type;
 }
-function FromUnion7(args, type) {
-  type.anyOf = FromTypes(args, type.anyOf);
+function FromUnion7(args2, type) {
+  type.anyOf = FromTypes(args2, type.anyOf);
   return type;
 }
-function FromTuple4(args, type) {
+function FromTuple4(args2, type) {
   if (IsUndefined(type.items))
     return type;
-  type.items = FromTypes(args, type.items);
+  type.items = FromTypes(args2, type.items);
   return type;
 }
-function FromArray5(args, type) {
-  type.items = FromType(args, type.items);
+function FromArray5(args2, type) {
+  type.items = FromType(args2, type.items);
   return type;
 }
-function FromAsyncIterator2(args, type) {
-  type.items = FromType(args, type.items);
+function FromAsyncIterator2(args2, type) {
+  type.items = FromType(args2, type.items);
   return type;
 }
-function FromIterator2(args, type) {
-  type.items = FromType(args, type.items);
+function FromIterator2(args2, type) {
+  type.items = FromType(args2, type.items);
   return type;
 }
-function FromPromise3(args, type) {
-  type.item = FromType(args, type.item);
+function FromPromise3(args2, type) {
+  type.item = FromType(args2, type.item);
   return type;
 }
-function FromObject2(args, type) {
-  const mappedProperties = FromProperties11(args, type.properties);
+function FromObject2(args2, type) {
+  const mappedProperties = FromProperties11(args2, type.properties);
   return { ...type, ...Object2(mappedProperties) };
 }
-function FromRecord2(args, type) {
-  const mappedKey = FromType(args, RecordKey2(type));
-  const mappedValue = FromType(args, RecordValue2(type));
+function FromRecord2(args2, type) {
+  const mappedKey = FromType(args2, RecordKey2(type));
+  const mappedValue = FromType(args2, RecordValue2(type));
   const result = Record(mappedKey, mappedValue);
   return { ...type, ...result };
 }
-function FromArgument(args, argument) {
-  return argument.index in args ? args[argument.index] : Unknown();
+function FromArgument(args2, argument) {
+  return argument.index in args2 ? args2[argument.index] : Unknown();
 }
-function FromProperty2(args, type) {
+function FromProperty2(args2, type) {
   const isReadonly = IsReadonly(type);
   const isOptional = IsOptional(type);
-  const mapped = FromType(args, type);
+  const mapped = FromType(args2, type);
   return isReadonly && isOptional ? ReadonlyOptional(mapped) : isReadonly && !isOptional ? Readonly(mapped) : !isReadonly && isOptional ? Optional(mapped) : mapped;
 }
-function FromProperties11(args, properties) {
+function FromProperties11(args2, properties) {
   return globalThis.Object.getOwnPropertyNames(properties).reduce((result, key) => {
-    return { ...result, [key]: FromProperty2(args, properties[key]) };
+    return { ...result, [key]: FromProperty2(args2, properties[key]) };
   }, {});
 }
-function FromTypes(args, types) {
-  return types.map((type) => FromType(args, type));
+function FromTypes(args2, types) {
+  return types.map((type) => FromType(args2, type));
 }
-function FromType(args, type) {
-  return IsConstructor(type) ? FromConstructor2(args, type) : IsFunction2(type) ? FromFunction2(args, type) : IsIntersect(type) ? FromIntersect5(args, type) : IsUnion(type) ? FromUnion7(args, type) : IsTuple(type) ? FromTuple4(args, type) : IsArray3(type) ? FromArray5(args, type) : IsAsyncIterator2(type) ? FromAsyncIterator2(args, type) : IsIterator2(type) ? FromIterator2(args, type) : IsPromise(type) ? FromPromise3(args, type) : IsObject3(type) ? FromObject2(args, type) : IsRecord(type) ? FromRecord2(args, type) : IsArgument(type) ? FromArgument(args, type) : type;
+function FromType(args2, type) {
+  return IsConstructor(type) ? FromConstructor2(args2, type) : IsFunction2(type) ? FromFunction2(args2, type) : IsIntersect(type) ? FromIntersect5(args2, type) : IsUnion(type) ? FromUnion7(args2, type) : IsTuple(type) ? FromTuple4(args2, type) : IsArray3(type) ? FromArray5(args2, type) : IsAsyncIterator2(type) ? FromAsyncIterator2(args2, type) : IsIterator2(type) ? FromIterator2(args2, type) : IsPromise(type) ? FromPromise3(args2, type) : IsObject3(type) ? FromObject2(args2, type) : IsRecord(type) ? FromRecord2(args2, type) : IsArgument(type) ? FromArgument(args2, type) : type;
 }
-function Instantiate(type, args) {
-  return FromType(args, CloneType(type));
+function Instantiate(type, args2) {
+  return FromType(args2, CloneType(type));
 }
 function Integer(options) {
   return CreateType({ [Kind]: "Integer", type: "integer" }, options);
@@ -2917,7 +2958,7 @@ function createWorkerTools(client, options) {
     }),
     createTool(WORKER_TOOLS.CREATE_FILE, async (params) => {
       try {
-        const name2 = validateStringParam(params, "name", true);
+        const name = validateStringParam(params, "name", true);
         const description = validateStringParam(params, "description", false);
         const content = validateStringParam(params, "content", false);
         const contentFormat = validateEnumParam(
@@ -2928,7 +2969,7 @@ function createWorkerTools(client, options) {
         );
         const taskId = validateStringParam(params, "taskId", false);
         const result = await client.createFile({
-          name: name2,
+          name,
           description,
           content,
           contentFormat,
@@ -3583,18 +3624,18 @@ function saveCursor(ctx, cursor, storagePath, log) {
   }
 }
 function validateField(opts) {
-  const { value, name: name2, minLength, maxLength, pattern, patternMessage } = opts;
-  if (!value) return `${name2} is required`;
-  if (typeof value !== "string") return `${name2} must be a string`;
+  const { value, name, minLength, maxLength, pattern, patternMessage } = opts;
+  if (!value) return `${name} is required`;
+  if (typeof value !== "string") return `${name} must be a string`;
   const trimmed = value.trim();
   if (trimmed !== value)
-    return `${name2} must not have leading or trailing whitespace`;
+    return `${name} must not have leading or trailing whitespace`;
   if (minLength !== void 0 && trimmed.length < minLength)
-    return `${name2} appears to be incomplete (minimum ${minLength} characters expected)`;
+    return `${name} appears to be incomplete (minimum ${minLength} characters expected)`;
   if (maxLength !== void 0 && trimmed.length > maxLength)
-    return `${name2} appears to be invalid (maximum ${maxLength} characters expected)`;
+    return `${name} appears to be invalid (maximum ${maxLength} characters expected)`;
   if (pattern !== void 0 && !pattern.test(trimmed))
-    return patternMessage ?? `${name2} contains invalid characters`;
+    return patternMessage ?? `${name} contains invalid characters`;
   return null;
 }
 function isLocalDevelopmentHost(hostname2) {
@@ -3618,8 +3659,8 @@ function validateBotId(value) {
   if (patternError) return patternError;
   return null;
 }
-function validateUrl(value, name2, allowedProtocols, protocolError) {
-  const fieldError = validateField({ value, name: name2 });
+function validateUrl(value, name, allowedProtocols, protocolError) {
+  const fieldError = validateField({ value, name });
   if (fieldError) return fieldError;
   const trimmed = value.trim();
   let url;
@@ -3627,21 +3668,21 @@ function validateUrl(value, name2, allowedProtocols, protocolError) {
     url = new URL(trimmed);
   } catch (err) {
     const message = err instanceof Error ? err.message : "Invalid URL format";
-    return `${name2} must be a valid URL: ${message}`;
+    return `${name} must be a valid URL: ${message}`;
   }
   if (!allowedProtocols.includes(url.protocol)) {
     return protocolError;
   }
   if (!url.hostname) {
-    return `${name2} must have a valid hostname`;
+    return `${name} must have a valid hostname`;
   }
   if (isLocalDevelopmentHost(url.hostname)) {
     if (process.env.NODE_ENV === "production") {
-      return `${name2} cannot use localhost or private IP addresses in production. Please use a publicly accessible URL.`;
+      return `${name} cannot use localhost or private IP addresses in production. Please use a publicly accessible URL.`;
     }
   }
   if (url.hostname.includes("..") || url.hostname.startsWith(".")) {
-    return `${name2} hostname appears to be malformed. Please check for typos.`;
+    return `${name} hostname appears to be malformed. Please check for typos.`;
   }
   return null;
 }
@@ -3673,8 +3714,8 @@ var init_dist = __esm({
       return mod || (0, cb[__getOwnPropNames2(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
     };
     __export2 = (target, all) => {
-      for (var name2 in all)
-        __defProp2(target, name2, { get: all[name2], enumerable: true });
+      for (var name in all)
+        __defProp2(target, name, { get: all[name], enumerable: true });
     };
     __copyProps2 = (to, from, except, desc) => {
       if (from && typeof from === "object" || typeof from === "function") {
@@ -5712,9 +5753,9 @@ var init_dist = __esm({
     require_extension = __commonJS2({
       "../../node_modules/ws/lib/extension.js"(exports$1, module) {
         var { tokenChars } = require_validation();
-        function push(dest, name2, elem) {
-          if (dest[name2] === void 0) dest[name2] = [elem];
-          else dest[name2].push(elem);
+        function push(dest, name, elem) {
+          if (dest[name] === void 0) dest[name] = [elem];
+          else dest[name].push(elem);
         }
         function parse(header) {
           const offers = /* @__PURE__ */ Object.create(null);
@@ -5724,7 +5765,7 @@ var init_dist = __esm({
           let inQuotes = false;
           let extensionName;
           let paramName;
-          let start = -1;
+          let start2 = -1;
           let code = -1;
           let end = -1;
           let i = 0;
@@ -5732,45 +5773,45 @@ var init_dist = __esm({
             code = header.charCodeAt(i);
             if (extensionName === void 0) {
               if (end === -1 && tokenChars[code] === 1) {
-                if (start === -1) start = i;
+                if (start2 === -1) start2 = i;
               } else if (i !== 0 && (code === 32 || code === 9)) {
-                if (end === -1 && start !== -1) end = i;
+                if (end === -1 && start2 !== -1) end = i;
               } else if (code === 59 || code === 44) {
-                if (start === -1) {
+                if (start2 === -1) {
                   throw new SyntaxError(`Unexpected character at index ${i}`);
                 }
                 if (end === -1) end = i;
-                const name2 = header.slice(start, end);
+                const name = header.slice(start2, end);
                 if (code === 44) {
-                  push(offers, name2, params);
+                  push(offers, name, params);
                   params = /* @__PURE__ */ Object.create(null);
                 } else {
-                  extensionName = name2;
+                  extensionName = name;
                 }
-                start = end = -1;
+                start2 = end = -1;
               } else {
                 throw new SyntaxError(`Unexpected character at index ${i}`);
               }
             } else if (paramName === void 0) {
               if (end === -1 && tokenChars[code] === 1) {
-                if (start === -1) start = i;
+                if (start2 === -1) start2 = i;
               } else if (code === 32 || code === 9) {
-                if (end === -1 && start !== -1) end = i;
+                if (end === -1 && start2 !== -1) end = i;
               } else if (code === 59 || code === 44) {
-                if (start === -1) {
+                if (start2 === -1) {
                   throw new SyntaxError(`Unexpected character at index ${i}`);
                 }
                 if (end === -1) end = i;
-                push(params, header.slice(start, end), true);
+                push(params, header.slice(start2, end), true);
                 if (code === 44) {
                   push(offers, extensionName, params);
                   params = /* @__PURE__ */ Object.create(null);
                   extensionName = void 0;
                 }
-                start = end = -1;
-              } else if (code === 61 && start !== -1 && end === -1) {
-                paramName = header.slice(start, i);
-                start = end = -1;
+                start2 = end = -1;
+              } else if (code === 61 && start2 !== -1 && end === -1) {
+                paramName = header.slice(start2, i);
+                start2 = end = -1;
               } else {
                 throw new SyntaxError(`Unexpected character at index ${i}`);
               }
@@ -5779,13 +5820,13 @@ var init_dist = __esm({
                 if (tokenChars[code] !== 1) {
                   throw new SyntaxError(`Unexpected character at index ${i}`);
                 }
-                if (start === -1) start = i;
+                if (start2 === -1) start2 = i;
                 else if (!mustUnescape) mustUnescape = true;
                 isEscaping = false;
               } else if (inQuotes) {
                 if (tokenChars[code] === 1) {
-                  if (start === -1) start = i;
-                } else if (code === 34 && start !== -1) {
+                  if (start2 === -1) start2 = i;
+                } else if (code === 34 && start2 !== -1) {
                   inQuotes = false;
                   end = i;
                 } else if (code === 92) {
@@ -5796,15 +5837,15 @@ var init_dist = __esm({
               } else if (code === 34 && header.charCodeAt(i - 1) === 61) {
                 inQuotes = true;
               } else if (end === -1 && tokenChars[code] === 1) {
-                if (start === -1) start = i;
-              } else if (start !== -1 && (code === 32 || code === 9)) {
+                if (start2 === -1) start2 = i;
+              } else if (start2 !== -1 && (code === 32 || code === 9)) {
                 if (end === -1) end = i;
               } else if (code === 59 || code === 44) {
-                if (start === -1) {
+                if (start2 === -1) {
                   throw new SyntaxError(`Unexpected character at index ${i}`);
                 }
                 if (end === -1) end = i;
-                let value = header.slice(start, end);
+                let value = header.slice(start2, end);
                 if (mustUnescape) {
                   value = value.replace(/\\/g, "");
                   mustUnescape = false;
@@ -5816,17 +5857,17 @@ var init_dist = __esm({
                   extensionName = void 0;
                 }
                 paramName = void 0;
-                start = end = -1;
+                start2 = end = -1;
               } else {
                 throw new SyntaxError(`Unexpected character at index ${i}`);
               }
             }
           }
-          if (start === -1 || inQuotes || code === 32 || code === 9) {
+          if (start2 === -1 || inQuotes || code === 32 || code === 9) {
             throw new SyntaxError("Unexpected end of input");
           }
           if (end === -1) end = i;
-          const token = header.slice(start, end);
+          const token = header.slice(start2, end);
           if (extensionName === void 0) {
             push(offers, token, params);
           } else {
@@ -6842,34 +6883,34 @@ var init_dist = __esm({
         var { tokenChars } = require_validation();
         function parse(header) {
           const protocols = /* @__PURE__ */ new Set();
-          let start = -1;
+          let start2 = -1;
           let end = -1;
           let i = 0;
           for (i; i < header.length; i++) {
             const code = header.charCodeAt(i);
             if (end === -1 && tokenChars[code] === 1) {
-              if (start === -1) start = i;
+              if (start2 === -1) start2 = i;
             } else if (i !== 0 && (code === 32 || code === 9)) {
-              if (end === -1 && start !== -1) end = i;
+              if (end === -1 && start2 !== -1) end = i;
             } else if (code === 44) {
-              if (start === -1) {
+              if (start2 === -1) {
                 throw new SyntaxError(`Unexpected character at index ${i}`);
               }
               if (end === -1) end = i;
-              const protocol2 = header.slice(start, end);
+              const protocol2 = header.slice(start2, end);
               if (protocols.has(protocol2)) {
                 throw new SyntaxError(`The "${protocol2}" subprotocol is duplicated`);
               }
               protocols.add(protocol2);
-              start = end = -1;
+              start2 = end = -1;
             } else {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
           }
-          if (start === -1 || end !== -1) {
+          if (start2 === -1 || end !== -1) {
             throw new SyntaxError("Unexpected end of input");
           }
-          const protocol = header.slice(start, i);
+          const protocol = header.slice(start2, i);
           if (protocols.has(protocol)) {
             throw new SyntaxError(`The "${protocol}" subprotocol is duplicated`);
           }
@@ -7455,14 +7496,14 @@ var init_dist = __esm({
        * Validates that a string parameter is non-empty.
        * Catches invalid inputs before they hit the network.
        */
-      requireNonEmpty(value, name2, caller) {
+      requireNonEmpty(value, name, caller) {
         if (!value || value.trim() === "") {
           const ctx = caller ? ` (in ${caller})` : "";
           throw new DeskFreeError(
             "client",
-            name2,
-            `${name2} is required and cannot be empty${ctx}`,
-            `Missing required parameter: ${name2}. Please provide a valid value.`
+            name,
+            `${name} is required and cannot be empty${ctx}`,
+            `Missing required parameter: ${name}. Please provide a valid value.`
           );
         }
       }
@@ -8785,18 +8826,8 @@ var init_config = __esm({
     init_dist();
     isDocker = process.env["DOCKER"] === "1" || existsSync("/.dockerenv");
     DEFAULTS = {
-      stateDir: isDocker ? "/app/state" : join(
-        homedir(),
-        ".deskfree",
-        process.env["DESKFREE_INSTANCE_NAME"] ?? "main",
-        "state"
-      ),
-      toolsDir: isDocker ? "/app/tools" : join(
-        homedir(),
-        ".deskfree",
-        process.env["DESKFREE_INSTANCE_NAME"] ?? "main",
-        "tools"
-      ),
+      stateDir: isDocker ? "/app/state" : join(homedir(), ".deskfree", process.env["BOT"] ?? "default", "state"),
+      toolsDir: isDocker ? "/app/tools" : join(homedir(), ".deskfree", process.env["BOT"] ?? "default", "tools"),
       logLevel: "info",
       healthPort: 3100
     };
@@ -11048,9 +11079,9 @@ var require_event_target2 = __commonJS({
 var require_extension2 = __commonJS({
   "../../node_modules/ws/lib/extension.js"(exports$1, module) {
     var { tokenChars } = require_validation2();
-    function push(dest, name2, elem) {
-      if (dest[name2] === void 0) dest[name2] = [elem];
-      else dest[name2].push(elem);
+    function push(dest, name, elem) {
+      if (dest[name] === void 0) dest[name] = [elem];
+      else dest[name].push(elem);
     }
     function parse(header) {
       const offers = /* @__PURE__ */ Object.create(null);
@@ -11060,7 +11091,7 @@ var require_extension2 = __commonJS({
       let inQuotes = false;
       let extensionName;
       let paramName;
-      let start = -1;
+      let start2 = -1;
       let code = -1;
       let end = -1;
       let i = 0;
@@ -11068,45 +11099,45 @@ var require_extension2 = __commonJS({
         code = header.charCodeAt(i);
         if (extensionName === void 0) {
           if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
           } else if (i !== 0 && (code === 32 || code === 9)) {
-            if (end === -1 && start !== -1) end = i;
+            if (end === -1 && start2 !== -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            const name2 = header.slice(start, end);
+            const name = header.slice(start2, end);
             if (code === 44) {
-              push(offers, name2, params);
+              push(offers, name, params);
               params = /* @__PURE__ */ Object.create(null);
             } else {
-              extensionName = name2;
+              extensionName = name;
             }
-            start = end = -1;
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
         } else if (paramName === void 0) {
           if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
           } else if (code === 32 || code === 9) {
-            if (end === -1 && start !== -1) end = i;
+            if (end === -1 && start2 !== -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            push(params, header.slice(start, end), true);
+            push(params, header.slice(start2, end), true);
             if (code === 44) {
               push(offers, extensionName, params);
               params = /* @__PURE__ */ Object.create(null);
               extensionName = void 0;
             }
-            start = end = -1;
-          } else if (code === 61 && start !== -1 && end === -1) {
-            paramName = header.slice(start, i);
-            start = end = -1;
+            start2 = end = -1;
+          } else if (code === 61 && start2 !== -1 && end === -1) {
+            paramName = header.slice(start2, i);
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
@@ -11115,13 +11146,13 @@ var require_extension2 = __commonJS({
             if (tokenChars[code] !== 1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
-            if (start === -1) start = i;
+            if (start2 === -1) start2 = i;
             else if (!mustUnescape) mustUnescape = true;
             isEscaping = false;
           } else if (inQuotes) {
             if (tokenChars[code] === 1) {
-              if (start === -1) start = i;
-            } else if (code === 34 && start !== -1) {
+              if (start2 === -1) start2 = i;
+            } else if (code === 34 && start2 !== -1) {
               inQuotes = false;
               end = i;
             } else if (code === 92) {
@@ -11132,15 +11163,15 @@ var require_extension2 = __commonJS({
           } else if (code === 34 && header.charCodeAt(i - 1) === 61) {
             inQuotes = true;
           } else if (end === -1 && tokenChars[code] === 1) {
-            if (start === -1) start = i;
-          } else if (start !== -1 && (code === 32 || code === 9)) {
+            if (start2 === -1) start2 = i;
+          } else if (start2 !== -1 && (code === 32 || code === 9)) {
             if (end === -1) end = i;
           } else if (code === 59 || code === 44) {
-            if (start === -1) {
+            if (start2 === -1) {
               throw new SyntaxError(`Unexpected character at index ${i}`);
             }
             if (end === -1) end = i;
-            let value = header.slice(start, end);
+            let value = header.slice(start2, end);
             if (mustUnescape) {
               value = value.replace(/\\/g, "");
               mustUnescape = false;
@@ -11152,17 +11183,17 @@ var require_extension2 = __commonJS({
               extensionName = void 0;
             }
             paramName = void 0;
-            start = end = -1;
+            start2 = end = -1;
           } else {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
         }
       }
-      if (start === -1 || inQuotes || code === 32 || code === 9) {
+      if (start2 === -1 || inQuotes || code === 32 || code === 9) {
         throw new SyntaxError("Unexpected end of input");
       }
       if (end === -1) end = i;
-      const token = header.slice(start, end);
+      const token = header.slice(start2, end);
       if (extensionName === void 0) {
         push(offers, token, params);
       } else {
@@ -12184,34 +12215,34 @@ var require_subprotocol2 = __commonJS({
     var { tokenChars } = require_validation2();
     function parse(header) {
       const protocols = /* @__PURE__ */ new Set();
-      let start = -1;
+      let start2 = -1;
       let end = -1;
       let i = 0;
       for (i; i < header.length; i++) {
         const code = header.charCodeAt(i);
         if (end === -1 && tokenChars[code] === 1) {
-          if (start === -1) start = i;
+          if (start2 === -1) start2 = i;
         } else if (i !== 0 && (code === 32 || code === 9)) {
-          if (end === -1 && start !== -1) end = i;
+          if (end === -1 && start2 !== -1) end = i;
         } else if (code === 44) {
-          if (start === -1) {
+          if (start2 === -1) {
             throw new SyntaxError(`Unexpected character at index ${i}`);
           }
           if (end === -1) end = i;
-          const protocol2 = header.slice(start, end);
+          const protocol2 = header.slice(start2, end);
           if (protocols.has(protocol2)) {
             throw new SyntaxError(`The "${protocol2}" subprotocol is duplicated`);
           }
           protocols.add(protocol2);
-          start = end = -1;
+          start2 = end = -1;
         } else {
           throw new SyntaxError(`Unexpected character at index ${i}`);
         }
       }
-      if (start === -1 || end !== -1) {
+      if (start2 === -1 || end !== -1) {
         throw new SyntaxError("Unexpected end of input");
       }
-      const protocol = header.slice(start, i);
+      const protocol = header.slice(start2, i);
       if (protocols.has(protocol)) {
         throw new SyntaxError(`The "${protocol}" subprotocol is duplicated`);
       }
@@ -13249,9 +13280,9 @@ function adaptTool(deskfreeTool) {
     deskfreeTool.name,
     deskfreeTool.description,
     zodShape,
-    async (args) => {
+    async (args2) => {
       const result = await deskfreeTool.execute(
-        args
+        args2
       );
       return {
         content: result.content,
@@ -13350,15 +13381,15 @@ function containsInjectionPattern(content) {
   return INJECTION_PATTERNS.some((pattern) => pattern.test(content));
 }
 function withContentScan(execute, extractContent, scanner) {
-  return async (args) => {
-    const content = extractContent(args);
+  return async (args2) => {
+    const content = extractContent(args2);
     if (content) {
       const result = await scanner.scan(content);
       if (!result.safe) {
         return `Security check failed: ${result.reason ?? "content rejected"}. File not updated.`;
       }
     }
-    return execute(args);
+    return execute(args2);
   };
 }
 function validateDownloadUrl(url) {
@@ -13488,7 +13519,7 @@ function createWorkerMcpServer(client, customTools = [], contentScanner) {
     if ((t.name === "deskfree_update_file" || t.name === "deskfree_create_file") && contentScanner) {
       const wrappedExecute = withContentScan(
         t.execute,
-        (args) => typeof args["content"] === "string" ? args["content"] : null,
+        (args2) => typeof args2["content"] === "string" ? args2["content"] : null,
         contentScanner
       );
       return {
@@ -13818,17 +13849,17 @@ async function buildContextualPrompt(message, task, mediaPaths, log) {
   const imageBlocks = [];
   for (const filePath of mediaPaths) {
     const ext = extname(filePath).toLowerCase();
-    const name2 = basename(filePath);
+    const name = basename(filePath);
     try {
       if (TEXT_EXTENSIONS.has(ext)) {
         const buf = await readFile(filePath);
         if (buf.length <= MAX_INLINE_TEXT_SIZE) {
           attachmentTexts.push(
-            `<attachment name="${name2}">${buf.toString("utf-8")}</attachment>`
+            `<attachment name="${name}">${buf.toString("utf-8")}</attachment>`
           );
         } else {
           attachmentTexts.push(
-            `<attachment name="${name2}">[File too large to inline: ${buf.length} bytes]</attachment>`
+            `<attachment name="${name}">[File too large to inline: ${buf.length} bytes]</attachment>`
           );
         }
       } else if (IMAGE_EXTENSIONS.has(ext)) {
@@ -13843,7 +13874,7 @@ async function buildContextualPrompt(message, task, mediaPaths, log) {
         });
       } else {
         attachmentTexts.push(
-          `<attachment name="${name2}" contentType="${ext}">File attached but content not previewable inline.</attachment>`
+          `<attachment name="${name}" contentType="${ext}">File attached but content not previewable inline.</attachment>`
         );
       }
     } catch (err) {
@@ -15006,7 +15037,7 @@ async function startAgent(opts) {
   log.info("DeskFree Agent Runtime starting...");
   const { getRotationToken: getRotationToken2, setInitialRotationToken: setInitialRotationToken2 } = await Promise.resolve().then(() => (init_ws_gateway(), ws_gateway_exports));
   const { collectFingerprint: collectFingerprint2 } = await Promise.resolve().then(() => (init_fingerprint(), fingerprint_exports));
-  const runtimeVersion = "0.6.10";
+  const runtimeVersion = "0.7.1";
   const fingerprint = collectFingerprint2(localConfig.stateDir, runtimeVersion);
   log.info("Connecting to DeskFree...", { wsUrl: localConfig.wsUrl });
   const connectResult = await initialConnect({
@@ -15051,7 +15082,7 @@ async function startAgent(opts) {
     runtimeVersion,
     maxConcurrentWorkers: 5,
     // updated after WorkerManager is created
-    instanceName: process.env["DESKFREE_INSTANCE_NAME"] || void 0
+    instanceName: process.env["BOT"] || void 0
   };
   mkdirSync(config.stateDir, { recursive: true });
   mkdirSync(config.toolsDir, { recursive: true });
@@ -15352,60 +15383,55 @@ var init_entrypoint = __esm({
 });
 
 // src/bin.ts
-init_paths();
-var [name, cleanArgs] = parseName(process.argv.slice(2));
-var command = cleanArgs[0];
-if (command === "install") {
-  const stageIdx = cleanArgs.indexOf("--stage");
-  let stage;
-  let installArgs = cleanArgs.slice(1);
-  if (stageIdx !== -1) {
-    stage = cleanArgs[stageIdx + 1];
-    if (!stage || stage.startsWith("-")) {
-      console.error("Error: --stage requires a value (e.g. --stage charlie)");
-      process.exit(1);
-    }
-    installArgs = installArgs.filter(
-      (_, i) => i !== stageIdx - 1 && i !== stageIdx
-    );
-  }
-  let botId = installArgs[0];
-  if (!botId) {
-    const { createInterface } = await import('readline');
-    const rl = createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-    botId = await new Promise((resolve) => {
-      rl.question(
-        "Paste your bot ID (from the DeskFree dashboard):\n> ",
-        (answer) => {
-          rl.close();
-          resolve(answer.trim());
-        }
-      );
-    });
-    if (!botId) {
-      console.error("No bot ID provided.");
-      process.exit(1);
-    }
+var args = process.argv.slice(2);
+var command = args[0];
+function requireBotId(args2) {
+  for (const arg of args2) {
+    if (!arg.startsWith("-") && /^B[A-Z0-9]+$/i.test(arg)) return arg;
+  }
+  console.error(
+    "Error: bot ID required.\n\nUsage: deskfree <command> <botId>\n\nExample:\n  deskfree start BABCDE12345"
+  );
+  process.exit(1);
+}
+function parseStage(args2) {
+  const idx = args2.indexOf("--stage");
+  if (idx === -1) return void 0;
+  const stage = args2[idx + 1];
+  if (!stage || stage.startsWith("-")) {
+    console.error("Error: --stage requires a value (e.g. --stage charlie)");
+    process.exit(1);
   }
-  const { install: install2 } = await Promise.resolve().then(() => (init_install(), install_exports));
-  install2(botId, name, stage);
+  return stage;
+}
+if (command === "start") {
+  const cmdArgs = args.slice(1);
+  const botId = requireBotId(cmdArgs);
+  const stage = parseStage(cmdArgs);
+  const { start: start2 } = await Promise.resolve().then(() => (init_start(), start_exports));
+  start2(botId, stage);
+} else if (command === "stop") {
+  const botId = requireBotId(args.slice(1));
+  const { stop: stop2 } = await Promise.resolve().then(() => (init_stop(), stop_exports));
+  stop2(botId);
 } else if (command === "uninstall") {
+  const botId = requireBotId(args.slice(1));
   const { uninstall: uninstall2 } = await Promise.resolve().then(() => (init_uninstall(), uninstall_exports));
-  uninstall2(name);
+  uninstall2(botId);
 } else if (command === "status") {
+  const botId = requireBotId(args.slice(1));
   const { status: status2 } = await Promise.resolve().then(() => (init_status(), status_exports));
-  status2(name);
+  status2(botId);
 } else if (command === "restart") {
+  const botId = requireBotId(args.slice(1));
   const { restart: restart2 } = await Promise.resolve().then(() => (init_restart(), restart_exports));
-  restart2(name);
+  restart2(botId);
 } else if (command === "logs") {
-  const follow = cleanArgs.includes("-f") || cleanArgs.includes("--follow");
+  const botId = requireBotId(args.slice(1));
+  const follow = args.includes("-f") || args.includes("--follow");
   const { logs: logs2 } = await Promise.resolve().then(() => (init_logs(), logs_exports));
-  logs2(follow, name);
-} else {
+  logs2(follow, botId);
+} else if (command === "run") {
   let handleShutdown = function(signal) {
     log.info(`Received ${signal} \u2014 shutting down...`);
     if (dispose) {
@@ -15417,12 +15443,20 @@ if (command === "install") {
       process.exit(1);
     }, 5e3).unref();
   };
-  const startArgs = command === "start" ? cleanArgs.slice(1) : cleanArgs;
-  if (startArgs.length >= 2) {
-    process.env["STAGE"] = startArgs[0];
-    process.env["BOT"] = startArgs[1];
-  } else if (startArgs.length === 1) {
-    process.env["BOT"] = startArgs[0];
+  const runArgs = args.slice(1);
+  const stage = parseStage(runArgs);
+  const positionals = runArgs.filter((a) => !a.startsWith("-") && a !== stage);
+  if (positionals.length >= 2) {
+    process.env["STAGE"] = positionals[0];
+    process.env["BOT"] = positionals[1];
+  } else if (positionals.length === 1) {
+    process.env["BOT"] = positionals[0];
+    if (stage) process.env["STAGE"] = stage;
+  } else {
+    console.error(
+      "Error: bot ID required.\n\nUsage: deskfree run <botId> [--stage <stage>]"
+    );
+    process.exit(1);
   }
   const { startAgent: startAgent2 } = await Promise.resolve().then(() => (init_entrypoint(), entrypoint_exports));
   const { createLogger: createLogger2 } = await Promise.resolve().then(() => (init_logger(), logger_exports));
@@ -15447,6 +15481,99 @@ if (command === "install") {
     log.error(`Fatal: failed to start agent: ${msg}`);
     process.exit(1);
   });
+} else {
+  if (args.length >= 2 && args[0] && !args[0].startsWith("-")) {
+    let handleShutdown = function(signal) {
+      log.info(`Received ${signal} \u2014 shutting down...`);
+      if (dispose) {
+        dispose();
+        dispose = null;
+      }
+      setTimeout(() => {
+        log.warn("Cleanup timeout \u2014 forcing exit");
+        process.exit(1);
+      }, 5e3).unref();
+    };
+    process.env["STAGE"] = args[0];
+    process.env["BOT"] = args[1];
+    const { startAgent: startAgent2 } = await Promise.resolve().then(() => (init_entrypoint(), entrypoint_exports));
+    const { createLogger: createLogger2 } = await Promise.resolve().then(() => (init_logger(), logger_exports));
+    const log = createLogger2("bin");
+    let dispose = null;
+    process.on("SIGTERM", () => handleShutdown("SIGTERM"));
+    process.on("SIGINT", () => handleShutdown("SIGINT"));
+    process.on("uncaughtException", (err) => {
+      log.error(`Uncaught exception: ${err.message}`);
+      log.error(err.stack ?? "");
+      process.exit(1);
+    });
+    process.on("unhandledRejection", (reason) => {
+      const msg = reason instanceof Error ? reason.message : String(reason);
+      log.error(`Unhandled rejection: ${msg}`);
+      process.exit(1);
+    });
+    startAgent2({ log }).then((d) => {
+      dispose = d;
+    }).catch((err) => {
+      const msg = err instanceof Error ? err.message : String(err);
+      log.error(`Fatal: failed to start agent: ${msg}`);
+      process.exit(1);
+    });
+  } else if (process.env["BOT"]) {
+    let handleShutdown = function(signal) {
+      log.info(`Received ${signal} \u2014 shutting down...`);
+      if (dispose) {
+        dispose();
+        dispose = null;
+      }
+      setTimeout(() => {
+        log.warn("Cleanup timeout \u2014 forcing exit");
+        process.exit(1);
+      }, 5e3).unref();
+    };
+    const { startAgent: startAgent2 } = await Promise.resolve().then(() => (init_entrypoint(), entrypoint_exports));
+    const { createLogger: createLogger2 } = await Promise.resolve().then(() => (init_logger(), logger_exports));
+    const log = createLogger2("bin");
+    let dispose = null;
+    process.on("SIGTERM", () => handleShutdown("SIGTERM"));
+    process.on("SIGINT", () => handleShutdown("SIGINT"));
+    process.on("uncaughtException", (err) => {
+      log.error(`Uncaught exception: ${err.message}`);
+      log.error(err.stack ?? "");
+      process.exit(1);
+    });
+    process.on("unhandledRejection", (reason) => {
+      const msg = reason instanceof Error ? reason.message : String(reason);
+      log.error(`Unhandled rejection: ${msg}`);
+      process.exit(1);
+    });
+    startAgent2({ log }).then((d) => {
+      dispose = d;
+    }).catch((err) => {
+      const msg = err instanceof Error ? err.message : String(err);
+      log.error(`Fatal: failed to start agent: ${msg}`);
+      process.exit(1);
+    });
+  } else {
+    console.log(`DeskFree Agent CLI
+
+Usage: deskfree <command> <botId> [options]
+
+Commands:
+  start <botId> [--stage <stage>]   Install as service and start
+  stop <botId>                      Stop the service
+  restart <botId>                   Restart the service
+  status <botId>                    Check service status
+  logs <botId> [-f]                 View logs
+  uninstall <botId>                 Remove the service
+  run <botId> [--stage <stage>]     Run in foreground (no service)
+
+Examples:
+  deskfree start BABCDE12345
+  deskfree start BABCDE12345 --stage charlie
+  deskfree stop BABCDE12345
+  deskfree logs BABCDE12345 -f`);
+  }
 }
 //# sourceMappingURL=bin.js.map
 //# sourceMappingURL=bin.js.map