@sowonai/crewx-sdk 0.1.0-dev.4 → 0.1.0-dev.40

package/dist/skills/runtime/progressive-loader.d.ts

@@ -0,0 +1,27 @@
+import { IProgressiveSkillLoader } from '../../types/skill-runtime.types';
+import { SkillMetadata, SkillDefinition } from '../../schema/skills.types';
+import { ClaudeSkillAdapter } from '../adapter/claude-skill-adapter';
+export declare class ProgressiveSkillLoader implements IProgressiveSkillLoader {
+    private readonly claudeAdapter;
+    private readonly metadataCache;
+    private readonly contentCache;
+    private readonly cacheTimestamps;
+    private readonly defaultTTL;
+    constructor(claudeAdapter: ClaudeSkillAdapter);
+    loadMetadata(skillPaths: string[]): Promise<SkillMetadata[]>;
+    loadFullContent(skillName: string): Promise<SkillDefinition>;
+    isFullyLoaded(skillName: string): boolean;
+    preloadContent(skillNames: string[]): Promise<void>;
+    clearContentCache(): Promise<void>;
+    getCacheStats(): {
+        metadataCache: number;
+        contentCache: number;
+        totalItems: number;
+    };
+    clearAllCaches(): void;
+    cleanupExpiredCache(): void;
+    private loadMetadataFromPath;
+    private deduplicateMetadata;
+    private findSkillFile;
+    private isCacheExpired;
+}

package/dist/skills/runtime/progressive-loader.js

@@ -0,0 +1,186 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressiveSkillLoader = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+class ProgressiveSkillLoader {
+    constructor(claudeAdapter) {
+        this.metadataCache = new Map();
+        this.contentCache = new Map();
+        this.cacheTimestamps = new Map();
+        this.defaultTTL = 30 * 60 * 1000;
+        this.claudeAdapter = claudeAdapter;
+    }
+    async loadMetadata(skillPaths) {
+        const allMetadata = [];
+        for (const skillPath of skillPaths) {
+            try {
+                const metadata = await this.loadMetadataFromPath(skillPath);
+                allMetadata.push(...metadata);
+            }
+            catch (error) {
+                console.warn(`Failed to load metadata from ${skillPath}:`, error);
+            }
+        }
+        const uniqueMetadata = this.deduplicateMetadata(allMetadata);
+        for (const metadata of uniqueMetadata) {
+            this.metadataCache.set(metadata.name, metadata);
+            this.cacheTimestamps.set(`metadata:${metadata.name}`, Date.now());
+        }
+        return uniqueMetadata;
+    }
+    async loadFullContent(skillName) {
+        const cached = this.contentCache.get(skillName);
+        if (cached && !this.isCacheExpired(`content:${skillName}`)) {
+            return cached;
+        }
+        const metadata = this.metadataCache.get(skillName);
+        if (!metadata) {
+            throw new Error(`Skill "${skillName}" not found. Load metadata first.`);
+        }
+        const skillFilePath = await this.findSkillFile(skillName);
+        if (!skillFilePath) {
+            throw new Error(`Skill file for "${skillName}" not found`);
+        }
+        try {
+            const fullContent = await promises_1.default.readFile(skillFilePath, 'utf-8');
+            const content = this.claudeAdapter.parseContent(fullContent);
+            const definition = {
+                metadata,
+                content,
+                filePath: skillFilePath,
+                fullyLoaded: true
+            };
+            this.contentCache.set(skillName, definition);
+            this.cacheTimestamps.set(`content:${skillName}`, Date.now());
+            return definition;
+        }
+        catch (error) {
+            throw new Error(`Failed to load full content for skill "${skillName}": ${error.message}`);
+        }
+    }
+    isFullyLoaded(skillName) {
+        const cached = this.contentCache.get(skillName);
+        return cached?.fullyLoaded || false;
+    }
+    async preloadContent(skillNames) {
+        const loadPromises = skillNames.map(skillName => this.loadFullContent(skillName).catch(error => {
+            console.warn(`Failed to preload content for skill "${skillName}":`, error);
+            return null;
+        }));
+        await Promise.all(loadPromises);
+    }
+    async clearContentCache() {
+        this.contentCache.clear();
+        const keysToDelete = [];
+        for (const [key] of this.cacheTimestamps) {
+            if (key.startsWith('content:')) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cacheTimestamps.delete(key);
+        }
+    }
+    getCacheStats() {
+        return {
+            metadataCache: this.metadataCache.size,
+            contentCache: this.contentCache.size,
+            totalItems: this.metadataCache.size + this.contentCache.size
+        };
+    }
+    clearAllCaches() {
+        this.metadataCache.clear();
+        this.contentCache.clear();
+        this.cacheTimestamps.clear();
+    }
+    cleanupExpiredCache() {
+        const now = Date.now();
+        const keysToDelete = [];
+        for (const [key, timestamp] of this.cacheTimestamps) {
+            if (now - timestamp > this.defaultTTL) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cacheTimestamps.delete(key);
+            if (key.startsWith('metadata:')) {
+                const skillName = key.replace('metadata:', '');
+                this.metadataCache.delete(skillName);
+            }
+            else if (key.startsWith('content:')) {
+                const skillName = key.replace('content:', '');
+                this.contentCache.delete(skillName);
+            }
+        }
+    }
+    async loadMetadataFromPath(skillPath) {
+        const metadata = [];
+        try {
+            const stats = await promises_1.default.stat(skillPath);
+            if (stats.isFile() && skillPath.endsWith('.md')) {
+                const skillMetadata = await this.claudeAdapter.extractMetadata(skillPath);
+                metadata.push(skillMetadata);
+            }
+            else if (stats.isDirectory()) {
+                const skillFiles = await this.claudeAdapter.discoverSkills(skillPath);
+                for (const filePath of skillFiles) {
+                    try {
+                        const skillMetadata = await this.claudeAdapter.extractMetadata(filePath);
+                        metadata.push(skillMetadata);
+                    }
+                    catch (error) {
+                        console.warn(`Failed to load metadata from ${filePath}:`, error);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to load metadata from path ${skillPath}: ${error.message}`);
+        }
+        return metadata;
+    }
+    deduplicateMetadata(metadata) {
+        const seen = new Set();
+        const unique = [];
+        for (const item of metadata) {
+            if (!seen.has(item.name)) {
+                seen.add(item.name);
+                unique.push(item);
+            }
+        }
+        return unique;
+    }
+    async findSkillFile(skillName) {
+        const metadata = this.metadataCache.get(skillName);
+        if (!metadata) {
+            return null;
+        }
+        const possiblePaths = [
+            `./skills/${skillName}.md`,
+            `~/.claude/skills/${skillName}.md`,
+            `./${skillName}.md`
+        ];
+        for (const possiblePath of possiblePaths) {
+            try {
+                const expandedPath = possiblePath.replace('~', process.env.HOME || '');
+                await promises_1.default.access(expandedPath);
+                return expandedPath;
+            }
+            catch {
+            }
+        }
+        return null;
+    }
+    isCacheExpired(key) {
+        const timestamp = this.cacheTimestamps.get(key);
+        if (!timestamp) {
+            return true;
+        }
+        return Date.now() - timestamp > this.defaultTTL;
+    }
+}
+exports.ProgressiveSkillLoader = ProgressiveSkillLoader;
+//# sourceMappingURL=progressive-loader.js.map

package/dist/skills/runtime/progressive-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-loader.js","sourceRoot":"","sources":["../../../src/skills/runtime/progressive-loader.ts"],"names":[],"mappings":";;;;;;AAOA,2DAA6B;AAU7B,MAAa,sBAAsB;IAQjC,YAAY,aAAiC;QAN5B,kBAAa,GAA+B,IAAI,GAAG,EAAE,CAAC;QACtD,iBAAY,GAAiC,IAAI,GAAG,EAAE,CAAC;QACvD,oBAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;QAEjD,eAAU,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAG3C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAKD,KAAK,CAAC,YAAY,CAAC,UAAoB;QACrC,MAAM,WAAW,GAAoB,EAAE,CAAC;QAExC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;gBAC5D,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAGD,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAG7D,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAKD,KAAK,CAAC,eAAe,CAAC,SAAiB;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,SAAS,EAAE,CAAC,EAAE,CAAC;YAC3D,OAAO,MAAM,CAAC;QAChB,CAAC;QAGD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,mCAAmC,CAAC,CAAC;QAC1E,CAAC;QAGD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,aAAa,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,WAAW,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAG9D,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAE7D,MAAM,UAAU,GAAoB;gBAClC,QAAQ;gBACR,OAAO;gBACP,QAAQ,EAAE,aAAa;gBACvB,WAAW,EAAE,IAAI;aAClB,CAAC;YAGF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,SAAS,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAE7D,OAAO,UAAU,CAAC;QAEpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAKD,aAAa,CAAC,SAAiB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,MAAM,EAAE,WAAW,IAAI,KAAK,CAAC;IACtC,CAAC;IAKD,KAAK,CAAC,cAAc,CAAC,UAAoB;QACvC,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAC9C,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC5C,OAAO,CAAC,IAAI,CAAC,wCAAwC,SAAS,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAKD,KAAK,CAAC,iBAAiB;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAG1B,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAKD,aAAa;QACX,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YACtC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;YACpC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI;SAC7D,CAAC;IACJ,CAAC;IAKD,cAAc;QACZ,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAKD,mBAAmB;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACpD,IAAI,GAAG,GAAG,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBACtC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAOO,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAClD,MAAM,QAAQ,GAAoB,EAAE,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAEvC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAEhD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;gBAC1E,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAE/B,CAAC;iBAAM,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBAE/B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;gBAEtE,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;oBAClC,IAAI,CAAC;wBACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;wBACzE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBAC/B,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;YACH,CAAC;QAEH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAKO,mBAAmB,CAAC,QAAyB;QACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAKO,KAAK,CAAC,aAAa,CAAC,SAAiB;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAID,MAAM,aAAa,GAAG;YACpB,YAAY,SAAS,KAAK;YAC1B,oBAAoB,SAAS,KAAK;YAClC,KAAK,SAAS,KAAK;SACpB,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBACvE,MAAM,kBAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC9B,OAAO,YAAY,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;YAET,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKO,cAAc,CAAC,GAAW;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IAClD,CAAC;CACF;AA5QD,wDA4QC"}

package/dist/skills/runtime/runtime-requirements-validator.d.ts

@@ -0,0 +1,23 @@
+import { RuntimeRequirementsValidator, RuntimeInfo } from '../../types/skill-runtime.types';
+export declare class SystemRuntimeValidator implements RuntimeRequirementsValidator {
+    validatePython(requirement: string): Promise<boolean>;
+    validateNode(requirement: string): Promise<boolean>;
+    validateDocker(): Promise<boolean>;
+    validateMemory(requirement: string): Promise<boolean>;
+    getCurrentRuntime(): Promise<RuntimeInfo>;
+    private compareVersions;
+    private compareVersionArrays;
+    private parseMemoryRequirement;
+}
+export declare class MockRuntimeValidator implements RuntimeRequirementsValidator {
+    private mockResults;
+    private mockRuntime;
+    constructor(mockResults?: Record<string, boolean>);
+    validatePython(requirement: string): Promise<boolean>;
+    validateNode(requirement: string): Promise<boolean>;
+    validateDocker(): Promise<boolean>;
+    validateMemory(requirement: string): Promise<boolean>;
+    getCurrentRuntime(): Promise<RuntimeInfo>;
+    setMockResult(component: string, result: boolean): void;
+    setMockRuntime(runtime: Partial<RuntimeInfo>): void;
+}

package/dist/skills/runtime/runtime-requirements-validator.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockRuntimeValidator = exports.SystemRuntimeValidator = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const os_1 = __importDefault(require("os"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+class SystemRuntimeValidator {
+    async validatePython(requirement) {
+        try {
+            const result = await execAsync('python3 --version 2>&1 || python --version 2>&1');
+            const versionOutput = (result.stdout.trim() || result.stderr.trim());
+            const versionMatch = versionOutput.match(/Python (\d+\.\d+\.\d+)/);
+            if (!versionMatch?.[1]) {
+                return false;
+            }
+            const currentVersion = versionMatch[1];
+            return this.compareVersions(currentVersion, requirement);
+        }
+        catch (error) {
+            console.warn('Python not found or version check failed:', error);
+            return false;
+        }
+    }
+    async validateNode(requirement) {
+        try {
+            const result = await execAsync('node --version');
+            const versionOutput = result.stdout.trim();
+            const versionMatch = versionOutput.match(/v(\d+\.\d+\.\d+)/);
+            if (!versionMatch?.[1]) {
+                return false;
+            }
+            const currentVersion = versionMatch[1];
+            return this.compareVersions(currentVersion, requirement);
+        }
+        catch (error) {
+            console.warn('Node.js not found or version check failed:', error);
+            return false;
+        }
+    }
+    async validateDocker() {
+        try {
+            const result = await execAsync('docker --version');
+            return result.stdout.trim().length > 0;
+        }
+        catch (error) {
+            console.warn('Docker not found or not accessible:', error);
+            return false;
+        }
+    }
+    async validateMemory(requirement) {
+        try {
+            const requiredMemory = this.parseMemoryRequirement(requirement);
+            const availableMemory = os_1.default.totalmem();
+            return availableMemory >= requiredMemory;
+        }
+        catch (error) {
+            console.warn('Memory validation failed:', error);
+            return false;
+        }
+    }
+    async getCurrentRuntime() {
+        const runtime = {
+            memory: {
+                total: os_1.default.totalmem(),
+                available: os_1.default.freemem()
+            }
+        };
+        try {
+            const result = await execAsync('python3 --version 2>&1 || python --version 2>&1');
+            const versionOutput = (result.stdout.trim() || result.stderr.trim());
+            const versionMatch = versionOutput.match(/Python (\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                runtime.python = {
+                    version: versionMatch[1] || 'unknown',
+                    available: true
+                };
+            }
+            else {
+                runtime.python = {
+                    version: 'unknown',
+                    available: false
+                };
+            }
+        }
+        catch {
+            runtime.python = {
+                version: 'unknown',
+                available: false
+            };
+        }
+        try {
+            const result = await execAsync('node --version');
+            const versionOutput = result.stdout.trim();
+            const versionMatch = versionOutput.match(/v(\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                runtime.node = {
+                    version: versionMatch[1] || 'unknown',
+                    available: true
+                };
+            }
+            else {
+                runtime.node = {
+                    version: 'unknown',
+                    available: false
+                };
+            }
+        }
+        catch {
+            runtime.node = {
+                version: 'unknown',
+                available: false
+            };
+        }
+        try {
+            const result = await execAsync('docker --version');
+            const versionOutput = result.stdout.trim();
+            const versionMatch = versionOutput.match(/Docker version (\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                runtime.docker = {
+                    version: versionMatch[1] || 'unknown',
+                    available: true
+                };
+            }
+            else {
+                runtime.docker = {
+                    version: 'unknown',
+                    available: false
+                };
+            }
+        }
+        catch {
+            runtime.docker = {
+                version: 'unknown',
+                available: false
+            };
+        }
+        return runtime;
+    }
+    compareVersions(current, requirement) {
+        const match = requirement.match(/^([><=!]+)\s*(\d+\.\d+\.\d+)$/);
+        if (!match) {
+            return current === requirement;
+        }
+        const operator = match[1];
+        const requiredVersion = match[2] || '';
+        const currentParts = current.split('.').map(Number);
+        const requiredParts = requiredVersion.split('.').map(Number);
+        const comparison = this.compareVersionArrays(currentParts, requiredParts);
+        switch (operator) {
+            case '>=':
+                return comparison >= 0;
+            case '>':
+                return comparison > 0;
+            case '<=':
+                return comparison <= 0;
+            case '<':
+                return comparison < 0;
+            case '==':
+            case '=':
+                return comparison === 0;
+            default:
+                throw new Error(`Unsupported version operator: ${operator}`);
+        }
+    }
+    compareVersionArrays(a, b) {
+        const maxLength = Math.max(a.length, b.length);
+        for (let i = 0; i < maxLength; i++) {
+            const aPart = a[i] || 0;
+            const bPart = b[i] || 0;
+            if (aPart > bPart)
+                return 1;
+            if (aPart < bPart)
+                return -1;
+        }
+        return 0;
+    }
+    parseMemoryRequirement(requirement) {
+        const match = requirement.match(/^(\d+(?:\.\d+)?)\s*(GB|MB|KB|B)$/i);
+        if (!match) {
+            throw new Error(`Invalid memory requirement format: ${requirement}`);
+        }
+        const value = parseFloat(match[1] || '0');
+        const unit = (match[2] || '').toUpperCase();
+        const multipliers = {
+            'B': 1,
+            'KB': 1024,
+            'MB': 1024 * 1024,
+            'GB': 1024 * 1024 * 1024
+        };
+        return Math.floor(value * multipliers[unit]);
+    }
+}
+exports.SystemRuntimeValidator = SystemRuntimeValidator;
+class MockRuntimeValidator {
+    constructor(mockResults) {
+        this.mockResults = new Map();
+        if (mockResults) {
+            Object.entries(mockResults).forEach(([key, value]) => {
+                this.mockResults.set(key, value);
+            });
+        }
+        this.mockRuntime = {
+            python: {
+                version: '3.11.0',
+                available: this.mockResults.get('python') ?? true
+            },
+            node: {
+                version: '18.17.0',
+                available: this.mockResults.get('node') ?? true
+            },
+            docker: {
+                version: '24.0.0',
+                available: this.mockResults.get('docker') ?? true
+            },
+            memory: {
+                total: 16 * 1024 * 1024 * 1024,
+                available: 8 * 1024 * 1024 * 1024
+            }
+        };
+    }
+    async validatePython(requirement) {
+        return this.mockResults.get('python') ?? true;
+    }
+    async validateNode(requirement) {
+        return this.mockResults.get('node') ?? true;
+    }
+    async validateDocker() {
+        return this.mockResults.get('docker') ?? true;
+    }
+    async validateMemory(requirement) {
+        return this.mockResults.get('memory') ?? true;
+    }
+    async getCurrentRuntime() {
+        return { ...this.mockRuntime };
+    }
+    setMockResult(component, result) {
+        this.mockResults.set(component, result);
+    }
+    setMockRuntime(runtime) {
+        this.mockRuntime = { ...this.mockRuntime, ...runtime };
+    }
+}
+exports.MockRuntimeValidator = MockRuntimeValidator;
+//# sourceMappingURL=runtime-requirements-validator.js.map

package/dist/skills/runtime/runtime-requirements-validator.js.map

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

package/dist/skills/runtime/skill-runtime.service.d.ts

@@ -0,0 +1,42 @@
+import { EventEmitter } from 'events';
+import { ISkillRuntime, IProgressiveSkillLoader, IClaudeSkillAdapter, SkillExecutionContext, SkillExecutionResult, SkillLoadOptions, SkillResolutionResult, SkillCacheStats, SkillRuntimeInfo, RuntimeRequirementsValidator, ProgressiveDisclosureConfig } from '../../types/skill-runtime.types';
+import { SkillMetadata, SkillDefinition, SkillValidationResult, AgentDefinition } from '../../schema/skills.types';
+export declare class SkillRuntime extends EventEmitter implements ISkillRuntime {
+    private readonly progressiveLoader;
+    private readonly claudeAdapter;
+    private readonly runtimeValidator;
+    private readonly config;
+    private startTime;
+    private skillsCache;
+    private contentCache;
+    private activeExecutions;
+    private cacheStats;
+    constructor(progressiveLoader: IProgressiveSkillLoader, claudeAdapter: IClaudeSkillAdapter, runtimeValidator: RuntimeRequirementsValidator, config?: Partial<ProgressiveDisclosureConfig>);
+    loadSkills(options?: SkillLoadOptions): Promise<SkillMetadata[]>;
+    validateSkill(skillName: string): Promise<SkillValidationResult>;
+    prepareContext(skillName: string, agentConfig: AgentDefinition, options?: Partial<SkillExecutionContext>): Promise<SkillExecutionContext>;
+    executeSkill(context: SkillExecutionContext, input: string): Promise<SkillExecutionResult>;
+    cleanup(context: SkillExecutionContext): Promise<void>;
+    listAvailableSkills(): Promise<string[]>;
+    getSkillMetadata(skillName: string): Promise<SkillMetadata | null>;
+    getSkillDefinition(skillName: string): Promise<SkillDefinition | null>;
+    resolveDependencies(skillName: string): Promise<SkillResolutionResult>;
+    clearCache(): Promise<void>;
+    getCacheStats(): SkillCacheStats;
+    getRuntimeInfo(): SkillRuntimeInfo;
+    shutdown(): Promise<void>;
+    private initializeCacheStats;
+    private setupCacheCleanup;
+    private applyFilters;
+    private validateMetadataStructure;
+    private validateDependencies;
+    private validateRuntimeRequirements;
+    private buildExecutionPrompt;
+    private executeWithAIProvider;
+    private generateExecutionId;
+    private getMemoryUsage;
+    private getCacheHits;
+    private getCacheMisses;
+    private updateCacheStats;
+    private cleanupExpiredCache;
+}