oh-my-opencode-slim 1.0.0 → 1.0.1

package/README.md

@@ -105,7 +105,7 @@ ping all agents
 
 <div align="center">
   <img src="img/ping.png" alt="Ping all agents" width="600">
-  <p><i>Confirmation that all six agents are online and ready.</i></p>
+  <p><i>Confirmation that all configured agents are online and ready.</i></p>
 </div>
 
 If any agent fails to respond, check your provider authentication and config file.
@@ -239,7 +239,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### Council: The Chorus of Minds
+### 04. Council: The Chorus of Minds
 
 > [!NOTE]
 > **Why doesn't Orchestrator auto-call Council more often?** This is intentional. Council runs multiple models at once, so automatic delegation is kept strict because it is usually the highest-cost path in the system. In practice, Council is meant to be used manually when you want it, for example: <code>@council compare these two architectures</code>.
@@ -288,7 +288,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 04. Librarian: The Weaver of Knowledge
+### 05. Librarian: The Weaver of Knowledge
 
 <table>
   <tr>
@@ -329,7 +329,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 05. Designer: The Guardian of Aesthetics
+### 06. Designer: The Guardian of Aesthetics
 
 <table>
   <tr>
@@ -370,7 +370,7 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ---
 
-### 06. Fixer: The Last Builder
+### 07. Fixer: The Last Builder
 
 <table>
   <tr>
@@ -409,18 +409,22 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
 </table>
 
-### 07. Observer: The Silent Witness
+---
+
+## Optional Agents
+
+### Observer: The Silent Witness
 
 > [!NOTE]
 > **Why a separate agent?** If your Orchestrator model is not multimodal, enable Observer to handle images, screenshots, PDFs, and other visual files. Observer is disabled by default and gives the Orchestrator a dedicated multimodal reader without forcing you to change your main reasoning model. Set `disabled_agents: []` and an `observer` model in your configuration.
 
 <table>
   <tr>
-    <td width="240" valign="top">
-      <b>Observer</b><br>
-      <i>Visual & binary analysis</i>
+    <td width="30%" align="center" valign="top">
+      <img src="img/observer.jpg" width="240" style="border-radius: 10px;">
+      <br><sub><i>The eye that reads what others cannot.</i></sub>
     </td>
-    <td>
+    <td width="70%" valign="top">
 
 **Read-only visual analysis** — interprets images, screenshots, PDFs, and diagrams. Returns structured observations to the orchestrator without loading raw file bytes into the main context window.
 
@@ -469,6 +473,7 @@ Use this section as a map: start with installation, then jump to features, confi
 | **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow |
 | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
 | **[Todo Continuation](docs/todo-continuation.md)** | Auto-continue orchestrator sessions with cooldowns and safety checks |
+| **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
 | **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
 
 ### ⚙️ Config & Reference

package/dist/cli/index.js

@@ -158,13 +158,15 @@ var CouncilConfigSchema = z.object({
     deprecated.push("master_timeout");
   if (data.master_fallback !== undefined)
     deprecated.push("master_fallback");
+  const legacyMasterModel = typeof data.master === "object" && data.master !== null && "model" in data.master && typeof data.master.model === "string" ? data.master.model : undefined;
   return {
     presets: data.presets,
     timeout: data.timeout,
     default_preset: data.default_preset,
     councillor_execution_mode: data.councillor_execution_mode,
     councillor_retries: data.councillor_retries,
-    _deprecated: deprecated.length > 0 ? deprecated : undefined
+    _deprecated: deprecated.length > 0 ? deprecated : undefined,
+    _legacyMasterModel: legacyMasterModel
   };
 });
 // src/config/schema.ts

package/dist/config/council-schema.d.ts

@@ -82,6 +82,7 @@ export declare const CouncilConfigSchema: z.ZodPipe<z.ZodObject<{
     councillor_execution_mode: "parallel" | "serial";
     councillor_retries: number;
     _deprecated: string[] | undefined;
+    _legacyMasterModel: string | undefined;
 }, {
     presets: Record<string, Record<string, {
         model: string;

package/dist/config/schema.d.ts

@@ -345,6 +345,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         councillor_execution_mode: "parallel" | "serial";
         councillor_retries: number;
         _deprecated: string[] | undefined;
+        _legacyMasterModel: string | undefined;
     }, {
         presets: Record<string, Record<string, {
             model: string;

package/dist/council/council-manager.d.ts

@@ -15,9 +15,12 @@ export declare class CouncilManager {
     private depthTracker?;
     private tmuxEnabled;
     private deprecatedFields?;
+    private legacyMasterModel?;
     constructor(ctx: PluginInput, config?: PluginConfig, depthTracker?: SubagentDepthTracker, tmuxEnabled?: boolean);
     /** Return deprecated config fields detected during parsing (for tool warnings). */
     getDeprecatedFields(): string[] | undefined;
+    /** Return the legacy master.model if it was used as fallback. */
+    getLegacyMasterModel(): string | undefined;
     /**
      * Run a full council session.
      *

package/dist/index.js

@@ -18378,13 +18378,15 @@ var CouncilConfigSchema = z.object({
     deprecated.push("master_timeout");
   if (data.master_fallback !== undefined)
     deprecated.push("master_fallback");
+  const legacyMasterModel = typeof data.master === "object" && data.master !== null && "model" in data.master && typeof data.master.model === "string" ? data.master.model : undefined;
   return {
     presets: data.presets,
     timeout: data.timeout,
     default_preset: data.default_preset,
     councillor_execution_mode: data.councillor_execution_mode,
     councillor_retries: data.councillor_retries,
-    _deprecated: deprecated.length > 0 ? deprecated : undefined
+    _deprecated: deprecated.length > 0 ? deprecated : undefined,
+    _legacyMasterModel: legacyMasterModel
   };
 });
 // src/config/loader.ts
@@ -19630,6 +19632,13 @@ function createAgents(config) {
     applyDefaultPermissions(agent, override?.skills);
     return agent;
   });
+  const legacyMasterModel = config?.council?._legacyMasterModel;
+  if (legacyMasterModel) {
+    const councilAgent = builtInSubAgents.find((a) => a.name === "council");
+    if (councilAgent && !getAgentOverride(config, "council")?.model && councilAgent.config.model === DEFAULT_MODELS.council) {
+      councilAgent.config.model = legacyMasterModel;
+    }
+  }
   const customSubAgents = protoCustomAgents.map((agent) => {
     const override = getAgentOverride(config, agent.name);
     if (override) {
@@ -19819,17 +19828,22 @@ class CouncilManager {
   depthTracker;
   tmuxEnabled;
   deprecatedFields;
+  legacyMasterModel;
   constructor(ctx, config, depthTracker, tmuxEnabled = false) {
     this.client = ctx.client;
     this.directory = ctx.directory;
     this.config = config;
     this.deprecatedFields = config?.council?._deprecated;
+    this.legacyMasterModel = config?.council?._legacyMasterModel;
     this.depthTracker = depthTracker;
     this.tmuxEnabled = tmuxEnabled;
   }
   getDeprecatedFields() {
     return this.deprecatedFields;
   }
+  getLegacyMasterModel() {
+    return this.legacyMasterModel;
+  }
   async runCouncil(prompt, presetName, parentSessionId) {
     if (this.depthTracker) {
       const parentDepth = this.depthTracker.getDepth(parentSessionId);
@@ -22613,31 +22627,51 @@ function extFromMime(mime) {
 function sanitizeFilename(name) {
   return name.replace(/[^a-zA-Z0-9._-]/g, "_");
 }
-function cleanupOldImages(dir, saveDir) {
+function cleanupAllSessions(saveDir) {
   const now = Date.now();
-  if (!lastCleanupByDir.has(dir) && existsSync4(dir)) {
-    lastCleanupByDir.set(dir, now);
-  }
-  const lastCleanup = lastCleanupByDir.get(dir) ?? 0;
+  const lastCleanup = lastCleanupByDir.get(saveDir) ?? 0;
   if (now - lastCleanup < CLEANUP_INTERVAL)
     return;
-  lastCleanupByDir.set(dir, now);
+  lastCleanupByDir.set(saveDir, now);
+  const maxAge = 60 * 60 * 1000;
+  const dirsToScan = [];
   try {
-    const maxAge = 60 * 60 * 1000;
-    for (const f of readdirSync2(dir)) {
-      const fp = join7(dir, f);
-      try {
-        if (now - statSync3(fp).mtimeMs > maxAge)
-          unlinkSync2(fp);
-      } catch {}
-    }
-    if (dir !== saveDir) {
-      try {
-        rmdirSync(dir);
-        lastCleanupByDir.delete(dir);
-      } catch {}
+    for (const entry of readdirSync2(saveDir, { withFileTypes: true })) {
+      const fp = join7(saveDir, entry.name);
+      if (entry.isDirectory()) {
+        dirsToScan.push(fp);
+      } else {
+        try {
+          if (now - statSync3(fp).mtimeMs > maxAge)
+            unlinkSync2(fp);
+        } catch {}
+      }
     }
   } catch {}
+  for (const dir of dirsToScan) {
+    try {
+      let isEmpty = true;
+      let allRemoved = true;
+      for (const f of readdirSync2(dir)) {
+        isEmpty = false;
+        const fp = join7(dir, f);
+        try {
+          if (now - statSync3(fp).mtimeMs > maxAge) {
+            unlinkSync2(fp);
+          } else {
+            allRemoved = false;
+          }
+        } catch {
+          allRemoved = false;
+        }
+      }
+      if (!isEmpty && allRemoved) {
+        try {
+          rmdirSync(dir);
+        } catch {}
+      }
+    } catch {}
+  }
 }
 function writeUniqueFile(dir, name, data, log2) {
   const ext = extname(name);
@@ -22680,6 +22714,7 @@ function processImageAttachments(args) {
   } catch (e) {
     log2(`[image-hook] failed to create image directory: ${e}`);
   }
+  cleanupAllSessions(saveDir);
   for (const msg of messages) {
     if (msg.info.role !== "user")
       continue;
@@ -22693,7 +22728,6 @@ function processImageAttachments(args) {
     } catch (e) {
       log2(`[image-hook] failed to create target image directory: ${e}`);
     }
-    cleanupOldImages(targetDir, saveDir);
     const savedPaths = [];
     for (const p of imageParts) {
       const url = p.url;
@@ -25055,6 +25089,10 @@ function renderInterviewPage(interviewId, resumeSlug) {
         render(data);
       }
 
+      function scrollToTop() {
+        window.scrollTo({ top: 0, left: 0, behavior: 'smooth' });
+      }
+
       document.getElementById('submitButton').addEventListener('click', async () => {
         if (!state.data) return;
         const answers = (state.data.questions || []).map((question) => {
@@ -25068,6 +25106,7 @@ function renderInterviewPage(interviewId, resumeSlug) {
         const overlayText = document.getElementById('loadingText');
         overlay.classList.add('active');
         overlayText.textContent = "Submitting Answers...";
+        scrollToTop();
 
         try {
           const response = await fetch('/api/interviews/' + encodeURIComponent(interviewId) + '/answers', {
@@ -28571,14 +28610,158 @@ Returns the councillor responses with a summary footer.`,
 *Council: ${completed}/${total} councillors responded (${composition})*`;
       const deprecated = councilManager.getDeprecatedFields();
       if (deprecated && deprecated.length > 0) {
+        const legacyMasterModel = councilManager.getLegacyMasterModel();
+        const hasMaster = deprecated.includes("master");
+        const trulyIgnored = hasMaster && !legacyMasterModel ? deprecated : deprecated.filter((f) => f !== "master");
+        const parts = [];
+        if (hasMaster && legacyMasterModel) {
+          parts.push(`\`council.master\` is deprecated and will be removed in a future version. Its \`model\` is currently used as a fallback for the council agent — add a \`council\` entry to your preset to make this explicit.`);
+        }
+        if (trulyIgnored.length > 0) {
+          parts.push(`${trulyIgnored.map((f) => `\`council.${f}\``).join(", ")} ${trulyIgnored.length === 1 ? "is" : "are"} deprecated and ignored — remove ${trulyIgnored.length === 1 ? "it" : "them"} from your config.`);
+        }
         output += `
-⚠ Config warning: ${deprecated.map((f) => `\`council.${f}\``).join(", ")} ${deprecated.length === 1 ? "is" : "are"} deprecated and ignored. The council agent synthesizes directly — remove ${deprecated.length === 1 ? "it" : "them"} from your config.`;
+⚠ Config warning: ${parts.join(" ")}`;
       }
       return output;
     }
   });
   return { council_session };
 }
+// src/tools/preset-manager.ts
+var COMMAND_NAME3 = "preset";
+function createPresetManager(ctx, config) {
+  let activePreset = config.preset ?? null;
+  async function handleCommandExecuteBefore(input, output) {
+    if (input.command !== COMMAND_NAME3) {
+      return;
+    }
+    output.parts.length = 0;
+    const arg = input.arguments.trim();
+    const presets = config.presets ?? {};
+    if (!arg) {
+      output.parts.push(createInternalAgentTextPart(formatPresetList(presets)));
+      return;
+    }
+    if (/\s/.test(arg)) {
+      const suggestion = arg.split(/\s+/)[0];
+      output.parts.push(createInternalAgentTextPart(`Preset names cannot contain spaces. Did you mean: /preset ${suggestion}?`));
+      return;
+    }
+    await switchPreset(arg, presets, output);
+  }
+  function registerCommand(opencodeConfig) {
+    const configCommand = opencodeConfig.command;
+    if (!configCommand?.[COMMAND_NAME3]) {
+      if (!opencodeConfig.command) {
+        opencodeConfig.command = {};
+      }
+      opencodeConfig.command[COMMAND_NAME3] = {
+        template: "List available presets and switch between them",
+        description: "Switch agent presets at runtime (e.g., /preset cheap, /preset powerful)"
+      };
+    }
+  }
+  async function switchPreset(presetName, presets, output) {
+    const preset = presets[presetName];
+    if (!preset) {
+      const available = Object.keys(presets);
+      const hint = available.length > 0 ? `Available presets: ${available.join(", ")}` : "No presets configured. Define presets in oh-my-opencode-slim.jsonc.";
+      output.parts.push(createInternalAgentTextPart(`Preset "${presetName}" not found. ${hint}`));
+      return;
+    }
+    const agentUpdates = {};
+    for (const [agentName, override] of Object.entries(preset)) {
+      const agentConfig = mapOverrideToAgentConfig(override);
+      if (Object.keys(agentConfig).length > 0) {
+        agentUpdates[agentName] = agentConfig;
+      }
+    }
+    if (Object.keys(agentUpdates).length === 0) {
+      output.parts.push(createInternalAgentTextPart(`Preset "${presetName}" is empty (no agent overrides defined).`));
+      return;
+    }
+    try {
+      await ctx.client.config.update({
+        body: { agent: agentUpdates }
+      });
+      activePreset = presetName;
+      const summary = Object.entries(agentUpdates).map(([name, cfg]) => {
+        const parts = [name];
+        if (cfg.model)
+          parts.push(`model: ${cfg.model}`);
+        if (cfg.variant)
+          parts.push(`variant: ${cfg.variant}`);
+        if (cfg.temperature !== undefined)
+          parts.push(`temp: ${cfg.temperature}`);
+        if (cfg.options)
+          parts.push("options: yes");
+        return parts.join(" → ");
+      }).join(`
+`);
+      output.parts.push(createInternalAgentTextPart(`Switched to preset "${presetName}":
+${summary}`));
+    } catch (err) {
+      output.parts.push(createInternalAgentTextPart(`Failed to switch preset "${presetName}": ${String(err)}`));
+    }
+  }
+  function mapOverrideToAgentConfig(override) {
+    const agentConfig = {};
+    if (typeof override.model === "string") {
+      agentConfig.model = override.model;
+    } else if (Array.isArray(override.model) && override.model.length > 0) {
+      const first = override.model[0];
+      agentConfig.model = typeof first === "string" ? first : first.id;
+      if (typeof first !== "string" && first.variant) {
+        agentConfig.variant = first.variant;
+      }
+    }
+    if (typeof override.temperature === "number") {
+      agentConfig.temperature = override.temperature;
+    }
+    if (typeof override.variant === "string") {
+      agentConfig.variant = override.variant;
+    }
+    if (override.options && typeof override.options === "object" && !Array.isArray(override.options)) {
+      agentConfig.options = override.options;
+    }
+    return agentConfig;
+  }
+  function formatPresetList(presets) {
+    const names = Object.keys(presets);
+    if (names.length === 0) {
+      return 'No presets configured. Define presets in oh-my-opencode-slim.jsonc under the "presets" field.';
+    }
+    const lines = ["Available presets:"];
+    for (const name of names) {
+      const marker = name === activePreset ? " ← active" : "";
+      const preset = presets[name];
+      const agentNames = Object.keys(preset);
+      const models = agentNames.map((a) => {
+        const cfg = preset[a];
+        const modelStr = typeof cfg.model === "string" ? cfg.model : Array.isArray(cfg.model) && cfg.model.length > 0 ? resolveFirstModel(cfg.model) : undefined;
+        return modelStr ? `    ${a} → ${modelStr}` : `    ${a}`;
+      }).join(`
+`);
+      lines.push(`  ${name}${marker}`);
+      lines.push(models);
+    }
+    lines.push(`
+Usage: /preset <name> to switch.`);
+    return lines.join(`
+`);
+  }
+  function resolveFirstModel(models) {
+    if (models.length === 0)
+      return;
+    const first = models[0];
+    return typeof first === "string" ? first : first.id;
+  }
+  return {
+    handleCommandExecuteBefore,
+    registerCommand
+  };
+}
 // src/tools/smartfetch/constants.ts
 var DOCS_HOST_SUFFIXES = [
   ".readthedocs.io",
@@ -30966,6 +31149,7 @@ var OhMyOpenCodeLite = async (ctx) => {
   let foregroundFallback;
   let todoContinuationHook;
   let interviewManager;
+  let presetManager;
   let councilTools;
   let webfetch;
   let toolCount = 0;
@@ -31043,6 +31227,7 @@ var OhMyOpenCodeLite = async (ctx) => {
       autoEnableThreshold: config.todoContinuation?.autoEnableThreshold ?? 4
     });
     interviewManager = createInterviewManager(ctx, config);
+    presetManager = createPresetManager(ctx, config);
     toolCount = Object.keys(councilTools).length + Object.keys(todoContinuationHook.tool).length + 1 + 2;
   } catch (err) {
     log("[plugin] FATAL: init failed", String(err));
@@ -31197,6 +31382,7 @@ var OhMyOpenCodeLite = async (ctx) => {
         };
       }
       interviewManager.registerCommand(opencodeConfig);
+      presetManager.registerCommand(opencodeConfig);
     },
     event: async (input) => {
       const event = input.event;
@@ -31232,6 +31418,7 @@ var OhMyOpenCodeLite = async (ctx) => {
     "command.execute.before": async (input, output) => {
       await todoContinuationHook.handleCommandExecuteBefore(input, output);
       await interviewManager.handleCommandExecuteBefore(input, output);
+      await presetManager.handleCommandExecuteBefore(input, output);
     },
     "chat.headers": chatHeadersHook["chat.headers"],
     "chat.message": async (input, output) => {

package/dist/tools/index.d.ts

@@ -1,3 +1,5 @@
 export { ast_grep_replace, ast_grep_search } from './ast-grep';
 export { createCouncilTool } from './council';
+export type { PresetManager } from './preset-manager';
+export { createPresetManager } from './preset-manager';
 export { createWebfetchTool } from './smartfetch';

package/dist/tools/preset-manager.d.ts

@@ -0,0 +1,27 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { PluginConfig } from '../config';
+/**
+ * Creates a preset manager for the /preset slash command.
+ *
+ * Uses the OpenCode SDK's client.config.update() to change agent models
+ * and temperatures without restarting. The server invalidates its agent
+ * cache and re-reads config on the next prompt.
+ *
+ * Note: activePreset is tracked in-memory only and resets on plugin reload.
+ * If the user manually edits config or another mechanism changes agents,
+ * this tracker may become stale until the next /preset call.
+ */
+export declare function createPresetManager(ctx: PluginInput, config: PluginConfig): {
+    handleCommandExecuteBefore: (input: {
+        command: string;
+        sessionID: string;
+        arguments: string;
+    }, output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => Promise<void>;
+    registerCommand: (opencodeConfig: Record<string, unknown>) => void;
+};
+export type PresetManager = ReturnType<typeof createPresetManager>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-slim",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",