crewly 1.4.63 → 1.4.64

package/dist/backend/backend/src/services/workflow/unified-scheduler.service.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Unified Scheduler Service
+ *
+ * Consolidates cron, interval, and idle-based scheduling into a single
+ * persistent service with agent auto-start capabilities.
+ *
+ * Features:
+ * - Cron schedules: standard 5-field expressions
+ * - Interval schedules: fixed-interval triggers
+ * - Idle schedules: trigger when agent has been idle for N minutes
+ * - Persistent storage in ~/.crewly/unified-schedules.json
+ * - Auto-start agents that are offline when triggered
+ * - Auto-pause after maxConsecutiveTriggers without agent response
+ * - Manual trigger, pause, and resume
+ *
+ * Runs a 60-second evaluation loop that checks all active schedules
+ * and triggers those that are due.
+ *
+ * @module services/workflow/unified-scheduler.service
+ */
+import { EventEmitter } from 'events';
+import type { UnifiedSchedule, CreateScheduleRequest, UpdateScheduleRequest, SchedulerHealth } from './unified-scheduler.types.js';
+/**
+ * UnifiedSchedulerService manages all schedule types (cron, interval, idle)
+ * in a single persistent store with a 60-second evaluation loop.
+ *
+ * Uses sendMessageToAgent (via callback) for message delivery and
+ * supports auto-starting offline agents.
+ */
+export declare class UnifiedSchedulerService extends EventEmitter {
+    private static instance;
+    private readonly logger;
+    private readonly storagePath;
+    /** All schedules indexed by ID */
+    private schedules;
+    /** Evaluation loop timer */
+    private evalTimer;
+    /** Whether the eval loop is running */
+    private running;
+    /** Timestamp of last evaluation cycle */
+    private lastEvaluatedAt;
+    /** Total triggers since service start */
+    private totalTriggersSinceStart;
+    /**
+     * Callback for sending messages to agents.
+     * Set via setMessageCallback() — decouples from AgentRegistrationService.
+     */
+    private messageCallback;
+    /**
+     * Callback for checking if an agent is online.
+     * Set via setAgentStatusCallback().
+     */
+    private agentStatusCallback;
+    /**
+     * Callback for starting an offline agent.
+     * Set via setAgentStartCallback().
+     */
+    private agentStartCallback;
+    /**
+     * Callback for checking agent idle status.
+     * Set via setIdleCheckCallback().
+     */
+    private idleCheckCallback;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @param crewlyHome - Override ~/.crewly path (for testing)
+     * @returns Service instance
+     */
+    static getInstance(crewlyHome?: string): UnifiedSchedulerService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Set the callback for sending messages to agents.
+     *
+     * @param callback - Function that sends a message to an agent by session name
+     */
+    setMessageCallback(callback: (sessionName: string, message: string) => Promise<{
+        success: boolean;
+    }>): void;
+    /**
+     * Set the callback for checking if an agent is online.
+     *
+     * @param callback - Returns true if the agent is currently active
+     */
+    setAgentStatusCallback(callback: (sessionName: string) => Promise<boolean>): void;
+    /**
+     * Set the callback for starting an offline agent.
+     *
+     * @param callback - Starts the agent and returns true if successful
+     */
+    setAgentStartCallback(callback: (sessionName: string) => Promise<boolean>): void;
+    /**
+     * Set the callback for checking agent idle status.
+     *
+     * @param callback - Returns idle status and idle duration
+     */
+    setIdleCheckCallback(callback: (sessionName: string) => Promise<{
+        idle: boolean;
+        idleMinutes: number;
+    }>): void;
+    /**
+     * Start the scheduler evaluation loop.
+     *
+     * Loads persisted schedules from disk and begins the 60-second
+     * evaluation cycle.
+     */
+    start(): void;
+    /**
+     * Stop the scheduler evaluation loop.
+     */
+    stop(): void;
+    /**
+     * Create a new schedule.
+     *
+     * @param request - Schedule creation request
+     * @returns Created schedule
+     * @throws Error if validation fails
+     */
+    create(request: CreateScheduleRequest): UnifiedSchedule;
+    /**
+     * Get a schedule by ID.
+     *
+     * @param id - Schedule ID
+     * @returns Schedule or null
+     */
+    get(id: string): UnifiedSchedule | null;
+    /**
+     * List all schedules, optionally filtered by target session.
+     *
+     * @param target - Optional session name filter
+     * @returns Array of schedules
+     */
+    list(target?: string): UnifiedSchedule[];
+    /**
+     * Update an existing schedule.
+     *
+     * @param id - Schedule ID
+     * @param updates - Partial update fields
+     * @returns Updated schedule or null if not found
+     */
+    update(id: string, updates: UpdateScheduleRequest): UnifiedSchedule | null;
+    /**
+     * Delete a schedule.
+     *
+     * @param id - Schedule ID
+     * @returns True if deleted
+     */
+    delete(id: string): boolean;
+    /**
+     * Pause a schedule.
+     *
+     * @param id - Schedule ID
+     * @returns Updated schedule or null
+     */
+    pause(id: string): UnifiedSchedule | null;
+    /**
+     * Resume a paused schedule.
+     *
+     * @param id - Schedule ID
+     * @returns Updated schedule or null
+     */
+    resume(id: string): UnifiedSchedule | null;
+    /**
+     * Manually trigger a schedule now, regardless of timing.
+     *
+     * @param id - Schedule ID
+     * @returns True if triggered successfully
+     */
+    triggerNow(id: string): Promise<boolean>;
+    /**
+     * Get scheduler health and statistics.
+     *
+     * @returns Health stats
+     */
+    getHealth(): SchedulerHealth;
+    /**
+     * Evaluate all active schedules and trigger those that are due.
+     *
+     * Called every 60 seconds by the eval timer. Checks each schedule
+     * type against its timing criteria and executes if due.
+     */
+    evaluate(): Promise<void>;
+    /**
+     * Check if a schedule is due for triggering.
+     *
+     * @param schedule - Schedule to check
+     * @returns True if the schedule should trigger now
+     */
+    private isScheduleDue;
+    /**
+     * Check if a cron schedule is due (within the current evaluation window).
+     *
+     * Compares the cron expression against the current time.
+     * Uses minute-level granularity (matches eval loop frequency).
+     *
+     * @param schedule - Cron schedule to check
+     * @returns True if the current minute matches the cron expression
+     */
+    private isCronDue;
+    /**
+     * Execute a schedule: send message to agent, handle auto-start,
+     * track consecutive triggers, and auto-pause if limit reached.
+     *
+     * @param schedule - Schedule to execute
+     * @returns True if message was delivered successfully
+     */
+    private executeSchedule;
+    /**
+     * Reset the consecutive trigger counter for a target agent.
+     *
+     * Called when an agent shows activity (e.g., sends a message, completes a task).
+     * This prevents auto-pausing schedules for responsive agents.
+     *
+     * @param target - Agent session name
+     */
+    resetConsecutiveTriggers(target: string): void;
+    /**
+     * Save all schedules to disk.
+     */
+    private persist;
+    /**
+     * Load schedules from disk.
+     */
+    private loadFromDisk;
+    /**
+     * Get count of active schedules.
+     */
+    private getActiveCount;
+}
+//# sourceMappingURL=unified-scheduler.service.d.ts.map

package/dist/backend/backend/src/services/workflow/unified-scheduler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-scheduler.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/workflow/unified-scheduler.service.ts"],"names":[],"mappings":"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"}