skillpkg-core 0.1.0

package/dist/importer/importer.js

@@ -0,0 +1,204 @@
+/**
+ * Importer - Import skills from various platform formats
+ *
+ * Uses platform adapters to detect and import skills
+ */
+import { readdir, stat } from 'fs/promises';
+import { join } from 'path';
+import { createAdapterManager } from '../adapters/manager.js';
+/**
+ * Importer class
+ */
+export class Importer {
+    adapters;
+    constructor() {
+        const manager = createAdapterManager();
+        this.adapters = manager.listAdapters();
+    }
+    /**
+     * Detect importable files in a path
+     */
+    async detect(path) {
+        const detected = [];
+        const stats = await stat(path).catch(() => null);
+        if (!stats) {
+            return detected;
+        }
+        if (stats.isFile()) {
+            // Single file - check each adapter
+            for (const adapter of this.adapters) {
+                if (await adapter.canImport(path)) {
+                    detected.push({
+                        path,
+                        platform: adapter.name,
+                        displayName: adapter.displayName,
+                    });
+                    break; // First match wins
+                }
+            }
+        }
+        else if (stats.isDirectory()) {
+            // Directory - scan for importable files
+            await this.scanDirectory(path, detected);
+        }
+        return detected;
+    }
+    /**
+     * Scan directory recursively for importable files
+     */
+    async scanDirectory(dirPath, detected, depth = 0) {
+        // Limit recursion depth
+        if (depth > 5)
+            return;
+        try {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dirPath, entry.name);
+                if (entry.isFile()) {
+                    // Check if any adapter can import this file
+                    for (const adapter of this.adapters) {
+                        if (await adapter.canImport(fullPath)) {
+                            detected.push({
+                                path: fullPath,
+                                platform: adapter.name,
+                                displayName: adapter.displayName,
+                            });
+                            break;
+                        }
+                    }
+                }
+                else if (entry.isDirectory()) {
+                    // Skip common non-skill directories
+                    if (this.shouldSkipDirectory(entry.name)) {
+                        continue;
+                    }
+                    // Recurse into subdirectory
+                    await this.scanDirectory(fullPath, detected, depth + 1);
+                }
+            }
+        }
+        catch {
+            // Ignore permission errors, etc.
+        }
+    }
+    /**
+     * Check if a directory should be skipped during scanning
+     */
+    shouldSkipDirectory(name) {
+        const skipDirs = [
+            'node_modules',
+            '.git',
+            '.svn',
+            'dist',
+            'build',
+            'coverage',
+            '__pycache__',
+            '.venv',
+            'venv',
+        ];
+        return skipDirs.includes(name);
+    }
+    /**
+     * Import a single file
+     */
+    async importFile(path, options = {}) {
+        // Find adapter that can import this file
+        let targetAdapter = null;
+        if (options.platform) {
+            // Use specified platform
+            targetAdapter =
+                this.adapters.find((a) => a.name === options.platform) || null;
+            if (targetAdapter && !(await targetAdapter.canImport(path))) {
+                return {
+                    path,
+                    success: false,
+                    error: `File is not a valid ${targetAdapter.displayName} format`,
+                };
+            }
+        }
+        else {
+            // Auto-detect platform
+            for (const adapter of this.adapters) {
+                if (await adapter.canImport(path)) {
+                    targetAdapter = adapter;
+                    break;
+                }
+            }
+        }
+        if (!targetAdapter) {
+            return {
+                path,
+                success: false,
+                error: 'No compatible platform adapter found',
+            };
+        }
+        try {
+            const skill = await targetAdapter.import(path);
+            return {
+                path,
+                success: true,
+                skill,
+                platform: targetAdapter.name,
+            };
+        }
+        catch (error) {
+            return {
+                path,
+                success: false,
+                platform: targetAdapter.name,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Import multiple files (batch import)
+     */
+    async importBatch(paths, options = {}) {
+        const result = {
+            imported: [],
+            failed: [],
+            skipped: [],
+            total: paths.length,
+        };
+        for (const path of paths) {
+            const importResult = await this.importFile(path, options);
+            if (importResult.success) {
+                result.imported.push(importResult);
+            }
+            else {
+                result.failed.push(importResult);
+            }
+        }
+        return result;
+    }
+    /**
+     * Import from a path (file or directory)
+     */
+    async importFrom(path, options = {}) {
+        // First detect importable files
+        const detected = await this.detect(path);
+        if (detected.length === 0) {
+            return {
+                imported: [],
+                failed: [],
+                skipped: [
+                    {
+                        path,
+                        success: false,
+                        error: 'No importable files found',
+                    },
+                ],
+                total: 0,
+            };
+        }
+        // Import all detected files
+        return this.importBatch(detected.map((d) => d.path), options);
+    }
+}
+/**
+ * Create a new Importer instance
+ */
+export function createImporter() {
+    return new Importer();
+}
+//# sourceMappingURL=importer.js.map

package/dist/importer/importer.js.map

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

package/dist/importer/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Importer module - Import skills from various platform formats
+ */
+export type { ImportResult, BatchImportResult, ImportOptions, DetectedFile, } from './types.js';
+export { Importer, createImporter } from './importer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/importer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/importer/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/importer/index.js

@@ -0,0 +1,6 @@
+/**
+ * Importer module - Import skills from various platform formats
+ */
+// Importer
+export { Importer, createImporter } from './importer.js';
+//# sourceMappingURL=index.js.map

package/dist/importer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/importer/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,WAAW;AACX,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/importer/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Importer types
+ */
+import type { Skill } from '../types.js';
+/**
+ * Import result for a single file
+ */
+export interface ImportResult {
+    path: string;
+    success: boolean;
+    skill?: Skill;
+    platform?: string;
+    error?: string;
+}
+/**
+ * Batch import result
+ */
+export interface BatchImportResult {
+    imported: ImportResult[];
+    failed: ImportResult[];
+    skipped: ImportResult[];
+    total: number;
+}
+/**
+ * Import options
+ */
+export interface ImportOptions {
+    /** Dry run - don't actually save */
+    dryRun?: boolean;
+    /** Target platform to import from (auto-detect if not specified) */
+    platform?: string;
+    /** Whether to overwrite existing skills */
+    overwrite?: boolean;
+}
+/**
+ * Detected file info
+ */
+export interface DetectedFile {
+    path: string;
+    platform: string;
+    displayName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/importer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/importer/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/importer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/importer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/importer/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @skillpkg/core
+ *
+ * Core library for skillpkg - Agent Skills Package Manager
+ */
+export declare const VERSION = "0.0.1";
+export * from './types.js';
+export * from './parser/index.js';
+export * from './store/index.js';
+export * from './adapters/index.js';
+export * from './importer/index.js';
+export * from './exporter/index.js';
+export * from './registry/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @skillpkg/core
+ *
+ * Core library for skillpkg - Agent Skills Package Manager
+ */
+export const VERSION = '0.0.1';
+// Types
+export * from './types.js';
+// Parser module
+export * from './parser/index.js';
+// Store module
+export * from './store/index.js';
+// Adapters module
+export * from './adapters/index.js';
+// Importer module
+export * from './importer/index.js';
+// Exporter module
+export * from './exporter/index.js';
+// Registry module
+export * from './registry/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAElC,eAAe;AACf,cAAc,kBAAkB,CAAC;AAEjC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,qBAAqB,CAAC"}

package/dist/parser/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parser module - public API
+ *
+ * Provides YAML parsing and validation for skill.yaml files.
+ *
+ * @example
+ * ```typescript
+ * import { parse, validate, stringify } from '@skillpkg/core/parser';
+ *
+ * const result = parse(yamlContent);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export { parse, stringify, parseAndValidate } from './parser.js';
+export type { ParseResult, ParseError, ParseOptions } from './parser.js';
+export { validate } from './validator.js';
+export type { ValidationResult, ValidationError, ValidationWarning } from './validator.js';
+export { skillSchema, fieldDescriptions } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,24 @@
+/**
+ * Parser module - public API
+ *
+ * Provides YAML parsing and validation for skill.yaml files.
+ *
+ * @example
+ * ```typescript
+ * import { parse, validate, stringify } from '@skillpkg/core/parser';
+ *
+ * const result = parse(yamlContent);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+// Parser functions
+export { parse, stringify, parseAndValidate } from './parser.js';
+// Validator functions
+export { validate } from './validator.js';
+// Schema
+export { skillSchema, fieldDescriptions } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,mBAAmB;AACnB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGjE,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,SAAS;AACT,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/parser/parser.d.ts

@@ -0,0 +1,64 @@
+import type { Skill } from '../types.js';
+import { type ValidationResult } from './validator.js';
+/**
+ * Parse error with line/column information
+ */
+export interface ParseError {
+    /** Error message */
+    message: string;
+    /** Line number (1-indexed) */
+    line?: number;
+    /** Column number (1-indexed) */
+    column?: number;
+    /** Error code */
+    code: 'YAML_SYNTAX' | 'VALIDATION' | 'UNKNOWN';
+}
+/**
+ * Parse result
+ */
+export interface ParseResult<T> {
+    /** Whether parsing succeeded */
+    success: boolean;
+    /** Parsed data (if successful) */
+    data?: T;
+    /** Parse errors (if failed) */
+    errors?: ParseError[];
+    /** Validation warnings (even if successful) */
+    warnings?: string[];
+}
+/**
+ * Parse options
+ */
+export interface ParseOptions {
+    /** Whether to validate after parsing (default: true) */
+    validate?: boolean;
+    /** Whether to include warnings in result (default: true) */
+    includeWarnings?: boolean;
+}
+/**
+ * Parse a skill.yaml string into a Skill object
+ *
+ * @param content - The YAML content to parse
+ * @param options - Parse options
+ * @returns ParseResult with the parsed Skill or errors
+ */
+export declare function parse(content: string, options?: ParseOptions): ParseResult<Skill>;
+/**
+ * Stringify a Skill object to YAML
+ *
+ * @param skill - The Skill object to stringify
+ * @returns YAML string
+ */
+export declare function stringify(skill: Skill): string;
+/**
+ * Parse and validate, returning both results
+ *
+ * @param content - The YAML content to parse
+ * @returns Object with parsed skill and validation result
+ */
+export declare function parseAndValidate(content: string): {
+    skill: Skill | null;
+    validation: ValidationResult;
+    parseErrors?: ParseError[];
+};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser/parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,IAAI,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,+BAA+B;IAC/B,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAAC,KAAK,CAAC,CA+ErF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B,CAiBA"}

package/dist/parser/parser.js

@@ -0,0 +1,121 @@
+/**
+ * YAML parser for skill.yaml files
+ */
+import { parse as parseYaml, stringify as stringifyYaml, YAMLParseError } from 'yaml';
+import { validate } from './validator.js';
+/**
+ * Parse a skill.yaml string into a Skill object
+ *
+ * @param content - The YAML content to parse
+ * @param options - Parse options
+ * @returns ParseResult with the parsed Skill or errors
+ */
+export function parse(content, options = {}) {
+    const { validate: shouldValidate = true, includeWarnings = true } = options;
+    try {
+        // Parse YAML
+        const data = parseYaml(content, {
+            prettyErrors: true,
+        });
+        // Check if data is an object
+        if (typeof data !== 'object' || data === null) {
+            return {
+                success: false,
+                errors: [
+                    {
+                        message: 'skill.yaml must contain an object',
+                        code: 'VALIDATION',
+                    },
+                ],
+            };
+        }
+        // Validate if requested
+        if (shouldValidate) {
+            const validationResult = validate(data);
+            if (!validationResult.valid) {
+                return {
+                    success: false,
+                    errors: validationResult.errors.map((e) => ({
+                        message: `${e.path}: ${e.message}${e.expected ? ` (expected: ${e.expected})` : ''}`,
+                        code: 'VALIDATION',
+                    })),
+                };
+            }
+            // Return with warnings
+            const warnings = includeWarnings
+                ? validationResult.warnings.map((w) => `${w.path}: ${w.message}`)
+                : undefined;
+            return {
+                success: true,
+                data: data,
+                warnings: warnings?.length ? warnings : undefined,
+            };
+        }
+        return {
+            success: true,
+            data: data,
+        };
+    }
+    catch (error) {
+        // Handle YAML parse errors
+        if (error instanceof YAMLParseError) {
+            return {
+                success: false,
+                errors: [
+                    {
+                        message: error.message,
+                        line: error.linePos?.[0]?.line,
+                        column: error.linePos?.[0]?.col,
+                        code: 'YAML_SYNTAX',
+                    },
+                ],
+            };
+        }
+        // Handle unknown errors
+        return {
+            success: false,
+            errors: [
+                {
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                    code: 'UNKNOWN',
+                },
+            ],
+        };
+    }
+}
+/**
+ * Stringify a Skill object to YAML
+ *
+ * @param skill - The Skill object to stringify
+ * @returns YAML string
+ */
+export function stringify(skill) {
+    return stringifyYaml(skill, {
+        indent: 2,
+        lineWidth: 0, // Don't wrap lines
+        defaultStringType: 'QUOTE_DOUBLE',
+        defaultKeyType: 'PLAIN',
+    });
+}
+/**
+ * Parse and validate, returning both results
+ *
+ * @param content - The YAML content to parse
+ * @returns Object with parsed skill and validation result
+ */
+export function parseAndValidate(content) {
+    const parseResult = parse(content, { validate: false });
+    if (!parseResult.success || !parseResult.data) {
+        return {
+            skill: null,
+            validation: { valid: false, errors: [], warnings: [] },
+            parseErrors: parseResult.errors,
+        };
+    }
+    const validation = validate(parseResult.data);
+    return {
+        skill: validation.valid ? parseResult.data : null,
+        validation,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser/parser.js.map

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