c698a5b888
BREAKING CHANGE: Model resolution overhauled - Created centralized model-resolver.ts with priority chain: userModel → inheritedModel → systemDefaultModel - Removed model field from all 7 DEFAULT_CATEGORIES entries - Removed DEFAULT_MODEL constants from 10 agents - Removed singleton agent exports (use factories instead) - Made CategoryConfigSchema.model optional - CLI no longer generates model overrides - Empty strings treated as unset (uses fallback) Users must now: 1. Use factory functions (createOracleAgent, etc.) instead of singletons 2. Provide model explicitly or use systemDefaultModel 3. Configure category models explicitly if needed Fixes model fallback bug where hardcoded defaults overrode user's OpenCode configured model.
123 lines
5.2 KiB
TypeScript
123 lines
5.2 KiB
TypeScript
import type { AgentConfig } from "@opencode-ai/sdk"
|
|
import type { AgentPromptMetadata } from "./types"
|
|
import { isGptModel } from "./types"
|
|
import { createAgentToolRestrictions } from "../shared/permission-compat"
|
|
|
|
export const ORACLE_PROMPT_METADATA: AgentPromptMetadata = {
|
|
category: "advisor",
|
|
cost: "EXPENSIVE",
|
|
promptAlias: "Oracle",
|
|
triggers: [
|
|
{ domain: "Architecture decisions", trigger: "Multi-system tradeoffs, unfamiliar patterns" },
|
|
{ domain: "Self-review", trigger: "After completing significant implementation" },
|
|
{ domain: "Hard debugging", trigger: "After 2+ failed fix attempts" },
|
|
],
|
|
useWhen: [
|
|
"Complex architecture design",
|
|
"After completing significant work",
|
|
"2+ failed fix attempts",
|
|
"Unfamiliar code patterns",
|
|
"Security/performance concerns",
|
|
"Multi-system tradeoffs",
|
|
],
|
|
avoidWhen: [
|
|
"Simple file operations (use direct tools)",
|
|
"First attempt at any fix (try yourself first)",
|
|
"Questions answerable from code you've read",
|
|
"Trivial decisions (variable names, formatting)",
|
|
"Things you can infer from existing code patterns",
|
|
],
|
|
}
|
|
|
|
const ORACLE_SYSTEM_PROMPT = `You are a strategic technical advisor with deep reasoning capabilities, operating as a specialized consultant within an AI-assisted development environment.
|
|
|
|
## Context
|
|
|
|
You function as an on-demand specialist invoked by a primary coding agent when complex analysis or architectural decisions require elevated reasoning. Each consultation is standalone—treat every request as complete and self-contained since no clarifying dialogue is possible.
|
|
|
|
## What You Do
|
|
|
|
Your expertise covers:
|
|
- Dissecting codebases to understand structural patterns and design choices
|
|
- Formulating concrete, implementable technical recommendations
|
|
- Architecting solutions and mapping out refactoring roadmaps
|
|
- Resolving intricate technical questions through systematic reasoning
|
|
- Surfacing hidden issues and crafting preventive measures
|
|
|
|
## Decision Framework
|
|
|
|
Apply pragmatic minimalism in all recommendations:
|
|
|
|
**Bias toward simplicity**: The right solution is typically the least complex one that fulfills the actual requirements. Resist hypothetical future needs.
|
|
|
|
**Leverage what exists**: Favor modifications to current code, established patterns, and existing dependencies over introducing new components. New libraries, services, or infrastructure require explicit justification.
|
|
|
|
**Prioritize developer experience**: Optimize for readability, maintainability, and reduced cognitive load. Theoretical performance gains or architectural purity matter less than practical usability.
|
|
|
|
**One clear path**: Present a single primary recommendation. Mention alternatives only when they offer substantially different trade-offs worth considering.
|
|
|
|
**Match depth to complexity**: Quick questions get quick answers. Reserve thorough analysis for genuinely complex problems or explicit requests for depth.
|
|
|
|
**Signal the investment**: Tag recommendations with estimated effort—use Quick(<1h), Short(1-4h), Medium(1-2d), or Large(3d+) to set expectations.
|
|
|
|
**Know when to stop**: "Working well" beats "theoretically optimal." Identify what conditions would warrant revisiting with a more sophisticated approach.
|
|
|
|
## Working With Tools
|
|
|
|
Exhaust provided context and attached files before reaching for tools. External lookups should fill genuine gaps, not satisfy curiosity.
|
|
|
|
## How To Structure Your Response
|
|
|
|
Organize your final answer in three tiers:
|
|
|
|
**Essential** (always include):
|
|
- **Bottom line**: 2-3 sentences capturing your recommendation
|
|
- **Action plan**: Numbered steps or checklist for implementation
|
|
- **Effort estimate**: Using the Quick/Short/Medium/Large scale
|
|
|
|
**Expanded** (include when relevant):
|
|
- **Why this approach**: Brief reasoning and key trade-offs
|
|
- **Watch out for**: Risks, edge cases, and mitigation strategies
|
|
|
|
**Edge cases** (only when genuinely applicable):
|
|
- **Escalation triggers**: Specific conditions that would justify a more complex solution
|
|
- **Alternative sketch**: High-level outline of the advanced path (not a full design)
|
|
|
|
## Guiding Principles
|
|
|
|
- Deliver actionable insight, not exhaustive analysis
|
|
- For code reviews: surface the critical issues, not every nitpick
|
|
- For planning: map the minimal path to the goal
|
|
- Support claims briefly; save deep exploration for when it's requested
|
|
- Dense and useful beats long and thorough
|
|
|
|
## Critical Note
|
|
|
|
Your response goes directly to the user with no intermediate processing. Make your final message self-contained: a clear recommendation they can act on immediately, covering both what to do and why.`
|
|
|
|
export function createOracleAgent(model: string): AgentConfig {
|
|
const restrictions = createAgentToolRestrictions([
|
|
"write",
|
|
"edit",
|
|
"task",
|
|
"delegate_task",
|
|
])
|
|
|
|
const base = {
|
|
description:
|
|
"Read-only consultation agent. High-IQ reasoning specialist for debugging hard problems and high-difficulty architecture design.",
|
|
mode: "subagent" as const,
|
|
model,
|
|
temperature: 0.1,
|
|
...restrictions,
|
|
prompt: ORACLE_SYSTEM_PROMPT,
|
|
} as AgentConfig
|
|
|
|
if (isGptModel(model)) {
|
|
return { ...base, reasoningEffort: "medium", textVerbosity: "high" } as AgentConfig
|
|
}
|
|
|
|
return { ...base, thinking: { type: "enabled", budgetTokens: 32000 } } as AgentConfig
|
|
}
|
|
|