openvole 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -576,6 +576,8 @@ declare class TaskQueue {
     }): AgentTask;
     /** Cancel a task by ID */
     cancel(taskId: string): boolean;
+    /** Cancel all queued tasks (for shutdown) */
+    cancelAll(): void;
     /** Get all tasks (queued + running + completed) */
     list(): AgentTask[];
     /** Get a task by ID */
@@ -627,7 +629,7 @@ declare class SchedulerStore {
         nextRun?: string;
         createdAt: number;
     }>;
-    /** Clear all schedules (for shutdown) */
+    /** Clear all schedules (for shutdown). Disables persistence so the file is never overwritten. */
     clearAll(): void;
     /** Save schedules to disk */
     private persist;
@@ -724,6 +726,7 @@ interface VoleEngine {
 declare function createEngine(projectRoot: string, options?: {
     io?: VoleIO;
     configPath?: string;
+    headless?: boolean;
 }): Promise<VoleEngine>;
 
 export { type ActionError, type ActionErrorCode, type ActionResult, type ActiveSkill, type AgentContext, type AgentMessage, type AgentPlan, type AgentTask, type BootstrapHook, type BusEvents, type CompactHook, type EffectivePermissions, type HeartbeatConfig, type LoopConfig, type LoopDependencies, type LoopPhase, type MessageBus, type ObserveHook, PHASE_ORDER, type PawConfig, type PawDefinition, type PawInstance, type PawManifest, PawRegistry, type PerceiveHook, type PlannedAction, RateLimiter, type RateLimits, type ScheduleHook, SchedulerStore, type SkillDefinition, type SkillInstance, SkillRegistry, TaskQueue, type TaskStatus, type ToolDefinition, ToolRegistry, type ToolRegistryEntry, type ToolSummary, type TransportType, Vault, type VaultEntry, type VoleConfig, type VoleEngine, type VoleIO, type VoleLock, addPawToLock, addSkillToLock, buildActiveSkills, computeEffectivePermissions, createActionError, createAgentContext, createEngine, createMessageBus, createTtyIO, defineConfig, failureResult, loadConfig, readLockFile, readPawManifest, removePawFromLock, removeSkillFromLock, resolvePawPath, resolveSkills, runAgentLoop, successResult, validatePermissions, writeLockFile };

package/dist/index.js

@@ -737,6 +737,19 @@ var TaskQueue = class {
     }
     return false;
   }
+  /** Cancel all queued tasks (for shutdown) */
+  cancelAll() {
+    while (this.queue.length > 0) {
+      const task = this.queue.shift();
+      task.status = "cancelled";
+      task.completedAt = Date.now();
+      this.completed.push(task);
+      this.bus.emit("task:cancelled", { taskId: task.id });
+    }
+    for (const task of this.running.values()) {
+      task.status = "cancelled";
+    }
+  }
   /** Get all tasks (queued + running + completed) */
   list() {
     return [
@@ -853,7 +866,8 @@ var SchedulerStore = class {
       if (persisted.length > 0) {
         logger4.info(`Restored ${persisted.length} schedule(s) from disk`);
       }
-    } catch {
+    } catch (err) {
+      logger4.warn(`Could not restore schedules: ${err}`);
     }
   }
   /** Create or replace a recurring schedule */
@@ -896,8 +910,9 @@ var SchedulerStore = class {
       createdAt
     }));
   }
-  /** Clear all schedules (for shutdown) */
+  /** Clear all schedules (for shutdown). Disables persistence so the file is never overwritten. */
   clearAll() {
+    this.savePath = void 0;
     for (const entry of this.schedules.values()) {
       entry.job.stop();
     }
@@ -906,16 +921,29 @@ var SchedulerStore = class {
   }
   /** Save schedules to disk */
   async persist() {
-    if (!this.savePath) return;
+    const targetPath = this.savePath;
+    if (!targetPath) return;
     const toSave = Array.from(this.schedules.values()).filter((s) => s.id !== "__heartbeat__").map(({ id, input, cron, createdAt }) => ({
       id,
       input,
       cron,
       createdAt
     }));
+    if (toSave.length === 0) {
+      try {
+        const existing = await fs3.readFile(targetPath, "utf-8");
+        const parsed = JSON.parse(existing);
+        if (parsed.length > 0) {
+          logger4.warn(`Refusing to overwrite ${parsed.length} persisted schedule(s) with empty list`);
+          return;
+        }
+      } catch {
+      }
+    }
     try {
-      await fs3.mkdir(path3.dirname(this.savePath), { recursive: true });
-      await fs3.writeFile(this.savePath, JSON.stringify(toSave, null, 2) + "\n", "utf-8");
+      await fs3.mkdir(path3.dirname(targetPath), { recursive: true });
+      await fs3.writeFile(targetPath, JSON.stringify(toSave, null, 2) + "\n", "utf-8");
+      logger4.debug(`Persisted ${toSave.length} schedule(s) to disk`);
     } catch (err) {
       logger4.error(`Failed to persist schedules: ${err}`);
     }
@@ -1287,8 +1315,14 @@ var IpcTransport = class {
     this.handlers.clear();
   }
   send(message) {
+    if (this.disposed) return;
     if (this.type === "ipc") {
-      this.childProcess.send?.(message);
+      try {
+        if (this.childProcess.connected) {
+          this.childProcess.send?.(message);
+        }
+      } catch {
+      }
     } else {
       const json = JSON.stringify(message);
       const header = `Content-Length: ${Buffer.byteLength(json)}\r
@@ -2649,6 +2683,7 @@ async function createEngine(projectRoot, options) {
       rateLimiter
     });
   });
+  let shuttingDown = false;
   const engine = {
     bus,
     toolRegistry,
@@ -2659,10 +2694,12 @@ async function createEngine(projectRoot, options) {
     config,
     async start() {
       engineLogger.info("Starting OpenVole...");
+      const headless = options?.headless ?? false;
       if (config.brain) {
       } else {
         engineLogger.info("No Brain Paw configured \u2014 Think step will be a no-op");
       }
+      const headlessSkipPatterns = ["paw-dashboard", "paw-telegram", "paw-slack", "paw-discord", "paw-whatsapp"];
       const pawConfigs = config.paws.map(normalizePawConfig);
       const brainConfig = pawConfigs.find((p) => p.name === config.brain);
       const subprocessPaws = pawConfigs.filter(
@@ -2680,15 +2717,18 @@ async function createEngine(projectRoot, options) {
           pawRegistry.setBrain("");
         }
       }
-      for (const pawConfig of subprocessPaws) {
-        await pawRegistry.load(pawConfig);
-      }
+      const pawsToLoad = headless ? subprocessPaws.filter((p) => !headlessSkipPatterns.some((pat) => p.name.includes(pat))) : subprocessPaws;
+      await Promise.all(pawsToLoad.map((pawConfig) => pawRegistry.load(pawConfig)));
       for (const skillName of config.skills) {
         await skillRegistry.load(skillName);
       }
       skillRegistry.resolve();
-      await scheduler.restore();
-      if (config.heartbeat.enabled) {
+      if (!headless) {
+        await scheduler.restore();
+      } else {
+        await scheduler.loadFromDisk();
+      }
+      if (config.heartbeat.enabled && !headless) {
         const heartbeatMdPath = path10.resolve(projectRoot, ".openvole", "HEARTBEAT.md");
         const heartbeatCron = `*/${config.heartbeat.intervalMinutes} * * * *`;
         scheduler.add(
@@ -2719,8 +2759,11 @@ ${heartbeatContent}` : "Heartbeat wake-up. Check active skills and decide if any
       taskQueue.enqueue(input, source, sessionId ? { sessionId } : void 0);
     },
     async shutdown() {
+      if (shuttingDown) return;
+      shuttingDown = true;
       engineLogger.info("Shutting down...");
       scheduler.clearAll();
+      taskQueue.cancelAll();
       for (const paw of pawRegistry.list()) {
         await pawRegistry.unload(paw.name);
       }