@elizaos/daemon 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# @elizaos/daemon
+
+Cross-platform daemon/service management for Eliza agents.
+
+Provides a unified API for managing background services across platforms:
+- **macOS**: LaunchAgents (launchd)
+- **Linux**: systemd user services  
+- **Windows**: Scheduled Tasks (schtasks)
+
+## Installation
+
+```bash
+npm install @elizaos/daemon
+```
+
+## Quick Start
+
+```typescript
+import { installAgentService, isServiceRunning, stopService } from "@elizaos/daemon";
+
+// Install an Eliza agent as a background service
+await installAgentService({
+  name: "my-eliza-agent",
+  description: "My Eliza Agent",
+  entryPoint: "/path/to/agent/index.js",
+  workingDirectory: "/path/to/agent",
+});
+
+// Check if running
+const running = await isServiceRunning("my-eliza-agent");
+console.log(`Agent running: ${running}`);
+
+// Stop the service
+await stopService("my-eliza-agent");
+```
+
+## API
+
+### Service Management
+
+```typescript
+// Install a service
+installService(config: ServiceConfig): Promise<ServiceResult>
+
+// Uninstall a service
+uninstallService(name: string): Promise<ServiceResult>
+
+// Start/stop/restart
+startService(name: string): Promise<ServiceResult>
+stopService(name: string): Promise<ServiceResult>
+restartService(name: string): Promise<ServiceResult>
+
+// Check status
+isServiceInstalled(name: string): Promise<boolean>
+isServiceRunning(name: string): Promise<boolean>
+getServiceRuntime(name: string): Promise<ServiceRuntime>
+```
+
+### Service Configuration
+
+```typescript
+interface ServiceConfig {
+  /** Unique service name/identifier */
+  name: string;
+  /** Human-readable description */
+  description?: string;
+  /** Command to execute (first element is the executable) */
+  command: string[];
+  /** Working directory for the service */
+  workingDirectory?: string;
+  /** Environment variables */
+  environment?: Record<string, string>;
+  /** Auto-restart on failure (default: true) */
+  restartOnFailure?: boolean;
+  /** Restart delay in seconds (default: 5) */
+  restartDelay?: number;
+  /** Keep alive - restart if process exits (default: true) */
+  keepAlive?: boolean;
+  /** Run at system load/boot (default: true) */
+  runAtLoad?: boolean;
+}
+```
+
+### Platform-Specific Managers
+
+For direct access to platform-specific functionality:
+
+```typescript
+import { launchdManager, systemdManager, schtasksManager } from "@elizaos/daemon";
+
+// Use macOS-specific features
+if (process.platform === "darwin") {
+  const runtime = await launchdManager.getRuntime("my-service");
+  console.log("Plist path:", runtime.platformInfo?.plistPath);
+}
+```
+
+## Platform Details
+
+### macOS (launchd)
+
+Services are installed as user LaunchAgents in `~/Library/LaunchAgents/`.
+Logs are written to `~/Library/Logs/{service-name}/`.
+
+### Linux (systemd)
+
+Services are installed as user units in `~/.config/systemd/user/`.
+User lingering is automatically enabled to allow services to run without login.
+
+### Windows (Task Scheduler)
+
+Services are registered as scheduled tasks that run at user logon.
+Tasks are configured with auto-restart on failure.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @elizaos/daemon - Cross-platform daemon/service management for Eliza agents.
+ *
+ * Provides a unified API for managing background services across platforms:
+ * - macOS: LaunchAgents (launchd)
+ * - Linux: systemd user services
+ * - Windows: Scheduled Tasks (schtasks)
+ *
+ * @example
+ * ```typescript
+ * import { installService, getServiceManager } from "@elizaos/daemon";
+ *
+ * // Install a service
+ * await installService({
+ *   name: "my-eliza-agent",
+ *   description: "My Eliza Agent",
+ *   command: ["node", "/path/to/agent.js"],
+ *   keepAlive: true,
+ *   runAtLoad: true,
+ * });
+ *
+ * // Check status
+ * const manager = getServiceManager();
+ * const runtime = await manager.getRuntime("my-eliza-agent");
+ * console.log(`Running: ${runtime.running}, PID: ${runtime.pid}`);
+ * ```
+ *
+ * @module
+ */
+import type { Platform, ServiceCommand, ServiceConfig, ServiceManager, ServiceResult, ServiceRuntime } from "./types.js";
+export type { Platform, ServiceCommand, ServiceConfig, ServiceManager, ServiceResult, ServiceRuntime, };
+export { launchdManager } from "./launchd.js";
+export { systemdManager } from "./systemd.js";
+export { schtasksManager } from "./schtasks.js";
+/**
+ * Get the current platform.
+ */
+export declare function getPlatform(): Platform;
+/**
+ * Check if the current platform is supported.
+ */
+export declare function isPlatformSupported(): boolean;
+/**
+ * Get the service manager for the current platform.
+ *
+ * @throws Error if the platform is not supported
+ */
+export declare function getServiceManager(): ServiceManager;
+/**
+ * Install a service on the current platform.
+ *
+ * @param config - Service configuration
+ * @returns Result of the installation
+ */
+export declare function installService(config: ServiceConfig): Promise<ServiceResult>;
+/**
+ * Uninstall a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the uninstallation
+ */
+export declare function uninstallService(name: string): Promise<ServiceResult>;
+/**
+ * Start a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the start operation
+ */
+export declare function startService(name: string): Promise<ServiceResult>;
+/**
+ * Stop a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the stop operation
+ */
+export declare function stopService(name: string): Promise<ServiceResult>;
+/**
+ * Restart a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the restart operation
+ */
+export declare function restartService(name: string): Promise<ServiceResult>;
+/**
+ * Check if a service is installed on the current platform.
+ *
+ * @param name - Service name
+ * @returns True if the service is installed
+ */
+export declare function isServiceInstalled(name: string): Promise<boolean>;
+/**
+ * Check if a service is running on the current platform.
+ *
+ * @param name - Service name
+ * @returns True if the service is running
+ */
+export declare function isServiceRunning(name: string): Promise<boolean>;
+/**
+ * Get service command details.
+ *
+ * @param name - Service name
+ * @returns Service command details or null if not found
+ */
+export declare function getServiceCommand(name: string): Promise<ServiceCommand | null>;
+/**
+ * Get service runtime status.
+ *
+ * @param name - Service name
+ * @returns Service runtime status
+ */
+export declare function getServiceRuntime(name: string): Promise<ServiceRuntime>;
+/**
+ * Install an Eliza agent as a service.
+ *
+ * This is a convenience function that sets up sensible defaults for Eliza agents.
+ *
+ * @param options - Agent service options
+ * @returns Result of the installation
+ */
+export declare function installAgentService(options: {
+    /** Agent name (used as service name) */
+    name: string;
+    /** Agent description */
+    description?: string;
+    /** Path to the agent entry point (e.g., index.js) */
+    entryPoint: string;
+    /** Working directory for the agent */
+    workingDirectory?: string;
+    /** Node.js executable path (defaults to current process) */
+    nodeExecutable?: string;
+    /** Additional environment variables */
+    environment?: Record<string, string>;
+}): Promise<ServiceResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typescript/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,GACf,CAAC;AAGF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAalD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGvE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGtE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGzE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGhC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAG7E;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB"}

package/dist/index.js

@@ -0,0 +1,181 @@
+/**
+ * @elizaos/daemon - Cross-platform daemon/service management for Eliza agents.
+ *
+ * Provides a unified API for managing background services across platforms:
+ * - macOS: LaunchAgents (launchd)
+ * - Linux: systemd user services
+ * - Windows: Scheduled Tasks (schtasks)
+ *
+ * @example
+ * ```typescript
+ * import { installService, getServiceManager } from "@elizaos/daemon";
+ *
+ * // Install a service
+ * await installService({
+ *   name: "my-eliza-agent",
+ *   description: "My Eliza Agent",
+ *   command: ["node", "/path/to/agent.js"],
+ *   keepAlive: true,
+ *   runAtLoad: true,
+ * });
+ *
+ * // Check status
+ * const manager = getServiceManager();
+ * const runtime = await manager.getRuntime("my-eliza-agent");
+ * console.log(`Running: ${runtime.running}, PID: ${runtime.pid}`);
+ * ```
+ *
+ * @module
+ */
+import { launchdManager } from "./launchd.js";
+import { schtasksManager } from "./schtasks.js";
+import { systemdManager } from "./systemd.js";
+// Re-export platform-specific managers for direct access
+export { launchdManager } from "./launchd.js";
+export { systemdManager } from "./systemd.js";
+export { schtasksManager } from "./schtasks.js";
+/**
+ * Get the current platform.
+ */
+export function getPlatform() {
+    return process.platform;
+}
+/**
+ * Check if the current platform is supported.
+ */
+export function isPlatformSupported() {
+    const platform = getPlatform();
+    return platform === "darwin" || platform === "linux" || platform === "win32";
+}
+/**
+ * Get the service manager for the current platform.
+ *
+ * @throws Error if the platform is not supported
+ */
+export function getServiceManager() {
+    const platform = getPlatform();
+    switch (platform) {
+        case "darwin":
+            return launchdManager;
+        case "linux":
+            return systemdManager;
+        case "win32":
+            return schtasksManager;
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+}
+/**
+ * Install a service on the current platform.
+ *
+ * @param config - Service configuration
+ * @returns Result of the installation
+ */
+export async function installService(config) {
+    const manager = getServiceManager();
+    return manager.install(config);
+}
+/**
+ * Uninstall a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the uninstallation
+ */
+export async function uninstallService(name) {
+    const manager = getServiceManager();
+    return manager.uninstall(name);
+}
+/**
+ * Start a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the start operation
+ */
+export async function startService(name) {
+    const manager = getServiceManager();
+    return manager.start(name);
+}
+/**
+ * Stop a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the stop operation
+ */
+export async function stopService(name) {
+    const manager = getServiceManager();
+    return manager.stop(name);
+}
+/**
+ * Restart a service on the current platform.
+ *
+ * @param name - Service name
+ * @returns Result of the restart operation
+ */
+export async function restartService(name) {
+    const manager = getServiceManager();
+    return manager.restart(name);
+}
+/**
+ * Check if a service is installed on the current platform.
+ *
+ * @param name - Service name
+ * @returns True if the service is installed
+ */
+export async function isServiceInstalled(name) {
+    const manager = getServiceManager();
+    return manager.isInstalled(name);
+}
+/**
+ * Check if a service is running on the current platform.
+ *
+ * @param name - Service name
+ * @returns True if the service is running
+ */
+export async function isServiceRunning(name) {
+    const manager = getServiceManager();
+    return manager.isRunning(name);
+}
+/**
+ * Get service command details.
+ *
+ * @param name - Service name
+ * @returns Service command details or null if not found
+ */
+export async function getServiceCommand(name) {
+    const manager = getServiceManager();
+    return manager.getCommand(name);
+}
+/**
+ * Get service runtime status.
+ *
+ * @param name - Service name
+ * @returns Service runtime status
+ */
+export async function getServiceRuntime(name) {
+    const manager = getServiceManager();
+    return manager.getRuntime(name);
+}
+/**
+ * Install an Eliza agent as a service.
+ *
+ * This is a convenience function that sets up sensible defaults for Eliza agents.
+ *
+ * @param options - Agent service options
+ * @returns Result of the installation
+ */
+export async function installAgentService(options) {
+    const nodeExe = options.nodeExecutable || process.execPath;
+    const config = {
+        name: options.name,
+        description: options.description || `Eliza Agent: ${options.name}`,
+        command: [nodeExe, options.entryPoint],
+        workingDirectory: options.workingDirectory,
+        environment: options.environment,
+        keepAlive: true,
+        restartOnFailure: true,
+        restartDelay: 5,
+        runAtLoad: true,
+    };
+    return installService(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/launchd.d.ts

@@ -0,0 +1,9 @@
+/**
+ * macOS LaunchAgent service manager.
+ *
+ * Manages services via launchd LaunchAgents for the current user.
+ */
+import type { ServiceManager } from "./types.js";
+/** macOS LaunchAgent service manager */
+export declare const launchdManager: ServiceManager;
+//# sourceMappingURL=launchd.d.ts.map

package/dist/launchd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../typescript/src/launchd.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAGV,cAAc,EAGf,MAAM,YAAY,CAAC;AAgLpB,wCAAwC;AACxC,eAAO,MAAM,cAAc,EAAE,cA2H5B,CAAC"}