@phuetz/code-buddy 1.6.1 → 2.0.0

package/dist/tools/metadata.js

@@ -1,3 +1,5 @@
+import { TOOL_EFFECT_CLASSES } from "./types.js";
+import { logger } from "../utils/logger.js";
 /**
  * Default tool metadata for all built-in tools
  */
@@ -5,6 +7,7 @@ export const TOOL_METADATA = [
     // File reading
     {
         name: 'view_file',
+        effect: 'read',
         category: 'file_read',
         keywords: ['view', 'read', 'show', 'display', 'content', 'file', 'open', 'look', 'see', 'check', 'list', 'directory', 'ls', 'cat'],
         priority: 10,
@@ -13,6 +16,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'read_file',
+        effect: 'read',
         category: 'file_read',
         keywords: ['read', 'view', 'show', 'display', 'content', 'file', 'hermes'],
         priority: 10,
@@ -22,6 +26,7 @@ export const TOOL_METADATA = [
     // File writing
     {
         name: 'create_file',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['create', 'new', 'write', 'generate', 'make', 'add', 'initialize', 'init', 'touch'],
         priority: 8,
@@ -29,6 +34,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'write_file',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['write', 'create', 'new', 'file', 'content', 'hermes'],
         priority: 8,
@@ -36,6 +42,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'str_replace_editor',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['edit', 'modify', 'change', 'update', 'replace', 'fix', 'refactor', 'alter', 'patch'],
         priority: 10,
@@ -43,6 +50,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'patch',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['patch', 'edit', 'replace', 'modify', 'file', 'text', 'hermes'],
         priority: 9,
@@ -50,6 +58,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'edit_file',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['edit', 'modify', 'change', 'update', 'fast', 'morph', 'apply', 'bulk'],
         priority: 9,
@@ -57,14 +66,42 @@ export const TOOL_METADATA = [
     },
     {
         name: 'multi_edit',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['multi', 'edit', 'replace', 'batch', 'atomic', 'refactor', 'multiple', 'edits', 'rename'],
         priority: 8,
         description: 'Apply multiple text replacements to a single file atomically'
     },
+    {
+        name: 'apply_patch',
+        effect: 'reversible',
+        category: 'file_write',
+        keywords: ['patch', 'diff', 'apply', 'unified', 'edit', 'update', 'add', 'delete', 'file', 'diff-first'],
+        priority: 8,
+        description: 'Apply a diff-first patch to add/update/delete files (required by WritePolicy strict mode)'
+    },
+    // Self-model — the robot's own components/bricks
+    {
+        name: 'self_describe',
+        effect: 'read',
+        category: 'file_read',
+        keywords: ['self', 'describe', 'components', 'composants', 'briques', 'bricks', 'architecture', 'de quoi es-tu fait', 'de quoi es-tu compose', 'qui es-tu', 'capabilities', 'capacites', 'capteur', 'capteurs', 'sensors', 'modules', 'buddy-sense', 'buddy-vision', 'buddy-memory', 'introspection', 'auto inspection', 'etudie', 'examine', 'inspecte', 'propre code', 'ton code', 'fonctionne', 'fonctionnes', 'fonctionnement', 'limites', 'version', 'conscient', 'consciente', 'conscience', 'consciousness', 'modele de soi'],
+        priority: 50,
+        description: "Inspect the robot's attested core, bounded code structure, turn metadata, configured faculties, and epistemic limits without live probes",
+        fleetSafe: true,
+    },
+    {
+        name: 'self_evolution',
+        effect: 'read',
+        category: 'file_read',
+        keywords: ['self', 'evolution', 'evolutions', 'changement', 'changements', 'recent', 'récemment', 'release', 'changelog', 'notes de version', 'version', 'appris', 'learned', 'voice', 'voix', 'memory', 'mémoire', 'companion', 'fiabilité', 'reliability'],
+        priority: 50,
+        description: "Read documented recent changes to Code Buddy's own behavior without modifying files or probing services",
+    },
     // Directory listing
     {
         name: 'list_directory',
+        effect: 'read',
         category: 'file_read',
         keywords: ['list', 'directory', 'files', 'ls', 'folder', 'contents', 'dir', 'entries'],
         priority: 9,
@@ -74,6 +111,7 @@ export const TOOL_METADATA = [
     // File search
     {
         name: 'search',
+        effect: 'read',
         category: 'file_search',
         keywords: ['search', 'find', 'locate', 'grep', 'look for', 'where', 'which', 'query', 'pattern', 'regex'],
         priority: 10,
@@ -82,6 +120,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'search_files',
+        effect: 'read',
         category: 'file_search',
         keywords: ['search', 'files', 'grep', 'find', 'pattern', 'text', 'hermes'],
         priority: 10,
@@ -90,6 +129,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'find_symbols',
+        effect: 'read',
         category: 'file_search',
         keywords: ['symbols', 'functions', 'classes', 'definitions', 'code', 'index', 'semantic'],
         priority: 8,
@@ -98,6 +138,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'find_references',
+        effect: 'read',
         category: 'file_search',
         keywords: ['references', 'usages', 'where used', 'callers', 'semantic'],
         priority: 8,
@@ -106,6 +147,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'find_definition',
+        effect: 'read',
         category: 'file_search',
         keywords: ['definition', 'go to definition', 'declaration', 'symbol'],
         priority: 8,
@@ -114,15 +156,35 @@ export const TOOL_METADATA = [
     },
     {
         name: 'search_multi',
+        effect: 'read',
         category: 'file_search',
         keywords: ['multi', 'search', 'batch', 'parallel', 'patterns', 'queries'],
         priority: 7,
         description: 'Run multiple searches in one call',
         fleetSafe: true,
     },
+    {
+        name: 'workspace_search',
+        effect: 'read',
+        category: 'file_search',
+        keywords: ['workspace', 'multi-repo', 'repository', 'ecosystem', 'search', 'grep'],
+        priority: 10,
+        description: 'Search text across every selected repository in the opt-in workspace',
+        fleetSafe: true,
+    },
+    {
+        name: 'workspace_read',
+        effect: 'read',
+        category: 'file_read',
+        keywords: ['workspace', 'multi-repo', 'repository', 'ecosystem', 'read', 'file'],
+        priority: 10,
+        description: 'Read a bounded file from a repository in the opt-in workspace',
+        fleetSafe: true,
+    },
     // System operations
     {
         name: 'bash',
+        effect: 'emission',
         category: 'system',
         keywords: ['bash', 'terminal', 'command', 'run', 'execute', 'shell', 'npm', 'yarn', 'pip', 'install', 'build', 'test', 'compile'],
         priority: 9,
@@ -130,20 +192,42 @@ export const TOOL_METADATA = [
     },
     {
         name: 'terminal',
+        effect: 'emission',
         category: 'system',
         keywords: ['terminal', 'bash', 'shell', 'command', 'execute', 'run', 'hermes'],
         priority: 9,
         description: 'Execute shell commands through the existing bash safety checks',
     },
+    {
+        name: 'interactive_shell',
+        effect: 'emission',
+        category: 'system',
+        keywords: [
+            'interactive', 'pty', 'handoff', 'vim', 'rebase', 'prompt', 'manual',
+            'shell', 'terminal', 'user', 'intervention', 'conflict',
+        ],
+        priority: 6,
+        description: 'Hand control of an interactive PTY shell to the user until they type exit',
+    },
     {
         name: 'process',
+        effect: 'emission',
         category: 'system',
         keywords: ['process', 'spawn', 'kill', 'list', 'logs', 'pid', 'monitor'],
         priority: 6,
         description: 'Manage system processes (spawn, inspect, logs, terminate)'
     },
+    {
+        name: 'app_server',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['dev server', 'app server', 'localhost', 'preview', 'test app', 'serve', 'npm run dev', 'vite', 'test ui'],
+        priority: 7,
+        description: 'Start/stop a managed local dev server and make its loopback URL browsable for testing the app'
+    },
     {
         name: 'js_repl',
+        effect: 'emission',
         category: 'system',
         keywords: ['javascript', 'repl', 'eval', 'node', 'snippet', 'runtime'],
         priority: 5,
@@ -151,14 +235,24 @@ export const TOOL_METADATA = [
     },
     {
         name: 'execute_code',
+        effect: 'emission',
         category: 'system',
         keywords: ['execute_code', 'hermes', 'code', 'script', 'runtime', 'subprocess', 'artifact', 'run'],
         priority: 8,
         description: 'Execute a bounded code snippet as a real subprocess and persist run artifacts',
     },
+    {
+        name: 'code_exec',
+        effect: 'emission',
+        category: 'utility',
+        keywords: ['code_exec', 'code mode', 'javascript', 'orchestration', 'tool bridge', 'responses lite', 'exec'],
+        priority: 9,
+        description: 'Run bounded JavaScript orchestration whose nested effects retain Code Buddy policies and confirmations',
+    },
     // Git operations
     {
         name: 'git',
+        effect: 'emission',
         category: 'git',
         keywords: ['git', 'commit', 'push', 'pull', 'branch', 'merge', 'diff', 'status', 'checkout', 'stash', 'version', 'control'],
         priority: 8,
@@ -167,6 +261,7 @@ export const TOOL_METADATA = [
     // Docker operations
     {
         name: 'docker',
+        effect: 'emission',
         category: 'system',
         keywords: ['docker', 'container', 'image', 'build', 'run', 'stop', 'logs', 'exec', 'compose', 'pull', 'push', 'prune', 'volume', 'network', 'dockerfile'],
         priority: 7,
@@ -175,6 +270,7 @@ export const TOOL_METADATA = [
     // Kubernetes operations
     {
         name: 'kubernetes',
+        effect: 'emission',
         category: 'system',
         keywords: ['kubernetes', 'k8s', 'kubectl', 'pod', 'deployment', 'service', 'namespace', 'cluster', 'node', 'scale', 'rollout', 'configmap', 'secret', 'ingress', 'helm'],
         priority: 7,
@@ -183,22 +279,135 @@ export const TOOL_METADATA = [
     // Web operations
     {
         name: 'web_search',
+        effect: 'emission',
         category: 'web',
-        keywords: ['search', 'google', 'web', 'internet', 'online', 'latest', 'news', 'documentation', 'docs', 'how to', 'weather', 'météo', 'meteo', 'forecast', 'temperature', 'info', 'find', 'lookup'],
+        keywords: ['search', 'google', 'web', 'internet', 'online', 'latest', 'news', 'documentation', 'docs', 'how to', 'info', 'find', 'lookup'],
         priority: 8,
-        description: 'Search the web for information including weather, news, documentation, and general queries',
+        description: 'Search the web for information including news, documentation, and general queries',
         fleetSafe: true,
     },
+    {
+        name: 'community_search',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['reddit', 'hacker news', 'community', 'discussion', 'people', 'opinion',
+            'what do people think', 'sentiment', 'buzz', 'trending', 'stack overflow',
+            'github', 'arxiv', 'avis', 'retours', 'communauté'],
+        priority: 8,
+        description: 'Search what people actually say — discussions, votes and engagement — rather than what publishers write',
+        fleetSafe: true,
+    },
+    {
+        name: 'weather',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['weather', 'météo', 'meteo', 'forecast', 'prévisions', 'previsions', 'température', 'temperature', 'pluie', 'neige', 'vent'],
+        priority: 8,
+        description: 'Current weather and forecast for a city via Open-Meteo (no API key)',
+        // Read-only (public weather API) — answerable under the plan posture.
+        fleetSafe: true,
+    },
+    {
+        name: 'stock_quote',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['stock', 'bourse', 'cours', 'action', 'quote', 'ticker', 'market', 'index', 'indice', 'nasdaq', 'cac', 'cac 40', 'cotation', 'action en bourse', 'valeur boursière'],
+        priority: 8,
+        description: 'Real stock/index market quote via Yahoo Finance (free, no API key), Stooq fallback',
+        // Read-only (public market data API) — answerable under the plan posture.
+        fleetSafe: true,
+    },
+    {
+        name: 'design_system',
+        effect: 'reversible',
+        category: 'utility',
+        keywords: ['design', 'design system', 'ui', 'brand', 'branding', 'style', 'theme', 'spotify', 'apple', 'brutalism', 'interface', 'landing', 'esthétique', 'charte', 'palette', 'typographie'],
+        priority: 7,
+        description: 'List 150 brand design systems and read a chosen DESIGN.md to generate branded UIs',
+        // Read-only (reads vendored DESIGN.md assets) — answerable under the plan posture.
+        fleetSafe: true,
+    },
+    {
+        name: 'csv_analyze',
+        effect: 'read',
+        category: 'utility',
+        keywords: ['csv', 'table', 'tabular', 'columns', 'colonnes', 'numeric', 'stats', 'statistiques', 'preview', 'data', 'analyze', 'analyse', 'spreadsheet'],
+        priority: 6,
+        description: 'Read-only CSV analysis: dimensions, column types, numeric stats, and a row preview',
+        // Read-only (deterministic local parse, no network) — answerable under the plan posture.
+        fleetSafe: true,
+    },
+    {
+        name: 'deep_research',
+        effect: 'emission',
+        category: 'web',
+        keywords: [
+            'research', 'deep research', 'investigate', 'investigation', 'sources', 'cite', 'citation',
+            'report', 'literature', 'state of the art', "état de l'art", 'etat de l\'art',
+            'recherche approfondie', 'recherche', 'enquête', 'due diligence', 'compare', 'comparison',
+            'storm', 'perspectives', 'multi-source', 'cited',
+        ],
+        priority: 7,
+        description: 'Bounded multi-source cited research pipeline (deep/wide/STORM) returning a report with references',
+    },
+    {
+        name: 'paper_qa',
+        effect: 'read',
+        category: 'web',
+        keywords: [
+            'paper', 'papers', 'pdf', 'scientific', 'science', 'article', 'articles', 'corpus',
+            'cite', 'citation', 'cited', 'page', 'section', 'papier', 'papiers', 'scientifique',
+            'cite la source', 'preuves', 'grounded', 'publication', 'étude', 'research paper',
+        ],
+        priority: 7,
+        description: 'Grounded, cited QA over a local corpus of scientific PDFs (page/section provenance, honest refusal)',
+    },
+    {
+        name: 'meeting_notes',
+        effect: 'reversible',
+        category: 'document',
+        keywords: [
+            'meeting', 'notes', 'minutes', 'transcript', 'transcription', 'audio', 'video',
+            'summary', 'decisions', 'actions', 'speakers', 'evidence', 'timestamp',
+            'réunion', 'compte rendu', 'résumé', 'décisions', 'tâches', 'horodatage',
+        ],
+        priority: 8,
+        description: 'Create private, grounded meeting notes from a workspace-local transcript, audio, or video file',
+    },
+    {
+        name: 'comfy_recipe',
+        effect: 'emission',
+        category: 'media',
+        keywords: [
+            'comfyui', 'comfy', 'recipe', 'workflow', 'local generation', 'image', 'reference image',
+            'avatar', 'character consistency', 'cohérence personnage', 'video',
+            'audio', 'music', '3d', 'storyboard', 'book cover', 'trailer', 'animation',
+            'génération locale', 'couverture', 'bande annonce',
+        ],
+        priority: 9,
+        description: 'List, preflight, or run a registered local ComfyUI recipe with declared workspace-local image references and confined outputs',
+    },
     {
         name: 'web_fetch',
+        effect: 'emission',
         category: 'web',
         keywords: ['fetch', 'url', 'website', 'page', 'download', 'http', 'https', 'link', 'read'],
         priority: 7,
         description: 'Fetch web page content',
         fleetSafe: true,
     },
+    {
+        name: 'web_scrape',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['scrape', 'crawl', 'extract', 'cloudflare', 'anti-bot', 'stealth', 'html', 'markdown', 'adaptive', 'selector'],
+        priority: 8,
+        description: 'Scrape a public web page locally with Scrapling and graceful web_fetch fallback',
+        fleetSafe: true,
+    },
     {
         name: 'web_extract',
+        effect: 'emission',
         category: 'web',
         keywords: ['extract', 'fetch', 'url', 'website', 'page', 'http', 'https', 'read', 'hermes'],
         priority: 7,
@@ -207,6 +416,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'internet_scout_plan',
+        effect: 'read',
         category: 'web',
         keywords: ['internet scout', 'surf', 'browse', 'navigation', 'osint', 'prospecting', 'lead', 'profile enrichment', 'search', 'fetch', 'observe', 'extract', 'assert', 'stagehand', 'evidence', 'rate limit', 'captcha', 'proof'],
         priority: 8,
@@ -215,6 +425,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'internet_scout_run',
+        effect: 'emission',
         category: 'web',
         keywords: ['internet scout', 'run', 'surf', 'browse', 'playwright', 'browser', 'navigation', 'osint', 'prospecting', 'lead', 'profile enrichment', 'search', 'fetch', 'observe', 'extract', 'assert', 'stagehand', 'evidence', 'rate limit', 'captcha', 'proof'],
         priority: 9,
@@ -223,6 +434,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_navigate',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'navigate', 'goto', 'url', 'playwright', 'hermes'],
         priority: 8,
@@ -230,6 +442,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_click',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'click', 'ref', 'element', 'playwright', 'hermes'],
         priority: 8,
@@ -237,6 +450,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_type',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'type', 'input', 'text', 'ref', 'playwright', 'hermes'],
         priority: 8,
@@ -244,6 +458,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_scroll',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'scroll', 'page', 'viewport', 'ref', 'playwright', 'hermes'],
         priority: 7,
@@ -251,6 +466,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_back',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'back', 'history', 'navigation', 'playwright', 'hermes'],
         priority: 7,
@@ -258,6 +474,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_press',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'press', 'keyboard', 'key', 'playwright', 'hermes'],
         priority: 7,
@@ -265,6 +482,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_vision',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'vision', 'screenshot', 'analyze', 'playwright', 'hermes'],
         priority: 8,
@@ -272,6 +490,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_dialog',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'dialog', 'alert', 'confirm', 'prompt', 'beforeunload', 'modal', 'playwright', 'hermes'],
         priority: 7,
@@ -279,6 +498,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_get_images',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'image', 'images', 'img', 'media', 'alt', 'playwright', 'hermes'],
         priority: 7,
@@ -286,6 +506,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_console',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'console', 'logs', 'javascript', 'pageerror', 'debug', 'playwright', 'hermes'],
         priority: 7,
@@ -293,6 +514,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser_snapshot',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'snapshot', 'accessibility', 'refs', 'observe', 'playwright', 'hermes'],
         priority: 8,
@@ -300,6 +522,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lead_scout_plan',
+        effect: 'read',
         category: 'planning',
         keywords: ['lead scout', 'prospecting', 'prospect', 'leads', 'b2b', 'architectes', 'syndics', 'agences immobilieres', 'maitres oeuvre', 'promoteurs', 'bureaux etudes', 'sirene', 'rnc', 'osint', 'public data', 'script recipe', 'scoring', 'human review'],
         priority: 9,
@@ -308,6 +531,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lead_scout_run',
+        effect: 'emission',
         category: 'planning',
         keywords: ['lead scout', 'run', 'prospecting', 'prospect', 'leads', 'b2b', 'architectes', 'syndics', 'agences immobilieres', 'dataset', 'json', 'csv', 'dedupe', 'scoring', 'review queue', 'email draft', 'human review'],
         priority: 10,
@@ -316,6 +540,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lead_scout_enrichment_plan',
+        effect: 'read',
         category: 'planning',
         keywords: ['lead scout', 'enrichment', 'multi-hop', 'script generation', 'sandbox', 'manus', 'architectes', 'website', 'contact page', 'phone', 'telephone', 'email', 'evidence chain', 'public data'],
         priority: 10,
@@ -324,6 +549,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lead_scout_lesson_candidates',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['lead scout', 'lessons', 'learning', 'self improvement', 'script feedback', 'sandbox logs', 'patterns', 'enrichment', 'lessons_add'],
         priority: 9,
@@ -333,6 +559,7 @@ export const TOOL_METADATA = [
     // Firecrawl (Native Engine v2026.3.14)
     {
         name: 'firecrawl_search',
+        effect: 'emission',
         category: 'web',
         keywords: ['search', 'firecrawl', 'crawl', 'web', 'find', 'query', 'results', 'internet'],
         priority: 8,
@@ -341,6 +568,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'firecrawl_scrape',
+        effect: 'emission',
         category: 'web',
         keywords: ['scrape', 'firecrawl', 'crawl', 'extract', 'web', 'page', 'content', 'markdown', 'fetch'],
         priority: 8,
@@ -349,20 +577,31 @@ export const TOOL_METADATA = [
     },
     {
         name: 'browser',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser', 'automate', 'click', 'fill', 'form', 'screenshot', 'scrape', 'navigate', 'headless', 'puppeteer', 'playwright', 'selenium', 'test', 'ui', 'automation', 'web', 'observe', 'extract', 'assert', 'assertion', 'stagehand', 'page.act', 'page.extract', 'page.observe'],
         priority: 6,
         description: 'Automate web browser for navigation, interaction, extraction, observation, and testing'
     },
+    {
+        name: 'web_test',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['web test', 'test ui', 'verify app', 'smoke test', 'e2e', 'console errors', 'check page', 'test app'],
+        priority: 7,
+        description: 'One-call structured UI test with evidence: console + server logs + snapshot + screenshot + assertions'
+    },
     {
         name: 'browser_operator',
+        effect: 'emission',
         category: 'web',
         keywords: ['browser operator', 'browser', 'web automation', 'live web', 'navigate', 'login', 'interaction', 'consent', 'stagehand', 'computer use', 'session', 'stop control', 'proof export', 'operator', 'propose'],
         priority: 6,
-        description: 'Propose a consent-gated Browser Operator session (action log, consent scopes, stop control, proof export) for live web goals beyond web_search/web_fetch — without launching a browser'
+        description: 'Propose a consent-gated Browser Operator session for a reviewed sourceUrl (action log, consent scopes, stop control, proof export) — without launching a browser'
     },
     {
         name: 'computer_control',
+        effect: 'emission',
         category: 'system',
         keywords: ['computer', 'control', 'desktop', 'mouse', 'keyboard', 'window', 'dialog', 'modal', 'prompt', 'click', 'type', 'automation', 'form', 'field', 'dropdown', 'listbox', 'checkbox', 'radio', 'tab', 'menu', 'tree', 'treeitem', 'slider', 'range', 'link', 'button', 'assert', 'application', 'profile', 'excel', 'spreadsheet', 'notepad', 'calculator'],
         priority: 6,
@@ -370,6 +609,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'office_macro_execute',
+        effect: 'emission',
         category: 'system',
         keywords: ['office', 'excel', 'word', 'powerpoint', 'vba', 'macro', 'powershell', 'com', 'windows', 'automation'],
         priority: 4,
@@ -378,6 +618,7 @@ export const TOOL_METADATA = [
     // Planning
     {
         name: 'create_todo_list',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['todo', 'plan', 'task', 'list', 'organize', 'steps', 'breakdown', 'project'],
         priority: 6,
@@ -385,6 +626,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'get_todo_list',
+        effect: 'read',
         category: 'planning',
         keywords: ['todo', 'task', 'list', 'view', 'show', 'what', 'do', 'faire', 'tâches', 'taches', 'pending', 'status'],
         priority: 7,
@@ -393,6 +635,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'update_todo_list',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['todo', 'update', 'complete', 'done', 'progress', 'status', 'mark'],
         priority: 6,
@@ -400,6 +643,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_show',
+        effect: 'read',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'show', 'card', 'task', 'board', 'coordination'],
         priority: 8,
@@ -407,6 +651,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_list',
+        effect: 'read',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'list', 'cards', 'tasks', 'board', 'coordination'],
         priority: 8,
@@ -414,6 +659,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_complete',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'complete', 'done', 'finish', 'task', 'board'],
         priority: 8,
@@ -421,6 +667,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_block',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'block', 'blocked', 'stuck', 'reason', 'task'],
         priority: 8,
@@ -428,6 +675,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_heartbeat',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'heartbeat', 'progress', 'status', 'task', 'agent'],
         priority: 8,
@@ -435,6 +683,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_comment',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'comment', 'note', 'task', 'board', 'coordination'],
         priority: 8,
@@ -442,6 +691,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_create',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'create', 'card', 'task', 'board', 'coordination'],
         priority: 8,
@@ -449,6 +699,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_link',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'link', 'artifact', 'url', 'commit', 'issue', 'task'],
         priority: 8,
@@ -456,6 +707,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'kanban_unblock',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['kanban', 'hermes', 'unblock', 'resume', 'progress', 'task', 'board'],
         priority: 8,
@@ -463,6 +715,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'send_message',
+        effect: 'emission',
         category: 'web',
         keywords: ['send', 'message', 'channel', 'gateway', 'telegram', 'discord', 'slack', 'email', 'hermes'],
         priority: 8,
@@ -470,6 +723,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'discord',
+        effect: 'emission',
         category: 'web',
         keywords: ['discord', 'server', 'guild', 'channel', 'messages', 'members', 'thread', 'hermes'],
         priority: 8,
@@ -477,6 +731,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'discord_admin',
+        effect: 'emission',
         category: 'web',
         keywords: ['discord', 'admin', 'server', 'guild', 'channels', 'roles', 'pins', 'moderation', 'hermes'],
         priority: 8,
@@ -484,6 +739,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'yb_query_group_info',
+        effect: 'emission',
         category: 'web',
         keywords: ['yuanbao', 'yb', 'group', 'pai', 'owner', 'member count', 'hermes'],
         priority: 8,
@@ -491,6 +747,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'yb_query_group_members',
+        effect: 'emission',
         category: 'web',
         keywords: ['yuanbao', 'yb', 'group', 'members', 'mention', 'bots', 'pai', 'hermes'],
         priority: 8,
@@ -498,6 +755,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'yb_send_dm',
+        effect: 'emission',
         category: 'web',
         keywords: ['yuanbao', 'yb', 'dm', 'direct message', 'private message', 'media', 'hermes'],
         priority: 8,
@@ -505,6 +763,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'yb_search_sticker',
+        effect: 'emission',
         category: 'web',
         keywords: ['yuanbao', 'yb', 'sticker', 'search', 'tim face', 'emoji', 'hermes'],
         priority: 8,
@@ -512,6 +771,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'yb_send_sticker',
+        effect: 'emission',
         category: 'web',
         keywords: ['yuanbao', 'yb', 'sticker', 'send', 'chat', 'tim face', 'hermes'],
         priority: 8,
@@ -519,6 +779,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'ha_list_entities',
+        effect: 'emission',
         category: 'web',
         keywords: ['homeassistant', 'home assistant', 'hass', 'entity', 'entities', 'smart home', 'hermes'],
         priority: 8,
@@ -526,6 +787,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'ha_get_state',
+        effect: 'emission',
         category: 'web',
         keywords: ['homeassistant', 'home assistant', 'hass', 'state', 'entity', 'smart home', 'hermes'],
         priority: 8,
@@ -533,6 +795,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'ha_list_services',
+        effect: 'emission',
         category: 'web',
         keywords: ['homeassistant', 'home assistant', 'hass', 'services', 'actions', 'smart home', 'hermes'],
         priority: 8,
@@ -540,6 +803,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'ha_call_service',
+        effect: 'emission',
         category: 'web',
         keywords: ['homeassistant', 'home assistant', 'hass', 'service', 'control', 'device', 'smart home', 'hermes'],
         priority: 8,
@@ -547,6 +811,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'mixture_of_agents',
+        effect: 'emission',
         category: 'utility',
         keywords: ['mixture of agents', 'moa', 'openrouter', 'frontier', 'aggregation', 'reasoning', 'hermes'],
         priority: 8,
@@ -554,6 +819,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_playback',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'music', 'playback', 'player', 'pause', 'skip', 'volume', 'recently played', 'hermes'],
         priority: 8,
@@ -561,6 +827,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_devices',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'device', 'devices', 'connect', 'transfer playback', 'speaker', 'hermes'],
         priority: 8,
@@ -568,6 +835,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_queue',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'queue', 'music', 'add to queue', 'play next', 'hermes'],
         priority: 8,
@@ -575,6 +843,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_search',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'search', 'music', 'track', 'album', 'artist', 'playlist', 'hermes'],
         priority: 8,
@@ -582,6 +851,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_playlists',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'playlist', 'playlists', 'create playlist', 'add items', 'remove items', 'hermes'],
         priority: 8,
@@ -589,6 +859,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_albums',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'album', 'albums', 'tracks', 'music', 'hermes'],
         priority: 8,
@@ -596,6 +867,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spotify_library',
+        effect: 'emission',
         category: 'web',
         keywords: ['spotify', 'library', 'saved tracks', 'saved albums', 'save music', 'remove saved', 'hermes'],
         priority: 8,
@@ -603,6 +875,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'x_search',
+        effect: 'emission',
         category: 'web',
         keywords: ['x', 'twitter', 'xai', 'grok', 'posts', 'threads', 'citations', 'current discussion', 'hermes'],
         priority: 8,
@@ -610,6 +883,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'feishu_doc_read',
+        effect: 'emission',
         category: 'web',
         keywords: ['feishu', 'lark', 'document', 'docx', 'read', 'raw content', 'hermes'],
         priority: 8,
@@ -617,6 +891,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'feishu_drive_list_comments',
+        effect: 'emission',
         category: 'web',
         keywords: ['feishu', 'lark', 'drive', 'comments', 'list', 'document', 'hermes'],
         priority: 8,
@@ -624,6 +899,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'feishu_drive_list_comment_replies',
+        effect: 'emission',
         category: 'web',
         keywords: ['feishu', 'lark', 'drive', 'comments', 'replies', 'thread', 'hermes'],
         priority: 8,
@@ -631,6 +907,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'feishu_drive_reply_comment',
+        effect: 'emission',
         category: 'web',
         keywords: ['feishu', 'lark', 'drive', 'comment', 'reply', 'document', 'hermes'],
         priority: 8,
@@ -638,6 +915,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'feishu_drive_add_comment',
+        effect: 'emission',
         category: 'web',
         keywords: ['feishu', 'lark', 'drive', 'comment', 'add', 'document', 'hermes'],
         priority: 8,
@@ -645,6 +923,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'cronjob',
+        effect: 'emission',
         category: 'planning',
         keywords: ['cron', 'cronjob', 'schedule', 'scheduled', 'job', 'jobs', 'reminder', 'monitor', 'heartbeat', 'watchdog', 'hermes'],
         priority: 8,
@@ -653,6 +932,7 @@ export const TOOL_METADATA = [
     // Codebase analysis
     {
         name: 'codebase_map',
+        effect: 'read',
         category: 'codebase',
         keywords: ['codebase', 'structure', 'architecture', 'map', 'overview', 'symbols', 'dependencies', 'analyze', 'graph', 'imports', 'who imports', 'neighbors', 'path', 'layers', 'components', 'modules', 'relationships', 'calls', 'call graph', 'extends', 'inherits', 'methods', 'flowchart', 'organigramme'],
         priority: 6,
@@ -661,6 +941,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'code_graph',
+        effect: 'read',
         category: 'codebase',
         keywords: ['code graph', 'call graph', 'who calls', 'what calls', 'callers', 'callees', 'impact analysis', 'what breaks', 'affected', 'flowchart', 'mermaid', 'diagram', 'organigramme', 'class hierarchy', 'inheritance', 'extends', 'implements', 'file functions', 'methods', 'signatures', 'dependency path', 'module dependencies', 'communities', 'clusters', 'subsystems', 'semantic search', 'embedding', 'similarity', 'pagerank', 'dead code', 'unused', 'uncalled', 'orphan', 'coupling', 'heatmap', 'refactoring', 'god function', 'hub module', 'drift', 'snapshot', 'evolution', 'visualize', 'interactive', 'd3', 'impact preview', 'pr impact', 'diff impact'],
         priority: 7,
@@ -669,6 +950,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'spawn_subagent',
+        effect: 'emission',
         category: 'codebase',
         keywords: ['subagent', 'agent', 'review', 'debug', 'test', 'explore', 'document', 'refactor'],
         priority: 5,
@@ -677,6 +959,7 @@ export const TOOL_METADATA = [
     // Media tools
     {
         name: 'screenshot',
+        effect: 'reversible',
         category: 'media',
         keywords: ['screenshot', 'capture', 'screen', 'image', 'snap', 'window'],
         priority: 5,
@@ -684,6 +967,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'camera_snapshot',
+        effect: 'reversible',
         category: 'media',
         keywords: ['camera', 'webcam', 'snapshot', 'photo', 'vision', 'see', 'look', 'companion', 'eyes'],
         priority: 6,
@@ -691,13 +975,15 @@ export const TOOL_METADATA = [
     },
     {
         name: 'camera_analyze',
+        effect: 'read',
         category: 'media',
-        keywords: ['camera', 'webcam', 'see', 'vision', 'describe', 'look', 'photo', 'companion', 'eyes', 'analyze', 'what do you see'],
+        keywords: ['camera', 'webcam', 'see', 'vision', 'describe', 'look', 'photo', 'companion', 'eyes', 'analyze', 'what do you see', 'image_path'],
         priority: 7,
-        description: 'Capture a local webcam frame and describe it with a local multimodal vision model'
+        description: 'Describe a still image (image_path) or a webcam frame with a local VLM (default moondream); refuses dark frames'
     },
     {
         name: 'audio',
+        effect: 'emission',
         category: 'media',
         keywords: ['audio', 'sound', 'music', 'transcribe', 'speech', 'voice', 'mp3', 'wav'],
         priority: 5,
@@ -705,20 +991,60 @@ export const TOOL_METADATA = [
     },
     {
         name: 'text_to_speech',
+        effect: 'emission',
         category: 'media',
         keywords: ['tts', 'speech', 'audio', 'voice', 'synthesize', 'hermes'],
         priority: 7,
         description: 'Convert text to a local speech audio file'
     },
+    {
+        name: 'tool_search',
+        effect: 'read',
+        category: 'system',
+        keywords: ['tool', 'search', 'discover', 'find', 'capability', 'mcp', 'schema'],
+        priority: 9,
+        description: 'Search available tools by keyword (progressive disclosure)',
+        // Index BM25 local, sans écriture ni réseau : une confirmation bloquante
+        // n'ajoute aucune frontière de sécurité et cassait le premier tour Studio.
+        fleetSafe: true,
+    },
     {
         name: 'image_generate',
+        effect: 'emission',
         category: 'media',
-        keywords: ['image', 'generate', 'picture', 'photo', 'openai', 'xai', 'hermes'],
+        keywords: ['image', 'generate', 'picture', 'photo', 'openai', 'xai', 'hermes', 'gener', 'cree', 'dessin', 'illustration'],
         priority: 8,
         description: 'Generate an image through the configured image backend and cache returned media when possible'
     },
+    {
+        name: 'lisa_selfie',
+        effect: 'emission',
+        category: 'media',
+        keywords: [
+            'lisa',
+            'selfie',
+            'photo',
+            'portrait',
+            'telegram',
+            'companion',
+            'lora',
+            'photo de toi',
+            'envoie photo',
+        ],
+        priority: 9,
+        description: 'Generate a portrait of Lisa (LoRA when installed) and optionally send it on Telegram',
+    },
+    {
+        name: 'image_edit',
+        effect: 'emission',
+        category: 'media',
+        keywords: ['image', 'edit', 'inpaint', 'mask', 'mark', 'design', 'retouch', 'modifier', 'zone'],
+        priority: 8,
+        description: 'Create a new edited image from a confirmed workspace source and optional PNG alpha mask'
+    },
     {
         name: 'video',
+        effect: 'emission',
         category: 'media',
         keywords: ['video', 'movie', 'frames', 'thumbnail', 'mp4', 'extract'],
         priority: 5,
@@ -726,6 +1052,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'video_analyze',
+        effect: 'read',
         category: 'media',
         keywords: ['video', 'analyze', 'vision', 'movie', 'mp4', 'gemini', 'openai', 'hermes'],
         priority: 8,
@@ -733,13 +1060,102 @@ export const TOOL_METADATA = [
     },
     {
         name: 'video_generate',
+        effect: 'emission',
         category: 'media',
-        keywords: ['video', 'generate', 'text-to-video', 'image-to-video', 'xai', 'fal', 'hermes'],
+        keywords: ['video', 'generate', 'text-to-video', 'image-to-video', 'xai', 'fal', 'hermes', 'gener', 'cree', 'clip', 'film', 'animation'],
         priority: 8,
         description: 'Generate a video through the configured video backend and cache returned media when possible'
     },
+    {
+        name: 'markdown_convert',
+        effect: 'reversible',
+        category: 'document',
+        keywords: ['markdown', 'convert', 'convertir', 'pdf', 'docx', 'xlsx', 'pptx', 'word', 'excel', 'powerpoint', 'html', 'csv', 'json', 'xml', 'zip', 'epub', 'ocr', 'transcription', 'table', 'tableau', 'structure', 'extract', 'extraire', 'lire', 'document', 'markitdown'],
+        priority: 8,
+        description: 'Convert any document (Office, PDF, HTML, CSV, ZIP, EPub, image, audio, URL) to structured Markdown for the model — preserves headings, lists and tables. Optional MarkItDown sidecar; falls back cleanly with install instructions when absent'
+    },
+    {
+        name: 'video_stitch',
+        effect: 'emission',
+        category: 'media',
+        keywords: ['video', 'stitch', 'montage', 'film', 'concatenate', 'concat', 'chain', 'transition', 'xfade', 'crossfade', 'enchainer', 'assembler', 'monter', 'clip', 'produire', 'production', 'long', 'music', 'voiceover'],
+        priority: 8,
+        description: 'Chain multiple local video clips into one longer film with transitions (xfade/gl), optional background music (ducked) and voiceover, via ffmpeg; saved under .codebuddy/media-generation/films/'
+    },
+    {
+        name: 'video_quality_gate',
+        effect: 'emission',
+        category: 'media',
+        keywords: [
+            'video', 'quality', 'gate', 'youtube', 'master', 'visual', 'identity', 'anatomy',
+            'fashion', 'review', 'qa', 'qualité', 'contrôle', 'gate visuel', 'flicker',
+        ],
+        priority: 8,
+        description: 'Fail-closed visual quality gate plus digest-bound YouTube master human review; never publishes',
+    },
+    {
+        name: 'video_long_form_plan',
+        effect: 'read',
+        category: 'media',
+        keywords: [
+            'video', 'long-form', 'long form', 'episode', 'plan', 'youtube', 'chapters',
+            'narration', 'ad break', 'mid-roll', 'épisode', 'plan long', 'compile',
+        ],
+        priority: 8,
+        description: 'Assess or compile an original long-form episode plan; never writes files or auto-publishes',
+    },
+    {
+        name: 'video_trailer_plan',
+        effect: 'read',
+        category: 'media',
+        keywords: [
+            'video', 'trailer', 'bande-annonce', 'cinematic', 'storyboard', 'book',
+            'preview', 'plan', 'narrative', 'hook', 'cta',
+        ],
+        priority: 8,
+        description: 'Validate a cinematic book-trailer plan or compile a preview routing estimate; never generates media',
+    },
+    {
+        name: 'video_flow_handoff',
+        effect: 'emission',
+        category: 'media',
+        keywords: [
+            'video', 'flow', 'google flow', 'veo', 'handoff', 'export', 'import',
+            'credits', 'browser', 'packet', 'transfert', 'veo3',
+        ],
+        priority: 8,
+        description: 'Build, verify, export or human-review Google Flow work packets; never bills via API, never publishes',
+    },
+    {
+        name: 'video_route',
+        effect: 'read',
+        category: 'media',
+        keywords: [
+            'video', 'route', 'router', 'hybrid', 'flow', 'veo', 'comfyui', 'longcat',
+            'gpuNode', 'localGpu', 'credits', 'engine', 'routage', 'moteur',
+        ],
+        priority: 8,
+        description: 'Route hybrid video requests to local engines or browser-assisted Google Flow; estimates credits, never spends',
+    },
+    {
+        name: 'understand_video',
+        effect: 'read',
+        category: 'media',
+        keywords: ['video', 'youtube', 'transcribe', 'transcript', 'captions', 'subtitles', 'vidéo', 'résume vidéo', 'summarize', 'watch', 'movie', 'mp4', 'visual', 'screencast', 'frames', 'on-screen', 'shown', 'cloud', 'gemini', 'research', 'experiment', 'backlog', 'innovation'],
+        priority: 8,
+        description: 'Understand a video: transcript + research card + unverified experiment backlog + optional local visual or opt-in Gemini analysis'
+    },
+    {
+        name: 'gpu_media_job',
+        effect: 'emission',
+        category: 'media',
+        keywords: ['gpuNode', 'gpu', 'panoworld', 'longcat', 'avatar', '3dgs', 'world model', 'reconstruction', 'render'],
+        priority: 8,
+        description: 'Submit and monitor isolated PanoWorld or LongCat jobs on a configured GPU worker'
+    },
     {
         name: 'ocr',
+        effect: 'read',
         category: 'media',
         keywords: ['ocr', 'text', 'extract', 'image', 'recognize', 'read'],
         priority: 5,
@@ -747,13 +1163,23 @@ export const TOOL_METADATA = [
     },
     {
         name: 'vision_analyze',
+        effect: 'read',
         category: 'media',
         keywords: ['vision', 'image', 'analyze', 'metadata', 'ocr', 'hermes'],
         priority: 8,
         description: 'Analyze a local image with metadata, colors, labels, and optional OCR evidence',
     },
+    {
+        name: 'object_detect',
+        effect: 'read',
+        category: 'media',
+        keywords: ['vision', 'image', 'object', 'detect', 'detection', 'yolo', 'yolov8', 'ultralytics', 'person', 'people', 'presence', 'camera'],
+        priority: 8,
+        description: 'Detect objects in a local image using local YOLOv8/Ultralytics inference',
+    },
     {
         name: 'clipboard',
+        effect: 'emission',
         category: 'media',
         keywords: ['clipboard', 'copy', 'paste', 'cut'],
         priority: 4,
@@ -762,6 +1188,7 @@ export const TOOL_METADATA = [
     // Document tools
     {
         name: 'pdf',
+        effect: 'reversible',
         category: 'document',
         keywords: ['pdf', 'document', 'extract', 'read', 'pages'],
         priority: 5,
@@ -769,6 +1196,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'document',
+        effect: 'reversible',
         category: 'document',
         keywords: ['docx', 'xlsx', 'pptx', 'word', 'excel', 'powerpoint', 'office', 'spreadsheet', 'embedded images', 'screenshots'],
         priority: 5,
@@ -776,6 +1204,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'archive',
+        effect: 'reversible',
         category: 'document',
         keywords: ['zip', 'tar', 'archive', 'compress', 'extract', 'unzip', 'rar', '7z'],
         priority: 5,
@@ -784,6 +1213,7 @@ export const TOOL_METADATA = [
     // Reasoning
     {
         name: 'reason',
+        effect: 'read',
         category: 'codebase',
         keywords: ['reason', 'think', 'plan', 'analyze', 'architecture', 'design', 'debug', 'complex', 'trade-off', 'compare', 'evaluate', 'strategy', 'decision', 'mcts', 'tree-of-thought'],
         priority: 6,
@@ -793,6 +1223,7 @@ export const TOOL_METADATA = [
     // Docs search
     {
         name: 'docs_search',
+        effect: 'read',
         category: 'codebase',
         keywords: ['docs', 'documentation', 'architecture', 'subsystem', 'api', 'security', 'config', 'design', 'how does', 'explain', 'overview'],
         priority: 5,
@@ -802,6 +1233,7 @@ export const TOOL_METADATA = [
     // Plan management
     {
         name: 'plan',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['plan', 'goal', 'steps', 'track', 'progress', 'todo', 'organize', 'breakdown', 'checklist', 'PLAN.md'],
         priority: 7,
@@ -810,6 +1242,7 @@ export const TOOL_METADATA = [
     // Script execution
     {
         name: 'run_script',
+        effect: 'emission',
         category: 'utility',
         keywords: ['script', 'python', 'typescript', 'javascript', 'shell', 'execute', 'run', 'sandbox', 'docker', 'compute', 'data'],
         priority: 5,
@@ -818,6 +1251,7 @@ export const TOOL_METADATA = [
     // Utility tools
     {
         name: 'diagram',
+        effect: 'emission',
         category: 'utility',
         keywords: ['diagram', 'flowchart', 'chart', 'mermaid', 'sequence', 'class', 'uml', 'graph', 'visualize'],
         priority: 5,
@@ -825,6 +1259,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'export',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['export', 'save', 'convert', 'format', 'json', 'markdown', 'html'],
         priority: 4,
@@ -832,6 +1267,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'qr',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['qr', 'code', 'barcode', 'scan', 'generate'],
         priority: 4,
@@ -839,6 +1275,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'a2ui',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['a2ui', 'surface', 'component', 'ui', 'interface', 'canvas', 'render'],
         priority: 4,
@@ -846,6 +1283,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'canvas',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['canvas', 'visual', 'workspace', 'diagram', 'layout', 'element', 'render', 'export', 'import'],
         priority: 4,
@@ -853,6 +1291,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'deploy',
+        effect: 'emission',
         category: 'utility',
         keywords: ['deploy', 'cloud', 'fly', 'railway', 'render', 'gcp', 'hosting', 'production', 'hetzner', 'northflank'],
         priority: 6,
@@ -861,6 +1300,7 @@ export const TOOL_METADATA = [
     // Agent Tools — attention, knowledge, lessons, discovery, device, verification
     {
         name: 'todo_update',
+        effect: 'reversible',
         category: 'planning',
         keywords: ['todo', 'task', 'plan', 'track', 'progress', 'attention', 'focus'],
         priority: 8,
@@ -868,14 +1308,23 @@ export const TOOL_METADATA = [
     },
     {
         name: 'restore_context',
+        effect: 'read',
         category: 'utility',
-        keywords: ['restore', 'context', 'memory', 'compressed', 'retrieve', 'earlier'],
+        keywords: ['restore', 'context', 'memory', 'compressed', 'retrieve', 'earlier', 'callId', 'raw', 'exact', 'workspace', 'session'],
         priority: 7,
-        description: 'Restore compressed context content by identifier',
-        fleetSafe: true,
+        description: 'Restore exact content previously captured in the active workspace and session by callId or scoped identifier',
+    },
+    {
+        name: 'context_expand',
+        effect: 'read',
+        category: 'utility',
+        keywords: ['context', 'expand', 'segment', 'summary', 'exact', 'archive', 'conversation'],
+        priority: 8,
+        description: 'Expand exact original messages for a compacted segment in the current session',
     },
     {
         name: 'knowledge_search',
+        effect: 'read',
         category: 'utility',
         keywords: ['knowledge', 'search', 'convention', 'docs', 'domain', 'procedure'],
         priority: 5,
@@ -884,6 +1333,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'knowledge_add',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['knowledge', 'add', 'save', 'persist', 'remember', 'convention'],
         priority: 4,
@@ -891,6 +1341,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'ask_human',
+        effect: 'read',
         category: 'utility',
         keywords: ['ask', 'human', 'clarify', 'question', 'input', 'pause', 'confirm'],
         priority: 6,
@@ -898,13 +1349,23 @@ export const TOOL_METADATA = [
     },
     {
         name: 'create_skill',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['skill', 'create', 'workflow', 'reusable', 'procedure', 'automate'],
         priority: 3,
         description: 'Create a new SKILL.md workflow'
     },
+    {
+        name: 'extension_forge',
+        effect: 'reversible',
+        category: 'system',
+        keywords: ['extension', 'forge', 'create', 'widget', 'tool', 'skill', 'self-extension', 'code'],
+        priority: 9,
+        description: 'Safely author and install a runtime widget, tool, or skill'
+    },
     {
         name: 'skill_discover',
+        effect: 'emission',
         category: 'utility',
         keywords: ['skill', 'discover', 'search', 'hub', 'install', 'capability', 'plugin'],
         priority: 3,
@@ -912,6 +1373,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'skills_list',
+        effect: 'read',
         category: 'utility',
         keywords: ['skill', 'skills', 'list', 'installed', 'enabled', 'disabled', 'hub', 'hermes'],
         priority: 5,
@@ -920,6 +1382,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'skill_view',
+        effect: 'read',
         category: 'utility',
         keywords: ['skill', 'skills', 'view', 'read', 'content', 'inspect', 'show', 'hub', 'hermes'],
         priority: 6,
@@ -928,6 +1391,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'skill_manage',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['skill', 'skills', 'manage', 'list', 'view', 'history', 'create', 'discover', 'candidate', 'review', 'install', 'enable', 'disable', 'deprecate', 'delete', 'patch', 'rollback', 'update', 'lifecycle', 'hub', 'hermes'],
         priority: 6,
@@ -935,13 +1399,15 @@ export const TOOL_METADATA = [
     },
     {
         name: 'device_manage',
+        effect: 'emission',
         category: 'utility',
-        keywords: ['device', 'ssh', 'adb', 'android', 'remote', 'screenshot', 'camera', 'pair'],
+        keywords: ['device', 'ssh', 'adb', 'android', 'remote', 'screenshot', 'camera', 'pair', 'calendar', 'agenda'],
         priority: 4,
-        description: 'Manage paired devices (SSH/ADB/local)'
+        description: 'Manage paired devices (SSH/ADB/local), including read-only calendar events'
     },
     {
         name: 'spawn_parallel_agents',
+        effect: 'emission',
         category: 'codebase',
         keywords: ['parallel', 'agents', 'concurrent', 'subtasks', 'batch', 'delegate'],
         priority: 5,
@@ -949,6 +1415,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'remember',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['memory', 'remember', 'persist', 'context', 'store', 'preference'],
         priority: 5,
@@ -956,13 +1423,27 @@ export const TOOL_METADATA = [
     },
     {
         name: 'replace_memory',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['memory', 'replace', 'rewrite', 'update', 'persist', 'preference'],
         priority: 5,
         description: 'Replace an existing persistent memory entry under the memory char budget'
     },
+    {
+        name: 'remind',
+        effect: 'reversible',
+        category: 'utility',
+        keywords: [
+            'remind', 'reminder', 'rappel', 'rappelle-moi', 'rappelle moi', 'remind me',
+            'alarm', 'alarme', 'notify me', 'préviens-moi', 'previens moi', 'schedule',
+            'todo', 'tâche', 'one-shot', 'dated',
+        ],
+        priority: 6,
+        description: 'Set a dated one-shot or daily recurring reminder without shelling buddy remind add',
+    },
     {
         name: 'memory_propose',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['memory', 'candidate', 'propose', 'review', 'long-term', 'persist'],
         priority: 5,
@@ -970,6 +1451,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'recall',
+        effect: 'read',
         category: 'utility',
         keywords: ['memory', 'recall', 'retrieve', 'lookup', 'context'],
         priority: 5,
@@ -978,6 +1460,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'forget',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['memory', 'forget', 'remove', 'delete', 'cleanup'],
         priority: 4,
@@ -985,6 +1468,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'relationship_context',
+        effect: 'read',
         category: 'utility',
         keywords: [
             'relationship',
@@ -1006,6 +1490,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lessons_add',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['lesson', 'learn', 'correction', 'pattern', 'rule', 'mistake'],
         priority: 5,
@@ -1013,6 +1498,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lessons_propose',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['lesson', 'propose', 'candidate', 'review', 'learn', 'self improvement', 'pattern'],
         priority: 5,
@@ -1020,6 +1506,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lessons_search',
+        effect: 'read',
         category: 'utility',
         keywords: ['lesson', 'search', 'pattern', 'rule', 'past', 'history', 'mistake'],
         priority: 5,
@@ -1028,6 +1515,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lessons_list',
+        effect: 'read',
         category: 'utility',
         keywords: ['lesson', 'list', 'all', 'show', 'history'],
         priority: 4,
@@ -1036,6 +1524,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lessons_graph',
+        effect: 'read',
         category: 'utility',
         keywords: ['lesson', 'graph', 'obsidian', 'wiki', 'related', 'concepts', 'links', 'notions'],
         priority: 5,
@@ -1044,6 +1533,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'user_model_observe',
+        effect: 'reversible',
         category: 'utility',
         keywords: ['user', 'model', 'preference', 'observe', 'profile', 'personalization', 'working style', 'trait'],
         priority: 4,
@@ -1051,6 +1541,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'user_model_recall',
+        effect: 'read',
         category: 'utility',
         keywords: ['user', 'model', 'preference', 'recall', 'profile', 'personalization', 'who'],
         priority: 4,
@@ -1059,6 +1550,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'task_verify',
+        effect: 'emission',
         category: 'utility',
         keywords: ['verify', 'test', 'typecheck', 'lint', 'check', 'validate', 'ci'],
         priority: 7,
@@ -1066,15 +1558,63 @@ export const TOOL_METADATA = [
     },
     {
         name: 'knowledge_graph',
+        effect: 'reversible',
         category: 'codebase',
         keywords: ['knowledge', 'graph', 'relationships', 'imports', 'calls', 'extends', 'dependencies', 'code', 'architecture'],
         priority: 6,
         description: 'Query code entity relationships and dependencies',
         fleetSafe: true,
     },
+    // LSP semantic navigation and diagnostics (read-only)
+    {
+        name: 'lsp_definition',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['lsp', 'definition', 'declaration', 'go to definition', 'semantic navigation', 'symbol', 'type'],
+        priority: 9,
+        description: 'Resolve a semantic symbol definition through the configured language server',
+        fleetSafe: true,
+    },
+    {
+        name: 'lsp_references',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['lsp', 'references', 'usages', 'callers', 'where used', 'semantic navigation', 'symbol'],
+        priority: 9,
+        description: 'Find semantic symbol references through the configured language server',
+        fleetSafe: true,
+    },
+    {
+        name: 'lsp_hover',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['lsp', 'hover', 'type', 'signature', 'documentation', 'semantic information', 'symbol'],
+        priority: 9,
+        description: 'Get semantic hover and type information from the configured language server',
+        fleetSafe: true,
+    },
+    {
+        name: 'lsp_symbols',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['lsp', 'symbols', 'outline', 'classes', 'functions', 'methods', 'document structure', 'semantic navigation'],
+        priority: 9,
+        description: 'Get a semantic document outline from the configured language server',
+        fleetSafe: true,
+    },
+    {
+        name: 'lsp_diagnostics',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['lsp', 'diagnostics', 'errors', 'warnings', 'typecheck', 'lint', 'semantic analysis'],
+        priority: 9,
+        description: 'Get diagnostics published by the configured language server',
+        fleetSafe: true,
+    },
     // LSP rename/refactor
     {
         name: 'lsp_rename',
+        effect: 'reversible',
         category: 'codebase',
         keywords: ['rename', 'refactor', 'symbol', 'lsp', 'language server', 'cross-file', 'identifier'],
         priority: 7,
@@ -1082,6 +1622,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'lsp_code_action',
+        effect: 'reversible',
         category: 'codebase',
         keywords: ['code action', 'quickfix', 'refactor', 'lsp', 'language server', 'suggestion'],
         priority: 6,
@@ -1090,6 +1631,7 @@ export const TOOL_METADATA = [
     // Bug finder (static analysis)
     {
         name: 'find_bugs',
+        effect: 'read',
         category: 'codebase',
         keywords: ['bug', 'find', 'scan', 'analysis', 'static', 'security', 'lint', 'check', 'vulnerability', 'error', 'leak', 'dead code', 'race condition', 'null', 'injection'],
         priority: 7,
@@ -1099,6 +1641,7 @@ export const TOOL_METADATA = [
     // Merge conflict resolution
     {
         name: 'resolve_conflicts',
+        effect: 'reversible',
         category: 'git',
         keywords: ['merge', 'conflict', 'resolve', 'git', 'ours', 'theirs', 'rebase', 'cherry-pick', 'markers'],
         priority: 7,
@@ -1107,6 +1650,7 @@ export const TOOL_METADATA = [
     // Vulnerability scanning
     {
         name: 'scan_vulnerabilities',
+        effect: 'emission',
         category: 'system',
         keywords: ['vulnerability', 'security', 'audit', 'dependency', 'npm', 'pip', 'cargo', 'cve', 'scan', 'advisory'],
         priority: 7,
@@ -1115,6 +1659,7 @@ export const TOOL_METADATA = [
     // Control
     {
         name: 'terminate',
+        effect: 'emission',
         category: 'control',
         keywords: ['terminate', 'finish', 'done', 'complete', 'end', 'stop', 'exit', 'signal'],
         priority: 5,
@@ -1124,6 +1669,7 @@ export const TOOL_METADATA = [
     // Secrets detection
     {
         name: 'scan_secrets',
+        effect: 'read',
         category: 'security',
         keywords: ['secrets', 'credentials', 'api key', 'token', 'password', 'leak', 'scan', 'security', 'hardcoded', 'detect', 'aws', 'github', 'stripe', 'jwt'],
         priority: 7,
@@ -1132,14 +1678,45 @@ export const TOOL_METADATA = [
     // Advisor (second opinion from a stronger reviewer model)
     {
         name: 'advisor',
+        effect: 'read',
         category: 'utility',
         keywords: ['advisor', 'review', 'second opinion', 'consult', 'check', 'validate', 'expert', 'critique', 'feedback'],
         priority: 6,
         description: 'Consult a stronger reviewer model for a second opinion (full conversation forwarded)'
     },
+    // Verify (explicit delegation to the independent, fresh-context Verifier agent)
+    {
+        name: 'verify',
+        effect: 'emission',
+        category: 'utility',
+        keywords: ['verify', 'verification', 'evidence', 'confirm', 'validate', 'oracle', 'independent', 'proof', 'check', 'works'],
+        priority: 6,
+        description: 'Delegate to an independent fresh-context Verifier that runs real oracles and returns a CONFIRMED / NEEDS REVIEW verdict with evidence (read-only)'
+        // No fleetSafe: the Verifier drives execution tools (bash/app_server) — not peer-exposable.
+    },
+    // Delegate agent (single tool that reaches the built-in specialized agents)
+    {
+        name: 'delegate_agent',
+        effect: 'emission',
+        category: 'utility',
+        keywords: ['delegate', 'agent', 'specialized', 'pdf', 'excel', 'xlsx', 'csv', 'data', 'analysis', 'sql', 'database', 'query', 'archive', 'zip', 'tar', 'swe', 'refactor', 'debug', 'pivot', 'correlate'],
+        priority: 6,
+        description: 'Delegate a bounded multi-step task to a built-in specialized agent (pdf/excel/data_analysis/sql/archive/swe)'
+        // No fleetSafe: swe/excel-write/sql-import/archive-create can write — not peer-exposable.
+    },
+    // Document generator (PPTX/DOCX/XLSX/PDF) — complements the read-only `document` tool
+    {
+        name: 'generate_document',
+        effect: 'reversible',
+        category: 'document',
+        keywords: ['generate', 'document', 'pptx', 'docx', 'xlsx', 'pdf', 'powerpoint', 'word', 'excel', 'slides', 'deck', 'report', 'create', 'export'],
+        priority: 6,
+        description: 'Generate professional documents (PowerPoint/Word/Excel/PDF) from markdown content'
+    },
     // Fleet — multi-Claude orchestration via peer-RPC (Phase (d).17)
     {
         name: 'peer_delegate',
+        effect: 'emission',
         category: 'utility',
         keywords: ['peer', 'delegate', 'fleet', 'consult', 'ask', 'collaborate', 'remote', 'claude', 'orchestrate', 'sub-agent', 'multi-ai', 'distributed', 'hermes', 'dispatch', 'dispatchProfile', 'profile', 'toolset', 'toolsets', 'policy'],
         priority: 7,
@@ -1147,6 +1724,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'peer_chain',
+        effect: 'emission',
         category: 'utility',
         keywords: ['peer', 'chain', 'fleet', 'delegate', 'multi-agent', 'collaborate', 'orchestrate', 'hermes', 'handoff', 'roles', 'review', 'safe', 'code'],
         priority: 8,
@@ -1154,6 +1732,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'list_peers',
+        effect: 'emission',
         category: 'utility',
         keywords: ['peers', 'fleet', 'connected', 'remote', 'claudes', 'list', 'discover', 'status', 'provider', 'model', 'capabilities', 'route', 'routing', 'hermes', 'dispatch'],
         priority: 5,
@@ -1161,6 +1740,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'route_peer',
+        effect: 'emission',
         category: 'utility',
         keywords: ['peer', 'route', 'fleet', 'model', 'provider', 'capability', 'delegate', 'multi-ai', 'orchestrate', 'select', 'hermes', 'dispatch', 'chain', 'roles', 'dispatchProfile', 'profile', 'toolset', 'toolsets', 'policy', 'safe', 'review', 'research', 'code'],
         priority: 7,
@@ -1169,6 +1749,7 @@ export const TOOL_METADATA = [
     // AskUserQuestion (structured multi-option mid-task questions)
     {
         name: 'ask_user_question',
+        effect: 'read',
         category: 'utility',
         keywords: ['ask', 'question', 'user', 'clarify', 'choose', 'option', 'decide', 'multi-choice', 'prompt', 'interactive', 'pick'],
         priority: 7,
@@ -1177,14 +1758,27 @@ export const TOOL_METADATA = [
     // ExitPlanMode (request approval to leave plan mode)
     {
         name: 'exit_plan_mode',
+        effect: 'read',
         category: 'utility',
         keywords: ['plan', 'exit', 'approve', 'approval', 'leave', 'execute', 'proceed', 'unlock', 'sign-off'],
         priority: 7,
         description: 'Request user approval to leave plan mode and start executing'
     },
+    {
+        name: 'submit_plan',
+        effect: 'reversible',
+        category: 'planning',
+        keywords: [
+            'plan', 'submit', 'approval', 'approve', 'research', 'execution plan',
+            'current.md', 'plan mode', 'sign-off',
+        ],
+        priority: 7,
+        description: 'Write .codebuddy/plans/current.md and request user approval to leave plan mode',
+    },
     // Codebase replace
     {
         name: 'codebase_replace',
+        effect: 'reversible',
         category: 'file_write',
         keywords: ['replace', 'find', 'rename', 'refactor', 'codebase', 'search', 'substitute', 'sed', 'bulk', 'mass', 'global'],
         priority: 7,
@@ -1195,6 +1789,7 @@ export const TOOL_METADATA = [
     // read their transcript, message them, or spawn isolated sandboxed sub-agents.
     {
         name: 'sessions_list',
+        effect: 'read',
         category: 'utility',
         keywords: ['sessions', 'list', 'active', 'agents', 'discover', 'coordination', 'multi-agent'],
         priority: 5,
@@ -1203,6 +1798,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'sessions_history',
+        effect: 'read',
         category: 'utility',
         keywords: ['sessions', 'history', 'transcript', 'messages', 'review', 'context', 'multi-agent'],
         priority: 5,
@@ -1211,6 +1807,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'session_search',
+        effect: 'read',
         category: 'utility',
         keywords: ['session', 'sessions', 'search', 'history', 'saved', 'recall', 'fts', 'conversation', 'hermes'],
         priority: 6,
@@ -1219,6 +1816,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'sessions_send',
+        effect: 'emission',
         category: 'utility',
         keywords: ['sessions', 'send', 'message', 'communicate', 'notify', 'multi-agent', 'broadcast'],
         priority: 6,
@@ -1226,6 +1824,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'sessions_spawn',
+        effect: 'emission',
         category: 'utility',
         keywords: ['sessions', 'spawn', 'create', 'subagent', 'delegate', 'parallel', 'subtask', 'multi-agent'],
         priority: 7,
@@ -1233,6 +1832,7 @@ export const TOOL_METADATA = [
     },
     {
         name: 'code_explorer_ask',
+        effect: 'read',
         category: 'utility',
         keywords: ['code-explorer', 'ask', 'query', 'understand', 'explain', 'search', 'related files', 'dependents', 'tests'],
         priority: 6,
@@ -1241,12 +1841,222 @@ export const TOOL_METADATA = [
     },
     {
         name: 'screen_memory',
+        effect: 'read',
         category: 'utility',
         keywords: ['screen', 'memory', 'screenpipe', 'recall', 'what did i see', 'history', 'ocr', 'audio', 'transcript', 'said', 'heard'],
         priority: 5,
         description: 'Recall what was on screen / said / heard via a local screenpipe instance (read-only, redacted)',
+        fleetSafe: true,
+    },
+    // ---- 20 pre-authored tools (wired 2026-07-05) ----
+    {
+        name: 'scaffold_app',
+        effect: 'reversible',
+        category: 'file_write',
+        keywords: ['scaffold', 'template', 'app', 'project', 'generate', 'node-cli', 'react', 'express'],
+        priority: 85,
+        description: 'Scaffold a new project from a template (node-cli, react, express).',
+        fleetSafe: false,
+    },
+    {
+        name: 'project_map',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['project', 'map', 'tree', 'structure', 'entrypoint', 'languages'],
+        priority: 80,
+        description: 'Read-only map of a project: directory tree, entry points and languages.',
+        fleetSafe: true,
+    },
+    {
+        name: 'dep_inspect',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['dependencies', 'package.json', 'scripts', 'engines', 'lockfile', 'npm'],
+        priority: 78,
+        description: 'Inspect package.json dependencies, scripts, engines and lockfile.',
+        fleetSafe: true,
+    },
+    {
+        name: 'code_stats',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['code', 'stats', 'lines', 'languages', 'comments', 'largest files'],
+        priority: 76,
+        description: 'Compute code statistics: line counts by language, comments and largest files.',
+        fleetSafe: true,
+    },
+    {
+        name: 'git_summary',
+        effect: 'emission',
+        category: 'git',
+        keywords: ['git', 'summary', 'status', 'branch', 'commit', 'ahead', 'behind'],
+        priority: 82,
+        description: 'Read-only git summary: branch, ahead/behind, staged/modified counts and last commit.',
+        fleetSafe: true,
+    },
+    {
+        name: 'todo_scan',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['todo', 'fixme', 'hack', 'xxx', 'scan', 'markers'],
+        priority: 72,
+        description: 'Scan a codebase for TODO/FIXME/HACK/XXX markers.',
+        fleetSafe: true,
+    },
+    {
+        name: 'json_query',
+        effect: 'read',
+        category: 'utility',
+        keywords: ['json', 'query', 'path', 'inspect', 'data'],
+        priority: 70,
+        description: 'Query a JSON file by a dotted/bracket path.',
+        fleetSafe: true,
+    },
+    {
+        name: 'csv_preview',
+        effect: 'read',
+        category: 'utility',
+        keywords: ['csv', 'preview', 'columns', 'rows', 'types', 'data'],
+        priority: 70,
+        description: 'Preview a CSV file: inferred columns, row counts and value types.',
+        fleetSafe: true,
+    },
+    {
+        name: 'env_doctor',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['environment', 'doctor', 'node', 'node_modules', 'scripts', 'config', 'git', 'docker'],
+        priority: 75,
+        description: 'Diagnose a project environment: node, node_modules, scripts, config, git, docker.',
+        fleetSafe: true,
+    },
+    {
+        name: 'port_check',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['port', 'check', 'loopback', 'available', 'listening', 'server'],
+        priority: 74,
+        description: 'Check whether a loopback port is available or already listening.',
+        fleetSafe: true,
+    },
+    {
+        name: 'lint_project',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['lint', 'eslint', 'quality'],
+        priority: 80,
+        description: 'Run the project linter (eslint) and report issues.',
+        fleetSafe: false,
+    },
+    {
+        name: 'test_runner',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['test', 'vitest', 'jest'],
+        priority: 80,
+        description: 'Run the project test suite (vitest/jest) and report results.',
+        fleetSafe: false,
+    },
+    {
+        name: 'format_project',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['format', 'prettier'],
+        priority: 70,
+        description: 'Run the project formatter (prettier).',
+        fleetSafe: false,
+    },
+    {
+        name: 'bundle_analyze',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['bundle', 'dist', 'gzip'],
+        priority: 70,
+        description: 'Analyze build output size (dist, gzip) for the project.',
+        fleetSafe: true,
+    },
+    {
+        name: 'build_project',
+        effect: 'emission',
+        category: 'system',
+        keywords: ['build', 'compile'],
+        priority: 80,
+        description: 'Build/compile the project and report the outcome.',
+        fleetSafe: false,
+    },
+    {
+        name: 'license_check',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['license', 'compliance', 'dependencies'],
+        priority: 75,
+        description: 'Check dependency licenses for compliance.',
+        fleetSafe: true,
+    },
+    {
+        name: 'sbom_generate',
+        effect: 'read',
+        category: 'codebase',
+        keywords: ['sbom', 'dependencies', 'supply-chain'],
+        priority: 75,
+        description: 'Generate a software bill of materials (SBOM) from the dependency tree.',
+        fleetSafe: true,
+    },
+    {
+        name: 'http_probe',
+        effect: 'emission',
+        category: 'web',
+        keywords: ['http', 'probe', 'loopback'],
+        priority: 65,
+        description: 'Probe a loopback HTTP endpoint for status and headers.',
+        fleetSafe: true,
+    },
+    {
+        name: 'file_search',
+        effect: 'read',
+        category: 'file_search',
+        keywords: ['search', 'regex', 'files'],
+        priority: 65,
+        description: 'Regex search in text files under a bounded root (ignores node_modules/.git/binaries).',
+        fleetSafe: true,
+    },
+    {
+        name: 'diff_files',
+        effect: 'read',
+        category: 'file_search',
+        keywords: ['diff', 'files', 'lcs'],
+        priority: 65,
+        description: 'Compute an LCS-based diff between two files.',
+        fleetSafe: true,
     },
 ];
+const missingEffectWarned = new Set();
+function isToolEffectClass(value) {
+    return TOOL_EFFECT_CLASSES.includes(value);
+}
+/** Resolve a tool's declared effect class. Missing catalog/MCP entries warn once and return `unknown`. */
+export function resolveToolEffect(name, metadata) {
+    if (isToolEffectClass(metadata?.effect))
+        return metadata.effect;
+    const catalog = TOOL_METADATA.find((entry) => entry.name === name)?.effect;
+    if (isToolEffectClass(catalog))
+        return catalog;
+    if (!missingEffectWarned.has(name)) {
+        missingEffectWarned.add(name);
+        logger.warn('tool metadata missing effect class; treating as unknown', { tool: name });
+    }
+    return 'unknown';
+}
+/** Test hook: unique-warning latch. */
+export function resetToolEffectWarningLatch() {
+    missingEffectWarned.clear();
+}
+/** Metadata visible to RAG / BM25. Gated tools stay out of the index when disabled. */
+export function getActiveToolMetadata() {
+    if (process.env.CODEBUDDY_CONTEXT_ZOOM === 'true')
+        return TOOL_METADATA;
+    return TOOL_METADATA.filter((metadata) => metadata.name !== 'context_expand');
+}
 /**
  * Category keyword mappings for query classification
  */
@@ -1258,7 +2068,7 @@ export const CATEGORY_KEYWORDS = {
     git: ['git', 'commit', 'push', 'pull', 'branch', 'merge', 'diff', 'status', 'version control'],
     web: ['search online', 'google', 'web', 'internet', 'fetch url', 'website', 'documentation', 'latest', 'news', 'browser', 'automate', 'click', 'fill form', 'screenshot', 'scrape', 'headless', 'ui test', 'observe', 'extract from page', 'assert page', 'stagehand', 'weather', 'météo', 'meteo', 'forecast', 'temperature', 'actualité', 'actualite', 'current events', 'real time', 'real-time'],
     planning: ['plan', 'todo', 'task', 'organize', 'steps', 'breakdown'],
-    media: ['image', 'audio', 'video', 'screenshot', 'picture', 'photo', 'sound', 'music', 'capture', 'camera', 'webcam', 'vision'],
+    media: ['image', 'audio', 'video', 'screenshot', 'picture', 'photo', 'sound', 'music', 'capture', 'camera', 'webcam', 'vision', 'clip', 'film', 'animation', 'dessin', 'illustration', 'voix'],
     document: ['pdf', 'document', 'docx', 'xlsx', 'word', 'excel', 'archive', 'zip'],
     utility: ['diagram', 'chart', 'export', 'qr', 'visualize', 'convert'],
     codebase: ['codebase', 'structure', 'architecture', 'analyze', 'overview', 'dependencies'],