@orbytautomation/engine 0.6.2 → 0.7.1

package/dist/storage/ScheduleStore.js

@@ -1,2 +1,209 @@
-export {};
+/**
+ * Schedule Store
+ *
+ * Persists workflow schedule state under .orbyt/schedules/.
+ * One JSON file per schedule; enables restart recovery so the scheduler
+ * can reload all known schedules without re-registration by callers.
+ *
+ * Layout:
+ *   .orbyt/schedules/<scheduleId>.json
+ *
+ * Primary purposes:
+ *   - Persist cron/interval schedules so they survive process restarts
+ *   - Track last-run / next-run timestamps for missed-run recovery
+ *   - Record consecutive error counts for circuit-breaker logic
+ *
+ * All methods are non-fatal (errors are swallowed) — the store must never
+ * interrupt the scheduler or workflow execution.
+ *
+ * @module storage
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync, rmSync, } from 'node:fs';
+import { join, basename } from 'node:path';
+// ─── ScheduleStore ────────────────────────────────────────────────────────────
+/**
+ * File-based schedule state store.
+ *
+ * An in-memory cache avoids re-reading files on every access.
+ * The cache is always the source of truth for in-flight updates;
+ * the file acts as the durable record for restarts.
+ */
+export class ScheduleStore {
+    dir;
+    /** In-memory cache: scheduleId → current state */
+    cache = new Map();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    // ─── Write API ─────────────────────────────────────────────────────────────
+    /**
+     * Persist a schedule record.
+     * Creates the storage directory on first call.
+     * If the schedule already exists it is fully replaced.
+     */
+    save(schedule) {
+        try {
+            mkdirSync(this.dir, { recursive: true });
+            const updated = {
+                ...schedule,
+                updatedAt: new Date().toISOString(),
+            };
+            this.cache.set(schedule.scheduleId, updated);
+            this._write(schedule.scheduleId, updated);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    /**
+     * Record the outcome of a schedule trigger.
+     *
+     * - Updates `lastRunAt`, `lastStatus`, `nextRunAt`
+     * - Increments `executionCount`
+     * - On success: resets `errorCount` and clears `lastError`
+     * - On failure: increments `errorCount` and stores `lastError`
+     */
+    updateLastRun(scheduleId, status, runAt, nextRunAt, error) {
+        try {
+            const record = this._getOrLoad(scheduleId);
+            if (!record)
+                return;
+            record.lastRunAt = runAt.toISOString();
+            record.lastStatus = status;
+            record.executionCount = (record.executionCount ?? 0) + 1;
+            if (nextRunAt)
+                record.nextRunAt = nextRunAt.toISOString();
+            if (status === 'completed') {
+                record.errorCount = 0;
+                delete record.lastError;
+            }
+            else {
+                record.errorCount = (record.errorCount ?? 0) + 1;
+                if (error)
+                    record.lastError = error;
+            }
+            record.updatedAt = new Date().toISOString();
+            this.cache.set(scheduleId, record);
+            this._write(scheduleId, record);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    /**
+     * Mark a schedule as active.
+     * No-op if the schedule does not exist.
+     */
+    enable(scheduleId) {
+        this._setStatus(scheduleId, 'active');
+    }
+    /**
+     * Mark a schedule as paused — it will not fire until re-enabled.
+     * No-op if the schedule does not exist.
+     */
+    disable(scheduleId) {
+        this._setStatus(scheduleId, 'paused');
+    }
+    /**
+     * Remove a schedule from both the cache and disk.
+     * Safe to call if the schedule does not exist.
+     */
+    delete(scheduleId) {
+        try {
+            this.cache.delete(scheduleId);
+            const filePath = this._filePath(scheduleId);
+            if (existsSync(filePath))
+                rmSync(filePath);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // ─── Read API ──────────────────────────────────────────────────────────────
+    /**
+     * Read a single schedule by ID.
+     * Returns null if not found.
+     */
+    load(scheduleId) {
+        try {
+            const cached = this.cache.get(scheduleId);
+            if (cached)
+                return { ...cached };
+            const filePath = this._filePath(scheduleId);
+            if (!existsSync(filePath))
+                return null;
+            return JSON.parse(readFileSync(filePath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Return all persisted schedules, sorted by `createdAt` ascending.
+     */
+    list() {
+        try {
+            mkdirSync(this.dir, { recursive: true });
+            return readdirSync(this.dir)
+                .filter(f => f.endsWith('.json'))
+                .flatMap(f => {
+                try {
+                    const id = basename(f, '.json');
+                    const record = this._getOrLoad(id);
+                    return record ? [record] : [];
+                }
+                catch {
+                    return [];
+                }
+            })
+                .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Return only schedules that are currently active.
+     */
+    listEnabled() {
+        return this.list().filter(s => s.status === 'active');
+    }
+    // ─── Internal helpers ──────────────────────────────────────────────────────
+    _setStatus(scheduleId, status) {
+        try {
+            const record = this._getOrLoad(scheduleId);
+            if (!record)
+                return;
+            record.status = status;
+            record.updatedAt = new Date().toISOString();
+            this.cache.set(scheduleId, record);
+            this._write(scheduleId, record);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    _getOrLoad(scheduleId) {
+        const cached = this.cache.get(scheduleId);
+        if (cached)
+            return cached;
+        const filePath = this._filePath(scheduleId);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const record = JSON.parse(readFileSync(filePath, 'utf-8'));
+            this.cache.set(scheduleId, record);
+            return record;
+        }
+        catch {
+            return null;
+        }
+    }
+    _filePath(scheduleId) {
+        return join(this.dir, `${scheduleId}.json`);
+    }
+    _write(scheduleId, record) {
+        writeFileSync(this._filePath(scheduleId), JSON.stringify(record, null, 2), 'utf-8');
+    }
+}
 //# sourceMappingURL=ScheduleStore.js.map

package/dist/storage/ScheduleStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScheduleStore.js","sourceRoot":"","sources":["../../src/storage/ScheduleStore.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ScheduleStore.js","sourceRoot":"","sources":["../../src/storage/ScheduleStore.ts"],"names":[],"mappings":"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"}

package/dist/storage/WorkflowStore.d.ts

@@ -1,2 +1,83 @@
-export {};
+/**
+ * Workflow Store
+ *
+ * Persists versioned workflow definitions under .orbyt/workflows/.
+ * Each workflow gets its own subdirectory; each save creates a new versioned file.
+ *
+ * Layout:
+ *   .orbyt/workflows/<workflowName>/v1.json
+ *   .orbyt/workflows/<workflowName>/v2.json
+ *   ...
+ *
+ * Primary purpose: replay a failed run against the exact workflow definition
+ * that was used — not against a potentially-modified current version.
+ *
+ * All methods are non-fatal (errors are swallowed) — the store must never
+ * interrupt actual workflow execution.
+ *
+ * @module storage
+ */
+import type { ParsedWorkflow } from '../types/core-types.js';
+export interface PersistedWorkflow {
+    /** Workflow identifier (name or generated) */
+    workflowId: string;
+    /** Version number (1-based, auto-incremented) */
+    version: number;
+    /** ISO 8601 timestamp of when this version was saved */
+    savedAt: string;
+    /** The full parsed workflow definition */
+    definition: ParsedWorkflow;
+}
+/**
+ * File-based workflow definition store.
+ *
+ * Stores multiple versions of each workflow definition so a failed execution
+ * can always be replayed against the exact definition that produced it.
+ *
+ * An in-memory cache for the latest version of each workflow avoids
+ * re-reading the file on every `save()` call.
+ */
+export declare class WorkflowStore {
+    private readonly dir;
+    /** Cache: workflowId → latest saved version number */
+    private readonly latestVersionCache;
+    constructor(dir: string);
+    /**
+     * Save a workflow definition.
+     * A new version file is created on each call; the version number is
+     * determined by inspecting existing files (or the cache).
+     */
+    save(workflow: ParsedWorkflow): void;
+    /**
+     * Load the most recently saved version of a workflow.
+     * Returns null if the workflow has never been saved.
+     */
+    loadLatest(workflowId: string): PersistedWorkflow | null;
+    /**
+     * Load a specific version of a workflow.
+     * When `version` is omitted the latest version is returned.
+     */
+    load(workflowId: string, version?: number): PersistedWorkflow | null;
+    /**
+     * Return all saved version numbers for a workflow, sorted newest-first.
+     */
+    listVersions(workflowId: string): number[];
+    /**
+     * Return all workflow IDs that have at least one saved version.
+     */
+    list(): string[];
+    /**
+     * Delete a specific version of a workflow, or all versions if `version`
+     * is omitted (removes the entire workflow subdirectory).
+     */
+    delete(workflowId: string, version?: number): void;
+    /** Derive a stable ID from the workflow — prefer `name`, fallback to `metadata.name`. */
+    private _resolveId;
+    /**
+     * Calculate the next version number.
+     * Reads the cache first; if not cached, scans the directory.
+     */
+    private _nextVersion;
+    private _readVersion;
+}
 //# sourceMappingURL=WorkflowStore.d.ts.map

package/dist/storage/WorkflowStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkflowStore.d.ts","sourceRoot":"","sources":["../../src/storage/WorkflowStore.ts"],"names":[],"mappings":""}
+{"version":3,"file":"WorkflowStore.d.ts","sourceRoot":"","sources":["../../src/storage/WorkflowStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,cAAc,CAAC;CAC5B;AAID;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;gBAEpD,GAAG,EAAE,MAAM;IAMvB;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IA2BpC;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAUxD;;;OAGG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IASpE;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAa1C;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAYhB;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBlD,yFAAyF;IACzF,OAAO,CAAC,UAAU;IAMlB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;CAKrB"}

package/dist/storage/WorkflowStore.js

@@ -1,2 +1,184 @@
-export {};
+/**
+ * Workflow Store
+ *
+ * Persists versioned workflow definitions under .orbyt/workflows/.
+ * Each workflow gets its own subdirectory; each save creates a new versioned file.
+ *
+ * Layout:
+ *   .orbyt/workflows/<workflowName>/v1.json
+ *   .orbyt/workflows/<workflowName>/v2.json
+ *   ...
+ *
+ * Primary purpose: replay a failed run against the exact workflow definition
+ * that was used — not against a potentially-modified current version.
+ *
+ * All methods are non-fatal (errors are swallowed) — the store must never
+ * interrupt actual workflow execution.
+ *
+ * @module storage
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync, rmSync, } from 'node:fs';
+import { join } from 'node:path';
+// ─── WorkflowStore ────────────────────────────────────────────────────────────
+/**
+ * File-based workflow definition store.
+ *
+ * Stores multiple versions of each workflow definition so a failed execution
+ * can always be replayed against the exact definition that produced it.
+ *
+ * An in-memory cache for the latest version of each workflow avoids
+ * re-reading the file on every `save()` call.
+ */
+export class WorkflowStore {
+    dir;
+    /** Cache: workflowId → latest saved version number */
+    latestVersionCache = new Map();
+    constructor(dir) {
+        this.dir = dir;
+    }
+    // ─── Write API ─────────────────────────────────────────────────────────────
+    /**
+     * Save a workflow definition.
+     * A new version file is created on each call; the version number is
+     * determined by inspecting existing files (or the cache).
+     */
+    save(workflow) {
+        try {
+            const workflowId = this._resolveId(workflow);
+            const workflowDir = join(this.dir, workflowId);
+            mkdirSync(workflowDir, { recursive: true });
+            const nextVersion = this._nextVersion(workflowId, workflowDir);
+            const record = {
+                workflowId,
+                version: nextVersion,
+                savedAt: new Date().toISOString(),
+                definition: workflow,
+            };
+            writeFileSync(join(workflowDir, `v${nextVersion}.json`), JSON.stringify(record, null, 2), 'utf-8');
+            this.latestVersionCache.set(workflowId, nextVersion);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // ─── Read API ──────────────────────────────────────────────────────────────
+    /**
+     * Load the most recently saved version of a workflow.
+     * Returns null if the workflow has never been saved.
+     */
+    loadLatest(workflowId) {
+        try {
+            const versions = this.listVersions(workflowId);
+            if (versions.length === 0)
+                return null;
+            return this._readVersion(workflowId, versions[0]);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load a specific version of a workflow.
+     * When `version` is omitted the latest version is returned.
+     */
+    load(workflowId, version) {
+        try {
+            if (version === undefined)
+                return this.loadLatest(workflowId);
+            return this._readVersion(workflowId, version);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Return all saved version numbers for a workflow, sorted newest-first.
+     */
+    listVersions(workflowId) {
+        try {
+            const workflowDir = join(this.dir, workflowId);
+            if (!existsSync(workflowDir))
+                return [];
+            return readdirSync(workflowDir)
+                .filter(f => /^v\d+\.json$/.test(f))
+                .map(f => parseInt(f.slice(1, -5), 10))
+                .sort((a, b) => b - a); // newest first
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Return all workflow IDs that have at least one saved version.
+     */
+    list() {
+        try {
+            mkdirSync(this.dir, { recursive: true });
+            return readdirSync(this.dir, { withFileTypes: true })
+                .filter(e => e.isDirectory())
+                .map(e => e.name)
+                .sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Delete a specific version of a workflow, or all versions if `version`
+     * is omitted (removes the entire workflow subdirectory).
+     */
+    delete(workflowId, version) {
+        try {
+            if (version !== undefined) {
+                const filePath = join(this.dir, workflowId, `v${version}.json`);
+                if (existsSync(filePath))
+                    rmSync(filePath);
+                // Invalidate cache if we deleted the latest version
+                if (this.latestVersionCache.get(workflowId) === version) {
+                    this.latestVersionCache.delete(workflowId);
+                }
+            }
+            else {
+                const workflowDir = join(this.dir, workflowId);
+                if (existsSync(workflowDir))
+                    rmSync(workflowDir, { recursive: true });
+                this.latestVersionCache.delete(workflowId);
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // ─── Internal helpers ──────────────────────────────────────────────────────
+    /** Derive a stable ID from the workflow — prefer `name`, fallback to `metadata.name`. */
+    _resolveId(workflow) {
+        const raw = workflow.name ?? workflow.metadata?.name ?? 'unnamed';
+        // Sanitise for use as a directory name (keep alphanumeric, hyphen, underscore, dot)
+        return raw.replace(/[^a-zA-Z0-9._-]/g, '_');
+    }
+    /**
+     * Calculate the next version number.
+     * Reads the cache first; if not cached, scans the directory.
+     */
+    _nextVersion(workflowId, workflowDir) {
+        const cached = this.latestVersionCache.get(workflowId);
+        if (cached !== undefined)
+            return cached + 1;
+        try {
+            const existing = readdirSync(workflowDir)
+                .filter(f => /^v\d+\.json$/.test(f))
+                .map(f => parseInt(f.slice(1, -5), 10));
+            return existing.length === 0 ? 1 : Math.max(...existing) + 1;
+        }
+        catch {
+            return 1;
+        }
+    }
+    _readVersion(workflowId, version) {
+        const filePath = join(this.dir, workflowId, `v${version}.json`);
+        if (!existsSync(filePath))
+            return null;
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+}
 //# sourceMappingURL=WorkflowStore.js.map

package/dist/storage/WorkflowStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkflowStore.js","sourceRoot":"","sources":["../../src/storage/WorkflowStore.ts"],"names":[],"mappings":""}
+{"version":3,"file":"WorkflowStore.js","sourceRoot":"","sources":["../../src/storage/WorkflowStore.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+export * from './ExecutionStore.js';
+export * from './ScheduleStore.js';
+export * from './WorkflowStore.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/storage/index.js

@@ -1,5 +1,4 @@
-export {};
-// export * from './ExecutionStore.js';
-// export * from './ScheduleStore.js';
-// export * from './WorkflowStore.js';
+export * from './ExecutionStore.js';
+export * from './ScheduleStore.js';
+export * from './WorkflowStore.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,sCAAsC;AACtC,sCAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/types/core-types.d.ts

@@ -749,6 +749,8 @@ export interface ParsedStep {
 export interface WorkflowResult {
     /** Workflow name */
     workflowName: string;
+    /** Unique execution identifier */
+    executionId: string;
     /** Overall status */
     status: 'success' | 'failure' | 'partial' | 'timeout';
     /** All step results */