@action-llama/action-llama 0.14.1 → 0.16.0

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"}

package/dist/shared/persistence/migration.js

@@ -0,0 +1,297 @@
+/**
+ * Migration utilities for transitioning from legacy StateStore/StatsStore to unified persistence.
+ *
+ * Provides atomic migration with rollback support and progress reporting.
+ */
+import { createEvent, EventTypes } from "./event-store.js";
+export class LegacyMigrator {
+    newStore;
+    constructor(newStore) {
+        this.newStore = newStore;
+    }
+    /**
+     * Migrate from legacy StateStore to new persistence layer.
+     */
+    async migrateStateStore(legacyStore, options = {}) {
+        const { onProgress, preserveOriginal = true } = options;
+        // Get all namespaces by querying common ones
+        const commonNamespaces = ["locks", "lock-holders", "sessions", "calls", "containers"];
+        let totalItems = 0;
+        const namespaceData = new Map();
+        // Count total items first
+        for (const namespace of commonNamespaces) {
+            try {
+                const items = await legacyStore.list(namespace);
+                namespaceData.set(namespace, items);
+                totalItems += items.length;
+            }
+            catch (error) {
+                // Namespace might not exist, skip
+                continue;
+            }
+        }
+        if (totalItems === 0) {
+            onProgress?.({ step: "No data to migrate", processed: 0, total: 0, percentage: 100 });
+            return;
+        }
+        let processed = 0;
+        await this.newStore.transaction(async (store) => {
+            for (const [namespace, items] of namespaceData) {
+                onProgress?.({
+                    step: `Migrating namespace: ${namespace}`,
+                    processed,
+                    total: totalItems,
+                    percentage: Math.floor((processed / totalItems) * 100),
+                });
+                for (const item of items) {
+                    await store.kv.set(namespace, item.key, item.value);
+                    // Create audit event for the migration
+                    await store.events.stream("migration").append(createEvent("state.migrated", {
+                        namespace,
+                        key: item.key,
+                        source: "legacy-state-store",
+                    }, {
+                        source: "migrator",
+                        tags: ["migration", "state-store"],
+                    }));
+                    processed++;
+                    if (processed % 100 === 0) {
+                        onProgress?.({
+                            step: `Migrating namespace: ${namespace}`,
+                            processed,
+                            total: totalItems,
+                            percentage: Math.floor((processed / totalItems) * 100),
+                        });
+                    }
+                }
+            }
+            onProgress?.({
+                step: "Migration completed",
+                processed: totalItems,
+                total: totalItems,
+                percentage: 100,
+            });
+        });
+        if (!preserveOriginal) {
+            for (const namespace of namespaceData.keys()) {
+                await legacyStore.deleteAll(namespace);
+            }
+        }
+    }
+    /**
+     * Migrate from legacy StatsStore to event-sourced analytics.
+     */
+    async migrateStatsStore(legacyStore, options = {}) {
+        const { onProgress, batchSize = 1000, preserveOriginal = true } = options;
+        // Migration is complex because we need to convert SQL data to events
+        // We'll query the runs and call_edges tables and convert them to events
+        let processed = 0;
+        onProgress?.({
+            step: "Counting historical data",
+            processed: 0,
+            total: 0,
+            percentage: 0,
+        });
+        // Use direct SQL to get all data efficiently
+        const runs = await this.newStore.query.sql("SELECT * FROM runs ORDER BY started_at ASC").catch(() => []); // Table might not exist
+        const callEdges = await this.newStore.query.sql("SELECT * FROM call_edges ORDER BY started_at ASC").catch(() => []);
+        const totalItems = runs.length + callEdges.length;
+        if (totalItems === 0) {
+            onProgress?.({ step: "No stats data to migrate", processed: 0, total: 0, percentage: 100 });
+            return;
+        }
+        await this.newStore.transaction(async (store) => {
+            const statsStream = store.events.stream("stats");
+            // Migrate run records to events
+            onProgress?.({
+                step: "Migrating run records",
+                processed,
+                total: totalItems,
+                percentage: Math.floor((processed / totalItems) * 100),
+            });
+            for (const run of runs) {
+                // Convert to run started event
+                await statsStream.append(createEvent(EventTypes.RUN_STARTED, {
+                    instanceId: run.instance_id,
+                    agentName: run.agent_name,
+                    triggerType: run.trigger_type,
+                    triggerSource: run.trigger_source,
+                }, {
+                    source: "migrator",
+                    correlationId: run.instance_id,
+                    tags: ["migration", "stats"],
+                }));
+                // Convert to run completed/failed event
+                const eventType = run.result === "error" ? EventTypes.RUN_FAILED : EventTypes.RUN_COMPLETED;
+                await statsStream.append(createEvent(eventType, {
+                    instanceId: run.instance_id,
+                    agentName: run.agent_name,
+                    result: run.result,
+                    exitCode: run.exit_code,
+                    durationMs: run.duration_ms,
+                    inputTokens: run.input_tokens,
+                    outputTokens: run.output_tokens,
+                    cacheReadTokens: run.cache_read_tokens,
+                    cacheWriteTokens: run.cache_write_tokens,
+                    totalTokens: run.total_tokens,
+                    costUsd: run.cost_usd,
+                    turnCount: run.turn_count,
+                    errorMessage: run.error_message,
+                    preHookMs: run.pre_hook_ms,
+                    postHookMs: run.post_hook_ms,
+                }, {
+                    source: "migrator",
+                    correlationId: run.instance_id,
+                    tags: ["migration", "stats"],
+                }));
+                processed++;
+                if (processed % 100 === 0) {
+                    onProgress?.({
+                        step: "Migrating run records",
+                        processed,
+                        total: totalItems,
+                        percentage: Math.floor((processed / totalItems) * 100),
+                    });
+                }
+            }
+            // Migrate call edge records to events
+            onProgress?.({
+                step: "Migrating call records",
+                processed,
+                total: totalItems,
+                percentage: Math.floor((processed / totalItems) * 100),
+            });
+            for (const call of callEdges) {
+                // Convert to call initiated event
+                await statsStream.append(createEvent(EventTypes.CALL_INITIATED, {
+                    callerAgent: call.caller_agent,
+                    callerInstance: call.caller_instance,
+                    targetAgent: call.target_agent,
+                    targetInstance: call.target_instance,
+                    depth: call.depth,
+                }, {
+                    source: "migrator",
+                    correlationId: call.caller_instance,
+                    tags: ["migration", "stats"],
+                }));
+                // Convert to call completed/failed event if finished
+                if (call.duration_ms !== null) {
+                    const eventType = call.status === "error" ? EventTypes.CALL_FAILED : EventTypes.CALL_COMPLETED;
+                    await statsStream.append(createEvent(eventType, {
+                        callerAgent: call.caller_agent,
+                        callerInstance: call.caller_instance,
+                        targetAgent: call.target_agent,
+                        targetInstance: call.target_instance,
+                        depth: call.depth,
+                        durationMs: call.duration_ms,
+                        status: call.status,
+                    }, {
+                        source: "migrator",
+                        correlationId: call.caller_instance,
+                        tags: ["migration", "stats"],
+                    }));
+                }
+                processed++;
+                if (processed % 100 === 0) {
+                    onProgress?.({
+                        step: "Migrating call records",
+                        processed,
+                        total: totalItems,
+                        percentage: Math.floor((processed / totalItems) * 100),
+                    });
+                }
+            }
+            // Create a migration completed event
+            await store.events.stream("migration").append(createEvent("stats.migrated", {
+                runsCount: runs.length,
+                callEdgesCount: callEdges.length,
+                source: "legacy-stats-store",
+            }, {
+                source: "migrator",
+                tags: ["migration", "stats-store"],
+            }));
+            onProgress?.({
+                step: "Migration completed",
+                processed: totalItems,
+                total: totalItems,
+                percentage: 100,
+            });
+        });
+    }
+    /**
+     * Perform complete migration from all legacy stores.
+     */
+    async migrateAll(legacyStateStore, legacyStatsStore, options = {}) {
+        const { onProgress } = options;
+        onProgress?.({
+            step: "Starting complete migration",
+            processed: 0,
+            total: 100,
+            percentage: 0,
+        });
+        try {
+            if (legacyStateStore) {
+                onProgress?.({
+                    step: "Migrating state store",
+                    processed: 25,
+                    total: 100,
+                    percentage: 25,
+                });
+                await this.migrateStateStore(legacyStateStore, {
+                    ...options,
+                    onProgress: undefined, // Don't double-report
+                });
+            }
+            if (legacyStatsStore) {
+                onProgress?.({
+                    step: "Migrating stats store",
+                    processed: 50,
+                    total: 100,
+                    percentage: 50,
+                });
+                await this.migrateStatsStore(legacyStatsStore, {
+                    ...options,
+                    onProgress: undefined, // Don't double-report
+                });
+            }
+            // Create final migration marker
+            await this.newStore.events.stream("migration").append(createEvent("migration.completed", {
+                timestamp: Date.now(),
+                version: "1.0.0",
+            }, {
+                source: "migrator",
+                tags: ["migration", "completion"],
+            }));
+            onProgress?.({
+                step: "All migrations completed",
+                processed: 100,
+                total: 100,
+                percentage: 100,
+            });
+        }
+        catch (error) {
+            // Create error event
+            await this.newStore.events.stream("migration").append(createEvent("migration.failed", {
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: Date.now(),
+            }, {
+                source: "migrator",
+                tags: ["migration", "error"],
+            }));
+            throw error;
+        }
+    }
+}
+/**
+ * Helper function to run migration with console progress reporting.
+ */
+export async function migrateFromLegacy(newStore, legacyStateStore, legacyStatsStore, options = {}) {
+    const migrator = new LegacyMigrator(newStore);
+    await migrator.migrateAll(legacyStateStore, legacyStatsStore, {
+        ...options,
+        onProgress: (progress) => {
+            console.log(`Migration: ${progress.step} (${progress.percentage}%)`);
+        },
+    });
+}
+//# sourceMappingURL=migration.js.map

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

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

package/dist/shared/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,UAAU,CAU1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAUtE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAU3C"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,UAAU,CAqE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAUtE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAU3C"}

package/dist/shared/usage.js

@@ -2,14 +2,59 @@
  * Convert pi-ai SDK SessionStats to our TokenUsage format
  */
 export function sessionStatsToUsage(stats) {
+    // Handle null/undefined stats
+    if (!stats) {
+        return zeroTokenUsage();
+    }
+    // Try multiple possible paths for input tokens
+    const inputTokens = stats.usage?.input ?? // Current working format (OpenAI)
+        stats.inputTokens ?? // Direct property
+        stats.metrics?.input_tokens ?? // Metrics object  
+        stats.usageMetrics?.inputTokens ?? // Usage metrics object
+        stats.anthropic?.usage?.input_tokens ?? // Provider-specific format
+        0;
+    // Try multiple possible paths for output tokens  
+    const outputTokens = stats.usage?.output ?? // Current working format (OpenAI)
+        stats.outputTokens ?? // Direct property
+        stats.metrics?.output_tokens ?? // Metrics object
+        stats.usageMetrics?.outputTokens ?? // Usage metrics object  
+        stats.anthropic?.usage?.output_tokens ?? // Provider-specific format
+        0;
+    // Try multiple possible paths for cache read tokens
+    const cacheReadTokens = stats.usage?.cacheRead ?? // Current working format (OpenAI)
+        stats.cacheReadTokens ?? // Direct property
+        stats.metrics?.cache_read_tokens ?? // Metrics object
+        stats.usageMetrics?.cacheReadTokens ?? // Usage metrics object
+        stats.anthropic?.usage?.cache_read_input_tokens ?? // Anthropic cache format
+        0;
+    // Try multiple possible paths for cache write tokens  
+    const cacheWriteTokens = stats.usage?.cacheWrite ?? // Current working format (OpenAI) 
+        stats.cacheWriteTokens ?? // Direct property
+        stats.metrics?.cache_write_tokens ?? // Metrics object
+        stats.usageMetrics?.cacheWriteTokens ?? // Usage metrics object
+        stats.anthropic?.usage?.cache_creation_input_tokens ?? // Anthropic cache format
+        0;
+    // Calculate total tokens if not provided
+    const totalTokens = stats.usage?.totalTokens ?? // Provided total
+        stats.totalTokens ?? // Direct property
+        stats.metrics?.total_tokens ?? // Metrics object
+        inputTokens + outputTokens; // Fallback calculation
+    // Try multiple possible paths for cost
+    const cost = stats.usage?.cost?.total ?? // Current working format  
+        stats.cost ?? // Direct property
+        stats.metrics?.cost ?? // Metrics object
+        stats.usageMetrics?.cost ?? // Usage metrics object
+        0;
+    // Turn count should be consistent across providers
+    const turnCount = stats.turnCount ?? 0;
     return {
-        inputTokens: stats.usage?.input ?? 0,
-        outputTokens: stats.usage?.output ?? 0,
-        cacheReadTokens: stats.usage?.cacheRead ?? 0,
-        cacheWriteTokens: stats.usage?.cacheWrite ?? 0,
-        totalTokens: stats.usage?.totalTokens ?? 0,
-        cost: stats.usage?.cost?.total ?? 0,
-        turnCount: stats.turnCount ?? 0,
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheWriteTokens,
+        totalTokens,
+        cost,
+        turnCount,
     };
 }
 /**

package/dist/shared/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAU;IAC5C,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC;QACpC,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;QACtC,eAAe,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC;QAC5C,gBAAgB,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;QAC9C,WAAW,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;QAC1C,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;QACnC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,CAAa,EAAE,CAAa;IACxD,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC7C,eAAe,EAAE,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe;QACtD,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QACzD,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,IAAI,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI;QACrB,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,CAAC;QACP,SAAS,EAAE,CAAC;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/shared/usage.ts"],"names":[],"mappings":"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"}

package/dist/shared/validation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Enhanced validation functions for Action Llama configurations.
+ * Provides schema validation, unknown field detection, cron validation,
+ * model/provider compatibility checks, and unsafe config warnings.
+ */
+import type { AgentConfig, GlobalConfig } from "./config.js";
+export interface ValidationError {
+    type: "error" | "warning";
+    message: string;
+    field?: string;
+    context?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+export interface ConfigSchema {
+    required: Set<string>;
+    optional: Set<string>;
+    nested: Record<string, ConfigSchema>;
+}
+/**
+ * Validate a cron expression using the croner library.
+ */
+export declare function validateCronExpression(schedule: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate model/provider/authType compatibility.
+ */
+export declare function validateModelProviderCompat(provider: string, model: string, authType: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate config against a schema and return validation errors.
+ */
+export declare function validateConfigSchema(config: unknown, schema: ConfigSchema, path?: string): ValidationResult;
+/**
+ * Detect unknown fields in config that are not in the schema.
+ */
+export declare function detectUnknownFields(config: unknown, schema: ConfigSchema, path?: string): string[];
+/**
+ * Validate global config with comprehensive checks.
+ */
+export declare function validateGlobalConfig(config: GlobalConfig, raw?: unknown): ValidationResult;
+/**
+ * Validate agent config with comprehensive checks.
+ */
+export declare function validateAgentConfig(config: AgentConfig, raw?: unknown): ValidationResult;
+/**
+ * Check for unknown fields in global config.
+ */
+export declare function detectGlobalConfigUnknownFields(raw: unknown): string[];
+/**
+ * Check for unknown fields in agent config.
+ */
+export declare function detectAgentConfigUnknownFields(raw: unknown): string[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/shared/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtC;AA4DD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAY3F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAoCpC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,IAAI,SAAK,GACR,gBAAgB,CA2ClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,IAAI,SAAK,GACR,MAAM,EAAE,CAwBV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAyC1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAsDxF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAErE"}