devchain-cli 0.8.5 → 0.9.1

package/dist/server/modules/skills/adapters/github-skill-source.base.js

@@ -0,0 +1,382 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubSkillSourceBase = void 0;
+const node_fs_1 = require("node:fs");
+const fs = __importStar(require("node:fs/promises"));
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const tar = __importStar(require("tar"));
+const error_types_1 = require("../../../common/errors/error-types");
+const logger_1 = require("../../../common/logging/logger");
+const logger = (0, logger_1.createLogger)('GitHubSkillSourceBase');
+const DEFAULT_BRANCH = 'main';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_USER_AGENT = 'devchain-skills-sync';
+const DEFAULT_SKILLS_ROOT = (0, node_path_1.join)((0, node_os_1.homedir)(), '.devchain', 'skills');
+const CONTROL_CHAR_REGEX = /[\u0000-\u001f\u007f]/;
+const SAFE_SKILL_SEGMENT_REGEX = /^[A-Za-z0-9_-]+$/;
+class GitHubSkillSourceBase {
+    constructor(config = {}) {
+        this.sourceName = config.sourceName ?? 'unknown';
+        this.repoOwner = config.repoOwner ?? '';
+        this.repoName = config.repoName ?? '';
+        this.branch = config.branch ?? DEFAULT_BRANCH;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.userAgent = config.userAgent ?? DEFAULT_USER_AGENT;
+        this.storageRootDir = config.storageRootDir ?? DEFAULT_SKILLS_ROOT;
+        this.githubToken = config.githubToken ?? process.env.GITHUB_TOKEN ?? null;
+        this.repoUrl =
+            this.repoOwner && this.repoName
+                ? `https://github.com/${this.repoOwner}/${this.repoName}`
+                : 'https://github.com';
+    }
+    async downloadSkill(skillName, targetPath) {
+        const context = await this.prepareExtractedRepository();
+        try {
+            return await this.downloadSkillFromExtractedRepo(skillName, targetPath, context.extractedRepoRoot);
+        }
+        finally {
+            await context.dispose();
+        }
+    }
+    async getLatestCommit() {
+        this.ensureRepoConfigured();
+        const endpoint = `https://api.github.com/repos/${this.repoOwner}/${this.repoName}/commits/${encodeURIComponent(this.branch)}`;
+        const response = await this.fetchWithTimeout(endpoint);
+        if (!response.ok) {
+            throw new error_types_1.StorageError('Failed to fetch latest GitHub commit for skill source.', {
+                sourceName: this.sourceName,
+                repoOwner: this.repoOwner,
+                repoName: this.repoName,
+                branch: this.branch,
+                status: response.status,
+            });
+        }
+        const payload = (await response.json());
+        if (typeof payload.sha !== 'string' || payload.sha.length === 0) {
+            throw new error_types_1.StorageError('GitHub commit response did not include a valid SHA.', {
+                sourceName: this.sourceName,
+                repoOwner: this.repoOwner,
+                repoName: this.repoName,
+                branch: this.branch,
+            });
+        }
+        return payload.sha;
+    }
+    async parseSkillMarkdown(skillDirectory) {
+        const safeSkillDirectory = (0, node_path_1.resolve)(skillDirectory);
+        const skillMdPath = (0, node_path_1.join)(safeSkillDirectory, 'SKILL.md');
+        let markdown;
+        try {
+            markdown = await fs.readFile(skillMdPath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                logger.warn({ sourceName: this.sourceName, skillMdPath }, 'SKILL.md not found for skill');
+                return null;
+            }
+            throw this.wrapStorageError('Failed reading SKILL.md for skill.', error, {
+                sourceName: this.sourceName,
+                skillMdPath,
+            });
+        }
+        try {
+            const parsed = (0, gray_matter_1.default)(markdown);
+            const frontmatter = parsed.data && typeof parsed.data === 'object'
+                ? parsed.data
+                : {};
+            return {
+                frontmatter,
+                instructionContent: parsed.content,
+            };
+        }
+        catch (error) {
+            logger.warn({
+                sourceName: this.sourceName,
+                skillMdPath,
+                error: error instanceof Error ? error.message : String(error),
+            }, 'Failed to parse SKILL.md frontmatter for skill. Skipping malformed file.');
+            return null;
+        }
+    }
+    getSkillStorageRoot() {
+        return (0, node_path_1.resolve)(this.storageRootDir);
+    }
+    validatePathSegment(segment, fieldName) {
+        const trimmed = segment.trim();
+        if (!trimmed) {
+            throw new error_types_1.ValidationError(`Invalid ${fieldName}: value cannot be empty.`, { fieldName });
+        }
+        if (trimmed.includes('..') ||
+            trimmed.includes('/') ||
+            trimmed.includes('\\') ||
+            CONTROL_CHAR_REGEX.test(trimmed)) {
+            throw new error_types_1.ValidationError(`Invalid ${fieldName}: path traversal or control characters are not allowed.`, { fieldName, segment: trimmed });
+        }
+        if (!SAFE_SKILL_SEGMENT_REGEX.test(trimmed)) {
+            throw new error_types_1.ValidationError(`Invalid ${fieldName}: only alphanumeric characters, underscores, and hyphens are allowed.`, { fieldName, segment: trimmed });
+        }
+        return trimmed;
+    }
+    pickString(frontmatter, keys) {
+        for (const key of keys) {
+            const value = this.toStringValue(frontmatter[key]);
+            if (value) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+    pickStringArray(frontmatter, keys) {
+        for (const key of keys) {
+            const value = frontmatter[key];
+            if (!Array.isArray(value)) {
+                continue;
+            }
+            const items = value
+                .filter((item) => typeof item === 'string')
+                .map((item) => item.trim())
+                .filter((item) => item.length > 0);
+            if (items.length > 0) {
+                return items;
+            }
+        }
+        return [];
+    }
+    toStringValue(value) {
+        if (typeof value === 'string' && value.trim().length > 0) {
+            return value.trim();
+        }
+        if (Array.isArray(value)) {
+            const items = value
+                .filter((item) => typeof item === 'string')
+                .map((item) => item.trim())
+                .filter((item) => item.length > 0);
+            if (items.length > 0) {
+                return items.join(', ');
+            }
+        }
+        return undefined;
+    }
+    async resolveSkillDirectory(extractedRepoRoot, skillName) {
+        const candidates = [
+            (0, node_path_1.join)(extractedRepoRoot, skillName),
+            (0, node_path_1.join)(extractedRepoRoot, 'skills', skillName),
+            (0, node_path_1.join)(extractedRepoRoot, 'library', skillName),
+        ];
+        for (const candidate of candidates) {
+            try {
+                const stats = await fs.stat(candidate);
+                if (stats.isDirectory()) {
+                    return candidate;
+                }
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT') {
+                    throw this.wrapStorageError('Failed checking extracted skill directory.', error, {
+                        candidate,
+                        sourceName: this.sourceName,
+                        skillName,
+                    });
+                }
+            }
+        }
+        throw new error_types_1.StorageError('Skill directory was not found in extracted repository tarball.', {
+            sourceName: this.sourceName,
+            skillName,
+            extractedRepoRoot,
+        });
+    }
+    async prepareExtractedRepository() {
+        this.ensureRepoConfigured();
+        const safeSourceName = this.validatePathSegment(this.sourceName, 'sourceName');
+        const tempRoot = await fs.mkdtemp((0, node_path_1.join)((0, node_os_1.tmpdir)(), `skills-${safeSourceName}-`));
+        const archivePath = (0, node_path_1.join)(tempRoot, 'repo.tar.gz');
+        const extractPath = (0, node_path_1.join)(tempRoot, 'repo');
+        let disposed = false;
+        const dispose = async () => {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            await this.cleanupTempDirectory(tempRoot);
+        };
+        try {
+            await fs.mkdir(extractPath, { recursive: true });
+            await this.downloadTarball(archivePath);
+            await tar.x({
+                file: archivePath,
+                cwd: extractPath,
+                strip: 1,
+                strict: true,
+            });
+            return {
+                extractedRepoRoot: extractPath,
+                dispose,
+            };
+        }
+        catch (error) {
+            await dispose();
+            throw this.wrapStorageError('Failed to download and extract skills repository.', error, {
+                sourceName: safeSourceName,
+            });
+        }
+    }
+    async downloadSkillFromExtractedRepo(skillName, targetPath, extractedRepoRoot) {
+        this.ensureRepoConfigured();
+        const safeSourceName = this.validatePathSegment(this.sourceName, 'sourceName');
+        const safeSkillName = this.validatePathSegment(skillName, 'skillName');
+        const storageRoot = typeof targetPath === 'string' && targetPath.trim().length > 0
+            ? (0, node_path_1.resolve)(targetPath)
+            : (0, node_path_1.resolve)(this.storageRootDir);
+        const sourceRoot = (0, node_path_1.resolve)(storageRoot, safeSourceName);
+        const destinationPath = (0, node_path_1.resolve)(sourceRoot, safeSkillName);
+        if (!destinationPath.startsWith(`${sourceRoot}${node_path_1.sep}`)) {
+            throw new error_types_1.ValidationError('Resolved skill destination path is outside the source directory.', {
+                sourceRoot,
+                destinationPath,
+            });
+        }
+        try {
+            const resolvedSkillPath = await this.resolveSkillDirectory((0, node_path_1.resolve)(extractedRepoRoot), safeSkillName);
+            await fs.mkdir(sourceRoot, { recursive: true });
+            await fs.rm(destinationPath, { recursive: true, force: true });
+            await fs.cp(resolvedSkillPath, destinationPath, { recursive: true, force: true });
+            return destinationPath;
+        }
+        catch (error) {
+            throw this.wrapStorageError('Failed to copy skill from extracted repository.', error, {
+                sourceName: safeSourceName,
+                skillName: safeSkillName,
+            });
+        }
+    }
+    ensureRepoConfigured() {
+        if (!this.repoOwner || !this.repoName) {
+            throw new error_types_1.ValidationError('GitHub skill source adapter is missing repository configuration.', { sourceName: this.sourceName });
+        }
+    }
+    getTarballUrl() {
+        return `https://api.github.com/repos/${this.repoOwner}/${this.repoName}/tarball/${encodeURIComponent(this.branch)}`;
+    }
+    buildGitHubHeaders() {
+        const headers = {
+            Accept: 'application/vnd.github+json',
+            'User-Agent': this.userAgent,
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+        if (this.githubToken) {
+            headers.Authorization = `Bearer ${this.githubToken}`;
+        }
+        return headers;
+    }
+    async downloadTarball(destinationPath) {
+        const response = await this.fetchWithTimeout(this.getTarballUrl());
+        if (!response.ok || !response.body) {
+            throw new error_types_1.StorageError('Failed to download GitHub tarball for skill source.', {
+                sourceName: this.sourceName,
+                repoOwner: this.repoOwner,
+                repoName: this.repoName,
+                branch: this.branch,
+                status: response.status,
+            });
+        }
+        await fs.mkdir((0, node_path_1.dirname)(destinationPath), { recursive: true });
+        const writeStream = (0, node_fs_1.createWriteStream)(destinationPath);
+        const bodyStream = node_stream_1.Readable.fromWeb(response.body);
+        await (0, promises_1.pipeline)(bodyStream, writeStream);
+    }
+    async fetchWithTimeout(url) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            return await fetch(url, {
+                signal: controller.signal,
+                headers: this.buildGitHubHeaders(),
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new error_types_1.TimeoutError('GitHub skill source request timed out.', {
+                    sourceName: this.sourceName,
+                    timeoutMs: this.timeoutMs,
+                    url,
+                });
+            }
+            throw this.wrapStorageError('GitHub skill source request failed.', error, {
+                sourceName: this.sourceName,
+                url,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async cleanupTempDirectory(tempRoot) {
+        try {
+            await fs.rm(tempRoot, { recursive: true, force: true });
+        }
+        catch (cleanupError) {
+            logger.warn({
+                tempRoot,
+                error: cleanupError instanceof Error ? cleanupError.message : String(cleanupError),
+            }, 'Failed to cleanup temporary GitHub skill directory');
+        }
+    }
+    wrapStorageError(message, error, details) {
+        if (error instanceof error_types_1.StorageError) {
+            return error;
+        }
+        if (error instanceof error_types_1.ValidationError) {
+            throw error;
+        }
+        if (error instanceof error_types_1.TimeoutError) {
+            throw error;
+        }
+        return new error_types_1.StorageError(message, {
+            ...details,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+exports.GitHubSkillSourceBase = GitHubSkillSourceBase;
+//# sourceMappingURL=github-skill-source.base.js.map

package/dist/server/modules/skills/adapters/github-skill-source.base.js.map

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

package/dist/server/modules/skills/adapters/microsoft-skill-source.adapter.d.ts

@@ -0,0 +1,11 @@
+import { GitHubSkillSourceBase } from './github-skill-source.base';
+import { SkillManifest, SkillSourceAdapter, SkillSourceSyncContext } from './skill-source.adapter';
+export declare class MicrosoftSkillSource extends GitHubSkillSourceBase implements SkillSourceAdapter {
+    constructor();
+    listSkills(): Promise<Map<string, SkillManifest>>;
+    createSyncContext(): Promise<SkillSourceSyncContext>;
+    protected resolveSkillDirectory(extractedRepoRoot: string, skillName: string): Promise<string>;
+    private listSkillNamesFromExtractedRepo;
+    private parseSkillMarkdownWithFallback;
+    private toSkillManifest;
+}

package/dist/server/modules/skills/adapters/microsoft-skill-source.adapter.js

@@ -0,0 +1,227 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftSkillSource = void 0;
+const node_path_1 = require("node:path");
+const common_1 = require("@nestjs/common");
+const fs = __importStar(require("node:fs/promises"));
+const error_types_1 = require("../../../common/errors/error-types");
+const logger_1 = require("../../../common/logging/logger");
+const github_skill_source_base_1 = require("./github-skill-source.base");
+const logger = (0, logger_1.createLogger)('MicrosoftSkillSource');
+const SKILLS_DIRECTORY = '.github/skills';
+let MicrosoftSkillSource = class MicrosoftSkillSource extends github_skill_source_base_1.GitHubSkillSourceBase {
+    constructor() {
+        super({
+            sourceName: 'microsoft',
+            repoOwner: 'microsoft',
+            repoName: 'skills',
+            timeoutMs: 90_000,
+        });
+    }
+    async listSkills() {
+        const context = await this.createSyncContext();
+        try {
+            return new Map(context.manifests);
+        }
+        finally {
+            await context.dispose();
+        }
+    }
+    async createSyncContext() {
+        const repoContext = await this.prepareExtractedRepository();
+        const manifests = new Map();
+        let disposed = false;
+        const dispose = async () => {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            await repoContext.dispose();
+        };
+        try {
+            const skillNames = await this.listSkillNamesFromExtractedRepo(repoContext.extractedRepoRoot);
+            for (const skillName of skillNames) {
+                try {
+                    const skillDirectory = await this.resolveSkillDirectory(repoContext.extractedRepoRoot, skillName);
+                    const parsedSkill = await this.parseSkillMarkdownWithFallback(skillDirectory);
+                    if (!parsedSkill) {
+                        continue;
+                    }
+                    manifests.set(skillName, this.toSkillManifest(skillName, parsedSkill));
+                }
+                catch (error) {
+                    logger.warn({
+                        sourceName: this.sourceName,
+                        skillName,
+                        error: error instanceof Error ? error.message : String(error),
+                    }, 'Failed processing Microsoft skill. Skipping.');
+                }
+            }
+            return {
+                manifests,
+                downloadSkill: async (skillName, targetPath) => this.downloadSkillFromExtractedRepo(skillName, targetPath, repoContext.extractedRepoRoot),
+                dispose,
+            };
+        }
+        catch (error) {
+            await dispose();
+            throw error;
+        }
+    }
+    async resolveSkillDirectory(extractedRepoRoot, skillName) {
+        const skillDirectory = (0, node_path_1.join)(extractedRepoRoot, SKILLS_DIRECTORY, skillName);
+        try {
+            const stats = await fs.stat(skillDirectory);
+            if (stats.isDirectory()) {
+                return skillDirectory;
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw new error_types_1.StorageError('Failed checking extracted Microsoft skill directory.', {
+                    sourceName: this.sourceName,
+                    skillName,
+                    skillDirectory,
+                    cause: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        throw new error_types_1.StorageError('Microsoft skill directory not found in repository archive.', {
+            sourceName: this.sourceName,
+            skillName,
+            skillDirectory,
+        });
+    }
+    async listSkillNamesFromExtractedRepo(extractedRepoRoot) {
+        const skillsRoot = (0, node_path_1.join)(extractedRepoRoot, SKILLS_DIRECTORY);
+        let entries;
+        try {
+            entries = await fs.readdir(skillsRoot, { withFileTypes: true });
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new error_types_1.StorageError('Microsoft skills directory not found in repository archive.', {
+                    sourceName: this.sourceName,
+                    skillsRoot,
+                });
+            }
+            throw new error_types_1.StorageError('Failed reading Microsoft skills directory in archive.', {
+                sourceName: this.sourceName,
+                skillsRoot,
+                cause: error instanceof Error ? error.message : String(error),
+            });
+        }
+        const skillNames = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('.')) {
+                continue;
+            }
+            try {
+                skillNames.push(this.validatePathSegment(entry.name, 'skillName'));
+            }
+            catch {
+                logger.warn({ sourceName: this.sourceName, skillName: entry.name }, 'Skipping Microsoft skill directory with invalid name.');
+            }
+        }
+        return skillNames.sort((left, right) => left.localeCompare(right));
+    }
+    async parseSkillMarkdownWithFallback(skillDirectory) {
+        const parsed = await this.parseSkillMarkdown(skillDirectory);
+        if (parsed) {
+            return parsed;
+        }
+        const skillMarkdownPath = (0, node_path_1.join)(skillDirectory, 'SKILL.md');
+        try {
+            const markdown = await fs.readFile(skillMarkdownPath, 'utf-8');
+            return {
+                frontmatter: {},
+                instructionContent: markdown,
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw new error_types_1.StorageError('Failed reading Microsoft SKILL.md fallback content.', {
+                sourceName: this.sourceName,
+                skillMarkdownPath,
+                cause: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    toSkillManifest(skillName, parsedSkill) {
+        const frontmatter = parsedSkill.frontmatter;
+        const manifestName = this.pickString(frontmatter, ['name']) ?? skillName;
+        const displayName = this.pickString(frontmatter, ['displayName', 'display_name', 'title']);
+        const description = this.pickString(frontmatter, ['description', 'summary', 'shortDescription']) ??
+            `Skill instructions for ${skillName}`;
+        const shortDescription = this.pickString(frontmatter, [
+            'shortDescription',
+            'short_description',
+            'summary',
+        ]);
+        const license = this.pickString(frontmatter, ['license']);
+        const compatibility = this.pickString(frontmatter, ['compatibility']);
+        const resources = this.pickStringArray(frontmatter, ['resources', 'references']);
+        return {
+            name: manifestName,
+            displayName,
+            description,
+            shortDescription,
+            license,
+            compatibility,
+            frontmatter,
+            instructionContent: parsedSkill.instructionContent,
+            resources,
+            sourceUrl: `${this.repoUrl}/tree/${encodeURIComponent(this.branch)}/${SKILLS_DIRECTORY}/${encodeURIComponent(skillName)}`,
+        };
+    }
+};
+exports.MicrosoftSkillSource = MicrosoftSkillSource;
+exports.MicrosoftSkillSource = MicrosoftSkillSource = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], MicrosoftSkillSource);
+//# sourceMappingURL=microsoft-skill-source.adapter.js.map

package/dist/server/modules/skills/adapters/microsoft-skill-source.adapter.js.map

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

package/dist/server/modules/skills/adapters/openai-skill-source.adapter.d.ts

@@ -0,0 +1,13 @@
+import { GitHubSkillSourceBase } from './github-skill-source.base';
+import { SkillManifest, SkillSourceSyncContext } from './skill-source.adapter';
+export declare class OpenAISkillSource extends GitHubSkillSourceBase {
+    constructor();
+    listSkills(): Promise<Map<string, SkillManifest>>;
+    protected resolveSkillDirectory(extractedRepoRoot: string, skillName: string): Promise<string>;
+    createSyncContext(): Promise<SkillSourceSyncContext>;
+    private listSkillNamesFromExtractedRepo;
+    private parseOpenAIAgentMetadata;
+    private extractOpenAIInterfaceFields;
+    private normalizeYamlScalar;
+    private toSkillManifest;
+}