@questionbase/deskfree 0.4.7 → 0.5.1

package/dist/cli/install.d.ts

@@ -1,3 +1,3 @@
-declare function install(token: string): void;
+declare function install(token: string, name: string): void;
 
 export { install };

package/dist/cli/install.js

@@ -1,26 +1,42 @@
 import { createRequire } from 'node:module';
-import { execSync } from 'child_process';
-import { mkdirSync, writeFileSync, chmodSync } from 'fs';
 import { homedir } from 'os';
 import { dirname, join } from 'path';
+import { execSync } from 'child_process';
+import { mkdirSync, writeFileSync, chmodSync } from 'fs';
 
 createRequire(import.meta.url);
-var SERVICE_NAME = "deskfree-agent";
-var PACKAGE = "@questionbase/deskfree@latest";
-var PLIST_LABEL = "com.deskfree.agent";
-function getMacPaths() {
+function getPlistLabel(name) {
+  return `com.deskfree.agent.${name}`;
+}
+function getServiceName(name) {
+  return `deskfree-agent-${name}`;
+}
+function getMacPaths(name) {
   const home = homedir();
-  const deskfreeDir = join(home, ".deskfree");
+  const deskfreeDir = join(home, ".deskfree", name);
+  const plistLabel = getPlistLabel(name);
   return {
     deskfreeDir,
     envFile: join(deskfreeDir, ".env"),
     launcher: join(deskfreeDir, "launcher.sh"),
     logDir: join(deskfreeDir, "logs"),
-    plist: join(home, "Library", "LaunchAgents", `${PLIST_LABEL}.plist`)
+    plist: join(home, "Library", "LaunchAgents", `${plistLabel}.plist`)
+  };
+}
+function getLinuxPaths(name) {
+  const serviceName = getServiceName(name);
+  return {
+    serviceName,
+    serviceFile: `/etc/systemd/system/${serviceName}.service`,
+    envFile: `/etc/${serviceName}.env`,
+    stateDir: `/var/lib/${serviceName}`,
+    logDir: `/var/log/${serviceName}`
   };
 }
-function installMac(token) {
-  const paths = getMacPaths();
+var PACKAGE = "@questionbase/deskfree@latest";
+function installMac(token, name) {
+  const paths = getMacPaths(name);
+  const plistLabel = getPlistLabel(name);
   let nodeBinDir;
   try {
     const nodePath = execSync("which node", { encoding: "utf8" }).trim();
@@ -32,8 +48,13 @@ function installMac(token) {
   mkdirSync(paths.deskfreeDir, { recursive: true });
   mkdirSync(paths.logDir, { recursive: true });
   mkdirSync(dirname(paths.plist), { recursive: true });
-  writeFileSync(paths.envFile, `DESKFREE_LAUNCH=${token}
-`, { mode: 384 });
+  writeFileSync(
+    paths.envFile,
+    `DESKFREE_LAUNCH=${token}
+DESKFREE_INSTANCE_NAME=${name}
+`,
+    { mode: 384 }
+  );
   chmodSync(paths.envFile, 384);
   console.log(`Wrote ${paths.envFile}`);
   const launcher = `#!/bin/bash
@@ -59,7 +80,7 @@ exec deskfree-agent start
 <plist version="1.0">
 <dict>
   <key>Label</key>
-  <string>${PLIST_LABEL}</string>
+  <string>${plistLabel}</string>
   <key>ProgramArguments</key>
   <array>
     <string>${paths.launcher}</string>
@@ -87,61 +108,90 @@ exec deskfree-agent start
   }
   execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);
   console.log(`
-Service ${PLIST_LABEL} installed and started.`);
-  console.log(`Check status: launchctl print gui/$(id -u)/${PLIST_LABEL}`);
+Service ${plistLabel} installed and started.`);
+  console.log(`Check status: launchctl print gui/$(id -u)/${plistLabel}`);
   console.log(`Logs: tail -f ${join(paths.logDir, "stdout.log")}`);
 }
-var SYSTEMD_SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;
-var SYSTEMD_ENV_FILE = `/etc/${SERVICE_NAME}.env`;
-function installLinux(token) {
+function installLinux(token, name) {
   if (process.getuid?.() !== 0) {
     console.error("Error: install must be run as root (use sudo)");
     process.exit(1);
   }
-  let npxPath;
+  const paths = getLinuxPaths(name);
+  const serviceName = getServiceName(name);
+  const systemUser = serviceName;
+  let npmPath;
+  let nodeBinDir;
   try {
-    npxPath = execSync("which npx", { encoding: "utf8" }).trim();
+    npmPath = execSync("which npm", { encoding: "utf8" }).trim();
+    nodeBinDir = dirname(npmPath);
   } catch {
-    console.error("Error: npx not found in PATH");
+    console.error("Error: npm not found in PATH");
     process.exit(1);
   }
-  writeFileSync(SYSTEMD_ENV_FILE, `DESKFREE_LAUNCH=${token}
-`, {
-    mode: 384
-  });
-  chmodSync(SYSTEMD_ENV_FILE, 384);
-  console.log(`Wrote ${SYSTEMD_ENV_FILE}`);
+  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(
+    `chown ${systemUser}:${systemUser} ${paths.stateDir} ${paths.logDir}`
+  );
+  console.log(`Created ${paths.stateDir} and ${paths.logDir}`);
+  writeFileSync(
+    paths.envFile,
+    `DESKFREE_LAUNCH=${token}
+DESKFREE_INSTANCE_NAME=${name}
+`,
+    { mode: 384 }
+  );
+  chmodSync(paths.envFile, 384);
+  console.log(`Wrote ${paths.envFile}`);
   const unit = `[Unit]
-Description=DeskFree Agent
+Description=DeskFree Agent (${name})
 After=network-online.target
 Wants=network-online.target
 
 [Service]
 Type=simple
-ExecStartPre=${npxPath} ${PACKAGE} --version
-ExecStart=${npxPath} ${PACKAGE} start
-EnvironmentFile=${SYSTEMD_ENV_FILE}
+User=${systemUser}
+Group=${systemUser}
+WorkingDirectory=${paths.stateDir}
+Environment=PATH=${nodeBinDir}:/usr/local/bin:/usr/bin:/bin
+ExecStartPre=+${npmPath} install -g ${PACKAGE}
+ExecStart=${nodeBinDir}/deskfree-agent start
+EnvironmentFile=${paths.envFile}
 Environment=NODE_ENV=production
+Environment=DESKFREE_STATE_DIR=${paths.stateDir}
+Environment=DESKFREE_TOOLS_DIR=${paths.stateDir}/tools
 Restart=always
 RestartSec=10
+StandardOutput=append:${paths.logDir}/stdout.log
+StandardError=append:${paths.logDir}/stderr.log
 
 [Install]
 WantedBy=multi-user.target
 `;
-  writeFileSync(SYSTEMD_SERVICE_FILE, unit);
-  console.log(`Wrote ${SYSTEMD_SERVICE_FILE}`);
+  writeFileSync(paths.serviceFile, unit);
+  console.log(`Wrote ${paths.serviceFile}`);
   execSync("systemctl daemon-reload");
-  execSync(`systemctl enable ${SERVICE_NAME}`);
-  execSync(`systemctl start ${SERVICE_NAME}`);
+  execSync(`systemctl enable ${serviceName}`);
+  execSync(`systemctl start ${serviceName}`);
   console.log(`
-Service ${SERVICE_NAME} installed and started.`);
-  console.log(`Check status: systemctl status ${SERVICE_NAME}`);
+Service ${serviceName} installed and started.`);
+  console.log(`Check status: systemctl status ${serviceName}`);
+  console.log(`Logs: tail -f ${paths.logDir}/stdout.log`);
 }
-function install(token) {
+function install(token, name) {
   if (process.platform === "darwin") {
-    installMac(token);
+    installMac(token, name);
   } else if (process.platform === "linux") {
-    installLinux(token);
+    installLinux(token, name);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);

package/dist/cli/install.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/install.ts"],"names":[],"mappings":"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","file":"install.js","sourcesContent":["import { execSync } from 'node:child_process';\nimport { chmodSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join } from 'node:path';\n\nconst SERVICE_NAME = 'deskfree-agent';\nconst PACKAGE = '@questionbase/deskfree@latest';\n\n// ── macOS (launchd) ─────────────────────────────────────────────────────────\n\nconst PLIST_LABEL = 'com.deskfree.agent';\n\nfunction getMacPaths() {\n  const home = homedir();\n  const deskfreeDir = join(home, '.deskfree');\n  return {\n    deskfreeDir,\n    envFile: join(deskfreeDir, '.env'),\n    launcher: join(deskfreeDir, 'launcher.sh'),\n    logDir: join(deskfreeDir, 'logs'),\n    plist: join(home, 'Library', 'LaunchAgents', `${PLIST_LABEL}.plist`),\n  };\n}\n\nfunction installMac(token: string): void {\n  const paths = getMacPaths();\n\n  // Resolve full path to node's bin directory (survives nvm/fnm across sessions)\n  let nodeBinDir: string;\n  try {\n    const nodePath = execSync('which node', { encoding: 'utf8' }).trim();\n    nodeBinDir = dirname(nodePath);\n  } catch {\n    console.error('Error: node not found in PATH');\n    process.exit(1);\n  }\n\n  // Create directories\n  mkdirSync(paths.deskfreeDir, { recursive: true });\n  mkdirSync(paths.logDir, { recursive: true });\n  mkdirSync(dirname(paths.plist), { recursive: true });\n\n  // Write env file (chmod 600)\n  writeFileSync(paths.envFile, `DESKFREE_LAUNCH=${token}\\n`, { mode: 0o600 });\n  chmodSync(paths.envFile, 0o600);\n  console.log(`Wrote ${paths.envFile}`);\n\n  // Write launcher script\n  const launcher = `#!/bin/bash\nset -euo pipefail\n\nexport PATH=\"${nodeBinDir}:$PATH\"\n\n# Update to latest version before starting\nnpm install -g ${PACKAGE} 2>/dev/null || true\n\n# Source env\nset -a\nsource \"${paths.envFile}\"\nset +a\n\nexec deskfree-agent start\n`;\n\n  writeFileSync(paths.launcher, launcher, { mode: 0o755 });\n  chmodSync(paths.launcher, 0o755);\n  console.log(`Wrote ${paths.launcher}`);\n\n  // Write LaunchAgent plist\n  const plist = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>${PLIST_LABEL}</string>\n  <key>ProgramArguments</key>\n  <array>\n    <string>${paths.launcher}</string>\n  </array>\n  <key>KeepAlive</key>\n  <true/>\n  <key>RunAtLoad</key>\n  <true/>\n  <key>StandardOutPath</key>\n  <string>${join(paths.logDir, 'stdout.log')}</string>\n  <key>StandardErrorPath</key>\n  <string>${join(paths.logDir, 'stderr.log')}</string>\n  <key>ThrottleInterval</key>\n  <integer>10</integer>\n</dict>\n</plist>\n`;\n\n  writeFileSync(paths.plist, plist);\n  console.log(`Wrote ${paths.plist}`);\n\n  // Unload if already loaded (ignore errors)\n  try {\n    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {\n      stdio: 'ignore',\n    });\n  } catch {\n    // not loaded — fine\n  }\n\n  // Load the service\n  execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);\n\n  console.log(`\\nService ${PLIST_LABEL} installed and started.`);\n  console.log(`Check status: launchctl print gui/$(id -u)/${PLIST_LABEL}`);\n  console.log(`Logs: tail -f ${join(paths.logDir, 'stdout.log')}`);\n}\n\n// ── Linux (systemd) ─────────────────────────────────────────────────────────\n\nconst SYSTEMD_SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;\nconst SYSTEMD_ENV_FILE = `/etc/${SERVICE_NAME}.env`;\n\nfunction installLinux(token: string): void {\n  if (process.getuid?.() !== 0) {\n    console.error('Error: install must be run as root (use sudo)');\n    process.exit(1);\n  }\n\n  // Resolve full npx path so systemd doesn't depend on PATH\n  let npxPath: string;\n  try {\n    npxPath = execSync('which npx', { encoding: 'utf8' }).trim();\n  } catch {\n    console.error('Error: npx not found in PATH');\n    process.exit(1);\n  }\n\n  // Write env file with token (chmod 600 — only root can read)\n  writeFileSync(SYSTEMD_ENV_FILE, `DESKFREE_LAUNCH=${token}\\n`, {\n    mode: 0o600,\n  });\n  chmodSync(SYSTEMD_ENV_FILE, 0o600);\n  console.log(`Wrote ${SYSTEMD_ENV_FILE}`);\n\n  // Write systemd unit file\n  const unit = `[Unit]\nDescription=DeskFree Agent\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nType=simple\nExecStartPre=${npxPath} ${PACKAGE} --version\nExecStart=${npxPath} ${PACKAGE} start\nEnvironmentFile=${SYSTEMD_ENV_FILE}\nEnvironment=NODE_ENV=production\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target\n`;\n\n  writeFileSync(SYSTEMD_SERVICE_FILE, unit);\n  console.log(`Wrote ${SYSTEMD_SERVICE_FILE}`);\n\n  // Enable and start\n  execSync('systemctl daemon-reload');\n  execSync(`systemctl enable ${SERVICE_NAME}`);\n  execSync(`systemctl start ${SERVICE_NAME}`);\n\n  console.log(`\\nService ${SERVICE_NAME} installed and started.`);\n  console.log(`Check status: systemctl status ${SERVICE_NAME}`);\n}\n\n// ── Public API ──────────────────────────────────────────────────────────────\n\nexport function install(token: string): void {\n  if (process.platform === 'darwin') {\n    installMac(token);\n  } else if (process.platform === 'linux') {\n    installLinux(token);\n  } else {\n    console.error(`Unsupported platform: ${process.platform}`);\n    process.exit(1);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/cli/paths.ts","../../src/cli/install.ts"],"names":["join"],"mappings":"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","file":"install.js","sourcesContent":["import { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nconst DEFAULT_NAME = 'main';\n\nexport function resolveName(name?: string): string {\n  return name ?? DEFAULT_NAME;\n}\n\nexport function getPlistLabel(name: string): string {\n  return `com.deskfree.agent.${name}`;\n}\n\nexport function getServiceName(name: string): string {\n  return `deskfree-agent-${name}`;\n}\n\nexport function getMacPaths(name: string) {\n  const home = homedir();\n  const deskfreeDir = join(home, '.deskfree', name);\n  const plistLabel = getPlistLabel(name);\n  return {\n    deskfreeDir,\n    envFile: join(deskfreeDir, '.env'),\n    launcher: join(deskfreeDir, 'launcher.sh'),\n    logDir: join(deskfreeDir, 'logs'),\n    plist: join(home, 'Library', 'LaunchAgents', `${plistLabel}.plist`),\n  };\n}\n\nexport function getLinuxPaths(name: string) {\n  const serviceName = getServiceName(name);\n  return {\n    serviceName,\n    serviceFile: `/etc/systemd/system/${serviceName}.service`,\n    envFile: `/etc/${serviceName}.env`,\n    stateDir: `/var/lib/${serviceName}`,\n    logDir: `/var/log/${serviceName}`,\n  };\n}\n\n/** Parse --name <value> from argv, returning [resolvedName, remainingArgs]. */\nexport function parseName(args: string[]): [string, string[]] {\n  const idx = args.indexOf('--name');\n  if (idx === -1) return [DEFAULT_NAME, args];\n  const name = args[idx + 1];\n  if (!name || name.startsWith('-')) {\n    console.error('Error: --name requires a value (e.g. --name kasper)');\n    process.exit(1);\n  }\n  if (!/^[a-z0-9-]+$/i.test(name)) {\n    console.error(\n      'Error: --name must contain only letters, numbers, and hyphens',\n    );\n    process.exit(1);\n  }\n  const remaining = [...args.slice(0, idx), ...args.slice(idx + 2)];\n  return [name, remaining];\n}\n","import {\n  getLinuxPaths,\n  getMacPaths,\n  getPlistLabel,\n  getServiceName,\n} from './paths.js';\nimport { execSync } from 'node:child_process';\nimport { chmodSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nconst PACKAGE = '@questionbase/deskfree@latest';\n\n// ── macOS (launchd) ─────────────────────────────────────────────────────────\n\nfunction installMac(token: string, name: string): void {\n  const paths = getMacPaths(name);\n  const plistLabel = getPlistLabel(name);\n\n  // Resolve full path to node's bin directory (survives nvm/fnm across sessions)\n  let nodeBinDir: string;\n  try {\n    const nodePath = execSync('which node', { encoding: 'utf8' }).trim();\n    nodeBinDir = dirname(nodePath);\n  } catch {\n    console.error('Error: node not found in PATH');\n    process.exit(1);\n  }\n\n  // Create directories\n  mkdirSync(paths.deskfreeDir, { recursive: true });\n  mkdirSync(paths.logDir, { recursive: true });\n  mkdirSync(dirname(paths.plist), { recursive: true });\n\n  // Write env file (chmod 600)\n  writeFileSync(\n    paths.envFile,\n    `DESKFREE_LAUNCH=${token}\\nDESKFREE_INSTANCE_NAME=${name}\\n`,\n    { mode: 0o600 },\n  );\n  chmodSync(paths.envFile, 0o600);\n  console.log(`Wrote ${paths.envFile}`);\n\n  // Write launcher script\n  const launcher = `#!/bin/bash\nset -euo pipefail\n\nexport PATH=\"${nodeBinDir}:$PATH\"\n\n# Update to latest version before starting\nnpm install -g ${PACKAGE} 2>/dev/null || true\n\n# Source env\nset -a\nsource \"${paths.envFile}\"\nset +a\n\nexec deskfree-agent start\n`;\n\n  writeFileSync(paths.launcher, launcher, { mode: 0o755 });\n  chmodSync(paths.launcher, 0o755);\n  console.log(`Wrote ${paths.launcher}`);\n\n  // Write LaunchAgent plist\n  const plist = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>${plistLabel}</string>\n  <key>ProgramArguments</key>\n  <array>\n    <string>${paths.launcher}</string>\n  </array>\n  <key>KeepAlive</key>\n  <true/>\n  <key>RunAtLoad</key>\n  <true/>\n  <key>StandardOutPath</key>\n  <string>${join(paths.logDir, 'stdout.log')}</string>\n  <key>StandardErrorPath</key>\n  <string>${join(paths.logDir, 'stderr.log')}</string>\n  <key>ThrottleInterval</key>\n  <integer>10</integer>\n</dict>\n</plist>\n`;\n\n  writeFileSync(paths.plist, plist);\n  console.log(`Wrote ${paths.plist}`);\n\n  // Unload if already loaded (ignore errors)\n  try {\n    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {\n      stdio: 'ignore',\n    });\n  } catch {\n    // not loaded — fine\n  }\n\n  // Load the service\n  execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);\n\n  console.log(`\\nService ${plistLabel} installed and started.`);\n  console.log(`Check status: launchctl print gui/$(id -u)/${plistLabel}`);\n  console.log(`Logs: tail -f ${join(paths.logDir, 'stdout.log')}`);\n}\n\n// ── Linux (systemd) ─────────────────────────────────────────────────────────\n\nfunction installLinux(token: string, name: string): void {\n  if (process.getuid?.() !== 0) {\n    console.error('Error: install must be run as root (use sudo)');\n    process.exit(1);\n  }\n\n  const paths = getLinuxPaths(name);\n  const serviceName = getServiceName(name);\n  const systemUser = serviceName;\n\n  // Resolve full npm/node bin dir so systemd doesn't depend on PATH\n  let npmPath: string;\n  let nodeBinDir: string;\n  try {\n    npmPath = execSync('which npm', { encoding: 'utf8' }).trim();\n    nodeBinDir = dirname(npmPath);\n  } catch {\n    console.error('Error: npm not found in PATH');\n    process.exit(1);\n  }\n\n  // Create dedicated system user (no login shell, no home dir)\n  try {\n    execSync(`id ${systemUser}`, { stdio: 'ignore' });\n  } catch {\n    execSync(\n      `useradd --system --no-create-home --shell /usr/sbin/nologin ${systemUser}`,\n    );\n    console.log(`Created system user: ${systemUser}`);\n  }\n\n  // Create state and log directories owned by the service user\n  mkdirSync(paths.stateDir, { recursive: true });\n  mkdirSync(paths.logDir, { recursive: true });\n  execSync(\n    `chown ${systemUser}:${systemUser} ${paths.stateDir} ${paths.logDir}`,\n  );\n  console.log(`Created ${paths.stateDir} and ${paths.logDir}`);\n\n  // Write env file with token (chmod 600 — only root can read)\n  writeFileSync(\n    paths.envFile,\n    `DESKFREE_LAUNCH=${token}\\nDESKFREE_INSTANCE_NAME=${name}\\n`,\n    { mode: 0o600 },\n  );\n  chmodSync(paths.envFile, 0o600);\n  console.log(`Wrote ${paths.envFile}`);\n\n  // Write systemd unit file\n  const unit = `[Unit]\nDescription=DeskFree Agent (${name})\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nType=simple\nUser=${systemUser}\nGroup=${systemUser}\nWorkingDirectory=${paths.stateDir}\nEnvironment=PATH=${nodeBinDir}:/usr/local/bin:/usr/bin:/bin\nExecStartPre=+${npmPath} install -g ${PACKAGE}\nExecStart=${nodeBinDir}/deskfree-agent start\nEnvironmentFile=${paths.envFile}\nEnvironment=NODE_ENV=production\nEnvironment=DESKFREE_STATE_DIR=${paths.stateDir}\nEnvironment=DESKFREE_TOOLS_DIR=${paths.stateDir}/tools\nRestart=always\nRestartSec=10\nStandardOutput=append:${paths.logDir}/stdout.log\nStandardError=append:${paths.logDir}/stderr.log\n\n[Install]\nWantedBy=multi-user.target\n`;\n\n  writeFileSync(paths.serviceFile, unit);\n  console.log(`Wrote ${paths.serviceFile}`);\n\n  // Enable and start\n  execSync('systemctl daemon-reload');\n  execSync(`systemctl enable ${serviceName}`);\n  execSync(`systemctl start ${serviceName}`);\n\n  console.log(`\\nService ${serviceName} installed and started.`);\n  console.log(`Check status: systemctl status ${serviceName}`);\n  console.log(`Logs: tail -f ${paths.logDir}/stdout.log`);\n}\n\n// ── Public API ──────────────────────────────────────────────────────────────\n\nexport function install(token: string, name: string): void {\n  if (process.platform === 'darwin') {\n    installMac(token, name);\n  } else if (process.platform === 'linux') {\n    installLinux(token, name);\n  } else {\n    console.error(`Unsupported platform: ${process.platform}`);\n    process.exit(1);\n  }\n}\n"]}

package/dist/cli/uninstall.d.ts

@@ -1,3 +1,3 @@
-declare function uninstall(): void;
+declare function uninstall(name: string): void;
 
 export { uninstall };

package/dist/cli/uninstall.js

@@ -1,64 +1,89 @@
 import { createRequire } from 'node:module';
-import { execSync } from 'child_process';
-import { existsSync, unlinkSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
+import { execSync } from 'child_process';
+import { existsSync, unlinkSync } from 'fs';
 
 createRequire(import.meta.url);
-var SERVICE_NAME = "deskfree-agent";
-var PLIST_LABEL = "com.deskfree.agent";
-function uninstallMac() {
+function getPlistLabel(name) {
+  return `com.deskfree.agent.${name}`;
+}
+function getServiceName(name) {
+  return `deskfree-agent-${name}`;
+}
+function getMacPaths(name) {
   const home = homedir();
-  const plist = join(home, "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
-  const deskfreeDir = join(home, ".deskfree");
-  const envFile = join(deskfreeDir, ".env");
-  const launcher = join(deskfreeDir, "launcher.sh");
+  const deskfreeDir = join(home, ".deskfree", name);
+  const plistLabel = getPlistLabel(name);
+  return {
+    deskfreeDir,
+    envFile: join(deskfreeDir, ".env"),
+    launcher: join(deskfreeDir, "launcher.sh"),
+    logDir: join(deskfreeDir, "logs"),
+    plist: join(home, "Library", "LaunchAgents", `${plistLabel}.plist`)
+  };
+}
+function getLinuxPaths(name) {
+  const serviceName = getServiceName(name);
+  return {
+    serviceName,
+    serviceFile: `/etc/systemd/system/${serviceName}.service`,
+    envFile: `/etc/${serviceName}.env`,
+    stateDir: `/var/lib/${serviceName}`,
+    logDir: `/var/log/${serviceName}`
+  };
+}
+function uninstallMac(name) {
+  const paths = getMacPaths(name);
+  const plistLabel = getPlistLabel(name);
   try {
-    execSync(`launchctl bootout gui/$(id -u) ${plist}`, { stdio: "ignore" });
+    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {
+      stdio: "ignore"
+    });
   } catch {
   }
-  for (const file of [plist, envFile, launcher]) {
+  for (const file of [paths.plist, paths.envFile, paths.launcher]) {
     if (existsSync(file)) {
       unlinkSync(file);
       console.log(`Removed ${file}`);
     }
   }
-  console.log(`Service ${PLIST_LABEL} uninstalled.`);
+  console.log(`Service ${plistLabel} uninstalled.`);
   console.log(
-    `Note: logs and state in ${deskfreeDir} were preserved. Remove manually if desired.`
+    `Note: logs and state in ${paths.deskfreeDir} were preserved. Remove manually if desired.`
   );
 }
-var SYSTEMD_SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;
-var SYSTEMD_ENV_FILE = `/etc/${SERVICE_NAME}.env`;
-function uninstallLinux() {
+function uninstallLinux(name) {
   if (process.getuid?.() !== 0) {
     console.error("Error: uninstall must be run as root (use sudo)");
     process.exit(1);
   }
+  const paths = getLinuxPaths(name);
+  const serviceName = getServiceName(name);
   try {
-    execSync(`systemctl stop ${SERVICE_NAME}`, { stdio: "ignore" });
+    execSync(`systemctl stop ${serviceName}`, { stdio: "ignore" });
   } catch {
   }
   try {
-    execSync(`systemctl disable ${SERVICE_NAME}`, { stdio: "ignore" });
+    execSync(`systemctl disable ${serviceName}`, { stdio: "ignore" });
   } catch {
   }
-  if (existsSync(SYSTEMD_SERVICE_FILE)) {
-    unlinkSync(SYSTEMD_SERVICE_FILE);
-    console.log(`Removed ${SYSTEMD_SERVICE_FILE}`);
+  if (existsSync(paths.serviceFile)) {
+    unlinkSync(paths.serviceFile);
+    console.log(`Removed ${paths.serviceFile}`);
   }
-  if (existsSync(SYSTEMD_ENV_FILE)) {
-    unlinkSync(SYSTEMD_ENV_FILE);
-    console.log(`Removed ${SYSTEMD_ENV_FILE}`);
+  if (existsSync(paths.envFile)) {
+    unlinkSync(paths.envFile);
+    console.log(`Removed ${paths.envFile}`);
   }
   execSync("systemctl daemon-reload");
-  console.log(`Service ${SERVICE_NAME} uninstalled.`);
+  console.log(`Service ${serviceName} uninstalled.`);
 }
-function uninstall() {
+function uninstall(name) {
   if (process.platform === "darwin") {
-    uninstallMac();
+    uninstallMac(name);
   } else if (process.platform === "linux") {
-    uninstallLinux();
+    uninstallLinux(name);
   } else {
     console.error(`Unsupported platform: ${process.platform}`);
     process.exit(1);

package/dist/cli/uninstall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/uninstall.ts"],"names":[],"mappings":"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","file":"uninstall.js","sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, unlinkSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nconst SERVICE_NAME = 'deskfree-agent';\n\n// ── macOS (launchd) ─────────────────────────────────────────────────────────\n\nconst PLIST_LABEL = 'com.deskfree.agent';\n\nfunction uninstallMac(): void {\n  const home = homedir();\n  const plist = join(home, 'Library', 'LaunchAgents', `${PLIST_LABEL}.plist`);\n  const deskfreeDir = join(home, '.deskfree');\n  const envFile = join(deskfreeDir, '.env');\n  const launcher = join(deskfreeDir, 'launcher.sh');\n\n  // Unload (ignore errors if not loaded)\n  try {\n    execSync(`launchctl bootout gui/$(id -u) ${plist}`, { stdio: 'ignore' });\n  } catch {\n    // not loaded — fine\n  }\n\n  // Remove files\n  for (const file of [plist, envFile, launcher]) {\n    if (existsSync(file)) {\n      unlinkSync(file);\n      console.log(`Removed ${file}`);\n    }\n  }\n\n  console.log(`Service ${PLIST_LABEL} uninstalled.`);\n  console.log(\n    `Note: logs and state in ${deskfreeDir} were preserved. Remove manually if desired.`,\n  );\n}\n\n// ── Linux (systemd) ─────────────────────────────────────────────────────────\n\nconst SYSTEMD_SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;\nconst SYSTEMD_ENV_FILE = `/etc/${SERVICE_NAME}.env`;\n\nfunction uninstallLinux(): void {\n  if (process.getuid?.() !== 0) {\n    console.error('Error: uninstall must be run as root (use sudo)');\n    process.exit(1);\n  }\n\n  // Stop and disable (ignore errors if not running/enabled)\n  try {\n    execSync(`systemctl stop ${SERVICE_NAME}`, { stdio: 'ignore' });\n  } catch {\n    // not running — fine\n  }\n  try {\n    execSync(`systemctl disable ${SERVICE_NAME}`, { stdio: 'ignore' });\n  } catch {\n    // not enabled — fine\n  }\n\n  // Remove files\n  if (existsSync(SYSTEMD_SERVICE_FILE)) {\n    unlinkSync(SYSTEMD_SERVICE_FILE);\n    console.log(`Removed ${SYSTEMD_SERVICE_FILE}`);\n  }\n  if (existsSync(SYSTEMD_ENV_FILE)) {\n    unlinkSync(SYSTEMD_ENV_FILE);\n    console.log(`Removed ${SYSTEMD_ENV_FILE}`);\n  }\n\n  execSync('systemctl daemon-reload');\n  console.log(`Service ${SERVICE_NAME} uninstalled.`);\n}\n\n// ── Public API ──────────────────────────────────────────────────────────────\n\nexport function uninstall(): void {\n  if (process.platform === 'darwin') {\n    uninstallMac();\n  } else if (process.platform === 'linux') {\n    uninstallLinux();\n  } else {\n    console.error(`Unsupported platform: ${process.platform}`);\n    process.exit(1);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/cli/paths.ts","../../src/cli/uninstall.ts"],"names":[],"mappings":";;;;;;;AASO,SAAS,cAAc,IAAA,EAAsB;AAClD,EAAA,OAAO,sBAAsB,IAAI,CAAA,CAAA;AACnC;AAEO,SAAS,eAAe,IAAA,EAAsB;AACnD,EAAA,OAAO,kBAAkB,IAAI,CAAA,CAAA;AAC/B;AAEO,SAAS,YAAY,IAAA,EAAc;AACxC,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,IAAA,EAAM,WAAA,EAAa,IAAI,CAAA;AAChD,EAAA,MAAM,UAAA,GAAa,cAAc,IAAI,CAAA;AACrC,EAAA,OAAO;AAAA,IACL,WAAA;AAAA,IACA,OAAA,EAAS,IAAA,CAAK,WAAA,EAAa,MAAM,CAAA;AAAA,IACjC,QAAA,EAAU,IAAA,CAAK,WAAA,EAAa,aAAa,CAAA;AAAA,IACzC,MAAA,EAAQ,IAAA,CAAK,WAAA,EAAa,MAAM,CAAA;AAAA,IAChC,OAAO,IAAA,CAAK,IAAA,EAAM,WAAW,cAAA,EAAgB,CAAA,EAAG,UAAU,CAAA,MAAA,CAAQ;AAAA,GACpE;AACF;AAEO,SAAS,cAAc,IAAA,EAAc;AAC1C,EAAA,MAAM,WAAA,GAAc,eAAe,IAAI,CAAA;AACvC,EAAA,OAAO;AAAA,IACL,WAAA;AAAA,IACA,WAAA,EAAa,uBAAuB,WAAW,CAAA,QAAA,CAAA;AAAA,IAC/C,OAAA,EAAS,QAAQ,WAAW,CAAA,IAAA,CAAA;AAAA,IAC5B,QAAA,EAAU,YAAY,WAAW,CAAA,CAAA;AAAA,IACjC,MAAA,EAAQ,YAAY,WAAW,CAAA;AAAA,GACjC;AACF;AC5BA,SAAS,aAAa,IAAA,EAAoB;AACxC,EAAA,MAAM,KAAA,GAAQ,YAAY,IAAI,CAAA;AAC9B,EAAA,MAAM,UAAA,GAAa,cAAc,IAAI,CAAA;AAGrC,EAAA,IAAI;AACF,IAAA,QAAA,CAAS,CAAA,+BAAA,EAAkC,KAAA,CAAM,KAAK,CAAA,CAAA,EAAI;AAAA,MACxD,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH,CAAA,CAAA,MAAQ;AAAA,EAER;AAGA,EAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,KAAA,CAAM,KAAA,EAAO,MAAM,OAAA,EAAS,KAAA,CAAM,QAAQ,CAAA,EAAG;AAC/D,IAAA,IAAI,UAAA,CAAW,IAAI,CAAA,EAAG;AACpB,MAAA,UAAA,CAAW,IAAI,CAAA;AACf,MAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,QAAA,EAAW,IAAI,CAAA,CAAE,CAAA;AAAA,IAC/B;AAAA,EACF;AAEA,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,QAAA,EAAW,UAAU,CAAA,aAAA,CAAe,CAAA;AAChD,EAAA,OAAA,CAAQ,GAAA;AAAA,IACN,CAAA,wBAAA,EAA2B,MAAM,WAAW,CAAA,4CAAA;AAAA,GAC9C;AACF;AAIA,SAAS,eAAe,IAAA,EAAoB;AAC1C,EAAA,IAAI,OAAA,CAAQ,MAAA,IAAS,KAAM,CAAA,EAAG;AAC5B,IAAA,OAAA,CAAQ,MAAM,iDAAiD,CAAA;AAC/D,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB;AAEA,EAAA,MAAM,KAAA,GAAQ,cAAc,IAAI,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,eAAe,IAAI,CAAA;AAGvC,EAAA,IAAI;AACF,IAAA,QAAA,CAAS,kBAAkB,WAAW,CAAA,CAAA,EAAI,EAAE,KAAA,EAAO,UAAU,CAAA;AAAA,EAC/D,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,IAAI;AACF,IAAA,QAAA,CAAS,qBAAqB,WAAW,CAAA,CAAA,EAAI,EAAE,KAAA,EAAO,UAAU,CAAA;AAAA,EAClE,CAAA,CAAA,MAAQ;AAAA,EAER;AAGA,EAAA,IAAI,UAAA,CAAW,KAAA,CAAM,WAAW,CAAA,EAAG;AACjC,IAAA,UAAA,CAAW,MAAM,WAAW,CAAA;AAC5B,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,QAAA,EAAW,KAAA,CAAM,WAAW,CAAA,CAAE,CAAA;AAAA,EAC5C;AACA,EAAA,IAAI,UAAA,CAAW,KAAA,CAAM,OAAO,CAAA,EAAG;AAC7B,IAAA,UAAA,CAAW,MAAM,OAAO,CAAA;AACxB,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,QAAA,EAAW,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EACxC;AAEA,EAAA,QAAA,CAAS,yBAAyB,CAAA;AAClC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,QAAA,EAAW,WAAW,CAAA,aAAA,CAAe,CAAA;AACnD;AAIO,SAAS,UAAU,IAAA,EAAoB;AAC5C,EAAA,IAAI,OAAA,CAAQ,aAAa,QAAA,EAAU;AACjC,IAAA,YAAA,CAAa,IAAI,CAAA;AAAA,EACnB,CAAA,MAAA,IAAW,OAAA,CAAQ,QAAA,KAAa,OAAA,EAAS;AACvC,IAAA,cAAA,CAAe,IAAI,CAAA;AAAA,EACrB,CAAA,MAAO;AACL,IAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,sBAAA,EAAyB,OAAA,CAAQ,QAAQ,CAAA,CAAE,CAAA;AACzD,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB;AACF","file":"uninstall.js","sourcesContent":["import { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nconst DEFAULT_NAME = 'main';\n\nexport function resolveName(name?: string): string {\n  return name ?? DEFAULT_NAME;\n}\n\nexport function getPlistLabel(name: string): string {\n  return `com.deskfree.agent.${name}`;\n}\n\nexport function getServiceName(name: string): string {\n  return `deskfree-agent-${name}`;\n}\n\nexport function getMacPaths(name: string) {\n  const home = homedir();\n  const deskfreeDir = join(home, '.deskfree', name);\n  const plistLabel = getPlistLabel(name);\n  return {\n    deskfreeDir,\n    envFile: join(deskfreeDir, '.env'),\n    launcher: join(deskfreeDir, 'launcher.sh'),\n    logDir: join(deskfreeDir, 'logs'),\n    plist: join(home, 'Library', 'LaunchAgents', `${plistLabel}.plist`),\n  };\n}\n\nexport function getLinuxPaths(name: string) {\n  const serviceName = getServiceName(name);\n  return {\n    serviceName,\n    serviceFile: `/etc/systemd/system/${serviceName}.service`,\n    envFile: `/etc/${serviceName}.env`,\n    stateDir: `/var/lib/${serviceName}`,\n    logDir: `/var/log/${serviceName}`,\n  };\n}\n\n/** Parse --name <value> from argv, returning [resolvedName, remainingArgs]. */\nexport function parseName(args: string[]): [string, string[]] {\n  const idx = args.indexOf('--name');\n  if (idx === -1) return [DEFAULT_NAME, args];\n  const name = args[idx + 1];\n  if (!name || name.startsWith('-')) {\n    console.error('Error: --name requires a value (e.g. --name kasper)');\n    process.exit(1);\n  }\n  if (!/^[a-z0-9-]+$/i.test(name)) {\n    console.error(\n      'Error: --name must contain only letters, numbers, and hyphens',\n    );\n    process.exit(1);\n  }\n  const remaining = [...args.slice(0, idx), ...args.slice(idx + 2)];\n  return [name, remaining];\n}\n","import {\n  getLinuxPaths,\n  getMacPaths,\n  getPlistLabel,\n  getServiceName,\n} from './paths.js';\nimport { execSync } from 'node:child_process';\nimport { existsSync, unlinkSync } from 'node:fs';\n\n// ── macOS (launchd) ─────────────────────────────────────────────────────────\n\nfunction uninstallMac(name: string): void {\n  const paths = getMacPaths(name);\n  const plistLabel = getPlistLabel(name);\n\n  // Unload (ignore errors if not loaded)\n  try {\n    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {\n      stdio: 'ignore',\n    });\n  } catch {\n    // not loaded — fine\n  }\n\n  // Remove files\n  for (const file of [paths.plist, paths.envFile, paths.launcher]) {\n    if (existsSync(file)) {\n      unlinkSync(file);\n      console.log(`Removed ${file}`);\n    }\n  }\n\n  console.log(`Service ${plistLabel} uninstalled.`);\n  console.log(\n    `Note: logs and state in ${paths.deskfreeDir} were preserved. Remove manually if desired.`,\n  );\n}\n\n// ── Linux (systemd) ─────────────────────────────────────────────────────────\n\nfunction uninstallLinux(name: string): void {\n  if (process.getuid?.() !== 0) {\n    console.error('Error: uninstall must be run as root (use sudo)');\n    process.exit(1);\n  }\n\n  const paths = getLinuxPaths(name);\n  const serviceName = getServiceName(name);\n\n  // Stop and disable (ignore errors if not running/enabled)\n  try {\n    execSync(`systemctl stop ${serviceName}`, { stdio: 'ignore' });\n  } catch {\n    // not running — fine\n  }\n  try {\n    execSync(`systemctl disable ${serviceName}`, { stdio: 'ignore' });\n  } catch {\n    // not enabled — fine\n  }\n\n  // Remove files\n  if (existsSync(paths.serviceFile)) {\n    unlinkSync(paths.serviceFile);\n    console.log(`Removed ${paths.serviceFile}`);\n  }\n  if (existsSync(paths.envFile)) {\n    unlinkSync(paths.envFile);\n    console.log(`Removed ${paths.envFile}`);\n  }\n\n  execSync('systemctl daemon-reload');\n  console.log(`Service ${serviceName} uninstalled.`);\n}\n\n// ── Public API ──────────────────────────────────────────────────────────────\n\nexport function uninstall(name: string): void {\n  if (process.platform === 'darwin') {\n    uninstallMac(name);\n  } else if (process.platform === 'linux') {\n    uninstallLinux(name);\n  } else {\n    console.error(`Unsupported platform: ${process.platform}`);\n    process.exit(1);\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PluginLogger, DeskFreeClient, DeskFreeTool, ChatMessage, RuntimeBootstrapConfig } from '@deskfree/core';
+import { PluginLogger, AgentContext, DeskFreeClient, DeskFreeTool, ChatMessage, RuntimeBootstrapConfig } from '@deskfree/core';
 import * as _anthropic_ai_claude_agent_sdk from '@anthropic-ai/claude-agent-sdk';
 import { McpSdkServerConfigWithInstance, SDKMessage, SDKUserMessage, Query, tool } from '@anthropic-ai/claude-agent-sdk';
 
@@ -28,6 +28,8 @@ interface OrchestratorQueryOptions {
     sessionId?: string;
     /** Path to user's Claude Code executable (uses bundled CLI if omitted). */
     claudeCodePath?: string;
+    /** Runtime context for templated system prompt. Falls back to static directive if omitted. */
+    agentContext?: AgentContext;
 }
 /**
  * Run the orchestrator agent. Returns an async iterable of SDKMessage events.
@@ -44,6 +46,8 @@ interface HeartbeatOptions {
     model: string;
     /** Path to user's Claude Code executable (uses bundled CLI if omitted). */
     claudeCodePath?: string;
+    /** Runtime context for templated system prompt. Falls back to static directive if omitted. */
+    agentContext?: AgentContext;
 }
 /**
  * Run a one-shot heartbeat query (no session persistence).
@@ -56,6 +60,8 @@ interface WorkerQueryOptions {
     model: string;
     /** Agent SDK session ID to resume (for multi-turn task conversations). */
     sessionId?: string;
+    /** Runtime context for templated system prompt. Falls back to static directive if omitted. */
+    agentContext?: AgentContext;
 }
 /**
  * Run the worker agent directly. Returns a Query (async iterable of
@@ -111,6 +117,8 @@ interface WorkerManagerDeps {
     dailyLogCharBudget?: number;
     /** Path to persist session history JSON (taskId → sessionId). */
     sessionHistoryPath?: string;
+    /** Runtime context for templated system prompts. */
+    agentContext?: AgentContext;
 }
 declare class WorkerManager {
     private workers;
@@ -386,6 +394,10 @@ interface RuntimeConfig extends LocalConfig {
     baseUrl?: string;
     /** Bot ID for this runtime instance */
     botId: string;
+    /** Bot's display name (e.g. "Sofia") */
+    botName: string;
+    /** Deployment type (aws, docker, local) */
+    deploymentType: 'aws' | 'docker' | 'local' | null;
     /** File ID for the bot's Memory file (null if not created yet) */
     memoryFileId: string | null;
     /** Hour of day (0-23) in local time for the nightly sleep cycle (null = disabled) */
@@ -409,8 +421,8 @@ declare function loadConfig(): LocalConfig;
  * Env var overrides take precedence over API values for debugging/testing.
  *
  * When running multiple agents on the same machine, stateDir and toolsDir
- * are automatically namespaced by botId (unless explicitly overridden via
- * DESKFREE_STATE_DIR / DESKFREE_TOOLS_DIR env vars).
+ * are namespaced by instance name (DESKFREE_INSTANCE_NAME, default "main").
+ * The instance name is set during `deskfree-agent install --name <name>`.
  */
 declare function mergeWithRemoteConfig(local: LocalConfig, remote: RuntimeBootstrapConfig): RuntimeConfig;