@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/config/agent-typed-models.js

@@ -1,8 +1,7 @@
-import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../agent/agent-scope.js";
 import { init_schema, parseModelRef } from "./schema.js";
+import { resolveEffectiveAgentManifestForAgent } from "./agent-profile.js";
 //#region src/config/agent-typed-models.ts
 init_schema();
-init_agent_scope();
 function rolesToEntries(roles) {
 	return Object.entries(roles ?? {}).map(([id, role]) => ({
 		id,
@@ -11,10 +10,8 @@ function rolesToEntries(roles) {
 }
 function resolveEffectiveTypedModels(config, agentId) {
 	const out = /* @__PURE__ */ new Map();
-	for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) out.set(modelRole.id, modelRole);
-	const id = normalizeAgentId(agentId);
-	const entry = listAgentEntries(config).find((candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id);
-	for (const modelRole of rolesToEntries(entry?.models?.roles)) out.set(modelRole.id, modelRole);
+	const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);
+	for (const modelRole of rolesToEntries(manifest.models.roles)) out.set(modelRole.id, modelRole);
 	return out;
 }
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */

package/dist/src/config/agent-typed-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\nimport { listAgentEntries, normalizeAgentId } from '../agent/agent-scope.js';\n\nexport type { AgentTypedModel };\n\nfunction rolesToEntries(\n  roles: Record<string, { model: string; description?: string }> | undefined,\n): AgentTypedModel[] {\n  return Object.entries(roles ?? {}).map(([id, role]) => ({\n    id,\n    ...role,\n  }));\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  const id = normalizeAgentId(agentId);\n  const entry = listAgentEntries(config).find(\n    (candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id,\n  );\n  for (const modelRole of rolesToEntries(entry?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;aAK4C;kBACiC;AAI7E,SAAS,eACP,OACmB;AACnB,QAAO,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW;EACtD;EACA,GAAG;EACJ,EAAE;;AAGL,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,UAAU,QAAQ,MAAM,CAC5E,KAAI,IAAI,UAAU,IAAI,UAAU;CAElC,MAAM,KAAK,iBAAiB,QAAQ;CACpC,MAAM,QAAQ,iBAAiB,OAAO,CAAC,MACpC,cAAc,UAAU,YAAY,SAAS,iBAAiB,UAAU,GAAG,KAAK,GAClF;AACD,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,MAAM,CAC1D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}
+{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from the selected agent manifest.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\nimport { resolveEffectiveAgentManifestForAgent } from './agent-profile.js';\n\nexport type { AgentTypedModel };\n\nfunction rolesToEntries(\n  roles: Record<string, { model: string; description?: string }> | undefined,\n): AgentTypedModel[] {\n  return Object.entries(roles ?? {}).map(([id, role]) => ({\n    id,\n    ...role,\n  }));\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);\n  for (const modelRole of rolesToEntries(manifest.models.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;aAK4C;AAK5C,SAAS,eACP,OACmB;AACnB,QAAO,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW;EACtD;EACA,GAAG;EACJ,EAAE;;AAGL,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,sBAAM,IAAI,KAA8B;CAC9C,MAAM,WAAW,sCAAsC,QAAQ,QAAQ;AACvE,MAAK,MAAM,aAAa,eAAe,SAAS,OAAO,MAAM,CAC3D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}

package/dist/src/config/gateway-bind.js

@@ -1,7 +1,7 @@
 import { getTailnetIPv4Sync } from "../infra/tailscale.js";
 import { isLoopbackHost } from "../gateway/host.js";
-import { existsSync } from "node:fs";
 import net from "node:net";
+import { existsSync } from "node:fs";
 //#region src/config/gateway-bind.ts
 function resolveGatewayBindMode(cfg, bindOverride) {
 	if (bindOverride) return bindOverride;

package/dist/src/config/index.js

@@ -1,16 +1,16 @@
-import { clearConfigValueCache, getAllowedCommands, getCacheStats, init_resolve_config_value, resolveConfigValue, resolveHeaders, testApiKeyResolution } from "./resolve-config-value.js";
+import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
+import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
+import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, 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 { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { ENV_VARS, XOPC_DB_FILENAME, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath } from "./paths-state.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
 import { resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
-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 { CustomModelSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.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, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, 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 { extractProfileAgentId, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "./agent-profile.js";
+import { FILENAMES, USER_MEMORY_FILENAME, USER_PROFILE_FILENAME, 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, resolveUserDir, resolveUserMemoryPath, resolveUserProfilePath, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath } from "./paths.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";
+import { CustomModelSchema, ModelOverrideSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProviderConfigSchema, VercelGatewayRoutingSchema, getDefaultModelValues, init_models_json, loadModelsJson, modelsJsonExists, saveModelsJson, validateModelsConfig } from "./models-json.js";
 import { canonicalizeConfiguredMcpServer, isKnownCliMcpTypeAlias, normalizeConfiguredMcpServers, resolveXopcMcpTransportAlias } from "./mcp-config-normalize.js";
 import { formatThinkingLevels, listThinkingLevels, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, thinkLevelToNumber } from "../agent/transcript/thinking-types.js";
 import { getWorkspacePath } from "./workspace-path-helpers.js";
@@ -27,6 +27,6 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, ConnectorsConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, 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 };
+export { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, ConnectorsConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, 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, USER_MEMORY_FILENAME, USER_PROFILE_FILENAME, 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, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, 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, resolveUserDir, resolveUserMemoryPath, resolveUserProfilePath, 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.models, gateway, channels, etc.).
+ * - Main config: `ConfigSchema` (agent manifests, 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.js

@@ -1,12 +1,12 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
-import { init_paths, resolveConfigPath } from "./paths.js";
+import { ConfigSchema, init_schema } from "./schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { ConfigSchema, init_schema } from "./schema.js";
+import { init_paths, resolveConfigPath } from "./paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { assertChannelPluginConfigs, init_validate_channel_configs } from "./validate-channel-configs.js";
-import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { dirname } from "path";
+import { existsSync, mkdirSync, promises, readFileSync } from "fs";
 import { config } from "dotenv";
 //#region src/config/loader.ts
 /**

package/dist/src/config/models-json.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { init_paths, resolveModelsJsonPath } from "./paths.js";
-import { existsSync, readFileSync } from "fs";
+import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { z } from "zod";
+import { existsSync, readFileSync } from "fs";
 //#region src/config/models-json.ts
 /**
 * Models.json configuration types and schema

package/dist/src/config/paths-state.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { join } from "node:path";
 import { homedir } from "node:os";
+import { join } from "node:path";
 //#region src/config/paths-state.ts
 function resolveHomeDir(env = process.env) {
 	return env[ENV_VARS.HOME] || homedir();

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

@@ -22,12 +22,13 @@ export declare const FILENAMES: {
 export declare const WORKSPACE_FILES: {
     readonly SOUL: "SOUL.md";
     readonly IDENTITY: "IDENTITY.md";
-    readonly USER: "USER.md";
     readonly AGENTS: "AGENTS.md";
     readonly TOOLS: "TOOLS.md";
     readonly HEARTBEAT: "HEARTBEAT.md";
     readonly MEMORY: "MEMORY.md";
 };
+export declare const USER_PROFILE_FILENAME = "PROFILE.md";
+export declare const USER_MEMORY_FILENAME = "MEMORY.md";
 /**
  * Resolve the main config file path
  */
@@ -40,6 +41,12 @@ export declare function resolveCredentialsDir(): string;
  * Resolve the global auth-profiles.json path
  */
 export declare function resolveAuthProfilesPath(): string;
+/** Global user profile root (`~/.xopc/user/`). */
+export declare function resolveUserDir(): string;
+/** Global human/user profile Markdown (`~/.xopc/user/PROFILE.md`). */
+export declare function resolveUserProfilePath(): string;
+/** Global human/user long-term memory Markdown (`~/.xopc/user/MEMORY.md`). */
+export declare function resolveUserMemoryPath(): string;
 /**
  * Resolve OAuth token file path for a provider
  */

package/dist/src/config/paths.js

@@ -2,8 +2,8 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { ENV_VARS, XOPC_DB_FILENAME, init_paths_state, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath } from "./paths-state.js";
 import { init_workspace_defaults, resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
 import { init_agent_scope, resolveAgentDir as resolveAgentDir$1, resolveAgentHomeDir as resolveAgentHomeDir$1, resolveAgentProfileDir as resolveAgentProfileDir$1, resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPath$1, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
-import { existsSync } from "fs";
 import { dirname, join, sep } from "path";
+import { existsSync } from "fs";
 import { fileURLToPath } from "url";
 //#region src/config/paths.ts
 /**
@@ -24,6 +24,18 @@ function resolveCredentialsDir() {
 function resolveAuthProfilesPath() {
 	return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);
 }
+/** Global user profile root (`~/.xopc/user/`). */
+function resolveUserDir() {
+	return join(resolveStateDir(), "user");
+}
+/** Global human/user profile Markdown (`~/.xopc/user/PROFILE.md`). */
+function resolveUserProfilePath() {
+	return join(resolveUserDir(), USER_PROFILE_FILENAME);
+}
+/** Global human/user long-term memory Markdown (`~/.xopc/user/MEMORY.md`). */
+function resolveUserMemoryPath() {
+	return join(resolveUserDir(), USER_MEMORY_FILENAME);
+}
 /**
 * Resolve OAuth token file path for a provider
 */
@@ -293,7 +305,7 @@ function resolveExtensionSdkPath() {
 		return join(process.cwd(), "src", "extensions", "sdk", "index.ts");
 	}
 }
-var ENV_BUNDLED_EXTENSIONS_ROOT, ENV_BUNDLED_SKILLS_ROOT, FILENAMES, WORKSPACE_FILES;
+var ENV_BUNDLED_EXTENSIONS_ROOT, ENV_BUNDLED_SKILLS_ROOT, FILENAMES, WORKSPACE_FILES, USER_PROFILE_FILENAME, USER_MEMORY_FILENAME;
 var init_paths = __esmMin((() => {
 	init_agent_scope();
 	init_paths_state();
@@ -319,15 +331,16 @@ var init_paths = __esmMin((() => {
 	WORKSPACE_FILES = {
 		SOUL: "SOUL.md",
 		IDENTITY: "IDENTITY.md",
-		USER: "USER.md",
 		AGENTS: "AGENTS.md",
 		TOOLS: "TOOLS.md",
 		HEARTBEAT: "HEARTBEAT.md",
 		MEMORY: "MEMORY.md"
 	};
+	USER_PROFILE_FILENAME = "PROFILE.md";
+	USER_MEMORY_FILENAME = "MEMORY.md";
 }));
 //#endregion
 init_paths();
-export { ENV_VARS, FILENAMES, WORKSPACE_FILES, XOPC_DB_FILENAME, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath };
+export { ENV_VARS, FILENAMES, USER_MEMORY_FILENAME, USER_PROFILE_FILENAME, WORKSPACE_FILES, XOPC_DB_FILENAME, existsSync, init_paths, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveDefaultAgentWorkspaceDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveUserDir, resolveUserMemoryPath, resolveUserProfilePath, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath };
 
 //# sourceMappingURL=paths.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join, sep } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nconst ENV_BUNDLED_EXTENSIONS_ROOT = 'XOPC_BUNDLED_EXTENSIONS_ROOT';\nconst ENV_BUNDLED_SKILLS_ROOT = 'XOPC_BUNDLED_SKILLS_ROOT';\n\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  USER: 'USER.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n} as const;\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `dist/extensions` when built, else `extensions/` (dev, tsx)\n * - `out/server` → `dist/electron/extensions` (Electron extension bundles)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  const envDir = process.env[ENV_BUNDLED_EXTENSIONS_ROOT];\n  if (envDir && existsSync(envDir)) {\n    return envDir;\n  }\n\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const isElectronServerBundle = srcDir.endsWith(`${sep}out${sep}server`);\n    const candidates = isElectronServerBundle\n      ? [join(srcDir, '..', '..', 'dist', 'electron', 'extensions')]\n      : [\n          // In source-tree dev, prefer compiled bundled extensions when present: manifests point\n          // at built JavaScript entries (for example src/index.js), while source folders contain TS.\n          join(srcDir, '..', '..', 'dist', 'extensions'),\n          join(srcDir, '..', '..', 'extensions'),\n          join(srcDir, '..', '..', '..', 'dist', 'extensions'),\n          join(srcDir, '..', '..', '..', 'extensions'),\n        ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  const envDir = process.env[ENV_BUNDLED_SKILLS_ROOT];\n  if (envDir && existsSync(envDir)) {\n    return envDir;\n  }\n\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":";;;;;;;;;;;AAkEA,SAAgB,oBAA4B;AAC1C,QAAO,QAAQ,IAAI,SAAS,gBAAgB,KAAK,iBAAiB,EAAE,UAAU,OAAO;;;;;AAMvF,SAAgB,wBAAgC;AAC9C,QAAO,QAAQ,IAAI,SAAS,oBAAoB,KAAK,iBAAiB,EAAE,cAAc;;;;;AAMxF,SAAgB,0BAAkC;AAChD,QAAO,KAAK,uBAAuB,EAAE,UAAU,qBAAqB;;;;;AAMtE,SAAgB,iBAAiB,UAA0B;AACzD,QAAO,KAAK,uBAAuB,EAAE,SAAS,GAAG,SAAS,OAAO;;;;;;AAOnE,SAAgB,gBAAgB,QAAgB,SAAyB;AACvE,QAAOA,kBAAsB,QAAQ,QAAQ;;;;;AAM/C,SAAgB,oBAAoB,QAAgB,SAAyB;AAC3E,QAAOC,sBAAuB,QAAQ,QAAQ;;;AAIhD,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAOC,yBAA6B,QAAQ,QAAQ;;;AAItD,SAAgB,gCAAgC,QAAgB,SAAiB,UAA0B;AACzG,QAAOC,kCAAsC,QAAQ,SAAS,SAAS;;;;;AAMzE,SAAgB,qBAAqB,QAAgB,UAAkB,SAAyB;AAC9F,QAAO,KAAKD,yBAA6B,QAAQ,QAAQ,EAAE,SAAS;;;;;AAMtE,SAAgB,6BAA6B,QAAgB,SAAyB;AACpF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,qBAAqB;;;;;AAM/E,SAAgB,gBAAgB,QAAgB,SAAyB;AACvE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,QAAQ;;;;;AAMxD,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU;;;;;AAM1D,SAAgB,yBAAyB,QAAgB,SAAyB;AAChF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,YAAY;;;;;AAM5D,SAAgB,wBACd,QACA,WACA,SACA,SACQ;AAER,QAAO,KADK,UAAU,uBAAuB,QAAQ,QAAQ,GAAG,yBAAyB,QAAQ,QAAQ,EACxF,GAAG,UAAU,OAAO;;;;;AAMvC,SAAgB,eAAe,QAAgB,SAAyB;AACtE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,IAAI;;;;;AAM9D,SAAgB,kBAAkB,QAAgB,SAAyB;AACzE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,OAAO;;;;;AAMjE,SAAgB,kBAAkB,QAAgB,SAAyB;AACzE,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,UAAU,OAAO;;;;;AAMjE,SAAgB,uBAA+B;AAC7C,QAAO,KAAK,iBAAiB,EAAE,aAAa;;;;;AAM9C,SAAgB,4BAAoC;AAClD,QAAO,KAAK,sBAAsB,EAAE,UAAU,gBAAgB;;;;;;;AAQhE,SAAgB,8BAA8B,QAAgB,SAAyB;AACrF,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,aAAa;;;;;AAM7D,SAAgB,mBAA2B;AACzC,QAAO,KAAK,iBAAiB,EAAE,SAAS;;;;;AAM1C,SAAgB,iBAAiB,SAAyB;AACxD,QAAO,KAAK,kBAAkB,EAAE,SAAS,WAAW;;;;;AAMtD,SAAgB,wBAAgC;AAC9C,QAAO,KAAK,iBAAiB,EAAE,UAAU,YAAY;;;;;AAMvD,SAAgB,iBAAyB;AACvC,QAAO,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMxC,SAAgB,sBAA8B;AAC5C,QAAO,KAAK,gBAAgB,EAAE,UAAU,UAAU;;;;;AAMpD,SAAgB,iBAAyB;AACvC,QAAO,QAAQ,IAAI,SAAS,YAAY,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMzE,SAAgB,eAAe,MAAsB;AACnD,QAAO,KAAK,gBAAgB,EAAE,QAAQ,KAAK,MAAM;;;;;AAMnD,SAAgB,gBAAwB;AACtC,QAAO,KAAK,iBAAiB,EAAE,MAAM;;;;;AAMvC,SAAgB,qBAA6B;AAC3C,QAAO,KAAK,eAAe,EAAE,OAAO;;;;;AAMtC,SAAgB,kBAA0B;AACxC,QAAO,KAAK,iBAAiB,EAAE,QAAQ;;;;;AAMzC,SAAgB,sBAA8B;AAC5C,QAAO,KAAK,iBAAiB,EAAE,OAAO;;;;;AAMxC,SAAgB,oBAA4B;AAC1C,QAAO,KAAK,qBAAqB,EAAE,WAAW,MAAM;;;;;AAMtD,SAAgB,qBAA6B;AAC3C,QAAO,KAAK,mBAAmB,EAAE,OAAO;;;;;AAM1C,SAAgB,oBAA4B;AAC1C,QAAO,KAAK,mBAAmB,EAAE,MAAM;;;;;AAMzC,SAAgB,wBAAgC;AAC9C,QAAO,KAAK,iBAAiB,EAAE,UAAU,YAAY;;;;;AAMvD,SAAgB,yBAAyB,QAAgB,SAAyB;AAChF,QAAO,KAAK,yBAAyB,QAAQ,QAAQ,EAAE,QAAQ;;;;;AAMjE,SAAgB,0BAA0B,QAAgB,SAAyB;AACjF,QAAO,KAAK,yBAAyB,QAAQ,QAAQ,EAAE,UAAU,gBAAgB;;;;;AAMnF,SAAgB,uBAAuB,QAAgB,SAAyB;AAC9E,QAAO,KAAK,gBAAgB,QAAQ,QAAQ,EAAE,SAAS,UAAU,aAAa;;;;;;;;;;;AAYhF,SAAgB,8BAA6C;CAC3D,MAAM,SAAS,QAAQ,IAAI;AAC3B,KAAI,UAAU,WAAW,OAAO,CAC9B,QAAO;AAGT,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EAEnC,MAAM,aADyB,OAAO,SAAS,GAAG,IAAI,KAAK,IAAI,QACtB,GACrC,CAAC,KAAK,QAAQ,MAAM,MAAM,QAAQ,YAAY,aAAa,CAAC,GAC5D;GAGE,KAAK,QAAQ,MAAM,MAAM,QAAQ,aAAa;GAC9C,KAAK,QAAQ,MAAM,MAAM,aAAa;GACtC,KAAK,QAAQ,MAAM,MAAM,MAAM,QAAQ,aAAa;GACpD,KAAK,QAAQ,MAAM,MAAM,MAAM,aAAa;GAC7C;AACL,OAAK,MAAM,OAAO,WAChB,KAAI,WAAW,IAAI,CACjB,QAAO;AAGX,SAAO;SACD;AACN,SAAO;;;;;;AAOX,SAAgB,0BAAyC;CACvD,MAAM,SAAS,QAAQ,IAAI;AAC3B,KAAI,UAAU,WAAW,OAAO,CAC9B,QAAO;AAGT,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EAInC,MAAM,YAAY,KADE,KAAK,QAAQ,MAAM,KACL,EAAE,SAAS;AAC7C,MAAI,WAAW,UAAU,CACvB,QAAO;EAKT,MAAM,eAAe,KADE,KAAK,QAAQ,MAAM,MAAM,KACR,EAAE,SAAS;AACnD,MAAI,WAAW,aAAa,CAC1B,QAAO;AAGT,SAAO;SACD;AACN,SAAO;;;;;;AAOX,SAAgB,0BAAkC;AAChD,KAAI;EAEF,MAAM,SAAS,QADK,cAAc,OAAO,KAAK,IACZ,CAAC;EACnC,MAAM,WAAW,KAAK,QAAQ,MAAM,cAAc,OAAO,WAAW;AACpE,MAAI,WAAW,SAAS,CACtB,QAAO;EAET,MAAM,kBAAkB,KAAK,QAAQ,MAAM,MAAM,OAAO,cAAc,OAAO,WAAW;AACxF,MAAI,WAAW,gBAAgB,CAC7B,QAAO;EAET,MAAM,MAAM,KAAK,QAAQ,KAAK,EAAE,OAAO,cAAc,OAAO,WAAW;AACvE,MAAI,WAAW,IAAI,CACjB,QAAO;AAET,SAAO;SACD;AACN,SAAO,KAAK,QAAQ,KAAK,EAAE,OAAO,cAAc,OAAO,WAAW;;;;;mBAharC;mBAC4B;0BAGa;AAUpE,+BAA8B;AAC9B,2BAA0B;AAEnB,aAAY;EACvB,QAAQ;EACR,aAAa;;EAEb,SAAS;EACT,iBAAiB;EACjB,sBAAsB;EACtB,WAAW;EACX,iBAAiB;EACjB,cAAc;;EAEd,aAAa;EACb,KAAK;EACL,QAAQ;EACR,QAAQ;EACT;AAKY,mBAAkB;EAC7B,MAAM;EACN,UAAU;EACV,MAAM;EACN,QAAQ;EACR,OAAO;EACP,WAAW;EACX,QAAQ;EACT"}
+{"version":3,"file":"paths.js","names":["resolveAgentDirScoped","resolveAgentHomeScoped","resolveAgentProfileDirScoped","resolveAgentProfileMarkdownPathScoped"],"sources":["../../../src/config/paths.ts"],"sourcesContent":["import { join, sep } from 'path';\nimport { fileURLToPath } from 'url';\nimport { dirname } from 'path';\nimport { existsSync } from 'fs';\n\nimport type { Config } from './schema.js';\nimport {\n  resolveAgentDir as resolveAgentDirScoped,\n  resolveAgentHomeDir as resolveAgentHomeScoped,\n  resolveAgentProfileDir as resolveAgentProfileDirScoped,\n  resolveAgentProfileMarkdownPath as resolveAgentProfileMarkdownPathScoped,\n  resolveAgentWorkspaceDir,\n} from '../agent/agent-scope.js';\nimport { ENV_VARS, resolveStateDir } from './paths-state.js';\n\nexport { ENV_VARS, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths-state.js';\nexport { resolveDefaultAgentWorkspaceDir } from './workspace-defaults.js';\nexport {\n  resolveAgentWorkspaceDir,\n  resolveAgentDir as resolveAgentDirFromConfig,\n  resolveAgentHomeDir as resolveAgentHomeDirFromConfig,\n} from '../agent/agent-scope.js';\n\n// ============================================\n// File Names\n// ============================================\nconst ENV_BUNDLED_EXTENSIONS_ROOT = 'XOPC_BUNDLED_EXTENSIONS_ROOT';\nconst ENV_BUNDLED_SKILLS_ROOT = 'XOPC_BUNDLED_SKILLS_ROOT';\n\nexport const FILENAMES = {\n  CONFIG: 'xopc.json',\n  MODELS_JSON: 'models.json',\n  /** Primary SQLite state database (`~/.xopc/xopc.db`). */\n  XOPC_DB: 'xopc.db',\n  EXTENSIONS_LOCK: 'extensions-lock.json',\n  CREDENTIALS_PROFILES: 'auth-profiles.json',\n  CRON_JOBS: 'jobs.json',\n  WORKSPACE_STATE: 'workspace.json',\n  SKILLS_CACHE: 'skills-cache.json',\n  /** Hub / CLI install provenance for ~/.xopc/skills/<id>. */\n  SKILLS_LOCK: 'skills-lock.json',\n  PID: 'pid',\n  STATUS: 'status.json',\n  SOCKET: 'agent.sock',\n} as const;\n\n// ============================================\n// Workspace Files\n// ============================================\nexport const WORKSPACE_FILES = {\n  SOUL: 'SOUL.md',\n  IDENTITY: 'IDENTITY.md',\n  AGENTS: 'AGENTS.md',\n  TOOLS: 'TOOLS.md',\n  HEARTBEAT: 'HEARTBEAT.md',\n  MEMORY: 'MEMORY.md',\n} as const;\n\nexport const USER_PROFILE_FILENAME = 'PROFILE.md';\nexport const USER_MEMORY_FILENAME = 'MEMORY.md';\n\n// ============================================\n// Path Resolution Functions\n// ============================================\n\n/**\n * Resolve the main config file path\n */\nexport function resolveConfigPath(): string {\n  return process.env[ENV_VARS.CONFIG_PATH] ?? join(resolveStateDir(), FILENAMES.CONFIG);\n}\n\n/**\n * Resolve the credentials directory\n */\nexport function resolveCredentialsDir(): string {\n  return process.env[ENV_VARS.CREDENTIALS_DIR] ?? join(resolveStateDir(), 'credentials');\n}\n\n/**\n * Resolve the global auth-profiles.json path\n */\nexport function resolveAuthProfilesPath(): string {\n  return join(resolveCredentialsDir(), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/** Global user profile root (`~/.xopc/user/`). */\nexport function resolveUserDir(): string {\n  return join(resolveStateDir(), 'user');\n}\n\n/** Global human/user profile Markdown (`~/.xopc/user/PROFILE.md`). */\nexport function resolveUserProfilePath(): string {\n  return join(resolveUserDir(), USER_PROFILE_FILENAME);\n}\n\n/** Global human/user long-term memory Markdown (`~/.xopc/user/MEMORY.md`). */\nexport function resolveUserMemoryPath(): string {\n  return join(resolveUserDir(), USER_MEMORY_FILENAME);\n}\n\n/**\n * Resolve OAuth token file path for a provider\n */\nexport function resolveOAuthPath(provider: string): string {\n  return join(resolveCredentialsDir(), 'oauth', `${provider}.json`);\n}\n\n/**\n * Internal agent state dir: `stateDir/agents/<id>/agent/`\n * (credentials, inbox IPC, pid, agent.json — not the Markdown workspace).\n */\nexport function resolveAgentDir(config: Config, agentId: string): string {\n  return resolveAgentDirScoped(config, agentId);\n}\n\n/**\n * Per-agent home: `stateDir/agents/<id>/` (sessions + `agent/`).\n */\nexport function resolveAgentHomeDir(config: Config, agentId: string): string {\n  return resolveAgentHomeScoped(config, agentId);\n}\n\n/** Agent profile Markdown root: `stateDir/agents/<id>/profile/`. */\nexport function resolveAgentProfileDir(config: Config, agentId: string): string {\n  return resolveAgentProfileDirScoped(config, agentId);\n}\n\n/** Single file under {@link resolveAgentProfileDir} (basename only). */\nexport function resolveAgentProfileMarkdownPath(config: Config, agentId: string, filename: string): string {\n  return resolveAgentProfileMarkdownPathScoped(config, agentId, filename);\n}\n\n/**\n * Resolve a profile system Markdown path (SOUL.md, …) under the agent `profile/` directory.\n */\nexport function resolveWorkspaceFile(config: Config, filename: string, agentId: string): string {\n  return join(resolveAgentProfileDirScoped(config, agentId), filename);\n}\n\n/**\n * OpenClaw-aligned: per-agent auth-profiles.json directly under agent dir (no credentials subdirectory).\n */\nexport function resolveAgentAuthProfilesPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.CREDENTIALS_PROFILES);\n}\n\n/**\n * Resolve the inbox directory for an agent\n */\nexport function resolveInboxDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'inbox');\n}\n\n/**\n * Resolve the pending inbox directory\n */\nexport function resolveInboxPendingDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'pending');\n}\n\n/**\n * Resolve the processed inbox directory\n */\nexport function resolveInboxProcessedDir(config: Config, agentId: string): string {\n  return join(resolveInboxDir(config, agentId), 'processed');\n}\n\n/**\n * Resolve a specific inbox message path\n */\nexport function resolveInboxMessagePath(\n  config: Config,\n  messageId: string,\n  pending: boolean,\n  agentId: string,\n): string {\n  const dir = pending ? resolveInboxPendingDir(config, agentId) : resolveInboxProcessedDir(config, agentId);\n  return join(dir, `${messageId}.json`);\n}\n\n/**\n * Resolve the pid file path\n */\nexport function resolvePidPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.PID);\n}\n\n/**\n * Resolve the status.json path\n */\nexport function resolveStatusPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.STATUS);\n}\n\n/**\n * Resolve the Unix socket path\n */\nexport function resolveSocketPath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), FILENAMES.SOCKET);\n}\n\n/**\n * Resolve the extensions directory (global)\n */\nexport function resolveExtensionsDir(): string {\n  return join(resolveStateDir(), 'extensions');\n}\n\n/**\n * Resolve the extensions lockfile path\n */\nexport function resolveExtensionsLockPath(): string {\n  return join(resolveExtensionsDir(), FILENAMES.EXTENSIONS_LOCK);\n}\n\n/**\n * Per-agent extensions directory (`…/agents/<id>/agent/extensions/`) — used for discovery of\n * legacy or manually placed copies. CLI, web store, and `extensions dev` symlink installs use\n * {@link resolveExtensionsDir} (`~/.xopc/extensions`) only.\n */\nexport function resolveWorkspaceExtensionsDir(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'extensions');\n}\n\n/**\n * Resolve the skills directory (global)\n */\nexport function resolveSkillsDir(): string {\n  return join(resolveStateDir(), 'skills');\n}\n\n/**\n * Resolve a specific skill path\n */\nexport function resolveSkillPath(skillId: string): string {\n  return join(resolveSkillsDir(), skillId, 'SKILL.md');\n}\n\n/**\n * Skills hub lock file (~/.xopc/skills-lock.json): install source + content hash per managed skill id.\n */\nexport function resolveSkillsLockPath(): string {\n  return join(resolveStateDir(), FILENAMES.SKILLS_LOCK);\n}\n\n/**\n * Resolve the cron directory\n */\nexport function resolveCronDir(): string {\n  return join(resolveStateDir(), 'cron');\n}\n\n/**\n * Resolve the cron jobs file path\n */\nexport function resolveCronJobsPath(): string {\n  return join(resolveCronDir(), FILENAMES.CRON_JOBS);\n}\n\n/**\n * Resolve the logs directory\n */\nexport function resolveLogsDir(): string {\n  return process.env[ENV_VARS.LOG_DIR] ?? join(resolveStateDir(), 'logs');\n}\n\n/**\n * Resolve a specific log file path\n */\nexport function resolveLogPath(date: string): string {\n  return join(resolveLogsDir(), `xopc-${date}.log`);\n}\n\n/**\n * Resolve the bin directory\n */\nexport function resolveBinDir(): string {\n  return join(resolveStateDir(), 'bin');\n}\n\n/**\n * Resolve the xopc CLI path\n */\nexport function resolveXopcBinPath(): string {\n  return join(resolveBinDir(), 'xopc');\n}\n\n/**\n * Resolve the tools directory\n */\nexport function resolveToolsDir(): string {\n  return join(resolveStateDir(), 'tools');\n}\n\n/**\n * Resolve the Node.js tools directory\n */\nexport function resolveNodeToolsDir(): string {\n  return join(resolveToolsDir(), 'node');\n}\n\n/**\n * Resolve the current Node.js bin directory\n */\nexport function resolveNodeBinDir(): string {\n  return join(resolveNodeToolsDir(), 'current', 'bin');\n}\n\n/**\n * Resolve the node binary path\n */\nexport function resolveNodeBinPath(): string {\n  return join(resolveNodeBinDir(), 'node');\n}\n\n/**\n * Resolve the npm binary path\n */\nexport function resolveNpmBinPath(): string {\n  return join(resolveNodeBinDir(), 'npm');\n}\n\n/**\n * Resolve the models.json path\n */\nexport function resolveModelsJsonPath(): string {\n  return join(resolveStateDir(), FILENAMES.MODELS_JSON);\n}\n\n/**\n * OpenClaw-aligned: workspace setup state directory (`<workspace>/.xopc/`).\n */\nexport function resolveWorkspaceStateDir(config: Config, agentId: string): string {\n  return join(resolveAgentWorkspaceDir(config, agentId), '.xopc');\n}\n\n/**\n * OpenClaw-aligned: workspace setup state file (`<workspace>/.xopc/workspace.json`).\n */\nexport function resolveWorkspaceStatePath(config: Config, agentId: string): string {\n  return join(resolveWorkspaceStateDir(config, agentId), FILENAMES.WORKSPACE_STATE);\n}\n\n/**\n * Resolve the skills cache file path (internal agent state, under agent dir).\n */\nexport function resolveSkillsCachePath(config: Config, agentId: string): string {\n  return join(resolveAgentDir(config, agentId), 'state', FILENAMES.SKILLS_CACHE);\n}\n\n/**\n * Resolve the bundled extensions directory (shipped with xopc).\n *\n * Layout-dependent candidates (first existing wins):\n * - `XOPC_BUNDLED_EXTENSIONS_ROOT` (Electron packaged gateway override)\n * - `dist/src/config` → `dist/extensions` (npm / gateway)\n * - `src/config` → `dist/extensions` when built, else `extensions/` (dev, tsx)\n * - `out/server` → `dist/electron/extensions` (Electron extension bundles)\n */\nexport function resolveBundledExtensionsDir(): string | null {\n  const envDir = process.env[ENV_BUNDLED_EXTENSIONS_ROOT];\n  if (envDir && existsSync(envDir)) {\n    return envDir;\n  }\n\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const isElectronServerBundle = srcDir.endsWith(`${sep}out${sep}server`);\n    const candidates = isElectronServerBundle\n      ? [join(srcDir, '..', '..', 'dist', 'electron', 'extensions')]\n      : [\n          // In source-tree dev, prefer compiled bundled extensions when present: manifests point\n          // at built JavaScript entries (for example src/index.js), while source folders contain TS.\n          join(srcDir, '..', '..', 'dist', 'extensions'),\n          join(srcDir, '..', '..', 'extensions'),\n          join(srcDir, '..', '..', '..', 'dist', 'extensions'),\n          join(srcDir, '..', '..', '..', 'extensions'),\n        ];\n    for (const dir of candidates) {\n      if (existsSync(dir)) {\n        return dir;\n      }\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the bundled skills directory (shipped with xopc)\n */\nexport function resolveBundledSkillsDir(): string | null {\n  const envDir = process.env[ENV_BUNDLED_SKILLS_ROOT];\n  if (envDir && existsSync(envDir)) {\n    return envDir;\n  }\n\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    \n    // Production (npm): dist/config/paths.js -> ../../ -> package root -> skills\n    const packageRoot = join(srcDir, '..', '..');\n    const skillsDir = join(packageRoot, 'skills');\n    if (existsSync(skillsDir)) {\n      return skillsDir;\n    }\n    \n    // Development (source): src/config/paths.js -> ../../../ -> package root -> skills\n    const devPackageRoot = join(srcDir, '..', '..', '..');\n    const devSkillsDir = join(devPackageRoot, 'skills');\n    if (existsSync(devSkillsDir)) {\n      return devSkillsDir;\n    }\n    \n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Path to extension-sdk entry (for jiti / extension loader aliases).\n */\nexport function resolveExtensionSdkPath(): string {\n  try {\n    const currentFile = fileURLToPath(import.meta.url);\n    const srcDir = dirname(currentFile);\n    const adjacent = join(srcDir, '..', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(adjacent)) {\n      return adjacent;\n    }\n    const fromPackageRoot = join(srcDir, '..', '..', 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(fromPackageRoot)) {\n      return fromPackageRoot;\n    }\n    const cwd = join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n    if (existsSync(cwd)) {\n      return cwd;\n    }\n    return adjacent;\n  } catch {\n    return join(process.cwd(), 'src', 'extensions', 'sdk', 'index.ts');\n  }\n}\n\n// Re-export existsSync for bundled paths\nexport { existsSync };\n"],"mappings":"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"}

package/dist/src/config/profile.js

@@ -1,8 +1,8 @@
 import { ENV_VARS, init_paths_state, resolveHomeDir } from "./paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { existsSync } from "fs";
 import { join } from "path";
+import { existsSync } from "fs";
 import { mkdir, readdir, rm, stat } from "fs/promises";
 //#region src/config/profile.ts
 init_logger();

package/dist/src/config/reload.js

@@ -1,6 +1,6 @@
-import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { baseLogger as logger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveModelsJsonPath } from "./paths.js";
 import { init_loader, loadConfig } from "./loader.js";
 import { diffConfigPaths } from "./diff.js";
 import { BASE_RELOAD_RULES, buildReloadPlan, matchReloadRule } from "./rules.js";
@@ -166,7 +166,7 @@ var ConfigHotReloader = class {
 			if (this.callbacks.onModelsReload) await Promise.resolve(this.callbacks.onModelsReload(newConfig));
 			return;
 		}
-		if (path.startsWith("agents.defaults.")) {
+		if (path.startsWith("agents.list") || path.startsWith("agents.capabilityPresets")) {
 			if (this.callbacks.onAgentDefaultsReload) await Promise.resolve(this.callbacks.onAgentDefaultsReload(newConfig));
 			return;
 		}

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

@@ -1 +1 @@
-{"version":3,"file":"reload.js","names":[],"sources":["../../../src/config/reload.ts"],"sourcesContent":["/**\n * Configuration hot reload manager\n */\n\nimport { watch, type FSWatcher } from 'fs';\nimport { loadConfig } from './loader.js';\nimport type { Config } from './schema.js';\nimport { diffConfigPaths } from './diff.js';\nimport { buildReloadPlan, type ReloadPlan } from './rules.js';\nimport { resolveModelsJsonPath } from './paths.js';\nimport { logger as log } from '../utils/logger.js';\n\nexport interface HotReloadConfig {\n  debounceMs: number;\n  enabled: boolean;\n}\n\nexport interface ReloadResult {\n  success: boolean;\n  plan?: ReloadPlan;\n  error?: string;\n}\n\n/**\n * Callback types for different reload actions\n */\nexport type ReloadCallback = (newConfig: Config) => void | Promise<void>;\n\nexport interface ReloadCallbacks {\n  onModelsReload?: ReloadCallback;\n  onAgentDefaultsReload?: ReloadCallback;\n  onChannelsReload?: ReloadCallback;\n  onCronReload?: ReloadCallback;\n  onHeartbeatReload?: ReloadCallback;\n  onToolsReload?: ReloadCallback;\n  onMcpReload?: ReloadCallback;\n  onWebSearchReload?: ReloadCallback;\n  /** All `extensions.*` hot paths in one batch (deduplicated in applyReload). */\n  onExtensionsReload?: (\n    newConfig: Config,\n    changedPaths: string[],\n  ) => void | Promise<void>;\n  onFullRestart?: ReloadCallback;\n}\n\n/**\n * Configuration hot reload manager\n */\nexport class ConfigHotReloader {\n  private configPath: string;\n  private callbacks: ReloadCallbacks;\n  private watcher: FSWatcher | null = null;\n  private modelsJsonWatcher: FSWatcher | null = null;\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private currentConfig: Config;\n  private debounceMs: number;\n  private enabled: boolean;\n\n  constructor(\n    configPath: string,\n    initialConfig: Config,\n    callbacks: ReloadCallbacks,\n    options: HotReloadConfig = { debounceMs: 300, enabled: true }\n  ) {\n    this.configPath = configPath;\n    this.currentConfig = initialConfig;\n    this.callbacks = callbacks;\n    this.debounceMs = options.debounceMs;\n    this.enabled = options.enabled;\n  }\n\n  /**\n   * Start watching config file for changes\n   */\n  start(): void {\n    if (!this.enabled) {\n      log.info('Config hot reload disabled');\n      return;\n    }\n\n    try {\n      this.watcher = watch(this.configPath, (eventType) => {\n        if (eventType === 'change') {\n          this.scheduleReload();\n        }\n      });\n      log.info({ path: this.configPath }, 'Config hot reload enabled');\n    } catch (err) {\n      log.error({ err }, 'Failed to setup config watcher');\n    }\n\n    this.startModelsJsonWatcher();\n  }\n\n  /**\n   * Stop watching config file\n   */\n  async stop(): Promise<void> {\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n    if (this.modelsJsonWatcher) {\n      this.modelsJsonWatcher.close();\n      this.modelsJsonWatcher = null;\n    }\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n    log.info('Config hot reload stopped');\n  }\n\n  /**\n   * Schedule a reload with debounce\n   */\n  private scheduleReload(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n    }\n    this.debounceTimer = setTimeout(() => {\n      void this.reload();\n    }, this.debounceMs);\n  }\n\n  /**\n   * Watch models.json independently so direct file edits are picked up without restarting.\n   * The watcher is best-effort: if the file does not exist yet, it will not be watched.\n   */\n  private startModelsJsonWatcher(): void {\n    const modelsJsonPath = resolveModelsJsonPath();\n    try {\n      this.modelsJsonWatcher = watch(modelsJsonPath, (eventType) => {\n        if (eventType === 'change') {\n          this.scheduleModelsJsonReload();\n        }\n      });\n      log.info({ path: modelsJsonPath }, 'models.json hot reload enabled');\n    } catch {\n      log.debug({ path: modelsJsonPath }, 'models.json not found, skipping watcher');\n    }\n  }\n\n  /**\n   * Debounced handler for models.json changes.\n   * Calls onModelsReload with the current config so the registry is refreshed.\n   */\n  private scheduleModelsJsonReload(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n    }\n    this.debounceTimer = setTimeout(() => {\n      log.info('models.json changed on disk — refreshing ModelRegistry');\n      if (this.callbacks.onModelsReload) {\n        void Promise.resolve(this.callbacks.onModelsReload(this.currentConfig));\n      }\n    }, this.debounceMs);\n  }\n\n  /**\n   * Reload configuration and apply changes\n   */\n  async reload(): Promise<ReloadResult> {\n    try {\n      log.info('Reloading configuration...');\n      \n      // Load new config\n      const newConfig = loadConfig(this.configPath);\n      \n      // Diff with current config\n      const changedPaths = diffConfigPaths(this.currentConfig, newConfig);\n      \n      if (changedPaths.length === 0) {\n        log.debug('No config changes detected');\n        return { success: true };\n      }\n      \n      log.info({ changedPaths }, 'Config changes detected');\n      \n      // Build reload plan\n      const plan = buildReloadPlan(changedPaths);\n      \n      // Apply changes based on plan\n      await this.applyReload(plan, newConfig);\n      \n      // Update current config\n      this.currentConfig = newConfig;\n      \n      return { success: true, plan };\n      \n    } catch (err) {\n      const error = err instanceof Error ? err.message : String(err);\n      log.error({ err, configPath: this.configPath, errorMessage: error }, `Config hot reload failed: ${error}`);\n      return { success: false, error };\n    }\n  }\n\n  /**\n   * Apply reload based on plan\n   */\n  private async applyReload(plan: ReloadPlan, newConfig: Config): Promise<void> {\n    // Handle restart-required changes first\n    if (plan.requiresRestart) {\n      log.info(\n        { restartPaths: plan.restartPaths },\n        'Config changes require gateway restart'\n      );\n      \n      if (this.callbacks.onFullRestart) {\n        this.callbacks.onFullRestart(newConfig);\n      }\n      return;\n    }\n\n    if (!plan.requiresHotReload) {\n      log.info({ plan }, 'Config hot reload completed');\n      return;\n    }\n\n    const isExtensionPath = (p: string) => p === 'extensions' || p.startsWith('extensions.');\n    const extensionPaths = plan.hotPaths.filter(isExtensionPath);\n    const otherPaths = plan.hotPaths.filter((p) => !isExtensionPath(p));\n\n    for (const path of otherPaths) {\n      await this.applyHotPath(path, newConfig);\n    }\n\n    if (extensionPaths.length > 0 && this.callbacks.onExtensionsReload) {\n      await Promise.resolve(this.callbacks.onExtensionsReload(newConfig, extensionPaths));\n    }\n\n    log.info({ plan }, 'Config hot reload completed');\n  }\n\n  /**\n   * Apply a single hot-reloadable path\n   */\n  private async applyHotPath(path: string, newConfig: Config): Promise<void> {\n    if (path.startsWith('models.')) {\n      if (this.callbacks.onModelsReload) {\n        await Promise.resolve(this.callbacks.onModelsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('agents.defaults.')) {\n      if (this.callbacks.onAgentDefaultsReload) {\n        await Promise.resolve(this.callbacks.onAgentDefaultsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('channels.')) {\n      if (this.callbacks.onChannelsReload) {\n        await Promise.resolve(this.callbacks.onChannelsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('cron.')) {\n      if (this.callbacks.onCronReload) {\n        await Promise.resolve(this.callbacks.onCronReload(newConfig));\n      }\n      return;\n    }\n\n    if (path === 'gateway.heartbeat' || path.startsWith('gateway.heartbeat.')) {\n      if (this.callbacks.onHeartbeatReload) {\n        await Promise.resolve(this.callbacks.onHeartbeatReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('tools.')) {\n      if (this.callbacks.onToolsReload) {\n        await Promise.resolve(this.callbacks.onToolsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('mcp.') || path === 'mcp') {\n      if (this.callbacks.onMcpReload) {\n        await Promise.resolve(this.callbacks.onMcpReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('webSearch.') || path.startsWith('webTools.')) {\n      if (this.callbacks.onWebSearchReload) {\n        await Promise.resolve(this.callbacks.onWebSearchReload(newConfig));\n      }\n      return;\n    }\n\n    log.debug({ path }, 'No handler for hot reload path');\n  }\n\n  /**\n   * Manually trigger a reload\n   */\n  async triggerReload(): Promise<ReloadResult> {\n    return this.reload();\n  }\n\n  /**\n   * Align diff baseline with a freshly loaded config (e.g. Weixin QR wrote token files but JSON unchanged).\n   */\n  syncCurrentConfig(config: Config): void {\n    this.currentConfig = config;\n  }\n\n  /**\n   * Get current config\n   */\n  getConfig(): Config {\n    return this.currentConfig;\n  }\n\n  /**\n   * Check if hot reload is enabled\n   */\n  isEnabled(): boolean {\n    return this.enabled;\n  }\n}\n\nexport { diffConfigPaths } from './diff.js';\nexport { buildReloadPlan, matchReloadRule, BASE_RELOAD_RULES } from './rules.js';\n"],"mappings":"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"}
+{"version":3,"file":"reload.js","names":[],"sources":["../../../src/config/reload.ts"],"sourcesContent":["/**\n * Configuration hot reload manager\n */\n\nimport { watch, type FSWatcher } from 'fs';\nimport { loadConfig } from './loader.js';\nimport type { Config } from './schema.js';\nimport { diffConfigPaths } from './diff.js';\nimport { buildReloadPlan, type ReloadPlan } from './rules.js';\nimport { resolveModelsJsonPath } from './paths.js';\nimport { logger as log } from '../utils/logger.js';\n\nexport interface HotReloadConfig {\n  debounceMs: number;\n  enabled: boolean;\n}\n\nexport interface ReloadResult {\n  success: boolean;\n  plan?: ReloadPlan;\n  error?: string;\n}\n\n/**\n * Callback types for different reload actions\n */\nexport type ReloadCallback = (newConfig: Config) => void | Promise<void>;\n\nexport interface ReloadCallbacks {\n  onModelsReload?: ReloadCallback;\n  onAgentDefaultsReload?: ReloadCallback;\n  onChannelsReload?: ReloadCallback;\n  onCronReload?: ReloadCallback;\n  onHeartbeatReload?: ReloadCallback;\n  onToolsReload?: ReloadCallback;\n  onMcpReload?: ReloadCallback;\n  onWebSearchReload?: ReloadCallback;\n  /** All `extensions.*` hot paths in one batch (deduplicated in applyReload). */\n  onExtensionsReload?: (\n    newConfig: Config,\n    changedPaths: string[],\n  ) => void | Promise<void>;\n  onFullRestart?: ReloadCallback;\n}\n\n/**\n * Configuration hot reload manager\n */\nexport class ConfigHotReloader {\n  private configPath: string;\n  private callbacks: ReloadCallbacks;\n  private watcher: FSWatcher | null = null;\n  private modelsJsonWatcher: FSWatcher | null = null;\n  private debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  private currentConfig: Config;\n  private debounceMs: number;\n  private enabled: boolean;\n\n  constructor(\n    configPath: string,\n    initialConfig: Config,\n    callbacks: ReloadCallbacks,\n    options: HotReloadConfig = { debounceMs: 300, enabled: true }\n  ) {\n    this.configPath = configPath;\n    this.currentConfig = initialConfig;\n    this.callbacks = callbacks;\n    this.debounceMs = options.debounceMs;\n    this.enabled = options.enabled;\n  }\n\n  /**\n   * Start watching config file for changes\n   */\n  start(): void {\n    if (!this.enabled) {\n      log.info('Config hot reload disabled');\n      return;\n    }\n\n    try {\n      this.watcher = watch(this.configPath, (eventType) => {\n        if (eventType === 'change') {\n          this.scheduleReload();\n        }\n      });\n      log.info({ path: this.configPath }, 'Config hot reload enabled');\n    } catch (err) {\n      log.error({ err }, 'Failed to setup config watcher');\n    }\n\n    this.startModelsJsonWatcher();\n  }\n\n  /**\n   * Stop watching config file\n   */\n  async stop(): Promise<void> {\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n    if (this.modelsJsonWatcher) {\n      this.modelsJsonWatcher.close();\n      this.modelsJsonWatcher = null;\n    }\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n    log.info('Config hot reload stopped');\n  }\n\n  /**\n   * Schedule a reload with debounce\n   */\n  private scheduleReload(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n    }\n    this.debounceTimer = setTimeout(() => {\n      void this.reload();\n    }, this.debounceMs);\n  }\n\n  /**\n   * Watch models.json independently so direct file edits are picked up without restarting.\n   * The watcher is best-effort: if the file does not exist yet, it will not be watched.\n   */\n  private startModelsJsonWatcher(): void {\n    const modelsJsonPath = resolveModelsJsonPath();\n    try {\n      this.modelsJsonWatcher = watch(modelsJsonPath, (eventType) => {\n        if (eventType === 'change') {\n          this.scheduleModelsJsonReload();\n        }\n      });\n      log.info({ path: modelsJsonPath }, 'models.json hot reload enabled');\n    } catch {\n      log.debug({ path: modelsJsonPath }, 'models.json not found, skipping watcher');\n    }\n  }\n\n  /**\n   * Debounced handler for models.json changes.\n   * Calls onModelsReload with the current config so the registry is refreshed.\n   */\n  private scheduleModelsJsonReload(): void {\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n    }\n    this.debounceTimer = setTimeout(() => {\n      log.info('models.json changed on disk — refreshing ModelRegistry');\n      if (this.callbacks.onModelsReload) {\n        void Promise.resolve(this.callbacks.onModelsReload(this.currentConfig));\n      }\n    }, this.debounceMs);\n  }\n\n  /**\n   * Reload configuration and apply changes\n   */\n  async reload(): Promise<ReloadResult> {\n    try {\n      log.info('Reloading configuration...');\n      \n      // Load new config\n      const newConfig = loadConfig(this.configPath);\n      \n      // Diff with current config\n      const changedPaths = diffConfigPaths(this.currentConfig, newConfig);\n      \n      if (changedPaths.length === 0) {\n        log.debug('No config changes detected');\n        return { success: true };\n      }\n      \n      log.info({ changedPaths }, 'Config changes detected');\n      \n      // Build reload plan\n      const plan = buildReloadPlan(changedPaths);\n      \n      // Apply changes based on plan\n      await this.applyReload(plan, newConfig);\n      \n      // Update current config\n      this.currentConfig = newConfig;\n      \n      return { success: true, plan };\n      \n    } catch (err) {\n      const error = err instanceof Error ? err.message : String(err);\n      log.error({ err, configPath: this.configPath, errorMessage: error }, `Config hot reload failed: ${error}`);\n      return { success: false, error };\n    }\n  }\n\n  /**\n   * Apply reload based on plan\n   */\n  private async applyReload(plan: ReloadPlan, newConfig: Config): Promise<void> {\n    // Handle restart-required changes first\n    if (plan.requiresRestart) {\n      log.info(\n        { restartPaths: plan.restartPaths },\n        'Config changes require gateway restart'\n      );\n      \n      if (this.callbacks.onFullRestart) {\n        this.callbacks.onFullRestart(newConfig);\n      }\n      return;\n    }\n\n    if (!plan.requiresHotReload) {\n      log.info({ plan }, 'Config hot reload completed');\n      return;\n    }\n\n    const isExtensionPath = (p: string) => p === 'extensions' || p.startsWith('extensions.');\n    const extensionPaths = plan.hotPaths.filter(isExtensionPath);\n    const otherPaths = plan.hotPaths.filter((p) => !isExtensionPath(p));\n\n    for (const path of otherPaths) {\n      await this.applyHotPath(path, newConfig);\n    }\n\n    if (extensionPaths.length > 0 && this.callbacks.onExtensionsReload) {\n      await Promise.resolve(this.callbacks.onExtensionsReload(newConfig, extensionPaths));\n    }\n\n    log.info({ plan }, 'Config hot reload completed');\n  }\n\n  /**\n   * Apply a single hot-reloadable path\n   */\n  private async applyHotPath(path: string, newConfig: Config): Promise<void> {\n    if (path.startsWith('models.')) {\n      if (this.callbacks.onModelsReload) {\n        await Promise.resolve(this.callbacks.onModelsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('agents.list') || path.startsWith('agents.capabilityPresets')) {\n      if (this.callbacks.onAgentDefaultsReload) {\n        await Promise.resolve(this.callbacks.onAgentDefaultsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('channels.')) {\n      if (this.callbacks.onChannelsReload) {\n        await Promise.resolve(this.callbacks.onChannelsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('cron.')) {\n      if (this.callbacks.onCronReload) {\n        await Promise.resolve(this.callbacks.onCronReload(newConfig));\n      }\n      return;\n    }\n\n    if (path === 'gateway.heartbeat' || path.startsWith('gateway.heartbeat.')) {\n      if (this.callbacks.onHeartbeatReload) {\n        await Promise.resolve(this.callbacks.onHeartbeatReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('tools.')) {\n      if (this.callbacks.onToolsReload) {\n        await Promise.resolve(this.callbacks.onToolsReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('mcp.') || path === 'mcp') {\n      if (this.callbacks.onMcpReload) {\n        await Promise.resolve(this.callbacks.onMcpReload(newConfig));\n      }\n      return;\n    }\n\n    if (path.startsWith('webSearch.') || path.startsWith('webTools.')) {\n      if (this.callbacks.onWebSearchReload) {\n        await Promise.resolve(this.callbacks.onWebSearchReload(newConfig));\n      }\n      return;\n    }\n\n    log.debug({ path }, 'No handler for hot reload path');\n  }\n\n  /**\n   * Manually trigger a reload\n   */\n  async triggerReload(): Promise<ReloadResult> {\n    return this.reload();\n  }\n\n  /**\n   * Align diff baseline with a freshly loaded config (e.g. Weixin QR wrote token files but JSON unchanged).\n   */\n  syncCurrentConfig(config: Config): void {\n    this.currentConfig = config;\n  }\n\n  /**\n   * Get current config\n   */\n  getConfig(): Config {\n    return this.currentConfig;\n  }\n\n  /**\n   * Check if hot reload is enabled\n   */\n  isEnabled(): boolean {\n    return this.enabled;\n  }\n}\n\nexport { diffConfigPaths } from './diff.js';\nexport { buildReloadPlan, matchReloadRule, BASE_RELOAD_RULES } from './rules.js';\n"],"mappings":"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"}

package/dist/src/config/rules.js

@@ -14,69 +14,19 @@ const BASE_RELOAD_RULES = [
 		description: "Model merge mode"
 	},
 	{
-		prefix: "agents.defaults.models",
+		prefix: "agents.list",
 		kind: "hot",
-		description: "Model configuration"
+		description: "Agent manifests"
 	},
 	{
-		prefix: "agents.defaults.maxTaskDurationMs",
+		prefix: "agents.capabilityPresets",
 		kind: "hot",
-		description: "Per-turn wall-clock timeout (ms)"
+		description: "Agent capability presets"
 	},
 	{
-		prefix: "agents.defaults.maxTokens",
+		prefix: "agents.default",
 		kind: "hot",
-		description: "Max tokens"
-	},
-	{
-		prefix: "agents.defaults.temperature",
-		kind: "hot",
-		description: "Temperature"
-	},
-	{
-		prefix: "agents.defaults.maxToolIterations",
-		kind: "hot",
-		description: "Max tool iterations"
-	},
-	{
-		prefix: "agents.defaults.compaction",
-		kind: "hot",
-		description: "Compaction settings"
-	},
-	{
-		prefix: "agents.defaults.pruning",
-		kind: "hot",
-		description: "Pruning settings"
-	},
-	{
-		prefix: "agents.defaults.webExtract",
-		kind: "hot",
-		description: "Web extract model and limits"
-	},
-	{
-		prefix: "agents.defaults.browser",
-		kind: "hot",
-		description: "Browser automation (Playwright) tools"
-	},
-	{
-		prefix: "agents.defaults.delegate",
-		kind: "hot",
-		description: "delegate_task sub-agent tool"
-	},
-	{
-		prefix: "agents.defaults.executeCode",
-		kind: "hot",
-		description: "execute_code sandbox tool"
-	},
-	{
-		prefix: "agents.defaults.backgroundReview",
-		kind: "hot",
-		description: "Post-turn memory/skill nudge + background review"
-	},
-	{
-		prefix: "agents.defaults.workspace",
-		kind: "none",
-		description: "Workspace path - no runtime effect"
+		description: "Default agent id"
 	},
 	{
 		prefix: "gateway.bind",

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\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  { prefix: 'gateway.siteShare', kind: 'restart', description: 'Site 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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"}
+{"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  { prefix: 'agents.list', kind: 'hot', description: 'Agent manifests' },\n  { prefix: 'agents.capabilityPresets', kind: 'hot', description: 'Agent capability presets' },\n  { prefix: 'agents.default', kind: 'hot', description: 'Default agent id' },\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  { prefix: 'gateway.siteShare', kind: 'restart', description: 'Site 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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"}