oh-my-opencode-slim 0.8.3 → 0.8.5

package/README.md

@@ -15,7 +15,7 @@
 bunx oh-my-opencode-slim@latest install
 ```
 
-The installer generates an OpenAI configuration by default (using `gpt-5.4` and `gpt-5-codex`). No provider questions asked.
+The installer generates an OpenAI configuration by default (using `gpt-5.4` and `gpt-5.4-mini`). No provider questions asked.
 
 For non-interactive mode:
 
@@ -23,6 +23,11 @@ For non-interactive mode:
 bunx oh-my-opencode-slim@latest install --no-tui --tmux=no --skills=yes
 ```
 
+To force overwrite of an existing configuration:
+```bash
+bunx oh-my-opencode-slim@latest install --reset
+```
+
 ### For Alternative Providers
 
 The default configuration uses OpenAI. To use Kimi, GitHub Copilot, or ZAI Coding Plan, see **[Provider Configurations](docs/provider-configurations.md)** for step-by-step instructions and config examples.
@@ -54,6 +59,28 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
 **Additional guides:**
 - **[Provider Configurations](docs/provider-configurations.md)** - Config examples for all supported providers
 - **[Tmux Integration](docs/tmux-integration.md)** - Real-time agent monitoring with tmux
+**[Quick Reference](docs/quick-reference.md)** - Config, fallback behavior, skills, MCPs
+
+### ✅ Verify Your Setup
+
+After installation and authentication, verify all agents are configured and responding:
+
+```bash
+opencode
+```
+
+Then run:
+
+```
+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>
+</div>
+
+If any agent fails to respond, check your provider authentication and config file.
 
 ---
 
@@ -119,12 +146,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -191,12 +218,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -263,12 +290,12 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5-codex</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5-codex</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -282,6 +309,7 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
 - **[Installation Guide](docs/installation.md)** - Detailed installation and troubleshooting
 - **[Cartography Skill](docs/cartography.md)** - Custom skill for repository mapping + codemap generation
 - **[Tmux Integration](docs/tmux-integration.md)** - Real-time agent monitoring with tmux
+**[Quick Reference](docs/quick-reference.md)** - Config, fallback behavior, skills, MCPs
 
 ---
 

package/dist/agents/council-master.d.ts

@@ -0,0 +1,2 @@
+import { type AgentDefinition } from './orchestrator';
+export declare function createCouncilMasterAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/council.d.ts

@@ -0,0 +1,28 @@
+import { type AgentDefinition } from './orchestrator';
+export declare function createCouncilAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
+/**
+ * Build the prompt for a specific councillor session.
+ *
+ * Returns the raw user prompt — the agent factory (councillor.ts) provides
+ * the system prompt with tool-aware instructions. No duplication.
+ *
+ * If a per-councillor prompt override is provided, it is prepended as
+ * role/guidance context before the user's question.
+ */
+export declare function formatCouncillorPrompt(userPrompt: string, councillorPrompt?: string): string;
+/**
+ * Build the synthesis prompt for the council master.
+ *
+ * Formats councillor results as structured data — the agent factory
+ * (council-master.ts) provides the system prompt with synthesis instructions.
+ * Returns a special prompt when all councillors failed to produce output.
+ *
+ * @param masterPrompt - Optional per-master guidance appended to the synthesis.
+ */
+export declare function formatMasterSynthesisPrompt(originalPrompt: string, councillorResults: Array<{
+    name: string;
+    model: string;
+    status: string;
+    result?: string;
+    error?: string;
+}>, masterPrompt?: string): string;

package/dist/agents/councillor.d.ts

@@ -0,0 +1,2 @@
+import { type AgentDefinition } from './orchestrator';
+export declare function createCouncillorAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/orchestrator.d.ts

@@ -9,6 +9,12 @@ export interface AgentDefinition {
         variant?: string;
     }>;
 }
+/**
+ * Resolve agent prompt from base/custom/append inputs.
+ * If customPrompt is provided, it replaces the base entirely.
+ * Otherwise, customAppendPrompt is appended to the base.
+ */
+export declare function resolvePrompt(base: string, customPrompt?: string, customAppendPrompt?: string): string;
 export declare function createOrchestratorAgent(model?: string | Array<string | {
     id: string;
     variant?: string;

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

@@ -15,6 +15,7 @@
 import type { PluginInput } from '@opencode-ai/plugin';
 import type { BackgroundTaskConfig, PluginConfig } from '../config';
 import type { TmuxConfig } from '../config/schema';
+import { SubagentDepthTracker } from './subagent-depth';
 /**
  * Represents a background task running in an isolated session.
  * Tasks are tracked from creation through completion or failure.
@@ -46,6 +47,7 @@ export declare class BackgroundTaskManager {
     private tasks;
     private tasksBySessionId;
     private agentBySessionId;
+    private depthTracker;
     private client;
     private directory;
     private tmuxEnabled;
@@ -94,7 +96,6 @@ export declare class BackgroundTaskManager {
      */
     private processQueue;
     private resolveFallbackChain;
-    private promptWithTimeout;
     /**
      * Calculate tool permissions for a spawned agent based on its own delegation rules.
      * Agents that cannot delegate (leaf nodes) get delegation tools disabled entirely,
@@ -172,4 +173,8 @@ export declare class BackgroundTaskManager {
      * Clean up all tasks.
      */
     cleanup(): void;
+    /**
+     * Get the depth tracker instance for use by other managers.
+     */
+    getDepthTracker(): SubagentDepthTracker;
 }

package/dist/background/index.d.ts

@@ -1,2 +1,3 @@
 export { type BackgroundTask, BackgroundTaskManager, type LaunchOptions, } from './background-manager';
+export { SubagentDepthTracker } from './subagent-depth';
 export { TmuxSessionManager } from './tmux-session-manager';

package/dist/background/subagent-depth.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tracks subagent spawn depth to prevent excessive nesting.
+ *
+ * Depth 0 = root session (user's main conversation)
+ * Depth 1 = agent spawned by root (e.g., explorer, council)
+ * Depth 2 = agent spawned by depth-1 agent (e.g., councillor spawned by council)
+ * Depth 3 = agent spawned by depth-2 agent (max depth by default)
+ *
+ * When max depth is exceeded, the spawn is blocked.
+ */
+export declare class SubagentDepthTracker {
+    private depthBySession;
+    private readonly _maxDepth;
+    constructor(maxDepth?: number);
+    /** Maximum allowed depth. */
+    get maxDepth(): number;
+    /**
+     * Get the current depth of a session.
+     * Root sessions (not tracked) have depth 0.
+     */
+    getDepth(sessionId: string): number;
+    /**
+     * Register a child session and check if the spawn is allowed.
+     * @returns true if allowed, false if max depth exceeded
+     */
+    registerChild(parentSessionId: string, childSessionId: string): boolean;
+    /**
+     * Clean up session tracking when a session is deleted.
+     */
+    cleanup(sessionId: string): void;
+    /**
+     * Clean up all tracking data.
+     */
+    cleanupAll(): void;
+}

package/dist/cli/config-io.d.ts

@@ -16,7 +16,7 @@ export declare function parseConfig(path: string): {
  */
 export declare function writeConfig(configPath: string, config: OpenCodeConfig): void;
 export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
-export declare function writeLiteConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function writeLiteConfig(installConfig: InstallConfig, targetPath?: string): ConfigMergeResult;
 export declare function disableDefaultAgents(): ConfigMergeResult;
 export declare function canModifyOpenCodeConfig(): boolean;
 export declare function detectCurrentConfig(): DetectedConfig;

package/dist/cli/custom-skills.d.ts

@@ -1,6 +1,6 @@
 /**
  * A custom skill bundled in this repository.
- * Unlike npx-installed skills, these are copied from src/skills/ to ~/.config/opencode/skills/
+ * Unlike npx-installed skills, these are copied from src/skills/ to the OpenCode skills directory
  */
 export interface CustomSkill {
     /** Skill name (folder name) */
@@ -21,7 +21,7 @@ export declare const CUSTOM_SKILLS: CustomSkill[];
  */
 export declare function getCustomSkillsDir(): string;
 /**
- * Install a custom skill by copying from src/skills/ to ~/.config/opencode/skills/
+ * Install a custom skill by copying from src/skills/ to the OpenCode skills directory
  * @param skill - The custom skill to install
  * @param projectRoot - Root directory of oh-my-opencode-slim project
  * @returns True if installation succeeded, false otherwise