@compilr-dev/sdk 0.10.5 → 0.10.7

package/dist/capabilities/auto-detect.d.ts

@@ -1,6 +1,8 @@
 /**
  * Auto-Detect Capabilities — scans agent messages for "Tool not found"
  * errors and auto-loads the corresponding capability packs.
+ * Also detects programming languages from file paths to pre-load
+ * language-specific analysis packs.
  */
 import type { Message } from '@compilr-dev/agents';
 import type { CapabilityManager } from './manager.js';

package/dist/capabilities/auto-detect.js

@@ -1,7 +1,23 @@
 /**
  * Auto-Detect Capabilities — scans agent messages for "Tool not found"
  * errors and auto-loads the corresponding capability packs.
+ * Also detects programming languages from file paths to pre-load
+ * language-specific analysis packs.
  */
+/**
+ * Map file extensions to language capability pack IDs.
+ */
+const EXT_TO_LANG_PACK = {
+    '.ts': 'lang_typescript',
+    '.tsx': 'lang_typescript',
+    '.js': 'lang_typescript',
+    '.jsx': 'lang_typescript',
+    '.mjs': 'lang_typescript',
+    '.cjs': 'lang_typescript',
+    '.py': 'lang_python',
+    '.pyw': 'lang_python',
+    '.go': 'lang_go',
+};
 /**
  * Scan recent messages for "Tool not found: X" errors and auto-load
  * the corresponding capability packs (max N per turn, loadable only).
@@ -45,5 +61,59 @@ export function autoDetectCapabilities(manager, messages, maxLoads = 2) {
         // Only scan the most recent user message
         break;
     }
+    // Also detect languages from file paths in recent tool calls
+    autoDetectLanguagePacks(manager, messages, result, maxLoads - result.loaded.length);
     return result;
 }
+/**
+ * Scan recent assistant messages for file-related tool calls (read_file, edit, write_file, glob)
+ * and auto-load language packs based on file extensions.
+ */
+function autoDetectLanguagePacks(manager, messages, result, maxLoads) {
+    if (maxLoads <= 0)
+        return;
+    const detectedPacks = new Set();
+    // Scan the last few assistant messages for tool_use blocks with file paths
+    const recentMessages = messages.slice(-6);
+    for (const msg of recentMessages) {
+        if (msg.role !== 'assistant' || typeof msg.content === 'string')
+            continue;
+        for (const block of msg.content) {
+            if (block.type !== 'tool_use')
+                continue;
+            // Extract file paths from common tool inputs
+            const input = block.input;
+            if (!input)
+                continue;
+            const paths = [];
+            if (typeof input.path === 'string')
+                paths.push(input.path);
+            if (typeof input.file_path === 'string')
+                paths.push(input.file_path);
+            if (typeof input.filePath === 'string')
+                paths.push(input.filePath);
+            if (typeof input.pattern === 'string')
+                paths.push(input.pattern);
+            for (const p of paths) {
+                const lastDot = p.lastIndexOf('.');
+                const ext = lastDot >= 0 ? p.slice(lastDot).toLowerCase() : '';
+                const packId = EXT_TO_LANG_PACK[ext];
+                if (packId && !manager.isLoaded(packId)) {
+                    detectedPacks.add(packId);
+                }
+            }
+        }
+    }
+    // Load detected language packs
+    let loaded = 0;
+    for (const packId of detectedPacks) {
+        if (loaded >= maxLoads)
+            break;
+        const tier = manager.getTier(packId);
+        if (tier === 'loadable') {
+            manager.load(packId, 'auto-detect');
+            result.loaded.push(packId);
+            loaded++;
+        }
+    }
+}

package/dist/capabilities/packs.js

@@ -327,6 +327,94 @@ export const CAPABILITY_PACKS = {
         estimatedPromptTokens: 60,
         estimatedToolTokens: 300,
     },
+    // ============= LANGUAGE-SPECIFIC ANALYSIS PACKS =============
+    lang_typescript: {
+        id: 'lang_typescript',
+        label: 'TypeScript/JavaScript Analysis',
+        tools: [
+            'ts_find_symbol',
+            'ts_find_references',
+            'ts_find_implementations',
+            'ts_find_dead_code',
+            'ts_find_duplicates',
+            'ts_find_patterns',
+            'ts_get_file_structure',
+            'ts_get_imports',
+            'ts_get_exports',
+            'ts_get_call_graph',
+            'ts_get_dependency_graph',
+            'ts_get_type_hierarchy',
+            'ts_get_complexity',
+            'ts_get_signature',
+            'ts_get_documentation',
+            'ts_read_function',
+            'ts_read_class',
+            'ts_read_type',
+        ],
+        readOnly: true,
+        promptModules: [],
+        promptSnippet: 'TypeScript/JS AST analysis loaded: ts_find_symbol, ts_get_call_graph, ts_get_type_hierarchy, ts_find_dead_code, ts_get_imports/exports, ts_find_patterns, ts_read_function/class/type. Use these for precise structural analysis (prefer over grep for code structure questions).',
+        estimatedPromptTokens: 120,
+        estimatedToolTokens: 4200,
+    },
+    lang_python: {
+        id: 'lang_python',
+        label: 'Python Analysis',
+        tools: [
+            'find_symbol_python',
+            'find_references_python',
+            'find_implementations_python',
+            'find_dead_code_python',
+            'find_duplicates_python',
+            'find_patterns_python',
+            'get_file_structure_python',
+            'get_imports_python',
+            'get_exports_python',
+            'get_call_graph_python',
+            'get_dependency_graph_python',
+            'get_class_hierarchy_python',
+            'get_complexity_python',
+            'get_signature_python',
+            'extract_docstrings_python',
+            'read_function_py',
+            'read_class_py',
+            'read_type_py',
+        ],
+        readOnly: true,
+        promptModules: [],
+        promptSnippet: 'Python AST analysis loaded: find_symbol_python, get_call_graph_python, get_class_hierarchy_python, find_dead_code_python, get_imports_python, extract_docstrings_python, read_function_py/class_py. Use these for precise structural analysis.',
+        estimatedPromptTokens: 120,
+        estimatedToolTokens: 4200,
+    },
+    lang_go: {
+        id: 'lang_go',
+        label: 'Go Analysis',
+        tools: [
+            'find_symbol_go',
+            'find_references_go',
+            'find_implementations_go',
+            'find_dead_code_go',
+            'find_duplicates_go',
+            'find_patterns_go',
+            'get_file_structure_go',
+            'get_imports_go',
+            'get_exports_go',
+            'get_call_graph_go',
+            'get_dependency_graph_go',
+            'get_class_hierarchy_go',
+            'get_complexity_go',
+            'get_signature_go',
+            'extract_docstrings_go',
+            'read_function_go',
+            'read_struct_go',
+            'read_type_go',
+        ],
+        readOnly: true,
+        promptModules: [],
+        promptSnippet: 'Go AST analysis loaded: find_symbol_go, get_call_graph_go, find_dead_code_go, get_imports_go, read_function_go/struct_go. Use these for precise structural analysis.',
+        estimatedPromptTokens: 120,
+        estimatedToolTokens: 4200,
+    },
 };
 /**
  * Mapping from forbidden pack IDs to suggested agent roles.

package/dist/guide/shared-content.js

@@ -174,18 +174,58 @@ Skills with issues (short description, empty body, name mismatch) show a ⚠ war
     // ── Models & Providers ──────────────────────────────────────────────────
     {
         id: 'models',
-        title: 'Models and Providers',
-        keywords: ['model', 'provider', 'claude', 'openai', 'gemini', 'ollama', 'llm'],
+        title: 'Models, Providers, and Model Switching',
+        keywords: [
+            'model',
+            'provider',
+            'claude',
+            'openai',
+            'gemini',
+            'ollama',
+            'llm',
+            'switch model',
+            'change model',
+            'hot swap',
+            'tier',
+            'fast',
+            'balanced',
+            'powerful',
+            'settings model',
+            'agent model',
+            'per-agent model',
+        ],
         content: `Compilr Dev supports multiple LLM providers:
 
-- Claude (Anthropic) — Claude Opus, Sonnet, Haiku
+- Claude (Anthropic) — Opus (powerful), Sonnet (balanced), Haiku (fast)
 - OpenAI — GPT-4o, GPT-4o-mini
 - Gemini (Google) — Gemini 2.5 Pro, Flash
 - Ollama — Local models (llama, codellama, etc.)
 - Together, Groq, Fireworks, Perplexity, OpenRouter
 
 Each provider requires an API key (except Ollama which runs locally).
-Models are organized by tier: premium, balanced, fast.`,
+
+**Model tiers:**
+- **Fast** — quick responses, lower cost (Haiku, GPT-4o-mini, Flash)
+- **Balanced** — best mix of speed and capability, the default (Sonnet, GPT-4o)
+- **Powerful** — best reasoning for complex tasks (Opus)
+
+**Settings model vs agent model — important distinction:**
+- The model in Settings is a **template for new agents**. Changing it does NOT affect existing agents. It only determines which model new agents get when you create them.
+- Each agent has its **own model**. You can change an agent's model independently without affecting other agents.
+
+**How to change an agent's model:**
+- **Desktop:** Click the model name in the status bar (bottom right) to open the model picker for the active chat's agent. You can also change models from the Agents panel.
+- **CLI:** Use /model to change the active agent's model.
+
+**Same provider only (Level 1):** You can switch between models within the same provider (e.g., Claude Sonnet → Claude Opus). Switching providers (e.g., Claude → Gemini) is not yet supported.
+
+**When to switch models:**
+- Use a **powerful** model (Opus) for complex architecture decisions, debugging hard problems, or writing nuanced content
+- Use the **balanced** model (Sonnet) for everyday coding, planning, and general tasks
+- Use a **fast** model (Haiku) for quick questions, simple edits, or when cost matters
+- Switch back after the hard task is done — no need to stay on the expensive model
+
+**Cost awareness:** switching from Haiku to Opus mid-conversation can significantly increase cost. The model tier is shown in the status bar and agent cards so you always know what you're using.`,
     },
     // ── Context & Memory ────────────────────────────────────────────────────
     {

package/dist/presets/coding.js

@@ -2,7 +2,7 @@
  * Coding preset — batteries-included for software development
  */
 import { readFileTool, writeFileTool, editTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, todoWriteTool, todoReadTool, webFetchTool, suggestTool, } from '@compilr-dev/agents';
-import { allCodingTools, unifiedTools } from '@compilr-dev/agents-coding';
+import { allCodingTools, unifiedTools, ts, python, go } from '@compilr-dev/agents-coding';
 const CODING_SYSTEM_PROMPT = `You are a skilled software engineer. You help users with coding tasks including:
 - Writing, reviewing, and debugging code
 - Understanding codebases and architecture
@@ -42,12 +42,23 @@ const utilityTools = [todoWriteTool, todoReadTool, suggestTool];
 /**
  * All coding preset tools combined
  */
+/**
+ * Language-specific AST analysis tools (loaded on-demand via capability packs).
+ * Registered in the MetaToolsRegistry but hidden until the matching
+ * lang_typescript / lang_python / lang_go pack is loaded.
+ */
+const langTools = [
+    ...ts.allTsTools,
+    ...python.allPythonTools,
+    ...go.allGoTools,
+];
 const allPresetTools = [
     ...fileTools,
     ...shellTools,
     ...utilityTools,
     ...allCodingTools,
     ...unifiedTools,
+    ...langTools,
 ];
 /**
  * Coding preset — full development environment

package/dist/team/tool-config.js

@@ -380,6 +380,85 @@ export const TOOL_GROUPS = {
         tier: 'meta',
         note: 'Generate project files from structured models',
     },
+    // Language-specific AST analysis (auto-loaded based on project language)
+    lang_typescript: {
+        label: 'TypeScript/JS Analysis',
+        tools: [
+            'ts_find_symbol',
+            'ts_find_references',
+            'ts_find_implementations',
+            'ts_find_dead_code',
+            'ts_find_duplicates',
+            'ts_find_patterns',
+            'ts_get_file_structure',
+            'ts_get_imports',
+            'ts_get_exports',
+            'ts_get_call_graph',
+            'ts_get_dependency_graph',
+            'ts_get_type_hierarchy',
+            'ts_get_complexity',
+            'ts_get_signature',
+            'ts_get_documentation',
+            'ts_read_function',
+            'ts_read_class',
+            'ts_read_type',
+        ],
+        readOnly: true,
+        tier: 'direct',
+        note: 'AST-based TypeScript/JavaScript analysis via TypeScript Compiler API',
+    },
+    lang_python: {
+        label: 'Python Analysis',
+        tools: [
+            'find_symbol_python',
+            'find_references_python',
+            'find_implementations_python',
+            'find_dead_code_python',
+            'find_duplicates_python',
+            'find_patterns_python',
+            'get_file_structure_python',
+            'get_imports_python',
+            'get_exports_python',
+            'get_call_graph_python',
+            'get_dependency_graph_python',
+            'get_class_hierarchy_python',
+            'get_complexity_python',
+            'get_signature_python',
+            'extract_docstrings_python',
+            'read_function_py',
+            'read_class_py',
+            'read_type_py',
+        ],
+        readOnly: true,
+        tier: 'direct',
+        note: 'AST-based Python analysis via Tree-sitter',
+    },
+    lang_go: {
+        label: 'Go Analysis',
+        tools: [
+            'find_symbol_go',
+            'find_references_go',
+            'find_implementations_go',
+            'find_dead_code_go',
+            'find_duplicates_go',
+            'find_patterns_go',
+            'get_file_structure_go',
+            'get_imports_go',
+            'get_exports_go',
+            'get_call_graph_go',
+            'get_dependency_graph_go',
+            'get_class_hierarchy_go',
+            'get_complexity_go',
+            'get_signature_go',
+            'extract_docstrings_go',
+            'read_function_go',
+            'read_struct_go',
+            'read_type_go',
+        ],
+        readOnly: true,
+        tier: 'direct',
+        note: 'AST-based Go analysis via Tree-sitter',
+    },
 };
 // =============================================================================
 // Tool Profiles
@@ -401,6 +480,9 @@ export const TOOL_PROFILES = {
         'search',
         'dependencies',
         'backlog_read',
+        'lang_typescript',
+        'lang_python',
+        'lang_go',
     ],
     // Developer - coding tasks
     developer: [
@@ -429,6 +511,9 @@ export const TOOL_PROFILES = {
         'web',
         'factory_models',
         'factory_scaffold',
+        'lang_typescript',
+        'lang_python',
+        'lang_go',
     ],
     // Security - security audits
     security: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.5",
+  "version": "0.10.7",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -76,7 +76,7 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
-    "@compilr-dev/agents-coding": "^1.0.6",
+    "@compilr-dev/agents-coding": "^1.0.8",
     "@eslint/js": "^9.39.1",
     "@opentelemetry/api": "^1.9.0",
     "@types/better-sqlite3": "^7.6.13",