@moltos/sdk 0.7.1 → 0.7.3

package/dist/lib/scheduler.d.ts

@@ -0,0 +1,138 @@
+/**
+ * ClawScheduler - Persistent Task Scheduler for MoltOS
+ *
+ * Features:
+ * - Hybrid checkpointing: WASM state serialization (primary) + Firecracker snapshots (fallback)
+ * - Dual triggers: Cron-based and event-based (ClawBus webhooks)
+ * - ClawFS storage with optional remote replication
+ * - Persistent daemon with automatic restart from last checkpoint
+ *
+ * Architecture:
+ * - Scheduler daemon runs as background process
+ * - Tasks are defined as WASM modules or shell commands
+ * - State serialized to ClawFS on each checkpoint
+ * - Failed tasks auto-restart from last known good state
+ */
+export type TaskTrigger = {
+    type: 'cron';
+    expression: string;
+} | {
+    type: 'event';
+    topic: string;
+} | {
+    type: 'once';
+    delayMs?: number;
+};
+export type CheckpointMode = 'wasm' | 'firecracker' | 'auto';
+export interface TaskConfig {
+    id: string;
+    name: string;
+    command: string;
+    args?: string[];
+    workingDir?: string;
+    env?: Record<string, string>;
+    trigger: TaskTrigger;
+    checkpointMode: CheckpointMode;
+    checkpointInterval?: number;
+    maxRetries: number;
+    timeout?: number;
+    replicate?: boolean;
+}
+export interface TaskState {
+    id: string;
+    status: 'pending' | 'running' | 'paused' | 'failed' | 'completed';
+    pid?: number;
+    startedAt?: string;
+    lastCheckpoint?: string;
+    checkpointId?: string;
+    runCount: number;
+    failCount: number;
+    lastError?: string;
+    envSnapshot?: Record<string, string>;
+}
+export interface Checkpoint {
+    id: string;
+    taskId: string;
+    timestamp: string;
+    type: 'wasm' | 'firecracker';
+    statePath: string;
+    metadata: {
+        pid?: number;
+        cwd: string;
+        env: Record<string, string>;
+        exitCode?: number;
+    };
+    merkleRoot: string;
+}
+export interface Schedule {
+    tasks: TaskConfig[];
+    global: {
+        defaultCheckpointInterval: number;
+        maxConcurrentTasks: number;
+        replicateByDefault: boolean;
+    };
+}
+export declare class ClawScheduler {
+    private tasks;
+    private states;
+    private processes;
+    private cronCache;
+    private clawfs;
+    private privateKey;
+    private clawId;
+    private isRunning;
+    private checkInterval?;
+    private checkpointIntervals;
+    private eventListeners;
+    constructor(baseDir: string, clawId: string, privateKey: string);
+    private get schedulePath();
+    private get statePath();
+    private loadSchedule;
+    private saveState;
+    /**
+     * Add a new scheduled task
+     */
+    addTask(config: Omit<TaskConfig, 'id'>): TaskConfig;
+    private saveSchedule;
+    /**
+     * Remove a task
+     */
+    removeTask(taskId: string): boolean;
+    /**
+     * Start a specific task
+     */
+    startTask(taskId: string, fromCheckpoint?: string): Promise<void>;
+    /**
+     * Stop a running task
+     */
+    stopTask(taskId: string): void;
+    private createCheckpoint;
+    private loadCheckpoint;
+    /**
+     * Start the scheduler daemon
+     */
+    start(): void;
+    /**
+     * Stop the scheduler daemon
+     */
+    stop(): void;
+    private checkCronTriggers;
+    /**
+     * Subscribe to a ClawBus topic for event triggers
+     */
+    subscribeEvent(topic: string, handler: (data: unknown) => void): void;
+    /**
+     * Emit an event to trigger event-based tasks
+     */
+    emitEvent(topic: string, data: unknown): void;
+    getStatus(): {
+        isRunning: boolean;
+        taskCount: number;
+        runningCount: number;
+        tasks: TaskState[];
+    };
+    getTaskLogs(taskId: string): string;
+}
+export declare function schedulerCommand(action: 'start' | 'stop' | 'status' | 'add' | 'remove' | 'logs', options: any, clawId: string, privateKey: string): Promise<void>;
+export default ClawScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/lib/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/lib/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE;QACN,yBAAyB,EAAE,MAAM,CAAC;QAClC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;CACH;AAsKD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,cAAc,CAAuD;gBAG3E,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM;IAYpB,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,UAAU;IA0BnD,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAcnC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8FvE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YA+BhB,gBAAgB;IA2B9B,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAOrE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB;IASD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAOpC;AAMD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EAC/D,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAoGf;AAED,eAAe,aAAa,CAAC"}