skillpkg-mcp-server 0.1.0

package/dist/tools/search-registry.js

@@ -0,0 +1,72 @@
+/**
+ * Tool: search_registry
+ *
+ * Searches the skill registry only (no local search).
+ */
+import { getRegistryClient, successResult, errorResult, validateString, validateLimit } from './utils.js';
+import { RegistryUnavailableError } from '../types.js';
+export function createSearchRegistryHandler() {
+    return {
+        name: 'search_registry',
+        description: 'Search the skill registry for available skills. Returns skills from the remote registry only.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query to find skills',
+                },
+                limit: {
+                    type: 'number',
+                    default: 20,
+                    description: 'Maximum number of results (1-100)',
+                },
+            },
+            required: ['query'],
+        },
+        async execute(args) {
+            const input = args;
+            try {
+                const query = validateString(input.query, 'query');
+                const limit = validateLimit(input.limit, 20, 100);
+                const client = getRegistryClient();
+                // Check if registry is reachable
+                const isReachable = await client.ping();
+                if (!isReachable) {
+                    throw new RegistryUnavailableError();
+                }
+                const searchResult = await client.search(query, { limit });
+                const output = {
+                    results: searchResult.results.map((skill) => ({
+                        name: skill.name,
+                        description: skill.description,
+                        version: skill.version,
+                        author: skill.author || 'Unknown',
+                        downloads: skill.downloads || 0,
+                    })),
+                    total: searchResult.total,
+                };
+                // Format output
+                if (output.results.length === 0) {
+                    return successResult(`No skills found in registry for "${query}".`);
+                }
+                let text = `Registry search for "${query}" (${output.total} results):\n\n`;
+                for (const skill of output.results) {
+                    text += `• ${skill.name} v${skill.version}\n`;
+                    text += `  ${skill.description}\n`;
+                    text += `  Author: ${skill.author} | Downloads: ${skill.downloads}\n\n`;
+                }
+                text += `\nTo install: use install_skill with the skill name.`;
+                return successResult(text.trim());
+            }
+            catch (error) {
+                if (error instanceof RegistryUnavailableError) {
+                    return errorResult('Registry is currently unavailable.', 'Try again later or use list_skills to see locally installed skills.');
+                }
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(`Registry search failed: ${message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-registry.js.map

package/dist/tools/search-registry.js.map

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

package/dist/tools/search-skills.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tool: search_skills
+ *
+ * Searches for skills in local store and/or registry.
+ */
+import type { ToolHandler } from '../types.js';
+export declare function createSearchSkillsHandler(): ToolHandler;
+//# sourceMappingURL=search-skills.d.ts.map

package/dist/tools/search-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-skills.d.ts","sourceRoot":"","sources":["../../src/tools/search-skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,aAAa,CAAC;AAYrB,wBAAgB,yBAAyB,IAAI,WAAW,CAqLvD"}

package/dist/tools/search-skills.js

@@ -0,0 +1,159 @@
+/**
+ * Tool: search_skills
+ *
+ * Searches for skills in local store and/or registry.
+ */
+import { getStore, getRegistryClient, successResult, errorResult, validateString, validateLimit, calculateRelevanceScore, } from './utils.js';
+export function createSearchSkillsHandler() {
+    return {
+        name: 'search_skills',
+        description: 'Search for skills by keyword. Searches both installed skills and the registry, returning results sorted by relevance.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (matches name, description, and tags)',
+                },
+                source: {
+                    type: 'string',
+                    enum: ['all', 'local', 'registry'],
+                    default: 'all',
+                    description: 'Where to search: all, local (installed only), or registry (remote only)',
+                },
+                limit: {
+                    type: 'number',
+                    default: 20,
+                    description: 'Maximum number of results to return (1-100)',
+                },
+            },
+            required: ['query'],
+        },
+        async execute(args) {
+            const input = args;
+            try {
+                const query = validateString(input.query, 'query');
+                const source = input.source || 'all';
+                const limit = validateLimit(input.limit, 20, 100);
+                const results = [];
+                const installedNames = new Set();
+                // Search local stores
+                if (source === 'all' || source === 'local') {
+                    const scopes = ['local', 'global'];
+                    for (const scope of scopes) {
+                        const store = getStore(scope);
+                        if (!(await store.isInitialized())) {
+                            continue;
+                        }
+                        const skills = await store.listSkills();
+                        const queryLower = query.toLowerCase();
+                        for (const skill of skills) {
+                            // Simple text matching
+                            const nameMatch = skill.name.toLowerCase().includes(queryLower);
+                            const descMatch = skill.description.toLowerCase().includes(queryLower);
+                            if (nameMatch || descMatch) {
+                                installedNames.add(skill.name);
+                                results.push({
+                                    id: `${scope}:${skill.name}`,
+                                    name: skill.name,
+                                    description: skill.description,
+                                    version: skill.version,
+                                    source: 'local',
+                                    installed: true,
+                                    rating: 0, // Local skills don't have ratings
+                                    downloads: 0,
+                                    updatedAt: skill.installedAt,
+                                    tags: [],
+                                    relevanceScore: calculateRelevanceScore({
+                                        name: skill.name,
+                                        description: skill.description,
+                                        updatedAt: skill.installedAt,
+                                    }, query),
+                                });
+                            }
+                        }
+                    }
+                }
+                // Search registry
+                if (source === 'all' || source === 'registry') {
+                    try {
+                        const client = getRegistryClient();
+                        const searchResult = await client.search(query, { limit });
+                        for (const skill of searchResult.results) {
+                            const isInstalled = installedNames.has(skill.name);
+                            // Skip if already in results from local
+                            if (isInstalled && source === 'all') {
+                                // Update existing entry with registry metadata
+                                const existing = results.find((r) => r.name === skill.name);
+                                if (existing) {
+                                    existing.downloads = skill.downloads || 0;
+                                    existing.tags = skill.keywords || [];
+                                }
+                                continue;
+                            }
+                            results.push({
+                                id: `registry:${skill.name}`,
+                                name: skill.name,
+                                description: skill.description,
+                                version: skill.version,
+                                source: 'registry',
+                                installed: isInstalled,
+                                rating: 0, // Registry doesn't have ratings yet
+                                downloads: skill.downloads || 0,
+                                updatedAt: skill.updatedAt || new Date().toISOString(),
+                                tags: skill.keywords || [],
+                                relevanceScore: calculateRelevanceScore({
+                                    name: skill.name,
+                                    description: skill.description,
+                                    downloads: skill.downloads,
+                                    updatedAt: skill.updatedAt,
+                                    tags: skill.keywords,
+                                }, query),
+                            });
+                        }
+                    }
+                    catch {
+                        // Registry might be unavailable, continue with local results
+                        if (source === 'registry') {
+                            return errorResult('Registry is currently unavailable.', 'Try searching with source: "local" to see installed skills.');
+                        }
+                    }
+                }
+                // Sort by relevance score (descending)
+                results.sort((a, b) => b.relevanceScore - a.relevanceScore);
+                // Apply limit
+                const limitedResults = results.slice(0, limit);
+                const output = {
+                    results: limitedResults,
+                    total: results.length,
+                    query,
+                };
+                // Format output
+                if (limitedResults.length === 0) {
+                    return successResult(`No skills found for "${query}".`);
+                }
+                let text = `Found ${output.total} skill(s) for "${query}":\n\n`;
+                for (const skill of limitedResults) {
+                    const installed = skill.installed ? ' [installed]' : '';
+                    const rating = skill.rating > 0 ? ` ⭐${skill.rating.toFixed(1)}` : '';
+                    const downloads = skill.downloads > 0 ? ` 📥${skill.downloads}` : '';
+                    text += `• ${skill.name} v${skill.version}${installed}${rating}${downloads}\n`;
+                    text += `  ${skill.description}\n`;
+                    if (skill.tags.length > 0) {
+                        text += `  Tags: ${skill.tags.join(', ')}\n`;
+                    }
+                    text += '\n';
+                }
+                if (output.total > limit) {
+                    text += `Showing ${limit} of ${output.total} results.`;
+                }
+                return successResult(text.trim());
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(`Search failed: ${message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-skills.js.map

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

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

package/dist/tools/skill-info.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tool: skill_info
+ *
+ * Gets detailed information about a skill from the registry.
+ */
+import type { ToolHandler } from '../types.js';
+export declare function createSkillInfoHandler(): ToolHandler;
+//# sourceMappingURL=skill-info.d.ts.map

package/dist/tools/skill-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-info.d.ts","sourceRoot":"","sources":["../../src/tools/skill-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAuD,MAAM,aAAa,CAAC;AAIpG,wBAAgB,sBAAsB,IAAI,WAAW,CAwFpD"}

package/dist/tools/skill-info.js

@@ -0,0 +1,83 @@
+/**
+ * Tool: skill_info
+ *
+ * Gets detailed information about a skill from the registry.
+ */
+import { getRegistryClient, successResult, errorResult, validateString } from './utils.js';
+import { SkillNotFoundError } from '../types.js';
+export function createSkillInfoHandler() {
+    return {
+        name: 'skill_info',
+        description: 'Get detailed information about a skill from the registry, including versions, readme, and metadata.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Name of the skill to get information about',
+                },
+            },
+            required: ['name'],
+        },
+        async execute(args) {
+            const input = args;
+            try {
+                const skillName = validateString(input.name, 'name');
+                const client = getRegistryClient();
+                let skillInfo;
+                try {
+                    skillInfo = await client.getSkillInfo(skillName);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : '';
+                    if (message.includes('404') || message.includes('not found')) {
+                        throw new SkillNotFoundError(skillName);
+                    }
+                    throw error;
+                }
+                const author = typeof skillInfo.author === 'string'
+                    ? { name: skillInfo.author }
+                    : skillInfo.author || { name: 'Unknown' };
+                const output = {
+                    name: skillInfo.name,
+                    description: skillInfo.description,
+                    version: skillInfo.version,
+                    author,
+                    repository: skillInfo.repository,
+                    license: skillInfo.license,
+                    tags: skillInfo.keywords,
+                };
+                // Format detailed output
+                let text = `# ${output.name}\n\n`;
+                text += `**Version:** ${output.version}\n`;
+                text += `**Author:** ${output.author.name}`;
+                if (output.author.email)
+                    text += ` <${output.author.email}>`;
+                if (output.author.url)
+                    text += ` (${output.author.url})`;
+                text += '\n';
+                if (output.license) {
+                    text += `**License:** ${output.license}\n`;
+                }
+                if (output.repository) {
+                    text += `**Repository:** ${output.repository}\n`;
+                }
+                if (output.tags && output.tags.length > 0) {
+                    text += `**Tags:** ${output.tags.join(', ')}\n`;
+                }
+                text += '\n---\n\n';
+                text += `${output.description}\n`;
+                text += `\n\n---\n\nTo install: install_skill source: "${skillName}"`;
+                return successResult(text);
+            }
+            catch (error) {
+                if (error instanceof SkillNotFoundError) {
+                    return errorResult(`Skill "${input.name}" not found in registry.`, 'Use search_registry to find available skills.');
+                }
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(`Failed to get skill info: ${message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=skill-info.js.map

package/dist/tools/skill-info.js.map

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

package/dist/tools/uninstall-skill.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tool: uninstall_skill
+ *
+ * Removes an installed skill.
+ */
+import type { ToolHandler } from '../types.js';
+export declare function createUninstallSkillHandler(): ToolHandler;
+//# sourceMappingURL=uninstall-skill.d.ts.map

package/dist/tools/uninstall-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall-skill.d.ts","sourceRoot":"","sources":["../../src/tools/uninstall-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAyD,MAAM,aAAa,CAAC;AAGtG,wBAAgB,2BAA2B,IAAI,WAAW,CAkEzD"}

package/dist/tools/uninstall-skill.js

@@ -0,0 +1,60 @@
+/**
+ * Tool: uninstall_skill
+ *
+ * Removes an installed skill.
+ */
+import { getStore, successResult, errorResult, validateString, validateScope } from './utils.js';
+export function createUninstallSkillHandler() {
+    return {
+        name: 'uninstall_skill',
+        description: 'Uninstall a skill by name. Removes it from the specified scope.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Name of the skill to uninstall',
+                },
+                scope: {
+                    type: 'string',
+                    enum: ['local', 'global'],
+                    default: 'local',
+                    description: 'Scope to uninstall from: local (project) or global (~/.skillpkg)',
+                },
+            },
+            required: ['id'],
+        },
+        async execute(args) {
+            const input = args;
+            try {
+                const skillName = validateString(input.id, 'id');
+                const scope = validateScope(input.scope, 'local');
+                const store = getStore(scope);
+                // Check if store is initialized
+                if (!(await store.isInitialized())) {
+                    return errorResult(`No skills installed in ${scope} scope.`, 'Use list_skills to see installed skills.');
+                }
+                // Check if skill exists
+                const exists = await store.hasSkill(skillName);
+                if (!exists) {
+                    return errorResult(`Skill "${skillName}" is not installed in ${scope} scope.`, 'Use list_skills to see installed skills.');
+                }
+                // Remove the skill
+                const removed = await store.removeSkill(skillName);
+                if (!removed) {
+                    return errorResult(`Failed to uninstall skill "${skillName}".`);
+                }
+                const output = {
+                    success: true,
+                    message: `Successfully uninstalled "${skillName}" from ${scope} scope.`,
+                };
+                return successResult(output.message);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return errorResult(`Failed to uninstall skill: ${message}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=uninstall-skill.js.map

package/dist/tools/uninstall-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall-skill.js","sourceRoot":"","sources":["../../src/tools/uninstall-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjG,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;oBACzB,OAAO,EAAE,OAAO;oBAChB,WAAW,EAAE,kEAAkE;iBAChF;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;QAED,KAAK,CAAC,OAAO,CAAC,IAAa;YACzB,MAAM,KAAK,GAAG,IAA2B,CAAC;YAE1C,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAElD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAE9B,gCAAgC;gBAChC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;oBACnC,OAAO,WAAW,CAChB,0BAA0B,KAAK,SAAS,EACxC,0CAA0C,CAC3C,CAAC;gBACJ,CAAC;gBAED,wBAAwB;gBACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,WAAW,CAChB,UAAU,SAAS,yBAAyB,KAAK,SAAS,EAC1D,0CAA0C,CAC3C,CAAC;gBACJ,CAAC;gBAED,mBAAmB;gBACnB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAEnD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,WAAW,CAAC,8BAA8B,SAAS,IAAI,CAAC,CAAC;gBAClE,CAAC;gBAED,MAAM,MAAM,GAAyB;oBACnC,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,6BAA6B,SAAS,UAAU,KAAK,SAAS;iBACxE,CAAC;gBAEF,OAAO,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,WAAW,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Tool utilities - shared helpers for tool handlers
+ */
+import { type StoreManager, type RegistryClient } from 'skillpkg-core';
+import type { ToolResult, Scope } from '../types.js';
+/**
+ * Get the appropriate store based on scope
+ */
+export declare function getStore(scope: Scope, projectPath?: string): StoreManager;
+/**
+ * Get registry client
+ */
+export declare function getRegistryClient(): RegistryClient;
+/**
+ * Create a success result
+ */
+export declare function successResult(data: unknown): ToolResult;
+/**
+ * Create an error result
+ */
+export declare function errorResult(message: string, suggestion?: string): ToolResult;
+/**
+ * Validate required string parameter
+ */
+export declare function validateString(value: unknown, name: string): string;
+/**
+ * Validate optional string parameter
+ */
+export declare function validateOptionalString(value: unknown): string | undefined;
+/**
+ * Validate scope parameter
+ */
+export declare function validateScope(value: unknown, defaultValue?: Scope): Scope;
+/**
+ * Validate limit parameter
+ */
+export declare function validateLimit(value: unknown, defaultValue?: number, max?: number): number;
+/**
+ * Calculate text match score (0-1)
+ */
+export declare function calculateTextMatch(_text: string, query: string, fields: {
+    name?: string;
+    description?: string;
+    tags?: string[];
+}): number;
+/**
+ * Calculate relevance score for a skill
+ */
+export declare function calculateRelevanceScore(skill: {
+    name: string;
+    description: string;
+    tags?: string[];
+    rating?: number;
+    downloads?: number;
+    updatedAt?: string;
+}, query: string): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/tools/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,YAAY,EAEjB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAKzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAKvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAS5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQzE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,GAAE,KAAe,GAAG,KAAK,CAKlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAK,EAAE,GAAG,SAAM,GAAG,MAAM,CAKlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/D,MAAM,CAyCR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,KAAK,EAAE,MAAM,GACZ,MAAM,CA2BR"}

package/dist/tools/utils.js

@@ -0,0 +1,151 @@
+/**
+ * Tool utilities - shared helpers for tool handlers
+ */
+import { createGlobalStore, createLocalStore, createRegistryClient, } from 'skillpkg-core';
+/**
+ * Get the appropriate store based on scope
+ */
+export function getStore(scope, projectPath) {
+    if (scope === 'global') {
+        return createGlobalStore();
+    }
+    return createLocalStore(projectPath);
+}
+/**
+ * Get registry client
+ */
+export function getRegistryClient() {
+    // Use GitHub-based registry
+    return createRegistryClient({
+        registryUrl: 'https://raw.githubusercontent.com/skillpkg/registry/main',
+    });
+}
+/**
+ * Create a success result
+ */
+export function successResult(data) {
+    const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+/**
+ * Create an error result
+ */
+export function errorResult(message, suggestion) {
+    let text = `Error: ${message}`;
+    if (suggestion) {
+        text += `\n\nSuggestion: ${suggestion}`;
+    }
+    return {
+        content: [{ type: 'text', text }],
+        isError: true,
+    };
+}
+/**
+ * Validate required string parameter
+ */
+export function validateString(value, name) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`${name} is required and must be a non-empty string`);
+    }
+    return value.trim();
+}
+/**
+ * Validate optional string parameter
+ */
+export function validateOptionalString(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    return value.trim() || undefined;
+}
+/**
+ * Validate scope parameter
+ */
+export function validateScope(value, defaultValue = 'local') {
+    if (value === 'local' || value === 'global') {
+        return value;
+    }
+    return defaultValue;
+}
+/**
+ * Validate limit parameter
+ */
+export function validateLimit(value, defaultValue = 20, max = 100) {
+    if (typeof value === 'number' && value > 0) {
+        return Math.min(value, max);
+    }
+    return defaultValue;
+}
+/**
+ * Calculate text match score (0-1)
+ */
+export function calculateTextMatch(_text, query, fields) {
+    const queryLower = query.toLowerCase();
+    const words = queryLower.split(/\s+/);
+    let score = 0;
+    let maxScore = 0;
+    // Name match (highest weight)
+    if (fields.name) {
+        maxScore += 3;
+        const nameLower = fields.name.toLowerCase();
+        if (nameLower === queryLower) {
+            score += 3; // Exact match
+        }
+        else if (nameLower.includes(queryLower)) {
+            score += 2; // Contains query
+        }
+        else if (words.some((w) => nameLower.includes(w))) {
+            score += 1; // Contains word
+        }
+    }
+    // Description match
+    if (fields.description) {
+        maxScore += 2;
+        const descLower = fields.description.toLowerCase();
+        if (descLower.includes(queryLower)) {
+            score += 2;
+        }
+        else if (words.some((w) => descLower.includes(w))) {
+            score += 1;
+        }
+    }
+    // Tags match
+    if (fields.tags && fields.tags.length > 0) {
+        maxScore += 1;
+        const tagsLower = fields.tags.map((t) => t.toLowerCase());
+        if (tagsLower.some((t) => t === queryLower || words.includes(t))) {
+            score += 1;
+        }
+    }
+    return maxScore > 0 ? score / maxScore : 0;
+}
+/**
+ * Calculate relevance score for a skill
+ */
+export function calculateRelevanceScore(skill, query) {
+    // Text relevance (0-40)
+    const textRelevance = calculateTextMatch(query, query, {
+        name: skill.name,
+        description: skill.description,
+        tags: skill.tags,
+    }) * 40;
+    // Rating score (0-25)
+    const rating = skill.rating ?? 3;
+    const ratingScore = (rating / 5) * 25;
+    // Popularity score (0-20) - log scale
+    const downloads = skill.downloads ?? 0;
+    const popularityScore = Math.min(Math.log10(downloads + 1) / 4, 1) * 20;
+    // Freshness score (0-15) - decay over 180 days
+    let freshnessScore = 15;
+    if (skill.updatedAt) {
+        const daysSinceUpdate = Math.floor((Date.now() - new Date(skill.updatedAt).getTime()) / (1000 * 60 * 60 * 24));
+        freshnessScore = Math.max(0, 1 - daysSinceUpdate / 180) * 15;
+    }
+    return textRelevance + ratingScore + popularityScore + freshnessScore;
+}
+//# sourceMappingURL=utils.js.map