oh-my-opencode-slim 0.8.4 → 0.8.6

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
-  <img src="img/team.png" alt="Pantheon agents" width="420">
-  <p><i>Six divine beings emerged from the dawn of code, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.</i></p>
+  <img src="img/team.png" alt="Pantheon agents" style="border-radius: 10px;" width="620">
+  <p><i>Seven divine beings emerged from the dawn of code, each an immortal master of their craft await your command to forge order from chaos and build what was once thought impossible.</i></p>
   <p><b>Open Multi Agent Suite</b> · Mix any models · Auto delegate tasks</p>
   <p><a href="https://moltfounders.com/jobs/09d1c6e7-9e0e-4683-8d78-e2376aaa2333"><img src="https://moltfounders.com/badges/4.png" alt="MoltFounders" height="30"></a></p>
 </div>
@@ -56,10 +56,6 @@ https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/mas
 
 **Detailed installation guide:** [docs/installation.md](docs/installation.md)
 
-**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
-
 ### ✅ Verify Your Setup
 
 After installation and authentication, verify all agents are configured and responding:
@@ -114,7 +110,7 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>openai/gpt-5.4</code> <code>kimi-for-coding/k2p5</code>
+      <b>Recommended Models:</b> <code>openai/gpt-5.4</code> <code>anthropic/claude-opus-4.6</code>
     </td>
   </tr>
 </table>
@@ -150,7 +146,7 @@ If any agent fails to respond, check your provider authentication and config fil
   </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.4-mini</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -181,12 +177,53 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>openai/gpt-5.4</code>
+      <b>Default Model:</b> <code>openai/gpt-5.4 (high)</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Models:</b> <code>openai/gpt-5.4 (high)</code> <code>google/gemini-3.1-pro-preview (high)</code>
+    </td>
+  </tr>
+</table>
+
+---
+
+### Council: The Chorus of Minds
+
+<table>
+  <tr>
+    <td width="30%" align="center" valign="top">
+      <img src="img/council.png" width="240" style="border-radius: 10px;">
+      <br><sub><i>Many minds, one verdict.</i></sub>
+    </td>
+    <td width="70%" valign="top">
+      The Council is not a lone being but a chamber of minds summoned when one answer is not enough. It sends your question to multiple models in parallel, gathers their competing judgments, and places them before a master who distills the strongest ideas into a single verdict. Where a solitary agent may miss a path, the Council cross-examines possibility itself.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Role:</b> <code>Multi-LLM consensus and synthesis</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Prompt:</b> <a href="src/agents/council.ts"><code>council.ts</code></a>
     </td>
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>openai/gpt-5.4</code> <code>kimi-for-coding/k2p5</code>
+      <b>Guide:</b> <a href="docs/council.md"><code>docs/council.md</code></a>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Default Setup:</b> <code>Config-driven</code> — council master + councillors are chosen from your configured preset
+    </td>
+  </tr>
+  <tr>
+    <td colspan="2">
+      <b>Recommended Setup:</b> <code>Strong master</code> + <code>diverse councillors</code> across providers
     </td>
   </tr>
 </table>
@@ -222,7 +259,7 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
   <tr>
     <td colspan="2">
-      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>openai/gpt-5.4-mini</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -253,12 +290,12 @@ If any agent fails to respond, check your provider authentication and config fil
   </tr>
   <tr>
     <td colspan="2">
-      <b>Default Model:</b> <code>kimi-for-coding/k2p5</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>
+      <b>Recommended Models:</b> <code>google/gemini-3.1-pro-preview</code> <code>kimi-for-coding/k2p5</code> 
     </td>
   </tr>
 </table>
@@ -294,7 +331,7 @@ If any agent fails to respond, check your provider authentication and config fil
   </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.4-mini</code>
+      <b>Recommended Models:</b> <code>cerebras/zai-glm-4.7</code> <code>fireworks-ai/accounts/fireworks/routers/kimi-k2p5-turbo</code> <code>openai/gpt-5.4-mini</code>
     </td>
   </tr>
 </table>
@@ -303,11 +340,35 @@ If any agent fails to respond, check your provider authentication and config fil
 
 ## 📚 Documentation
 
-- **[Quick Reference](docs/quick-reference.md)** - Skills, MCPs, Tools, Configuration
-- **[Provider Configurations](docs/provider-configurations.md)** - Config examples for OpenAI, Kimi, Copilot, ZAI
-- **[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
+### 🚀 Getting Started
+
+| Doc | Contents |
+|-----|----------|
+| **[Installation Guide](docs/installation.md)** | CLI flags, `--reset`, auth, troubleshooting |
+| **[Provider Configurations](docs/provider-configurations.md)** | OpenAI, Kimi, Copilot, ZAI, Fireworks AI — mixing providers, fallback chains |
+
+### ✨ Features
+
+| Feature | Doc | What it does |
+|---------|-----|--------------|
+| **Council** | [council.md](docs/council.md) | Run N models in parallel, synthesize one answer (`@council`) |
+| **Tmux Integration** | [tmux-integration.md](docs/tmux-integration.md) | Watch agents work in real-time with auto-spawned panes |
+| **Cartography Skill** | [cartography.md](docs/cartography.md) | Auto-generate hierarchical codemaps for any codebase |
+
+### ⚙️ Config & Reference
+
+| Doc | Contents |
+|-----|----------|
+| **[Skills](docs/skills.md)** | `simplify`, `agent-browser`, `cartography` — assignment syntax |
+| **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `grep_app` — permissions per agent |
+| **[Tools](docs/tools.md)** | Background tasks, LSP, code search, formatters |
+| **[Configuration](docs/configuration.md)** | Config files, prompt overriding, JSONC, full option reference |
+
+### 💡 Author's Setup
+
+| Doc | Contents |
+|-----|----------|
+| **[Author's Preset](docs/authors-preset.md)** | The exact config the author runs daily — OpenAI + Fireworks AI + GitHub Copilot |
 
 ---
 

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/index.js

@@ -96,7 +96,10 @@ var SUBAGENT_NAMES = [
   "librarian",
   "oracle",
   "designer",
-  "fixer"
+  "fixer",
+  "council",
+  "councillor",
+  "council-master"
 ];
 var ORCHESTRATOR_NAME = "orchestrator";
 var ALL_AGENT_NAMES = [ORCHESTRATOR_NAME, ...SUBAGENT_NAMES];
@@ -13634,6 +13637,61 @@ function date4(params) {
 
 // node_modules/zod/v4/classic/external.js
 config(en_default());
+// src/config/council-schema.ts
+var ModelIdSchema = exports_external.string().regex(/^[^/\s]+\/[^\s]+$/, 'Expected provider/model format (e.g. "openai/gpt-5.4-mini")');
+var CouncillorConfigSchema = exports_external.object({
+  model: ModelIdSchema.describe('Model ID in provider/model format (e.g. "openai/gpt-5.4-mini")'),
+  variant: exports_external.string().optional(),
+  prompt: exports_external.string().optional().describe("Optional role/guidance injected into the councillor user prompt")
+});
+var PresetMasterOverrideSchema = exports_external.object({
+  model: ModelIdSchema.optional().describe("Override the master model for this preset"),
+  variant: exports_external.string().optional().describe("Override the master variant for this preset"),
+  prompt: exports_external.string().optional().describe("Override the master synthesis guidance for this preset")
+});
+var CouncilPresetSchema = exports_external.record(exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown())).transform((entries, ctx) => {
+  const councillors = {};
+  let masterOverride;
+  for (const [key, raw] of Object.entries(entries)) {
+    if (key === "master") {
+      const parsed = PresetMasterOverrideSchema.safeParse(raw);
+      if (!parsed.success) {
+        ctx.addIssue(`Invalid master override in preset: ${parsed.error.issues.map((i) => i.message).join(", ")}`);
+        return exports_external.NEVER;
+      }
+      masterOverride = parsed.data;
+    } else {
+      const parsed = CouncillorConfigSchema.safeParse(raw);
+      if (!parsed.success) {
+        ctx.addIssue(`Invalid councillor "${key}": ${parsed.error.issues.map((i) => i.message).join(", ")}`);
+        return exports_external.NEVER;
+      }
+      councillors[key] = parsed.data;
+    }
+  }
+  return { councillors, master: masterOverride };
+});
+var CouncilMasterConfigSchema = exports_external.object({
+  model: ModelIdSchema.describe('Model ID for the council master (e.g. "anthropic/claude-opus-4-6")'),
+  variant: exports_external.string().optional(),
+  prompt: exports_external.string().optional().describe("Optional role/guidance injected into the master synthesis prompt")
+});
+var CouncilConfigSchema = exports_external.object({
+  master: CouncilMasterConfigSchema,
+  presets: exports_external.record(exports_external.string(), CouncilPresetSchema),
+  master_timeout: exports_external.number().min(0).default(300000),
+  councillors_timeout: exports_external.number().min(0).default(180000),
+  default_preset: exports_external.string().default("default"),
+  master_fallback: exports_external.array(ModelIdSchema).optional().transform((val) => {
+    if (!val)
+      return val;
+    const unique = [...new Set(val)];
+    if (unique.length !== val.length) {
+      return unique;
+    }
+    return val;
+  }).describe("Fallback models for the council master. Tried in order if the primary model fails. " + 'Example: ["anthropic/claude-sonnet-4-6", "openai/gpt-5.4"]')
+});
 // src/config/schema.ts
 var ProviderModelIdSchema = exports_external.string().regex(/^[^/\s]+\/[^\s]+$/, "Expected provider/model format (provider/.../model)");
 var ManualAgentPlanSchema = exports_external.object({
@@ -13722,7 +13780,8 @@ var PluginConfigSchema = exports_external.object({
   disabled_mcps: exports_external.array(exports_external.string()).optional(),
   tmux: TmuxConfigSchema.optional(),
   background: BackgroundTaskConfigSchema.optional(),
-  fallback: FailoverConfigSchema.optional()
+  fallback: FailoverConfigSchema.optional(),
+  council: CouncilConfigSchema.optional()
 });
 // src/config/agent-mcps.ts
 var DEFAULT_AGENT_MCPS = {
@@ -13731,7 +13790,10 @@ var DEFAULT_AGENT_MCPS = {
   oracle: [],
   librarian: ["websearch", "context7", "grep_app"],
   explorer: [],
-  fixer: []
+  fixer: [],
+  council: [],
+  councillor: [],
+  "council-master": []
 };
 
 // src/cli/skills.ts

package/dist/cli/paths.d.ts

@@ -7,6 +7,16 @@
  * 3. ~/.config/opencode
  */
 export declare function getConfigDir(): string;
+/**
+ * Get OpenCode config directories in read/search order.
+ *
+ * Resolution order:
+ * 1. OPENCODE_CONFIG_DIR (if set)
+ * 2. XDG_CONFIG_HOME/opencode or ~/.config/opencode
+ *
+ * Duplicate entries are removed.
+ */
+export declare function getConfigSearchDirs(): string[];
 export declare function getOpenCodeConfigPaths(): string[];
 export declare function getConfigJson(): string;
 export declare function getConfigJsonc(): string;

package/dist/config/constants.d.ts

@@ -1,8 +1,9 @@
 export declare const AGENT_ALIASES: Record<string, string>;
-export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer"];
+export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer", "council", "councillor", "council-master"];
 export declare const ORCHESTRATOR_NAME: "orchestrator";
-export declare const ALL_AGENT_NAMES: readonly ["orchestrator", "explorer", "librarian", "oracle", "designer", "fixer"];
+export declare const ALL_AGENT_NAMES: readonly ["orchestrator", "explorer", "librarian", "oracle", "designer", "fixer", "council", "councillor", "council-master"];
 export type AgentName = (typeof ALL_AGENT_NAMES)[number];
+export declare const ORCHESTRATABLE_AGENTS: readonly ["explorer", "librarian", "oracle", "designer", "fixer", "council"];
 export declare const SUBAGENT_DELEGATION_RULES: Record<AgentName, readonly string[]>;
 export declare const DEFAULT_MODELS: Record<AgentName, string | undefined>;
 export declare const POLL_INTERVAL_MS = 500;
@@ -11,4 +12,8 @@ export declare const POLL_INTERVAL_BACKGROUND_MS = 2000;
 export declare const DEFAULT_TIMEOUT_MS: number;
 export declare const MAX_POLL_TIME_MS: number;
 export declare const FALLBACK_FAILOVER_TIMEOUT_MS = 15000;
+export declare const DEFAULT_MAX_SUBAGENT_DEPTH = 3;
+export declare const PHASE_REMINDER_TEXT = "Recall Workflow Rules:\nUnderstand \u2192 build the best path (delegated based on Agent rules, split and parallelized as much as possible) \u2192 execute \u2192 verify.\nIf delegating, launch the specialist in the same turn you mention it.";
+export declare const TMUX_SPAWN_DELAY_MS = 500;
+export declare const COUNCILLOR_STAGGER_MS = 250;
 export declare const STABLE_POLLS_THRESHOLD = 3;

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

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+/**
+ * Configuration for a single councillor within a preset.
+ * Each councillor is an independent LLM that processes the same prompt.
+ *
+ * Councillors run as agent sessions with read-only codebase access
+ * (read, glob, grep, lsp, list). They can examine the codebase but
+ * cannot modify files or spawn subagents.
+ */
+export declare const CouncillorConfigSchema: z.ZodObject<{
+    model: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CouncillorConfig = z.infer<typeof CouncillorConfigSchema>;
+/**
+ * Per-preset master override. All fields are optional — any field
+ * provided here overrides the global `council.master` for this preset.
+ * Fields not provided fall back to the global master config.
+ */
+export declare const PresetMasterOverrideSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PresetMasterOverride = z.infer<typeof PresetMasterOverrideSchema>;
+/**
+ * A named preset grouping several councillors with an optional master override.
+ *
+ * The reserved key `"master"` provides per-preset overrides for the council
+ * master (model, variant, prompt). All other keys are treated as councillor
+ * names mapping to councillor configs.
+ *
+ * After parsing, the preset resolves to:
+ * `{ councillors: Record<string, CouncillorConfig>, master?: PresetMasterOverride }`
+ */
+export declare const CouncilPresetSchema: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodTransform<{
+    councillors: Record<string, {
+        model: string;
+        variant?: string | undefined;
+        prompt?: string | undefined;
+    }>;
+    master: {
+        model?: string | undefined;
+        variant?: string | undefined;
+        prompt?: string | undefined;
+    } | undefined;
+}, Record<string, Record<string, unknown>>>>;
+export type CouncilPreset = z.infer<typeof CouncilPresetSchema>;
+/**
+ * Council Master configuration.
+ * The master receives all councillor responses and produces the final synthesis.
+ *
+ * Note: The master runs as a council-master agent session with zero
+ * permissions (deny all). Synthesis is a text-in/text-out operation —
+ * no tools or MCPs are needed.
+ */
+export declare const CouncilMasterConfigSchema: z.ZodObject<{
+    model: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CouncilMasterConfig = z.infer<typeof CouncilMasterConfigSchema>;
+/**
+ * Top-level council configuration.
+ *
+ * Example JSONC:
+ * ```jsonc
+ * {
+ *   "council": {
+ *     "master": { "model": "anthropic/claude-opus-4-6" },
+ *     "presets": {
+ *       "default": {
+ *         "alpha": { "model": "openai/gpt-5.4-mini" },
+ *         "beta":  { "model": "openai/gpt-5.3-codex" },
+ *         "gamma": { "model": "google/gemini-3-pro" }
+ *       }
+ *     },
+ *     "master_timeout": 300000,
+ *     "councillors_timeout": 180000
+ *   }
+ * }
+ * ```
+ */
+export declare const CouncilConfigSchema: z.ZodObject<{
+    master: z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    presets: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodTransform<{
+        councillors: Record<string, {
+            model: string;
+            variant?: string | undefined;
+            prompt?: string | undefined;
+        }>;
+        master: {
+            model?: string | undefined;
+            variant?: string | undefined;
+            prompt?: string | undefined;
+        } | undefined;
+    }, Record<string, Record<string, unknown>>>>>;
+    master_timeout: z.ZodDefault<z.ZodNumber>;
+    councillors_timeout: z.ZodDefault<z.ZodNumber>;
+    default_preset: z.ZodDefault<z.ZodString>;
+    master_fallback: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
+}, z.core.$strip>;
+export type CouncilConfig = z.infer<typeof CouncilConfigSchema>;
+/**
+ * A sensible default council configuration that users can copy into their
+ * opencode.jsonc. Provides a 3-councillor preset using common models.
+ *
+ * Users should replace models with ones they have access to.
+ *
+ * ```jsonc
+ * "council": DEFAULT_COUNCIL_CONFIG
+ * ```
+ */
+export declare const DEFAULT_COUNCIL_CONFIG: z.input<typeof CouncilConfigSchema>;
+/**
+ * Result of a council session.
+ */
+export interface CouncilResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+    councillorResults: Array<{
+        name: string;
+        model: string;
+        status: 'completed' | 'failed' | 'timed_out';
+        result?: string;
+        error?: string;
+    }>;
+}

package/dist/config/index.d.ts

@@ -1,4 +1,5 @@
 export * from './constants';
+export * from './council-schema';
 export { loadAgentPrompt, loadPluginConfig } from './loader';
 export * from './schema';
 export { getAgentOverride } from './utils';

package/dist/config/schema.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 declare const FALLBACK_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
 declare const MANUAL_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer"];
+export declare const ProviderModelIdSchema: z.ZodString;
 export declare const ManualAgentPlanSchema: z.ZodObject<{
     primary: z.ZodString;
     fallback1: z.ZodString;
@@ -215,6 +216,29 @@ export declare const PluginConfigSchema: z.ZodObject<{
             fixer: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
     }, z.core.$strip>>;
+    council: z.ZodOptional<z.ZodObject<{
+        master: z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        presets: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodTransform<{
+            councillors: Record<string, {
+                model: string;
+                variant?: string | undefined;
+                prompt?: string | undefined;
+            }>;
+            master: {
+                model?: string | undefined;
+                variant?: string | undefined;
+                prompt?: string | undefined;
+            } | undefined;
+        }, Record<string, Record<string, unknown>>>>>;
+        master_timeout: z.ZodDefault<z.ZodNumber>;
+        councillors_timeout: z.ZodDefault<z.ZodNumber>;
+        default_preset: z.ZodDefault<z.ZodString>;
+        master_fallback: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
 export type { AgentName } from './constants';

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

@@ -0,0 +1,40 @@
+/**
+ * Council Manager
+ *
+ * Orchestrates multi-LLM council sessions: launches councillors in
+ * parallel, collects results, then runs the council master for synthesis.
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { SubagentDepthTracker } from '../background/subagent-depth';
+import type { PluginConfig } from '../config';
+import type { CouncilResult } from '../config/council-schema';
+export declare class CouncilManager {
+    private client;
+    private directory;
+    private config?;
+    private depthTracker?;
+    private tmuxEnabled;
+    constructor(ctx: PluginInput, config?: PluginConfig, depthTracker?: SubagentDepthTracker, tmuxEnabled?: boolean);
+    /**
+     * Run a full council session.
+     *
+     * 1. Look up the preset
+     * 2. Launch all councillors in parallel
+     * 3. Collect results (respecting timeout)
+     * 4. Run master synthesis
+     * 5. Return combined result
+     */
+    runCouncil(prompt: string, presetName: string | undefined, parentSessionId: string): Promise<CouncilResult>;
+    /**
+     * Inject a start notification into the parent session so the user
+     * sees immediate feedback while councillors are spinning up.
+     */
+    private sendStartNotification;
+    /**
+     * Run a single agent session: create → register → prompt → extract → cleanup.
+     * Both councillors and the master follow this identical lifecycle.
+     */
+    private runAgentSession;
+    private runCouncillors;
+    private runMaster;
+}

package/dist/council/index.d.ts

@@ -0,0 +1 @@
+export { CouncilManager } from './council-manager';

package/dist/hooks/index.d.ts

@@ -2,7 +2,7 @@ export type { AutoUpdateCheckerOptions } from './auto-update-checker';
 export { createAutoUpdateCheckerHook } from './auto-update-checker';
 export { createChatHeadersHook } from './chat-headers';
 export { createDelegateTaskRetryHook } from './delegate-task-retry';
-export { ForegroundFallbackManager, isRateLimitError } from './foreground-fallback';
+export { ForegroundFallbackManager, isRateLimitError, } from './foreground-fallback';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
 export { createPhaseReminderHook } from './phase-reminder';
-export { createPostReadNudgeHook } from './post-read-nudge';
+export { createPostFileToolNudgeHook } from './post-file-tool-nudge';