pulseed 0.3.0 → 0.4.1

package/dist/runtime/daemon/runner.d.ts

@@ -0,0 +1,229 @@
+import { CoreLoop } from "../../orchestrator/loop/core-loop.js";
+import { DriveSystem } from "../../platform/drive/drive-system.js";
+import { StateManager } from "../../base/state/state-manager.js";
+import { PIDManager } from "../pid-manager.js";
+import { Logger } from "../logger.js";
+import { EventServer } from "../event/server.js";
+import type { DaemonConfig } from "../../base/types/daemon.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import { CronScheduler } from "../cron-scheduler.js";
+import { ScheduleEngine } from "../schedule/engine.js";
+import { IngressGateway } from "../gateway/index.js";
+import { LoopSupervisor } from "../executor/index.js";
+import type { ShutdownMarker } from "./index.js";
+export { generateCronEntry } from "./signals.js";
+export { rotateDaemonLog, calculateAdaptiveInterval } from "./health.js";
+export type { ShutdownMarker } from "./index.js";
+export interface DaemonDeps {
+    coreLoop: CoreLoop;
+    driveSystem: DriveSystem;
+    stateManager: StateManager;
+    pidManager: PIDManager;
+    logger: Logger;
+    reportingEngine?: {
+        generateNotification(type: "approval_required", context: {
+            goalId: string;
+            message: string;
+            details?: string;
+        }): Promise<unknown>;
+    };
+    config?: Partial<DaemonConfig>;
+    eventServer?: EventServer;
+    llmClient?: ILLMClient;
+    cronScheduler?: CronScheduler;
+    scheduleEngine?: ScheduleEngine;
+    gateway?: IngressGateway;
+    supervisor?: LoopSupervisor;
+    /** Factory to create fresh CoreLoop instances for LoopSupervisor workers. */
+    coreLoopFactory?: () => CoreLoop;
+}
+export declare class DaemonRunner {
+    private coreLoop;
+    private driveSystem;
+    private stateManager;
+    private pidManager;
+    private logger;
+    private config;
+    private running;
+    private shuttingDown;
+    private state;
+    private baseDir;
+    private logDir;
+    private logPath;
+    private eventServer;
+    private approvalFn;
+    private sleepAbortController;
+    private currentGoalIds;
+    private currentLoopIndex;
+    private lastProactiveTickAt;
+    private llmClient;
+    private reportingEngine;
+    private cronScheduler;
+    private scheduleEngine;
+    private consecutiveIdleCycles;
+    private gateway;
+    private supervisor;
+    private cronScheduleInterval;
+    private shutdownResolve;
+    private shutdownCoordinator;
+    private stopStatusHeartbeat;
+    private readonly deps;
+    private runtimeRoot;
+    private approvalStore;
+    private outboxStore;
+    private runtimeHealthStore;
+    private leaderLockManager;
+    private goalLeaseManager;
+    private journalQueue;
+    private queueClaimSweeper;
+    private approvalBroker;
+    private commandDispatcher;
+    private eventDispatcher;
+    private runtimeOwnership;
+    constructor(deps: DaemonDeps);
+    private resolveRuntimeRoot;
+    /**
+     * Start daemon loop for given goals.
+     * Throws if daemon is already running.
+     */
+    start(goalIds: string[]): Promise<void>;
+    private initializeRuntimeFoundation;
+    private saveRuntimeHealthSnapshot;
+    private acquireRuntimeLeadership;
+    private failRuntimeLeadership;
+    private releaseStartupOwnership;
+    /** Expose approvalFn for callers (e.g. cmdStart) to wire into TaskLifecycle */
+    getApprovalFn(): ((task: Record<string, unknown>) => Promise<boolean>) | undefined;
+    /**
+     * Abort the current sleep cycle immediately.
+     */
+    abortSleep(): void;
+    /**
+     * Signal daemon to stop after current iteration completes.
+     * Saves interrupted_goals so they can be restored on next start.
+     */
+    stop(): void;
+    /**
+     * Main daemon loop. Runs until this.running is false or a critical error occurs.
+     */
+    private runLoop;
+    /**
+     * Determine which goals should be activated this cycle.
+     * Uses DriveSystem.shouldActivate() for each goal, then sorts by priority.
+     */
+    private determineActiveGoals;
+    private collectGoalCycleSnapshot;
+    /**
+     * Calculate the next check interval in milliseconds.
+     * Uses per-goal override from config.goal_intervals if configured,
+     * otherwise falls back to config.check_interval_ms.
+     * Returns the minimum interval across all goals (so the daemon checks
+     * as soon as the earliest goal is due).
+     */
+    private getNextInterval;
+    /**
+     * Handle a non-critical loop error for a single goal.
+     * Increments crash_count and stops daemon if max_retries exceeded.
+     */
+    private handleLoopError;
+    /**
+     * Handle a critical daemon-level error (outer loop catch).
+     * Marks state as crashed and stops the loop.
+     */
+    private handleCriticalError;
+    /**
+     * Save daemon state to {baseDir}/daemon-state.json atomically.
+     */
+    private saveDaemonState;
+    /**
+     * Restore state from a previous interrupted run.
+     * Merges interrupted_goals from daemon-state.json with the given goalIds (deduped).
+     * Returns the merged goal ID array.
+     */
+    private restoreState;
+    /**
+     * Perform cleanup after the loop exits and write the final runtime health snapshot.
+     * Also writes "clean_shutdown" marker to enable crash-vs-clean detection on next startup.
+     */
+    private cleanup;
+    private beginGracefulShutdown;
+    /**
+     * Process due cron-scheduled tasks.
+     * Logs each task, executes based on type, and marks as fired.
+     */
+    private processCronTasks;
+    /**
+     * Process due schedule engine entries.
+     */
+    private processScheduleEntries;
+    /**
+     * Expire old non-permanent cron tasks.
+     */
+    private expireCronTasks;
+    /**
+     * Sleep for the given number of milliseconds.
+     * Can be aborted early via sleepAbortController (e.g. when an event arrives).
+     */
+    private sleep;
+    /**
+     * Called when a file-watcher event arrives from DriveSystem.
+     * Aborts the current sleep so the loop runs immediately.
+     */
+    private onEventReceived;
+    private acceptRuntimeEnvelope;
+    private handleInboundEnvelope;
+    private handleGoalStartCommand;
+    private handleGoalStopCommand;
+    private handleGoalCompletion;
+    private runSupervisorMaintenanceCycle;
+    private handleChatMessageCommand;
+    private handleApprovalResponseCommand;
+    private handleCronTaskDue;
+    /**
+     * Ask the LLM for a proactive action when no goals were activated this cycle.
+     * Fires only if proactive_mode is enabled and enough time has passed since last tick.
+     * Errors are caught and logged — they never affect the daemon loop.
+     */
+    private proactiveTick;
+    /**
+     * Get the highest gap score across all active goals.
+     * Falls back to 0 if no gap data is available.
+     */
+    private getMaxGapScore;
+    /**
+     * Thin wrapper delegating to the standalone calculateAdaptiveInterval function.
+     * Passes this.config.adaptive_sleep as the config parameter.
+     * Kept as a class method so tests can call daemon.calculateAdaptiveInterval(...).
+     */
+    calculateAdaptiveInterval(baseInterval: number, goalsActivatedThisCycle: number, maxGapScore: number, consecutiveIdleCycles: number): number;
+    /**
+     * Write shutdown-state.json to baseDir (async, atomic).
+     */
+    private writeShutdownMarker;
+    /**
+     * Read shutdown-state.json from baseDir.
+     * Returns null if file doesn't exist or fails to parse.
+     */
+    readShutdownMarker(): Promise<ShutdownMarker | null>;
+    /**
+     * Delete shutdown-state.json (after successful resume).
+     */
+    deleteShutdownMarker(): Promise<void>;
+    /**
+     * Check for a previous shutdown marker and log recovery information.
+     * Called at startup before the main loop begins.
+     */
+    private checkCrashRecovery;
+    /**
+     * Rotate the main log file if it exceeds the configured size limit.
+     * Delegates to rotateDaemonLog() with explicit config params.
+     * Called at daemon startup.
+     */
+    rotateLog(): Promise<void>;
+    /**
+     * Generate a crontab entry that runs `pulseed run --goal <goalId>` on a schedule.
+     * Delegates to the standalone generateCronEntry() function in daemon-signals.ts.
+     */
+    static generateCronEntry(goalId: string, intervalMinutes?: number): string;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runtime/daemon/runner.d.ts.map

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