create-merlin-brain 3.8.2 → 3.10.0

package/dist/server/server.js

@@ -20,11 +20,13 @@ import { registerAdaptiveTools } from './tools/adaptive.js';
 import { registerAgentTools } from './tools/agents.js';
 import { registerDiscoveryTools } from './tools/discoveries.js';
 import { registerRouteTools } from './tools/route.js';
+import { registerCostTools } from './tools/cost.js';
 import { registerLiteTools, getOrInitLiteClient, enhanceFromCloud } from './tools/lite.js';
 import { registerConfigSyncTools } from './tools/config-sync.js';
 import { registerSightsIndexTools } from './tools/sights-index.js';
 import { registerAgentsIndexTools } from './tools/agents-index.js';
 import { registerAutoTeachTools, assessContextConfidence, buildTeachBackPrompt } from './tools/auto-teach.js';
+import { registerSmartRouteTools } from './tools/smart-route.js';
 import { wrapResponse, getStats, getCompactStats, formatSaveNotification, markSessionStatusShown } from './stats.js';
 import { coachWrap, recordToolCall } from './session-coach.js';
 /** Load saved config from ~/.merlin/config.json */
@@ -272,8 +274,9 @@ export function createServer() {
     // ============================================================
     // TOOLS
     // ============================================================
+    // ── CORE tool: always loaded, used at every session start ──────────────
     // Tool: merlin_get_brief
-    server.tool('merlin_get_brief', 'Get structured project brief for session start. Returns ~500 token summary: product, architecture, status, APIs. Call this after selecting a repo to understand the full picture.', {
+    server.tool('merlin_get_brief', 'Get structured project brief at session start. Returns ~500-token summary covering product purpose, tech stack, architecture, active tasks, shipped APIs, and coding rules. Call after selecting a repo to orient yourself before coding, planning, or reviewing.', {
         repoUrl: z.string().optional().describe('GitHub URL of the repository (uses selected repo if omitted)'),
     }, async ({ repoUrl }) => {
         try {
@@ -402,8 +405,9 @@ export function createServer() {
             };
         }
     });
+    // ── CORE tool: MANDATORY before every file edit or code modification ────
     // Tool: merlin_get_context
-    server.tool('merlin_get_context', `MANDATORY before ANY file edit or creation. Call this BEFORE every code change — not just once per session, but before EACH file you modify. Returns codebase context, existing patterns, and related files in ~2 seconds. Without this, you WILL duplicate existing code or break established patterns. Re-call every few minutes even for the same task — the codebase changes.`, {
+    server.tool('merlin_get_context', `MANDATORY before every file edit, code modification, or feature implementation. Call before EACH file you modify — not just once per session. Returns codebase conventions, relevant file locations, how-to guide, anti-patterns, and auto-apply behavior patterns for the given task. Without this, you WILL duplicate existing code or break established patterns. Re-call every few minutes — the codebase changes. Works in both cloud (Sights) and local Lite mode.`, {
         task: z.string().describe('What you want to know or do (e.g., "how does profile creation work", "add authentication", "where is the payment logic")'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ task, repoUrl }) => {
@@ -614,8 +618,9 @@ export function createServer() {
             };
         }
     });
+    // ── CORE tool: always loaded, used before reading or modifying any file ─
     // Tool: merlin_find_files
-    server.tool('merlin_find_files', 'Find files by purpose or layer. Call this BEFORE creating new files to check if something similar already exists. Re-fetch before editing — files change frequently. Returns file paths with descriptions.', {
+    server.tool('merlin_find_files', 'Find files by purpose, description, or architectural layer (routes, services, models, utils, components, hooks, middleware, etc.). Returns file paths, exports, and what to modify for specific tasks. Call BEFORE creating new files to check if something similar already exists. ALWAYS re-fetch before editing — files may have changed. Use this to locate existing functions before adding duplicates.', {
         query: z.string().describe('What you are looking for (e.g., "authentication", "database models", "API routes", "payment handling")'),
         layer: z.string().optional().describe('Filter by layer (routes, services, models, utils, components, etc.)'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -706,8 +711,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for style/rule questions ────────────
     // Tool: merlin_get_conventions
-    server.tool('merlin_get_conventions', 'Get coding conventions and anti-patterns for the repository.', {
+    server.tool('merlin_get_conventions', 'Get all coding conventions, anti-patterns, style rules, naming guidelines, and change guides for the repository. Use when reviewing code quality, enforcing standards, understanding what patterns to avoid, or learning how to make specific types of changes. Returns category-organized rules with examples and example files.', {
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ repoUrl }) => {
         try {
@@ -801,8 +807,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for onboarding/orientation ──────────
     // Tool: merlin_quickstart
-    server.tool('merlin_quickstart', 'Get a 60-second overview of the codebase. Use this when first working with a repository.', {
+    server.tool('merlin_quickstart', 'Get a 60-second overview and onboarding guide for the codebase. Returns the project quickstart document covering repo structure, entry points, dev commands, and key concepts. Use when first working with an unfamiliar repository, introducing a new team member, or needing a fast orientation without digging into code.', {
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ repoUrl }) => {
         try {
@@ -858,8 +865,9 @@ export function createServer() {
             };
         }
     });
+    // ── CORE tool: always loaded, used for searching documentation ──────────
     // Tool: merlin_search
-    server.tool('merlin_search', 'Search project documentation for patterns, flows, and implementations. Call this when you need to understand how something works before changing it. Wiki updates in real-time — always search fresh, never assume earlier results are still accurate.', {
+    server.tool('merlin_search', 'Search project documentation, wiki, and knowledge base by keyword or concept. Returns matching documentation sections, guides, and explanations that update in real-time as the team commits code. Use to find API docs, architecture notes, setup instructions, or any documented behavior. Complements merlin_get_context for targeted keyword search. Wiki updates in real-time — always fetch fresh.', {
         query: z.string().describe('What you want to find (e.g., "profile creation flow", "authentication", "payment API")'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ query, repoUrl }) => {
@@ -909,8 +917,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for listing available Sights ─────────
     // Tool: merlin_list_repos
-    server.tool('merlin_list_repos', 'List all repositories you have analyzed on Merlin.', {}, async () => {
+    server.tool('merlin_list_repos', 'List all repositories you have connected and analyzed on Merlin Sights. Returns repo names, GitHub URLs, analysis status (completed/pending/failed), and creation dates. Use to discover which Sights are available, find the URL for merlin_select_repo, or audit your connected repositories.', {}, async () => {
         try {
             const repos = await client.getRepositories();
             if (repos.length === 0) {
@@ -972,8 +981,9 @@ export function createServer() {
             };
         }
     });
+    // ── CORE tool: always loaded, used to connect a specific repo ───────────
     // Tool: merlin_select_repo
-    server.tool('merlin_select_repo', 'Select which Merlin Sight to use for this session. Call this at the start of every session to explicitly connect to a repository. This takes precedence over auto-detection.', {
+    server.tool('merlin_select_repo', 'Explicitly select which Merlin Sight (analyzed repository) to use for this session. Overrides auto-detection from git remote. Call when auto-detection picks the wrong repo, when working on a repo with multiple remotes, or when the auto-detected repo is not connected to Sights. Takes a GitHub URL and sets it as the active Sight for all subsequent tool calls.', {
         repoUrl: z.string().describe('GitHub URL of the repository to use (e.g., "github.com/user/repo" or full URL)'),
         projectDir: z.string().optional().describe('Local project directory path (helps when auto-detection fails). Get via Bash(pwd).'),
     }, async ({ repoUrl, projectDir }) => {
@@ -1062,8 +1072,9 @@ export function createServer() {
             };
         }
     });
+    // ── CORE tool: MANDATORY first call at every session start ──────────────
     // Tool: merlin_get_selected_repo
-    server.tool('merlin_get_selected_repo', 'CALL THIS FIRST at session start. Connects to Merlin Sights and returns repository info. Must be called before any other work.', {}, async () => {
+    server.tool('merlin_get_selected_repo', 'CALL THIS FIRST at every session start. Connects to Merlin Sights, auto-detects the current repository from git remote, returns repository info (name, URL, analysis status), available Sights list, and repo root path for file operations. Must be called before any other Merlin tool. Without this, context tools cannot resolve the correct codebase.', {}, async () => {
         // Mark session status as shown - this is the required first call
         markSessionStatusShown();
         recordToolCall('merlin_get_selected_repo');
@@ -1193,8 +1204,9 @@ export function createServer() {
             throw error;
         }
     });
+    // ── DEFERRED tool: loaded on-demand for polling analysis completion ──────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_check_repo_status
-        server.tool('merlin_check_repo_status', 'Check if a repository analysis is complete. Use after merlin_connect_repo to poll for completion. Returns status: pending, analyzing, completed, or failed.', {
+        server.tool('merlin_check_repo_status', 'Poll whether a repository analysis is complete after calling merlin_connect_repo. Returns status: pending, analyzing, completed, or failed, plus estimated time remaining. Use in a loop with 30-second intervals after connecting a new repo until status is "completed" before using context tools.', {
             repoUrl: z.string().optional().describe('GitHub URL of the repository (uses selected repo if omitted)'),
         }, async ({ repoUrl }) => {
             try {
@@ -1295,8 +1307,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_check_repo_status
+    // ── DEFERRED tool: loaded on-demand for onboarding new repositories ──────
     // Tool: merlin_connect_repo
-    server.tool('merlin_connect_repo', 'Connect a new repository to Merlin Sights for analysis. Use this when working on a repo that is not yet in Sights. Analysis takes 2-5 minutes.', {
+    server.tool('merlin_connect_repo', 'Connect and submit a new GitHub repository to Merlin Sights for analysis and indexing. Use when working on a repo not yet in Sights — analysis takes 2-5 minutes. After connecting, poll with merlin_check_repo_status until completed, then use merlin_get_context and merlin_find_files as normal.', {
         repoUrl: z.string().describe('GitHub URL of the repository (e.g., "https://github.com/user/repo")'),
         branch: z.string().optional().default('main').describe('Branch to analyze (default: main)'),
     }, async ({ repoUrl, branch }) => {
@@ -1469,8 +1482,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for change impact assessment ─────────
     // Tool: merlin_impact_analysis
-    server.tool('merlin_impact_analysis', 'CALL BEFORE modifying any file. Analyzes what could break if you change a specific file. Returns dependent files that might need updates. Prevents cascading breakage.', {
+    server.tool('merlin_impact_analysis', 'Analyze what could break if you modify a specific file. Returns all dependent files, importers, and downstream consumers that may need updates. Use before refactoring, renaming exports, changing function signatures, or modifying shared utilities to prevent cascading breakage.', {
         filePath: z.string().describe('The file path you plan to modify (e.g., "src/services/user.ts")'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ filePath, repoUrl }) => {
@@ -1499,8 +1513,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for finding existing patterns ─────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_similar_code
-        server.tool('merlin_similar_code', 'Find similar implementations in the codebase BEFORE writing new code. Prevents duplicating existing patterns. Use this when implementing anything — there is likely an existing pattern to follow.', {
+        server.tool('merlin_similar_code', 'Find similar existing implementations in the codebase before writing new code. Returns matching patterns, functions, or components already built that serve similar purposes. Use when implementing anything new — there is likely an existing pattern to follow or extend. Prevents duplicating code and enforces DRY principles.', {
             description: z.string().describe('What you\'re trying to implement (e.g., "API endpoint with authentication", "database query with pagination", "React form with validation")'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ description, repoUrl }) => {
@@ -1530,8 +1545,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_similar_code
+    // ── DEFERRED tool: loaded on-demand for getting real code patterns ────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_code_examples
-        server.tool('merlin_code_examples', 'Get real code examples from this codebase for common tasks. Shows actual patterns used in this project.', {
+        server.tool('merlin_code_examples', 'Get real code examples extracted from this codebase for specific tasks. Returns actual patterns, templates, and snippets used in production. Use when you need to see how a pattern is really implemented (not just described) — e.g., "add endpoint", "add test", "error handling", "database query".', {
             task: z.string().optional().describe('Specific task (e.g., "add endpoint", "add test", "error handling"). Leave empty for all examples.'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ task, repoUrl }) => {
@@ -1561,8 +1577,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_code_examples
+    // ── DEFERRED tool: loaded on-demand for natural language codebase Q&A ──
     // Tool: merlin_ask
-    server.tool('merlin_ask', 'Ask ANY question about the codebase in natural language. Uses AI-powered semantic search + RAG to find relevant context and generate accurate answers with source citations. Perfect for questions like "How does authentication work?", "Where should I add a new API endpoint?", "Why is X structured this way?"', {
+    server.tool('merlin_ask', 'Ask any natural language question about the codebase and get an AI-generated answer with source citations. Uses semantic search and RAG to find relevant context across documentation, code, and conventions. Use when you need a direct answer with explanation rather than raw files — e.g., "how does authentication work?", "where is billing handled?", "where should I add a new API endpoint?", "why is X structured this way?".', {
         question: z.string().describe('Your question in natural language (e.g., "How does the payment flow work?", "Where is user validation handled?", "What patterns are used for error handling?")'),
         quick: z.boolean().optional().default(false).describe('If true, returns a faster but shorter answer without detailed sources'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
@@ -1629,8 +1646,9 @@ export function createServer() {
     // ============================================================
     // AGENT MEMORY - Write Tools
     // ============================================================
+    // ── DEFERRED tool: loaded on-demand for persisting cross-session data ────
     // Tool: merlin_write_state
-    server.tool('merlin_write_state', 'Write state to Merlin cloud. Use for persisting PROJECT.md, ROADMAP.md, STATE.md, or any planning artifacts for cross-session memory.', {
+    server.tool('merlin_write_state', 'Persist arbitrary state to Merlin cloud storage for cross-session and cross-agent memory. Use to save project artifacts (PROJECT.md, ROADMAP.md, STATE.md), planning data, decisions, agent outputs, or any data that needs to survive context resets. Supports optimistic locking via version parameter to prevent concurrent overwrites.', {
         key: z.string().describe('State key (e.g., "project", "roadmap", "state", "phase_3")'),
         value: z.any().describe('The state data to store (will be JSON serialized)'),
         agentId: z.string().optional().describe('Agent identifier for tracking who wrote the state'),
@@ -1687,8 +1705,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for restoring cross-session data ─────
     // Tool: merlin_read_state
-    server.tool('merlin_read_state', 'Read state from Merlin cloud. Use to restore cross-session memory like PROJECT.md, ROADMAP.md, or STATE.md.', {
+    server.tool('merlin_read_state', 'Read previously persisted state from Merlin cloud storage. Use to restore cross-session memory like PROJECT.md, ROADMAP.md, STATE.md, agent outputs, or any data saved with merlin_write_state. Returns the stored value and metadata (version, last updated, written by).', {
         key: z.string().describe('State key to read (e.g., "project", "roadmap", "state")'),
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ key, repoUrl }) => {
@@ -1730,8 +1749,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for auditing stored state ─────────────
     // Tool: merlin_list_state
-    server.tool('merlin_list_state', 'List all state keys stored for this repository. Shows what cross-session memory is available.', {
+    server.tool('merlin_list_state', 'List all state keys stored in Merlin cloud for this repository. Returns key names, last-updated timestamps, and sizes. Use to discover what cross-session memory is available (PROJECT.md, ROADMAP.md, checkpoints, agent outputs, etc.) before reading specific keys with merlin_read_state.', {
         repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
     }, async ({ repoUrl }) => {
         try {
@@ -1775,8 +1795,9 @@ export function createServer() {
             };
         }
     });
+    // ── DEFERRED tool: loaded on-demand for team activity logging ─────────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_log_activity
-        server.tool('merlin_log_activity', 'Log an activity event to the team timeline. Use for tracking progress, milestones, and decisions.', {
+        server.tool('merlin_log_activity', 'Log an activity event to the shared team timeline for audit trail and visibility. Use to record task completions, phase transitions, milestone achievements, decisions made, or any significant progress event. Events appear on the Merlin dashboard team timeline for coordination.', {
             eventType: z.string().describe('Event type (e.g., "phase_started", "task_completed", "blocker_hit", "decision_made")'),
             eventData: z.any().optional().describe('Additional event data (JSON object)'),
             agentId: z.string().describe('Agent identifier for tracking'),
@@ -1824,8 +1845,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_log_activity
+    // ── DEFERRED tool: loaded on-demand for syncing task state to cloud ───────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_sync_task
-        server.tool('merlin_sync_task', 'Sync a task to Merlin cloud. Use to track work items, their status, and dependencies for team visibility.', {
+        server.tool('merlin_sync_task', 'Sync a task (create or update) to Merlin cloud for team visibility and cross-agent coordination. Use to track work items with status (pending/in_progress/completed/blocked), dependencies (blockedBy/blocks), phase, plan, and owner agent. Tasks appear on the Merlin dashboard and can be queried by other agents.', {
             title: z.string().describe('Task title'),
             status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'skipped']).optional().describe('Task status'),
             description: z.string().optional().describe('Task description'),
@@ -1891,8 +1913,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_sync_task
+    // ── DEFERRED tool: loaded on-demand for viewing cloud task state ──────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_get_tasks
-        server.tool('merlin_get_tasks', 'Get tasks synced to Merlin. Shows work items from all agents for team coordination.', {
+        server.tool('merlin_get_tasks', 'Retrieve tasks synced to Merlin cloud. Filter by status (pending/in_progress/completed/blocked), phase, or plan. Returns work items from all agents for team coordination and planning. Use to see what tasks exist before creating duplicates, check what others are working on, or audit overall progress.', {
             status: z.string().optional().describe('Filter by status (pending, in_progress, completed, blocked)'),
             phase: z.string().optional().describe('Filter by phase'),
             plan: z.string().optional().describe('Filter by plan'),
@@ -1954,8 +1977,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_get_tasks
+    // ── DEFERRED tool: loaded on-demand for escalating blockers to humans ────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_report_blocker
-        server.tool('merlin_report_blocker', 'Report a blocker that requires human attention. The blocker will appear in the team dashboard for resolution.', {
+        server.tool('merlin_report_blocker', 'Report a blocker or impediment that requires human attention, decision, or external action. Creates a visible alert on the team dashboard with severity level and context. Use when you hit an auth requirement, need a human decision point, encounter a critical error you cannot resolve, or need clarification before proceeding. Types: human_verify, auth_required, clarification, decision_point, external, error.', {
             title: z.string().describe('Brief description of the blocker'),
             blockerType: z.enum(['human_verify', 'auth_required', 'clarification', 'decision_point', 'external', 'error', 'other']).describe('Type of blocker'),
             description: z.string().optional().describe('Detailed description'),
@@ -2007,8 +2031,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_report_blocker
+    // ── DEFERRED tool: loaded on-demand for checking pending blockers ─────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_get_blockers
-        server.tool('merlin_get_blockers', 'Get open blockers awaiting resolution. Check before starting work to see if there are issues to resolve.', {
+        server.tool('merlin_get_blockers', 'Get open blockers or impediments awaiting resolution. Returns blockers reported by any agent with status, severity, type, and context. Check at session start or before starting work to see if there are critical issues or human-required decisions pending. Filter by status: open, resolved, or all.', {
             status: z.string().optional().default('open').describe('Filter by status (open, resolved, all)'),
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ status, repoUrl }) => {
@@ -2059,8 +2084,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_get_blockers
+    // ── DEFERRED tool: loaded on-demand for human-in-the-loop checkpoints ────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_create_checkpoint
-        server.tool('merlin_create_checkpoint', 'Create a checkpoint requiring human verification or decision. Pauses agent work until human responds.', {
+        server.tool('merlin_create_checkpoint', 'Create a verification checkpoint that signals a human review is needed before work continues. Use for human_verify, auth_gate, decision_point, approval, or review situations. Includes a summary of what was built and a checklist of items for the human to verify. The checkpoint appears on the dashboard and can be resolved to resume work.', {
             title: z.string().describe('Checkpoint title'),
             checkpointType: z.enum(['human_verify', 'auth_gate', 'decision_point', 'approval', 'review']).describe('Type of checkpoint'),
             description: z.string().optional().describe('Detailed description'),
@@ -2118,8 +2144,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_create_checkpoint
+    // ── DEFERRED tool: loaded on-demand for team coordination overview ────────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_get_team_state
-        server.tool('merlin_get_team_state', 'Get consolidated team state: active sessions, pending checkpoints, open blockers, task summary. Use at session start to see what others are working on.', {
+        server.tool('merlin_get_team_state', 'Get consolidated team coordination state: active agent sessions, pending human checkpoints, open blockers, task summary counts (pending/in-progress/completed), and saved planning artifacts. Use at session start to see what other agents are working on, what decisions are pending, and what state is available for resuming work.', {
             repoUrl: z.string().optional().describe('GitHub URL of the repository (auto-detected from git if omitted)'),
         }, async ({ repoUrl }) => {
             try {
@@ -2213,8 +2240,9 @@ export function createServer() {
             }
         });
     } // end cloud: merlin_get_team_state
+    // ── DEFERRED tool: loaded on-demand for session lifecycle management ──────
     if (hasCloudApi && !coreOnly) { // Tool: merlin_update_session
-        server.tool('merlin_update_session', 'Update your session status. Use to track your work progress and enable pause/resume across context resets.', {
+        server.tool('merlin_update_session', 'Update your current session status and progress metadata for team visibility and pause/resume support. Records current phase, plan, task, completion count, and health score. Use to mark your session as active/paused/completed and track progress so other agents or humans can see where you are in the workflow.', {
             sessionId: z.string().describe('Unique session identifier'),
             agentId: z.string().describe('Agent identifier'),
             status: z.enum(['active', 'paused', 'completed', 'abandoned']).optional().describe('Session status'),
@@ -2545,6 +2573,26 @@ export function createServer() {
         });
     } // end free: registerRouteTools
     // ============================================================
+    if (!coreOnly) {
+        // SMART ROUTE TOOLS - Discovery-first agent routing
+        // ============================================================
+        registerSmartRouteTools({
+            server,
+            client,
+            resolveRepoId,
+        });
+    } // end free: registerSmartRouteTools
+    // ============================================================
+    if (!coreOnly) {
+        // COST TOOLS - Session cost tracking and model routing savings
+        // ============================================================
+        registerCostTools({
+            server,
+            client,
+            resolveRepoId,
+        });
+    } // end free: registerCostTools
+    // ============================================================
     if (hasCloudApi && !coreOnly) {
         // PUBLIC SIGHTS INDEX - Browse open source analyzed codebases
         // ============================================================