wave-agent-sdk 0.0.7 → 0.0.10

package/dist/services/configurationService.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Configuration Service
+ *
+ * Centralized service for loading, validating, and managing Wave configuration files.
+ * Replaces distributed configuration logic previously embedded in hook.ts.
+ */
+import type { WaveConfiguration } from "../types/hooks.js";
+import type { ConfigurationLoadResult, ValidationResult, ConfigurationPaths } from "../types/configuration.js";
+import { type EnvironmentValidationResult, type MergedEnvironmentContext, type EnvironmentMergeOptions } from "../types/environment.js";
+import { GatewayConfig, ModelConfig } from "../types/index.js";
+import { ClientOptions } from "openai";
+/**
+ * Default ConfigurationService implementation
+ *
+ * Provides centralized configuration loading, validation, and management.
+ * Extracted from distributed logic in hook.ts with improved error handling.
+ */
+export declare class ConfigurationService {
+    private currentConfiguration;
+    private env;
+    /**
+     * Load and merge configuration with comprehensive validation
+     */
+    loadMergedConfiguration(workdir: string): Promise<ConfigurationLoadResult>;
+    /**
+     * Validate configuration object structure and values
+     */
+    validateConfiguration(config: WaveConfiguration): ValidationResult;
+    /**
+     * Validate configuration file without loading
+     */
+    validateConfigurationFile(filePath: string): ValidationResult;
+    /**
+     * Get currently loaded configuration
+     */
+    getCurrentConfiguration(): WaveConfiguration | null;
+    /**
+     * Set environment variables from configuration
+     * This replaces direct process.env modification
+     */
+    setEnvironmentVars(env: Record<string, string>): void;
+    /**
+     * Get current environment variables
+     */
+    getEnvironmentVars(): Record<string, string>;
+    /**
+     * Resolves gateway configuration from constructor args and environment
+     * Resolution priority: options > env (from settings.json) > process.env > error
+     * @param apiKey - API key from constructor (optional)
+     * @param baseURL - Base URL from constructor (optional)
+     * @param defaultHeaders - HTTP headers from constructor (optional)
+     * @param fetchOptions - Fetch options from constructor (optional)
+     * @param fetch - Custom fetch implementation from constructor (optional)
+     * @returns Resolved gateway configuration
+     * @throws ConfigurationError if required configuration is missing after fallbacks
+     */
+    resolveGatewayConfig(apiKey?: string, baseURL?: string, defaultHeaders?: Record<string, string>, fetchOptions?: ClientOptions["fetchOptions"], fetch?: ClientOptions["fetch"]): GatewayConfig;
+    /**
+     * Resolves model configuration with fallbacks
+     * Resolution priority: options > env (from settings.json) > process.env > default
+     * @param agentModel - Agent model from constructor (optional)
+     * @param fastModel - Fast model from constructor (optional)
+     * @returns Resolved model configuration with defaults
+     */
+    resolveModelConfig(agentModel?: string, fastModel?: string): ModelConfig;
+    /**
+     * Resolves token limit with fallbacks
+     * Resolution priority: options > env (from settings.json) > process.env > default
+     * @param constructorLimit - Token limit from constructor (optional)
+     * @returns Resolved token limit
+     */
+    resolveTokenLimit(constructorLimit?: number): number;
+    /**
+     * Resolve all configuration file paths
+     */
+    getConfigurationPaths(workdir: string): ConfigurationPaths;
+    /**
+     * Add a permission rule to the project's settings.local.json
+     */
+    addAllowedRule(workdir: string, rule: string): Promise<void>;
+}
+/**
+ * Validate environment variable configuration
+ */
+export declare function validateEnvironmentConfig(env: unknown, configPath?: string): EnvironmentValidationResult;
+/**
+ * Merge environment configurations with project taking precedence over user
+ */
+export declare function mergeEnvironmentConfig(userEnv: Record<string, string> | undefined, projectEnv: Record<string, string> | undefined, options?: EnvironmentMergeOptions): MergedEnvironmentContext;
+/**
+ * Load Wave configuration from a JSON file
+ * Supports both hooks and environment variables with proper validation
+ */
+export declare function loadWaveConfigFromFile(filePath: string): WaveConfiguration | null;
+/**
+ * Load Wave configuration from multiple file paths in priority order
+ * Returns the first valid configuration found, or null if none exist
+ */
+export declare function loadWaveConfigFromFiles(filePaths: string[]): WaveConfiguration | null;
+/**
+ * Load user-specific Wave configuration
+ * Checks .local.json first, then falls back to .json
+ */
+export declare function loadUserWaveConfig(): WaveConfiguration | null;
+/**
+ * Load project-specific Wave configuration
+ * Checks .local.json first, then falls back to .json
+ */
+export declare function loadProjectWaveConfig(workdir: string): WaveConfiguration | null;
+/**
+ * Load and merge Wave configuration from both user and project sources
+ * Project configuration takes precedence over user configuration
+ * Checks .local.json files first, then falls back to .json files
+ */
+export declare function loadMergedWaveConfig(workdir: string): WaveConfiguration | null;
+//# sourceMappingURL=configurationService.d.ts.map

package/dist/services/configurationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationService.d.ts","sourceRoot":"","sources":["../../src/services/configurationService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,GAAG,CAA8B;IAIzC;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,CAAC;IA0EnC;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB;IA8FlE;;OAEG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAwC7D;;OAEG;IACH,uBAAuB,IAAI,iBAAiB,GAAG,IAAI;IAInD;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIrD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,YAAY,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,EAC5C,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC7B,aAAa;IA4DhB;;;;;;OAMG;IACH,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW;IAyBxE;;;;;OAKG;IACH,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAmBpD;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB;IAY1D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmCnE;AAKD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,2BAA2B,CAsD7B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC9C,OAAO,GAAE,uBAA4B,GACpC,wBAAwB,CAoC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,CA8C1B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EAAE,GAClB,iBAAiB,GAAG,IAAI,CAQ1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAE1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CAsE1B"}