@ch4p/cli 0.2.3 → 0.3.0

package/dist/gateway-BS2IUIQT.js

@@ -0,0 +1,19 @@
+import {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+} from "./chunk-ODOKLIJK.js";
+import "./chunk-WYXCGS55.js";
+import "./chunk-3CYOOHMM.js";
+import "./chunk-MQKGGZAB.js";
+import "./chunk-MABLWEGE.js";
+import "./chunk-6BURGD2Y.js";
+import "./chunk-UNF4S4CA.js";
+import "./chunk-YSCX2QQQ.js";
+import "./chunk-AORLXQHZ.js";
+import "./chunk-NMGPBPNU.js";
+export {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+};

package/dist/gateway-J7WHUIK3.js

@@ -0,0 +1,19 @@
+import {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+} from "./chunk-YTUBP6WQ.js";
+import "./chunk-WYXCGS55.js";
+import "./chunk-3CYOOHMM.js";
+import "./chunk-KLGE5YZR.js";
+import "./chunk-MABLWEGE.js";
+import "./chunk-6BURGD2Y.js";
+import "./chunk-UNF4S4CA.js";
+import "./chunk-YSCX2QQQ.js";
+import "./chunk-AORLXQHZ.js";
+import "./chunk-NMGPBPNU.js";
+export {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+};

package/dist/gateway-JTQ2FYQZ.js

@@ -0,0 +1,19 @@
+import {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+} from "./chunk-2JQRW4PJ.js";
+import "./chunk-WYXCGS55.js";
+import "./chunk-3CYOOHMM.js";
+import "./chunk-KLGE5YZR.js";
+import "./chunk-MABLWEGE.js";
+import "./chunk-6BURGD2Y.js";
+import "./chunk-UNF4S4CA.js";
+import "./chunk-YSCX2QQQ.js";
+import "./chunk-AORLXQHZ.js";
+import "./chunk-NMGPBPNU.js";
+export {
+  applySafeUpdates,
+  buildSafeConfig,
+  gateway
+};

package/dist/index.js

@@ -106,12 +106,12 @@ async function main() {
   const { command, rest } = parseArgs(process.argv);
   switch (command) {
     case "agent": {
-      const { agent } = await import("./agent-4FZCCYPE.js");
+      const { agent } = await import("./agent-FJPYQ6XV.js");
       await agent(rest);
       break;
     }
     case "gateway": {
-      const { gateway } = await import("./gateway-AR6UVNNA.js");
+      const { gateway } = await import("./gateway-BS2IUIQT.js");
       await gateway(rest);
       break;
     }
@@ -156,7 +156,7 @@ async function main() {
       break;
     }
     case "canvas": {
-      const { canvas } = await import("./canvas-MUYO2JL4.js");
+      const { canvas } = await import("./canvas-FTJBNVCM.js");
       await canvas(rest);
       break;
     }
@@ -166,7 +166,7 @@ async function main() {
       break;
     }
     case "install": {
-      const { install } = await import("./install-6LV7B2SV.js");
+      const { install } = await import("./install-4JYHJURZ.js");
       await install(rest);
       break;
     }

package/dist/install-4JYHJURZ.js

@@ -0,0 +1,378 @@
+import {
+  getCh4pDir,
+  getConfigPath,
+  getLogsDir
+} from "./chunk-AORLXQHZ.js";
+import {
+  BOLD,
+  DIM,
+  GREEN,
+  RED,
+  RESET,
+  TEAL,
+  YELLOW
+} from "./chunk-NMGPBPNU.js";
+
+// src/commands/install.ts
+import { execSync } from "child_process";
+import { writeFileSync, mkdirSync, existsSync, rmSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var LAUNCHD_LABEL = "com.ch4p.gateway";
+var SYSTEMD_UNIT = "ch4p-gateway";
+function run(cmd) {
+  try {
+    return execSync(cmd, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+function runOrThrow(cmd, errMsg) {
+  try {
+    return execSync(cmd, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(`${errMsg}
+  ${DIM}${detail}${RESET}`);
+  }
+}
+function findBinary() {
+  const which = run("which ch4p");
+  if (which && which.length > 0) return which;
+  const script = process.argv[1];
+  if (script) {
+    const dir = script.replace(/[/\\][^/\\]+$/, "");
+    const candidate = join(dir, "index.js");
+    if (existsSync(candidate)) {
+      return `${process.execPath} ${candidate}`;
+    }
+  }
+  return "ch4p";
+}
+function launchdPlistPath() {
+  return join(homedir(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+}
+function buildLaunchdPlist(binaryPath, ch4pDir, logsDir) {
+  const spaceIdx = binaryPath.indexOf(" ");
+  const programArgs = spaceIdx !== -1 ? [binaryPath.slice(0, spaceIdx), binaryPath.slice(spaceIdx + 1), "gateway"] : [binaryPath, "gateway"];
+  const programArgsXml = programArgs.map((a) => `		<string>${a}</string>`).join("\n");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>${LAUNCHD_LABEL}</string>
+
+	<key>ProgramArguments</key>
+	<array>
+${programArgsXml}
+	</array>
+
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>HOME</key>
+		<string>${homedir()}</string>
+		<key>PATH</key>
+		<string>${homedir()}/.local/bin:/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+	</dict>
+
+	<key>WorkingDirectory</key>
+	<string>${ch4pDir}</string>
+
+	<key>RunAtLoad</key>
+	<true/>
+
+	<key>KeepAlive</key>
+	<true/>
+
+	<key>ThrottleInterval</key>
+	<integer>5</integer>
+
+	<key>StandardOutPath</key>
+	<string>${logsDir}/gateway-stdout.log</string>
+
+	<key>StandardErrorPath</key>
+	<string>${logsDir}/gateway-stderr.log</string>
+</dict>
+</plist>
+`;
+}
+function installLaunchd(binaryPath) {
+  const ch4pDir = getCh4pDir();
+  const logsDir = getLogsDir();
+  const plistPath = launchdPlistPath();
+  const plistDir = join(homedir(), "Library", "LaunchAgents");
+  mkdirSync(plistDir, { recursive: true });
+  mkdirSync(logsDir, { recursive: true });
+  const plist = buildLaunchdPlist(binaryPath, ch4pDir, logsDir);
+  writeFileSync(plistPath, plist, { mode: 420 });
+  console.log(`  ${GREEN}\u2713${RESET} Wrote ${plistPath}`);
+  run(`launchctl unload "${plistPath}" 2>/dev/null`);
+  runOrThrow(
+    `launchctl load -w "${plistPath}"`,
+    "Failed to load plist with launchctl."
+  );
+  console.log(`  ${GREEN}\u2713${RESET} Service loaded and started`);
+  console.log(`
+  ${DIM}Check status:  ${TEAL}ch4p install --status${RESET}`);
+  console.log(`  ${DIM}Tail logs:     ${TEAL}ch4p install --logs${RESET}`);
+  console.log(`  ${DIM}Remove:        ${TEAL}ch4p install --uninstall${RESET}`);
+}
+function uninstallLaunchd() {
+  const plistPath = launchdPlistPath();
+  if (!existsSync(plistPath)) {
+    console.log(`  ${YELLOW}\u26A0 No service file found at${RESET} ${plistPath}`);
+    return;
+  }
+  run(`launchctl unload -w "${plistPath}" 2>/dev/null`);
+  rmSync(plistPath);
+  console.log(`  ${GREEN}\u2713${RESET} Removed ${plistPath}`);
+  console.log(`  ${GREEN}\u2713${RESET} Service unloaded`);
+}
+function statusLaunchd() {
+  const plistPath = launchdPlistPath();
+  if (!existsSync(plistPath)) {
+    console.log(`  ${RED}\u2717 Not installed${RESET} \u2014 run ${TEAL}ch4p install${RESET}`);
+    return;
+  }
+  console.log(`  ${DIM}Plist:${RESET}  ${plistPath}`);
+  const listOutput = run(`launchctl list | grep "${LAUNCHD_LABEL}"`);
+  if (listOutput) {
+    const parts = listOutput.trim().split(/\s+/);
+    const pid = parts[0];
+    const exitCode = parts[1];
+    if (pid && pid !== "-") {
+      console.log(`  ${GREEN}\u25CF Running${RESET}  PID ${pid}`);
+    } else {
+      const exitMsg = exitCode && exitCode !== "0" ? ` (last exit: ${exitCode})` : "";
+      console.log(`  ${YELLOW}\u25CB Stopped${RESET}${exitMsg}`);
+    }
+  } else {
+    console.log(`  ${YELLOW}\u25CB Not loaded${RESET}`);
+  }
+}
+function logsLaunchd() {
+  const logsDir = getLogsDir();
+  const outLog = join(logsDir, "gateway-stdout.log");
+  const errLog = join(logsDir, "gateway-stderr.log");
+  const jsonLog = join(logsDir, "gateway.jsonl");
+  if (existsSync(jsonLog)) {
+    console.log(`  ${DIM}Tailing ${jsonLog} \u2014 Ctrl-C to stop${RESET}
+`);
+    try {
+      execSync(`tail -f "${jsonLog}"`, { stdio: "inherit" });
+    } catch {
+    }
+    return;
+  }
+  if (existsSync(errLog) || existsSync(outLog)) {
+    const target = existsSync(errLog) ? errLog : outLog;
+    console.log(`  ${DIM}Tailing ${target} \u2014 Ctrl-C to stop${RESET}
+`);
+    try {
+      execSync(`tail -f "${target}"`, { stdio: "inherit" });
+    } catch {
+    }
+    return;
+  }
+  console.log(`  ${YELLOW}\u26A0 No log files found yet.${RESET}`);
+  console.log(`  ${DIM}Logs appear after the first gateway run.${RESET}`);
+  console.log(`  ${DIM}Expected: ${outLog}${RESET}`);
+}
+function systemdUnitPath() {
+  const configHome = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+  return join(configHome, "systemd", "user", `${SYSTEMD_UNIT}.service`);
+}
+function buildSystemdUnit(binaryPath, ch4pDir, logsDir) {
+  const envFile = join(ch4pDir, ".env");
+  const envFileLine = existsSync(envFile) ? `EnvironmentFile=-${envFile}
+` : "";
+  const execStart = `ExecStart=${binaryPath} gateway`;
+  return `[Unit]
+Description=ch4p Gateway \u2014 Personal AI Assistant
+Documentation=https://github.com/ch4p/ch4p
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+${envFileLine}Environment=HOME=${homedir()}
+WorkingDirectory=${ch4pDir}
+${execStart}
+Restart=on-failure
+RestartSec=5
+TimeoutStopSec=40
+KillMode=mixed
+
+# Logs are written to the systemd journal and optionally to ${logsDir}.
+# View with: journalctl --user -u ${SYSTEMD_UNIT} -f
+
+[Install]
+WantedBy=default.target
+`;
+}
+function installSystemd(binaryPath) {
+  const ch4pDir = getCh4pDir();
+  const logsDir = getLogsDir();
+  const unitPath = systemdUnitPath();
+  const unitDir = unitPath.replace(/\/[^/]+$/, "");
+  mkdirSync(unitDir, { recursive: true });
+  mkdirSync(logsDir, { recursive: true });
+  const unit = buildSystemdUnit(binaryPath, ch4pDir, logsDir);
+  writeFileSync(unitPath, unit, { mode: 420 });
+  console.log(`  ${GREEN}\u2713${RESET} Wrote ${unitPath}`);
+  runOrThrow("systemctl --user daemon-reload", "systemctl daemon-reload failed.");
+  runOrThrow(`systemctl --user enable ${SYSTEMD_UNIT}`, "systemctl enable failed.");
+  runOrThrow(`systemctl --user start ${SYSTEMD_UNIT}`, "systemctl start failed.");
+  console.log(`  ${GREEN}\u2713${RESET} Service enabled and started`);
+  console.log(`
+  ${DIM}Check status:  ${TEAL}ch4p install --status${RESET}`);
+  console.log(`  ${DIM}Tail logs:     ${TEAL}ch4p install --logs${RESET}`);
+  console.log(`  ${DIM}Remove:        ${TEAL}ch4p install --uninstall${RESET}`);
+}
+function uninstallSystemd() {
+  const unitPath = systemdUnitPath();
+  if (!existsSync(unitPath)) {
+    console.log(`  ${YELLOW}\u26A0 No unit file found at${RESET} ${unitPath}`);
+    return;
+  }
+  run(`systemctl --user stop ${SYSTEMD_UNIT} 2>/dev/null`);
+  run(`systemctl --user disable ${SYSTEMD_UNIT} 2>/dev/null`);
+  rmSync(unitPath);
+  run("systemctl --user daemon-reload 2>/dev/null");
+  console.log(`  ${GREEN}\u2713${RESET} Removed ${unitPath}`);
+  console.log(`  ${GREEN}\u2713${RESET} Service stopped and disabled`);
+}
+function statusSystemd() {
+  const unitPath = systemdUnitPath();
+  if (!existsSync(unitPath)) {
+    console.log(`  ${RED}\u2717 Not installed${RESET} \u2014 run ${TEAL}ch4p install${RESET}`);
+    return;
+  }
+  console.log(`  ${DIM}Unit:${RESET}   ${unitPath}`);
+  const output = run(`systemctl --user status ${SYSTEMD_UNIT} --no-pager -l`);
+  if (output) {
+    for (const line of output.split("\n").slice(0, 8)) {
+      console.log(`  ${DIM}${line}${RESET}`);
+    }
+  } else {
+    console.log(`  ${YELLOW}\u25CB Status unavailable${RESET}`);
+  }
+}
+function logsSystemd() {
+  console.log(`  ${DIM}Tailing journal for ${SYSTEMD_UNIT} \u2014 Ctrl-C to stop${RESET}
+`);
+  try {
+    execSync(`journalctl --user -u ${SYSTEMD_UNIT} -f --no-pager`, { stdio: "inherit" });
+  } catch {
+  }
+}
+function printHelp() {
+  console.log(`
+  ${TEAL}${BOLD}ch4p install${RESET} \u2014 gateway daemon installer
+
+  ${BOLD}Usage${RESET}
+    ${GREEN}ch4p install${RESET}              Install and start the gateway daemon
+    ${GREEN}ch4p install --uninstall${RESET}  Remove the daemon service
+    ${GREEN}ch4p install --status${RESET}     Show current service status
+    ${GREEN}ch4p install --logs${RESET}       Tail live service logs
+
+  ${BOLD}Platforms${RESET}
+    macOS   launchd user agent    ~/Library/LaunchAgents/com.ch4p.gateway.plist
+    Linux   systemd user service  ~/.config/systemd/user/ch4p-gateway.service
+
+  ${BOLD}Notes${RESET}
+    ${DIM}\u2022 No sudo required \u2014 services run as your user.${RESET}
+    ${DIM}\u2022 API keys and channel tokens are loaded from ~/.ch4p/.env automatically.${RESET}
+    ${DIM}\u2022 The service restarts automatically on crash (5-second delay).${RESET}
+    ${DIM}\u2022 Run ${TEAL}ch4p onboard${DIM} first if you have not set up ch4p yet.${RESET}
+`);
+}
+async function install(args) {
+  let action = "install";
+  for (const arg of args) {
+    switch (arg) {
+      case "--uninstall":
+      case "uninstall":
+        action = "uninstall";
+        break;
+      case "--status":
+      case "status":
+        action = "status";
+        break;
+      case "--logs":
+      case "logs":
+        action = "logs";
+        break;
+      case "--help":
+      case "-h":
+        printHelp();
+        return;
+    }
+  }
+  const platform = process.platform;
+  if (platform !== "darwin" && platform !== "linux") {
+    console.error(`
+  ${RED}\u2717 Unsupported platform:${RESET} ${platform}`);
+    console.error(`  ${DIM}ch4p install supports macOS (launchd) and Linux (systemd).${RESET}`);
+    console.error(`  ${DIM}On Windows, see the Docker deployment guide: ${TEAL}ch4p gateway${DIM}.${RESET}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  if (action === "install") {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+      console.error(`
+  ${RED}\u2717 No config found${RESET} at ${configPath}`);
+      console.error(`  ${DIM}Run ${TEAL}ch4p onboard${DIM} first to set up ch4p.${RESET}
+`);
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const banner = {
+    install: "Installing gateway daemon",
+    uninstall: "Removing gateway daemon",
+    status: "Gateway daemon status",
+    logs: "Gateway daemon logs"
+  }[action];
+  console.log(`
+  ${TEAL}${BOLD}${banner}${RESET}`);
+  console.log(`  ${"\u2500".repeat(40)}
+`);
+  if (platform === "darwin") {
+    if (action === "install") {
+      const bin = findBinary();
+      console.log(`  ${DIM}Binary:${RESET}  ${bin}`);
+      console.log(`  ${DIM}Service:${RESET} launchd \u2192 ~/Library/LaunchAgents/com.ch4p.gateway.plist
+`);
+      installLaunchd(bin);
+    } else if (action === "uninstall") {
+      uninstallLaunchd();
+    } else if (action === "status") {
+      statusLaunchd();
+    } else {
+      logsLaunchd();
+    }
+  } else {
+    if (action === "install") {
+      const bin = findBinary();
+      console.log(`  ${DIM}Binary:${RESET}  ${bin}`);
+      console.log(`  ${DIM}Service:${RESET} systemd --user \u2192 ~/.config/systemd/user/ch4p-gateway.service
+`);
+      installSystemd(bin);
+    } else if (action === "uninstall") {
+      uninstallSystemd();
+    } else if (action === "status") {
+      statusSystemd();
+    } else {
+      logsSystemd();
+    }
+  }
+  console.log("");
+}
+export {
+  install
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ch4p/cli",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Personal AI assistant platform — security-first, multi-channel, programmable",
   "license": "Apache-2.0",
   "type": "module",
@@ -53,22 +53,22 @@
     "playwright-core": "^1.50.0"
   },
   "devDependencies": {
-    "@ch4p/agent": "0.2.3",
-    "@ch4p/core": "0.2.3",
-    "@ch4p/security": "0.2.3",
-    "@ch4p/providers": "0.2.3",
-    "@ch4p/memory": "0.2.3",
-    "@ch4p/tools": "0.2.3",
-    "@ch4p/observability": "0.2.3",
-    "@ch4p/channels": "0.2.3",
-    "@ch4p/engines": "0.2.3",
-    "@ch4p/supervisor": "0.2.3",
-    "@ch4p/gateway": "0.2.3",
-    "@ch4p/skills": "0.2.3",
-    "@ch4p/tunnels": "0.2.3",
-    "@ch4p/voice": "0.2.3",
-    "@ch4p/canvas": "0.2.3",
-    "@ch4p/plugin-x402": "0.2.3"
+    "@ch4p/core": "0.3.0",
+    "@ch4p/agent": "0.3.0",
+    "@ch4p/channels": "0.3.0",
+    "@ch4p/security": "0.3.0",
+    "@ch4p/providers": "0.3.0",
+    "@ch4p/memory": "0.3.0",
+    "@ch4p/tools": "0.3.0",
+    "@ch4p/observability": "0.3.0",
+    "@ch4p/engines": "0.3.0",
+    "@ch4p/gateway": "0.3.0",
+    "@ch4p/supervisor": "0.3.0",
+    "@ch4p/skills": "0.3.0",
+    "@ch4p/tunnels": "0.3.0",
+    "@ch4p/voice": "0.3.0",
+    "@ch4p/canvas": "0.3.0",
+    "@ch4p/plugin-x402": "0.3.0"
   },
   "scripts": {
     "build": "tsup",