@burtson-labs/agent-core 1.6.13

package/dist/tools/skills/semantic-search-skill.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Semantic search skill — auto-activated when users ask about code concepts,
+ * architecture, or need to find code by meaning rather than literal text.
+ *
+ * Uses Ollama's nomic-embed-text model for local embeddings. Indexes workspace
+ * files on first search and caches vectors in memory for the session.
+ *
+ * Requires Ollama running locally with nomic-embed-text installed:
+ *   ollama pull nomic-embed-text
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.semanticSearchSkill = void 0;
+exports.configureSemanticSearchOllamaUrl = configureSemanticSearchOllamaUrl;
+exports.resetSemanticIndex = resetSemanticIndex;
+let store = [];
+let indexedPaths = new Set();
+let ollamaBaseUrl = 'http://localhost:11434';
+async function embed(text) {
+    const response = await fetch(`${ollamaBaseUrl}/api/embeddings`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ model: 'nomic-embed-text', prompt: text }),
+        signal: AbortSignal.timeout(10000)
+    });
+    if (!response.ok) {
+        throw new Error(`Embedding failed: ${response.status}`);
+    }
+    const data = await response.json();
+    if (!Array.isArray(data.embedding)) {
+        throw new Error('Embedding response missing vector');
+    }
+    return data.embedding;
+}
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function chunkText(text, maxChars = 800) {
+    if (text.length <= maxChars)
+        return [text];
+    const chunks = [];
+    const lines = text.split('\n');
+    let current = '';
+    for (const line of lines) {
+        if ((current + line).length > maxChars && current.length > 0) {
+            chunks.push(current.trim());
+            current = '';
+        }
+        current += line + '\n';
+    }
+    if (current.trim())
+        chunks.push(current.trim());
+    return chunks;
+}
+async function indexFile(path, content) {
+    if (indexedPaths.has(path))
+        return;
+    const chunks = chunkText(content);
+    for (const chunk of chunks) {
+        try {
+            const vector = await embed(chunk);
+            store.push({ path, content: chunk, vector });
+        }
+        catch {
+            // Skip failed chunks silently
+        }
+    }
+    indexedPaths.add(path);
+}
+const semanticSearchTool = {
+    name: 'semantic_search',
+    description: 'Search the codebase by meaning, not just text. Finds code related to a concept even when the exact words differ. Automatically indexes workspace files on first use. Use this when search_code (regex) misses what you need.',
+    parameters: [
+        { name: 'query', description: 'Natural language description of what you are looking for (e.g. "authentication middleware", "database connection pooling", "error boundary component")', required: true },
+        { name: 'file_glob', description: 'Optional glob to restrict which files are searched (e.g. "src/**/*.ts"). Defaults to all .ts/.tsx/.js/.jsx/.py files.' },
+        { name: 'top_k', description: 'Number of results to return (default: 6)' }
+    ],
+    async execute(params, ctx) {
+        const query = params.query?.trim();
+        if (!query)
+            return { output: 'Error: query parameter is required', isError: true };
+        const topK = Math.min(parseInt(params.top_k ?? '6', 10) || 6, 15);
+        const glob = params.file_glob ?? '**/*.{ts,tsx,js,jsx,py}';
+        // If the store is empty, index workspace files first
+        if (store.length === 0) {
+            try {
+                const files = await ctx.listFiles(glob);
+                const toIndex = files.slice(0, 50); // Cap at 50 files for speed
+                for (const file of toIndex) {
+                    try {
+                        const absPath = file.startsWith('/') ||
+                            file.startsWith('~') ||
+                            /^[A-Za-z]:[\\/]/.test(file) ||
+                            file.startsWith('\\\\')
+                            ? file
+                            : `${ctx.workspaceRoot}/${file}`;
+                        const content = await ctx.readFile(absPath);
+                        if (content.length > 0 && content.length < 50000) {
+                            await indexFile(file, content);
+                        }
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+                if (store.length === 0) {
+                    return { output: 'No files could be indexed. Is nomic-embed-text installed? Run: ollama pull nomic-embed-text', isError: true };
+                }
+            }
+            catch (err) {
+                return {
+                    output: `Embedding search failed: ${err instanceof Error ? err.message : String(err)}. Ensure Ollama is running with nomic-embed-text.`,
+                    isError: true
+                };
+            }
+        }
+        // Search
+        try {
+            const queryVector = await embed(query);
+            const scored = store.map(chunk => ({
+                path: chunk.path,
+                content: chunk.content,
+                score: cosineSimilarity(queryVector, chunk.vector)
+            }));
+            scored.sort((a, b) => b.score - a.score);
+            // Deduplicate by path, keeping best score per file
+            const seen = new Map();
+            for (const item of scored) {
+                if (!seen.has(item.path)) {
+                    seen.set(item.path, item);
+                }
+                if (seen.size >= topK)
+                    break;
+            }
+            const results = Array.from(seen.values());
+            if (results.length === 0) {
+                return { output: `No relevant results found for: "${query}"` };
+            }
+            const output = results.map((r, i) => {
+                const preview = r.content.slice(0, 500);
+                return `### ${i + 1}. ${r.path} (score: ${r.score.toFixed(3)})\n\`\`\`\n${preview}${r.content.length > 500 ? '\n...' : ''}\n\`\`\``;
+            }).join('\n\n');
+            return { output: `Found ${results.length} relevant files for "${query}":\n\n${output}` };
+        }
+        catch (err) {
+            return {
+                output: `Search failed: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true
+            };
+        }
+    }
+};
+const indexWorkspaceTool = {
+    name: 'index_workspace',
+    description: 'Index workspace files for semantic search. Run this before semantic_search if you want to search more files or specific directories.',
+    parameters: [
+        { name: 'glob', description: 'Glob pattern of files to index (default: "**/*.{ts,tsx,js,jsx,py}")' },
+        { name: 'max_files', description: 'Maximum number of files to index (default: 50)' }
+    ],
+    async execute(params, ctx) {
+        const glob = params.glob ?? '**/*.{ts,tsx,js,jsx,py}';
+        const maxFiles = Math.min(parseInt(params.max_files ?? '50', 10) || 50, 100);
+        try {
+            const files = await ctx.listFiles(glob);
+            const toIndex = files.slice(0, maxFiles);
+            let indexed = 0;
+            let skipped = 0;
+            for (const file of toIndex) {
+                if (indexedPaths.has(file)) {
+                    skipped++;
+                    continue;
+                }
+                try {
+                    const absPath = file.startsWith('/') ||
+                        file.startsWith('~') ||
+                        /^[A-Za-z]:[\\/]/.test(file) ||
+                        file.startsWith('\\\\')
+                        ? file
+                        : `${ctx.workspaceRoot}/${file}`;
+                    const content = await ctx.readFile(absPath);
+                    if (content.length > 0 && content.length < 50000) {
+                        await indexFile(file, content);
+                        indexed++;
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+            return {
+                output: `Indexed ${indexed} files (${skipped} already indexed, ${store.length} total chunks). Semantic search is ready.`
+            };
+        }
+        catch (err) {
+            return {
+                output: `Indexing failed: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true
+            };
+        }
+    }
+};
+exports.semanticSearchSkill = {
+    id: 'search/semantic',
+    name: 'Semantic Search',
+    version: '1.0.0',
+    description: 'Search codebase by meaning using local Ollama embeddings (nomic-embed-text). Finds conceptually related code.',
+    instructions: 'Use semantic_search when you need to find code by concept (e.g. "authentication logic", "data validation") rather than exact text. Use search_code for literal/regex matches. The index is built automatically on first search.',
+    activation: 'auto',
+    triggerPatterns: [
+        /\bfind.*related\b/i,
+        /\bwhere.*handle/i,
+        /\bhow.*implement/i,
+        /\bwhat.*does\b/i,
+        /\bunderstand\b/i,
+        /\barchitecture\b/i,
+        /\bexplain.*code\b/i,
+        /\bsemantic/i
+    ],
+    tools: [semanticSearchTool, indexWorkspaceTool]
+};
+/**
+ * Configure the Ollama base URL for the embedding client.
+ * Call this before the skill is used if Ollama is not on localhost.
+ */
+function configureSemanticSearchOllamaUrl(url) {
+    ollamaBaseUrl = url.replace(/\/+$/, '');
+}
+/**
+ * Reset the in-memory index (e.g. on workspace change).
+ */
+function resetSemanticIndex() {
+    store = [];
+    indexedPaths = new Set();
+}
+//# sourceMappingURL=semantic-search-skill.js.map

package/dist/tools/skills/semantic-search-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search-skill.js","sourceRoot":"","sources":["../../../src/tools/skills/semantic-search-skill.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAiPH,4EAEC;AAKD,gDAGC;AA/OD,IAAI,KAAK,GAAkB,EAAE,CAAC;AAC9B,IAAI,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;AACrC,IAAI,aAAa,GAAG,wBAAwB,CAAC;AAE7C,KAAK,UAAU,KAAK,CAAC,IAAY;IAC/B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,iBAAiB,EAAE;QAC9D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA8B,CAAC;IAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAQ,GAAG,GAAG;IAC7C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QACD,OAAO,IAAI,IAAI,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACpD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IACnC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,kBAAkB,GAAc;IACpC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,8NAA8N;IAC3O,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,wJAAwJ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,uHAAuH,EAAE;QAC3J,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,0CAA0C,EAAE;KAC3E;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAyB;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,MAAM,EAAE,oCAAoC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAEnF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,CAAC;QAE3D,qDAAqD;QACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,4BAA4B;gBAEhE,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;oBAC3B,IAAI,CAAC;wBACH,MAAM,OAAO,GACX,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;4BACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;4BACpB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;4BAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;4BACrB,CAAC,CAAC,IAAI;4BACN,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;wBACrC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;4BACjD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;wBACjC,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,wBAAwB;oBAC1B,CAAC;gBACH,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,OAAO,EAAE,MAAM,EAAE,6FAA6F,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClI,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,MAAM,EAAE,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD;oBACvI,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QAED,SAAS;QACT,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACjC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;aACnD,CAAC,CAAC,CAAC;YAEJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAEzC,mDAAmD;YACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4D,CAAC;YACjF,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC5B,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;oBAAE,MAAM;YAC/B,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,MAAM,EAAE,mCAAmC,KAAK,GAAG,EAAE,CAAC;YACjE,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAClC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACxC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;YACtI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,OAAO,CAAC,MAAM,wBAAwB,KAAK,SAAS,MAAM,EAAE,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBAC5E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,kBAAkB,GAAc;IACpC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,sIAAsI;IACnJ,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,qEAAqE,EAAE;QACpG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,gDAAgD,EAAE;KACrF;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAyB;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,yBAAyB,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAE7E,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACzC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,OAAO,EAAE,CAAC;oBACV,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,OAAO,GACT,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBACpB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;wBACrB,CAAC,CAAC,IAAI;wBACN,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;oBACvC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;wBACjD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;wBAC/B,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,WAAW,OAAO,WAAW,OAAO,qBAAqB,KAAK,CAAC,MAAM,2CAA2C;aACzH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBAC9E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEW,QAAA,mBAAmB,GAAkB;IAChD,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,+GAA+G;IAC5H,YAAY,EAAE,iOAAiO;IAC/O,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE;QACf,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,iBAAiB;QACjB,iBAAiB;QACjB,mBAAmB;QACnB,oBAAoB;QACpB,aAAa;KACd;IACD,KAAK,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CAChD,CAAC;AAEF;;;GAGG;AACH,SAAgB,gCAAgC,CAAC,GAAW;IAC1D,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,KAAK,GAAG,EAAE,CAAC;IACX,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/dist/tools/skills/test-gen-skill.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Test generation skill — auto-activated when the user mentions tests, specs, or coverage.
+ *
+ * Provides tools for discovering test frameworks and running test suites,
+ * giving the model the context it needs to generate or fix tests.
+ */
+import type { SkillManifest } from '../skill-types';
+export declare const testGenSkill: SkillManifest;
+//# sourceMappingURL=test-gen-skill.d.ts.map

package/dist/tools/skills/test-gen-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-gen-skill.d.ts","sourceRoot":"","sources":["../../../src/tools/skills/test-gen-skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA6GpD,eAAO,MAAM,YAAY,EAAE,aAS1B,CAAC"}

package/dist/tools/skills/test-gen-skill.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Test generation skill — auto-activated when the user mentions tests, specs, or coverage.
+ *
+ * Provides tools for discovering test frameworks and running test suites,
+ * giving the model the context it needs to generate or fix tests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testGenSkill = void 0;
+const runTestsTool = {
+    name: 'run_tests',
+    description: 'Run the project test suite and return results. Auto-detects the test runner (vitest, jest, mocha, pytest, cargo test).',
+    parameters: [
+        { name: 'filter', description: 'Optional test name or file pattern to filter (e.g. "auth", "src/utils/*.test.ts")' },
+        { name: 'runner', description: 'Override the test runner (e.g. "vitest", "jest", "pytest"). Auto-detected if omitted.' }
+    ],
+    async execute(params, ctx) {
+        const runner = params.runner?.trim();
+        let cmd;
+        let args;
+        if (runner) {
+            cmd = runner;
+            args = ['run'];
+            if (params.filter)
+                args.push(params.filter);
+        }
+        else {
+            // Auto-detect: check for common test runner config files
+            const detectors = [
+                { files: ['vitest.config.ts', 'vitest.config.js'], cmd: 'npx', args: ['vitest', 'run'] },
+                { files: ['jest.config.ts', 'jest.config.js', 'jest.config.mjs'], cmd: 'npx', args: ['jest'] },
+                { files: ['pytest.ini', 'pyproject.toml', 'setup.cfg'], cmd: 'python3', args: ['-m', 'pytest'] },
+                { files: ['Cargo.toml'], cmd: 'cargo', args: ['test'] },
+            ];
+            let detected = false;
+            for (const detector of detectors) {
+                for (const file of detector.files) {
+                    try {
+                        const files = await ctx.listFiles(file);
+                        if (files.length > 0) {
+                            cmd = detector.cmd;
+                            args = [...detector.args];
+                            if (params.filter)
+                                args.push(params.filter);
+                            detected = true;
+                            break;
+                        }
+                    }
+                    catch {
+                        // file doesn't exist, try next
+                    }
+                }
+                if (detected)
+                    break;
+            }
+            if (!detected) {
+                // Fallback: try npx vitest run
+                cmd = 'npx';
+                args = ['vitest', 'run'];
+                if (params.filter)
+                    args.push(params.filter);
+            }
+        }
+        try {
+            const result = await ctx.runCommand(cmd, args, ctx.workspaceRoot);
+            const combined = [
+                result.stdout.trim() ? result.stdout.trim() : '',
+                result.stderr.trim() ? `stderr:\n${result.stderr.trim()}` : '',
+                `exit code: ${result.exitCode}`
+            ].filter(Boolean).join('\n\n');
+            return {
+                output: combined.slice(0, 16000),
+                isError: result.exitCode !== 0
+            };
+        }
+        catch (err) {
+            return { output: `Error running tests: ${err instanceof Error ? err.message : String(err)}`, isError: true };
+        }
+    }
+};
+const listTestFilesTool = {
+    name: 'list_test_files',
+    description: 'Find all test files in the workspace. Searches for common test file patterns (*.test.ts, *.spec.ts, test_*.py, *_test.go).',
+    parameters: [
+        { name: 'cwd', description: 'Subdirectory to search in (optional, defaults to whole workspace)' }
+    ],
+    async execute(params, ctx) {
+        const patterns = [
+            '**/*.test.ts', '**/*.test.tsx', '**/*.test.js', '**/*.test.jsx',
+            '**/*.spec.ts', '**/*.spec.tsx', '**/*.spec.js', '**/*.spec.jsx',
+            '**/test_*.py', '**/*_test.py', '**/*_test.go',
+        ];
+        const allFiles = [];
+        const cwd = params.cwd
+            ? `${ctx.workspaceRoot}/${params.cwd}`
+            : ctx.workspaceRoot;
+        for (const pattern of patterns) {
+            try {
+                const files = await ctx.listFiles(pattern, cwd);
+                allFiles.push(...files);
+            }
+            catch {
+                // pattern matched nothing
+            }
+        }
+        const unique = [...new Set(allFiles)].sort();
+        if (unique.length === 0) {
+            return { output: 'No test files found.' };
+        }
+        return { output: `${unique.length} test file(s) found:\n\n${unique.join('\n')}` };
+    }
+};
+exports.testGenSkill = {
+    id: 'testing/test-gen',
+    name: 'Testing',
+    version: '1.0.0',
+    description: 'Run tests, find test files, and assist with test generation.',
+    instructions: 'When writing tests, first use list_test_files to understand existing test patterns. Use run_tests to verify your changes. Match the existing test style and framework.',
+    activation: 'auto',
+    triggerPatterns: [/\btest/i, /\bspec\b/i, /\bcoverage\b/i, /\bunit\s+test/i],
+    tools: [runTestsTool, listTestFilesTool]
+};
+//# sourceMappingURL=test-gen-skill.js.map

package/dist/tools/skills/test-gen-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-gen-skill.js","sourceRoot":"","sources":["../../../src/tools/skills/test-gen-skill.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH,MAAM,YAAY,GAAc;IAC9B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,wHAAwH;IACrI,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mFAAmF,EAAE;QACpH,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uFAAuF,EAAE;KACzH;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAyB;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,GAAW,CAAC;QAChB,IAAI,IAAc,CAAC;QAEnB,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,GAAG,MAAM,CAAC;YACb,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;YACf,IAAI,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,SAAS,GAA4D;gBACzE,EAAE,KAAK,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;gBACxF,EAAE,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;gBAC9F,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;gBAChG,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;aACxD,CAAC;YAEF,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClC,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;wBACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACrB,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;4BACnB,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;4BAC1B,IAAI,MAAM,CAAC,MAAM;gCAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;4BAC5C,QAAQ,GAAG,IAAI,CAAC;4BAChB,MAAM;wBACR,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,+BAA+B;oBACjC,CAAC;gBACH,CAAC;gBACD,IAAI,QAAQ;oBAAE,MAAM;YACtB,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,+BAA+B;gBAC/B,GAAG,GAAG,KAAK,CAAC;gBACZ,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACzB,IAAI,MAAM,CAAC,MAAM;oBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,GAAI,EAAE,IAAK,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG;gBACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;gBAChD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;gBAC9D,cAAc,MAAM,CAAC,QAAQ,EAAE;aAChC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/B,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAM,CAAC;gBACjC,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/G,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAc;IACnC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,4HAA4H;IACzI,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,mEAAmE,EAAE;KAClG;IACD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAyB;QAC7C,MAAM,QAAQ,GAAG;YACf,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;YAChE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;YAChE,cAAc,EAAE,cAAc,EAAE,cAAc;SAC/C,CAAC;QAEF,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG;YACpB,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC,GAAG,EAAE;YACtC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;QAEtB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAChD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,2BAA2B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACpF,CAAC;CACF,CAAC;AAEW,QAAA,YAAY,GAAkB;IACzC,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,8DAA8D;IAC3E,YAAY,EAAE,wKAAwK;IACtL,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC5E,KAAK,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC;CACzC,CAAC"}

package/dist/tools/tool-registry.d.ts

@@ -0,0 +1,60 @@
+import type { AgentTool } from './tool-types';
+/**
+ * Registry of available agent tools.
+ *
+ * Builds XML-format tool definitions for text-based tool calling,
+ * usable with models that don't support native function calling
+ * (gemma3, bandit-core, most 7-27B models).
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    register(tool: AgentTool): this;
+    registerAll(tools: AgentTool[]): this;
+    get(name: string): AgentTool | undefined;
+    getAll(): AgentTool[];
+    has(name: string): boolean;
+    get size(): number;
+    /**
+     * Builds the tool definitions block injected into the system prompt.
+     *
+     * Format used for text-based tool calling (XML, compatible with Gemma3/bandit-core):
+     *
+     * You have access to these tools:
+     * <tool name="read_file">
+     *   <description>...</description>
+     *   <param name="path" required="true">...</param>
+     * </tool>
+     * ...
+     * To use a tool, respond with ONLY:
+     * <tool_call>{"name": "tool_name", "params": {"key": "value"}}</tool_call>
+     *
+     * When you have finished using tools and have a final answer, respond normally.
+     */
+    buildSystemPromptBlock(): string;
+    /**
+     * Builds tool definitions in JSON schema format for models with native tool calling.
+     * Compatible with Ollama's `tools: [...]` field.
+     *
+     * Parameter types: each AgentToolParameter may carry an optional
+     * `schema` field that holds JSON-Schema type info. When present we
+     * render the full shape (objects with properties, arrays with item
+     * types, enums) so the provider tells the model "this param is an
+     * object with these fields" instead of the legacy "every param is a
+     * string" flattening. Tools without `schema` default to `type: string`
+     * — matches every in-tree tool today and keeps the contract for
+     * adapter-less consumers.
+     */
+    buildNativeToolsSchema(): Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: {
+                type: 'object';
+                properties: Record<string, Record<string, unknown>>;
+                required: string[];
+            };
+        };
+    }>;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,cAAc,CAAC;AAE5F;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAK/B,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAOrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,MAAM,IAAI,SAAS,EAAE;IAIrB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB,IAAI,MAAM;IAyChC;;;;;;;;;;;;OAYG;IACH,sBAAsB,IAAI,KAAK,CAAC;QAC9B,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ,CAAC;gBACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;aACpB,CAAC;SACH,CAAC;KACH,CAAC;CAgBH"}

package/dist/tools/tool-registry.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+/**
+ * Registry of available agent tools.
+ *
+ * Builds XML-format tool definitions for text-based tool calling,
+ * usable with models that don't support native function calling
+ * (gemma3, bandit-core, most 7-27B models).
+ */
+class ToolRegistry {
+    constructor() {
+        this.tools = new Map();
+    }
+    register(tool) {
+        this.tools.set(tool.name, tool);
+        return this;
+    }
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+        return this;
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    getAll() {
+        return [...this.tools.values()];
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * Builds the tool definitions block injected into the system prompt.
+     *
+     * Format used for text-based tool calling (XML, compatible with Gemma3/bandit-core):
+     *
+     * You have access to these tools:
+     * <tool name="read_file">
+     *   <description>...</description>
+     *   <param name="path" required="true">...</param>
+     * </tool>
+     * ...
+     * To use a tool, respond with ONLY:
+     * <tool_call>{"name": "tool_name", "params": {"key": "value"}}</tool_call>
+     *
+     * When you have finished using tools and have a final answer, respond normally.
+     */
+    buildSystemPromptBlock() {
+        if (this.tools.size === 0)
+            return '';
+        const toolDefs = this.getAll().map(tool => {
+            const params = tool.parameters.map(p => {
+                // Surface the JSON-Schema-derived type hint inline in the
+                // description so the model knows when to emit a nested object
+                // or an array instead of a bare string. Without this hint the
+                // XML-prompt format describes every param as opaque text,
+                // which is what produced the "Expected object, received
+                // string" failures on createFilter / modifyMessageLabels.
+                const typeHint = formatParamTypeHint(p.schema);
+                const desc = typeHint ? `${typeHint} ${p.description}` : p.description;
+                return `  <param name="${p.name}"${p.required ? ' required="true"' : ''}>${desc}</param>`;
+            }).join('\n');
+            return [
+                `<tool name="${tool.name}">`,
+                `  <description>${tool.description}</description>`,
+                params,
+                `</tool>`
+            ].join('\n');
+        }).join('\n\n');
+        return [
+            '## Available Tools',
+            '',
+            'You have access to the following tools to help you complete tasks:',
+            '',
+            toolDefs,
+            '',
+            '## How to Use Tools',
+            '',
+            'To call a tool, respond with ONLY a tool call on its own line:',
+            '<tool_call>{"name": "tool_name", "params": {"param1": "value1"}}</tool_call>',
+            '',
+            'Wait for the tool result before continuing.',
+            'When you have all the information needed and are ready to give your final response,',
+            'respond normally without any <tool_call> tags.',
+        ].join('\n');
+    }
+    /**
+     * Builds tool definitions in JSON schema format for models with native tool calling.
+     * Compatible with Ollama's `tools: [...]` field.
+     *
+     * Parameter types: each AgentToolParameter may carry an optional
+     * `schema` field that holds JSON-Schema type info. When present we
+     * render the full shape (objects with properties, arrays with item
+     * types, enums) so the provider tells the model "this param is an
+     * object with these fields" instead of the legacy "every param is a
+     * string" flattening. Tools without `schema` default to `type: string`
+     * — matches every in-tree tool today and keeps the contract for
+     * adapter-less consumers.
+     */
+    buildNativeToolsSchema() {
+        return this.getAll().map(tool => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: {
+                    type: 'object',
+                    properties: Object.fromEntries(tool.parameters.map(p => [p.name, renderParamForNativeSchema(p)])),
+                    required: tool.parameters.filter(p => p.required).map(p => p.name)
+                }
+            }
+        }));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+/**
+ * Translate an AgentToolParameter to the JSON-Schema-shaped fragment
+ * Ollama (and other OpenAI-compatible native-tools providers) want in
+ * the `parameters.properties[<name>]` slot. When the param carries a
+ * `schema` field, expand it into a real typed declaration; otherwise
+ * fall back to the legacy `{ type: "string", description }` shape so
+ * existing in-tree tools render identically.
+ *
+ * Recursive: nested object properties and array item shapes are
+ * expanded the same way, so a `createFilter` param with `criteria:
+ * { type: object, properties: { from, to, subject, query, ... } }`
+ * renders correctly all the way through.
+ */
+function renderParamForNativeSchema(p) {
+    const baseDescription = p.description;
+    if (!p.schema) {
+        return { type: 'string', description: baseDescription };
+    }
+    const rendered = renderSchemaFragment(p.schema);
+    // Top-level description from the AgentToolParameter wins so the
+    // agent sees the rich human-readable description we wrote at the
+    // tool definition (which often summarizes the whole param), not
+    // a nested per-property blurb.
+    rendered.description = baseDescription;
+    return rendered;
+}
+/**
+ * Build a short inline hint like "(object: {from, to, subject})" or
+ * "(array of string)" that prefixes the param description in the
+ * non-native system prompt block. Without a hint the model treats
+ * every param as opaque text. With it the model knows which params
+ * need JSON-encoded objects/arrays vs bare strings — which is the
+ * difference between createFilter working and Google rejecting the
+ * request with "Expected object, received string."
+ */
+function formatParamTypeHint(schema) {
+    if (!schema || !schema.type || schema.type === 'string')
+        return '';
+    if (schema.type === 'object') {
+        const keys = schema.properties ? Object.keys(schema.properties).slice(0, 6) : [];
+        const more = schema.properties && Object.keys(schema.properties).length > 6 ? ', …' : '';
+        return keys.length > 0
+            ? `(object — pass JSON like {"${keys.join('": …, "')}": …}${more})`
+            : '(object — pass a JSON object)';
+    }
+    if (schema.type === 'array') {
+        const itemType = schema.items?.type ?? 'value';
+        return `(array of ${itemType} — pass JSON like ["..."])`;
+    }
+    if (schema.type === 'integer' || schema.type === 'number') {
+        return `(${schema.type})`;
+    }
+    if (schema.type === 'boolean') {
+        return '(boolean — true or false)';
+    }
+    return `(${schema.type})`;
+}
+function renderSchemaFragment(s) {
+    const out = {};
+    if (s.type)
+        out.type = s.type;
+    if (s.description)
+        out.description = s.description;
+    if (s.enum)
+        out.enum = s.enum;
+    if (s.type === 'object' && s.properties) {
+        out.properties = Object.fromEntries(Object.entries(s.properties).map(([k, v]) => [k, renderSchemaFragment(v)]));
+        if (s.required && s.required.length > 0) {
+            out.required = s.required;
+        }
+        // Defaulting additionalProperties:false here would be safer but
+        // some MCP servers depend on extra fields passing through; leave
+        // unset so the provider doesn't reject valid calls.
+    }
+    else if (s.type === 'array' && s.items) {
+        out.items = renderSchemaFragment(s.items);
+    }
+    return out;
+}
+//# sourceMappingURL=tool-registry.js.map