@cyanautomation/kaseki-agent 1.4.1

package/dist/config/ConfigManager.d.ts

@@ -0,0 +1,395 @@
+/**
+ * Configuration Manager
+ *
+ * Handles 4-tier precedence:
+ * 1. CLI flags/arguments (highest)
+ * 2. Config file: ./kaseki-agent.json (project-local)
+ * 3. Config file: ~/.kaseki/config.json (user-global)
+ * 4. Environment variables
+ * 5. Built-in defaults (lowest)
+ */
+import { z } from 'zod';
+/**
+ * Full configuration schema with validation
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    auth: z.ZodOptional<z.ZodObject<{
+        openrouter_api_key_file: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        github_app_id_file: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        github_app_client_id_file: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        github_app_private_key_file: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        openrouter_api_key_file?: string | undefined;
+        github_app_id_file?: string | undefined;
+        github_app_client_id_file?: string | undefined;
+        github_app_private_key_file?: string | undefined;
+    }, {
+        openrouter_api_key_file?: string | undefined;
+        github_app_id_file?: string | undefined;
+        github_app_client_id_file?: string | undefined;
+        github_app_private_key_file?: string | undefined;
+    }>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        timeout_seconds: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        guardrails: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | undefined;
+        provider?: string | undefined;
+        timeout_seconds?: number | undefined;
+        guardrails?: boolean | undefined;
+    }, {
+        model?: string | undefined;
+        provider?: string | undefined;
+        timeout_seconds?: number | undefined;
+        guardrails?: boolean | undefined;
+    }>>;
+    repo: z.ZodOptional<z.ZodObject<{
+        url: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        ref: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        task_mode: z.ZodOptional<z.ZodOptional<z.ZodEnum<["patch", "inspect"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        url?: string | undefined;
+        ref?: string | undefined;
+        task_mode?: "patch" | "inspect" | undefined;
+    }, {
+        url?: string | undefined;
+        ref?: string | undefined;
+        task_mode?: "patch" | "inspect" | undefined;
+    }>>;
+    validation: z.ZodOptional<z.ZodObject<{
+        commands: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        skip_missing_npm_scripts: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        fail_fast: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        validate_after_agent_failure: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        allowlist: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        validation_allowlist: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        restore_disallowed_changes: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        max_diff_bytes: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        allow_empty_diff: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        commands?: string[] | undefined;
+        skip_missing_npm_scripts?: boolean | undefined;
+        fail_fast?: boolean | undefined;
+        validate_after_agent_failure?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        validation_allowlist?: string[] | undefined;
+        restore_disallowed_changes?: boolean | undefined;
+        max_diff_bytes?: number | undefined;
+        allow_empty_diff?: boolean | undefined;
+    }, {
+        commands?: string[] | undefined;
+        skip_missing_npm_scripts?: boolean | undefined;
+        fail_fast?: boolean | undefined;
+        validate_after_agent_failure?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        validation_allowlist?: string[] | undefined;
+        restore_disallowed_changes?: boolean | undefined;
+        max_diff_bytes?: number | undefined;
+        allow_empty_diff?: boolean | undefined;
+    }>>;
+    caching: z.ZodOptional<z.ZodObject<{
+        dependency_cache_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        dependency_restore_mode: z.ZodOptional<z.ZodOptional<z.ZodEnum<["copy", "link"]>>>;
+        install_ignore_scripts: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        npm_omit_dev: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        image_dependency_cache_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        git_cache_mode: z.ZodOptional<z.ZodOptional<z.ZodEnum<["off", "mirror"]>>>;
+        git_cache_root: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dependency_cache_dir?: string | undefined;
+        dependency_restore_mode?: "link" | "copy" | undefined;
+        install_ignore_scripts?: boolean | undefined;
+        npm_omit_dev?: boolean | undefined;
+        image_dependency_cache_dir?: string | undefined;
+        git_cache_mode?: "off" | "mirror" | undefined;
+        git_cache_root?: string | undefined;
+    }, {
+        dependency_cache_dir?: string | undefined;
+        dependency_restore_mode?: "link" | "copy" | undefined;
+        install_ignore_scripts?: boolean | undefined;
+        npm_omit_dev?: boolean | undefined;
+        image_dependency_cache_dir?: string | undefined;
+        git_cache_mode?: "off" | "mirror" | undefined;
+        git_cache_root?: string | undefined;
+    }>>;
+    repo_memory: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodOptional<z.ZodEnum<["off", "read", "read-write"]>>>;
+        ttl_days: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        max_bytes: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        mode?: "off" | "read" | "read-write" | undefined;
+        ttl_days?: number | undefined;
+        max_bytes?: number | undefined;
+    }, {
+        mode?: "off" | "read" | "read-write" | undefined;
+        ttl_days?: number | undefined;
+        max_bytes?: number | undefined;
+    }>>;
+    github: z.ZodOptional<z.ZodObject<{
+        app_enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        publish_mode: z.ZodOptional<z.ZodOptional<z.ZodEnum<["auto", "on", "off"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        app_enabled?: boolean | undefined;
+        publish_mode?: "off" | "auto" | "on" | undefined;
+    }, {
+        app_enabled?: boolean | undefined;
+        publish_mode?: "off" | "auto" | "on" | undefined;
+    }>>;
+    docker: z.ZodOptional<z.ZodObject<{
+        image: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        auto_pull: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        container_user: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        image?: string | undefined;
+        auto_pull?: boolean | undefined;
+        container_user?: string | undefined;
+    }, {
+        image?: string | undefined;
+        auto_pull?: boolean | undefined;
+        container_user?: string | undefined;
+    }>>;
+    api: z.ZodOptional<z.ZodObject<{
+        port: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        keys: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        log_level: z.ZodOptional<z.ZodOptional<z.ZodEnum<["debug", "info", "warn", "error"]>>>;
+        max_concurrent_runs: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        keys?: string[] | undefined;
+        port?: number | undefined;
+        log_level?: "debug" | "info" | "warn" | "error" | undefined;
+        max_concurrent_runs?: number | undefined;
+    }, {
+        keys?: string[] | undefined;
+        port?: number | undefined;
+        log_level?: "debug" | "info" | "warn" | "error" | undefined;
+        max_concurrent_runs?: number | undefined;
+    }>>;
+    directories: z.ZodOptional<z.ZodObject<{
+        root: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        log_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        cache_dir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        root?: string | undefined;
+        log_dir?: string | undefined;
+        cache_dir?: string | undefined;
+    }, {
+        root?: string | undefined;
+        log_dir?: string | undefined;
+        cache_dir?: string | undefined;
+    }>>;
+    debug: z.ZodOptional<z.ZodObject<{
+        stream_progress: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        keep_workspace: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        debug_raw_events: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        dry_run: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        strict_script_check: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        strict_host_logging: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        stream_progress?: boolean | undefined;
+        keep_workspace?: boolean | undefined;
+        debug_raw_events?: boolean | undefined;
+        dry_run?: boolean | undefined;
+        strict_script_check?: boolean | undefined;
+        strict_host_logging?: boolean | undefined;
+    }, {
+        stream_progress?: boolean | undefined;
+        keep_workspace?: boolean | undefined;
+        debug_raw_events?: boolean | undefined;
+        dry_run?: boolean | undefined;
+        strict_script_check?: boolean | undefined;
+        strict_host_logging?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    debug?: {
+        stream_progress?: boolean | undefined;
+        keep_workspace?: boolean | undefined;
+        debug_raw_events?: boolean | undefined;
+        dry_run?: boolean | undefined;
+        strict_script_check?: boolean | undefined;
+        strict_host_logging?: boolean | undefined;
+    } | undefined;
+    validation?: {
+        commands?: string[] | undefined;
+        skip_missing_npm_scripts?: boolean | undefined;
+        fail_fast?: boolean | undefined;
+        validate_after_agent_failure?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        validation_allowlist?: string[] | undefined;
+        restore_disallowed_changes?: boolean | undefined;
+        max_diff_bytes?: number | undefined;
+        allow_empty_diff?: boolean | undefined;
+    } | undefined;
+    auth?: {
+        openrouter_api_key_file?: string | undefined;
+        github_app_id_file?: string | undefined;
+        github_app_client_id_file?: string | undefined;
+        github_app_private_key_file?: string | undefined;
+    } | undefined;
+    agent?: {
+        model?: string | undefined;
+        provider?: string | undefined;
+        timeout_seconds?: number | undefined;
+        guardrails?: boolean | undefined;
+    } | undefined;
+    repo?: {
+        url?: string | undefined;
+        ref?: string | undefined;
+        task_mode?: "patch" | "inspect" | undefined;
+    } | undefined;
+    caching?: {
+        dependency_cache_dir?: string | undefined;
+        dependency_restore_mode?: "link" | "copy" | undefined;
+        install_ignore_scripts?: boolean | undefined;
+        npm_omit_dev?: boolean | undefined;
+        image_dependency_cache_dir?: string | undefined;
+        git_cache_mode?: "off" | "mirror" | undefined;
+        git_cache_root?: string | undefined;
+    } | undefined;
+    repo_memory?: {
+        mode?: "off" | "read" | "read-write" | undefined;
+        ttl_days?: number | undefined;
+        max_bytes?: number | undefined;
+    } | undefined;
+    github?: {
+        app_enabled?: boolean | undefined;
+        publish_mode?: "off" | "auto" | "on" | undefined;
+    } | undefined;
+    docker?: {
+        image?: string | undefined;
+        auto_pull?: boolean | undefined;
+        container_user?: string | undefined;
+    } | undefined;
+    api?: {
+        keys?: string[] | undefined;
+        port?: number | undefined;
+        log_level?: "debug" | "info" | "warn" | "error" | undefined;
+        max_concurrent_runs?: number | undefined;
+    } | undefined;
+    directories?: {
+        root?: string | undefined;
+        log_dir?: string | undefined;
+        cache_dir?: string | undefined;
+    } | undefined;
+}, {
+    debug?: {
+        stream_progress?: boolean | undefined;
+        keep_workspace?: boolean | undefined;
+        debug_raw_events?: boolean | undefined;
+        dry_run?: boolean | undefined;
+        strict_script_check?: boolean | undefined;
+        strict_host_logging?: boolean | undefined;
+    } | undefined;
+    validation?: {
+        commands?: string[] | undefined;
+        skip_missing_npm_scripts?: boolean | undefined;
+        fail_fast?: boolean | undefined;
+        validate_after_agent_failure?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        validation_allowlist?: string[] | undefined;
+        restore_disallowed_changes?: boolean | undefined;
+        max_diff_bytes?: number | undefined;
+        allow_empty_diff?: boolean | undefined;
+    } | undefined;
+    auth?: {
+        openrouter_api_key_file?: string | undefined;
+        github_app_id_file?: string | undefined;
+        github_app_client_id_file?: string | undefined;
+        github_app_private_key_file?: string | undefined;
+    } | undefined;
+    agent?: {
+        model?: string | undefined;
+        provider?: string | undefined;
+        timeout_seconds?: number | undefined;
+        guardrails?: boolean | undefined;
+    } | undefined;
+    repo?: {
+        url?: string | undefined;
+        ref?: string | undefined;
+        task_mode?: "patch" | "inspect" | undefined;
+    } | undefined;
+    caching?: {
+        dependency_cache_dir?: string | undefined;
+        dependency_restore_mode?: "link" | "copy" | undefined;
+        install_ignore_scripts?: boolean | undefined;
+        npm_omit_dev?: boolean | undefined;
+        image_dependency_cache_dir?: string | undefined;
+        git_cache_mode?: "off" | "mirror" | undefined;
+        git_cache_root?: string | undefined;
+    } | undefined;
+    repo_memory?: {
+        mode?: "off" | "read" | "read-write" | undefined;
+        ttl_days?: number | undefined;
+        max_bytes?: number | undefined;
+    } | undefined;
+    github?: {
+        app_enabled?: boolean | undefined;
+        publish_mode?: "off" | "auto" | "on" | undefined;
+    } | undefined;
+    docker?: {
+        image?: string | undefined;
+        auto_pull?: boolean | undefined;
+        container_user?: string | undefined;
+    } | undefined;
+    api?: {
+        keys?: string[] | undefined;
+        port?: number | undefined;
+        log_level?: "debug" | "info" | "warn" | "error" | undefined;
+        max_concurrent_runs?: number | undefined;
+    } | undefined;
+    directories?: {
+        root?: string | undefined;
+        log_dir?: string | undefined;
+        cache_dir?: string | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare class ConfigManager {
+    private config;
+    private configFilePath;
+    private loaded;
+    /**
+     * Initialize and load configuration
+     * Loads from: project-local config > user config > environment > defaults
+     */
+    load(overrideConfigPath?: string): Promise<void>;
+    /**
+     * Try to load config from file, return null if file doesn't exist
+     */
+    private tryLoadConfigFile;
+    /**
+     * Apply environment variables to config (lowest priority after files)
+     * Maps KASEKI_* and OPENROUTER_* env vars to config keys
+     */
+    private applyEnvironmentVariables;
+    /**
+     * Deep merge objects (right overwrites left)
+     */
+    private deepMerge;
+    /**
+     * Get entire configuration
+     */
+    getConfig(): Readonly<Config>;
+    /**
+     * Get specific config value by dot-notation path
+     */
+    get<T = any>(path: string, defaultValue?: T): T;
+    /**
+     * Set configuration value
+     */
+    set(path: string, value: any): void;
+    /**
+     * Save configuration to file
+     */
+    save(filePath?: string): Promise<void>;
+    /**
+     * Get config file path (for reference/logging)
+     */
+    getConfigFilePath(): string | null;
+    /**
+     * Reset to defaults
+     */
+    reset(): void;
+}
+//# sourceMappingURL=ConfigManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4Fb,CAAC;AAEb,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAsElD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;IACG,IAAI,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDtD;;OAEG;YACW,iBAAiB;IAiB/B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAyFjC;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC;IAO7B;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAqB/C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAoBnC;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5C;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}