feat(config): add custom_agents overrides and strict agent validation

src/config/schema/agent-overrides.ts

@@ -1,5 +1,6 @@
 import { z } from "zod"
 import { FallbackModelsSchema } from "./fallback-models"
+import { OverridableAgentNameSchema } from "./agent-names"
 import { AgentPermissionSchema } from "./internal/permission"
 
 export const AgentOverrideConfigSchema = z.object({
@@ -55,7 +56,7 @@ export const AgentOverrideConfigSchema = z.object({
     .optional(),
 })
 
-export const AgentOverridesSchema = z.object({
+const BuiltinAgentOverridesSchema = z.object({
   build: AgentOverrideConfigSchema.optional(),
   plan: AgentOverrideConfigSchema.optional(),
   sisyphus: AgentOverrideConfigSchema.optional(),
@@ -70,7 +71,38 @@ export const AgentOverridesSchema = z.object({
   explore: AgentOverrideConfigSchema.optional(),
   "multimodal-looker": AgentOverrideConfigSchema.optional(),
   atlas: AgentOverrideConfigSchema.optional(),
-})
+}).strict()
+
+export const AgentOverridesSchema = BuiltinAgentOverridesSchema
+
+const RESERVED_CUSTOM_AGENT_NAMES = OverridableAgentNameSchema.options
+const RESERVED_CUSTOM_AGENT_NAME_SET = new Set(
+  RESERVED_CUSTOM_AGENT_NAMES.map((name) => name.toLowerCase()),
+)
+const RESERVED_CUSTOM_AGENT_NAME_PATTERN = new RegExp(
+  `^(?!(?:${RESERVED_CUSTOM_AGENT_NAMES.map((name) => name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})$).+`,
+)
+
+export const CustomAgentOverridesSchema = z
+  .record(
+    z.string().regex(
+      RESERVED_CUSTOM_AGENT_NAME_PATTERN,
+      "custom_agents key cannot reuse built-in agent override name",
+    ),
+    AgentOverrideConfigSchema,
+  )
+  .superRefine((value, ctx) => {
+    for (const key of Object.keys(value)) {
+      if (RESERVED_CUSTOM_AGENT_NAME_SET.has(key.toLowerCase())) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: [key],
+          message: "custom_agents key cannot reuse built-in agent override name",
+        })
+      }
+    }
+  })
 
 export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>
 export type AgentOverrides = z.infer<typeof AgentOverridesSchema>
+export type CustomAgentOverrides = z.infer<typeof CustomAgentOverridesSchema>

src/config/schema/oh-my-opencode-config.ts

@@ -1,7 +1,7 @@
 import { z } from "zod"
 import { AnyMcpNameSchema } from "../../mcp/types"
 import { BuiltinAgentNameSchema, BuiltinSkillNameSchema } from "./agent-names"
-import { AgentOverridesSchema } from "./agent-overrides"
+import { AgentOverridesSchema, CustomAgentOverridesSchema } from "./agent-overrides"
 import { BabysittingConfigSchema } from "./babysitting"
 import { BackgroundTaskConfigSchema } from "./background-task"
 import { BrowserAutomationConfigSchema } from "./browser-automation"
@@ -38,6 +38,7 @@ export const OhMyOpenCodeConfigSchema = z.object({
   /** Enable model fallback on API errors (default: false). Set to true to enable automatic model switching when model errors occur. */
   model_fallback: z.boolean().optional(),
   agents: AgentOverridesSchema.optional(),
+  custom_agents: CustomAgentOverridesSchema.optional(),
   categories: CategoriesConfigSchema.optional(),
   claude_code: ClaudeCodeConfigSchema.optional(),
   sisyphus_agent: SisyphusAgentConfigSchema.optional(),