openvole 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -36,6 +36,8 @@ interface ToolSummary {
     name: string;
     description: string;
     pawName: string;
+    /** Parameter schema (Zod) — passed to Brain Paw for function calling */
+    parameters?: unknown;
 }
 /** A Skill whose required tools are all satisfied (compact — Brain reads full instructions on demand) */
 interface ActiveSkill {
@@ -225,7 +227,6 @@ interface LoopConfig {
     taskConcurrency: number;
     /** Max messages before triggering compact hooks (0 = disabled) */
     compactThreshold: number;
-    logLevel: 'debug' | 'info' | 'warn' | 'error';
     /** Rate limits (undefined = no limits) */
     rateLimits?: RateLimits;
 }
@@ -240,6 +241,15 @@ interface ToolProfile {
 interface HeartbeatConfig {
     enabled: boolean;
     intervalMinutes: number;
+    /** If true, run heartbeat immediately on startup (default: false) */
+    runOnStart?: boolean;
+}
+/** Security configuration */
+interface SecurityConfig {
+    /** If true, paws can only access files inside .openvole/ directory. Default: true */
+    sandboxFilesystem?: boolean;
+    /** Additional paths paws are allowed to access outside .openvole/ */
+    allowedPaths?: string[];
 }
 /** The full OpenVole configuration */
 interface VoleConfig {
@@ -250,6 +260,8 @@ interface VoleConfig {
     heartbeat: HeartbeatConfig;
     /** Tool profiles per task source — restrict which tools can be used */
     toolProfiles?: Record<string, ToolProfile>;
+    /** Security settings */
+    security?: SecurityConfig;
 }
 /** CLI-managed lock file — tracks installed paws and skills */
 interface VoleLock {
@@ -378,7 +390,8 @@ interface QueryableScheduler {
     list(): Array<{
         id: string;
         input: string;
-        intervalMinutes: number;
+        cron: string;
+        nextRun?: string;
         createdAt: number;
     }>;
 }
@@ -589,22 +602,62 @@ interface LoopDependencies {
  */
 declare function runAgentLoop(task: AgentTask, deps: LoopDependencies): Promise<void>;
 
-/** In-memory store for brain-created recurring schedules */
+/** Persistent store for recurring schedules using cron expressions */
 declare class SchedulerStore {
     private schedules;
+    private savePath;
+    private tickHandler;
+    /** Set the file path for persistence */
+    setPersistence(filePath: string): void;
+    /** Set the handler called when a schedule ticks */
+    setTickHandler(handler: (input: string) => void): void;
+    /** Load schedule data from disk without starting cron jobs (for read-only access) */
+    loadFromDisk(): Promise<void>;
+    /** Load persisted schedules from disk and restart their jobs */
+    restore(): Promise<void>;
     /** Create or replace a recurring schedule */
-    add(id: string, input: string, intervalMinutes: number, onTick: () => void): void;
+    add(id: string, input: string, cron: string, onTick: () => void, createdAt?: number, immediate?: boolean): void;
     /** Cancel a schedule by ID */
-    cancel(id: string): boolean;
+    cancel(id: string, skipPersist?: boolean): boolean;
     /** List all active schedules */
     list(): Array<{
         id: string;
         input: string;
-        intervalMinutes: number;
+        cron: string;
+        nextRun?: string;
         createdAt: number;
     }>;
     /** Clear all schedules (for shutdown) */
     clearAll(): void;
+    /** Save schedules to disk */
+    private persist;
+}
+
+interface VaultEntry {
+    value: string;
+    source: 'user' | 'tool' | 'brain';
+    createdAt: number;
+    /** Optional metadata — context about the stored value (service, handle, url, etc.) */
+    meta?: Record<string, string>;
+}
+declare class Vault {
+    private entries;
+    private vaultPath;
+    private encryptionKey?;
+    constructor(vaultPath: string, encryptionKey?: string);
+    init(): Promise<void>;
+    store(key: string, value: string, source?: string, meta?: Record<string, string>): Promise<boolean>;
+    get(key: string): Promise<string | null>;
+    list(): Promise<Array<{
+        key: string;
+        source: string;
+        createdAt: number;
+        meta?: Record<string, string>;
+    }>>;
+    delete(key: string): Promise<boolean>;
+    private save;
+    private encrypt;
+    private decrypt;
 }
 
 /**
@@ -673,4 +726,4 @@ declare function createEngine(projectRoot: string, options?: {
     configPath?: string;
 }): 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, 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 };
+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 };