@action-llama/action-llama 0.15.0 → 0.17.0

package/dist/shared/persistence/event-store.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Event sourcing utilities and helpers.
+ *
+ * Provides event versioning, schema evolution helpers, and common event patterns
+ * used throughout the Action Llama system.
+ */
+import type { Event, EventStream } from "./index.js";
+/** Common event types used across the system */
+export declare namespace EventTypes {
+    const RUN_STARTED = "run.started";
+    const RUN_COMPLETED = "run.completed";
+    const RUN_FAILED = "run.failed";
+    const CALL_INITIATED = "call.initiated";
+    const CALL_COMPLETED = "call.completed";
+    const CALL_FAILED = "call.failed";
+    const WORK_QUEUED = "work.queued";
+    const WORK_DEQUEUED = "work.dequeued";
+    const WORK_DROPPED = "work.dropped";
+    const LOCK_ACQUIRED = "lock.acquired";
+    const LOCK_RELEASED = "lock.released";
+    const LOCK_EXPIRED = "lock.expired";
+    const SESSION_CREATED = "session.created";
+    const SESSION_EXPIRED = "session.expired";
+}
+/** Event metadata standard fields */
+export interface EventMetadata {
+    /** Source system/component that generated the event */
+    source?: string;
+    /** Correlation ID for tracing related events */
+    correlationId?: string;
+    /** User or system that triggered the event */
+    actor?: string;
+    /** Additional tags for filtering/grouping */
+    tags?: string[];
+}
+/** Helper for creating events with proper defaults */
+export declare function createEvent(type: string, data: any, metadata?: EventMetadata, version?: number): Omit<Event, 'id' | 'timestamp'>;
+/** Schema evolution helper */
+export interface EventMigration {
+    fromVersion: number;
+    toVersion: number;
+    migrate: (event: Event) => Event;
+}
+export declare class EventMigrator {
+    private migrations;
+    addMigration(eventType: string, migration: EventMigration): void;
+    migrate(event: Event, targetVersion: number): Event;
+}
+/** Event stream wrapper with additional utilities */
+export declare class EventStreamWrapper {
+    private stream;
+    constructor(stream: EventStream);
+    /** Append a typed event */
+    appendTyped<T>(type: string, data: T, metadata?: EventMetadata, version?: number): Promise<Event>;
+    /** Replay events from the stream */
+    replay(query?: import("./index.js").EventQuery): AsyncIterable<Event>;
+    /** Get snapshot from the stream */
+    getSnapshot<T>(type: string): Promise<T | null>;
+    /** Save snapshot to the stream */
+    saveSnapshot<T>(type: string, data: T, eventId: string): Promise<void>;
+    /** Replay events of a specific type */
+    replayType<T>(type: string, from?: number, to?: number): AsyncIterable<Event & {
+        data: T;
+    }>;
+    /** Build a projection from events */
+    buildProjection<T>(initialState: T, reducer: (state: T, event: Event) => T, from?: number): Promise<T>;
+    /** Get the latest event of a specific type */
+    getLatestEvent(type: string): Promise<Event | null>;
+}
+/** Common projection builders */
+export declare namespace Projections {
+    /** Count events by type */
+    function eventCounts(events: AsyncIterable<Event>): Promise<Map<string, number>>;
+    /** Group events by time window */
+    function timeWindow(events: AsyncIterable<Event>, windowMs: number): Promise<Map<number, Event[]>>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/shared/persistence/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../../src/shared/persistence/event-store.ts"],"names":[],"mappings":"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"}

package/dist/shared/persistence/event-store.js

@@ -0,0 +1,139 @@
+/**
+ * Event sourcing utilities and helpers.
+ *
+ * Provides event versioning, schema evolution helpers, and common event patterns
+ * used throughout the Action Llama system.
+ */
+/** Common event types used across the system */
+export var EventTypes;
+(function (EventTypes) {
+    // Run lifecycle events
+    EventTypes.RUN_STARTED = "run.started";
+    EventTypes.RUN_COMPLETED = "run.completed";
+    EventTypes.RUN_FAILED = "run.failed";
+    // Call events 
+    EventTypes.CALL_INITIATED = "call.initiated";
+    EventTypes.CALL_COMPLETED = "call.completed";
+    EventTypes.CALL_FAILED = "call.failed";
+    // Work queue events
+    EventTypes.WORK_QUEUED = "work.queued";
+    EventTypes.WORK_DEQUEUED = "work.dequeued";
+    EventTypes.WORK_DROPPED = "work.dropped";
+    // Lock events
+    EventTypes.LOCK_ACQUIRED = "lock.acquired";
+    EventTypes.LOCK_RELEASED = "lock.released";
+    EventTypes.LOCK_EXPIRED = "lock.expired";
+    // Session events
+    EventTypes.SESSION_CREATED = "session.created";
+    EventTypes.SESSION_EXPIRED = "session.expired";
+})(EventTypes || (EventTypes = {}));
+/** Helper for creating events with proper defaults */
+export function createEvent(type, data, metadata, version = 1) {
+    return {
+        type,
+        data,
+        metadata: {
+            ...metadata,
+            source: "action-llama", // Always use consistent source for audit purposes
+        },
+        version,
+    };
+}
+export class EventMigrator {
+    migrations = new Map();
+    addMigration(eventType, migration) {
+        if (!this.migrations.has(eventType)) {
+            this.migrations.set(eventType, []);
+        }
+        this.migrations.get(eventType).push(migration);
+    }
+    migrate(event, targetVersion) {
+        const migrations = this.migrations.get(event.type) || [];
+        let currentEvent = { ...event };
+        while (currentEvent.version < targetVersion) {
+            const migration = migrations.find(m => m.fromVersion === currentEvent.version);
+            if (!migration) {
+                throw new Error(`No migration found for ${event.type} from version ${currentEvent.version}`);
+            }
+            currentEvent = migration.migrate(currentEvent);
+        }
+        return currentEvent;
+    }
+}
+/** Event stream wrapper with additional utilities */
+export class EventStreamWrapper {
+    stream;
+    constructor(stream) {
+        this.stream = stream;
+    }
+    /** Append a typed event */
+    async appendTyped(type, data, metadata, version = 1) {
+        return this.stream.append(createEvent(type, data, metadata, version));
+    }
+    /** Replay events from the stream */
+    replay(query) {
+        return this.stream.replay(query);
+    }
+    /** Get snapshot from the stream */
+    getSnapshot(type) {
+        return this.stream.getSnapshot(type);
+    }
+    /** Save snapshot to the stream */
+    saveSnapshot(type, data, eventId) {
+        return this.stream.saveSnapshot(type, data, eventId);
+    }
+    /** Replay events of a specific type */
+    async *replayType(type, from, to) {
+        for await (const event of this.stream.replay({ type, from, to })) {
+            yield event;
+        }
+    }
+    /** Build a projection from events */
+    async buildProjection(initialState, reducer, from) {
+        let state = initialState;
+        for await (const event of this.stream.replay({ from })) {
+            state = reducer(state, event);
+        }
+        return state;
+    }
+    /** Get the latest event of a specific type */
+    async getLatestEvent(type) {
+        const events = [];
+        for await (const event of this.stream.replay({ type, limit: 1 })) {
+            events.push(event);
+        }
+        return events[0] || null;
+    }
+}
+/** Common projection builders */
+export var Projections;
+(function (Projections) {
+    /** Count events by type */
+    function eventCounts(events) {
+        return buildProjectionFromIterable(events, new Map(), (counts, event) => {
+            counts.set(event.type, (counts.get(event.type) || 0) + 1);
+            return counts;
+        });
+    }
+    Projections.eventCounts = eventCounts;
+    /** Group events by time window */
+    function timeWindow(events, windowMs) {
+        return buildProjectionFromIterable(events, new Map(), (windows, event) => {
+            const window = Math.floor(event.timestamp / windowMs) * windowMs;
+            if (!windows.has(window)) {
+                windows.set(window, []);
+            }
+            windows.get(window).push(event);
+            return windows;
+        });
+    }
+    Projections.timeWindow = timeWindow;
+})(Projections || (Projections = {}));
+async function buildProjectionFromIterable(events, initialState, reducer) {
+    let state = initialState;
+    for await (const event of events) {
+        state = reducer(state, event);
+    }
+    return state;
+}
+//# sourceMappingURL=event-store.js.map

package/dist/shared/persistence/event-store.js.map

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

package/dist/shared/persistence/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Unified persistence layer combining key-value storage, event sourcing, and query capabilities.
+ *
+ * Replaces the fragmented StateStore/StatsStore/WorkQueue pattern with a single abstraction
+ * that supports namespaces, TTL, and append-only event storage for features like replay,
+ * audit, and high availability.
+ */
+export interface Event {
+    /** Unique event identifier */
+    id: string;
+    /** Event type/category */
+    type: string;
+    /** Event data payload */
+    data: any;
+    /** Event metadata (source, correlation id, etc.) */
+    metadata?: Record<string, any>;
+    /** Event timestamp (milliseconds since epoch) */
+    timestamp: number;
+    /** Event version for schema evolution */
+    version: number;
+}
+export interface EventQuery {
+    /** Event type filter */
+    type?: string;
+    /** Start timestamp (inclusive) */
+    from?: number;
+    /** End timestamp (exclusive) */
+    to?: number;
+    /** Maximum number of events to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+export interface EventStream {
+    /** Append an event to the stream */
+    append(event: Omit<Event, 'id' | 'timestamp'>): Promise<Event>;
+    /** Replay events from the stream */
+    replay(query?: EventQuery): AsyncIterable<Event>;
+    /** Get the latest snapshot for a given type */
+    getSnapshot<T>(type: string): Promise<T | null>;
+    /** Save a snapshot to optimize future replays */
+    saveSnapshot<T>(type: string, data: T, eventId: string): Promise<void>;
+    /** Subscribe to new events (optional - for real-time features) */
+    subscribe?(callback: (event: Event) => void): () => void;
+}
+export interface PersistenceStore {
+    /** Key-value operations with namespacing */
+    kv: {
+        /** Get a value by namespace and key */
+        get<T>(namespace: string, key: string): Promise<T | null>;
+        /** Set a value with optional TTL */
+        set<T>(namespace: string, key: string, value: T, opts?: {
+            ttl?: number;
+        }): Promise<void>;
+        /** Delete a single key */
+        delete(namespace: string, key: string): Promise<void>;
+        /** Delete all keys in a namespace */
+        deleteAll(namespace: string): Promise<void>;
+        /** List all non-expired entries in a namespace */
+        list<T>(namespace: string): Promise<Array<{
+            key: string;
+            value: T;
+        }>>;
+    };
+    /** Event sourcing operations */
+    events: {
+        /** Get or create an event stream */
+        stream(name: string): EventStream;
+        /** List available streams */
+        listStreams(): Promise<string[]>;
+    };
+    /** Query operations for analytics */
+    query: {
+        /** Execute a SQL query for analytics (backend-specific) */
+        sql<T>(query: string, params?: any[]): Promise<T[]>;
+    };
+    /** Transaction operations */
+    transaction<T>(fn: (store: PersistenceStore) => Promise<T>): Promise<T>;
+    /** Close the store and release resources */
+    close(): Promise<void>;
+}
+export interface PersistenceBackend {
+    /** Initialize the backend (create tables, etc.) */
+    init(): Promise<void>;
+    /** Implement the key-value operations */
+    kvGet<T>(namespace: string, key: string): Promise<T | null>;
+    kvSet<T>(namespace: string, key: string, value: T, ttlMs?: number): Promise<void>;
+    kvDelete(namespace: string, key: string): Promise<void>;
+    kvDeleteAll(namespace: string): Promise<void>;
+    kvList<T>(namespace: string): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /** Implement the event operations */
+    eventAppend(stream: string, event: Omit<Event, 'id' | 'timestamp'>): Promise<Event>;
+    eventReplay(stream: string, query?: EventQuery): AsyncIterable<Event>;
+    eventGetSnapshot<T>(stream: string, type: string): Promise<T | null>;
+    eventSaveSnapshot<T>(stream: string, type: string, data: T, eventId: string): Promise<void>;
+    eventListStreams(): Promise<string[]>;
+    /** Implement query operations */
+    querySql<T>(query: string, params?: any[]): Promise<T[]>;
+    /** Implement transaction operations */
+    transactionBegin(): Promise<void>;
+    transactionCommit(): Promise<void>;
+    transactionRollback(): Promise<void>;
+    transactionRun<T>(fn: () => Promise<T>): Promise<T>;
+    /** Close and cleanup */
+    close(): Promise<void>;
+}
+export interface PersistenceConfig {
+    type: "sqlite" | "memory";
+    path?: string;
+    maxSize?: number;
+}
+/**
+ * Create a persistence store from configuration.
+ */
+export declare function createPersistenceStore(config: PersistenceConfig): Promise<PersistenceStore>;
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/persistence/index.ts"],"names":[],"mappings":"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"}

package/dist/shared/persistence/index.js

@@ -0,0 +1,93 @@
+/**
+ * Unified persistence layer combining key-value storage, event sourcing, and query capabilities.
+ *
+ * Replaces the fragmented StateStore/StatsStore/WorkQueue pattern with a single abstraction
+ * that supports namespaces, TTL, and append-only event storage for features like replay,
+ * audit, and high availability.
+ */
+/**
+ * Create a persistence store from configuration.
+ */
+export async function createPersistenceStore(config) {
+    let backend;
+    switch (config.type) {
+        case "sqlite":
+            const { SqliteBackend } = await import("./backends/sqlite.js");
+            backend = new SqliteBackend(config.path || ":memory:");
+            break;
+        case "memory":
+            const { MemoryBackend } = await import("./backends/memory.js");
+            backend = new MemoryBackend(config.maxSize);
+            break;
+        default:
+            throw new Error(`Unsupported persistence backend: ${config.type}`);
+    }
+    await backend.init();
+    return new PersistenceStoreImpl(backend);
+}
+/**
+ * Implementation of PersistenceStore that delegates to a backend.
+ */
+class PersistenceStoreImpl {
+    backend;
+    streams = new Map();
+    constructor(backend) {
+        this.backend = backend;
+    }
+    get kv() {
+        return {
+            get: (namespace, key) => this.backend.kvGet(namespace, key),
+            set: (namespace, key, value, opts) => this.backend.kvSet(namespace, key, value, opts?.ttl ? opts.ttl * 1000 : undefined),
+            delete: (namespace, key) => this.backend.kvDelete(namespace, key),
+            deleteAll: (namespace) => this.backend.kvDeleteAll(namespace),
+            list: (namespace) => this.backend.kvList(namespace),
+        };
+    }
+    get events() {
+        return {
+            stream: (name) => {
+                if (!this.streams.has(name)) {
+                    this.streams.set(name, new EventStreamImpl(name, this.backend));
+                }
+                return this.streams.get(name);
+            },
+            listStreams: () => this.backend.eventListStreams(),
+        };
+    }
+    get query() {
+        return {
+            sql: (query, params) => this.backend.querySql(query, params),
+        };
+    }
+    async transaction(fn) {
+        return this.backend.transactionRun(() => fn(this));
+    }
+    async close() {
+        await this.backend.close();
+        this.streams.clear();
+    }
+}
+/**
+ * Implementation of EventStream that delegates to a backend.
+ */
+class EventStreamImpl {
+    name;
+    backend;
+    constructor(name, backend) {
+        this.name = name;
+        this.backend = backend;
+    }
+    append(event) {
+        return this.backend.eventAppend(this.name, event);
+    }
+    replay(query) {
+        return this.backend.eventReplay(this.name, query);
+    }
+    getSnapshot(type) {
+        return this.backend.eventGetSnapshot(this.name, type);
+    }
+    saveSnapshot(type, data, eventId) {
+        return this.backend.eventSaveSnapshot(this.name, type, data, eventId);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/shared/persistence/index.js.map

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

package/dist/shared/persistence/migration.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Migration utilities for transitioning from legacy StateStore/StatsStore to unified persistence.
+ *
+ * Provides atomic migration with rollback support and progress reporting.
+ */
+import type { StateStore } from "../state-store.js";
+import type { StatsStore } from "../../stats/store.js";
+import type { PersistenceStore } from "./index.js";
+export interface MigrationProgress {
+    /** Current step being performed */
+    step: string;
+    /** Number of items processed */
+    processed: number;
+    /** Total items to process */
+    total: number;
+    /** Estimated completion percentage */
+    percentage: number;
+}
+export interface MigrationOptions {
+    /** Progress callback */
+    onProgress?: (progress: MigrationProgress) => void;
+    /** Batch size for processing large datasets */
+    batchSize?: number;
+    /** Whether to preserve original data after migration */
+    preserveOriginal?: boolean;
+}
+export declare class LegacyMigrator {
+    private newStore;
+    constructor(newStore: PersistenceStore);
+    /**
+     * Migrate from legacy StateStore to new persistence layer.
+     */
+    migrateStateStore(legacyStore: StateStore, options?: MigrationOptions): Promise<void>;
+    /**
+     * Migrate from legacy StatsStore to event-sourced analytics.
+     */
+    migrateStatsStore(legacyStore: StatsStore, options?: MigrationOptions): Promise<void>;
+    /**
+     * Perform complete migration from all legacy stores.
+     */
+    migrateAll(legacyStateStore?: StateStore, legacyStatsStore?: StatsStore, options?: MigrationOptions): Promise<void>;
+}
+/**
+ * Helper function to run migration with console progress reporting.
+ */
+export declare function migrateFromLegacy(newStore: PersistenceStore, legacyStateStore?: StateStore, legacyStatsStore?: StatsStore, options?: Omit<MigrationOptions, 'onProgress'>): Promise<void>;
+//# sourceMappingURL=migration.d.ts.map

package/dist/shared/persistence/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../../src/shared/persistence/migration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAA6B,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAE9C;;OAEG;IACG,iBAAiB,CACrB,WAAW,EAAE,UAAU,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAiFhB;;OAEG;IACG,iBAAiB,CACrB,WAAW,EAAE,UAAU,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAsLhB;;OAEG;IACG,UAAU,CACd,gBAAgB,CAAC,EAAE,UAAU,EAC7B,gBAAgB,CAAC,EAAE,UAAU,EAC7B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;CA4EjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,CAAC,EAAE,UAAU,EAC7B,gBAAgB,CAAC,EAAE,UAAU,EAC7B,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAM,GACjD,OAAO,CAAC,IAAI,CAAC,CASf"}