oh-my-opencode 3.5.1 → 3.5.2

package/dist/cli/index.js

@@ -8326,10 +8326,9 @@ var init_cached_version = __esm(() => {
 
 // src/hooks/auto-update-checker/checker/pinned-version-updater.ts
 import * as fs9 from "fs";
-function updatePinnedVersion(configPath, oldEntry, newVersion) {
+function replacePluginEntry(configPath, oldEntry, newEntry) {
   try {
     const content = fs9.readFileSync(configPath, "utf-8");
-    const newEntry = `${PACKAGE_NAME3}@${newVersion}`;
     const pluginMatch = content.match(/"plugin"\s*:\s*\[/);
     if (!pluginMatch || pluginMatch.index === undefined) {
       log(`[auto-update-checker] No "plugin" array found in ${configPath}`);
@@ -8368,6 +8367,10 @@ function updatePinnedVersion(configPath, oldEntry, newVersion) {
     return false;
   }
 }
+function revertPinnedVersion(configPath, failedVersion, originalEntry) {
+  const failedEntry = `${PACKAGE_NAME3}@${failedVersion}`;
+  return replacePluginEntry(configPath, failedEntry, originalEntry);
+}
 var init_pinned_version_updater = __esm(() => {
   init_logger();
   init_constants3();
@@ -8642,23 +8645,23 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage) {
     return;
   }
   if (pluginInfo.isPinned) {
-    const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion);
-    if (!updated) {
-      await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
-      log("[auto-update-checker] Failed to update pinned version in config");
-      return;
-    }
-    log(`[auto-update-checker] Config updated: ${pluginInfo.entry} \u2192 ${PACKAGE_NAME3}@${latestVersion}`);
+    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
+    log(`[auto-update-checker] User-pinned version detected (${pluginInfo.entry}), skipping auto-update. Notification only.`);
+    return;
   }
   invalidatePackage(PACKAGE_NAME3);
   const installSuccess = await runBunInstallSafe();
   if (installSuccess) {
     await showAutoUpdatedToast(ctx, currentVersion, latestVersion);
     log(`[auto-update-checker] Update installed: ${currentVersion} \u2192 ${latestVersion}`);
-  } else {
-    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
-    log("[auto-update-checker] bun install failed; update not installed (falling back to notification-only)");
+    return;
   }
+  if (pluginInfo.isPinned) {
+    revertPinnedVersion(pluginInfo.configPath, latestVersion, pluginInfo.entry);
+    log("[auto-update-checker] Config reverted due to install failure");
+  }
+  await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
+  log("[auto-update-checker] bun install failed; update not installed (falling back to notification-only)");
 }
 var init_background_update_check = __esm(() => {
   init_config_manager();
@@ -8867,7 +8870,7 @@ var {
 // package.json
 var package_default = {
   name: "oh-my-opencode",
-  version: "3.5.1",
+  version: "3.5.2",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -8941,13 +8944,13 @@ var package_default = {
     typescript: "^5.7.3"
   },
   optionalDependencies: {
-    "oh-my-opencode-darwin-arm64": "3.5.1",
-    "oh-my-opencode-darwin-x64": "3.5.1",
-    "oh-my-opencode-linux-arm64": "3.5.1",
-    "oh-my-opencode-linux-arm64-musl": "3.5.1",
-    "oh-my-opencode-linux-x64": "3.5.1",
-    "oh-my-opencode-linux-x64-musl": "3.5.1",
-    "oh-my-opencode-windows-x64": "3.5.1"
+    "oh-my-opencode-darwin-arm64": "3.5.2",
+    "oh-my-opencode-darwin-x64": "3.5.2",
+    "oh-my-opencode-linux-arm64": "3.5.2",
+    "oh-my-opencode-linux-arm64-musl": "3.5.2",
+    "oh-my-opencode-linux-x64": "3.5.2",
+    "oh-my-opencode-linux-x64-musl": "3.5.2",
+    "oh-my-opencode-windows-x64": "3.5.2"
   },
   trustedDependencies: [
     "@ast-grep/cli",
@@ -22716,7 +22719,8 @@ var CategoryConfigSchema = exports_external.object({
   textVerbosity: exports_external.enum(["low", "medium", "high"]).optional(),
   tools: exports_external.record(exports_external.string(), exports_external.boolean()).optional(),
   prompt_append: exports_external.string().optional(),
-  is_unstable_agent: exports_external.boolean().optional()
+  is_unstable_agent: exports_external.boolean().optional(),
+  disable: exports_external.boolean().optional()
 });
 var BuiltinCategoryNameSchema = exports_external.enum([
   "visual-engineering",

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

@@ -27,6 +27,7 @@ export declare const CategoryConfigSchema: z.ZodObject<{
     tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     prompt_append: z.ZodOptional<z.ZodString>;
     is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
+    disable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const BuiltinCategoryNameSchema: z.ZodEnum<{
     "visual-engineering": "visual-engineering";
@@ -66,6 +67,7 @@ export declare const CategoriesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObjec
     tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     prompt_append: z.ZodOptional<z.ZodString>;
     is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
+    disable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export type CategoryConfig = z.infer<typeof CategoryConfigSchema>;
 export type CategoriesConfig = z.infer<typeof CategoriesConfigSchema>;

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -1158,6 +1158,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
         prompt_append: z.ZodOptional<z.ZodString>;
         is_unstable_agent: z.ZodOptional<z.ZodBoolean>;
+        disable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
     claude_code: z.ZodOptional<z.ZodObject<{
         mcp: z.ZodOptional<z.ZodBoolean>;

package/dist/hooks/auto-update-checker/checker/pinned-version-updater.d.ts

@@ -1 +1,2 @@
 export declare function updatePinnedVersion(configPath: string, oldEntry: string, newVersion: string): boolean;
+export declare function revertPinnedVersion(configPath: string, failedVersion: string, originalEntry: string): boolean;

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -3,6 +3,6 @@ export { getLocalDevVersion } from "./checker/local-dev-version";
 export { findPluginEntry } from "./checker/plugin-entry";
 export type { PluginEntryInfo } from "./checker/plugin-entry";
 export { getCachedVersion } from "./checker/cached-version";
-export { updatePinnedVersion } from "./checker/pinned-version-updater";
+export { updatePinnedVersion, revertPinnedVersion } from "./checker/pinned-version-updater";
 export { getLatestVersion } from "./checker/latest-version";
 export { checkForUpdate } from "./checker/check-for-update";

package/dist/index.js

@@ -12252,7 +12252,14 @@ function readBoulderState(directory) {
   }
   try {
     const content = readFileSync(filePath, "utf-8");
-    return JSON.parse(content);
+    const parsed = JSON.parse(content);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return null;
+    }
+    if (!Array.isArray(parsed.session_ids)) {
+      parsed.session_ids = [];
+    }
+    return parsed;
   } catch {
     return null;
   }
@@ -12274,7 +12281,10 @@ function appendSessionId(directory, sessionId) {
   const state = readBoulderState(directory);
   if (!state)
     return null;
-  if (!state.session_ids.includes(sessionId)) {
+  if (!state.session_ids?.includes(sessionId)) {
+    if (!Array.isArray(state.session_ids)) {
+      state.session_ids = [];
+    }
     state.session_ids.push(sessionId);
     if (writeBoulderState(directory, state)) {
       return state;
@@ -26785,7 +26795,7 @@ function createCommentCheckerHooks(config2) {
     "tool.execute.after": async (input, output) => {
       debugLog3("tool.execute.after:", { tool: input.tool, callID: input.callID });
       const toolLower = input.tool.toLowerCase();
-      const outputLower = output.output.toLowerCase();
+      const outputLower = (output.output ?? "").toLowerCase();
       const isToolFailure = outputLower.includes("error:") || outputLower.includes("failed to") || outputLower.includes("could not") || outputLower.startsWith("error");
       if (isToolFailure) {
         debugLog3("skipping due to tool failure in output");
@@ -36389,10 +36399,9 @@ function getCachedVersion() {
 // src/hooks/auto-update-checker/checker/pinned-version-updater.ts
 init_logger();
 import * as fs12 from "fs";
-function updatePinnedVersion(configPath, oldEntry, newVersion) {
+function replacePluginEntry(configPath, oldEntry, newEntry) {
   try {
     const content = fs12.readFileSync(configPath, "utf-8");
-    const newEntry = `${PACKAGE_NAME}@${newVersion}`;
     const pluginMatch = content.match(/"plugin"\s*:\s*\[/);
     if (!pluginMatch || pluginMatch.index === undefined) {
       log(`[auto-update-checker] No "plugin" array found in ${configPath}`);
@@ -36431,6 +36440,10 @@ function updatePinnedVersion(configPath, oldEntry, newVersion) {
     return false;
   }
 }
+function revertPinnedVersion(configPath, failedVersion, originalEntry) {
+  const failedEntry = `${PACKAGE_NAME}@${failedVersion}`;
+  return replacePluginEntry(configPath, failedEntry, originalEntry);
+}
 // src/hooks/auto-update-checker/checker/latest-version.ts
 async function getLatestVersion(channel = "latest") {
   const controller = new AbortController;
@@ -36673,23 +36686,23 @@ async function runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage) {
     return;
   }
   if (pluginInfo.isPinned) {
-    const updated = updatePinnedVersion(pluginInfo.configPath, pluginInfo.entry, latestVersion);
-    if (!updated) {
-      await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
-      log("[auto-update-checker] Failed to update pinned version in config");
-      return;
-    }
-    log(`[auto-update-checker] Config updated: ${pluginInfo.entry} \u2192 ${PACKAGE_NAME}@${latestVersion}`);
+    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
+    log(`[auto-update-checker] User-pinned version detected (${pluginInfo.entry}), skipping auto-update. Notification only.`);
+    return;
   }
   invalidatePackage(PACKAGE_NAME);
   const installSuccess = await runBunInstallSafe();
   if (installSuccess) {
     await showAutoUpdatedToast(ctx, currentVersion, latestVersion);
     log(`[auto-update-checker] Update installed: ${currentVersion} \u2192 ${latestVersion}`);
-  } else {
-    await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
-    log("[auto-update-checker] bun install failed; update not installed (falling back to notification-only)");
+    return;
   }
+  if (pluginInfo.isPinned) {
+    revertPinnedVersion(pluginInfo.configPath, latestVersion, pluginInfo.entry);
+    log("[auto-update-checker] Config reverted due to install failure");
+  }
+  await showUpdateAvailableToast(ctx, latestVersion, getToastMessage);
+  log("[auto-update-checker] bun install failed; update not installed (falling back to notification-only)");
 }
 
 // src/hooks/auto-update-checker/hook/config-errors-toast.ts
@@ -42832,7 +42845,7 @@ function createEditErrorRecoveryHook(_ctx) {
     "tool.execute.after": async (input, output) => {
       if (input.tool.toLowerCase() !== "edit")
         return;
-      const outputLower = output.output.toLowerCase();
+      const outputLower = (output.output ?? "").toLowerCase();
       const hasEditError = EDIT_ERROR_PATTERNS.some((pattern) => outputLower.includes(pattern.toLowerCase()));
       if (hasEditError) {
         output.output += `
@@ -42965,7 +42978,7 @@ function getAgentFromSession(sessionID, directory) {
   if (memoryAgent)
     return memoryAgent;
   const boulderState = readBoulderState(directory);
-  if (boulderState?.session_ids.includes(sessionID) && boulderState.agent) {
+  if (boulderState?.session_ids?.includes(sessionID) && boulderState.agent) {
     return boulderState.agent;
   }
   return getAgentFromMessageFiles(sessionID);
@@ -43120,15 +43133,16 @@ function createTaskResumeInfoHook() {
   const toolExecuteAfter = async (input, output) => {
     if (!TARGET_TOOLS2.includes(input.tool))
       return;
-    if (output.output.startsWith("Error:") || output.output.startsWith("Failed"))
+    const outputText = output.output ?? "";
+    if (outputText.startsWith("Error:") || outputText.startsWith("Failed"))
       return;
-    if (output.output.includes(`
+    if (outputText.includes(`
 to continue:`))
       return;
-    const sessionId = extractSessionId(output.output);
+    const sessionId = extractSessionId(outputText);
     if (!sessionId)
       return;
-    output.output = output.output.trimEnd() + `
+    output.output = outputText.trimEnd() + `
 
 to continue: task(session_id="${sessionId}", prompt="...")`;
   };
@@ -43629,7 +43643,7 @@ function createAtlasEventHandler(input) {
         return;
       log(`[${HOOK_NAME7}] session.idle`, { sessionID });
       const boulderState = readBoulderState(ctx.directory);
-      const isBoulderSession = boulderState?.session_ids.includes(sessionID) ?? false;
+      const isBoulderSession = boulderState?.session_ids?.includes(sessionID) ?? false;
       const isBackgroundTaskSession = subagentSessions.has(sessionID);
       if (!isBackgroundTaskSession && !isBoulderSession) {
         log(`[${HOOK_NAME7}] Skipped: not boulder or background task session`, { sessionID });
@@ -43798,7 +43812,23 @@ function buildOrchestratorReminder(planName, progress, sessionId) {
 
 ${buildVerificationReminder(sessionId)}
 
-**STEP 5: CHECK BOULDER STATE DIRECTLY (EVERY TIME \u2014 NO EXCEPTIONS)**
+**STEP 5: READ SUBAGENT NOTEPAD (LEARNINGS, ISSUES, PROBLEMS)**
+
+The subagent was instructed to record findings in notepad files. Read them NOW:
+\`\`\`
+Glob(".sisyphus/notepads/${planName}/*.md")
+\`\`\`
+Then \`Read\` each file found \u2014 especially:
+- **learnings.md**: Patterns, conventions, successful approaches discovered
+- **issues.md**: Problems, blockers, gotchas encountered during work
+- **problems.md**: Unresolved issues, technical debt flagged
+
+**USE this information to:**
+- Inform your next delegation (avoid known pitfalls)
+- Adjust your plan if blockers were discovered
+- Propagate learnings to subsequent subagents
+
+**STEP 6: CHECK BOULDER STATE DIRECTLY (EVERY TIME \u2014 NO EXCEPTIONS)**
 
 Do NOT rely on cached progress. Read the plan file NOW:
 \`\`\`
@@ -43807,7 +43837,7 @@ Read(".sisyphus/plans/${planName}.md")
 Count exactly: how many \`- [ ]\` remain? How many \`- [x]\` completed?
 This is YOUR ground truth. Use it to decide what comes next.
 
-**STEP 6: MARK COMPLETION IN PLAN FILE (IMMEDIATELY)**
+**STEP 7: MARK COMPLETION IN PLAN FILE (IMMEDIATELY)**
 
 RIGHT NOW - Do not delay. Verification passed \u2192 Mark IMMEDIATELY.
 
@@ -43817,12 +43847,12 @@ Update the plan file \`.sisyphus/plans/${planName}.md\`:
 
 **DO THIS BEFORE ANYTHING ELSE. Unmarked = Untracked = Lost progress.**
 
-**STEP 7: COMMIT ATOMIC UNIT**
+**STEP 8: COMMIT ATOMIC UNIT**
 
 - Stage ONLY the verified changes
 - Commit with clear message describing what was done
 
-**STEP 8: PROCEED TO NEXT TASK**
+**STEP 9: PROCEED TO NEXT TASK**
 
 - Read the plan file AGAIN to identify the next \`- [ ]\` task
 - Start immediately - DO NOT STOP
@@ -43916,7 +43946,7 @@ function createToolExecuteAfterHandler2(input) {
       const boulderState = readBoulderState(ctx.directory);
       if (boulderState) {
         const progress = getPlanProgress(boulderState.active_plan);
-        if (toolInput.sessionID && !boulderState.session_ids.includes(toolInput.sessionID)) {
+        if (toolInput.sessionID && !boulderState.session_ids?.includes(toolInput.sessionID)) {
           appendSessionId(ctx.directory, toolInput.sessionID);
           log(`[${HOOK_NAME7}] Appended session to boulder`, {
             sessionID: toolInput.sessionID,
@@ -49526,10 +49556,7 @@ async function createOrGetSession(args, toolContext, ctx) {
     const createResult = await ctx.client.session.create({
       body: {
         parentID: toolContext.sessionID,
-        title: `${args.description} (@${args.subagent_type} subagent)`,
-        permission: [
-          { permission: "question", action: "deny", pattern: "*" }
-        ]
+        title: `${args.description} (@${args.subagent_type} subagent)`
       },
       query: {
         directory: parentDirectory
@@ -49552,6 +49579,7 @@ Original error: ${createResult.error}`);
     }
     const sessionID = createResult.data.id;
     log(`[call_omo_agent] Created session: ${sessionID}`);
+    subagentSessions.add(sessionID);
     return { sessionID, isNew: true };
   }
 }
@@ -50027,6 +50055,15 @@ Original error: ${createResult.error}`;
 }
 // src/tools/delegate-task/tools.ts
 init_constants();
+
+// src/shared/merge-categories.ts
+init_constants();
+function mergeCategories(userCategories) {
+  const merged = userCategories ? { ...DEFAULT_CATEGORIES, ...userCategories } : { ...DEFAULT_CATEGORIES };
+  return Object.fromEntries(Object.entries(merged).filter(([, config3]) => !config3.disable));
+}
+
+// src/tools/delegate-task/tools.ts
 init_logger();
 
 // src/tools/delegate-task/prompt-builder.ts
@@ -50848,10 +50885,7 @@ async function createSyncSession(client2, input) {
   const createResult = await client2.session.create({
     body: {
       parentID: input.parentSessionID,
-      title: `${input.description} (@${input.agentToUse} subagent)`,
-      permission: [
-        { permission: "question", action: "deny", pattern: "*" }
-      ]
+      title: `${input.description} (@${input.agentToUse} subagent)`
     },
     query: {
       directory: parentDirectory
@@ -51035,9 +51069,6 @@ session_id: ${sessionID}
     }
   }
 }
-// src/tools/delegate-task/category-resolver.ts
-init_constants();
-
 // src/tools/delegate-task/sisyphus-junior-agent.ts
 var SISYPHUS_JUNIOR_AGENT2 = "sisyphus-junior";
 
@@ -51049,6 +51080,9 @@ function resolveCategoryConfig(categoryName, options) {
   const defaultConfig = DEFAULT_CATEGORIES[categoryName];
   const userConfig = userCategories?.[categoryName];
   const hasExplicitUserConfig = userConfig !== undefined;
+  if (userConfig?.disable) {
+    return null;
+  }
   const categoryReq = CATEGORY_MODEL_REQUIREMENTS[categoryName];
   if (categoryReq?.requiresModel && availableModels && !hasExplicitUserConfig) {
     if (!isModelAvailable(categoryReq.requiresModel, availableModels)) {
@@ -51198,7 +51232,8 @@ async function resolveCategoryExecution(args, executorCtx, inheritedModel, syste
   const { client: client2, userCategories, sisyphusJuniorModel } = executorCtx;
   const availableModels = await getAvailableModelsForDelegateTask(client2);
   const categoryName = args.category;
-  const categoryExists = DEFAULT_CATEGORIES[categoryName] !== undefined || userCategories?.[categoryName] !== undefined;
+  const enabledCategories = mergeCategories(userCategories);
+  const categoryExists = enabledCategories[categoryName] !== undefined;
   const resolved = resolveCategoryConfig(categoryName, {
     userCategories,
     inheritedModel,
@@ -51207,7 +51242,7 @@ async function resolveCategoryExecution(args, executorCtx, inheritedModel, syste
   });
   if (!resolved) {
     const requirement2 = CATEGORY_MODEL_REQUIREMENTS[categoryName];
-    const allCategoryNames = Object.keys({ ...DEFAULT_CATEGORIES, ...userCategories }).join(", ");
+    const allCategoryNames = Object.keys(enabledCategories).join(", ");
     if (categoryExists && requirement2?.requiresModel) {
       return {
         agentToUse: "",
@@ -51282,7 +51317,7 @@ Available categories: ${allCategoryNames}`
   }
   const categoryPromptAppend = resolved.promptAppend || undefined;
   if (!categoryModel && !actualModel) {
-    const categoryNames = Object.keys({ ...DEFAULT_CATEGORIES, ...userCategories });
+    const categoryNames = Object.keys(enabledCategories);
     return {
       agentToUse: "",
       categoryModel: undefined,
@@ -51392,7 +51427,7 @@ Create the work plan directly - that's your job as the planning agent.`
 // src/tools/delegate-task/tools.ts
 function createDelegateTask(options) {
   const { userCategories } = options;
-  const allCategories = { ...DEFAULT_CATEGORIES, ...userCategories };
+  const allCategories = mergeCategories(userCategories);
   const categoryNames = Object.keys(allCategories);
   const categoryExamples = categoryNames.map((k) => `'${k}'`).join(", ");
   const availableCategories = options.availableCategories ?? Object.entries(allCategories).map(([name, categoryConfig]) => {
@@ -52764,14 +52799,10 @@ class BackgroundManager {
     });
     const parentDirectory = parentSession?.data?.directory ?? this.directory;
     log(`[background-agent] Parent dir: ${parentSession?.data?.directory}, using: ${parentDirectory}`);
-    const inheritedPermission = parentSession?.data?.permission;
-    const permissionRules = Array.isArray(inheritedPermission) ? inheritedPermission.filter((r) => r?.permission !== "question") : [];
-    permissionRules.push({ permission: "question", action: "deny", pattern: "*" });
     const createResult = await this.client.session.create({
       body: {
         parentID: input.parentSessionID,
-        title: `${input.description} (@${input.agent} subagent)`,
-        permission: permissionRules
+        title: `${input.description} (@${input.agent} subagent)`
       },
       query: {
         directory: parentDirectory
@@ -62230,7 +62261,7 @@ ${rows.join(`
 `)}`;
 }
 function buildCategorySection(userCategories) {
-  const allCategories = { ...DEFAULT_CATEGORIES, ...userCategories };
+  const allCategories = mergeCategories(userCategories);
   const categoryRows = Object.entries(allCategories).map(([name, config3]) => {
     const temp = config3.temperature ?? 0.5;
     return `| \`${name}\` | ${temp} | ${getCategoryDescription(name, userCategories)} |`;
@@ -62306,7 +62337,7 @@ task(category="[category]", load_skills=["skill-1", "skill-2"], run_in_backgroun
 - Missing a relevant skill = suboptimal output quality`;
 }
 function buildDecisionMatrix(agents, userCategories) {
-  const allCategories = { ...DEFAULT_CATEGORIES, ...userCategories };
+  const allCategories = mergeCategories(userCategories);
   const categoryRows = Object.entries(allCategories).map(([name]) => `| ${getCategoryDescription(name, userCategories)} | \`category="${name}", load_skills=[...]\` |`);
   const agentRows = agents.map((a) => {
     const shortDesc = truncateDescription(a.description);
@@ -62324,7 +62355,6 @@ ${agentRows.join(`
 **NEVER provide both category AND agent - they are mutually exclusive.**`;
 }
 // src/agents/atlas/agent.ts
-init_constants();
 var MODE7 = "primary";
 function getAtlasPromptSource(model) {
   if (model && isGptModel2(model)) {
@@ -62347,7 +62377,7 @@ function buildDynamicOrchestratorPrompt(ctx) {
   const skills = ctx?.availableSkills ?? [];
   const userCategories = ctx?.userCategories;
   const model = ctx?.model;
-  const allCategories = { ...DEFAULT_CATEGORIES, ...userCategories };
+  const allCategories = mergeCategories(userCategories);
   const availableCategories = Object.entries(allCategories).map(([name]) => ({
     name,
     description: getCategoryDescription(name, userCategories)
@@ -63223,13 +63253,12 @@ function buildAvailableSkills(discoveredSkills, browserProvider, disabledSkills)
 }
 
 // src/agents/agent-builder.ts
-init_constants();
 function isFactory(source) {
   return typeof source === "function";
 }
 function buildAgent(source, model, categories, gitMasterConfig, browserProvider, disabledSkills) {
   const base = isFactory(source) ? source(model) : { ...source };
-  const categoryConfigs = categories ? { ...DEFAULT_CATEGORIES, ...categories } : DEFAULT_CATEGORIES;
+  const categoryConfigs = mergeCategories(categories);
   const agentWithCategory = base;
   if (agentWithCategory.category) {
     const categoryConfig = categoryConfigs[agentWithCategory.category];
@@ -63639,7 +63668,7 @@ async function createBuiltinAgents(disabledAgents = [], agentOverrides = {}, dir
   });
   const isFirstRunNoCache = availableModels.size === 0 && (!connectedProviders || connectedProviders.length === 0);
   const result = {};
-  const mergedCategories = categories ? { ...DEFAULT_CATEGORIES, ...categories } : DEFAULT_CATEGORIES;
+  const mergedCategories = mergeCategories(categories);
   const availableCategories = Object.entries(mergedCategories).map(([name]) => ({
     name,
     description: categories?.[name]?.description ?? CATEGORY_DESCRIPTIONS[name] ?? "General tasks"
@@ -66682,8 +66711,8 @@ function createManagers(args) {
 // src/plugin/available-categories.ts
 init_constants();
 function createAvailableCategories(pluginConfig) {
-  const mergedCategories = pluginConfig.categories ? { ...DEFAULT_CATEGORIES, ...pluginConfig.categories } : DEFAULT_CATEGORIES;
-  return Object.entries(mergedCategories).map(([name, categoryConfig]) => {
+  const categories = mergeCategories(pluginConfig.categories);
+  return Object.entries(categories).map(([name, categoryConfig]) => {
     const model = typeof categoryConfig.model === "string" ? categoryConfig.model : undefined;
     return {
       name,
@@ -67431,7 +67460,8 @@ var CategoryConfigSchema = exports_external.object({
   textVerbosity: exports_external.enum(["low", "medium", "high"]).optional(),
   tools: exports_external.record(exports_external.string(), exports_external.boolean()).optional(),
   prompt_append: exports_external.string().optional(),
-  is_unstable_agent: exports_external.boolean().optional()
+  is_unstable_agent: exports_external.boolean().optional(),
+  disable: exports_external.boolean().optional()
 });
 var BuiltinCategoryNameSchema = exports_external.enum([
   "visual-engineering",

package/dist/shared/merge-categories.d.ts

@@ -0,0 +1,6 @@
+import type { CategoriesConfig, CategoryConfig } from "../config/schema";
+/**
+ * Merge default and user categories, filtering out disabled ones.
+ * Single source of truth for category merging across the codebase.
+ */
+export declare function mergeCategories(userCategories?: CategoriesConfig): Record<string, CategoryConfig>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode",
-  "version": "3.5.1",
+  "version": "3.5.2",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -74,13 +74,13 @@
     "typescript": "^5.7.3"
   },
   "optionalDependencies": {
-    "oh-my-opencode-darwin-arm64": "3.5.1",
-    "oh-my-opencode-darwin-x64": "3.5.1",
-    "oh-my-opencode-linux-arm64": "3.5.1",
-    "oh-my-opencode-linux-arm64-musl": "3.5.1",
-    "oh-my-opencode-linux-x64": "3.5.1",
-    "oh-my-opencode-linux-x64-musl": "3.5.1",
-    "oh-my-opencode-windows-x64": "3.5.1"
+    "oh-my-opencode-darwin-arm64": "3.5.2",
+    "oh-my-opencode-darwin-x64": "3.5.2",
+    "oh-my-opencode-linux-arm64": "3.5.2",
+    "oh-my-opencode-linux-arm64-musl": "3.5.2",
+    "oh-my-opencode-linux-x64": "3.5.2",
+    "oh-my-opencode-linux-x64-musl": "3.5.2",
+    "oh-my-opencode-windows-x64": "3.5.2"
   },
   "trustedDependencies": [
     "@ast-grep/cli",