@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/config/index.js

@@ -5,8 +5,8 @@ import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAge
 import { FILENAMES, WORKSPACE_FILES, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentHomeDir, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.js";
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
-import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
-import { init_loader, loadConfig, registerChannelConfigValidator, saveConfig } from "./loader.js";
+import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
+import { init_loader, loadConfig, saveConfig } from "./loader.js";
 import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
 import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
@@ -27,6 +27,6 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
+export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
 
 //# sourceMappingURL=index.js.map

package/dist/src/config/integration.d.ts

@@ -1,7 +1,7 @@
 /**
  * Model-related configuration (documentation only):
  *
- * - Main config: `ConfigSchema` (agents.defaults.model, gateway, channels, etc.).
+ * - Main config: `ConfigSchema` (agents.defaults.models, gateway, channels, etc.).
  * - LLM API keys: `CredentialResolver` / auth profiles (Gateway PATCH /api/config `providers`, CLI onboard).
  * - Overrides and custom providers: `~/.xopc/models.json`.
  */

package/dist/src/config/loader.d.ts

@@ -1,5 +1,4 @@
 import { type Config } from './schema.js';
-export declare function registerChannelConfigValidator(fn: (cfg: Config) => void): void;
 /**
  * Load configuration from file
  * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json

package/dist/src/config/loader.js

@@ -4,16 +4,11 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveConfigPath } from "./paths.js";
 import { ConfigSchema, init_schema } from "./schema.js";
+import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
 import { dirname } from "path";
 import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { config } from "dotenv";
 //#region src/config/loader.ts
-function registerChannelConfigValidator(fn) {
-	channelConfigValidator = fn;
-}
-function assertChannelPluginConfigs(cfg) {
-	channelConfigValidator?.(cfg);
-}
 /**
 * Rotate config backups before writing new config.
 * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.
@@ -78,18 +73,18 @@ async function saveConfig(config, configPath) {
 	}
 	await writeTextAtomic(path, content);
 }
-var log, channelConfigValidator, CONFIG_BACKUP_COUNT;
+var log, CONFIG_BACKUP_COUNT;
 var init_loader = __esmMin((() => {
 	init_write_file_atomic();
 	init_schema();
 	init_paths();
 	init_logger();
+	init_validate_channel_configs();
 	log = createLogger("ConfigLoader");
-	channelConfigValidator = null;
 	CONFIG_BACKUP_COUNT = 10;
 }));
 //#endregion
 init_loader();
-export { init_loader, loadConfig, registerChannelConfigValidator, resolveConfigPath, saveConfig };
+export { init_loader, loadConfig, resolveConfigPath, saveConfig };
 
 //# sourceMappingURL=loader.js.map

package/dist/src/config/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","names":["fsPromises"],"sources":["../../../src/config/loader.ts"],"sourcesContent":["import { readFileSync, existsSync, mkdirSync, promises as fsPromises } from 'fs';\nimport { dirname } from 'path';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { type Config, ConfigSchema } from './schema.js';\nimport { resolveConfigPath } from './paths.js';\nimport { config } from 'dotenv';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('ConfigLoader');\n\n/**\n * Optional channel config validator injected at startup to avoid a circular\n * dependency: loader → validate-channel-configs → bundled-channel-plugins →\n * telegram/command-handler → providers → sync-provider-auth → loader.\n *\n * Call {@link registerChannelConfigValidator} once during application startup\n * (after all channel plugins are loaded) to enable validation.\n */\nlet channelConfigValidator: ((cfg: Config) => void) | null = null;\n\nexport function registerChannelConfigValidator(fn: (cfg: Config) => void): void {\n  channelConfigValidator = fn;\n}\n\nfunction assertChannelPluginConfigs(cfg: Config): void {\n  channelConfigValidator?.(cfg);\n}\n\n/** Number of backup files to keep */\nconst CONFIG_BACKUP_COUNT = 10;\n\n/**\n * Rotate config backups before writing new config.\n * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.\n */\nasync function rotateConfigBackups(configPath: string): Promise<void> {\n  if (CONFIG_BACKUP_COUNT <= 1) {\n    return;\n  }\n\n  const backupBase = `${configPath}.bak`;\n  const maxIndex = CONFIG_BACKUP_COUNT - 1;\n\n  // Delete oldest backup\n  try {\n    await fsPromises.unlink(`${backupBase}.${maxIndex}`);\n  } catch {\n    // best-effort: file may not exist\n  }\n\n  // Rotate existing backups: .bak.2 -> .bak.3, .bak.1 -> .bak.2, etc.\n  for (let index = maxIndex - 1; index >= 1; index--) {\n    try {\n      await fsPromises.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`);\n    } catch {\n      // best-effort: file may not exist\n    }\n  }\n\n  // Move .bak to .bak.1\n  try {\n    await fsPromises.rename(backupBase, `${backupBase}.1`);\n  } catch {\n    // best-effort: file may not exist\n  }\n}\n\n/**\n * Load configuration from file\n * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json\n */\nexport function loadConfig(configPath?: string): Config {\n  // dotenv ≥17 logs to stdout on every `config()` unless quiet; `loadConfig` runs from many call sites.\n  config({ quiet: true });\n\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  if (existsSync(path)) {\n    try {\n      const content = readFileSync(path, 'utf-8');\n      const json = JSON.parse(content);\n      const cfg = ConfigSchema.parse(json);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    } catch (error) {\n      log.error({ err: error, path }, `Failed to load config`);\n      const cfg = ConfigSchema.parse(undefined);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    }\n  }\n\n  const cfg = ConfigSchema.parse(undefined);\n  assertChannelPluginConfigs(cfg);\n  return cfg;\n}\n\n/**\n * Save configuration to file\n * @param config Configuration object to save\n * @param configPath Optional custom config path\n */\nexport async function saveConfig(config: Config, configPath?: string): Promise<void> {\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const validated = ConfigSchema.parse(config);\n  assertChannelPluginConfigs(validated);\n  const content = JSON.stringify(validated, null, 2);\n\n  // Backup existing config before writing\n  if (existsSync(path)) {\n    await rotateConfigBackups(path);\n    try {\n      // Copy current config to .bak as the latest backup\n      await fsPromises.copyFile(path, `${path}.bak`);\n    } catch {\n      // best-effort: backup copy may fail\n    }\n  }\n\n  await writeTextAtomic(path, content);\n}\n\nexport { resolveConfigPath } from './paths.js';\n"],"mappings":";;;;;;;;;;AAoBA,SAAgB,+BAA+B,IAAiC;AAC9E,0BAAyB;;AAG3B,SAAS,2BAA2B,KAAmB;AACrD,0BAAyB,IAAI;;;;;;AAU/B,eAAe,oBAAoB,YAAmC;AACpE,KAAI,uBAAuB,EACzB;CAGF,MAAM,aAAa,GAAG,WAAW;CACjC,MAAM,WAAW,sBAAsB;AAGvC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,WAAW;SAC9C;AAKR,MAAK,IAAI,QAAQ,WAAW,GAAG,SAAS,GAAG,QACzC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,IAAI;SACzE;AAMV,KAAI;AACF,QAAMA,SAAW,OAAO,YAAY,GAAG,WAAW,IAAI;SAChD;;;;;;AASV,SAAgB,WAAW,YAA6B;AAEtD,QAAO,EAAE,OAAO,MAAM,CAAC;CAEvB,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;AAE9E,KAAI,WAAW,KAAK,CAClB,KAAI;EACF,MAAM,UAAU,aAAa,MAAM,QAAQ;EAC3C,MAAM,OAAO,KAAK,MAAM,QAAQ;EAChC,MAAM,MAAM,aAAa,MAAM,KAAK;AACpC,6BAA2B,IAAI;AAC/B,SAAO;UACA,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAM,EAAE,wBAAwB;EACxD,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,6BAA2B,IAAI;AAC/B,SAAO;;CAIX,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,4BAA2B,IAAI;AAC/B,QAAO;;;;;;;AAQT,eAAsB,WAAW,QAAgB,YAAoC;CACnF,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;CAE9E,MAAM,MAAM,QAAQ,KAAK;AACzB,KAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;CAGrC,MAAM,YAAY,aAAa,MAAM,OAAO;AAC5C,4BAA2B,UAAU;CACrC,MAAM,UAAU,KAAK,UAAU,WAAW,MAAM,EAAE;AAGlD,KAAI,WAAW,KAAK,EAAE;AACpB,QAAM,oBAAoB,KAAK;AAC/B,MAAI;AAEF,SAAMA,SAAW,SAAS,MAAM,GAAG,KAAK,MAAM;UACxC;;AAKV,OAAM,gBAAgB,MAAM,QAAQ;;;;yBA3H0B;cACR;aACT;cAEG;AAE5C,OAAM,aAAa,eAAe;AAUpC,0BAAyD;AAWvD,uBAAsB"}
+{"version":3,"file":"loader.js","names":["fsPromises"],"sources":["../../../src/config/loader.ts"],"sourcesContent":["import { readFileSync, existsSync, mkdirSync, promises as fsPromises } from 'fs';\nimport { dirname } from 'path';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { type Config, ConfigSchema } from './schema.js';\nimport { resolveConfigPath } from './paths.js';\nimport { config } from 'dotenv';\nimport { createLogger } from '../utils/logger.js';\nimport { assertChannelPluginConfigs } from './validate-channel-configs.js';\n\nconst log = createLogger('ConfigLoader');\n\n/** Number of backup files to keep */\nconst CONFIG_BACKUP_COUNT = 10;\n\n/**\n * Rotate config backups before writing new config.\n * Creates a backup chain: xopc.json.bak, xopc.json.bak.1, xopc.json.bak.2, etc.\n */\nasync function rotateConfigBackups(configPath: string): Promise<void> {\n  if (CONFIG_BACKUP_COUNT <= 1) {\n    return;\n  }\n\n  const backupBase = `${configPath}.bak`;\n  const maxIndex = CONFIG_BACKUP_COUNT - 1;\n\n  // Delete oldest backup\n  try {\n    await fsPromises.unlink(`${backupBase}.${maxIndex}`);\n  } catch {\n    // best-effort: file may not exist\n  }\n\n  // Rotate existing backups: .bak.2 -> .bak.3, .bak.1 -> .bak.2, etc.\n  for (let index = maxIndex - 1; index >= 1; index--) {\n    try {\n      await fsPromises.rename(`${backupBase}.${index}`, `${backupBase}.${index + 1}`);\n    } catch {\n      // best-effort: file may not exist\n    }\n  }\n\n  // Move .bak to .bak.1\n  try {\n    await fsPromises.rename(backupBase, `${backupBase}.1`);\n  } catch {\n    // best-effort: file may not exist\n  }\n}\n\n/**\n * Load configuration from file\n * @param configPath Optional custom config path, defaults to XOPC_CONFIG_PATH or ~/.xopc/xopc.json\n */\nexport function loadConfig(configPath?: string): Config {\n  // dotenv ≥17 logs to stdout on every `config()` unless quiet; `loadConfig` runs from many call sites.\n  config({ quiet: true });\n\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  if (existsSync(path)) {\n    try {\n      const content = readFileSync(path, 'utf-8');\n      const json = JSON.parse(content);\n      const cfg = ConfigSchema.parse(json);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    } catch (error) {\n      log.error({ err: error, path }, `Failed to load config`);\n      const cfg = ConfigSchema.parse(undefined);\n      assertChannelPluginConfigs(cfg);\n      return cfg;\n    }\n  }\n\n  const cfg = ConfigSchema.parse(undefined);\n  assertChannelPluginConfigs(cfg);\n  return cfg;\n}\n\n/**\n * Save configuration to file\n * @param config Configuration object to save\n * @param configPath Optional custom config path\n */\nexport async function saveConfig(config: Config, configPath?: string): Promise<void> {\n  const path = configPath || process.env.XOPC_CONFIG_PATH || resolveConfigPath();\n\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const validated = ConfigSchema.parse(config);\n  assertChannelPluginConfigs(validated);\n  const content = JSON.stringify(validated, null, 2);\n\n  // Backup existing config before writing\n  if (existsSync(path)) {\n    await rotateConfigBackups(path);\n    try {\n      // Copy current config to .bak as the latest backup\n      await fsPromises.copyFile(path, `${path}.bak`);\n    } catch {\n      // best-effort: backup copy may fail\n    }\n  }\n\n  await writeTextAtomic(path, content);\n}\n\nexport { resolveConfigPath } from './paths.js';\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,eAAe,oBAAoB,YAAmC;AACpE,KAAI,uBAAuB,EACzB;CAGF,MAAM,aAAa,GAAG,WAAW;CACjC,MAAM,WAAW,sBAAsB;AAGvC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,WAAW;SAC9C;AAKR,MAAK,IAAI,QAAQ,WAAW,GAAG,SAAS,GAAG,QACzC,KAAI;AACF,QAAMA,SAAW,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,IAAI;SACzE;AAMV,KAAI;AACF,QAAMA,SAAW,OAAO,YAAY,GAAG,WAAW,IAAI;SAChD;;;;;;AASV,SAAgB,WAAW,YAA6B;AAEtD,QAAO,EAAE,OAAO,MAAM,CAAC;CAEvB,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;AAE9E,KAAI,WAAW,KAAK,CAClB,KAAI;EACF,MAAM,UAAU,aAAa,MAAM,QAAQ;EAC3C,MAAM,OAAO,KAAK,MAAM,QAAQ;EAChC,MAAM,MAAM,aAAa,MAAM,KAAK;AACpC,6BAA2B,IAAI;AAC/B,SAAO;UACA,OAAO;AACd,MAAI,MAAM;GAAE,KAAK;GAAO;GAAM,EAAE,wBAAwB;EACxD,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,6BAA2B,IAAI;AAC/B,SAAO;;CAIX,MAAM,MAAM,aAAa,MAAM,KAAA,EAAU;AACzC,4BAA2B,IAAI;AAC/B,QAAO;;;;;;;AAQT,eAAsB,WAAW,QAAgB,YAAoC;CACnF,MAAM,OAAO,cAAc,QAAQ,IAAI,oBAAoB,mBAAmB;CAE9E,MAAM,MAAM,QAAQ,KAAK;AACzB,KAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;CAGrC,MAAM,YAAY,aAAa,MAAM,OAAO;AAC5C,4BAA2B,UAAU;CACrC,MAAM,UAAU,KAAK,UAAU,WAAW,MAAM,EAAE;AAGlD,KAAI,WAAW,KAAK,EAAE;AACpB,QAAM,oBAAoB,KAAK;AAC/B,MAAI;AAEF,SAAMA,SAAW,SAAS,MAAM,GAAG,KAAK,MAAM;UACxC;;AAKV,OAAM,gBAAgB,MAAM,QAAQ;;;;yBA1G0B;cACR;aACT;cAEG;gCACyB;AAErE,OAAM,aAAa,eAAe;AAGlC,uBAAsB"}

package/dist/src/config/models-json.d.ts

@@ -88,8 +88,8 @@ export declare const CustomModelSchema: z.ZodObject<{
     }>>;
     reasoning: z.ZodOptional<z.ZodBoolean>;
     input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         image: "image";
+        text: "text";
     }>>>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -133,8 +133,8 @@ export declare const ModelOverrideSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodBoolean>;
     input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        text: "text";
         image: "image";
+        text: "text";
     }>>>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -206,8 +206,8 @@ export declare const ProviderConfigSchema: z.ZodObject<{
         }>>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
         input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            text: "text";
             image: "image";
+            text: "text";
         }>>>;
         contextWindow: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -251,8 +251,8 @@ export declare const ProviderConfigSchema: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
         input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            text: "text";
             image: "image";
+            text: "text";
         }>>>;
         contextWindow: z.ZodOptional<z.ZodNumber>;
         maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -326,8 +326,8 @@ export declare const ModelsJsonSchema: z.ZodObject<{
             }>>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
             input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                text: "text";
                 image: "image";
+                text: "text";
             }>>>;
             contextWindow: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
@@ -371,8 +371,8 @@ export declare const ModelsJsonSchema: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             reasoning: z.ZodOptional<z.ZodBoolean>;
             input: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                text: "text";
                 image: "image";
+                text: "text";
             }>>>;
             contextWindow: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;

package/dist/src/config/rules.js

@@ -1,5 +1,3 @@
-import { listChannelPlugins } from "../channels/plugins/registry.js";
-import { bundledChannelPlugins } from "../generated/bundled-channel-plugins.js";
 //#region src/config/rules.ts
 /**
 * Base reload rules for config paths
@@ -16,7 +14,7 @@ const BASE_RELOAD_RULES = [
 		description: "Model merge mode"
 	},
 	{
-		prefix: "agents.defaults.model",
+		prefix: "agents.defaults.models",
 		kind: "hot",
 		description: "Model configuration"
 	},
@@ -236,16 +234,8 @@ const BASE_RELOAD_RULES = [
 		description: "Tunnel broker and auto-start settings"
 	}
 ];
-function pluginsForReloadRules() {
-	const listed = listChannelPlugins();
-	return listed.length > 0 ? [...listed] : [...bundledChannelPlugins];
-}
 function getChannelReloadRules() {
-	return pluginsForReloadRules().filter((plugin) => plugin.reload?.configPrefixes?.length).flatMap((plugin) => plugin.reload.configPrefixes.map((prefix) => ({
-		prefix,
-		kind: "hot",
-		description: `${plugin.meta.label} settings`
-	})));
+	return [];
 }
 function mergedReloadRules() {
 	return [...BASE_RELOAD_RULES, ...getChannelReloadRules()];

package/dist/src/config/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","names":[],"sources":["../../../src/config/rules.ts"],"sourcesContent":["/**\n * Configuration reload rules\n * \n * Defines how different config paths are handled:\n * - hot: Apply changes immediately without restart\n * - restart: Require gateway restart\n * - none: Ignore changes (no action needed)\n */\n\nimport type { ChannelPlugin } from '../channels/plugin-types.js';\nimport { bundledChannelPlugins } from '../generated/bundled-channel-plugins.js';\nimport { listChannelPlugins } from '../channels/plugins/registry.js';\n\nexport type ReloadKind = 'hot' | 'restart' | 'none';\n\nexport interface ReloadRule {\n  prefix: string;\n  kind: ReloadKind;\n  description?: string;\n}\n\nexport interface ReloadPlan {\n  changedPaths: string[];\n  hotPaths: string[];\n  restartPaths: string[];\n  noopPaths: string[];\n  requiresRestart: boolean;\n  requiresHotReload: boolean;\n}\n\n/**\n * Base reload rules for config paths\n */\nexport const BASE_RELOAD_RULES: ReloadRule[] = [\n  // Models config - hot reload\n  { prefix: 'models.providers', kind: 'hot', description: 'Model provider API keys, base URLs' },\n  { prefix: 'models.mode', kind: 'hot', description: 'Model merge mode' },\n  \n  // Agent defaults - hot reload\n  { prefix: 'agents.defaults.model', kind: 'hot', description: 'Model configuration' },\n  { prefix: 'agents.defaults.maxTaskDurationMs', kind: 'hot', description: 'Per-turn wall-clock timeout (ms)' },\n  { prefix: 'agents.defaults.maxTokens', kind: 'hot', description: 'Max tokens' },\n  { prefix: 'agents.defaults.temperature', kind: 'hot', description: 'Temperature' },\n  { prefix: 'agents.defaults.maxToolIterations', kind: 'hot', description: 'Max tool iterations' },\n  { prefix: 'agents.defaults.compaction', kind: 'hot', description: 'Compaction settings' },\n  { prefix: 'agents.defaults.pruning', kind: 'hot', description: 'Pruning settings' },\n  { prefix: 'agents.defaults.webExtract', kind: 'hot', description: 'Web extract model and limits' },\n  { prefix: 'agents.defaults.browser', kind: 'hot', description: 'Browser automation (Playwright) tools' },\n  { prefix: 'agents.defaults.delegate', kind: 'hot', description: 'delegate_task sub-agent tool' },\n  { prefix: 'agents.defaults.executeCode', kind: 'hot', description: 'execute_code sandbox tool' },\n  {\n    prefix: 'agents.defaults.backgroundReview',\n    kind: 'hot',\n    description: 'Post-turn memory/skill nudge + background review',\n  },\n  { prefix: 'agents.defaults.workspace', kind: 'none', description: 'Workspace path - no runtime effect' },\n  \n  // Gateway - restart required\n  { prefix: 'gateway.bind', kind: 'restart', description: 'Gateway bind mode' },\n  { prefix: 'gateway.customBindHost', kind: 'restart', description: 'Gateway custom bind host' },\n  { prefix: 'gateway.port', kind: 'restart', description: 'Port number' },\n  { prefix: 'gateway.mode', kind: 'restart', description: 'Gateway local/remote CLI mode' },\n  { prefix: 'gateway.remote', kind: 'restart', description: 'Remote gateway CLI target' },\n  { prefix: 'gateway.tailscale', kind: 'restart', description: 'Tailscale Serve/Funnel exposure' },\n  { prefix: 'gateway.tls', kind: 'restart', description: 'Gateway native TLS' },\n  { prefix: 'gateway.auth', kind: 'restart', description: 'Authentication settings' },\n  { prefix: 'gateway.security', kind: 'restart', description: 'Gateway security policy' },\n  { prefix: 'gateway.corsOrigins', kind: 'restart', description: 'CORS settings' },\n  { prefix: 'gateway.trustedProxies', kind: 'restart', description: 'Trusted reverse proxy CIDRs' },\n  {\n    prefix: 'gateway.allowRealIpFallback',\n    kind: 'restart',\n    description: 'Trusted-proxy X-Real-IP fallback',\n  },\n  {\n    prefix: 'gateway.dangerouslyAllowHostHeaderOriginFallback',\n    kind: 'restart',\n    description: 'Host-header origin fallback',\n  },\n  { prefix: 'gateway.maxSseConnections', kind: 'restart', description: 'SSE connection limit' },\n  { prefix: 'gateway.channelConnectDeferMode', kind: 'restart', description: 'Channel connect defer mode' },\n  { prefix: 'gateway.channelConnectDeferIds', kind: 'restart', description: 'Explicit channel connect defer list' },\n  { prefix: 'gateway.channelConnectDeferSkipIds', kind: 'restart', description: 'Channel connect defer skip list' },\n  { prefix: 'gateway.share', kind: 'restart', description: 'File share policy' },\n  {\n    prefix: 'gateway.skillsStoreBaseUrl',\n    kind: 'restart',\n    description: 'Skills marketplace API base URL',\n  },\n  { prefix: 'gateway.enableHotReload', kind: 'hot', description: 'Hot reload toggle' },\n  \n  // Channels - hot reload (channel-specific prefixes are registered by channel plugins)\n  { prefix: 'channels', kind: 'hot', description: 'Any channel subtree (e.g. future extensions)' },\n  \n  // Cron - hot reload\n  { prefix: 'cron', kind: 'hot', description: 'Scheduled tasks' },\n  \n  // Heartbeat lives under gateway.heartbeat in config JSON (not top-level `heartbeat`)\n  { prefix: 'gateway.heartbeat', kind: 'hot', description: 'Heartbeat settings' },\n  \n  // Web search - hot reload\n  { prefix: 'webSearch', kind: 'hot', description: 'Web search settings' },\n  { prefix: 'webTools', kind: 'hot', description: 'Web tools settings' },\n  \n  // Extension list toggles — still require process restart to load/unload modules\n  {\n    prefix: 'extensions.enabled',\n    kind: 'restart',\n    description: 'Extension enable list (requires restart)',\n  },\n  {\n    prefix: 'extensions.disabled',\n    kind: 'restart',\n    description: 'Extension disable list (requires restart)',\n  },\n  // Extension instance config — hot-reloaded via extension registerReload handlers\n  {\n    prefix: 'extensions',\n    kind: 'hot',\n    description: 'Extension configuration (hot-reloaded via extension handlers)',\n  },\n  \n  // Tools - hot reload (for tool-specific settings)\n  { prefix: 'tools', kind: 'hot', description: 'Tools configuration' },\n\n  // MCP servers - hot reload (dispose and reconnect runtimes)\n  { prefix: 'mcp', kind: 'hot', description: 'MCP server definitions and idle TTL' },\n\n  // Tunnel E2E TLS — restart (local HTTPS terminator port)\n  { prefix: 'tunnel', kind: 'hot', description: 'Tunnel broker and auto-start settings' },\n];\n\nfunction pluginsForReloadRules(): ChannelPlugin[] {\n  const listed = listChannelPlugins();\n  return listed.length > 0 ? [...listed] : [...bundledChannelPlugins];\n}\n\nfunction getChannelReloadRules(): ReloadRule[] {\n  return pluginsForReloadRules()\n    .filter((plugin) => plugin.reload?.configPrefixes?.length)\n    .flatMap((plugin) =>\n      plugin.reload!.configPrefixes.map((prefix) => ({\n        prefix,\n        kind: 'hot' as const,\n        description: `${plugin.meta.label} settings`,\n      })),\n    );\n}\n\nfunction mergedReloadRules(): ReloadRule[] {\n  return [...BASE_RELOAD_RULES, ...getChannelReloadRules()];\n}\n\n/**\n * Find matching rule for a config path\n */\nexport function matchReloadRule(path: string): ReloadRule | null {\n  const merged = mergedReloadRules();\n  const exact = merged.find((r) => r.prefix === path);\n  if (exact) return exact;\n  const sorted = [...merged].sort((a, b) => b.prefix.length - a.prefix.length);\n  for (const rule of sorted) {\n    if (path === rule.prefix || path.startsWith(`${rule.prefix}.`)) {\n      return rule;\n    }\n  }\n  return null;\n}\n\n/**\n * Build reload plan from changed paths\n */\nexport function buildReloadPlan(changedPaths: string[]): ReloadPlan {\n  const plan: ReloadPlan = {\n    changedPaths,\n    hotPaths: [],\n    restartPaths: [],\n    noopPaths: [],\n    requiresRestart: false,\n    requiresHotReload: false,\n  };\n\n  for (const path of changedPaths) {\n    const rule = matchReloadRule(path);\n    \n    if (!rule) {\n      // No rule matched - default to restart for safety\n      plan.restartPaths.push(path);\n      plan.requiresRestart = true;\n      continue;\n    }\n\n    switch (rule.kind) {\n      case 'hot':\n        plan.hotPaths.push(path);\n        plan.requiresHotReload = true;\n        break;\n      case 'restart':\n        plan.restartPaths.push(path);\n        plan.requiresRestart = true;\n        break;\n      case 'none':\n        plan.noopPaths.push(path);\n        break;\n    }\n  }\n\n  return plan;\n}\n"],"mappings":"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"}
+{"version":3,"file":"rules.js","names":[],"sources":["../../../src/config/rules.ts"],"sourcesContent":["/**\n * Configuration reload rules\n * \n * Defines how different config paths are handled:\n * - hot: Apply changes immediately without restart\n * - restart: Require gateway restart\n * - none: Ignore changes (no action needed)\n */\n\nexport type ReloadKind = 'hot' | 'restart' | 'none';\n\nexport interface ReloadRule {\n  prefix: string;\n  kind: ReloadKind;\n  description?: string;\n}\n\nexport interface ReloadPlan {\n  changedPaths: string[];\n  hotPaths: string[];\n  restartPaths: string[];\n  noopPaths: string[];\n  requiresRestart: boolean;\n  requiresHotReload: boolean;\n}\n\n/**\n * Base reload rules for config paths\n */\nexport const BASE_RELOAD_RULES: ReloadRule[] = [\n  // Models config - hot reload\n  { prefix: 'models.providers', kind: 'hot', description: 'Model provider API keys, base URLs' },\n  { prefix: 'models.mode', kind: 'hot', description: 'Model merge mode' },\n  \n  // Agent defaults - hot reload\n  { prefix: 'agents.defaults.models', kind: 'hot', description: 'Model configuration' },\n  { prefix: 'agents.defaults.maxTaskDurationMs', kind: 'hot', description: 'Per-turn wall-clock timeout (ms)' },\n  { prefix: 'agents.defaults.maxTokens', kind: 'hot', description: 'Max tokens' },\n  { prefix: 'agents.defaults.temperature', kind: 'hot', description: 'Temperature' },\n  { prefix: 'agents.defaults.maxToolIterations', kind: 'hot', description: 'Max tool iterations' },\n  { prefix: 'agents.defaults.compaction', kind: 'hot', description: 'Compaction settings' },\n  { prefix: 'agents.defaults.pruning', kind: 'hot', description: 'Pruning settings' },\n  { prefix: 'agents.defaults.webExtract', kind: 'hot', description: 'Web extract model and limits' },\n  { prefix: 'agents.defaults.browser', kind: 'hot', description: 'Browser automation (Playwright) tools' },\n  { prefix: 'agents.defaults.delegate', kind: 'hot', description: 'delegate_task sub-agent tool' },\n  { prefix: 'agents.defaults.executeCode', kind: 'hot', description: 'execute_code sandbox tool' },\n  {\n    prefix: 'agents.defaults.backgroundReview',\n    kind: 'hot',\n    description: 'Post-turn memory/skill nudge + background review',\n  },\n  { prefix: 'agents.defaults.workspace', kind: 'none', description: 'Workspace path - no runtime effect' },\n  \n  // Gateway - restart required\n  { prefix: 'gateway.bind', kind: 'restart', description: 'Gateway bind mode' },\n  { prefix: 'gateway.customBindHost', kind: 'restart', description: 'Gateway custom bind host' },\n  { prefix: 'gateway.port', kind: 'restart', description: 'Port number' },\n  { prefix: 'gateway.mode', kind: 'restart', description: 'Gateway local/remote CLI mode' },\n  { prefix: 'gateway.remote', kind: 'restart', description: 'Remote gateway CLI target' },\n  { prefix: 'gateway.tailscale', kind: 'restart', description: 'Tailscale Serve/Funnel exposure' },\n  { prefix: 'gateway.tls', kind: 'restart', description: 'Gateway native TLS' },\n  { prefix: 'gateway.auth', kind: 'restart', description: 'Authentication settings' },\n  { prefix: 'gateway.security', kind: 'restart', description: 'Gateway security policy' },\n  { prefix: 'gateway.corsOrigins', kind: 'restart', description: 'CORS settings' },\n  { prefix: 'gateway.trustedProxies', kind: 'restart', description: 'Trusted reverse proxy CIDRs' },\n  {\n    prefix: 'gateway.allowRealIpFallback',\n    kind: 'restart',\n    description: 'Trusted-proxy X-Real-IP fallback',\n  },\n  {\n    prefix: 'gateway.dangerouslyAllowHostHeaderOriginFallback',\n    kind: 'restart',\n    description: 'Host-header origin fallback',\n  },\n  { prefix: 'gateway.maxSseConnections', kind: 'restart', description: 'SSE connection limit' },\n  { prefix: 'gateway.channelConnectDeferMode', kind: 'restart', description: 'Channel connect defer mode' },\n  { prefix: 'gateway.channelConnectDeferIds', kind: 'restart', description: 'Explicit channel connect defer list' },\n  { prefix: 'gateway.channelConnectDeferSkipIds', kind: 'restart', description: 'Channel connect defer skip list' },\n  { prefix: 'gateway.share', kind: 'restart', description: 'File share policy' },\n  {\n    prefix: 'gateway.skillsStoreBaseUrl',\n    kind: 'restart',\n    description: 'Skills marketplace API base URL',\n  },\n  { prefix: 'gateway.enableHotReload', kind: 'hot', description: 'Hot reload toggle' },\n  \n  // Channels - hot reload (channel-specific prefixes are registered by channel plugins)\n  { prefix: 'channels', kind: 'hot', description: 'Any channel subtree (e.g. future extensions)' },\n  \n  // Cron - hot reload\n  { prefix: 'cron', kind: 'hot', description: 'Scheduled tasks' },\n  \n  // Heartbeat lives under gateway.heartbeat in config JSON (not top-level `heartbeat`)\n  { prefix: 'gateway.heartbeat', kind: 'hot', description: 'Heartbeat settings' },\n  \n  // Web search - hot reload\n  { prefix: 'webSearch', kind: 'hot', description: 'Web search settings' },\n  { prefix: 'webTools', kind: 'hot', description: 'Web tools settings' },\n  \n  // Extension list toggles — still require process restart to load/unload modules\n  {\n    prefix: 'extensions.enabled',\n    kind: 'restart',\n    description: 'Extension enable list (requires restart)',\n  },\n  {\n    prefix: 'extensions.disabled',\n    kind: 'restart',\n    description: 'Extension disable list (requires restart)',\n  },\n  // Extension instance config — hot-reloaded via extension registerReload handlers\n  {\n    prefix: 'extensions',\n    kind: 'hot',\n    description: 'Extension configuration (hot-reloaded via extension handlers)',\n  },\n  \n  // Tools - hot reload (for tool-specific settings)\n  { prefix: 'tools', kind: 'hot', description: 'Tools configuration' },\n\n  // MCP servers - hot reload (dispose and reconnect runtimes)\n  { prefix: 'mcp', kind: 'hot', description: 'MCP server definitions and idle TTL' },\n\n  // Tunnel E2E TLS — restart (local HTTPS terminator port)\n  { prefix: 'tunnel', kind: 'hot', description: 'Tunnel broker and auto-start settings' },\n];\n\nfunction getChannelReloadRules(): ReloadRule[] {\n  return [];\n}\n\nfunction mergedReloadRules(): ReloadRule[] {\n  return [...BASE_RELOAD_RULES, ...getChannelReloadRules()];\n}\n\n/**\n * Find matching rule for a config path\n */\nexport function matchReloadRule(path: string): ReloadRule | null {\n  const merged = mergedReloadRules();\n  const exact = merged.find((r) => r.prefix === path);\n  if (exact) return exact;\n  const sorted = [...merged].sort((a, b) => b.prefix.length - a.prefix.length);\n  for (const rule of sorted) {\n    if (path === rule.prefix || path.startsWith(`${rule.prefix}.`)) {\n      return rule;\n    }\n  }\n  return null;\n}\n\n/**\n * Build reload plan from changed paths\n */\nexport function buildReloadPlan(changedPaths: string[]): ReloadPlan {\n  const plan: ReloadPlan = {\n    changedPaths,\n    hotPaths: [],\n    restartPaths: [],\n    noopPaths: [],\n    requiresRestart: false,\n    requiresHotReload: false,\n  };\n\n  for (const path of changedPaths) {\n    const rule = matchReloadRule(path);\n    \n    if (!rule) {\n      // No rule matched - default to restart for safety\n      plan.restartPaths.push(path);\n      plan.requiresRestart = true;\n      continue;\n    }\n\n    switch (rule.kind) {\n      case 'hot':\n        plan.hotPaths.push(path);\n        plan.requiresHotReload = true;\n        break;\n      case 'restart':\n        plan.restartPaths.push(path);\n        plan.requiresRestart = true;\n        break;\n      case 'none':\n        plan.noopPaths.push(path);\n        break;\n    }\n  }\n\n  return plan;\n}\n"],"mappings":"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"}

package/dist/src/config/schema.d.ts

@@ -9,6 +9,22 @@ export declare const AgentModelRefSchema: z.ZodObject<{
     fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type AgentModelConfig = z.infer<typeof AgentModelRefSchema>;
+export declare const AgentTypedModelRoleSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+}, z.core.$strict>;
+export type AgentTypedModelRole = z.infer<typeof AgentTypedModelRoleSchema>;
+export declare const AgentModelsSchema: z.ZodOptional<z.ZodObject<{
+    chat: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodString;
+        fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+export type AgentModelsConfig = z.infer<typeof AgentModelsSchema>;
 /**
  * Image-generation model ref. {@link AgentModelRefSchema} plus runtime knobs
  * (`timeoutMs`, `autoProviderFallback`) used by the image-generation runtime.
@@ -20,24 +36,21 @@ export declare const AgentImageGenerationModelSchema: z.ZodObject<{
     autoProviderFallback: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type AgentImageGenerationModelConfig = z.infer<typeof AgentImageGenerationModelSchema>;
-/** Named model role for workflows (e.g. `small`, `large`). Maps to a concrete `provider/model` ref. */
-export declare const AgentTypedModelSchema: z.ZodObject<{
-    id: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    model: z.ZodString;
-}, z.core.$strict>;
-export type AgentTypedModel = z.infer<typeof AgentTypedModelSchema>;
+export type AgentTypedModel = AgentTypedModelRole & {
+    id: string;
+};
 export declare const AgentDefaultsSchema: z.ZodObject<{
     workspace: z.ZodDefault<z.ZodString>;
-    model: z.ZodOptional<z.ZodObject<{
-        primary: z.ZodString;
-        fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    models: z.ZodOptional<z.ZodObject<{
+        chat: z.ZodOptional<z.ZodObject<{
+            primary: z.ZodString;
+            fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+        }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        model: z.ZodString;
-    }, z.core.$strict>>>;
     imageModel: z.ZodOptional<z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -269,14 +282,18 @@ export declare const AgentDefaultsSchema: z.ZodObject<{
 export declare const AgentConfigSchema: z.ZodObject<{
     id: z.ZodString;
     default: z.ZodOptional<z.ZodBoolean>;
-    name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
-    description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     enabled: z.ZodDefault<z.ZodBoolean>;
     workspace: z.ZodOptional<z.ZodString>;
     agentDir: z.ZodOptional<z.ZodString>;
-    model: z.ZodOptional<z.ZodObject<{
-        primary: z.ZodString;
-        fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    models: z.ZodOptional<z.ZodObject<{
+        chat: z.ZodOptional<z.ZodObject<{
+            primary: z.ZodString;
+            fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+        }, z.core.$strict>>>;
     }, z.core.$strict>>;
     thinkingDefault: z.ZodOptional<z.ZodEnum<{
         off: "off";
@@ -308,15 +325,16 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
     default: z.ZodOptional<z.ZodString>;
     defaults: z.ZodOptional<z.ZodObject<{
         workspace: z.ZodDefault<z.ZodString>;
-        model: z.ZodOptional<z.ZodObject<{
-            primary: z.ZodString;
-            fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        models: z.ZodOptional<z.ZodObject<{
+            chat: z.ZodOptional<z.ZodObject<{
+                primary: z.ZodString;
+                fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                model: z.ZodString;
+            }, z.core.$strict>>>;
         }, z.core.$strict>>;
-        models: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            model: z.ZodString;
-        }, z.core.$strict>>>;
         imageModel: z.ZodOptional<z.ZodObject<{
             primary: z.ZodString;
             fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -548,14 +566,18 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
     list: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         default: z.ZodOptional<z.ZodBoolean>;
-        name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
-        description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         workspace: z.ZodOptional<z.ZodString>;
         agentDir: z.ZodOptional<z.ZodString>;
-        model: z.ZodOptional<z.ZodObject<{
-            primary: z.ZodString;
-            fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        models: z.ZodOptional<z.ZodObject<{
+            chat: z.ZodOptional<z.ZodObject<{
+                primary: z.ZodString;
+                fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                model: z.ZodString;
+            }, z.core.$strict>>>;
         }, z.core.$strict>>;
         thinkingDefault: z.ZodOptional<z.ZodEnum<{
             off: "off";
@@ -1603,15 +1625,16 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
         defaults: z.ZodOptional<z.ZodObject<{
             workspace: z.ZodDefault<z.ZodString>;
-            model: z.ZodOptional<z.ZodObject<{
-                primary: z.ZodString;
-                fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            models: z.ZodOptional<z.ZodObject<{
+                chat: z.ZodOptional<z.ZodObject<{
+                    primary: z.ZodString;
+                    fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+                roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    model: z.ZodString;
+                }, z.core.$strict>>>;
             }, z.core.$strict>>;
-            models: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-                model: z.ZodString;
-            }, z.core.$strict>>>;
             imageModel: z.ZodOptional<z.ZodObject<{
                 primary: z.ZodString;
                 fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1843,14 +1866,18 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
         list: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             default: z.ZodOptional<z.ZodBoolean>;
-            name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
-            description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
             enabled: z.ZodDefault<z.ZodBoolean>;
             workspace: z.ZodOptional<z.ZodString>;
             agentDir: z.ZodOptional<z.ZodString>;
-            model: z.ZodOptional<z.ZodObject<{
-                primary: z.ZodString;
-                fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            models: z.ZodOptional<z.ZodObject<{
+                chat: z.ZodOptional<z.ZodObject<{
+                    primary: z.ZodString;
+                    fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+                roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    model: z.ZodString;
+                }, z.core.$strict>>>;
             }, z.core.$strict>>;
             thinkingDefault: z.ZodOptional<z.ZodEnum<{
                 off: "off";
@@ -2329,7 +2356,7 @@ export interface ParsedModelRef {
     model: string;
 }
 /**
- * Primary model ref from `agents.defaults.model`. Returns undefined when unset.
+ * Primary chat model ref from `agents.defaults.models.chat`. Returns undefined when unset.
  */
 export declare function getAgentDefaultModelRef(config: Config): string | undefined;
 /** `provider/model` or null when invalid. */