refactor(config): split legacy handling

2026-01-14 05:39:51 +00:00
parent a58ff1ac63
commit 5323652cfd
9 changed files with 1121 additions and 1077 deletions
--- a/src/config/legacy.rules.ts
+++ b/src/config/legacy.rules.ts
@@ -0,0 +1,134 @@
+import type { LegacyConfigRule } from "./legacy.shared.js";
+
+export const LEGACY_CONFIG_RULES: LegacyConfigRule[] = [
+  {
+    path: ["whatsapp"],
+    message:
+      "whatsapp config moved to channels.whatsapp (auto-migrated on load).",
+  },
+  {
+    path: ["telegram"],
+    message:
+      "telegram config moved to channels.telegram (auto-migrated on load).",
+  },
+  {
+    path: ["discord"],
+    message:
+      "discord config moved to channels.discord (auto-migrated on load).",
+  },
+  {
+    path: ["slack"],
+    message: "slack config moved to channels.slack (auto-migrated on load).",
+  },
+  {
+    path: ["signal"],
+    message: "signal config moved to channels.signal (auto-migrated on load).",
+  },
+  {
+    path: ["imessage"],
+    message:
+      "imessage config moved to channels.imessage (auto-migrated on load).",
+  },
+  {
+    path: ["msteams"],
+    message:
+      "msteams config moved to channels.msteams (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "allowFrom"],
+    message:
+      "routing.allowFrom was removed; use channels.whatsapp.allowFrom instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "bindings"],
+    message:
+      "routing.bindings was moved; use top-level bindings instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "agents"],
+    message:
+      "routing.agents was moved; use agents.list instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "defaultAgentId"],
+    message:
+      "routing.defaultAgentId was moved; use agents.list[].default instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "agentToAgent"],
+    message:
+      "routing.agentToAgent was moved; use tools.agentToAgent instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "groupChat", "requireMention"],
+    message:
+      'routing.groupChat.requireMention was removed; use channels.whatsapp/telegram/imessage groups defaults (e.g. channels.whatsapp.groups."*".requireMention) instead (auto-migrated on load).',
+  },
+  {
+    path: ["routing", "groupChat", "mentionPatterns"],
+    message:
+      "routing.groupChat.mentionPatterns was moved; use agents.list[].groupChat.mentionPatterns or messages.groupChat.mentionPatterns instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "queue"],
+    message:
+      "routing.queue was moved; use messages.queue instead (auto-migrated on load).",
+  },
+  {
+    path: ["routing", "transcribeAudio"],
+    message:
+      "routing.transcribeAudio was moved; use tools.audio.transcription instead (auto-migrated on load).",
+  },
+  {
+    path: ["telegram", "requireMention"],
+    message:
+      'telegram.requireMention was removed; use channels.telegram.groups."*".requireMention instead (auto-migrated on load).',
+  },
+  {
+    path: ["identity"],
+    message:
+      "identity was moved; use agents.list[].identity instead (auto-migrated on load).",
+  },
+  {
+    path: ["agent"],
+    message:
+      "agent.* was moved; use agents.defaults (and tools.* for tool/elevated/exec settings) instead (auto-migrated on load).",
+  },
+  {
+    path: ["agent", "model"],
+    message:
+      "agent.model string was replaced by agents.defaults.model.primary/fallbacks and agents.defaults.models (auto-migrated on load).",
+    match: (value) => typeof value === "string",
+  },
+  {
+    path: ["agent", "imageModel"],
+    message:
+      "agent.imageModel string was replaced by agents.defaults.imageModel.primary/fallbacks (auto-migrated on load).",
+    match: (value) => typeof value === "string",
+  },
+  {
+    path: ["agent", "allowedModels"],
+    message:
+      "agent.allowedModels was replaced by agents.defaults.models (auto-migrated on load).",
+  },
+  {
+    path: ["agent", "modelAliases"],
+    message:
+      "agent.modelAliases was replaced by agents.defaults.models.*.alias (auto-migrated on load).",
+  },
+  {
+    path: ["agent", "modelFallbacks"],
+    message:
+      "agent.modelFallbacks was replaced by agents.defaults.model.fallbacks (auto-migrated on load).",
+  },
+  {
+    path: ["agent", "imageModelFallbacks"],
+    message:
+      "agent.imageModelFallbacks was replaced by agents.defaults.imageModel.fallbacks (auto-migrated on load).",
+  },
+  {
+    path: ["gateway", "token"],
+    message:
+      "gateway.token is ignored; use gateway.auth.token instead (auto-migrated on load).",
+  },
+];