agent-nuvira 1.14.0

package/dist/cli/workflow.js

@@ -0,0 +1,347 @@
+/**
+ * Workflow command — Lists, runs, and manages workflow templates.
+ *
+ * Usage:
+ *   buff workflow list                    — Show available workflow templates
+ *   buff workflow run quick-fix "goal"    — Run the quick-fix workflow
+ *   buff workflow search <query>          — Search the GitHub workflow registry
+ *   buff workflow install <template>      — Install template from the registry
+ *   buff workflow publish <template-id>   — Prepare a local template for publishing
+ *   buff workflow info <template>         — Show registry template details
+ */
+import { Command } from 'commander';
+import ora from 'ora';
+import { BaseCommand } from './commands.js';
+import { Orchestrator } from '../agents/orchestrator.js';
+import { getWorkflowTemplates, getWorkflowTemplate, buildTaskPlanFromTemplate, buildWorkflowOptions } from '../workflow/templates.js';
+import { searchRegistry, installTemplate, getRegistryEntry, getInstalledTemplates, validateForPublish, prepareForPublish, getPublishUrl, clearRegistryCache, checkForUpgrades, } from '../workflow/registry.js';
+import { logger } from '../utils/logger.js';
+import { printOrchestrationResult } from './execute.js';
+/**
+ * Workflow command for listing, running, and managing workflow templates.
+ */
+export class WorkflowCommand extends BaseCommand {
+    create() {
+        const command = new Command('workflow')
+            .description('Run, manage, and share workflow templates');
+        // ── list ──────────────────────────────────────────────────────────────
+        command
+            .command('list')
+            .description('Show available workflow templates (built-in + installed)')
+            .action(() => {
+            this.listWorkflows();
+        });
+        // ── run ───────────────────────────────────────────────────────────────
+        command
+            .command('run')
+            .description('Run a workflow template')
+            .argument('<template>', 'Template name')
+            .argument('<goal>', 'The goal to accomplish')
+            .option('-p, --provider <provider>', 'Inference provider override')
+            .option('-m, --model <model>', 'Model override')
+            .option('--dry-run', 'Preview changes without writing to disk', false)
+            .option('-v, --verbose', 'Show detailed agent output', false)
+            .action(async (template, goal, options) => {
+            await this.runWorkflow(template, goal, options);
+        });
+        // ── search ────────────────────────────────────────────────────────────
+        command
+            .command('search')
+            .description('Search the GitHub workflow template registry')
+            .argument('<query>', 'Search query (e.g., "security", "test", "react")')
+            .option('--refresh', 'Force refresh the registry cache')
+            .action(async (query, options) => {
+            await this.searchRegistry(query, options);
+        });
+        // ── install ──────────────────────────────────────────────────────────
+        command
+            .command('install')
+            .description('Install a workflow template from the GitHub registry')
+            .argument('<template>', 'Template name from the registry (use `buff workflow search` to find templates)')
+            .action(async (template) => {
+            await this.installTemplate(template);
+        });
+        // ── publish ──────────────────────────────────────────────────────────
+        command
+            .command('publish')
+            .description('Prepare a local workflow template for publishing to the registry')
+            .argument('<template-id>', 'The ID of the local template to publish (must exist in ~/.buff/workflows/)')
+            .action(async (templateId) => {
+            await this.preparePublish(templateId);
+        });
+        // ── info ──────────────────────────────────────────────────────────────
+        command
+            .command('info')
+            .description('Show detailed information about a registry template')
+            .argument('<template>', 'Template name from the registry')
+            .action(async (template) => {
+            await this.showInfo(template);
+        });
+        // ── upgrade ────────────────────────────────────────────────────────────
+        command
+            .command('upgrade')
+            .description('Check for and apply template upgrades from the registry')
+            .action(async () => {
+            await this.checkUpgrades();
+        });
+        return command;
+    }
+    // ─── Action Handlers ──────────────────────────────────────────────────
+    listWorkflows() {
+        const builtin = getWorkflowTemplates();
+        const installed = getInstalledTemplates();
+        logger.highlight(`${'═'.repeat(60)}`);
+        logger.highlight('  📋  Available Workflow Templates');
+        logger.highlight(`${'═'.repeat(60)}`);
+        // Built-in templates
+        console.log(`\n  📦 Built-in (${builtin.length}):`);
+        for (const t of builtin) {
+            const tags = t.tags ? ` [${t.tags.join(', ')}]` : '';
+            console.log(`    ${t.id.padEnd(22)} ${t.description.slice(0, 50)}...${tags}`);
+            console.log(`    ${' '.repeat(24)} Steps: ${t.steps.length}${t.useMemory ? '  🧠 memory' : ''}`);
+        }
+        // Installed registry templates
+        if (installed.length > 0) {
+            console.log(`\n  🌐 Installed from registry (${installed.length}):`);
+            for (const t of installed) {
+                const ver = t.version ? ` v${t.version}` : '';
+                const author = t.author ? ` by ${t.author}` : '';
+                console.log(`    ${t.id.padEnd(22)} ${t.description.slice(0, 50)}...${ver}${author}`);
+            }
+        }
+        console.log(`\n  💡 Use 'buff workflow search <query>' to find templates in the registry.`);
+        console.log(`     Use 'buff workflow install <name>' to install from the registry.`);
+        console.log('');
+    }
+    async runWorkflow(templateId, goal, options) {
+        // Check built-in templates first
+        let template = getWorkflowTemplate(templateId);
+        // If not found, check installed registry templates
+        if (!template) {
+            const installed = getInstalledTemplates();
+            template = installed.find((t) => t.id === templateId);
+        }
+        // If still not found, offer to install from registry
+        if (!template) {
+            logger.error(`Unknown workflow template: '${templateId}'`);
+            console.log(`\n  💡 Search the registry: buff workflow search ${templateId}`);
+            console.log(`     Install from registry: buff workflow install ${templateId}`);
+            console.log(`     Available built-in: ${getWorkflowTemplates().map((t) => t.id).join(', ')}`);
+            return;
+        }
+        // Build the task plan from the template
+        const taskPlan = buildTaskPlanFromTemplate(template, goal);
+        const workflowOptions = buildWorkflowOptions(template, options);
+        if (options.verbose) {
+            logger.info(`Workflow: ${template.name}`);
+            logger.info(`Template: ${template.id}`);
+            logger.info(`Steps: ${taskPlan.length}`);
+            if (template.recommendedModels) {
+                logger.info('Recommended models:');
+                for (const [agent, model] of Object.entries(template.recommendedModels)) {
+                    logger.info(`  ${agent}: ${model}`);
+                }
+            }
+            console.log('');
+        }
+        // Execute via orchestrator with the pre-built plan
+        const spinner = ora({
+            text: `Running workflow '${template.id}'...`,
+            spinner: 'dots',
+        }).start();
+        try {
+            const orchestrator = new Orchestrator(this.configManager);
+            const result = await orchestrator.execute(goal, {
+                ...workflowOptions,
+                provider: options.provider,
+                model: options.model,
+                dryRun: options.dryRun,
+                verbose: options.verbose,
+                prefillPlan: taskPlan, // Skip the planner, use the pre-built plan
+            });
+            spinner.stop();
+            console.log('');
+            printOrchestrationResult(result);
+        }
+        catch (err) {
+            spinner.fail(`Workflow '${template.id}' failed`);
+            logger.error(String(err));
+        }
+    }
+    async searchRegistry(query, options) {
+        if (options?.refresh) {
+            clearRegistryCache();
+        }
+        const spinner = ora('Searching workflow registry...').start();
+        try {
+            const results = await searchRegistry(query);
+            spinner.stop();
+            if (results.length === 0) {
+                logger.info(`No templates found matching "${query}".`);
+                console.log('  The registry is at: https://github.com/agent-baba-d/workflows');
+                console.log('  You can submit your own templates there!');
+                return;
+            }
+            logger.highlight(`${'═'.repeat(60)}`);
+            logger.highlight(`  🔍  Registry Results: "${query}" (${results.length} found)`);
+            logger.highlight(`${'═'.repeat(60)}`);
+            for (const entry of results) {
+                const tags = entry.tags.length > 0 ? ` [${entry.tags.join(', ')}]` : '';
+                console.log(`\n  ${entry.id.padEnd(22)} v${entry.version} by ${entry.author}`);
+                console.log(`  ${' '.repeat(24)} ${entry.description.slice(0, 80)}`);
+                console.log(`  ${' '.repeat(24)} ${entry.stepCount} steps  |  Updated: ${entry.updatedAt.slice(0, 10)}${tags}`);
+                if (entry.sourceUrl) {
+                    console.log(`  ${' '.repeat(24)} ${entry.sourceUrl}`);
+                }
+            }
+            console.log(`\n  Install: buff workflow install <template-id>`);
+            console.log('');
+        }
+        catch (err) {
+            spinner.fail('Registry search failed');
+            logger.error(String(err));
+        }
+    }
+    async installTemplate(templateId) {
+        const spinner = ora(`Installing '${templateId}'...`).start();
+        try {
+            const template = await installTemplate(templateId);
+            spinner.stop();
+            if (template) {
+                const stepCount = template.steps.length;
+                logger.success(`Successfully installed '${template.id}'`);
+                console.log(`  Name: ${template.name}`);
+                console.log(`  Steps: ${stepCount}`);
+                console.log(`  Location: ~/.buff/workflows/registry/${template.id}.json`);
+                console.log(`\n  Run it: buff workflow run ${template.id} "your goal"`);
+            }
+        }
+        catch (err) {
+            spinner.fail('Installation failed');
+            logger.error(String(err));
+        }
+    }
+    async preparePublish(templateId) {
+        console.log('');
+        logger.highlight(`  📤  Preparing '${templateId}' for publishing`);
+        console.log('');
+        // Validate
+        const validation = validateForPublish(templateId);
+        if (!validation.valid) {
+            logger.error('Validation failed:');
+            for (const err of validation.errors) {
+                console.log(`    ❌ ${err}`);
+            }
+            return;
+        }
+        if (validation.warnings.length > 0) {
+            logger.info('Warnings:');
+            for (const w of validation.warnings) {
+                console.log(`    ⚠️  ${w}`);
+            }
+            console.log('');
+        }
+        // Generate the publish-ready JSON
+        const publishData = prepareForPublish(templateId);
+        if (!publishData)
+            return;
+        logger.success('Template validated successfully!');
+        console.log('');
+        // Display the publish data and instructions
+        console.log('  📄 Template data ready for publishing:');
+        console.log('');
+        // Show a preview (first 500 chars)
+        const preview = publishData.length > 500 ? publishData.slice(0, 500) + '\n  ...' : publishData;
+        for (const line of preview.split('\n')) {
+            console.log(`  ${line}`);
+        }
+        console.log('');
+        logger.highlight(`${'═'.repeat(60)}`);
+        console.log('');
+        console.log('  To publish this template:');
+        console.log('    1. Create a pull request at:');
+        console.log(`       ${getPublishUrl()}`);
+        console.log('    2. Include the template JSON shown above');
+        console.log('    3. The template will be reviewed and added to the registry');
+        console.log('');
+        console.log('  Or visit the registry repo:');
+        console.log('    https://github.com/agent-baba-d/workflows');
+        console.log('');
+    }
+    async checkUpgrades() {
+        const spinner = ora('Checking for template upgrades...').start();
+        try {
+            const upgrades = await checkForUpgrades();
+            spinner.stop();
+            if (upgrades.length === 0) {
+                logger.success('All installed templates are up to date.');
+                return;
+            }
+            logger.highlight(`${'═'.repeat(60)}`);
+            logger.highlight(`  ⬆️  Template Upgrades Available (${upgrades.length})`);
+            logger.highlight(`${'═'.repeat(60)}`);
+            for (const upgrade of upgrades) {
+                console.log(`\n  ${upgrade.id}`);
+                console.log(`    Current: v${upgrade.currentVersion}`);
+                console.log(`    Latest:  v${upgrade.latestVersion}`);
+            }
+            console.log(`\n  To upgrade a template: buff workflow install <template-id>`);
+            console.log('  (This will overwrite the local version with the latest from the registry)');
+            console.log('');
+        }
+        catch (err) {
+            spinner.fail('Upgrade check failed');
+            logger.error(String(err));
+        }
+    }
+    async showInfo(templateId) {
+        const spinner = ora('Fetching template info...').start();
+        try {
+            const entry = await getRegistryEntry(templateId);
+            spinner.stop();
+            if (!entry) {
+                // Check if it's a built-in template
+                const builtin = getWorkflowTemplate(templateId);
+                if (builtin) {
+                    logger.highlight(`  📋  ${builtin.name} (built-in)`);
+                    console.log('');
+                    console.log(`  ID: ${builtin.id}`);
+                    console.log(`  Description: ${builtin.description}`);
+                    console.log(`  Steps: ${builtin.steps.length}`);
+                    for (const step of builtin.steps) {
+                        console.log(`    ▶ [${step.agentType}] ${step.description}`);
+                    }
+                    if (builtin.recommendedModels) {
+                        console.log(`\n  Recommended models:`);
+                        for (const [agent, model] of Object.entries(builtin.recommendedModels)) {
+                            console.log(`    ${agent}: ${model}`);
+                        }
+                    }
+                    console.log('');
+                    return;
+                }
+                logger.error(`Template '${templateId}' not found in registry or built-in templates.`);
+                logger.info(`Search: buff workflow search ${templateId}`);
+                return;
+            }
+            logger.highlight(`  📋  ${entry.name} (registry)`);
+            console.log('');
+            console.log(`  ID: ${entry.id}`);
+            console.log(`  Version: ${entry.version}`);
+            console.log(`  Author: ${entry.author}`);
+            console.log(`  Description: ${entry.description}`);
+            console.log(`  Steps: ${entry.stepCount}`);
+            if (entry.tags.length > 0) {
+                console.log(`  Tags: ${entry.tags.join(', ')}`);
+            }
+            console.log(`  Updated: ${entry.updatedAt}`);
+            console.log(`  \n  Install: buff workflow install ${entry.id}`);
+            console.log('');
+        }
+        catch (err) {
+            spinner.fail('Failed to fetch template info');
+            logger.error(String(err));
+        }
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/cli/workflow.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,37 @@
+import { BuffConfig, ProviderType, ProviderConfig } from './types.js';
+export declare class ConfigManager {
+    private config;
+    private env;
+    private configDir;
+    private configPath;
+    constructor(configDir?: string);
+    /**
+     * Load config from disk, merging with defaults and env vars
+     */
+    private loadConfig;
+    /**
+     * Override API keys from environment variables
+     * Environment variables take priority over the config file.
+     */
+    private overrideFromEnv;
+    /**
+     * Get configuration for a specific provider
+     */
+    getProviderConfig(provider?: ProviderType): {
+        type: ProviderType;
+        config: ProviderConfig;
+    };
+    /**
+     * Get the full config
+     */
+    getAll(): BuffConfig;
+    /**
+     * Save current configuration to disk
+     */
+    save(config: Partial<BuffConfig>): void;
+    /**
+     * Check if a provider has the required API key
+     */
+    hasRequiredCredentials(provider: ProviderType): boolean;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAetE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,GAAG,CAAqC;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,SAAS,CAAC,EAAE,MAAM;IAO9B;;OAEG;IACH,OAAO,CAAC,UAAU;IA4ClB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE;IAW1F;;OAEG;IACH,MAAM,IAAI,UAAU;IAIpB;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAuBvC;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;CAIxD"}

package/dist/config/manager.js

@@ -0,0 +1,147 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { loadEnv } from '../utils/env.js';
+import { logger } from '../utils/logger.js';
+const DEFAULT_CONFIG = {
+    defaultProvider: 'local',
+    providers: {
+        nim: { model: 'meta/llama-3.1-8b-instruct', temperature: 0.7, maxTokens: 4096 },
+        gemini: { model: 'gemini-2.0-flash-exp', temperature: 0.7, maxTokens: 8192 },
+        openrouter: { model: 'mistralai/mistral-7b-instruct', temperature: 0.7, maxTokens: 4096 },
+        groq: { model: 'llama-3.3-70b-versatile', temperature: 0.7, maxTokens: 4096 },
+        local: { runner: 'ollama', model: 'llama2', temperature: 0.7, maxTokens: 4096 },
+    },
+};
+export class ConfigManager {
+    config;
+    env;
+    configDir;
+    configPath;
+    constructor(configDir) {
+        this.env = loadEnv();
+        this.configDir = configDir || join(homedir(), '.buff');
+        this.configPath = join(this.configDir, 'buffconfig.json');
+        this.config = this.loadConfig();
+    }
+    /**
+     * Load config from disk, merging with defaults and env vars
+     */
+    loadConfig() {
+        // Deep clone DEFAULT_CONFIG to avoid mutating the module-level constant
+        const config = {
+            ...DEFAULT_CONFIG,
+            providers: {
+                ...DEFAULT_CONFIG.providers,
+            },
+        };
+        // Deep merge providers defaults
+        for (const key of Object.keys(config.providers)) {
+            config.providers[key] = { ...config.providers[key] };
+        }
+        if (existsSync(this.configPath)) {
+            try {
+                const raw = readFileSync(this.configPath, 'utf-8');
+                const userConfig = JSON.parse(raw);
+                if (userConfig.defaultProvider) {
+                    config.defaultProvider = userConfig.defaultProvider;
+                }
+                if (userConfig.providers) {
+                    for (const [key, value] of Object.entries(userConfig.providers)) {
+                        const provider = key;
+                        if (config.providers[provider]) {
+                            config.providers[provider] = { ...config.providers[provider], ...value };
+                        }
+                        else {
+                            config.providers[provider] = value;
+                        }
+                    }
+                }
+            }
+            catch {
+                // If config is corrupted, fall back to defaults
+            }
+        }
+        // Override API keys from environment variables
+        this.overrideFromEnv(config);
+        return config;
+    }
+    /**
+     * Override API keys from environment variables
+     * Environment variables take priority over the config file.
+     */
+    overrideFromEnv(config) {
+        // Debug logging to help troubleshoot env var detection
+        const envVarsChecked = [];
+        if (this.env.NVIDIA_NIM_API_KEY) {
+            config.providers.nim.apiKey = this.env.NVIDIA_NIM_API_KEY;
+            envVarsChecked.push('NVIDIA_NIM_API_KEY');
+        }
+        if (this.env.GEMINI_API_KEY) {
+            config.providers.gemini.apiKey = this.env.GEMINI_API_KEY;
+            envVarsChecked.push('GEMINI_API_KEY');
+        }
+        if (this.env.OPENROUTER_API_KEY) {
+            config.providers.openrouter.apiKey = this.env.OPENROUTER_API_KEY;
+            envVarsChecked.push('OPENROUTER_API_KEY');
+        }
+        if (this.env.GROQ_API_KEY) {
+            config.providers.groq.apiKey = this.env.GROQ_API_KEY;
+            envVarsChecked.push('GROQ_API_KEY');
+        }
+        if (envVarsChecked.length > 0) {
+            logger.debug(`Config: Loaded API keys from env vars: ${envVarsChecked.join(', ')}`);
+        }
+        else {
+            logger.debug('Config: No API keys found in environment variables. Use --debug to see more.');
+        }
+    }
+    /**
+     * Get configuration for a specific provider
+     */
+    getProviderConfig(provider) {
+        const type = provider || this.config.defaultProvider;
+        const config = this.config.providers[type];
+        if (!config) {
+            throw new Error(`No configuration found for provider '${type}'`);
+        }
+        return { type, config };
+    }
+    /**
+     * Get the full config
+     */
+    getAll() {
+        return { ...this.config };
+    }
+    /**
+     * Save current configuration to disk
+     */
+    save(config) {
+        if (!existsSync(this.configDir)) {
+            mkdirSync(this.configDir, { recursive: true });
+        }
+        // Merge with existing
+        if (config.defaultProvider) {
+            this.config.defaultProvider = config.defaultProvider;
+        }
+        if (config.providers) {
+            for (const [key, value] of Object.entries(config.providers)) {
+                const provider = key;
+                this.config.providers[provider] = {
+                    ...this.config.providers[provider],
+                    ...value,
+                };
+            }
+        }
+        writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), 'utf-8');
+    }
+    /**
+     * Check if a provider has the required API key
+     */
+    hasRequiredCredentials(provider) {
+        if (provider === 'local')
+            return true; // Local doesn't need API key
+        return !!this.config.providers[provider]?.apiKey;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Supported inference provider identifiers
+ */
+export type ProviderType = 'nim' | 'gemini' | 'openrouter' | 'groq' | 'local';
+/**
+ * Local model runner options
+ */
+export type LocalRunner = 'ollama' | 'huggingface' | 'ggml';
+/**
+ * Provider-specific configuration
+ */
+export interface ProviderConfig {
+    apiKey?: string;
+    model?: string;
+    runner?: LocalRunner;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+/** Team collaboration settings */
+export interface TeamConfig {
+    /** Git URL for the team's shared memory/templates repo */
+    repository?: string;
+    /** Local path to the team data directory */
+    localPath?: string;
+    /** Branch to sync with */
+    branch?: string;
+    /** Auto-sync interval in minutes (0 = disabled) */
+    autoSyncMinutes?: number;
+    /** Whether to share trajectories with the team */
+    shareTrajectories?: boolean;
+}
+/**
+ * Full configuration schema for .buffconfig.json
+ */
+export interface BuffConfig {
+    defaultProvider: ProviderType;
+    providers: Record<ProviderType, ProviderConfig>;
+    /** Team collaboration config */
+    team?: TeamConfig;
+}
+/**
+ * Inference options passed to each generation call
+ * Note: provider is string to allow plugin-based providers
+ */
+export interface InferenceOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    provider?: string;
+    stream?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,YAAY,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAChD,gCAAgC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/config/types.js

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

package/dist/config/types.js.map

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