@action-llama/action-llama 0.15.0 → 0.17.0

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/validation.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 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;AAE1E,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;AAyED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAY3F;AAGD;;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,CAsB1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAuCxF;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"}

package/dist/shared/validation.js

@@ -0,0 +1,231 @@
+/**
+ * Enhanced validation functions for Action Llama configurations.
+ * Provides schema validation, unknown field detection, cron validation,
+ * model/provider compatibility checks, and unsafe config warnings.
+ */
+import { Cron } from "croner";
+// --- Schema definitions ---
+const GLOBAL_CONFIG_SCHEMA = {
+    required: new Set(),
+    optional: new Set([
+        "models", "local", "gateway", "webhooks", "telemetry",
+        "projectName", "maxReruns", "maxCallDepth", "maxTriggerDepth",
+        "webhookQueueSize", "workQueueSize", "resourceLockTimeout", "scale"
+    ]),
+    nested: {
+        models: {
+            required: new Set(),
+            optional: new Set(["provider", "model", "thinkingLevel", "authType"]),
+            nested: {}
+        },
+        local: {
+            required: new Set(),
+            optional: new Set(["enabled", "image", "memory", "cpus", "timeout"]),
+            nested: {}
+        },
+        gateway: {
+            required: new Set(),
+            optional: new Set(["port", "url"]),
+            nested: {}
+        },
+        telemetry: {
+            required: new Set(),
+            optional: new Set(["enabled", "provider", "endpoint", "serviceName", "headers", "samplingRate"]),
+            nested: {}
+        },
+    }
+};
+const AGENT_CONFIG_SCHEMA = {
+    required: new Set(["name", "credentials", "models"]),
+    optional: new Set([
+        "description", "schedule", "webhooks", "hooks", "params", "scale",
+        "timeout", "license", "compatibility"
+    ]),
+    nested: {
+        hooks: {
+            required: new Set(),
+            optional: new Set(["pre", "post"]),
+            nested: {}
+        },
+    }
+};
+/**
+ * Schema for raw SKILL.md YAML frontmatter (before resolution).
+ * `name` is derived from the directory name, and AL-specific fields
+ * like `credentials` and `models` live under `metadata`.
+ */
+const AGENT_FRONTMATTER_SCHEMA = {
+    required: new Set(),
+    optional: new Set(["description", "license", "compatibility", "metadata"]),
+    nested: {
+        metadata: {
+            required: new Set(["credentials", "models"]),
+            optional: new Set(["schedule", "webhooks", "hooks", "params", "scale", "timeout"]),
+            nested: {
+                hooks: {
+                    required: new Set(),
+                    optional: new Set(["pre", "post"]),
+                    nested: {}
+                },
+            }
+        },
+    }
+};
+/**
+ * Validate a cron expression using the croner library.
+ */
+export function validateCronExpression(schedule) {
+    try {
+        // Test by creating a Cron instance - if invalid, it will throw
+        const job = new Cron(schedule, { paused: true });
+        job.stop(); // Clean up immediately
+        return { valid: true };
+    }
+    catch (err) {
+        return {
+            valid: false,
+            error: err instanceof Error ? err.message : String(err)
+        };
+    }
+}
+/**
+ * Validate config against a schema and return validation errors.
+ */
+export function validateConfigSchema(config, schema, path = "") {
+    const errors = [];
+    const warnings = [];
+    if (typeof config !== "object" || config === null) {
+        errors.push({
+            type: "error",
+            message: "Configuration must be an object",
+            field: path
+        });
+        return { valid: false, errors, warnings };
+    }
+    const configObj = config;
+    // Check required fields
+    for (const field of schema.required) {
+        if (!(field in configObj)) {
+            errors.push({
+                type: "error",
+                message: `Required field "${field}" is missing`,
+                field: path ? `${path}.${field}` : field
+            });
+        }
+    }
+    // Validate nested objects
+    for (const [field, nestedSchema] of Object.entries(schema.nested)) {
+        if (field in configObj && configObj[field] != null) {
+            const nestedPath = path ? `${path}.${field}` : field;
+            if (typeof configObj[field] === "object") {
+                const nestedResult = validateConfigSchema(configObj[field], nestedSchema, nestedPath);
+                errors.push(...nestedResult.errors);
+                warnings.push(...nestedResult.warnings);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * Detect unknown fields in config that are not in the schema.
+ */
+export function detectUnknownFields(config, schema, path = "") {
+    const unknownFields = [];
+    if (typeof config !== "object" || config === null) {
+        return unknownFields;
+    }
+    const configObj = config;
+    const allowedFields = new Set([...schema.required, ...schema.optional, ...Object.keys(schema.nested)]);
+    for (const field of Object.keys(configObj)) {
+        const fieldPath = path ? `${path}.${field}` : field;
+        if (!allowedFields.has(field)) {
+            unknownFields.push(fieldPath);
+        }
+        else if (field in schema.nested && configObj[field] != null) {
+            // Recursively check nested objects
+            if (typeof configObj[field] === "object") {
+                unknownFields.push(...detectUnknownFields(configObj[field], schema.nested[field], fieldPath));
+            }
+        }
+    }
+    return unknownFields;
+}
+/**
+ * Validate global config with comprehensive checks.
+ */
+export function validateGlobalConfig(config, raw) {
+    const errors = [];
+    const warnings = [];
+    // Schema validation
+    if (raw) {
+        const schemaResult = validateConfigSchema(raw, GLOBAL_CONFIG_SCHEMA);
+        errors.push(...schemaResult.errors);
+        warnings.push(...schemaResult.warnings);
+    }
+    // Unsafe config warnings
+    if (config.gateway?.url?.includes("0.0.0.0")) {
+        warnings.push({
+            type: "warning",
+            message: "Gateway is bound to 0.0.0.0 (public interface). Consider using localhost for security.",
+            field: "gateway.url",
+            context: "unsafe configuration"
+        });
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validate agent config with comprehensive checks.
+ */
+export function validateAgentConfig(config, raw) {
+    const errors = [];
+    const warnings = [];
+    // Schema validation — raw is SKILL.md frontmatter (metadata-nested), not the resolved config
+    if (raw) {
+        const schemaResult = validateConfigSchema(raw, AGENT_FRONTMATTER_SCHEMA);
+        errors.push(...schemaResult.errors);
+        warnings.push(...schemaResult.warnings);
+    }
+    // Cron validation
+    if (config.schedule) {
+        const cronResult = validateCronExpression(config.schedule);
+        if (!cronResult.valid) {
+            errors.push({
+                type: "error",
+                message: `Invalid cron expression "${config.schedule}": ${cronResult.error}`,
+                field: "schedule",
+                context: "cron validation"
+            });
+        }
+    }
+    // pi_auth warning (already blocked at startup, but surface it in doctor too)
+    if (config.models) {
+        for (const [index, modelConfig] of config.models.entries()) {
+            if (modelConfig.authType === "pi_auth") {
+                warnings.push({
+                    type: "warning",
+                    message: `Model ${index} uses pi_auth which is not supported in container mode`,
+                    field: `models[${index}].authType`,
+                    context: "unsafe configuration"
+                });
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Check for unknown fields in global config.
+ */
+export function detectGlobalConfigUnknownFields(raw) {
+    return detectUnknownFields(raw, GLOBAL_CONFIG_SCHEMA);
+}
+/**
+ * Check for unknown fields in agent config.
+ */
+export function detectAgentConfigUnknownFields(raw) {
+    return detectUnknownFields(raw, AGENT_FRONTMATTER_SCHEMA);
+}
+//# sourceMappingURL=validation.js.map

package/dist/shared/validation.js.map

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

package/dist/shared/work-queue.d.ts

@@ -0,0 +1,17 @@
+export interface QueuedWorkItem<T> {
+    context: T;
+    receivedAt: Date;
+}
+export interface EnqueueResult<T> {
+    accepted: boolean;
+    dropped?: QueuedWorkItem<T>;
+}
+export interface WorkQueue<T> {
+    enqueue(agentName: string, context: T, receivedAt?: Date): EnqueueResult<T>;
+    dequeue(agentName: string): QueuedWorkItem<T> | undefined;
+    size(agentName: string): number;
+    clear(agentName: string): void;
+    clearAll(): void;
+    close(): void;
+}
+//# sourceMappingURL=work-queue.d.ts.map

package/dist/shared/work-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-queue.d.ts","sourceRoot":"","sources":["../../src/shared/work-queue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC1D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,IAAI,IAAI,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/shared/work-queue.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=work-queue.js.map

package/dist/shared/work-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-queue.js","sourceRoot":"","sources":["../../src/shared/work-queue.ts"],"names":[],"mappings":""}