@flowdot.ai/daemon 1.0.0

package/dist/loop/LoopDaemon.d.ts

@@ -0,0 +1,123 @@
+import { EventEmitter } from 'node:events';
+import type { LoopConfig, LoopDaemonConfig, DaemonStatus, Logger } from './types.js';
+import { type LoopManagerOptions } from './LoopManager.js';
+import { type GoalManagerOptions, type TokenProvider, type TaskType, type TaskGeneratorLLMFunction, type TaskGeneratorOptions, type TaskExecutorOptions, type TaskExecutionHandler, type ApprovalRequestFunction, type PermissionBridgeOptions, type GoalCommsHandlerOptions, type CommsSendFunction, type ReviewSchedulerOptions, type ProgressTrackerOptions, type ErrorRecoveryOptions, type GoalSchedulerOptions, type ExecuteGoalFunction } from '../goals/index.js';
+export interface DaemonGoalConfig {
+    baseUrl: string;
+    tokenProvider: TokenProvider;
+    managerOptions?: Partial<Omit<GoalManagerOptions, 'baseUrl' | 'tokenProvider' | 'logger'>>;
+    llmFunction?: TaskGeneratorLLMFunction;
+    taskGeneratorOptions?: Partial<Omit<TaskGeneratorOptions, 'llmFunction' | 'logger'>>;
+    taskHandlers?: Partial<Record<TaskType, TaskExecutionHandler>>;
+    approvalRequestFunction?: ApprovalRequestFunction;
+    permissionBridgeOptions?: Partial<Omit<PermissionBridgeOptions, 'logger'>>;
+    taskExecutorOptions?: Partial<Omit<TaskExecutorOptions, 'handlers' | 'requestApproval' | 'checkPermission' | 'updateTaskStatus' | 'logger'>>;
+    commsSendFunction?: CommsSendFunction;
+    commsHandlerOptions?: Partial<Omit<GoalCommsHandlerOptions, 'sendFunction' | 'logger'>>;
+    enableReviewScheduler?: boolean;
+    reviewSchedulerOptions?: Partial<Omit<ReviewSchedulerOptions, 'logger'>>;
+    enableProgressTracker?: boolean;
+    progressTrackerOptions?: Partial<Omit<ProgressTrackerOptions, 'logger'>>;
+    enableErrorRecovery?: boolean;
+    errorRecoveryOptions?: Partial<Omit<ErrorRecoveryOptions, 'logger'>>;
+    enableGoalScheduler?: boolean;
+    goalSchedulerOptions?: Partial<Omit<GoalSchedulerOptions, 'getDueGoals' | 'markGoalStarted' | 'markGoalCompleted' | 'executeGoal' | 'logger'>>;
+    executeGoalFunction?: ExecuteGoalFunction;
+}
+export interface LoopDaemonOptions {
+    baseDir?: string;
+    daemonConfig?: Partial<LoopDaemonConfig>;
+    loopConfig?: Partial<LoopConfig>;
+    managerOptions?: LoopManagerOptions;
+    goalConfig?: DaemonGoalConfig;
+    logger?: Logger;
+}
+export type DaemonMethod = 'ping' | 'status' | 'shutdown' | 'createLoop' | 'getLoop' | 'getLoopByName' | 'getAllLoops' | 'getLoopsByStatus' | 'pauseLoop' | 'resumeLoop' | 'stopLoop' | 'deleteLoop' | 'runNow' | 'runLoopNow' | 'getRunHistory' | 'getLoopHistory' | 'getRun' | 'getStats' | 'listGoals' | 'getGoal' | 'createGoal' | 'updateGoal' | 'deleteGoal' | 'pauseGoal' | 'resumeGoal' | 'completeGoal' | 'abandonGoal' | 'getGoalProgress' | 'listMilestones' | 'getMilestone' | 'createMilestone' | 'updateMilestone' | 'deleteMilestone' | 'completeMilestone' | 'listTasks' | 'getTask' | 'createTask' | 'updateTask' | 'deleteTask' | 'approveTask' | 'denyTask' | 'startTask' | 'completeTask' | 'failTask' | 'skipTask' | 'addTaskFeedback' | 'getPendingTasks' | 'getTasksAwaitingApproval' | 'listMemories' | 'createMemory' | 'updateMemory' | 'toggleMemory' | 'deleteMemory' | 'getEnabledMemories' | 'getGoalStats' | 'getActionLogs' | 'generateTasks' | 'generateDailyTasks' | 'suggestNextTask' | 'isTaskGenerationEnabled' | 'executeTask' | 'executeTaskSequence' | 'runGoalAutoMode' | 'canExecuteTask' | 'isTaskExecutionEnabled' | 'getExecutionCapabilities' | 'checkTaskPermission' | 'recordPermissionDecision' | 'getPermissionAuditLog' | 'clearPermissionCache' | 'sendGoalNotification' | 'requestGoalApproval' | 'handleApprovalResponse' | 'isCommsEnabled' | 'isReviewSchedulerEnabled' | 'setReviewSchedule' | 'removeReviewSchedule' | 'scheduleReview' | 'completeReview' | 'snoozeReview' | 'getPendingReviews' | 'getDueReviews' | 'isProgressTrackerEnabled' | 'calculateGoalProgress' | 'recordTaskCompletion' | 'createProgressSnapshot' | 'getProgressSnapshots' | 'getVelocityMetrics' | 'isErrorRecoveryEnabled' | 'createCheckpoint' | 'getCheckpoints' | 'restoreCheckpoint' | 'clearCheckpoints' | 'analyzeError';
+export interface DaemonEvents {
+    started: [];
+    stopping: [];
+    stopped: [];
+    error: [error: Error];
+    loopEvent: [event: string, data: Record<string, unknown>];
+    goalEvent: [event: string, data: Record<string, unknown>];
+}
+export declare class LoopDaemon extends EventEmitter {
+    private readonly baseDir;
+    private readonly flowdotDir;
+    private readonly config;
+    private readonly store;
+    private readonly managerOptions;
+    private readonly goalConfig?;
+    private readonly logger;
+    private manager;
+    private goalManager;
+    private taskGenerator;
+    private taskExecutor;
+    private permissionBridge;
+    private goalCommsHandler;
+    private reviewScheduler;
+    private progressTracker;
+    private errorRecovery;
+    private goalScheduler;
+    private ipcServer;
+    private logStream;
+    private startedAt;
+    private isShuttingDown;
+    constructor(options?: LoopDaemonOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): Promise<DaemonStatus>;
+    isRunning(): boolean;
+    private resolveLoopId;
+    private assertGoalManager;
+    private assertTaskGenerator;
+    private assertTaskExecutor;
+    private assertPermissionBridge;
+    private assertGoalCommsHandler;
+    private assertReviewScheduler;
+    private assertProgressTracker;
+    private assertErrorRecovery;
+    private handleRequest;
+    private setupManagerEvents;
+    private serializeEventData;
+    private setupGoalManagerEvents;
+    private serializeGoalEventData;
+    private setupTaskExecutorEvents;
+    private serializeExecutorEventData;
+    private serializePermissionEventData;
+    private setupCommsHandlerEvents;
+    private serializeCommsEventData;
+    private setupReviewSchedulerEvents;
+    private serializeReviewSchedulerEventData;
+    private setupProgressTrackerEvents;
+    private serializeProgressTrackerEventData;
+    private setupErrorRecoveryEvents;
+    private serializeErrorRecoveryEventData;
+    private setupGoalSchedulerEvents;
+    private serializeGoalSchedulerEventData;
+    private createGetDueGoalsFunction;
+    private createMarkGoalStartedFunction;
+    private createMarkGoalCompletedFunction;
+    private createDefaultExecuteGoalFunction;
+    private setupSignalHandlers;
+    private setupLogging;
+    private closeLogStream;
+    private logMessage;
+    private ensureDirectories;
+    private cleanup;
+}
+export interface DaemonControlOptions {
+    port?: number;
+    baseDir?: string;
+    daemonConfig?: Partial<LoopDaemonConfig>;
+    logger?: Logger;
+    daemonScript?: string;
+}
+export declare function startDaemon(options?: DaemonControlOptions): Promise<{
+    pid: number;
+}>;
+export declare function stopDaemon(options?: DaemonControlOptions): Promise<void>;
+export declare function getDaemonStatus(options?: DaemonControlOptions): Promise<DaemonStatus>;
+export declare function isProcessRunning(pid: number): boolean;
+export declare function createLoopDaemon(options?: LoopDaemonOptions): LoopDaemon;
+export declare function runDaemon(options?: LoopDaemonOptions): Promise<void>;