YeonGyu-Kim
80 lines
3.4 KiB
Markdown
80 lines
3.4 KiB
Markdown
# src/agents/ — 11 Agent Definitions
|
|
|
|
**Generated:** 2026-02-21
|
|
|
|
## OVERVIEW
|
|
|
|
Agent factories following `createXXXAgent(model) → AgentConfig` pattern. Each has static `mode` property. Built via `buildAgent()` compositing factory + categories + skills.
|
|
|
|
## AGENT INVENTORY
|
|
|
|
| Agent | Model | Temp | Mode | Fallback Chain | Purpose |
|
|
|-------|-------|------|------|----------------|---------|
|
|
| **Sisyphus** | claude-opus-4-6 | 0.1 | primary | kimi-k2.5 → glm-4.7 → gemini-3-pro | Main orchestrator, plans + delegates |
|
|
| **Hephaestus** | gpt-5.3-codex | 0.1 | primary | NONE (required) | Autonomous deep worker |
|
|
| **Oracle** | gpt-5.2 | 0.1 | subagent | claude-opus-4-6 → gemini-3-pro | Read-only consultation |
|
|
| **Librarian** | glm-4.7 | 0.1 | subagent | big-pickle → claude-sonnet-4-6 | External docs/code search |
|
|
| **Explore** | grok-code-fast-1 | 0.1 | subagent | claude-haiku-4-5 → gpt-5-nano | Contextual grep |
|
|
| **Multimodal-Looker** | gemini-3-flash | 0.1 | subagent | gpt-5.2 → glm-4.6v → ... (6 deep) | PDF/image analysis |
|
|
| **Metis** | claude-opus-4-6 | **0.3** | subagent | kimi-k2.5 → gpt-5.2 → gemini-3-pro | Pre-planning consultant |
|
|
| **Momus** | gpt-5.2 | 0.1 | subagent | claude-opus-4-6 → gemini-3-pro | Plan reviewer |
|
|
| **Atlas** | claude-sonnet-4-6 | 0.1 | primary | kimi-k2.5 → gpt-5.2 → gemini-3-pro | Todo-list orchestrator |
|
|
| **Prometheus** | claude-opus-4-6 | 0.1 | — | kimi-k2.5 → gpt-5.2 → gemini-3-pro | Strategic planner (internal) |
|
|
| **Sisyphus-Junior** | claude-sonnet-4-6 | 0.1 | all | user-configurable | Category-spawned executor |
|
|
|
|
## TOOL RESTRICTIONS
|
|
|
|
| Agent | Denied Tools |
|
|
|-------|-------------|
|
|
| Oracle | write, edit, task, call_omo_agent |
|
|
| Librarian | write, edit, task, call_omo_agent |
|
|
| Explore | write, edit, task, call_omo_agent |
|
|
| Multimodal-Looker | ALL except read |
|
|
| Atlas | task, call_omo_agent |
|
|
| Momus | write, edit, task |
|
|
|
|
## STRUCTURE
|
|
|
|
```
|
|
agents/
|
|
├── sisyphus.ts # 559 LOC, main orchestrator
|
|
├── hephaestus.ts # 507 LOC, autonomous worker
|
|
├── oracle.ts # Read-only consultant
|
|
├── librarian.ts # External search
|
|
├── explore.ts # Codebase grep
|
|
├── multimodal-looker.ts # Vision/PDF
|
|
├── metis.ts # Pre-planning
|
|
├── momus.ts # Plan review
|
|
├── atlas/agent.ts # Todo orchestrator
|
|
├── types.ts # AgentFactory, AgentMode
|
|
├── agent-builder.ts # buildAgent() composition
|
|
├── utils.ts # Agent utilities
|
|
├── builtin-agents.ts # createBuiltinAgents() registry
|
|
└── builtin-agents/ # maybeCreateXXXConfig conditional factories
|
|
├── sisyphus-agent.ts
|
|
├── hephaestus-agent.ts
|
|
├── atlas-agent.ts
|
|
├── general-agents.ts # collectPendingBuiltinAgents
|
|
└── available-skills.ts
|
|
```
|
|
|
|
## FACTORY PATTERN
|
|
|
|
```typescript
|
|
const createXXXAgent: AgentFactory = (model: string) => ({
|
|
instructions: "...",
|
|
model,
|
|
temperature: 0.1,
|
|
// ...config
|
|
})
|
|
createXXXAgent.mode = "subagent" // or "primary" or "all"
|
|
```
|
|
|
|
Model resolution: `AGENT_MODEL_REQUIREMENTS` in `shared/model-requirements.ts` defines fallback chains per agent.
|
|
|
|
## MODES
|
|
|
|
- **primary**: Respects UI-selected model, uses fallback chain
|
|
- **subagent**: Uses own fallback chain, ignores UI selection
|
|
- **all**: Available in both contexts (Sisyphus-Junior)
|