@kl-c/matrixos 0.3.25 → 0.3.27

package/dist/cli/index.js

@@ -2163,7 +2163,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.3.25",
+    version: "0.3.27",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -167053,6 +167053,226 @@ function executeRgpdConsentCommand(args) {
   }
 }
 
+// packages/omo-opencode/src/cli/service.ts
+var exports_service = {};
+__export(exports_service, {
+  serviceInstallCommand: () => serviceInstallCommand
+});
+import * as os15 from "os";
+import * as fs24 from "fs";
+import * as path29 from "path";
+import { execSync as execSync3 } from "child_process";
+function resolveMatrixosBin2() {
+  try {
+    const p2 = execSync3("command -v matrixos", { encoding: "utf-8" }).trim();
+    if (p2)
+      return p2;
+  } catch {}
+  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path29.join(os15.homedir(), ".bun/bin/matrixos")]) {
+    if (fs24.existsSync(cand))
+      return cand;
+  }
+  return "matrixos";
+}
+function resolveBunBin() {
+  try {
+    const p2 = execSync3("command -v bun", { encoding: "utf-8" }).trim();
+    if (p2)
+      return p2;
+  } catch {}
+  return "/usr/bin/bun";
+}
+function writeFileEnsureDir(filePath, content) {
+  fs24.mkdirSync(path29.dirname(filePath), { recursive: true });
+  fs24.writeFileSync(filePath, content, "utf-8");
+  console.log(`[service] written: ${filePath}`);
+}
+function installSystemd(opts) {
+  const bin = resolveMatrixosBin2();
+  const bun = resolveBunBin();
+  const scope = opts.user ? "--user" : "";
+  const unitDir = opts.user ? path29.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  if (opts.dashboard !== false) {
+    const unit = `[Unit]
+Description=MaTrixOS Dashboard
+After=network.target
+
+[Service]
+Type=simple
+User=${os15.userInfo().username}
+WorkingDirectory=${os15.homedir()}
+Environment=PATH=${envPath}
+Environment=HOME=${os15.homedir()}
+ExecStart=${bin} dashboard --host 0.0.0.0 --daemon
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=${opts.user ? "default.target" : "multi-user.target"}
+`;
+    writeFileEnsureDir(path29.join(unitDir, "matrixos-dashboard.service"), unit);
+  }
+  if (opts.gateway !== false) {
+    const unit = `[Unit]
+Description=MaTrixOS Telegram Gateway
+After=network.target
+
+[Service]
+Type=simple
+User=${os15.userInfo().username}
+WorkingDirectory=${os15.homedir()}
+Environment=PATH=${envPath}
+Environment=HOME=${os15.homedir()}
+ExecStart=${bin} gateway start --command "${bin} run"
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=${opts.user ? "default.target" : "multi-user.target"}
+`;
+    writeFileEnsureDir(path29.join(unitDir, "matrixos-gateway.service"), unit);
+  }
+  console.log("[service] reloading systemd...");
+  if (scope) {
+    execSync3(`${scope} systemctl --user daemon-reload`, { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3(`${scope} systemctl --user enable matrixos-dashboard.service`, { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3(`${scope} systemctl --user enable matrixos-gateway.service`, { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3(`${scope} systemctl --user start matrixos-dashboard.service`, { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3(`${scope} systemctl --user start matrixos-gateway.service`, { stdio: "inherit" });
+  } else {
+    execSync3("systemctl daemon-reload", { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3("systemctl enable matrixos-dashboard.service", { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3("systemctl enable matrixos-gateway.service", { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3("systemctl start matrixos-dashboard.service", { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3("systemctl start matrixos-gateway.service", { stdio: "inherit" });
+  }
+  console.log("[service] systemd units installed and started.");
+}
+function installLaunchd(opts) {
+  const bin = resolveMatrixosBin2();
+  const bun = resolveBunBin();
+  const launchDir = path29.join(os15.homedir(), "Library", "LaunchAgents");
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  if (opts.dashboard !== false) {
+    const label = "com.klc.matrixos.dashboard";
+    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>
+  <key>Label</key>
+  <string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bin}</string>
+    <string>dashboard</string>
+    <string>--host</string>
+    <string>0.0.0.0</string>
+    <string>--daemon</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${os15.homedir()}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${envPath}</string>
+    <key>HOME</key>
+    <string>${os15.homedir()}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-dashboard.log</string>
+  <key>StandardErrorPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-dashboard.log</string>
+</dict>
+</plist>
+`;
+    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
+    execSync3(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+  }
+  if (opts.gateway !== false) {
+    const label = "com.klc.matrixos.gateway";
+    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>
+  <key>Label</key>
+  <string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bin}</string>
+    <string>gateway</string>
+    <string>start</string>
+    <string>--command</string>
+    <string>${bin} run</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${os15.homedir()}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${envPath}</string>
+    <key>HOME</key>
+    <string>${os15.homedir()}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-gateway.log</string>
+  <key>StandardErrorPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-gateway.log</string>
+</dict>
+</plist>
+`;
+    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
+    execSync3(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+  }
+  console.log("[service] launchd agents installed and loaded.");
+}
+function installWindowsNote() {
+  console.log("[service] Windows: no auto-service installer yet.");
+  console.log("  Use Task Scheduler to run `matrixos dashboard --host 0.0.0.0 --daemon`");
+  console.log('  and `matrixos gateway start --command "matrixos run"` at logon.');
+  console.log("  Or run them in the background via a startup script.");
+}
+async function serviceInstallCommand(options) {
+  const platform2 = process.platform;
+  console.log(`[service] detected platform: ${platform2}`);
+  if (platform2 === "linux") {
+    if (!fs24.existsSync("/run/systemd/system") && !fs24.existsSync("/etc/systemd/system")) {
+      console.error("[service] systemd not detected \u2014 cannot install service automatically.");
+      console.error("  Start manually: matrixos dashboard --host 0.0.0.0 --daemon");
+      return 1;
+    }
+    installSystemd(options);
+    return 0;
+  }
+  if (platform2 === "darwin") {
+    installLaunchd(options);
+    return 0;
+  }
+  if (platform2 === "win32") {
+    installWindowsNote();
+    return 0;
+  }
+  console.error(`[service] unsupported platform: ${platform2}`);
+  return 1;
+}
+var init_service = () => {};
+
 // node_modules/.bun/commander@14.0.3/node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -186622,6 +186842,7 @@ import * as os12 from "os";
 import * as fs21 from "fs";
 import * as path24 from "path";
 import { Database as Database5 } from "bun:sqlite";
+init_config_context();
 var BUILTIN_AGENT_NAMES2 = BuiltinAgentNameSchema.options.map((v) => v);
 var AGENT_DISPLAY_NAMES2 = {
   morpheus: "Morpheus",
@@ -186734,7 +186955,7 @@ function readPackageVersion2() {
   return "0.0.0";
 }
 function createDataProvider(config5) {
-  const matrixosHome = config5?.matrixosHome ?? ".matrixos";
+  const matrixosHome = config5?.matrixosHome ?? getConfigDir();
   const version3 = readPackageVersion2();
   function readJsonl(filePath) {
     try {
@@ -188223,6 +188444,23 @@ Examples:
   process.stdout.write(result.stdout);
   process.exit(result.exitCode);
 });
+program2.command("service").description("Install MaTrixOS as a persistent OS service (dashboard + gateway)").argument("<action>", "install | uninstall").option("--no-dashboard", "Skip dashboard service").option("--no-gateway", "Skip gateway service").option("--user", "Install as current user (systemd --user / launchd user agent)").action(async (action, options) => {
+  if (action !== "install" && action !== "uninstall") {
+    console.error(`[service] unknown action: ${action}. Use 'install' or 'uninstall'.`);
+    process.exit(1);
+  }
+  if (action === "uninstall") {
+    console.log("[service] uninstall not yet implemented \u2014 remove units manually (systemctl disable / launchctl unload).");
+    process.exit(0);
+  }
+  const { serviceInstallCommand: serviceInstallCommand2 } = await Promise.resolve().then(() => (init_service(), exports_service));
+  const exitCode = await serviceInstallCommand2({
+    dashboard: options.dashboard ?? true,
+    gateway: options.gateway ?? true,
+    user: options.user ?? false
+  });
+  process.exit(exitCode);
+});
 
 // packages/omo-opencode/src/cli/index.ts
 runCli();

package/dist/cli/service.d.ts

@@ -0,0 +1,6 @@
+export interface ServiceInstallOptions {
+    readonly dashboard?: boolean;
+    readonly gateway?: boolean;
+    readonly user?: boolean;
+}
+export declare function serviceInstallCommand(options: ServiceInstallOptions): Promise<number>;

package/dist/cli-node/index.js

@@ -2163,7 +2163,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.3.25",
+    version: "0.3.27",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -167108,6 +167108,226 @@ function executeRgpdConsentCommand(args) {
   }
 }
 
+// packages/omo-opencode/src/cli/service.ts
+var exports_service = {};
+__export(exports_service, {
+  serviceInstallCommand: () => serviceInstallCommand
+});
+import * as os15 from "os";
+import * as fs24 from "fs";
+import * as path29 from "path";
+import { execSync as execSync3 } from "child_process";
+function resolveMatrixosBin2() {
+  try {
+    const p2 = execSync3("command -v matrixos", { encoding: "utf-8" }).trim();
+    if (p2)
+      return p2;
+  } catch {}
+  for (const cand of ["/usr/local/bin/matrixos", "/usr/bin/matrixos", path29.join(os15.homedir(), ".bun/bin/matrixos")]) {
+    if (fs24.existsSync(cand))
+      return cand;
+  }
+  return "matrixos";
+}
+function resolveBunBin() {
+  try {
+    const p2 = execSync3("command -v bun", { encoding: "utf-8" }).trim();
+    if (p2)
+      return p2;
+  } catch {}
+  return "/usr/bin/bun";
+}
+function writeFileEnsureDir(filePath, content) {
+  fs24.mkdirSync(path29.dirname(filePath), { recursive: true });
+  fs24.writeFileSync(filePath, content, "utf-8");
+  console.log(`[service] written: ${filePath}`);
+}
+function installSystemd(opts) {
+  const bin = resolveMatrixosBin2();
+  const bun = resolveBunBin();
+  const scope = opts.user ? "--user" : "";
+  const unitDir = opts.user ? path29.join(os15.homedir(), ".config", "systemd", "user") : "/etc/systemd/system";
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  if (opts.dashboard !== false) {
+    const unit = `[Unit]
+Description=MaTrixOS Dashboard
+After=network.target
+
+[Service]
+Type=simple
+User=${os15.userInfo().username}
+WorkingDirectory=${os15.homedir()}
+Environment=PATH=${envPath}
+Environment=HOME=${os15.homedir()}
+ExecStart=${bin} dashboard --host 0.0.0.0 --daemon
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=${opts.user ? "default.target" : "multi-user.target"}
+`;
+    writeFileEnsureDir(path29.join(unitDir, "matrixos-dashboard.service"), unit);
+  }
+  if (opts.gateway !== false) {
+    const unit = `[Unit]
+Description=MaTrixOS Telegram Gateway
+After=network.target
+
+[Service]
+Type=simple
+User=${os15.userInfo().username}
+WorkingDirectory=${os15.homedir()}
+Environment=PATH=${envPath}
+Environment=HOME=${os15.homedir()}
+ExecStart=${bin} gateway start --command "${bin} run"
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=${opts.user ? "default.target" : "multi-user.target"}
+`;
+    writeFileEnsureDir(path29.join(unitDir, "matrixos-gateway.service"), unit);
+  }
+  console.log("[service] reloading systemd...");
+  if (scope) {
+    execSync3(`${scope} systemctl --user daemon-reload`, { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3(`${scope} systemctl --user enable matrixos-dashboard.service`, { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3(`${scope} systemctl --user enable matrixos-gateway.service`, { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3(`${scope} systemctl --user start matrixos-dashboard.service`, { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3(`${scope} systemctl --user start matrixos-gateway.service`, { stdio: "inherit" });
+  } else {
+    execSync3("systemctl daemon-reload", { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3("systemctl enable matrixos-dashboard.service", { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3("systemctl enable matrixos-gateway.service", { stdio: "inherit" });
+    if (opts.dashboard !== false)
+      execSync3("systemctl start matrixos-dashboard.service", { stdio: "inherit" });
+    if (opts.gateway !== false)
+      execSync3("systemctl start matrixos-gateway.service", { stdio: "inherit" });
+  }
+  console.log("[service] systemd units installed and started.");
+}
+function installLaunchd(opts) {
+  const bin = resolveMatrixosBin2();
+  const bun = resolveBunBin();
+  const launchDir = path29.join(os15.homedir(), "Library", "LaunchAgents");
+  const envPath = `/usr/local/bin:/usr/bin:/bin:${path29.dirname(bun)}`;
+  if (opts.dashboard !== false) {
+    const label = "com.klc.matrixos.dashboard";
+    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>
+  <key>Label</key>
+  <string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bin}</string>
+    <string>dashboard</string>
+    <string>--host</string>
+    <string>0.0.0.0</string>
+    <string>--daemon</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${os15.homedir()}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${envPath}</string>
+    <key>HOME</key>
+    <string>${os15.homedir()}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-dashboard.log</string>
+  <key>StandardErrorPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-dashboard.log</string>
+</dict>
+</plist>
+`;
+    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
+    execSync3(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+  }
+  if (opts.gateway !== false) {
+    const label = "com.klc.matrixos.gateway";
+    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>
+  <key>Label</key>
+  <string>${label}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bin}</string>
+    <string>gateway</string>
+    <string>start</string>
+    <string>--command</string>
+    <string>${bin} run</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${os15.homedir()}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${envPath}</string>
+    <key>HOME</key>
+    <string>${os15.homedir()}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-gateway.log</string>
+  <key>StandardErrorPath</key>
+  <string>${os15.homedir()}/Library/Logs/matrixos-gateway.log</string>
+</dict>
+</plist>
+`;
+    writeFileEnsureDir(path29.join(launchDir, `${label}.plist`), plist);
+    execSync3(`launchctl load ${path29.join(launchDir, `${label}.plist`)}`, { stdio: "inherit" });
+  }
+  console.log("[service] launchd agents installed and loaded.");
+}
+function installWindowsNote() {
+  console.log("[service] Windows: no auto-service installer yet.");
+  console.log("  Use Task Scheduler to run `matrixos dashboard --host 0.0.0.0 --daemon`");
+  console.log('  and `matrixos gateway start --command "matrixos run"` at logon.');
+  console.log("  Or run them in the background via a startup script.");
+}
+async function serviceInstallCommand(options) {
+  const platform2 = process.platform;
+  console.log(`[service] detected platform: ${platform2}`);
+  if (platform2 === "linux") {
+    if (!fs24.existsSync("/run/systemd/system") && !fs24.existsSync("/etc/systemd/system")) {
+      console.error("[service] systemd not detected \u2014 cannot install service automatically.");
+      console.error("  Start manually: matrixos dashboard --host 0.0.0.0 --daemon");
+      return 1;
+    }
+    installSystemd(options);
+    return 0;
+  }
+  if (platform2 === "darwin") {
+    installLaunchd(options);
+    return 0;
+  }
+  if (platform2 === "win32") {
+    installWindowsNote();
+    return 0;
+  }
+  console.error(`[service] unsupported platform: ${platform2}`);
+  return 1;
+}
+var init_service = () => {};
+
 // node_modules/.bun/commander@14.0.3/node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
@@ -186677,6 +186897,7 @@ import * as os12 from "os";
 import * as fs21 from "fs";
 import * as path24 from "path";
 import { Database as Database5 } from "bun:sqlite";
+init_config_context();
 var BUILTIN_AGENT_NAMES2 = BuiltinAgentNameSchema.options.map((v) => v);
 var AGENT_DISPLAY_NAMES2 = {
   morpheus: "Morpheus",
@@ -186789,7 +187010,7 @@ function readPackageVersion2() {
   return "0.0.0";
 }
 function createDataProvider(config5) {
-  const matrixosHome = config5?.matrixosHome ?? ".matrixos";
+  const matrixosHome = config5?.matrixosHome ?? getConfigDir();
   const version3 = readPackageVersion2();
   function readJsonl(filePath) {
     try {
@@ -188278,6 +188499,23 @@ Examples:
   process.stdout.write(result.stdout);
   process.exit(result.exitCode);
 });
+program2.command("service").description("Install MaTrixOS as a persistent OS service (dashboard + gateway)").argument("<action>", "install | uninstall").option("--no-dashboard", "Skip dashboard service").option("--no-gateway", "Skip gateway service").option("--user", "Install as current user (systemd --user / launchd user agent)").action(async (action, options) => {
+  if (action !== "install" && action !== "uninstall") {
+    console.error(`[service] unknown action: ${action}. Use 'install' or 'uninstall'.`);
+    process.exit(1);
+  }
+  if (action === "uninstall") {
+    console.log("[service] uninstall not yet implemented \u2014 remove units manually (systemctl disable / launchctl unload).");
+    process.exit(0);
+  }
+  const { serviceInstallCommand: serviceInstallCommand2 } = await Promise.resolve().then(() => (init_service(), exports_service));
+  const exitCode = await serviceInstallCommand2({
+    dashboard: options.dashboard ?? true,
+    gateway: options.gateway ?? true,
+    user: options.user ?? false
+  });
+  process.exit(exitCode);
+});
 
 // packages/omo-opencode/src/cli/index.ts
 runCli();

package/dist/index.js

@@ -368019,7 +368019,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.3.25",
+  version: "0.3.27",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kl-c/matrixos",
-  "version": "0.3.25",
+  "version": "0.3.27",
   "description": "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",