@telora/daemon 0.12.33

package/dist/unified-shell.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Unified daemon process shell -- the single entry point for telora-daemon.
+ *
+ * Composes daemon-core's lifecycle primitives (PID locking, signal handling,
+ * config loading) with one or more ExecutionEngine adapters (StrategyEngine,
+ * FactoryEngine). The CLI in index.ts creates engine instances based on the
+ * unified config and passes them here.
+ *
+ * Lifecycle sequence:
+ *   1. Load unified config via loadUnifiedConfig()
+ *   2. Apply engine filter (--engine flag) if provided
+ *   3. Acquire PID lock at .telora/daemon.pid
+ *   4. Register uncaughtException / unhandledRejection handlers
+ *   5. Set up signal handlers (SIGTERM, SIGINT)
+ *   6. For each enabled engine: build config, create instance, init, recover, start
+ *   7. Register SIGUSR1 (status) and SIGUSR2 (circuit breaker reset) handlers
+ *   8. Keep the process running indefinitely
+ *
+ * On shutdown (SIGTERM/SIGINT):
+ *   1. Stop all engines (stop accepting new work)
+ *   2. Shut down all engines in parallel (graceful cleanup)
+ *   3. Release PID lock
+ *   4. Exit
+ */
+/** Options for the unified daemon. */
+export interface UnifiedDaemonOptions {
+    /** Enable verbose logging (prints full config). */
+    verbose?: boolean;
+    /** Explicit path to config file (default: .telora/daemon.json). */
+    config?: string;
+    /** Print configuration and exit without starting. */
+    dryRun?: boolean;
+    /** Skip crash recovery on startup. */
+    skipRecovery?: boolean;
+    /** Override: only enable this engine (for debugging). */
+    engineFilter?: 'strategy' | 'factory';
+    /** Disable auto-update (--no-auto-update flag). */
+    noAutoUpdate?: boolean;
+}
+/**
+ * Run the unified daemon process shell.
+ *
+ * This function loads configuration, acquires a PID lock, creates and
+ * initializes execution engines, runs crash recovery, starts the engines,
+ * and keeps the process running until a shutdown signal is received.
+ *
+ * @param opts  CLI options (verbose, config path, dry-run, skip-recovery, engine filter).
+ */
+export declare function runUnifiedDaemon(opts: UnifiedDaemonOptions): Promise<void>;
+//# sourceMappingURL=unified-shell.d.ts.map

package/dist/unified-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-shell.d.ts","sourceRoot":"","sources":["../src/unified-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA8BH,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA8ZD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8VhF"}