@salesforce/b2c-tooling-sdk 0.0.0-nightly.20260120023917 → 0.0.0-nightly.20260121023856

package/dist/cjs/skills/github.d.ts

@@ -0,0 +1,47 @@
+import type { CachedArtifact, DownloadSkillsOptions, ReleaseInfo, SkillSet } from './types.js';
+/**
+ * Get the cache directory for skills.
+ * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
+ *
+ * @returns Absolute path to cache directory
+ */
+export declare function getCacheDir(): string;
+/**
+ * Fetch release information from GitHub API.
+ *
+ * @param version - 'latest' or specific version (e.g., 'v0.1.0')
+ * @returns Release information
+ * @throws Error if release not found or API request fails
+ */
+export declare function getRelease(version?: string): Promise<ReleaseInfo>;
+/**
+ * List available releases with skills artifacts.
+ *
+ * @param limit - Maximum number of releases to return (default: 10)
+ * @returns Array of release information
+ */
+export declare function listReleases(limit?: number): Promise<ReleaseInfo[]>;
+/**
+ * Get cached artifact metadata if available.
+ *
+ * @param version - Release version
+ * @param skillSet - Skill set to check
+ * @returns Cached artifact info or null if not cached
+ */
+export declare function getCachedArtifact(version: string, skillSet: SkillSet): CachedArtifact | null;
+/**
+ * Download and extract skills artifact.
+ * Uses direct download URLs to avoid GitHub API rate limits.
+ *
+ * @param skillSet - Which skill set to download ('b2c' or 'b2c-cli')
+ * @param options - Download options
+ * @returns Path to extracted skills directory
+ * @throws Error if download fails or artifact not available
+ */
+export declare function downloadSkillsArtifact(skillSet: SkillSet, options?: DownloadSkillsOptions): Promise<string>;
+/**
+ * Clear the skills cache.
+ *
+ * @param version - Optional specific version to clear (default: all)
+ */
+export declare function clearCache(version?: string): Promise<void>;

package/dist/cjs/skills/github.js

@@ -0,0 +1,246 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { getLogger } from '../logging/logger.js';
+const GITHUB_REPO = 'SalesforceCommerceCloud/b2c-developer-tooling';
+const GITHUB_API_BASE = 'https://api.github.com';
+const GITHUB_DOWNLOAD_BASE = 'https://github.com';
+/**
+ * Asset filename patterns for skill archives.
+ */
+const ASSET_NAMES = {
+    b2c: 'b2c-skills.zip',
+    'b2c-cli': 'b2c-cli-skills.zip',
+};
+/**
+ * Build direct download URL for a release asset.
+ * These URLs don't require API calls and avoid rate limiting.
+ *
+ * @param version - 'latest' or specific version tag
+ * @param assetName - Name of the asset file
+ * @returns Direct download URL
+ */
+function getDirectDownloadUrl(version, assetName) {
+    if (version === 'latest') {
+        return `${GITHUB_DOWNLOAD_BASE}/${GITHUB_REPO}/releases/latest/download/${assetName}`;
+    }
+    const tag = version.startsWith('v') ? version : `v${version}`;
+    return `${GITHUB_DOWNLOAD_BASE}/${GITHUB_REPO}/releases/download/${tag}/${assetName}`;
+}
+/**
+ * Get the cache directory for skills.
+ * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
+ *
+ * @returns Absolute path to cache directory
+ */
+export function getCacheDir() {
+    const xdgCache = process.env.XDG_CACHE_HOME;
+    const baseCache = xdgCache || path.join(os.homedir(), '.cache');
+    return path.join(baseCache, 'b2c-cli', 'skills');
+}
+/**
+ * Parse GitHub API release response into ReleaseInfo.
+ */
+function parseRelease(release) {
+    const b2cAsset = release.assets.find((a) => a.name === ASSET_NAMES['b2c']);
+    const b2cCliAsset = release.assets.find((a) => a.name === ASSET_NAMES['b2c-cli']);
+    return {
+        tagName: release.tag_name,
+        version: release.tag_name.replace(/^v/, ''),
+        publishedAt: release.published_at,
+        b2cSkillsAssetUrl: b2cAsset?.browser_download_url ?? null,
+        b2cCliSkillsAssetUrl: b2cCliAsset?.browser_download_url ?? null,
+    };
+}
+/**
+ * Fetch release information from GitHub API.
+ *
+ * @param version - 'latest' or specific version (e.g., 'v0.1.0')
+ * @returns Release information
+ * @throws Error if release not found or API request fails
+ */
+export async function getRelease(version = 'latest') {
+    const logger = getLogger();
+    const endpoint = version === 'latest'
+        ? `${GITHUB_API_BASE}/repos/${GITHUB_REPO}/releases/latest`
+        : `${GITHUB_API_BASE}/repos/${GITHUB_REPO}/releases/tags/${version.startsWith('v') ? version : `v${version}`}`;
+    logger.debug({ endpoint }, 'Fetching release info');
+    const response = await fetch(endpoint, {
+        headers: {
+            Accept: 'application/vnd.github.v3+json',
+            'User-Agent': 'b2c-cli',
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Release not found: ${version}`);
+        }
+        throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return parseRelease(data);
+}
+/**
+ * List available releases with skills artifacts.
+ *
+ * @param limit - Maximum number of releases to return (default: 10)
+ * @returns Array of release information
+ */
+export async function listReleases(limit = 10) {
+    const logger = getLogger();
+    const endpoint = `${GITHUB_API_BASE}/repos/${GITHUB_REPO}/releases?per_page=${limit}`;
+    logger.debug({ endpoint }, 'Listing releases');
+    const response = await fetch(endpoint, {
+        headers: {
+            Accept: 'application/vnd.github.v3+json',
+            'User-Agent': 'b2c-cli',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    // Only return releases that have at least one skills artifact
+    return data.map(parseRelease).filter((r) => r.b2cSkillsAssetUrl || r.b2cCliSkillsAssetUrl);
+}
+/**
+ * Get cached artifact metadata if available.
+ *
+ * @param version - Release version
+ * @param skillSet - Skill set to check
+ * @returns Cached artifact info or null if not cached
+ */
+export function getCachedArtifact(version, skillSet) {
+    const cacheDir = getCacheDir();
+    const manifestPath = path.join(cacheDir, version, skillSet, 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract version tag from a GitHub release download URL.
+ * URLs follow pattern: .../releases/download/{tag}/...
+ *
+ * @param url - The final URL after redirects
+ * @returns Version tag or null if not found
+ */
+function extractVersionFromUrl(url) {
+    const match = url.match(/\/releases\/download\/([^/]+)\//);
+    return match ? match[1] : null;
+}
+/**
+ * Download and extract skills artifact.
+ * Uses direct download URLs to avoid GitHub API rate limits.
+ *
+ * @param skillSet - Which skill set to download ('b2c' or 'b2c-cli')
+ * @param options - Download options
+ * @returns Path to extracted skills directory
+ * @throws Error if download fails or artifact not available
+ */
+export async function downloadSkillsArtifact(skillSet, options = {}) {
+    const logger = getLogger();
+    const { version = 'latest', forceDownload = false } = options;
+    const assetName = ASSET_NAMES[skillSet];
+    // For specific versions, check cache first (before any network calls)
+    if (version !== 'latest' && !forceDownload) {
+        const versionTag = version.startsWith('v') ? version : `v${version}`;
+        const cached = getCachedArtifact(versionTag, skillSet);
+        if (cached && fs.existsSync(cached.path)) {
+            logger.debug({ version: versionTag, skillSet, path: cached.path }, 'Using cached skills');
+            return cached.path;
+        }
+    }
+    // Build direct download URL (avoids API rate limits)
+    const downloadUrl = getDirectDownloadUrl(version, assetName);
+    logger.debug({ url: downloadUrl, skillSet }, 'Downloading skills artifact');
+    // Download artifact - GitHub will redirect to the actual file
+    const response = await fetch(downloadUrl, {
+        headers: {
+            'User-Agent': 'b2c-cli',
+        },
+        redirect: 'follow',
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Skills artifact '${assetName}' not found for ${version === 'latest' ? 'latest release' : `version ${version}`}`);
+        }
+        throw new Error(`Failed to download skills: ${response.status} ${response.statusText}`);
+    }
+    // Extract actual version from the final URL (after redirects)
+    const actualVersion = extractVersionFromUrl(response.url) || version;
+    // Check cache for the resolved version (for 'latest' which we now know)
+    if (version === 'latest' && !forceDownload) {
+        const cached = getCachedArtifact(actualVersion, skillSet);
+        if (cached && fs.existsSync(cached.path)) {
+            logger.debug({ version: actualVersion, skillSet, path: cached.path }, 'Using cached skills (resolved latest)');
+            return cached.path;
+        }
+    }
+    const zipBuffer = Buffer.from(await response.arrayBuffer());
+    logger.debug({ size: zipBuffer.length, version: actualVersion }, 'Downloaded skills archive');
+    // Extract to cache directory
+    const cacheDir = options.cacheDir || getCacheDir();
+    const extractDir = path.join(cacheDir, actualVersion, skillSet);
+    // Clean existing extraction if present
+    if (fs.existsSync(extractDir)) {
+        await fs.promises.rm(extractDir, { recursive: true });
+    }
+    await fs.promises.mkdir(extractDir, { recursive: true });
+    // Extract zip contents
+    const zip = await JSZip.loadAsync(zipBuffer);
+    let extractedCount = 0;
+    for (const [relativePath, zipEntry] of Object.entries(zip.files)) {
+        if (zipEntry.dir) {
+            await fs.promises.mkdir(path.join(extractDir, relativePath), { recursive: true });
+            continue;
+        }
+        const targetPath = path.join(extractDir, relativePath);
+        const targetDir = path.dirname(targetPath);
+        // Ensure parent directory exists
+        await fs.promises.mkdir(targetDir, { recursive: true });
+        // Write file
+        const content = await zipEntry.async('nodebuffer');
+        await fs.promises.writeFile(targetPath, content);
+        extractedCount++;
+    }
+    logger.debug({ extractDir, fileCount: extractedCount }, 'Extracted skills');
+    // Write cache manifest
+    const manifest = {
+        version: actualVersion,
+        path: extractDir,
+        downloadedAt: new Date().toISOString(),
+    };
+    await fs.promises.writeFile(path.join(extractDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    return extractDir;
+}
+/**
+ * Clear the skills cache.
+ *
+ * @param version - Optional specific version to clear (default: all)
+ */
+export async function clearCache(version) {
+    const cacheDir = getCacheDir();
+    if (version) {
+        const versionDir = path.join(cacheDir, version);
+        if (fs.existsSync(versionDir)) {
+            await fs.promises.rm(versionDir, { recursive: true });
+        }
+    }
+    else if (fs.existsSync(cacheDir)) {
+        await fs.promises.rm(cacheDir, { recursive: true });
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/cjs/skills/github.js.map

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

package/dist/cjs/skills/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Skills management module for downloading and installing agent skills.
+ *
+ * This module provides functionality to:
+ * - Download skills artifacts from GitHub releases
+ * - Detect installed IDEs
+ * - Install skills to various IDE configurations
+ * - Manage skills cache
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   downloadSkillsArtifact,
+ *   scanSkills,
+ *   installSkills,
+ *   detectInstalledIdes,
+ * } from '@salesforce/b2c-tooling-sdk/skills';
+ *
+ * // Download and extract skills
+ * const skillsDir = await downloadSkillsArtifact('b2c');
+ *
+ * // Scan for available skills
+ * const skills = await scanSkills(skillsDir, 'b2c');
+ *
+ * // Detect installed IDEs
+ * const ides = await detectInstalledIdes();
+ *
+ * // Install skills
+ * const result = await installSkills(skills, skillsDir, {
+ *   ides: ['cursor'],
+ *   global: true,
+ *   update: false,
+ * });
+ * ```
+ *
+ * @module skills
+ */
+export type { IdeType, SkillSet, IdePaths, IdeConfig, SkillMetadata, ReleaseInfo, DownloadSkillsOptions, InstallSkillsOptions, SkillInstallation, SkillSkipped, SkillError, InstallSkillsResult, CachedArtifact, } from './types.js';
+export { IDE_CONFIGS, ALL_IDE_TYPES, detectInstalledIdes, getSkillInstallPath, getIdeDisplayName, getIdeDocsUrl, } from './agents.js';
+export { getCacheDir, getRelease, listReleases, getCachedArtifact, downloadSkillsArtifact, clearCache, } from './github.js';
+export { parseSkillFrontmatter, scanSkills, filterSkillsByName, findSkillsByName } from './parser.js';
+export { isSkillInstalled, installSkills, removeSkill } from './installer.js';

package/dist/cjs/skills/index.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+// Agent/IDE utilities
+export { IDE_CONFIGS, ALL_IDE_TYPES, detectInstalledIdes, getSkillInstallPath, getIdeDisplayName, getIdeDocsUrl, } from './agents.js';
+// GitHub/download utilities
+export { getCacheDir, getRelease, listReleases, getCachedArtifact, downloadSkillsArtifact, clearCache, } from './github.js';
+// Skill parsing
+export { parseSkillFrontmatter, scanSkills, filterSkillsByName, findSkillsByName } from './parser.js';
+// Installation
+export { isSkillInstalled, installSkills, removeSkill } from './installer.js';
+//# sourceMappingURL=index.js.map

package/dist/cjs/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyDH,sBAAsB;AACtB,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAAC,qBAAqB,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAEpG,eAAe;AACf,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/cjs/skills/installer.d.ts

@@ -0,0 +1,34 @@
+import type { IdeType, InstallSkillsOptions, InstallSkillsResult, SkillMetadata } from './types.js';
+/**
+ * Check if a skill is already installed.
+ *
+ * @param skillName - Name of the skill
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if skill is installed, false otherwise
+ */
+export declare function isSkillInstalled(skillName: string, ide: IdeType, options: {
+    global: boolean;
+    projectRoot?: string;
+}): boolean;
+/**
+ * Install skills to target IDE directories.
+ *
+ * @param skills - Skills to install
+ * @param sourceDir - Directory containing extracted skills
+ * @param options - Installation options
+ * @returns Installation results
+ */
+export declare function installSkills(skills: SkillMetadata[], sourceDir: string, options: InstallSkillsOptions): Promise<InstallSkillsResult>;
+/**
+ * Remove an installed skill.
+ *
+ * @param skillName - Name of the skill to remove
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if removed, false if not found
+ */
+export declare function removeSkill(skillName: string, ide: IdeType, options: {
+    global: boolean;
+    projectRoot?: string;
+}): Promise<boolean>;

package/dist/cjs/skills/installer.js

@@ -0,0 +1,181 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getSkillInstallPath } from './agents.js';
+import { getLogger } from '../logging/logger.js';
+/**
+ * Sanitize a skill name to prevent path traversal attacks.
+ *
+ * @param name - Skill name to sanitize
+ * @returns Sanitized name safe for use in file paths
+ */
+function sanitizeName(name) {
+    // Remove path separators and null bytes
+    let sanitized = name.replace(/[/\\:\0]/g, '');
+    // Remove leading/trailing dots and spaces
+    sanitized = sanitized.replace(/^[.\s]+|[.\s]+$/g, '');
+    // Limit length
+    if (sanitized.length > 255) {
+        sanitized = sanitized.slice(0, 255);
+    }
+    return sanitized;
+}
+/**
+ * Validate that a path is safely within a base directory.
+ *
+ * @param targetPath - Path to validate
+ * @param baseDir - Base directory that must contain targetPath
+ * @returns true if path is safe, false otherwise
+ */
+function isPathSafe(targetPath, baseDir) {
+    const resolvedTarget = path.resolve(targetPath);
+    const resolvedBase = path.resolve(baseDir);
+    // Ensure the target is within the base directory
+    return resolvedTarget.startsWith(resolvedBase + path.sep) || resolvedTarget === resolvedBase;
+}
+/**
+ * Recursively copy a directory.
+ *
+ * @param source - Source directory
+ * @param target - Target directory
+ */
+async function copyDirectory(source, target) {
+    const logger = getLogger();
+    let fileCount = 0;
+    await fs.promises.mkdir(target, { recursive: true });
+    const entries = await fs.promises.readdir(source, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourcePath = path.join(source, entry.name);
+        const targetPath = path.join(target, entry.name);
+        if (entry.isDirectory()) {
+            fileCount += await copyDirectory(sourcePath, targetPath);
+        }
+        else if (entry.isFile()) {
+            await fs.promises.copyFile(sourcePath, targetPath);
+            fileCount++;
+        }
+        // Skip symlinks and other special files for security
+    }
+    logger.debug({ source, target, fileCount }, 'Copied directory');
+    return fileCount;
+}
+/**
+ * Check if a skill is already installed.
+ *
+ * @param skillName - Name of the skill
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if skill is installed, false otherwise
+ */
+export function isSkillInstalled(skillName, ide, options) {
+    const installPath = getSkillInstallPath(ide, skillName, options);
+    return fs.existsSync(installPath);
+}
+/**
+ * Install skills to target IDE directories.
+ *
+ * @param skills - Skills to install
+ * @param sourceDir - Directory containing extracted skills
+ * @param options - Installation options
+ * @returns Installation results
+ */
+export async function installSkills(skills, sourceDir, options) {
+    const logger = getLogger();
+    const result = {
+        installed: [],
+        skipped: [],
+        errors: [],
+    };
+    for (const skill of skills) {
+        const sanitizedName = sanitizeName(skill.name);
+        if (sanitizedName !== skill.name) {
+            logger.warn({ original: skill.name, sanitized: sanitizedName }, 'Skill name was sanitized');
+        }
+        // Source path: sourceDir/skills/skill-path/
+        const sourcePath = path.join(sourceDir, 'skills', skill.path);
+        if (!fs.existsSync(sourcePath)) {
+            for (const ide of options.ides) {
+                result.errors.push({
+                    skill: skill.name,
+                    ide,
+                    error: `Source directory not found: ${sourcePath}`,
+                });
+            }
+            continue;
+        }
+        for (const ide of options.ides) {
+            try {
+                const targetPath = getSkillInstallPath(ide, sanitizedName, {
+                    global: options.global,
+                    projectRoot: options.projectRoot,
+                });
+                // Get the base directory for path safety validation
+                const baseDir = path.dirname(targetPath);
+                // Validate path safety
+                if (!isPathSafe(targetPath, baseDir)) {
+                    result.errors.push({
+                        skill: skill.name,
+                        ide,
+                        error: 'Path validation failed: potential directory traversal',
+                    });
+                    continue;
+                }
+                // Check if already installed
+                if (fs.existsSync(targetPath)) {
+                    if (!options.update) {
+                        result.skipped.push({
+                            skill: skill.name,
+                            ide,
+                            reason: 'Already installed (use --update to overwrite)',
+                        });
+                        continue;
+                    }
+                    // Remove existing for update
+                    await fs.promises.rm(targetPath, { recursive: true });
+                }
+                // Copy skill directory
+                await copyDirectory(sourcePath, targetPath);
+                result.installed.push({
+                    skill: skill.name,
+                    ide,
+                    path: targetPath,
+                });
+            }
+            catch (error) {
+                result.errors.push({
+                    skill: skill.name,
+                    ide,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    logger.debug({
+        installed: result.installed.length,
+        skipped: result.skipped.length,
+        errors: result.errors.length,
+    }, 'Installation complete');
+    return result;
+}
+/**
+ * Remove an installed skill.
+ *
+ * @param skillName - Name of the skill to remove
+ * @param ide - Target IDE
+ * @param options - Installation options
+ * @returns true if removed, false if not found
+ */
+export async function removeSkill(skillName, ide, options) {
+    const sanitizedName = sanitizeName(skillName);
+    const installPath = getSkillInstallPath(ide, sanitizedName, options);
+    if (!fs.existsSync(installPath)) {
+        return false;
+    }
+    await fs.promises.rm(installPath, { recursive: true });
+    return true;
+}
+//# sourceMappingURL=installer.js.map

package/dist/cjs/skills/installer.js.map

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

package/dist/cjs/skills/parser.d.ts

@@ -0,0 +1,39 @@
+import type { SkillMetadata, SkillSet } from './types.js';
+/**
+ * Parse simple YAML-like frontmatter from SKILL.md content.
+ * Only supports basic key: value pairs (name and description).
+ *
+ * @param content - File content with frontmatter
+ * @returns Parsed frontmatter or null if invalid
+ */
+export declare function parseSkillFrontmatter(content: string): {
+    name: string;
+    description: string;
+} | null;
+/**
+ * Scan a directory for skills and extract their metadata.
+ *
+ * @param skillsDir - Path to extracted skills directory (e.g., ~/.cache/b2c-cli/skills/v0.1.0/b2c/skills/)
+ * @param skillSet - The skill set being scanned ('b2c' or 'b2c-cli')
+ * @returns Array of skill metadata
+ */
+export declare function scanSkills(skillsDir: string, skillSet: SkillSet): Promise<SkillMetadata[]>;
+/**
+ * Filter skills by name.
+ *
+ * @param skills - All available skills
+ * @param names - Skill names to include (if provided)
+ * @returns Filtered skills
+ */
+export declare function filterSkillsByName(skills: SkillMetadata[], names?: string[]): SkillMetadata[];
+/**
+ * Find skills that match the given names, returning any that weren't found.
+ *
+ * @param skills - Available skills
+ * @param names - Requested skill names
+ * @returns Object with matched skills and names not found
+ */
+export declare function findSkillsByName(skills: SkillMetadata[], names: string[]): {
+    found: SkillMetadata[];
+    notFound: string[];
+};