@farazirfan/costar-server-executor 1.0.0

package/dist/cli/env-loader.js

@@ -0,0 +1,104 @@
+/**
+ * CoStar Server Executor - Environment Loader
+ *
+ * Loads environment variables with this precedence:
+ * 1. Process environment (highest priority)
+ * 2. .env in current working directory
+ * 3. Global .env at ~/.costar/.env (lowest priority)
+ */
+import { config as dotenvConfig } from "dotenv";
+import fs from "node:fs";
+import { resolveGlobalEnvPath } from "./paths.js";
+/**
+ * Load .env from CWD first, then from ~/.costar/.env as fallback.
+ * Neither overrides existing process.env values.
+ */
+export function loadGlobalEnv() {
+    // Load from CWD (dotenv default behavior)
+    dotenvConfig();
+    // Load global fallback: ~/.costar/.env
+    const globalEnvPath = resolveGlobalEnvPath();
+    if (fs.existsSync(globalEnvPath)) {
+        dotenvConfig({ path: globalEnvPath, override: false });
+    }
+}
+/**
+ * Write environment variables to the global .env file at ~/.costar/.env.
+ * Merges with existing values (new values override existing ones).
+ */
+export function writeGlobalEnv(vars) {
+    const envPath = resolveGlobalEnvPath();
+    const existing = readGlobalEnv();
+    // Merge: new values override existing
+    const merged = { ...existing, ...vars };
+    // Build .env content
+    const lines = [
+        "# CoStar Server Executor Configuration",
+        "# Generated by 'costar setup'",
+        `# Last updated: ${new Date().toISOString()}`,
+        "",
+    ];
+    // Group by category
+    const groups = {
+        "# === Required ===": ["USER_ID", "SUPABASE_URL", "SUPABASE_SERVICE_KEY", "ANTHROPIC_API_KEY"],
+        "# === Optional API Keys ===": ["OPENAI_API_KEY", "BRAVE_SEARCH_API_KEY", "GEMINI_API_KEY"],
+        "# === Agent Settings ===": [
+            "AGENT_MODEL", "ANTHROPIC_MODEL", "MAX_TOKENS", "TEMPERATURE",
+            "MAX_TURNS", "MODEL_FALLBACKS",
+        ],
+        "# === Workspace & Paths ===": ["WORKSPACE_DIR", "COSTAR_STATE_DIR"],
+        "# === Heartbeat ===": [
+            "ENABLE_HEARTBEAT", "HEARTBEAT_INTERVAL",
+            "HEARTBEAT_QUIET_HOURS_START", "HEARTBEAT_QUIET_HOURS_END",
+        ],
+        "# === Other ===": [],
+    };
+    const categorized = new Set(Object.values(groups).flat());
+    for (const [header, keys] of Object.entries(groups)) {
+        const sectionVars = keys.filter((k) => merged[k] !== undefined);
+        if (header === "# === Other ===" || sectionVars.length > 0) {
+            lines.push(header);
+            for (const key of sectionVars) {
+                lines.push(`${key}=${merged[key]}`);
+            }
+            // Add uncategorized vars to "Other"
+            if (header === "# === Other ===") {
+                for (const [key, value] of Object.entries(merged)) {
+                    if (!categorized.has(key)) {
+                        lines.push(`${key}=${value}`);
+                    }
+                }
+            }
+            lines.push("");
+        }
+    }
+    fs.writeFileSync(envPath, lines.join("\n"), "utf-8");
+}
+/**
+ * Read existing global .env file into a key-value map
+ */
+export function readGlobalEnv() {
+    const envPath = resolveGlobalEnvPath();
+    if (!fs.existsSync(envPath))
+        return {};
+    const content = fs.readFileSync(envPath, "utf-8");
+    const vars = {};
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        let value = trimmed.slice(eqIdx + 1).trim();
+        // Remove surrounding quotes if present
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        vars[key] = value;
+    }
+    return vars;
+}
+//# sourceMappingURL=env-loader.js.map

package/dist/cli/env-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.js","sourceRoot":"","sources":["../../src/cli/env-loader.ts"],"names":[],"mappings":"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"}

package/dist/cli/paths.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CoStar Server Executor - Path Resolution
+ * Follows OpenClaw's pattern: ~/.costar/ for all persistent state
+ */
+/** Base config/state directory: ~/.costar/ (or COSTAR_STATE_DIR) */
+export declare function resolveCoStarDir(): string;
+/** Global .env file: ~/.costar/.env */
+export declare function resolveGlobalEnvPath(): string;
+/** Default workspace directory: ~/.costar/workspace/ */
+export declare function resolveDefaultWorkspaceDir(): string;
+/** Logs directory: ~/.costar/logs/ */
+export declare function resolveLogsDir(): string;
+/** Sessions directory: ~/.costar/sessions/ */
+export declare function resolveSessionsDir(): string;
+/** PID file for the running server process */
+export declare function resolvePidFile(): string;
+/** Lock file to prevent multiple instances */
+export declare function resolveLockFile(): string;
+/** Service label for launchd/systemd */
+export declare const SERVICE_LABEL = "ai.costar.server-executor";
+export declare const SERVICE_DESCRIPTION = "CoStar Server Executor - 24/7 Autonomous AI Agent";
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,oEAAoE;AACpE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wDAAwD;AACxD,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,sCAAsC;AACtC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wCAAwC;AACxC,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,eAAO,MAAM,mBAAmB,sDAAsD,CAAC"}

package/dist/cli/paths.js

@@ -0,0 +1,38 @@
+/**
+ * CoStar Server Executor - Path Resolution
+ * Follows OpenClaw's pattern: ~/.costar/ for all persistent state
+ */
+import path from "node:path";
+import os from "node:os";
+/** Base config/state directory: ~/.costar/ (or COSTAR_STATE_DIR) */
+export function resolveCoStarDir() {
+    return process.env.COSTAR_STATE_DIR || path.join(os.homedir(), ".costar");
+}
+/** Global .env file: ~/.costar/.env */
+export function resolveGlobalEnvPath() {
+    return path.join(resolveCoStarDir(), ".env");
+}
+/** Default workspace directory: ~/.costar/workspace/ */
+export function resolveDefaultWorkspaceDir() {
+    return path.join(resolveCoStarDir(), "workspace");
+}
+/** Logs directory: ~/.costar/logs/ */
+export function resolveLogsDir() {
+    return path.join(resolveCoStarDir(), "logs");
+}
+/** Sessions directory: ~/.costar/sessions/ */
+export function resolveSessionsDir() {
+    return path.join(resolveCoStarDir(), "sessions");
+}
+/** PID file for the running server process */
+export function resolvePidFile() {
+    return path.join(resolveCoStarDir(), "costar.pid");
+}
+/** Lock file to prevent multiple instances */
+export function resolveLockFile() {
+    return path.join(resolveCoStarDir(), "costar.lock");
+}
+/** Service label for launchd/systemd */
+export const SERVICE_LABEL = "ai.costar.server-executor";
+export const SERVICE_DESCRIPTION = "CoStar Server Executor - 24/7 Autonomous AI Agent";
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,oEAAoE;AACpE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC5E,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mDAAmD,CAAC"}

package/dist/cli/service.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CoStar Server Executor - Service Management
+ *
+ * Installs/manages the server executor as a system service:
+ * - macOS: LaunchAgent (~/Library/LaunchAgents/)
+ * - Linux: systemd user service (~/.config/systemd/user/)
+ *
+ * Pattern follows OpenClaw's daemon/service.ts
+ */
+export declare function serviceCommand(action: "install" | "uninstall" | "restart" | "logs" | "status" | "stop"): Promise<void>;
+//# sourceMappingURL=service.d.ts.map

package/dist/cli/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/cli/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0cH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GACvE,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/dist/cli/service.js

@@ -0,0 +1,481 @@
+/**
+ * CoStar Server Executor - Service Management
+ *
+ * Installs/manages the server executor as a system service:
+ * - macOS: LaunchAgent (~/Library/LaunchAgents/)
+ * - Linux: systemd user service (~/.config/systemd/user/)
+ *
+ * Pattern follows OpenClaw's daemon/service.ts
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync, spawnSync } from "node:child_process";
+import { resolveCoStarDir, resolveLogsDir, resolvePidFile, SERVICE_LABEL, SERVICE_DESCRIPTION, } from "./paths.js";
+import { readGlobalEnv } from "./env-loader.js";
+// ─── Platform Detection ────────────────────────────────────────
+function getPlatform() {
+    if (process.platform === "darwin")
+        return "darwin";
+    if (process.platform === "linux")
+        return "linux";
+    return "unsupported";
+}
+// ─── Common Helpers ────────────────────────────────────────────
+function findNodeBinary() {
+    // Prefer the node that's currently running
+    return process.execPath;
+}
+function findCoStarBinary() {
+    // Find our own entry point
+    // When installed globally: look in node_modules/.bin
+    // When running from source: use dist/cli.js
+    const possiblePaths = [
+        // Global npm install location
+        path.join(path.dirname(process.execPath), "costar"),
+        // Our dist output
+        path.resolve("dist/cli.js"),
+        // Source with tsx
+        path.resolve("src/cli.ts"),
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    // Fallback: assume it's on PATH
+    return "costar";
+}
+function getEnvironmentForService() {
+    const env = {};
+    const globalEnv = readGlobalEnv();
+    // Merge global env with process env (process env takes precedence)
+    for (const [key, value] of Object.entries(globalEnv)) {
+        env[key] = value;
+    }
+    // Ensure PATH includes common locations
+    const pathDirs = [
+        path.dirname(process.execPath),
+        "/usr/local/bin",
+        "/usr/bin",
+        "/bin",
+        `${os.homedir()}/.nvm/versions/node/${process.version}/bin`,
+        `${os.homedir()}/.local/bin`,
+    ];
+    env.PATH = pathDirs.join(":");
+    // Ensure HOME is set
+    env.HOME = os.homedir();
+    return env;
+}
+// ─── macOS LaunchAgent ─────────────────────────────────────────
+function getLaunchAgentDir() {
+    return path.join(os.homedir(), "Library", "LaunchAgents");
+}
+function getLaunchAgentPath() {
+    return path.join(getLaunchAgentDir(), `${SERVICE_LABEL}.plist`);
+}
+function buildPlist() {
+    const node = findNodeBinary();
+    const costarBin = findCoStarBinary();
+    const logsDir = resolveLogsDir();
+    const env = getEnvironmentForService();
+    fs.mkdirSync(logsDir, { recursive: true });
+    // Build the program arguments
+    // If costar is a .js file, we need node to run it
+    let programArgs;
+    if (costarBin.endsWith(".js") || costarBin.endsWith(".ts")) {
+        programArgs = [node, costarBin, "start"];
+    }
+    else {
+        programArgs = [costarBin, "start"];
+    }
+    const envEntries = Object.entries(env)
+        .map(([key, value]) => `      <key>${escapeXml(key)}</key>\n      <string>${escapeXml(value)}</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>${SERVICE_LABEL}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+${programArgs.map((a) => `        <string>${escapeXml(a)}</string>`).join("\n")}
+    </array>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+${envEntries}
+    </dict>
+
+    <key>WorkingDirectory</key>
+    <string>${escapeXml(resolveCoStarDir())}</string>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>StandardOutPath</key>
+    <string>${escapeXml(path.join(logsDir, "costar-stdout.log"))}</string>
+
+    <key>StandardErrorPath</key>
+    <string>${escapeXml(path.join(logsDir, "costar-stderr.log"))}</string>
+
+    <key>ProcessType</key>
+    <string>Background</string>
+
+    <key>ThrottleInterval</key>
+    <integer>5</integer>
+</dict>
+</plist>`;
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+async function installLaunchAgent() {
+    const plistPath = getLaunchAgentPath();
+    const dir = getLaunchAgentDir();
+    // Create LaunchAgents directory if needed
+    fs.mkdirSync(dir, { recursive: true });
+    // Unload existing service if present
+    if (fs.existsSync(plistPath)) {
+        try {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: "pipe" });
+        }
+        catch {
+            // May not be loaded, that's fine
+        }
+    }
+    // Write plist
+    const plist = buildPlist();
+    fs.writeFileSync(plistPath, plist, "utf-8");
+    console.log(`  Wrote LaunchAgent: ${plistPath}`);
+    // Load the service
+    execSync(`launchctl load "${plistPath}"`, { stdio: "pipe" });
+    console.log("  Service loaded and started");
+}
+async function uninstallLaunchAgent() {
+    const plistPath = getLaunchAgentPath();
+    if (!fs.existsSync(plistPath)) {
+        console.log("  LaunchAgent not installed");
+        return;
+    }
+    try {
+        execSync(`launchctl unload "${plistPath}"`, { stdio: "pipe" });
+    }
+    catch {
+        // May already be unloaded
+    }
+    fs.unlinkSync(plistPath);
+    console.log("  LaunchAgent removed");
+}
+async function restartLaunchAgent() {
+    const plistPath = getLaunchAgentPath();
+    if (!fs.existsSync(plistPath)) {
+        console.log("  LaunchAgent not installed. Run 'costar service install' first.");
+        return;
+    }
+    try {
+        execSync(`launchctl unload "${plistPath}"`, { stdio: "pipe" });
+    }
+    catch {
+        // ignore
+    }
+    execSync(`launchctl load "${plistPath}"`, { stdio: "pipe" });
+    console.log("  Service restarted");
+}
+function isLaunchAgentLoaded() {
+    const result = spawnSync("launchctl", ["list", SERVICE_LABEL], {
+        stdio: "pipe",
+        encoding: "utf-8",
+    });
+    return result.status === 0;
+}
+function showLaunchAgentLogs() {
+    const logsDir = resolveLogsDir();
+    const stdoutLog = path.join(logsDir, "costar-stdout.log");
+    const stderrLog = path.join(logsDir, "costar-stderr.log");
+    console.log(`\nLog files:`);
+    console.log(`  stdout: ${stdoutLog}`);
+    console.log(`  stderr: ${stderrLog}`);
+    if (fs.existsSync(stderrLog)) {
+        const content = fs.readFileSync(stderrLog, "utf-8");
+        const lines = content.split("\n").filter(Boolean);
+        const last50 = lines.slice(-50);
+        if (last50.length > 0) {
+            console.log(`\nLast ${last50.length} lines of stderr:`);
+            console.log(last50.join("\n"));
+        }
+    }
+    if (fs.existsSync(stdoutLog)) {
+        const content = fs.readFileSync(stdoutLog, "utf-8");
+        const lines = content.split("\n").filter(Boolean);
+        const last50 = lines.slice(-50);
+        if (last50.length > 0) {
+            console.log(`\nLast ${last50.length} lines of stdout:`);
+            console.log(last50.join("\n"));
+        }
+    }
+}
+// ─── Linux systemd ─────────────────────────────────────────────
+function getSystemdDir() {
+    return path.join(os.homedir(), ".config", "systemd", "user");
+}
+function getSystemdServicePath() {
+    return path.join(getSystemdDir(), `${SERVICE_LABEL}.service`);
+}
+function buildSystemdUnit() {
+    const node = findNodeBinary();
+    const costarBin = findCoStarBinary();
+    const env = getEnvironmentForService();
+    let execStart;
+    if (costarBin.endsWith(".js") || costarBin.endsWith(".ts")) {
+        execStart = `${node} ${costarBin} start`;
+    }
+    else {
+        execStart = `${costarBin} start`;
+    }
+    const envLines = Object.entries(env)
+        .map(([key, value]) => `Environment="${key}=${value}"`)
+        .join("\n");
+    return `[Unit]
+Description=${SERVICE_DESCRIPTION}
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=${execStart}
+Restart=always
+RestartSec=5
+KillMode=process
+WorkingDirectory=${resolveCoStarDir()}
+${envLines}
+
+[Install]
+WantedBy=default.target
+`;
+}
+async function installSystemdService() {
+    const servicePath = getSystemdServicePath();
+    const dir = getSystemdDir();
+    fs.mkdirSync(dir, { recursive: true });
+    // Write unit file
+    const unit = buildSystemdUnit();
+    fs.writeFileSync(servicePath, unit, "utf-8");
+    console.log(`  Wrote systemd unit: ${servicePath}`);
+    // Enable linger for headless operation
+    try {
+        execSync(`loginctl enable-linger ${os.userInfo().username}`, { stdio: "pipe" });
+        console.log("  Enabled user linger (for headless operation)");
+    }
+    catch {
+        console.warn("  Warning: Could not enable linger. Service may stop on logout.");
+    }
+    // Reload, enable, and start
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+    execSync(`systemctl --user enable ${SERVICE_LABEL}`, { stdio: "pipe" });
+    execSync(`systemctl --user start ${SERVICE_LABEL}`, { stdio: "pipe" });
+    console.log("  Service enabled and started");
+}
+async function uninstallSystemdService() {
+    const servicePath = getSystemdServicePath();
+    if (!fs.existsSync(servicePath)) {
+        console.log("  Systemd service not installed");
+        return;
+    }
+    try {
+        execSync(`systemctl --user stop ${SERVICE_LABEL}`, { stdio: "pipe" });
+    }
+    catch {
+        // May already be stopped
+    }
+    try {
+        execSync(`systemctl --user disable ${SERVICE_LABEL}`, { stdio: "pipe" });
+    }
+    catch {
+        // ignore
+    }
+    fs.unlinkSync(servicePath);
+    execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+    console.log("  Systemd service removed");
+}
+async function restartSystemdService() {
+    const servicePath = getSystemdServicePath();
+    if (!fs.existsSync(servicePath)) {
+        console.log("  Systemd service not installed. Run 'costar service install' first.");
+        return;
+    }
+    execSync(`systemctl --user restart ${SERVICE_LABEL}`, { stdio: "pipe" });
+    console.log("  Service restarted");
+}
+function isSystemdServiceActive() {
+    const result = spawnSync("systemctl", ["--user", "is-active", SERVICE_LABEL], { stdio: "pipe", encoding: "utf-8" });
+    return result.stdout?.trim() === "active";
+}
+function showSystemdLogs() {
+    try {
+        execSync(`journalctl --user -u ${SERVICE_LABEL} -n 50 --no-pager`, { stdio: "inherit" });
+    }
+    catch {
+        console.error("Failed to read journalctl logs.");
+        // Fallback to log files
+        const logsDir = resolveLogsDir();
+        const logFile = path.join(logsDir, "costar-stdout.log");
+        if (fs.existsSync(logFile)) {
+            const content = fs.readFileSync(logFile, "utf-8");
+            const lines = content.split("\n").slice(-50);
+            console.log(lines.join("\n"));
+        }
+    }
+}
+// ─── Stop via PID file ─────────────────────────────────────────
+async function stopService() {
+    const platform = getPlatform();
+    // Try platform-specific stop first
+    if (platform === "darwin" && isLaunchAgentLoaded()) {
+        const plistPath = getLaunchAgentPath();
+        try {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: "pipe" });
+            console.log("  LaunchAgent stopped");
+        }
+        catch {
+            console.warn("  Warning: Could not stop LaunchAgent");
+        }
+        return;
+    }
+    if (platform === "linux" && isSystemdServiceActive()) {
+        try {
+            execSync(`systemctl --user stop ${SERVICE_LABEL}`, { stdio: "pipe" });
+            console.log("  Systemd service stopped");
+        }
+        catch {
+            console.warn("  Warning: Could not stop systemd service");
+        }
+        return;
+    }
+    // Fallback: kill by PID file
+    const pidFile = resolvePidFile();
+    if (fs.existsSync(pidFile)) {
+        const pid = parseInt(fs.readFileSync(pidFile, "utf-8").trim(), 10);
+        if (!isNaN(pid)) {
+            try {
+                process.kill(pid, "SIGTERM");
+                console.log(`  Sent SIGTERM to process ${pid}`);
+                fs.unlinkSync(pidFile);
+            }
+            catch {
+                console.warn(`  Process ${pid} not running`);
+                fs.unlinkSync(pidFile);
+            }
+        }
+    }
+    else {
+        console.log("  No running service found");
+    }
+}
+// ─── Service Status ────────────────────────────────────────────
+async function showServiceStatus() {
+    const platform = getPlatform();
+    if (platform === "darwin") {
+        const installed = fs.existsSync(getLaunchAgentPath());
+        const loaded = installed && isLaunchAgentLoaded();
+        console.log(`  Platform:  macOS (LaunchAgent)`);
+        console.log(`  Installed: ${installed ? "yes" : "no"}`);
+        console.log(`  Running:   ${loaded ? "yes" : "no"}`);
+        console.log(`  Plist:     ${getLaunchAgentPath()}`);
+    }
+    else if (platform === "linux") {
+        const installed = fs.existsSync(getSystemdServicePath());
+        const active = installed && isSystemdServiceActive();
+        console.log(`  Platform:  Linux (systemd user service)`);
+        console.log(`  Installed: ${installed ? "yes" : "no"}`);
+        console.log(`  Running:   ${active ? "yes" : "no"}`);
+        console.log(`  Unit:      ${getSystemdServicePath()}`);
+    }
+    else {
+        console.log(`  Platform:  ${process.platform} (unsupported for service management)`);
+    }
+}
+// ─── Public API ────────────────────────────────────────────────
+export async function serviceCommand(action) {
+    const platform = getPlatform();
+    console.log(`\nCoStar Service Manager\n`);
+    switch (action) {
+        case "install": {
+            if (platform === "unsupported") {
+                console.error("Service installation not supported on this platform.");
+                console.log("Supported: macOS (LaunchAgent), Linux (systemd)");
+                process.exit(1);
+            }
+            console.log(`Installing CoStar as a system service...`);
+            if (platform === "darwin") {
+                await installLaunchAgent();
+            }
+            else {
+                await installSystemdService();
+            }
+            console.log("\n  Service installed and started.");
+            console.log("  The agent will run 24/7 and auto-restart on boot.");
+            console.log("  View logs: costar service logs");
+            break;
+        }
+        case "uninstall": {
+            if (platform === "unsupported") {
+                console.error("Service management not supported on this platform.");
+                process.exit(1);
+            }
+            console.log("Removing CoStar system service...");
+            if (platform === "darwin") {
+                await uninstallLaunchAgent();
+            }
+            else {
+                await uninstallSystemdService();
+            }
+            break;
+        }
+        case "restart": {
+            if (platform === "unsupported") {
+                console.error("Service management not supported on this platform.");
+                process.exit(1);
+            }
+            console.log("Restarting CoStar service...");
+            if (platform === "darwin") {
+                await restartLaunchAgent();
+            }
+            else {
+                await restartSystemdService();
+            }
+            break;
+        }
+        case "stop": {
+            console.log("Stopping CoStar service...");
+            await stopService();
+            break;
+        }
+        case "logs": {
+            if (platform === "darwin") {
+                showLaunchAgentLogs();
+            }
+            else if (platform === "linux") {
+                showSystemdLogs();
+            }
+            else {
+                const logsDir = resolveLogsDir();
+                console.log(`Log directory: ${logsDir}`);
+            }
+            break;
+        }
+        case "status": {
+            await showServiceStatus();
+            break;
+        }
+    }
+}
+//# sourceMappingURL=service.js.map