@mohanscodex/spectra-agent 0.4.9 → 0.5.0

package/dist/tool/skill.js

@@ -0,0 +1,120 @@
+import { loadSkillContent, getSkillDescription, formatSkillCatalogEntry, buildIndex, matchSkills } from '../skill.js';
+import { incrementUseCount } from '../skill-store.js';
+export function createSkillTool(skills) {
+    return {
+        name: 'skill',
+        description: `Load a specialized skill by name. Use find_skills first to discover available skills, then call this to load the full instructions. The skill name must match one listed by find_skills.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'The exact skill name (as listed by find_skills)',
+                },
+                args: {
+                    type: 'string',
+                    description: 'Optional arguments to pass to the skill ($ARGUMENTS substitution)',
+                },
+            },
+            required: ['name'],
+        },
+        execute: async (_toolCallId, args) => {
+            const name = args.name;
+            const skillArgs = args.args ?? '';
+            const skill = skills.get(name);
+            if (!skill) {
+                const available = Array.from(skills.keys()).join(', ');
+                return {
+                    content: [{ type: 'text', text: `Skill "${name}" not found. Available skills: ${available}` }],
+                    isError: true,
+                };
+            }
+            const content = await loadSkillContent(skill, skillArgs);
+            // Track usage for evolving skills (fire and forget)
+            incrementUseCount(skill.name).catch(() => { });
+            const fileList = skill.files.length > 0
+                ? `\n\n<skill_files>\n${skill.files.map((f) => `<file>${f}</file>`).join('\n')}\n</skill_files>`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `<skill_content name="${skill.name}">\n# Skill: ${skill.name}\n\n${content}\n\nBase directory for this skill: file://${skill.location}\nRelative paths in this skill (e.g., scripts/, references/) are relative to this base directory.${fileList}\n</skill_content>`,
+                    }],
+            };
+        },
+    };
+}
+export function createFindSkillsTool(skills) {
+    let cachedIndex = null;
+    function getIndex() {
+        if (!cachedIndex) {
+            cachedIndex = buildIndex([...skills.values()]);
+        }
+        return cachedIndex;
+    }
+    return {
+        name: 'find_skills',
+        description: `Discover available skills. Pass a query to search by topic/task, or set all=true to browse the full catalog. Use this before loading a skill with the skill tool.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (e.g. "deploy vercel", "debug typescript", "write tests")',
+                },
+                all: {
+                    type: 'boolean',
+                    description: 'Set true to list ALL available skills (fallback when query returns nothing)',
+                },
+            },
+        },
+        execute: async (_toolCallId, args) => {
+            const query = args.query ?? '';
+            const showAll = args.all ?? false;
+            if (skills.size === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No skills available. Skills are loaded from .claude/skills/, .agents/skills/, ~/.claude/skills/, and ~/.agents/skills/.' }],
+                };
+            }
+            // All mode: return full catalog
+            if (showAll) {
+                const lines = Array.from(skills.values()).map((s) => formatSkillCatalogEntry(s));
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `<skill_catalog count="${skills.size}">\nAvailable skills. Load one with the skill tool:\n\n${lines.join('\n')}\n</skill_catalog>`,
+                        }],
+                };
+            }
+            // Query mode: TF-IDF search
+            if (!query) {
+                return {
+                    content: [{ type: 'text', text: 'Provide a query string to search skills, or set all=true to list everything.' }],
+                };
+            }
+            const index = getIndex();
+            const matches = matchSkills(query, index, { topK: 10, threshold: 0.03 });
+            if (matches.length === 0) {
+                const lines = Array.from(skills.values()).map((s) => formatSkillCatalogEntry(s));
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No skills matched "${query}". Here are all available skills:\n\n<skill_catalog count="${skills.size}">\n${lines.join('\n')}\n</skill_catalog>`,
+                        }],
+                };
+            }
+            const resultLines = matches.map((m) => {
+                const desc = getSkillDescription(m.skill);
+                const tags = m.skill.tags.length > 0 ? ` [${m.skill.tags.slice(0, 5).join(', ')}]` : '';
+                return `- ${m.skill.name} — ${desc}${tags} (score: ${m.score.toFixed(3)})`;
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `<skill_matches query="${query}" count="${matches.length}">\n${resultLines.join('\n')}\n</skill_matches>`,
+                    }],
+            };
+        },
+    };
+}
+//# sourceMappingURL=skill.js.map

package/dist/tool/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/tool/skill.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohanscodex/spectra-agent",
-  "version": "0.4.9",
+  "version": "0.5.0",
   "description": "Spectra Agent — agent loop, tool dispatch, state management",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,7 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@mohanscodex/spectra-ai": "^0.4.9",
+    "@mohanscodex/spectra-ai": "^0.5.0",
     "zod": "^3.25.0",
     "zod-to-json-schema": "^3.24.0"
   },