mcp-agent-foundry 1.3.1 → 2.1.0

package/dist/skills/hot-reloader.js

@@ -0,0 +1,314 @@
+/**
+ * Skill Hot Reloader
+ *
+ * Watches skill directories for file changes and hot-reloads skills
+ * without requiring server restart. Uses debouncing to prevent
+ * rapid reload storms.
+ */
+import { watch } from 'fs';
+import { promises as fs } from 'fs';
+import path from 'path';
+import os from 'os';
+import { EventEmitter } from 'events';
+// ============================================================================
+// Hot Reloader Class
+// ============================================================================
+/**
+ * Watches skill directories and hot-reloads on changes.
+ * Supports multiple watched directories with debounced reload.
+ */
+export class SkillHotReloader extends EventEmitter {
+    watchers = new Map();
+    loader;
+    config;
+    logger;
+    debounceTimers = new Map();
+    debounceMs = 500;
+    isRunning = false;
+    constructor(loader, config, logger) {
+        super();
+        this.loader = loader;
+        this.config = config;
+        this.logger = logger.child({ component: 'SkillHotReloader' });
+        this.logger.debug('SkillHotReloader initialized', {
+            watchForChanges: config.watchForChanges,
+            searchPaths: config.searchPaths,
+        });
+    }
+    // ==========================================================================
+    // Lifecycle Methods
+    // ==========================================================================
+    /**
+     * Start watching all configured skill directories.
+     * Creates watchers for each search path.
+     */
+    start() {
+        if (!this.config.watchForChanges) {
+            this.logger.debug('File watching disabled, skipping');
+            return;
+        }
+        if (this.isRunning) {
+            this.logger.warn('Hot reloader already running');
+            return;
+        }
+        this.isRunning = true;
+        for (const searchPath of this.config.searchPaths) {
+            const expandedPath = this.expandPath(searchPath);
+            this.watchDirectory(expandedPath);
+        }
+        this.logger.info('Hot reloader started', {
+            watchedPaths: this.getWatchedPaths(),
+        });
+    }
+    /**
+     * Stop watching all directories.
+     * Cleans up watchers and pending timers.
+     */
+    stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        // Clear all debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        // Close all watchers
+        for (const [path, watcher] of this.watchers.entries()) {
+            watcher.close();
+            this.logger.debug('Stopped watching directory', { path });
+        }
+        this.watchers.clear();
+        this.isRunning = false;
+        this.logger.info('Hot reloader stopped');
+    }
+    // ==========================================================================
+    // Watch Methods
+    // ==========================================================================
+    /**
+     * Watch a specific directory for changes.
+     * Creates recursive watcher if directory exists.
+     *
+     * @param dirPath - Directory path to watch
+     */
+    watchDirectory(dirPath) {
+        const expandedPath = this.expandPath(dirPath);
+        // Check if already watching
+        if (this.watchers.has(expandedPath)) {
+            this.logger.debug('Already watching directory', { path: expandedPath });
+            return;
+        }
+        // Check if directory exists
+        this.ensureDirectoryExists(expandedPath)
+            .then(() => {
+            this.createWatcher(expandedPath);
+        })
+            .catch((error) => {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.debug('Cannot watch directory (may not exist)', {
+                path: expandedPath,
+                error: errorMessage,
+            });
+        });
+    }
+    /**
+     * Ensure directory exists, creating it if necessary.
+     */
+    async ensureDirectoryExists(dirPath) {
+        try {
+            const stat = await fs.stat(dirPath);
+            if (!stat.isDirectory()) {
+                throw new Error('Path is not a directory');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                // Directory doesn't exist - don't create it, just skip
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create a file watcher for a directory.
+     */
+    createWatcher(dirPath) {
+        try {
+            // Use recursive option if available (Node.js 14.17+)
+            const watcher = watch(dirPath, { recursive: true }, (eventType, filename) => {
+                if (filename) {
+                    this.handleFileChange(eventType, filename, dirPath);
+                }
+            });
+            watcher.on('error', (error) => {
+                this.logger.error('Watch error', {
+                    path: dirPath,
+                    error,
+                });
+            });
+            watcher.on('close', () => {
+                this.watchers.delete(dirPath);
+                this.logger.debug('Watcher closed', { path: dirPath });
+            });
+            this.watchers.set(dirPath, watcher);
+            this.logger.debug('Watching directory', { path: dirPath });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.warn('Failed to create watcher', {
+                path: dirPath,
+                error: errorMessage,
+            });
+        }
+    }
+    // ==========================================================================
+    // Event Handling Methods
+    // ==========================================================================
+    /**
+     * Handle file change event from watcher.
+     * Debounces rapid changes and filters to skill files.
+     */
+    handleFileChange(eventType, filename, dirPath) {
+        // Only handle skill files
+        if (!this.isSkillFile(filename)) {
+            return;
+        }
+        const fullPath = path.join(dirPath, filename);
+        this.logger.debug('File change detected', {
+            eventType,
+            filename,
+            fullPath,
+        });
+        // Schedule debounced reload
+        this.scheduleReload(fullPath);
+    }
+    /**
+     * Schedule a debounced reload for a file.
+     * Cancels any pending reload for the same file.
+     *
+     * @param filePath - File path to reload
+     */
+    scheduleReload(filePath) {
+        // Cancel existing timer for this file
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Schedule new reload
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            void this.reloadFile(filePath);
+        }, this.debounceMs);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * Reload a skill file.
+     * Handles file creation, modification, and deletion.
+     */
+    async reloadFile(filePath) {
+        try {
+            // Check if file still exists
+            const exists = await this.fileExists(filePath);
+            if (!exists) {
+                // File was deleted - find and unregister the skill
+                const skillName = this.findSkillByPath(filePath);
+                if (skillName) {
+                    this.loader.unregister(skillName);
+                    this.emitReloadEvent({ name: skillName }, 'removed');
+                    this.logger.info('Skill removed (file deleted)', {
+                        name: skillName,
+                        path: filePath,
+                    });
+                }
+                return;
+            }
+            // Check if this is an update or new skill
+            const existingSkillName = this.findSkillByPath(filePath);
+            const action = existingSkillName ? 'updated' : 'added';
+            // Load the skill file
+            const skill = await this.loader.loadSkillFile(filePath);
+            if (skill) {
+                this.emitReloadEvent(skill, action);
+                this.logger.info(`Skill ${action}`, {
+                    name: skill.name,
+                    path: filePath,
+                });
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Failed to reload skill file', {
+                path: filePath,
+                error: err,
+            });
+        }
+    }
+    // ==========================================================================
+    // Helper Methods
+    // ==========================================================================
+    /**
+     * Check if a file exists.
+     */
+    async fileExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Find skill name by source path.
+     */
+    findSkillByPath(filePath) {
+        for (const skill of this.loader.getAllSkills()) {
+            if (skill.sourcePath === filePath) {
+                return skill.name;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if filename matches skill file patterns.
+     */
+    isSkillFile(filename) {
+        const ext = path.extname(filename).toLowerCase();
+        return ['.yaml', '.yml', '.json'].includes(ext);
+    }
+    /**
+     * Expand ~ in paths to home directory.
+     */
+    expandPath(p) {
+        if (p.startsWith('~')) {
+            return path.join(os.homedir(), p.slice(1));
+        }
+        return p;
+    }
+    /**
+     * Get list of currently watched directories.
+     */
+    getWatchedPaths() {
+        return Array.from(this.watchers.keys());
+    }
+    /**
+     * Emit a reload event.
+     */
+    emitReloadEvent(skill, action) {
+        const event = { skill, action };
+        this.emit('skill:reloaded', event);
+    }
+    /**
+     * Set debounce delay (for testing).
+     */
+    setDebounceMs(ms) {
+        this.debounceMs = ms;
+    }
+    /**
+     * Check if hot reloader is running.
+     */
+    get running() {
+        return this.isRunning;
+    }
+}
+//# sourceMappingURL=hot-reloader.js.map

package/dist/skills/hot-reloader.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skills System
+ *
+ * Hot-reloadable skills system for Agent Foundry.
+ * Skills are YAML/JSON-defined capabilities that can be triggered
+ * automatically or invoked manually.
+ *
+ * @module skills
+ */
+export * from './types.js';
+export { SkillLoader } from './skill-loader.js';
+export { SkillHotReloader } from './hot-reloader.js';
+export { SkillExecutor } from './skill-executor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,16 @@
+/**
+ * Skills System
+ *
+ * Hot-reloadable skills system for Agent Foundry.
+ * Skills are YAML/JSON-defined capabilities that can be triggered
+ * automatically or invoked manually.
+ *
+ * @module skills
+ */
+// Types
+export * from './types.js';
+// Core classes
+export { SkillLoader } from './skill-loader.js';
+export { SkillHotReloader } from './hot-reloader.js';
+export { SkillExecutor } from './skill-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/skills/skill-executor.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Skill Executor
+ *
+ * Executes skills with proper context handling.
+ * Supports forked, inherited, and isolated context modes.
+ */
+import type { Logger } from '../observability/logger.js';
+import type { SkillDefinition, SkillContext, SkillResult, SkillContextMode } from './types.js';
+/**
+ * Executes skills with proper context handling.
+ * Manages context isolation, forking, and inheritance.
+ */
+export declare class SkillExecutor {
+    private logger;
+    private defaultContextMode;
+    constructor(logger: Logger, defaultContextMode?: SkillContextMode);
+    /**
+     * Execute a skill with the given context and input.
+     *
+     * @param skill - Skill definition to execute
+     * @param context - Execution context
+     * @param input - Input data for the skill
+     * @returns Execution result
+     */
+    execute(skill: SkillDefinition, context: SkillContext, input: {
+        prompt?: string;
+        data?: unknown;
+    }): Promise<SkillResult>;
+    /**
+     * Create forked context from parent context.
+     * Child context is a deep copy with reference to parent.
+     *
+     * @param parentContext - Parent context to fork from
+     * @returns Forked child context
+     */
+    forkContext(parentContext: SkillContext): SkillContext;
+    /**
+     * Create isolated context with no parent data.
+     * Only includes session ID for correlation.
+     *
+     * @param sessionId - Session ID to use
+     * @returns Fresh isolated context
+     */
+    createIsolatedContext(sessionId: string): SkillContext;
+    /**
+     * Create a new context for a session.
+     *
+     * @param sessionId - Optional session ID (generated if not provided)
+     * @returns New skill context
+     */
+    createContext(sessionId?: string): SkillContext;
+    /**
+     * Prepare execution context based on context mode.
+     *
+     * @param context - Original context
+     * @param mode - Context handling mode
+     * @returns Prepared execution context
+     */
+    private prepareContext;
+    /**
+     * Build system prompt for skill execution.
+     * Combines skill's system prompt with role information.
+     *
+     * @param skill - Skill definition
+     * @returns Built system prompt
+     */
+    buildSystemPrompt(skill: SkillDefinition): string;
+    /**
+     * Apply context modifications back to parent context.
+     * Used when inherit mode skill execution completes.
+     *
+     * @param parentContext - Parent context to modify
+     * @param modifications - Modifications to apply
+     */
+    applyContextModifications(parentContext: SkillContext, modifications: Record<string, unknown>): void;
+    /**
+     * Execute the actual skill logic.
+     * This is a placeholder for integration with the provider system.
+     *
+     * @param skill - Skill definition
+     * @param context - Execution context
+     * @param input - Input data
+     * @param systemPrompt - Built system prompt
+     * @returns Skill output
+     */
+    private executeSkillLogic;
+    /**
+     * Extract context modifications from skill output.
+     * Looks for a specific structure in the output.
+     *
+     * @param output - Skill execution output
+     * @returns Extracted modifications or undefined
+     */
+    private extractContextModifications;
+}
+//# sourceMappingURL=skill-executor.d.ts.map

package/dist/skills/skill-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor.d.ts","sourceRoot":"","sources":["../../src/skills/skill-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAmB;gBAEjC,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,gBAAgB;IAajE;;;;;;;OAOG;IACG,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GACzC,OAAO,CAAC,WAAW,CAAC;IAoEvB;;;;;;OAMG;IACH,WAAW,CAAC,aAAa,EAAE,YAAY,GAAG,YAAY;IAYtD;;;;;;OAMG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAOtD;;;;;OAKG;IACH,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY;IAO/C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAiCjD;;;;;;OAMG;IACH,yBAAyB,CACvB,aAAa,EAAE,YAAY,EAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,IAAI;IAoCP;;;;;;;;;OASG;YACW,iBAAiB;IAgC/B;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;CAiCpC"}