@salesforce/b2c-tooling-sdk 0.1.0 → 0.2.0

package/dist/esm/skills/agents.js

@@ -0,0 +1,159 @@
+/*
+ * 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';
+const home = os.homedir();
+/**
+ * IDE configurations with paths and detection logic.
+ */
+export const IDE_CONFIGS = {
+    'claude-code': {
+        id: 'claude-code',
+        displayName: 'Claude Code',
+        paths: {
+            projectDir: '.claude/skills',
+            globalDir: path.join(home, '.claude/skills'),
+        },
+        detectInstalled: async () => {
+            return fs.existsSync(path.join(home, '.claude'));
+        },
+        docsUrl: 'https://docs.anthropic.com/en/docs/claude-code',
+    },
+    cursor: {
+        id: 'cursor',
+        displayName: 'Cursor',
+        paths: {
+            projectDir: '.cursor/skills',
+            globalDir: path.join(home, '.cursor/skills'),
+        },
+        detectInstalled: async () => {
+            return fs.existsSync(path.join(home, '.cursor'));
+        },
+        docsUrl: 'https://cursor.com/docs/context/skills',
+    },
+    windsurf: {
+        id: 'windsurf',
+        displayName: 'Windsurf',
+        paths: {
+            projectDir: '.windsurf/skills',
+            globalDir: path.join(home, '.codeium/windsurf/skills'),
+        },
+        detectInstalled: async () => {
+            return fs.existsSync(path.join(home, '.codeium/windsurf'));
+        },
+        docsUrl: 'https://docs.windsurf.com/',
+    },
+    vscode: {
+        id: 'vscode',
+        displayName: 'VS Code / GitHub Copilot',
+        paths: {
+            projectDir: '.github/skills',
+            globalDir: path.join(home, '.copilot/skills'),
+        },
+        detectInstalled: async () => {
+            // Check for either .github directory (project-based) or ~/.copilot
+            return fs.existsSync(path.join(home, '.copilot'));
+        },
+        docsUrl: 'https://code.visualstudio.com/docs/copilot/customization/agent-skills',
+    },
+    codex: {
+        id: 'codex',
+        displayName: 'OpenAI Codex CLI',
+        paths: {
+            projectDir: '.codex/skills',
+            globalDir: path.join(home, '.codex/skills'),
+        },
+        detectInstalled: async () => {
+            return fs.existsSync(path.join(home, '.codex'));
+        },
+        docsUrl: 'https://github.com/openai/codex',
+    },
+    opencode: {
+        id: 'opencode',
+        displayName: 'OpenCode',
+        paths: {
+            projectDir: '.opencode/skills',
+            globalDir: path.join(home, '.config/opencode/skills'),
+        },
+        detectInstalled: async () => {
+            return fs.existsSync(path.join(home, '.config/opencode'));
+        },
+        docsUrl: 'https://opencode.ai/',
+    },
+    manual: {
+        id: 'manual',
+        displayName: 'Manual Installation',
+        paths: {
+            // Manual mode uses same paths as Claude Code
+            projectDir: '.claude/skills',
+            globalDir: path.join(home, '.claude/skills'),
+        },
+        detectInstalled: async () => {
+            // Manual is always "available" as a fallback
+            return true;
+        },
+    },
+};
+/**
+ * All supported IDE types in display order.
+ */
+export const ALL_IDE_TYPES = ['claude-code', 'cursor', 'windsurf', 'vscode', 'codex', 'opencode', 'manual'];
+/**
+ * Detect which IDEs are installed on the system.
+ *
+ * @returns Array of IDE types that appear to be installed
+ */
+export async function detectInstalledIdes() {
+    const installed = [];
+    for (const ideType of ALL_IDE_TYPES) {
+        // Skip 'manual' from auto-detection since it's always available
+        if (ideType === 'manual') {
+            continue;
+        }
+        const config = IDE_CONFIGS[ideType];
+        const isInstalled = await config.detectInstalled();
+        if (isInstalled) {
+            installed.push(ideType);
+        }
+    }
+    return installed;
+}
+/**
+ * Get the installation path for a skill.
+ *
+ * @param ide - Target IDE
+ * @param skillName - Name of the skill
+ * @param options - Installation options
+ * @returns Absolute path where the skill would be installed
+ */
+export function getSkillInstallPath(ide, skillName, options) {
+    const config = IDE_CONFIGS[ide];
+    if (options.global) {
+        return path.join(config.paths.globalDir, skillName);
+    }
+    const projectRoot = options.projectRoot || process.cwd();
+    return path.join(projectRoot, config.paths.projectDir, skillName);
+}
+/**
+ * Get the display name for an IDE.
+ *
+ * @param ide - IDE type
+ * @returns Human-readable display name
+ */
+export function getIdeDisplayName(ide) {
+    return IDE_CONFIGS[ide].displayName;
+}
+/**
+ * Get the documentation URL for an IDE.
+ *
+ * @param ide - IDE type
+ * @returns Documentation URL or undefined if not available
+ */
+export function getIdeDocsUrl(ide) {
+    return IDE_CONFIGS[ide].docsUrl;
+}
+//# sourceMappingURL=agents.js.map

package/dist/esm/skills/agents.js.map

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

package/dist/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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>;