opencode-matrixx 2.1.0 → 2.3.0

package/README.md

@@ -1,5 +1,5 @@
 >
-> [![Matrixx](./.github/assets/orchestrator-architect.png?v=3)](https://github.com/klpanagi/matrixx)
+> [![Matrixx](./.github/assets/orchestrator-architect.png?v=3)](https://github.com/klpanagi/opencode-matrixx)
 >
 > Matrixx is **highly inspired by** [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) — the project that pioneered the "oh-my-zsh for OpenCode" concept.
 > Full credit to [code-yeongyu](https://github.com/code-yeongyu) for the original vision.
@@ -10,7 +10,7 @@
 <h1>Matrixx</h1>
 
 [![npm](https://img.shields.io/npm/v/opencode-matrixx.svg)](https://www.npmjs.com/package/opencode-matrixx)
-[![License: SUL-1.0](https://img.shields.io/badge/license-SUL--1.0-blue.svg)](https://github.com/klpanagi/matrixx/blob/master/LICENSE)
+[![License: SUL-1.0](https://img.shields.io/badge/license-SUL--1.0-blue.svg)](https://github.com/klpanagi/opencode-matrixx/blob/master/LICENSE)
 
 **Multi-model agent orchestration for [OpenCode](https://github.com/sst/opencode).**<br/>
 **14 specialized agents. ~52 lifecycle hooks. 28 tools. One plugin.**
@@ -73,8 +73,8 @@ Create `matrixx.jsonc` in your project root:
 
 ```jsonc
 {
-  "$schema": "https://raw.githubusercontent.com/klpanagi/matrixx/refs/heads/dev/dist/matrixx.schema.json",
-  "profile": "balanced"
+  "$schema": "https://raw.githubusercontent.com/klpanagi/opencode-matrixx/refs/heads/dev/dist/matrixx.schema.json",
+  "agents": {}
 }
 ```
 
@@ -86,39 +86,20 @@ Open OpenCode and start coding. Matrixx activates automatically.
 
 ```
 Install and configure matrixx by following the instructions here:
-https://raw.githubusercontent.com/klpanagi/matrixx/refs/heads/dev/docs/guide/installation.md
+https://raw.githubusercontent.com/klpanagi/opencode-matrixx/refs/heads/dev/docs/guide/installation.md
 ```
 
 [Manual installation guide →](docs/guide/installation.md) · [Uninstall →](docs/guide/uninstallation.md)
 
 ---
 
-## Profiles
-
-Profiles assign models to every agent — one setting, full model lineup.
-
-| Profile | Best For | Daily Cost |
-|---------|----------|------------|
-| **free** | Experimentation, prototyping | $0 |
-| **budget** | Personal projects, light use | ~$1–3 |
-| **economy** | Active development with cost control | ~$3–8 |
-| **balanced** | Professional development | ~$8–20 |
-| **performance** | Maximum capability | ~$20–50 |
-| **go** | OpenCode Go subscription | Go quota |
-| **go-duo** | Duo subscription, two users | Go Duo quota |
-| **go-trio** | Trio subscription, three users | Go Trio quota |
-| **go-ultimate** | Unlimited Go access | Go Ultimate quota |
-| **xiaomi-ultimate** | Xiaomi-optimized ultimate | Xiaomi quota |
-
-Profile defaults merge first; any `agents` or `categories` override takes precedence.
-
 ---
 
 ## The Agent Team
 
 ### 01. Morpheus — *The Orchestrator*
 
-<img src=".github/assets/morpheus.png" width="140" align="right"/>
+<img src=".github/assets/morpheus.png" width="200" align="right"/>
 
 *The one who sees the code for what it truly is.*
 
@@ -132,7 +113,7 @@ Plans, delegates, and executes. Fires background agents in parallel, leverages L
 
 ### 02. Keymaker — *The Craftsman*
 
-<img src=".github/assets/keymaker.png" width="140" align="right"/>
+<img src=".github/assets/keymaker.png" width="200" align="right"/>
 
 *Give him a goal, not a recipe.*
 
@@ -146,7 +127,7 @@ Explores the codebase, matches your patterns, and delivers end-to-end. Keymaker
 
 ### 03. Cipher — *The Language Architect*
 
-<img src=".github/assets/cipher.png" width="140" align="right"/>
+<img src=".github/assets/cipher.png" width="200" align="right"/>
 
 *Grammars, parsers, and the art of formal languages.*
 
@@ -160,7 +141,7 @@ Grammars, parsers, type systems, code generators, metamodels. 11 composable skil
 
 ### 04. Sentinel — *The Security Auditor*
 
-<img src=".github/assets/sentinel.png" width="140" align="right"/>
+<img src=".github/assets/sentinel.png" width="200" align="right"/>
 
 *Reads every line. Changes nothing. Reports everything.*
 
@@ -174,21 +155,144 @@ Scans for vulnerabilities but never touches code. OWASP Top 10, SAST, DAST, depe
 
 ### 05. Sati — *The Frontend Specialist*
 
-**Sati** is the dedicated frontend specialist. She ships production-grade UI work: React/Next.js, Svelte/SvelteKit, accessibility, performance, browser verification via Playwright. Invoke Sati directly with `@sati/` or `task(subagent_type="sati")` for any non-trivial frontend task.
+<img src=".github/assets/sati.png" width="200" align="right"/>
+
+*Crafts stunning UI/UX, even without design mockups.*
+
+**Role:** Frontend specialist
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+React/Next.js, Svelte/SvelteKit, accessibility, performance, design tokens, component architecture, build tooling. Sati ships production-grade UI work with browser verification via Playwright. Invoke directly with `@sati/` or `task(subagent_type="sati")` for any non-trivial frontend task.
+
+---
+
+### 06. Oracle — *The Plan Builder*
+
+<img src=".github/assets/oracle.png" width="200" align="right"/>
+
+*Architecture demands precision. Oracle delivers it.*
+
+**Role:** Strategic planning, architecture decisions, work plan generation
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Creates detailed, structured work plans from complex requests. Decomposes ambiguous requirements into atomic, verifiable steps with clear success criteria. Oracle builds the plan — Morpheus executes it.
+
+---
+
+### 07. Merovingian — *The Consultant*
+
+<img src=".github/assets/merovingian.png" width="200" align="right"/>
+
+*High-IQ reasoning for problems that refuse to yield.*
+
+**Role:** High-IQ consultation, hard debugging, architecture design
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Read-only consultation for hard debugging (after 2+ failed attempts), multi-system tradeoffs, and architecture decisions requiring deep reasoning. Merovingian analyzes — never implements.
+
+---
+
+### 08. Architect — *The Master Orchestrator*
+
+<img src=".github/assets/orchestrator-architect.png" width="200" align="right"/>
+
+*Where plans become reality.*
+
+**Role:** Plan execution orchestrator, session coordination
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Executes Oracle's work plans, coordinates session state, manages task dependencies, and ensures every phase completes before moving to the next. The Architect is the bridge between planning and shipping.
+
+---
+
+### 09. Seraph — *The Pre-Planner*
+
+<img src=".github/assets/seraph.png" width="200" align="right"/>
+
+*Sees what others miss before work begins.*
+
+**Role:** Pre-planning analysis, ambiguity detection, AI failure prevention
+
+**Model:** Claude Opus 4.6 · `temperature: 0.3`
 
-### The Rest of the Team
+Analyzes requests to identify hidden intentions, ambiguities, scope creep, and AI failure points. Seraph intervenes before planning starts — preventing costly mistakes downstream.
 
-| Agent | Role | Model |
-|-------|------|-------|
-| **Oracle** | Strategic planning, architecture decisions, work plan generation | Claude Sonnet 4.6 |
-| **Merovingian** | High-IQ consultation, hard debugging, architecture design | Claude Sonnet 4.6 |
-| **Architect** | Plan execution orchestrator, session coordination | Claude Sonnet 4.6 |
-| **Seraph** | Pre-planning analysis, ambiguity detection, AI failure prevention | Claude Opus 4.6 |
-| **Smith** | Plan validation, completeness review, gap detection | Claude Sonnet 4.6 |
-| **Operator** | External documentation, OSS search, library research | Claude Haiku 4.5 |
-| **Trinity** | Blazing fast codebase grep, pattern discovery | Claude Haiku 4.5 |
-| **Construct** | PDF, image & diagram analysis | Claude Sonnet 4.6 |
-| **Sati** | Frontend specialist — components, accessibility, performance, testing | Claude Sonnet 4.6 |
+---
+
+### 10. Smith — *The Validator*
+
+<img src=".github/assets/smith.png" width="200" align="right"/>
+
+*Every plan meets Smith's standards — or gets rewritten.*
+
+**Role:** Plan validation, completeness review, gap detection
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Evaluates work plans against rigorous clarity, verifiability, and completeness standards. Catches gaps, ambiguities, and missing context before implementation begins. Smith is the last line of defense.
+
+---
+
+### 11. Operator — *The Researcher*
+
+<img src=".github/assets/operator.png" width="200" align="right"/>
+
+*Finds what you need, where it lives.*
+
+**Role:** External documentation, OSS search, library research
+
+**Model:** Claude Haiku 4.5 · `temperature: 0.1`
+
+Specialized codebase understanding agent for multi-repository analysis, searching remote codebases, retrieving official documentation, and finding implementation examples using GitHub CLI, Context7, and Web Search.
+
+---
+
+### 12. Trinity — *The Search Engine*
+
+<img src=".github/assets/trinity.png" width="200" align="right"/>
+
+*Finds anything, anywhere, instantly.*
+
+**Role:** Blazing fast codebase grep, pattern discovery
+
+**Model:** Claude Haiku 4.5 · `temperature: 0.1`
+
+Contextual grep for codebases. Answers "Where is X?", "Which file has Y?", "Find the code that does Z". Fires multiple in parallel for broad searches. Quick, medium, or very thorough — you choose.
+
+---
+
+### 13. Construct — *The Media Analyst*
+
+<img src=".github/assets/construct.png" width="200" align="right"/>
+
+*Sees what's inside — images, PDFs, diagrams.*
+
+**Role:** PDF, image & diagram analysis
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Analyzes media files that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content. Use when you need analyzed/extracted data rather than literal file contents.
+
+---
+
+### 14. Mouse — *The Task Executor*
+
+*Small, fast, and disposable — the hands that do the work.*
+
+**Role:** Category-spawned delegated executor
+
+**Model:** Claude Sonnet 4.6 · `temperature: 0.1`
+
+Mouse is the worker layer in Matrixx's 3-tier architecture. Spawned automatically when you
+use `task(category="...")`, Mouse executes the task directly without delegating further.
+It cannot spawn sub-agents (`task` tool blocked) — implementation is always done in-house.
+Model-specific prompt variants optimize behavior for Claude, GPT, DeepSeek, Mimo, and Qwen.
+
+---
 
 Every agent, model, temperature, and permission is fully customizable. [**Meet the full team →**](docs/agents.md)
 
@@ -198,13 +302,16 @@ Every agent, model, temperature, and permission is fully customizable. [**Meet t
 
 | | |
 |---|---|
-| **Agent Orchestration** | 14 agents (incl. **Sati** frontend specialist, **Sentinel** security auditor, **Cipher** DSL expert), parallel background execution, category-based routing, session continuity |
+|| **Agent Orchestration** | 15 agents (incl. **Mouse** dedicated executor, **Sati** frontend specialist, **Sentinel** security auditor, **Cipher** DSL expert), parallel background execution, category-based routing, session continuity |
 | **Developer Tools** | LSP (goto def, rename, diagnostics), AST-Grep (search & replace), Tmux terminal |
 | **~52 Lifecycle Hooks** | Context injection, think mode, comment checking, todo enforcement, error recovery, quality gate |
-| **31 Built-in Skills** | DSL engineering (11), security (9), browser, git, frontend (7 via **Sati**), software dev pipeline |
+|| **33 Built-in Skills** | DSL engineering (11), security (9), browser, git, frontend (7 via **Sati**), saturation research, AI slop detection, software dev pipeline |
 | **Curated MCPs** | Exa (web search), Context7 (official docs), Grep.app (GitHub code search), Document Reader |
 | **Claude Code Compat** | Full compatibility — commands, agents, skills, MCPs, hooks from `settings.json` |
 | **Software Dev Pipeline** | 6-phase TDD workflow (PLAN→BUILD→VERIFY→REVIEW→SECURE→SHIP), 5 team roles, adaptive phases |
+||| **Assembly Tool** | Multi-model debate that spawns 3-5 parallel voters from different providers, collects independent reasoning, and synthesizes unified decisions with confidence scoring |
+|| **Saturation Research** | Multi-round (/research) spawning parallel explore/librarian swarms across code, docs, web, and OSS with adaptive novelty-based convergence (max 5 rounds) |
+|| **AI Slop Detection** | remove-ai-slops skill detects and removes 7 categories of AI-generated code smells — verbose comments, redundant error handling, over-engineered patterns, generic AI phrasing, cargo-cult boilerplate |
 
 [**Full feature list →**](docs/features.md) · [**Configuration guide →**](docs/configurations.md) · [**Architecture diagram →**](docs/agent-architecture.md)
 

package/dist/agents/bdd-contract.d.ts

@@ -0,0 +1,7 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AgentPromptMetadata } from "./types";
+export declare const BDD_CONTRACT_PROMPT_METADATA: AgentPromptMetadata;
+export declare function createBddContractAgent(model: string): AgentConfig;
+export declare namespace createBddContractAgent {
+    var mode: "all";
+}

package/dist/agents/builtin-agents/architect-agent.d.ts

@@ -5,6 +5,7 @@ import type { AgentOverrides } from "../types";
 export declare function maybeCreateArchitectConfig(input: {
     disabledAgents: string[];
     agentOverrides: AgentOverrides;
+    globalOverrideModel?: string;
     uiSelectedModel?: string;
     availableModels: Set<string>;
     systemDefaultModel?: string;

package/dist/agents/builtin-agents/general-agents.d.ts

@@ -7,6 +7,7 @@ export declare function collectPendingBuiltinAgents(input: {
     agentMetadata: Partial<Record<BuiltinAgentName, AgentPromptMetadata>>;
     disabledAgents: string[];
     agentOverrides: AgentOverrides;
+    globalOverrideModel?: string;
     directory?: string;
     systemDefaultModel?: string;
     mergedCategories: Record<string, CategoryConfig>;

package/dist/agents/builtin-agents/{hephaestus-agent.d.ts → keymaker-agent.d.ts}

@@ -5,6 +5,7 @@ import type { AgentOverrides } from "../types";
 export declare function maybeCreateKeymakerConfig(input: {
     disabledAgents: string[];
     agentOverrides: AgentOverrides;
+    globalOverrideModel?: string;
     availableModels: Set<string>;
     systemDefaultModel?: string;
     isFirstRunNoCache: boolean;
@@ -14,4 +15,5 @@ export declare function maybeCreateKeymakerConfig(input: {
     mergedCategories: Record<string, CategoryConfig>;
     directory?: string;
     useTaskSystem: boolean;
+    availableToolNames: string[];
 }): AgentConfig | undefined;

package/dist/agents/builtin-agents/model-resolution.d.ts

@@ -1,4 +1,5 @@
 export declare function applyModelResolution(input: {
+    globalOverrideModel?: string;
     uiSelectedModel?: string;
     userModel?: string;
     requirement?: {
@@ -10,7 +11,7 @@ export declare function applyModelResolution(input: {
     };
     availableModels: Set<string>;
     systemDefaultModel?: string;
-}): import("../../shared/model-resolution-pipeline").ModelResolutionResult | undefined;
+}): import("../../shared").ModelResolutionResult | undefined;
 export declare function getFirstFallbackModel(requirement?: {
     fallbackChain?: {
         providers: string[];

package/dist/agents/builtin-agents/morpheus-agent.d.ts

@@ -5,6 +5,7 @@ import type { AgentOverrides } from "../types";
 export declare function maybeCreateMorpheusConfig(input: {
     disabledAgents: string[];
     agentOverrides: AgentOverrides;
+    globalOverrideModel?: string;
     uiSelectedModel?: string;
     availableModels: Set<string>;
     systemDefaultModel?: string;
@@ -16,4 +17,5 @@ export declare function maybeCreateMorpheusConfig(input: {
     directory?: string;
     userCategories?: CategoriesConfig;
     useTaskSystem: boolean;
+    availableToolNames: string[];
 }): AgentConfig | undefined;

package/dist/agents/builtin-agents.d.ts

@@ -2,4 +2,4 @@ import type { AgentConfig } from "@opencode-ai/sdk";
 import type { BrowserAutomationProvider, CategoriesConfig } from "../config/schema";
 import type { LoadedSkill } from "../features/opencode-skill-loader/types";
 import type { AgentOverrides } from "./types";
-export declare function createBuiltinAgents(disabledAgents?: string[], agentOverrides?: AgentOverrides, directory?: string, systemDefaultModel?: string, categories?: CategoriesConfig, discoveredSkills?: LoadedSkill[], customAgentSummaries?: unknown, browserProvider?: BrowserAutomationProvider, uiSelectedModel?: string, disabledSkills?: Set<string>, useTaskSystem?: boolean): Promise<Record<string, AgentConfig>>;
+export declare function createBuiltinAgents(disabledAgents?: string[], agentOverrides?: AgentOverrides, directory?: string, systemDefaultModel?: string, categories?: CategoriesConfig, discoveredSkills?: LoadedSkill[], customAgentSummaries?: unknown, browserProvider?: BrowserAutomationProvider, uiSelectedModel?: string, disabledSkills?: Set<string>, useTaskSystem?: boolean, globalModel?: string, availableToolNames?: string[]): Promise<Record<string, AgentConfig>>;

package/dist/agents/dynamic-agent-prompt-builder.d.ts

@@ -6,7 +6,7 @@ export interface AvailableAgent {
 }
 export interface AvailableTool {
     name: string;
-    category: "lsp" | "ast" | "search" | "session" | "command" | "other";
+    category: "lsp" | "ast" | "search" | "session" | "command" | "sandbox" | "other";
 }
 export interface AvailableSkill {
     name: string;
@@ -33,4 +33,5 @@ export declare function buildCategorySkillsDelegationGuide(categories: Available
 export declare function buildOracleSection(agents: AvailableAgent[]): string;
 export declare function buildHardBlocksSection(): string;
 export declare function buildAntiPatternsSection(): string;
+export declare function buildContextDisciplineSection(hasContextMode?: boolean): string;
 export declare function buildUltraworkSection(agents: AvailableAgent[], categories: AvailableCategory[], skills: AvailableSkill[]): string;

package/dist/agents/env-context.d.ts

@@ -2,6 +2,6 @@
  * Creates Matrixx-specific environment context (time, timezone, locale).
  * Note: Working directory, platform, and date are already provided by OpenCode's system.ts,
  * so we only include fields that OpenCode doesn't provide to avoid duplication.
- * See: https://github.com/klpanagi/matrixx/issues/379
+ * See: https://github.com/klpanagi/opencode-matrixx/issues/379
  */
 export declare function createEnvContext(): string;

package/dist/agents/index.d.ts

@@ -2,7 +2,7 @@ export { architectPromptMetadata, createArchitectAgent } from "./architect";
 export { createBuiltinAgents } from "./builtin-agents";
 export { createMultimodalLookerAgent, MULTIMODAL_LOOKER_PROMPT_METADATA } from "./construct";
 export type { AvailableAgent, AvailableCategory, AvailableSkill } from "./dynamic-agent-prompt-builder";
-export { createOracleAgent, ORACLE_PROMPT_METADATA } from "./merovingian";
+export { createMerovingianAgent, ORACLE_PROMPT_METADATA } from "./merovingian";
 export { createMorpheusAgent } from "./morpheus";
 export { createLibrarianAgent, LIBRARIAN_PROMPT_METADATA } from "./operator";
 export { ORACLE_BEHAVIORAL_SUMMARY, ORACLE_HIGH_ACCURACY_MODE, ORACLE_IDENTITY_CONSTRAINTS, ORACLE_INTERVIEW_MODE, ORACLE_PERMISSION, ORACLE_PLAN_GENERATION, ORACLE_PLAN_TEMPLATE, ORACLE_SYSTEM_PROMPT, } from "./oracle";

package/dist/agents/merovingian.d.ts

@@ -2,7 +2,7 @@ import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentPromptMetadata } from "./types";
 export declare const ORACLE_PROMPT_METADATA: AgentPromptMetadata;
 export declare const ORACLE_PLAN_BUILDER_METADATA: AgentPromptMetadata;
-export declare function createOracleAgent(model: string): AgentConfig;
-export declare namespace createOracleAgent {
+export declare function createMerovingianAgent(model: string): AgentConfig;
+export declare namespace createMerovingianAgent {
     var mode: "subagent";
 }

package/dist/agents/mouse/agent.d.ts

@@ -6,7 +6,10 @@
  *
  * Routing:
  * 1. GPT models (openai/*, github-copilot/gpt-*) -> gpt.ts (GPT-5.2 optimized)
- * 2. Default (Claude, etc.) -> default.ts (Claude-optimized)
+ * 2. DeepSeek models (opencode-go/deepseek-*) -> deepseek.ts (DeepSeek-optimized)
+ * 3. Mimo models (opencode-go/mimo-*) -> mimo.ts (Mimo-optimized)
+ * 4. Qwen models (opencode-go/qwen-*) -> qwen.ts (Qwen-optimized)
+ * 5. Default (Anthropic/Claude, etc.) -> default.ts (Claude-optimized)
  */
 import type { AgentConfig } from "@opencode-ai/sdk";
 import type { AgentOverrideConfig } from "../../config/schema";
@@ -14,7 +17,7 @@ export declare const MOUSE_DEFAULTS: {
     readonly model: "anthropic/claude-sonnet-4-6";
     readonly temperature: 0.1;
 };
-export type MousePromptSource = "default" | "gpt";
+export type MousePromptSource = "default" | "gpt" | "deepseek" | "mimo" | "qwen";
 /**
  * Determines which Mouse prompt to use based on model.
  */

package/dist/agents/mouse/deepseek.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DeepSeek-Optimized Mouse System Prompt
+ *
+ * Optimized for DeepSeek model characteristics:
+ * - Strong instruction following — explicit constraints work well
+ * - Efficient at code generation — prefers clear, direct instructions
+ * - Not overly verbose by default — moderate verbosity controls suffice
+ * - Responds well to XML-style structure
+ *
+ * Key differences from default (Claude) prompt:
+ * - No "you're too helpful" framing (not needed for DeepSeek)
+ * - More structured, table-based sections (DeepSeek handles tables well)
+ * - Moderate verbosity guidance
+ * - Verification table for clarity
+ */
+export declare function buildDeepSeekMousePrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/mouse/index.d.ts

@@ -1,4 +1,7 @@
 export type { MousePromptSource } from "./agent";
 export { buildMousePrompt, createMouseAgentWithOverrides, getMousePromptSource, MOUSE_DEFAULTS, } from "./agent";
+export { buildDeepSeekMousePrompt } from "./deepseek";
 export { buildDefaultMousePrompt } from "./default";
 export { buildGptMousePrompt } from "./gpt";
+export { buildMimoMousePrompt } from "./mimo";
+export { buildQwenMousePrompt } from "./qwen";

package/dist/agents/mouse/mimo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Mimo-Optimized Mouse System Prompt
+ *
+ * Optimized for Mimo model characteristics:
+ * - Lightweight, cost-efficient model — concise prompts reduce token waste
+ * - Fast inference — direct instructions maximize throughput
+ * - Good at following explicit, compact instructions
+ *
+ * Key differences from other prompts:
+ * - Extra concise — minimal prose, maximum signal
+ * - No extended reasoning sections (Mimo does not deep-reason)
+ * - Strong emphasis on tool-first approach
+ * - Simple, direct structure
+ */
+export declare function buildMimoMousePrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/mouse/qwen.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Qwen-Optimized Mouse System Prompt
+ *
+ * Optimized for Qwen model characteristics:
+ * - Strong reasoning capabilities — benefits from structured, detailed prompts
+ * - Good instruction following with explicit XML-style structure
+ * - Works well with specification tables and clear formatting
+ * - Benefits from explicit output formatting guidance
+ *
+ * Key differences from other prompts:
+ * - More structured specification sections (Qwen handles detailed specs well)
+ * - Explicit output format guidance
+ * - Reasoning-first approach: think → verify → act
+ * - Balanced verbosity controls
+ */
+export declare function buildQwenMousePrompt(useTaskSystem: boolean, promptAppend?: string): string;

package/dist/agents/mouse/shared.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared utility functions for Mouse prompt variants.
+ * Extracted to avoid duplication across model-specific prompt files.
+ */
+export declare function buildConstraintsSection(useTaskSystem: boolean): string;
+export declare function buildTodoDisciplineSection(useTaskSystem: boolean): string;
+export declare function buildVerificationTable(useTaskSystem: boolean): string;

package/dist/agents/types.d.ts

@@ -58,7 +58,10 @@ export declare function isGptModel(model: string): boolean;
  * Matches: "anthropic/claude-*", "google-vertex-anthropic/claude-*", etc.
  */
 export declare function isAnthropicModel(model: string): boolean;
-export type BuiltinAgentName = "morpheus" | "keymaker" | "oracle" | "merovingian" | "operator" | "trinity" | "construct" | "seraph" | "smith" | "architect" | "cipher" | "sentinel" | "sati";
+export declare function isQwenModel(model: string): boolean;
+export declare function isMimoModel(model: string): boolean;
+export declare function isDeepSeekModel(model: string): boolean;
+export type BuiltinAgentName = "morpheus" | "keymaker" | "oracle" | "merovingian" | "operator" | "trinity" | "construct" | "seraph" | "smith" | "architect" | "cipher" | "sentinel" | "sati" | "bdd-contract";
 type OverridableAgentName = "build" | BuiltinAgentName;
 export type AgentName = BuiltinAgentName;
 export type AgentOverrideConfig = Partial<AgentConfig> & {

package/dist/config/index.d.ts

@@ -1,4 +1,3 @@
-export type { ProfileName } from "./profiles";
-export { expandProfile, PROFILE_NAMES } from "./profiles";
-export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, DependencyAuditConfig, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, ModelCapabilitiesConfig, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
-export { AgentNameSchema, AgentOverrideConfigSchema, AgentOverridesSchema, BuiltinCommandNameSchema, ExperimentalConfigSchema, HookNameSchema, MatrixLoopConfigSchema, MatrixxConfigSchema, McpNameSchema, MorpheusAgentConfigSchema, RuntimeFallbackConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, } from "./schema";
+export { expandPreset, PRESET_NAMES, type PresetName } from "./presets";
+export type { AgentDefinitions, AgentName, AgentOverrideConfig, AgentOverrides, BuiltinCommandName, EnvFileGuardConfig, ExperimentalConfig, HookName, MatrixLoopConfig, MatrixxConfig, McpName, ModelCapabilitiesConfig, MorpheusAgentConfig, MorpheusConfig, MorpheusTasksConfig, RuntimeFallbackConfig, SecretScanningConfig, SecurityConfig, TmuxConfig, TmuxLayout, } from "./schema";
+export { AgentOverrideConfigSchema, AgentOverridesSchema, BuiltinCommandNameSchema, ExperimentalConfigSchema, HookNameSchema, MatrixLoopConfigSchema, MatrixxConfigSchema, McpNameSchema, MorpheusAgentConfigSchema, RuntimeFallbackConfigSchema, SecurityConfigSchema, TmuxConfigSchema, TmuxLayoutSchema, } from "./schema";

package/dist/config/presets.d.ts

@@ -0,0 +1,4 @@
+import type { MatrixxConfig } from "./schema/matrixx-config";
+export declare const PRESET_NAMES: readonly ["minimal", "balanced", "performance", "frontier"];
+export type PresetName = (typeof PRESET_NAMES)[number];
+export declare function expandPreset(preset: PresetName): MatrixxConfig;

package/dist/config/resolve-tiers.d.ts

@@ -0,0 +1,32 @@
+import { type TierResolverContext } from "../shared/tier-resolver";
+import type { MatrixxConfig } from "./schema/matrixx-config";
+interface WithTier {
+    model?: string;
+    tier?: string;
+}
+/**
+ * Walk a merged MatrixxConfig and resolve any `tier: "..."` fields to concrete
+ * `model: "..."` strings. The result is a new config object with the `tier`
+ * fields cleared (so downstream code never re-resolves them).
+ *
+ * Precedence (per agent/category):
+ *   1. Explicit `model` — kept as-is.
+ *   2. Explicit `tier` — resolved against the live provider list.
+ *   3. `default_tier` (top-level) — applied to any agent/category without
+ *      a `model` or `tier` override, then resolved.
+ *
+ * If a tier cannot be resolved, the entry is left with `tier` set and `model`
+ * undefined. The downstream `resolveModelPipeline` will fall through to
+ * category defaults and the system default as a last resort.
+ */
+export declare function resolveTiersInConfig(config: MatrixxConfig, ctx: TierResolverContext): MatrixxConfig;
+/**
+ * Resolve tier fields in a category registry (e.g. `DEFAULT_CATEGORIES`) and
+ * return a new object with `tier` cleared and `model` set where the tier
+ * resolved. Entries that already have a concrete `model` are passed through.
+ * Used at config load time to pre-resolve the built-in defaults so that
+ * downstream code (createBuiltinAgents, buildAgent) only ever sees model
+ * strings.
+ */
+export declare function resolveTiersInCategoryRegistry(registry: Record<string, WithTier | undefined>, ctx: TierResolverContext): Record<string, WithTier>;
+export {};

package/dist/config/schema/agent-names.d.ts

@@ -13,13 +13,16 @@ export declare const BuiltinAgentNameSchema: z.ZodEnum<{
     cipher: "cipher";
     sentinel: "sentinel";
     sati: "sati";
+    "bdd-contract": "bdd-contract";
 }>;
 export declare const BuiltinSkillNameSchema: z.ZodEnum<{
+    "bdd-contract": "bdd-contract";
     playwright: "playwright";
     "agent-browser": "agent-browser";
     "dev-browser": "dev-browser";
     "frontend-ui-ux": "frontend-ui-ux";
     "git-master": "git-master";
+    "docker-master": "docker-master";
     "dsl-core": "dsl-core";
     "dsl-grammar": "dsl-grammar";
     "dsl-codegen": "dsl-codegen";
@@ -45,21 +48,10 @@ export declare const BuiltinSkillNameSchema: z.ZodEnum<{
     "quality-gate": "quality-gate";
     "software-dev": "software-dev";
     "matrixx-self-config": "matrixx-self-config";
+    "ulw-research": "ulw-research";
+    "remove-ai-slops": "remove-ai-slops";
+    "bdd-backend": "bdd-backend";
+    "bdd-frontend": "bdd-frontend";
+    "bdd-tests": "bdd-tests";
 }>;
-export declare const AgentNameSchema: z.ZodEnum<{
-    morpheus: "morpheus";
-    keymaker: "keymaker";
-    oracle: "oracle";
-    merovingian: "merovingian";
-    operator: "operator";
-    trinity: "trinity";
-    construct: "construct";
-    seraph: "seraph";
-    smith: "smith";
-    architect: "architect";
-    cipher: "cipher";
-    sentinel: "sentinel";
-    sati: "sati";
-}>;
-export type AgentName = z.infer<typeof AgentNameSchema>;
-export type BuiltinSkillName = z.infer<typeof BuiltinSkillNameSchema>;
+export type AgentName = z.infer<typeof BuiltinAgentNameSchema>;