@agntk/core 0.1.0

package/dist/config/loader.js

@@ -0,0 +1,222 @@
+/**
+ * @fileoverview Configuration loader.
+ * Loads config from YAML/JSON files and environment variables.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, extname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { createLogger } from '@agntk/logger';
+import { AgentConfigSchema, PartialAgentConfigSchema } from './schema.js';
+import { DEFAULT_MODELS, DEFAULT_PROVIDER, DEFAULT_MAX_STEPS } from './defaults.js';
+const log = createLogger('@agntk/core:config');
+// ============================================================================
+// Global Config State
+// ============================================================================
+let globalConfig = null;
+// ============================================================================
+// Config File Discovery
+// ============================================================================
+const CONFIG_FILENAMES = [
+    'agent-sdk.config.yaml',
+    'agent-sdk.config.yml',
+    'agent-sdk.config.json',
+    '.agent-sdk.yaml',
+    '.agent-sdk.json',
+];
+function findConfigFile(searchDir = process.cwd()) {
+    // Check env var first
+    const envPath = process.env['AGENT_SDK_CONFIG'];
+    if (envPath) {
+        const resolved = resolve(searchDir, envPath);
+        if (existsSync(resolved)) {
+            log.debug('Using config from AGENT_SDK_CONFIG', { path: resolved });
+            return resolved;
+        }
+        log.warn('AGENT_SDK_CONFIG path not found', { path: resolved });
+    }
+    // Auto-discover
+    for (const filename of CONFIG_FILENAMES) {
+        const path = resolve(searchDir, filename);
+        if (existsSync(path)) {
+            log.debug('Found config file', { path });
+            return path;
+        }
+    }
+    return null;
+}
+function parseConfigFile(path) {
+    const content = readFileSync(path, 'utf-8');
+    const ext = extname(path).toLowerCase();
+    let parsed;
+    if (ext === '.yaml' || ext === '.yml') {
+        parsed = parseYaml(content);
+    }
+    else {
+        parsed = JSON.parse(content);
+    }
+    // Validate with Zod
+    const result = PartialAgentConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        log.error('Invalid config file', { path, errors: result.error.errors });
+        throw new Error(`Invalid config file: ${result.error.message}`);
+    }
+    return result.data;
+}
+// ============================================================================
+// Environment Variable Reading
+// ============================================================================
+function getEnvConfig() {
+    const config = {};
+    // Model tier overrides
+    const tiers = {};
+    const tierNames = ['fast', 'standard', 'reasoning', 'powerful'];
+    for (const tier of tierNames) {
+        const envKey = `AGENT_SDK_MODEL_${tier.toUpperCase()}`;
+        const value = process.env[envKey];
+        if (value) {
+            log.debug('Model override from env', { tier, model: value });
+            tiers[tier] = value;
+        }
+    }
+    if (Object.keys(tiers).length > 0) {
+        config.models = { tiers };
+    }
+    // Default provider override
+    const provider = process.env['AGENT_SDK_DEFAULT_PROVIDER'];
+    if (provider) {
+        config.models = { ...config.models, defaultProvider: provider };
+    }
+    // Workspace root
+    if (process.env['AGENT_SDK_WORKSPACE']) {
+        config.workspaceRoot = process.env['AGENT_SDK_WORKSPACE'];
+    }
+    // Max steps
+    if (process.env['AGENT_SDK_MAX_STEPS']) {
+        config.maxSteps = parseInt(process.env['AGENT_SDK_MAX_STEPS'], 10);
+    }
+    return config;
+}
+// ============================================================================
+// Config Merging
+// ============================================================================
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = result[key];
+        if (sourceValue !== undefined) {
+            if (typeof sourceValue === 'object' &&
+                sourceValue !== null &&
+                !Array.isArray(sourceValue) &&
+                typeof targetValue === 'object' &&
+                targetValue !== null &&
+                !Array.isArray(targetValue)) {
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else {
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Load configuration from files and environment.
+ * Priority: env vars > config file > defaults
+ */
+export function loadConfig(searchDir = process.cwd()) {
+    log.debug('Loading config', { searchDir });
+    // Start with defaults
+    let config = {
+        models: {
+            defaultProvider: DEFAULT_PROVIDER,
+            providers: DEFAULT_MODELS,
+        },
+        maxSteps: DEFAULT_MAX_STEPS,
+    };
+    // Load from file if exists
+    const configPath = findConfigFile(searchDir);
+    if (configPath) {
+        log.info('Loading config file', { path: configPath });
+        const fileConfig = parseConfigFile(configPath);
+        config = deepMerge(config, fileConfig);
+    }
+    // Apply env var overrides (highest priority)
+    const envConfig = getEnvConfig();
+    config = deepMerge(config, envConfig);
+    globalConfig = config;
+    return config;
+}
+/**
+ * Get the current config, loading if necessary.
+ */
+export function getConfig() {
+    if (!globalConfig) {
+        globalConfig = loadConfig();
+    }
+    return globalConfig;
+}
+/**
+ * Configure the global settings programmatically.
+ */
+export function configure(options) {
+    const current = getConfig();
+    globalConfig = deepMerge(current, options);
+    log.debug('Config updated', { options });
+}
+/**
+ * Reset config to defaults.
+ */
+export function resetConfig() {
+    globalConfig = null;
+}
+/**
+ * Get model name for a tier, respecting config overrides.
+ */
+export function getModelForTier(tier, provider) {
+    const config = getConfig();
+    const effectiveProvider = provider ?? config.models?.defaultProvider ?? DEFAULT_PROVIDER;
+    // Check tier overrides first (from env or config tiers)
+    if (config.models?.tiers?.[tier]) {
+        return config.models.tiers[tier];
+    }
+    // Check provider-specific mappings
+    if (config.models?.providers?.[effectiveProvider]?.[tier]) {
+        return config.models.providers[effectiveProvider][tier];
+    }
+    // Fallback to defaults
+    return DEFAULT_MODELS[effectiveProvider]?.[tier]
+        ?? DEFAULT_MODELS[DEFAULT_PROVIDER][tier];
+}
+/**
+ * Helper for config file creation.
+ */
+export function defineConfig(config) {
+    return config;
+}
+/**
+ * Get tool-specific configuration.
+ */
+export function getToolConfig(toolName) {
+    const config = getConfig();
+    const toolsConfig = config.tools;
+    return (toolsConfig?.[toolName] ?? {});
+}
+/**
+ * Get server configuration.
+ */
+export function getServerConfig() {
+    const config = getConfig();
+    return config.server ?? {};
+}
+/**
+ * Get client configuration.
+ */
+export function getClientConfig() {
+    const config = getConfig();
+    return config.client ?? {};
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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