@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/config/helper-model.js

@@ -0,0 +1,187 @@
+/**
+ * Helper Model — lightweight LLM routing for grunt-work tasks.
+ *
+ * Routes tasks like cache planning, compaction, commit messages, etc. to a
+ * cheaper/free model so expensive main models don't waste tokens on routine work.
+ *
+ * Resolution order:
+ *   1. Per-provider helper (helper.providers.{currentProvider}.provider + model)
+ *   2. Global helper (helper.globalProvider + helper.globalModel)
+ *   3. Tool LLM (tools.llmProvider + tools.llmModel) — if configured
+ *   4. Main model (fallback — not a true helper, but ensures the task runs)
+ *
+ * Design constraints:
+ *   - Never throws from HelperModel.chat() — returns empty string on any error
+ *   - Logs failures via logger.debug (non-fatal)
+ *   - Singleton pattern — import `helperModel` for use
+ *   - Tracks token usage separately from the main model
+ */
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+/**
+ * HelperRouter — resolves which model to use for a given helper task.
+ *
+ * Resolution order:
+ *   1. Per-provider helper (helper.providers.{currentProvider}.provider + model)
+ *   2. Global helper (helper.globalProvider + helper.globalModel)
+ *   3. Tool LLM (tools.llmProvider + tools.llmModel) — if configured
+ *   4. Main model (fallback — not a true helper, but ensures the task runs)
+ */
+export class HelperRouter {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Resolve the best helper for the given task.
+     *
+     * Returns null only if no provider can be resolved at all.
+     */
+    resolve(_task) {
+        try {
+            // 1. Check per-provider helper
+            const currentModel = this.deps.providerRegistry.getCurrentModel();
+            const currentProviderName = currentModel.provider ?? '';
+            // Per-provider helpers stored in config as helper.providers.{name}.provider and .model
+            // These are accessed via getCategory since they're nested objects
+            const helperConfig = this.deps.configManager.getCategory('helper');
+            if (helperConfig) {
+                const providers = helperConfig['providers'];
+                if (providers && currentProviderName && providers[currentProviderName]) {
+                    const perProvider = providers[currentProviderName];
+                    if (perProvider.provider && perProvider.model) {
+                        try {
+                            const provider = this.deps.providerRegistry.get(perProvider.provider);
+                            return { provider, modelId: perProvider.model, isHelper: true };
+                        }
+                        catch {
+                            logger.debug(`HelperRouter: per-provider helper ${perProvider.provider} not found, falling through`);
+                        }
+                    }
+                }
+            }
+            // 2. Global helper
+            const globalProvider = this.deps.configManager.get('helper.globalProvider');
+            const globalModel = this.deps.configManager.get('helper.globalModel');
+            if (globalProvider && globalModel) {
+                try {
+                    const provider = this.deps.providerRegistry.get(globalProvider);
+                    return { provider, modelId: globalModel, isHelper: true };
+                }
+                catch {
+                    logger.debug(`HelperRouter: global helper ${globalProvider} not found, falling through`);
+                }
+            }
+            // 3. Tool LLM
+            const toolProvider = this.deps.configManager.get('tools.llmProvider');
+            const toolModel = this.deps.configManager.get('tools.llmModel');
+            if (toolProvider && toolModel) {
+                try {
+                    const provider = this.deps.providerRegistry.get(toolProvider);
+                    return { provider, modelId: toolModel, isHelper: true };
+                }
+                catch {
+                    logger.debug(`HelperRouter: tool LLM ${toolProvider} not found, falling through`);
+                }
+            }
+            // 4. Fallback to main model
+            const mainProvider = this.deps.providerRegistry.getForModel(currentModel.id, currentModel.provider);
+            return { provider: mainProvider, modelId: currentModel.id, isHelper: false };
+        }
+        catch (err) {
+            logger.debug('HelperRouter.resolve: failed', { task: _task, error: summarizeError(err) });
+            return null;
+        }
+    }
+}
+/**
+ * HelperModel — lightweight LLM interface for helper tasks.
+ *
+ * Callers own HelperModel lifetimes explicitly. Never throws — returns empty string on failure.
+ * Tracks token usage separately from the main model.
+ */
+export class HelperModel {
+    deps;
+    router;
+    _usage = { inputTokens: 0, outputTokens: 0, calls: 0 };
+    constructor(deps) {
+        this.deps = deps;
+        this.router = new HelperRouter(deps);
+    }
+    /**
+     * Send a prompt to the helper model for the given task.
+     *
+     * @param task     The helper task type (for routing).
+     * @param prompt   The user prompt to send.
+     * @param options  Optional maxTokens, systemPrompt, helperOnly.
+     * @returns        The assistant's text response, or empty string on failure.
+     */
+    async chat(task, prompt, options = {}) {
+        // When helper is disabled, skip the resolution chain entirely
+        const enabled = this.deps.configManager.get('helper.enabled');
+        if (!enabled) {
+            if (options.helperOnly)
+                return '';
+            // Disabled: bypass helper resolution — use main model directly
+            try {
+                const currentModel = this.deps.providerRegistry.getCurrentModel();
+                const mainProvider = this.deps.providerRegistry.getForModel(currentModel.id, currentModel.provider);
+                const response = await mainProvider.chat({
+                    model: currentModel.id,
+                    messages: [{ role: 'user', content: prompt }],
+                    maxTokens: options.maxTokens ?? 2048,
+                    systemPrompt: options.systemPrompt,
+                });
+                this._usage.inputTokens += response.usage?.inputTokens ?? 0;
+                this._usage.outputTokens += response.usage?.outputTokens ?? 0;
+                this._usage.calls += 1;
+                return response.content ?? '';
+            }
+            catch (err) {
+                logger.debug('HelperModel.chat: main model fallback failed (non-fatal)', { task, error: summarizeError(err) });
+                return '';
+            }
+        }
+        try {
+            const resolved = this.router.resolve(task);
+            if (!resolved) {
+                logger.debug('HelperModel.chat: no provider resolved', { task });
+                return '';
+            }
+            // If helperOnly is set and we fell back to the main model, return empty
+            if (options.helperOnly && !resolved.isHelper) {
+                return '';
+            }
+            const response = await resolved.provider.chat({
+                model: resolved.modelId,
+                messages: [{ role: 'user', content: prompt }],
+                maxTokens: options.maxTokens ?? 2048,
+                systemPrompt: options.systemPrompt,
+            });
+            // Track usage
+            this._usage.inputTokens += response.usage?.inputTokens ?? 0;
+            this._usage.outputTokens += response.usage?.outputTokens ?? 0;
+            this._usage.calls += 1;
+            logger.debug('HelperModel.chat: success', {
+                task,
+                isHelper: resolved.isHelper,
+                modelId: resolved.modelId,
+                inputTokens: response.usage?.inputTokens,
+                outputTokens: response.usage?.outputTokens,
+            });
+            return response.content ?? '';
+        }
+        catch (err) {
+            logger.debug('HelperModel.chat: request failed (non-fatal)', { task, error: summarizeError(err) });
+            return '';
+        }
+    }
+    /** Get cumulative helper usage since last reset. */
+    getUsage() {
+        return { ...this._usage };
+    }
+    /** Reset usage counters. */
+    resetUsage() {
+        this._usage = { inputTokens: 0, outputTokens: 0, calls: 0 };
+    }
+}

package/dist/_internal/platform/config/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Config system barrel export.
+ *
+ * Provides:
+ * - ConfigManager class and all schema types
+ * - Pure helpers that derive values from an explicit ConfigManager instance
+ */
+export { ConfigManager } from './manager.js';
+export type { DeepReadonly } from './manager.js';
+export type { GoodVibesConfig, ConfigKey, ConfigValue, ConfigSetting, PermissionMode, PermissionAction, PermissionsToolConfig, NotificationsConfig } from '@pellux/goodvibes-sdk/platform/config/schema';
+export { DEFAULT_CONFIG, CONFIG_SCHEMA } from '@pellux/goodvibes-sdk/platform/config/schema';
+export { ConfigError } from '@pellux/goodvibes-sdk/platform/types/errors';
+import { ConfigManager } from './manager.js';
+import type { GoodVibesConfig } from '@pellux/goodvibes-sdk/platform/config/schema';
+import { SecretsManager } from './secrets.js';
+export declare function getConfigSnapshot(configManager: Pick<ConfigManager, 'getRaw'>): Readonly<GoodVibesConfig>;
+export declare function getConfiguredModelId(configManager: Pick<ConfigManager, 'get'>): string;
+export declare function getConfiguredProviderId(configManager: Pick<ConfigManager, 'get'>): string;
+export declare function getConfiguredEmbeddingProviderId(configManager: Pick<ConfigManager, 'get'>): string;
+export declare function isAutoApproveEnabled(configManager: Pick<ConfigManager, 'get'>): boolean;
+export declare function getWorkingDirectory(configManager: Pick<ConfigManager, 'getWorkingDirectory'>): string | null;
+export declare function getConfiguredSystemPrompt(configManager: Pick<ConfigManager, 'get'>): string | undefined;
+export declare function getConfiguredApiKeys(): Record<string, string>;
+/**
+ * resolveApiKeys — three-tier async resolution for all provider API keys.
+ *
+ * Resolution order per key:
+ *   1. Environment variable (process.env)
+ *   2. SecretsManager hierarchy-aware stores (secure preferred, plaintext policy-aware)
+ *   3. Omitted from result (null → skip)
+ *
+ * Returns a map of provider → apiKey for all providers where a key is found.
+ */
+export declare function resolveApiKeys(secrets: Pick<SecretsManager, 'get'>): Promise<Record<string, string>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACzM,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAG1E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAEzG;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,CAEzF;AAED,wBAAgB,gCAAgC,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,CAElG;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,GAAG,MAAM,GAAG,IAAI,CAE5G;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,CASvG;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7D;AAwDD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkEjC"}

package/dist/_internal/platform/config/index.js

@@ -0,0 +1,182 @@
+/**
+ * Config system barrel export.
+ *
+ * Provides:
+ * - ConfigManager class and all schema types
+ * - Pure helpers that derive values from an explicit ConfigManager instance
+ */
+export { ConfigManager } from './manager.js';
+export { DEFAULT_CONFIG, CONFIG_SCHEMA } from '@pellux/goodvibes-sdk/platform/config/schema';
+export { ConfigError } from '@pellux/goodvibes-sdk/platform/types/errors';
+import { readFileSync } from 'fs';
+import { ConfigManager } from './manager.js';
+import { SecretsManager } from './secrets.js';
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+export function getConfigSnapshot(configManager) {
+    return configManager.getRaw();
+}
+export function getConfiguredModelId(configManager) {
+    return configManager.get('provider.model');
+}
+export function getConfiguredProviderId(configManager) {
+    return configManager.get('provider.provider');
+}
+export function getConfiguredEmbeddingProviderId(configManager) {
+    return configManager.get('provider.embeddingProvider');
+}
+export function isAutoApproveEnabled(configManager) {
+    return configManager.get('behavior.autoApprove');
+}
+export function getWorkingDirectory(configManager) {
+    return configManager.getWorkingDirectory();
+}
+export function getConfiguredSystemPrompt(configManager) {
+    const file = configManager.get('provider.systemPromptFile');
+    if (!file)
+        return undefined;
+    try {
+        return readFileSync(file, 'utf-8');
+    }
+    catch (err) {
+        logger.debug('systemPrompt file read failed (non-fatal)', { file, error: summarizeError(err) });
+        return undefined;
+    }
+}
+export function getConfiguredApiKeys() {
+    return loadEnvApiKeys();
+}
+function loadEnvApiKeys() {
+    const keys = {};
+    const mapping = {
+        openai: 'OPENAI_API_KEY',
+        anthropic: 'ANTHROPIC_API_KEY',
+        gemini: 'GEMINI_API_KEY',
+        inceptionlabs: 'INCEPTION_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
+        aihubmix: 'AIHUBMIX_API_KEY',
+        groq: 'GROQ_API_KEY',
+        cerebras: 'CEREBRAS_API_KEY',
+        mistral: 'MISTRAL_API_KEY',
+        'ollama-cloud': 'OLLAMA_CLOUD_API_KEY',
+        // Note: also checked as OLLAMA_API_KEY below
+        huggingface: 'HF_API_KEY',
+        nvidia: 'NVIDIA_API_KEY',
+        llm7: 'LLM7_API_KEY',
+        deepseek: 'DEEPSEEK_API_KEY',
+        fireworks: 'FIREWORKS_API_KEY',
+        'github-copilot': 'COPILOT_GITHUB_TOKEN',
+        'microsoft-foundry': 'AZURE_OPENAI_API_KEY',
+        minimax: 'MINIMAX_API_KEY',
+        moonshot: 'MOONSHOT_API_KEY',
+        qianfan: 'QIANFAN_API_KEY',
+        qwen: 'QWEN_API_KEY',
+        sglang: 'SGLANG_API_KEY',
+        stepfun: 'STEPFUN_API_KEY',
+        together: 'TOGETHER_API_KEY',
+        venice: 'VENICE_API_KEY',
+        volcengine: 'VOLCANO_ENGINE_API_KEY',
+        xai: 'XAI_API_KEY',
+        xiaomi: 'XIAOMI_API_KEY',
+        zai: 'ZAI_API_KEY',
+        'cloudflare-ai-gateway': 'CLOUDFLARE_AI_GATEWAY_API_KEY',
+        'vercel-ai-gateway': 'AI_GATEWAY_API_KEY',
+        litellm: 'LITELLM_API_KEY',
+        'copilot-proxy': 'COPILOT_PROXY_API_KEY',
+    };
+    for (const [prov, envVar] of Object.entries(mapping)) {
+        let value = process.env[envVar];
+        // Fallback env var names
+        if (!value && prov === 'gemini')
+            value = process.env['GOOGLE_API_KEY'] ?? process.env['GOOGLE_GEMINI_API_KEY'];
+        if (!value && prov === 'openai')
+            value = process.env['OPENAI_KEY'];
+        if (!value && prov === 'anthropic')
+            value = process.env['CLAUDE_API_KEY'];
+        if (!value && prov === 'ollama-cloud')
+            value = process.env['OLLAMA_API_KEY'];
+        if (!value && prov === 'huggingface')
+            value = process.env['HUGGINGFACE_API_KEY'] ?? process.env['HF_TOKEN'];
+        if (!value && prov === 'github-copilot')
+            value = process.env['GH_TOKEN'] ?? process.env['GITHUB_TOKEN'];
+        if (!value && prov === 'qwen')
+            value = process.env['DASHSCOPE_API_KEY'] ?? process.env['MODELSTUDIO_API_KEY'];
+        if (!value && prov === 'zai')
+            value = process.env['Z_AI_API_KEY'];
+        if (value)
+            keys[prov] = value;
+    }
+    return keys;
+}
+/**
+ * resolveApiKeys — three-tier async resolution for all provider API keys.
+ *
+ * Resolution order per key:
+ *   1. Environment variable (process.env)
+ *   2. SecretsManager hierarchy-aware stores (secure preferred, plaintext policy-aware)
+ *   3. Omitted from result (null → skip)
+ *
+ * Returns a map of provider → apiKey for all providers where a key is found.
+ */
+export async function resolveApiKeys(secrets) {
+    const mapping = [
+        { prov: 'openai', envVars: ['OPENAI_API_KEY', 'OPENAI_KEY'] },
+        { prov: 'anthropic', envVars: ['ANTHROPIC_API_KEY', 'CLAUDE_API_KEY'] },
+        { prov: 'gemini', envVars: ['GEMINI_API_KEY', 'GOOGLE_API_KEY', 'GOOGLE_GEMINI_API_KEY'] },
+        { prov: 'inceptionlabs', envVars: ['INCEPTION_API_KEY'] },
+        { prov: 'openrouter', envVars: ['OPENROUTER_API_KEY'] },
+        { prov: 'aihubmix', envVars: ['AIHUBMIX_API_KEY'] },
+        { prov: 'groq', envVars: ['GROQ_API_KEY'] },
+        { prov: 'cerebras', envVars: ['CEREBRAS_API_KEY'] },
+        { prov: 'mistral', envVars: ['MISTRAL_API_KEY'] },
+        { prov: 'ollama-cloud', envVars: ['OLLAMA_CLOUD_API_KEY', 'OLLAMA_API_KEY'] },
+        { prov: 'huggingface', envVars: ['HF_API_KEY', 'HUGGINGFACE_API_KEY', 'HF_TOKEN'] },
+        { prov: 'nvidia', envVars: ['NVIDIA_API_KEY'] },
+        { prov: 'llm7', envVars: ['LLM7_API_KEY'] },
+        { prov: 'deepseek', envVars: ['DEEPSEEK_API_KEY'] },
+        { prov: 'fireworks', envVars: ['FIREWORKS_API_KEY'] },
+        { prov: 'github-copilot', envVars: ['COPILOT_GITHUB_TOKEN', 'GH_TOKEN', 'GITHUB_TOKEN'] },
+        { prov: 'microsoft-foundry', envVars: ['AZURE_OPENAI_API_KEY'] },
+        { prov: 'minimax', envVars: ['MINIMAX_API_KEY'] },
+        { prov: 'moonshot', envVars: ['MOONSHOT_API_KEY'] },
+        { prov: 'qianfan', envVars: ['QIANFAN_API_KEY'] },
+        { prov: 'qwen', envVars: ['QWEN_API_KEY', 'DASHSCOPE_API_KEY', 'MODELSTUDIO_API_KEY'] },
+        { prov: 'sglang', envVars: ['SGLANG_API_KEY'] },
+        { prov: 'stepfun', envVars: ['STEPFUN_API_KEY'] },
+        { prov: 'together', envVars: ['TOGETHER_API_KEY'] },
+        { prov: 'venice', envVars: ['VENICE_API_KEY'] },
+        { prov: 'volcengine', envVars: ['VOLCANO_ENGINE_API_KEY'] },
+        { prov: 'xai', envVars: ['XAI_API_KEY'] },
+        { prov: 'xiaomi', envVars: ['XIAOMI_API_KEY'] },
+        { prov: 'zai', envVars: ['ZAI_API_KEY', 'Z_AI_API_KEY'] },
+        { prov: 'cloudflare-ai-gateway', envVars: ['CLOUDFLARE_AI_GATEWAY_API_KEY'] },
+        { prov: 'vercel-ai-gateway', envVars: ['AI_GATEWAY_API_KEY'] },
+        { prov: 'litellm', envVars: ['LITELLM_API_KEY'] },
+        { prov: 'copilot-proxy', envVars: ['COPILOT_PROXY_API_KEY'] },
+    ];
+    const result = {};
+    for (const { prov, envVars } of mapping) {
+        // Tier 1: environment variables
+        let value = null;
+        for (const envVar of envVars) {
+            if (process.env[envVar]) {
+                value = process.env[envVar];
+                break;
+            }
+        }
+        // Tier 2: SecretsManager hierarchy-aware secure/plaintext stores
+        if (value === null) {
+            for (const envVar of envVars) {
+                const stored = await secrets.get(envVar);
+                if (stored !== null) {
+                    value = stored;
+                    break;
+                }
+            }
+        }
+        if (value !== null) {
+            result[prov] = value;
+        }
+    }
+    return result;
+}

package/dist/_internal/platform/config/manager.d.ts

@@ -0,0 +1,91 @@
+import type { GoodVibesConfig, ConfigKey, ConfigValue, ConfigSetting } from '@pellux/goodvibes-sdk/platform/config/schema';
+import type { HookDispatcher } from '../hooks/index.js';
+/** Deep immutable type — prevents mutation of nested objects returned from getAll(). */
+export type DeepReadonly<T> = {
+    readonly [K in keyof T]: T[K] extends object ? DeepReadonly<T[K]> : T[K];
+};
+/** Constructor overrides for CLI args and programmatic instantiation. */
+interface ConfigCliOverrides {
+    model?: string;
+    provider?: string;
+    autoApprove?: boolean;
+    systemPromptFile?: string;
+    workingDir?: string;
+}
+export type ConfigOverrides = ConfigCliOverrides & ({
+    configDir: string;
+    homeDir?: string;
+    sharedConfigPath?: string;
+} | {
+    homeDir: string;
+    configDir?: string;
+    sharedConfigPath?: string;
+});
+export interface ConfigSetOptions {
+    bypassManagedLock?: boolean;
+}
+/**
+ * ConfigManager — Layered, mutable, persistent config system.
+ *
+ * Load order: defaults < global TUI settings < project TUI settings < CLI overrides
+ * API keys are never persisted — loaded from env vars only.
+ */
+export declare class ConfigManager {
+    private config;
+    private readonly configDir;
+    private readonly configPath;
+    private readonly projectConfigPath;
+    private readonly workingDirectory;
+    private readonly homeDirectory;
+    private hookDispatcher;
+    constructor(overrides: ConfigOverrides);
+    getControlPlaneConfigDir(): string;
+    getWorkingDirectory(): string | null;
+    getHomeDirectory(): string | null;
+    attachHookDispatcher(hookDispatcher: Pick<HookDispatcher, 'fire'> | null): void;
+    private resolvePath;
+    /** Get a config value by dot-path key. */
+    get<K extends ConfigKey>(key: K): ConfigValue<K>;
+    /** Set a config value by dot-path key and auto-save to disk. */
+    set<K extends ConfigKey>(key: K, value: ConfigValue<K>, options?: ConfigSetOptions): void;
+    /**
+     * Fire the Change:config hook for a config key change.
+     * Best-effort: the hook dispatcher may not be initialised during startup.
+     */
+    private emitConfigHook;
+    /**
+     * Set a config value from a validated ConfigKey with unknown value type.
+     * Used when iterating schema entries where the value type cannot be statically
+     * inferred. Runtime validation is still applied by the underlying set() method.
+     */
+    setDynamic(key: ConfigKey, value: unknown, options?: ConfigSetOptions): void;
+    /** Return a deep-readonly snapshot of the full config. Nested objects are immutable. */
+    getAll(): DeepReadonly<GoodVibesConfig>;
+    /** Return a deep-cloned snapshot of a config category. */
+    getCategory<C extends keyof GoodVibesConfig>(category: C): Readonly<GoodVibesConfig[C]>;
+    /** Return a deep-cloned snapshot of the live config. Safe for read-only external consumers. */
+    getRaw(): Readonly<GoodVibesConfig>;
+    /** Return the full schema. */
+    getSchema(): ConfigSetting[];
+    /** Persist current config to global TUI settings file. */
+    save(): void;
+    /** Persist current config to project-level TUI settings file (.goodvibes/goodvibes/settings.json). */
+    saveProject(): void;
+    /** Load config from disk: global then project (project wins). Deep-merges with defaults. */
+    load(): void;
+    /**
+     * Merge a partial patch into a config category and auto-save.
+     *
+     * This is the correct way to update array or object fields within a category
+     * that cannot be expressed as a scalar dot-path key (e.g. notifications.webhookUrls).
+     * The patch is shallow-merged into the existing category value.
+     */
+    mergeCategory<C extends keyof GoodVibesConfig>(category: C, patch: Partial<GoodVibesConfig[C]>): void;
+    /**
+     * Reset a specific key to its default, or reset all config.
+     * Saves to disk after reset.
+     */
+    reset(key?: ConfigKey): void;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

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