opencode-dux 1.0.0

package/dist/cli/install.d.ts

@@ -0,0 +1,2 @@
+import type { InstallArgs } from './types';
+export declare function install(args: InstallArgs): Promise<number>;

package/dist/cli/mcps.d.ts

@@ -0,0 +1,13 @@
+import type { SkillOrMcpConfig } from '../config';
+import { type NormalizedSkillConfig, normalizeSkillConfig } from './skills';
+export type { NormalizedSkillConfig as NormalizedMcpConfig };
+export { normalizeSkillConfig as normalizeMcpConfig };
+/**
+ * Get MCP permissions for a specific agent.
+ * MCP permission rules use 'allow'/'deny' per MCP name.
+ *
+ * @param agentName - The agent name
+ * @param mcpList - Optional MCP config (object or array syntax)
+ * @returns Permission rules keyed by MCP name
+ */
+export declare function getMcpPermissionsForAgent(_agentName: string, mcpList?: SkillOrMcpConfig): Promise<Record<string, 'allow' | 'ask' | 'deny'>>;

package/dist/cli/model-key-normalization.d.ts

@@ -0,0 +1 @@
+export declare function buildModelKeyAliases(input: string): string[];

package/dist/cli/paths.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Get the OpenCode plugin config directory.
+ *
+ * Resolution order:
+ * 1. OPENCODE_CONFIG_DIR (custom OpenCode directory)
+ * 2. XDG_CONFIG_HOME/opencode
+ * 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;
+export declare function getLiteConfig(): string;
+export declare function getLiteConfigJsonc(): string;
+export declare function getTuiConfig(): string;
+export declare function getTuiConfigJsonc(): string;
+export declare function getExistingLiteConfigPath(): string;
+export declare function getExistingTuiConfigPath(): string;
+export declare function getExistingConfigPath(): string;
+export declare function ensureConfigDir(): void;
+export declare function ensureTuiConfigDir(): void;
+/**
+ * Ensure the directory for OpenCode's main config file exists.
+ */
+export declare function ensureOpenCodeConfigDir(): void;

package/dist/cli/providers.d.ts

@@ -0,0 +1,137 @@
+import type { InstallConfig } from './types';
+export declare const GENERATED_PRESETS: readonly ["openai", "opencode-go"];
+export declare const MODEL_MAPPINGS: {
+    readonly openai: {
+        readonly orchestrator: {
+            readonly model: "openai/gpt-5.5";
+        };
+        readonly oracle: {
+            readonly model: "openai/gpt-5.5";
+            readonly variant: "high";
+        };
+        readonly librarian: {
+            readonly model: "openai/gpt-5.4-mini";
+            readonly variant: "low";
+        };
+        readonly explorer: {
+            readonly model: "openai/gpt-5.4-mini";
+            readonly variant: "low";
+        };
+        readonly designer: {
+            readonly model: "openai/gpt-5.4-mini";
+            readonly variant: "medium";
+        };
+        readonly fixer: {
+            readonly model: "openai/gpt-5.4-mini";
+            readonly variant: "low";
+        };
+    };
+    readonly kimi: {
+        readonly orchestrator: {
+            readonly model: "kimi-for-coding/k2p5";
+        };
+        readonly oracle: {
+            readonly model: "kimi-for-coding/k2p5";
+            readonly variant: "high";
+        };
+        readonly librarian: {
+            readonly model: "kimi-for-coding/k2p5";
+            readonly variant: "low";
+        };
+        readonly explorer: {
+            readonly model: "kimi-for-coding/k2p5";
+            readonly variant: "low";
+        };
+        readonly designer: {
+            readonly model: "kimi-for-coding/k2p5";
+            readonly variant: "medium";
+        };
+        readonly fixer: {
+            readonly model: "kimi-for-coding/k2p5";
+            readonly variant: "low";
+        };
+    };
+    readonly copilot: {
+        readonly orchestrator: {
+            readonly model: "github-copilot/claude-opus-4.6";
+        };
+        readonly oracle: {
+            readonly model: "github-copilot/claude-opus-4.6";
+            readonly variant: "high";
+        };
+        readonly librarian: {
+            readonly model: "github-copilot/grok-code-fast-1";
+            readonly variant: "low";
+        };
+        readonly explorer: {
+            readonly model: "github-copilot/grok-code-fast-1";
+            readonly variant: "low";
+        };
+        readonly designer: {
+            readonly model: "github-copilot/gemini-3.1-pro-preview";
+            readonly variant: "medium";
+        };
+        readonly fixer: {
+            readonly model: "github-copilot/claude-sonnet-4.6";
+            readonly variant: "low";
+        };
+    };
+    readonly 'zai-plan': {
+        readonly orchestrator: {
+            readonly model: "zai-coding-plan/glm-5";
+        };
+        readonly oracle: {
+            readonly model: "zai-coding-plan/glm-5";
+            readonly variant: "high";
+        };
+        readonly librarian: {
+            readonly model: "zai-coding-plan/glm-5";
+            readonly variant: "low";
+        };
+        readonly explorer: {
+            readonly model: "zai-coding-plan/glm-5";
+            readonly variant: "low";
+        };
+        readonly designer: {
+            readonly model: "zai-coding-plan/glm-5";
+            readonly variant: "medium";
+        };
+        readonly fixer: {
+            readonly model: "zai-coding-plan/glm-5";
+            readonly variant: "low";
+        };
+    };
+    readonly 'opencode-go': {
+        readonly orchestrator: {
+            readonly model: "neuralwatt/zai-org/GLM-5.1-FP8";
+            readonly variant: "medium";
+        };
+        readonly oracle: {
+            readonly model: "opencode-go/deepseek-v4-flash";
+            readonly variant: "medium";
+        };
+        readonly librarian: {
+            readonly model: "opencode-go/deepseek-v4-flash";
+            readonly variant: "low";
+        };
+        readonly explorer: {
+            readonly model: "neuralwatt/qwen3.5-397b-fast";
+            readonly variant: "low";
+        };
+        readonly designer: {
+            readonly model: "opencode-go/mimo-v2.5-pro";
+            readonly variant: "medium";
+        };
+        readonly fixer: {
+            readonly model: "opencode-go/deepseek-v4-flash";
+            readonly variant: "low";
+        };
+    };
+};
+export type PresetName = keyof typeof MODEL_MAPPINGS;
+export type GeneratedPresetName = (typeof GENERATED_PRESETS)[number];
+export declare function isPresetName(value: string): value is PresetName;
+export declare function getPresetNames(): PresetName[];
+export declare function isGeneratedPresetName(value: string): value is GeneratedPresetName;
+export declare function getGeneratedPresetNames(): GeneratedPresetName[];
+export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;

package/dist/cli/skills.d.ts

@@ -0,0 +1,22 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { SkillOrMcpConfig } from '../config';
+export interface NormalizedSkillConfig {
+    alwaysLoad: string[];
+    wildcard: boolean;
+    excluded: string[];
+}
+export declare function normalizeSkillConfig(raw: SkillOrMcpConfig | undefined): NormalizedSkillConfig;
+/**
+ * Get permission presets for a specific agent based on recommended skills.
+ * @param agentName - The name of the agent
+ * @param skillList - Optional explicit list of skills to allow (overrides recommendations)
+ * @param ctx - Plugin input context for SDK discovery when wildcard=true
+ * @returns Permission rules for the skill permission type
+ */
+export declare function getSkillPermissionsForAgent(_agentName: string, skillList?: SkillOrMcpConfig, ctx?: PluginInput): Promise<Record<string, 'allow' | 'ask' | 'deny'>>;
+/**
+ * Scan installed skills from the filesystem via SDK discovery.
+ * @param ctx - Plugin input context for SDK discovery
+ * @returns Array of skill names that are installed
+ */
+export declare function scanInstalledSkills(ctx: PluginInput): Promise<string[]>;

package/dist/cli/system.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveOpenCodePath(): string;
+export declare function isOpenCodeInstalled(): Promise<boolean>;
+export declare function getOpenCodeVersion(): Promise<string | null>;
+export declare function getOpenCodePath(): string | null;
+export declare function fetchLatestVersion(packageName: string): Promise<string | null>;

package/dist/cli/types.d.ts

@@ -0,0 +1,38 @@
+export type BooleanArg = 'yes' | 'no';
+export interface InstallArgs {
+    tui: boolean;
+    skills?: BooleanArg;
+    preset?: string;
+    dryRun?: boolean;
+    reset?: boolean;
+}
+export interface OpenCodeConfig {
+    plugin?: unknown[];
+    provider?: Record<string, unknown>;
+    agent?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface InstallConfig {
+    installSkills: boolean;
+    installCustomSkills: boolean;
+    preset?: string;
+    promptForStar?: boolean;
+    dryRun?: boolean;
+    reset: boolean;
+}
+export interface ConfigMergeResult {
+    success: boolean;
+    configPath: string;
+    error?: string;
+}
+export interface DetectedConfig {
+    isInstalled: boolean;
+    hasKimi: boolean;
+    hasOpenAI: boolean;
+    hasAnthropic?: boolean;
+    hasCopilot?: boolean;
+    hasZaiPlan?: boolean;
+    hasAntigravity: boolean;
+    hasChutes?: boolean;
+    hasOpencodeZen: boolean;
+}

package/dist/config/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const AGENT_ALIASES: Record<string, string>;
+export declare const SUBAGENT_NAMES: readonly ["explorer", "librarian", "oracle", "designer", "fixer", "steward", "interpreter"];
+export declare const ORCHESTRATOR_NAME: "orchestrator";
+export declare const ALL_AGENT_NAMES: readonly ["orchestrator", "explorer", "librarian", "oracle", "designer", "fixer", "steward", "interpreter"];
+export type AgentName = (typeof ALL_AGENT_NAMES)[number];
+export declare const DEFAULT_MODELS: Record<AgentName, string | undefined>;
+export declare const POLL_INTERVAL_MS = 500;
+export declare const MAX_POLL_TIME_MS: number;
+export declare const DEFAULT_MAX_SUBAGENT_DEPTH = 10;
+export declare const PHASE_REMINDER_TEXT = "!IMPORTANT! Follow <first_gate> order in system prompt; delegate_subagent in the same turn you name the agent. !END!";
+export declare const STABLE_POLLS_THRESHOLD = 3;
+export declare const SDK_DISCOVERY_TIMEOUT_MS = 10000;

package/dist/config/index.d.ts

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

package/dist/config/loader.d.ts

@@ -0,0 +1,40 @@
+import { type PluginConfig } from './schema';
+/**
+ * Recursively merge two objects, with override values taking precedence.
+ * For nested objects, merges recursively. For arrays and primitives, override replaces base.
+ *
+ * @param base - Base object to merge into
+ * @param override - Override object whose values take precedence
+ * @returns Merged object, or undefined if both inputs are undefined
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base?: T, override?: T): T | undefined;
+/**
+ * Load plugin configuration from user and project config files, merging them appropriately.
+ *
+ * Configuration is loaded from two locations:
+ * 1. User config: $OPENCODE_CONFIG_DIR/opencode-dux.jsonc or .json,
+ *    or ~/.config/opencode/opencode-dux.jsonc or .json (or $XDG_CONFIG_HOME)
+ * 2. Project config: <directory>/.opencode/opencode-dux.jsonc or .json
+ *
+ * JSONC format is preferred over JSON (allows comments and trailing commas).
+ * Project config takes precedence over user config. Nested objects (agents) are
+ * deep-merged, while top-level arrays are replaced entirely by project config.
+ *
+ * @param directory - Project directory to search for .opencode config
+ * @returns Merged plugin configuration (empty object if no configs found)
+ */
+export declare function loadPluginConfig(directory: string): PluginConfig;
+/**
+ * Load custom prompt for an agent from the prompts directory.
+ * Checks for {agent}.md (replaces default) and {agent}_append.md (appends to default).
+ * If preset is provided and safe for paths, it first checks {preset}/ subdirectory,
+ * then falls back to the root prompts directory.
+ *
+ * @param agentName - Name of the agent (e.g., "orchestrator", "explorer")
+ * @param preset - Optional preset name for preset-scoped prompt lookup
+ * @returns Object with prompt and/or appendPrompt if files exist
+ */
+export declare function loadAgentPrompt(agentName: string, preset?: string): {
+    prompt?: string;
+    appendPrompt?: string;
+};

package/dist/config/runtime-preset.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Module-level runtime preset state.
+ *
+ * Survives plugin re-inits triggered by client.config.update() →
+ * Instance.dispose(). The plugin function re-runs but this module-level
+ * variable persists within the same Node.js process.
+ */
+export declare function setActiveRuntimePreset(name: string | null): void;
+export declare function getActiveRuntimePreset(): string | null;
+export declare function getPreviousRuntimePreset(): string | null;
+export declare function setActiveRuntimePresetWithPrevious(name: string | null): void;
+export declare function rollbackRuntimePreset(previous: string | null): void;

package/dist/config/schema.d.ts

@@ -0,0 +1,281 @@
+import { z } from 'zod';
+declare const FALLBACK_AGENT_NAMES: readonly ["orchestrator", "oracle", "designer", "explorer", "librarian", "fixer", "steward", "interpreter"];
+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;
+    fallback2: z.ZodString;
+    fallback3: z.ZodString;
+}, z.core.$strip>;
+export declare const ManualPlanSchema: z.ZodObject<{
+    orchestrator: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+    oracle: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+    designer: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+    explorer: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+    librarian: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+    fixer: z.ZodObject<{
+        primary: z.ZodString;
+        fallback1: z.ZodString;
+        fallback2: z.ZodString;
+        fallback3: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type ManualAgentName = (typeof MANUAL_AGENT_NAMES)[number];
+export type ManualAgentPlan = z.infer<typeof ManualAgentPlanSchema>;
+export type ManualPlan = z.infer<typeof ManualPlanSchema>;
+export type FallbackAgentName = (typeof FALLBACK_AGENT_NAMES)[number];
+declare const SkillOrMcpConfigSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+    'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    wildcard: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>]>;
+export declare const AgentOverrideConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        wildcard: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+    mcps: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        wildcard: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+}, z.core.$strict>;
+export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;
+/** Normalized model entry with optional per-model variant. */
+export type ModelEntry = {
+    id: string;
+    variant?: string;
+};
+export declare const PresetSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>]>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        wildcard: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+    mcps: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        wildcard: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+}, z.core.$strict>>;
+export type Preset = z.infer<typeof PresetSchema>;
+export declare const WebsearchConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        exa: "exa";
+        tavily: "tavily";
+    }>>;
+}, z.core.$strip>;
+export type WebsearchConfig = z.infer<typeof WebsearchConfigSchema>;
+export declare const McpNameSchema: z.ZodEnum<{
+    websearch: "websearch";
+    context7: "context7";
+    grep_app: "grep_app";
+}>;
+export type McpName = z.infer<typeof McpNameSchema>;
+export declare const SessionManagerConfigSchema: z.ZodObject<{
+    maxSessionsPerAgent: z.ZodDefault<z.ZodNumber>;
+    readContextMinLines: z.ZodDefault<z.ZodNumber>;
+    readContextMaxFiles: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type SessionManagerConfig = z.infer<typeof SessionManagerConfigSchema>;
+export declare const TodoContinuationConfigSchema: z.ZodObject<{
+    maxContinuations: z.ZodDefault<z.ZodNumber>;
+    cooldownMs: z.ZodDefault<z.ZodNumber>;
+    autoEnable: z.ZodDefault<z.ZodBoolean>;
+    autoEnableThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type TodoContinuationConfig = z.infer<typeof TodoContinuationConfigSchema>;
+export declare const ContextPressureConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    warnThresholdPct: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ContextPressureConfig = z.infer<typeof ContextPressureConfigSchema>;
+export declare const FailoverConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    retryDelayMs: z.ZodDefault<z.ZodNumber>;
+    chains: z.ZodDefault<z.ZodObject<{
+        orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fixer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        steward: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        interpreter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
+    retry_on_empty: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FailoverConfig = z.infer<typeof FailoverConfigSchema>;
+export declare const PluginConfigSchema: z.ZodObject<{
+    preset: z.ZodOptional<z.ZodString>;
+    setDefaultAgent: z.ZodOptional<z.ZodBoolean>;
+    scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
+        v1: "v1";
+        "v2-shadow": "v2-shadow";
+        v2: "v2";
+    }>>;
+    balanceProviderUsage: z.ZodOptional<z.ZodBoolean>;
+    autoUpdate: z.ZodOptional<z.ZodBoolean>;
+    manualPlan: z.ZodOptional<z.ZodObject<{
+        orchestrator: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+        oracle: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+        designer: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+        explorer: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+        librarian: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+        fixer: z.ZodObject<{
+            primary: z.ZodString;
+            fallback1: z.ZodString;
+            fallback2: z.ZodString;
+            fallback3: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strict>>;
+    presets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        displayName: z.ZodOptional<z.ZodString>;
+        skills: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            wildcard: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        mcps: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            wildcard: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strict>>>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            id: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        displayName: z.ZodOptional<z.ZodString>;
+        skills: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            wildcard: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        mcps: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            'always-load': z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mandatory: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            wildcard: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strict>>>;
+    websearch: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<{
+            exa: "exa";
+            tavily: "tavily";
+        }>>;
+    }, z.core.$strip>>;
+    sessionManager: z.ZodOptional<z.ZodObject<{
+        maxSessionsPerAgent: z.ZodDefault<z.ZodNumber>;
+        readContextMinLines: z.ZodDefault<z.ZodNumber>;
+        readContextMaxFiles: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    todoContinuation: z.ZodOptional<z.ZodObject<{
+        maxContinuations: z.ZodDefault<z.ZodNumber>;
+        cooldownMs: z.ZodDefault<z.ZodNumber>;
+        autoEnable: z.ZodDefault<z.ZodBoolean>;
+        autoEnableThreshold: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    contextPressure: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        warnThresholdPct: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    fallback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        retryDelayMs: z.ZodDefault<z.ZodNumber>;
+        chains: z.ZodDefault<z.ZodObject<{
+            orchestrator: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            oracle: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            designer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            explorer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            librarian: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fixer: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            steward: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            interpreter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$catchall<z.ZodArray<z.ZodString>>>>;
+        retry_on_empty: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+export type { AgentName } from './constants';
+export type SkillOrMcpConfig = z.infer<typeof SkillOrMcpConfigSchema>;

package/dist/config/utils.d.ts

@@ -0,0 +1,10 @@
+import type { AgentOverrideConfig, PluginConfig } from './schema';
+/**
+ * Get agent override config by name, supporting backward-compatible aliases.
+ * Checks both the current name and any legacy alias names.
+ *
+ * @param config - The plugin configuration
+ * @param name - The current agent name
+ * @returns The agent-specific override configuration if found
+ */
+export declare function getAgentOverride(config: PluginConfig | undefined, name: string): AgentOverrideConfig | undefined;