mcp-agent-foundry 1.3.0 → 2.0.0

package/dist/skills/skill-executor.js

@@ -0,0 +1,289 @@
+/**
+ * Skill Executor
+ *
+ * Executes skills with proper context handling.
+ * Supports forked, inherited, and isolated context modes.
+ */
+import { randomUUID } from 'crypto';
+import { DEFAULT_SKILLS_CONFIG } from './types.js';
+// ============================================================================
+// Skill Executor Class
+// ============================================================================
+/**
+ * Executes skills with proper context handling.
+ * Manages context isolation, forking, and inheritance.
+ */
+export class SkillExecutor {
+    logger;
+    defaultContextMode;
+    constructor(logger, defaultContextMode) {
+        this.logger = logger.child({ component: 'SkillExecutor' });
+        this.defaultContextMode = defaultContextMode ?? DEFAULT_SKILLS_CONFIG.defaultContextMode;
+        this.logger.debug('SkillExecutor initialized', {
+            defaultContextMode: this.defaultContextMode,
+        });
+    }
+    // ==========================================================================
+    // Execution Methods
+    // ==========================================================================
+    /**
+     * 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
+     */
+    async execute(skill, context, input) {
+        const startTime = Date.now();
+        const contextMode = skill.context ?? this.defaultContextMode;
+        this.logger.debug('Executing skill', {
+            name: skill.name,
+            contextMode,
+            hasPrompt: !!input.prompt,
+            hasData: !!input.data,
+        });
+        try {
+            // Prepare execution context based on context mode
+            const executionContext = this.prepareContext(context, contextMode);
+            // Build system prompt
+            const systemPrompt = this.buildSystemPrompt(skill);
+            // Execute the skill
+            // Note: Actual execution would involve calling the provider
+            // This is a placeholder for the integration point
+            const output = await this.executeSkillLogic(skill, executionContext, input, systemPrompt);
+            const durationMs = Date.now() - startTime;
+            // Handle context modifications for inherit mode
+            const contextModifications = contextMode === 'inherit' ? this.extractContextModifications(output) : undefined;
+            this.logger.debug('Skill execution completed', {
+                name: skill.name,
+                durationMs,
+                success: true,
+            });
+            return {
+                success: true,
+                output,
+                contextModifications,
+                durationMs,
+            };
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const errorInstance = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Skill execution failed', {
+                name: skill.name,
+                durationMs,
+                error: errorInstance,
+            });
+            return {
+                success: false,
+                error: errorInstance,
+                durationMs,
+            };
+        }
+    }
+    // ==========================================================================
+    // Context Methods
+    // ==========================================================================
+    /**
+     * 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) {
+        return {
+            sessionId: parentContext.sessionId,
+            taskId: parentContext.taskId,
+            worktreePath: parentContext.worktreePath,
+            parentContext,
+            variables: { ...parentContext.variables },
+            messages: parentContext.messages ? [...parentContext.messages] : undefined,
+            metadata: parentContext.metadata ? { ...parentContext.metadata } : undefined,
+        };
+    }
+    /**
+     * 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) {
+        return {
+            sessionId,
+            variables: {},
+        };
+    }
+    /**
+     * Create a new context for a session.
+     *
+     * @param sessionId - Optional session ID (generated if not provided)
+     * @returns New skill context
+     */
+    createContext(sessionId) {
+        return {
+            sessionId: sessionId ?? randomUUID(),
+            variables: {},
+        };
+    }
+    /**
+     * Prepare execution context based on context mode.
+     *
+     * @param context - Original context
+     * @param mode - Context handling mode
+     * @returns Prepared execution context
+     */
+    prepareContext(context, mode) {
+        switch (mode) {
+            case 'fork':
+                return this.forkContext(context);
+            case 'isolated':
+                return this.createIsolatedContext(context.sessionId);
+            case 'inherit':
+            default:
+                return context;
+        }
+    }
+    // ==========================================================================
+    // System Prompt Methods
+    // ==========================================================================
+    /**
+     * Build system prompt for skill execution.
+     * Combines skill's system prompt with role information.
+     *
+     * @param skill - Skill definition
+     * @returns Built system prompt
+     */
+    buildSystemPrompt(skill) {
+        const parts = [];
+        // Add skill context
+        if (skill.displayName) {
+            parts.push(`You are executing the "${skill.displayName}" skill.`);
+        }
+        else {
+            parts.push(`You are executing the "${skill.name}" skill.`);
+        }
+        if (skill.description) {
+            parts.push(`\nSkill purpose: ${skill.description}`);
+        }
+        // Add skill's custom system prompt
+        if (skill.systemPrompt) {
+            parts.push(`\n${skill.systemPrompt}`);
+        }
+        // Add tool restrictions if specified
+        if (skill.allowedTools && skill.allowedTools.length > 0) {
+            parts.push(`\nYou are restricted to using only the following tools: ${skill.allowedTools.join(', ')}`);
+        }
+        return parts.join('');
+    }
+    // ==========================================================================
+    // Context Modification Methods
+    // ==========================================================================
+    /**
+     * 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, modifications) {
+        if (!modifications) {
+            return;
+        }
+        // Apply variable modifications
+        if (modifications['variables'] && typeof modifications['variables'] === 'object') {
+            Object.assign(parentContext.variables, modifications['variables']);
+        }
+        // Apply metadata modifications
+        if (modifications['metadata'] && typeof modifications['metadata'] === 'object') {
+            parentContext.metadata = {
+                ...parentContext.metadata,
+                ...modifications['metadata'],
+            };
+        }
+        // Apply messages modifications (append)
+        if (Array.isArray(modifications['messages'])) {
+            if (!parentContext.messages) {
+                parentContext.messages = [];
+            }
+            parentContext.messages.push(...modifications['messages']);
+        }
+        this.logger.debug('Applied context modifications', {
+            sessionId: parentContext.sessionId,
+            modifiedKeys: Object.keys(modifications),
+        });
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * 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
+     */
+    async executeSkillLogic(skill, context, input, systemPrompt) {
+        // This is a placeholder for actual execution
+        // In a real implementation, this would:
+        // 1. Resolve the provider/model based on skill.role, skill.provider, skill.model
+        // 2. Build messages from context.messages and input.prompt
+        // 3. Call the provider's complete() method
+        // 4. Return the response
+        this.logger.debug('Skill logic execution (placeholder)', {
+            name: skill.name,
+            role: skill.role,
+            provider: skill.provider,
+            model: skill.model,
+            systemPromptLength: systemPrompt.length,
+            inputPrompt: input.prompt?.substring(0, 100),
+        });
+        // Return placeholder result
+        // The actual implementation should be connected to ProviderManager
+        return {
+            status: 'executed',
+            skill: skill.name,
+            sessionId: context.sessionId,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * Extract context modifications from skill output.
+     * Looks for a specific structure in the output.
+     *
+     * @param output - Skill execution output
+     * @returns Extracted modifications or undefined
+     */
+    extractContextModifications(output) {
+        if (!output || typeof output !== 'object') {
+            return undefined;
+        }
+        const outputObj = output;
+        // Check for explicit context modifications
+        if (outputObj['contextModifications'] && typeof outputObj['contextModifications'] === 'object') {
+            return outputObj['contextModifications'];
+        }
+        // Check for implicit modifications (variables, metadata, messages keys at top level)
+        const implicitMods = {};
+        let hasImplicit = false;
+        if (outputObj['variables'] && typeof outputObj['variables'] === 'object') {
+            implicitMods['variables'] = outputObj['variables'];
+            hasImplicit = true;
+        }
+        if (outputObj['metadata'] && typeof outputObj['metadata'] === 'object') {
+            implicitMods['metadata'] = outputObj['metadata'];
+            hasImplicit = true;
+        }
+        if (Array.isArray(outputObj['messages'])) {
+            implicitMods['messages'] = outputObj['messages'];
+            hasImplicit = true;
+        }
+        return hasImplicit ? implicitMods : undefined;
+    }
+}
+//# sourceMappingURL=skill-executor.js.map

package/dist/skills/skill-executor.js.map

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

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

@@ -0,0 +1,147 @@
+/**
+ * Skill Loader
+ *
+ * Loads and manages skill definitions from YAML/JSON files.
+ * Handles file discovery, parsing, validation, and registration.
+ */
+import type { Logger } from '../observability/logger.js';
+import type { SkillDefinition, SkillsConfig, SkillValidationResult, SkillMatch } from './types.js';
+/**
+ * Loads and manages skill definitions from files.
+ * Provides methods for discovery, parsing, validation, and querying.
+ */
+export declare class SkillLoader {
+    private skills;
+    private config;
+    private logger;
+    private cooldownTracker;
+    constructor(config: Partial<SkillsConfig>, logger: Logger);
+    /**
+     * Load all skills from configured search paths.
+     * Searches each path in order and registers found skills.
+     */
+    loadAll(): Promise<void>;
+    /**
+     * Load skills from a specific directory.
+     * Returns array of successfully loaded skill definitions.
+     *
+     * @param dirPath - Directory path to search
+     * @returns Array of loaded skill definitions
+     */
+    loadFromDirectory(dirPath: string): Promise<SkillDefinition[]>;
+    /**
+     * Load a single skill file.
+     * Parses, validates, and registers the skill.
+     *
+     * @param filePath - Path to the skill file
+     * @returns Loaded skill definition or null if failed
+     */
+    loadSkillFile(filePath: string): Promise<SkillDefinition | null>;
+    /**
+     * Parse skill definition from file content.
+     * Supports YAML and JSON formats.
+     *
+     * @param content - File content
+     * @param filePath - Path to file (for error messages and format detection)
+     * @returns Parsed skill definition
+     */
+    parseSkill(content: string, filePath: string): SkillDefinition;
+    /**
+     * Normalize parsed skill object to SkillDefinition.
+     * Applies defaults and type coercion.
+     */
+    private normalizeSkill;
+    /**
+     * Parse triggers array from raw data.
+     */
+    private parseTriggers;
+    /**
+     * Parse context mode from raw value.
+     */
+    private parseContextMode;
+    /**
+     * Validate a skill definition.
+     * Returns validation result with errors and warnings.
+     *
+     * @param skill - Skill definition to validate
+     * @returns Validation result
+     */
+    validateSkill(skill: SkillDefinition): SkillValidationResult;
+    /**
+     * Register a skill programmatically.
+     * Overwrites existing skill with same name.
+     *
+     * @param skill - Skill definition to register
+     */
+    register(skill: SkillDefinition): void;
+    /**
+     * Unregister a skill by name.
+     *
+     * @param name - Skill name to unregister
+     * @returns True if skill was found and removed
+     */
+    unregister(name: string): boolean;
+    /**
+     * Check if a skill exists.
+     *
+     * @param name - Skill name
+     * @returns True if skill is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Clear all loaded skills.
+     */
+    clear(): void;
+    /**
+     * Get all loaded skills.
+     *
+     * @returns Array of all skill definitions
+     */
+    getAllSkills(): SkillDefinition[];
+    /**
+     * Get skill by name.
+     *
+     * @param name - Skill name
+     * @returns Skill definition or undefined if not found
+     */
+    getSkill(name: string): SkillDefinition | undefined;
+    /**
+     * Get the file path for a skill.
+     *
+     * @param name - Skill name
+     * @returns Source file path or undefined
+     */
+    getSkillPath(name: string): string | undefined;
+    /**
+     * Get skills matching trigger conditions.
+     * Returns skills sorted by confidence score (highest first).
+     *
+     * @param context - Trigger context to match against
+     * @returns Array of matching skills with confidence scores
+     */
+    getMatchingSkills(context: {
+        keywords?: string[];
+        event?: string;
+        text?: string;
+    }): SkillMatch[];
+    /**
+     * Reload a specific skill from its source file.
+     *
+     * @param name - Skill name to reload
+     * @returns True if skill was successfully reloaded
+     */
+    reloadSkill(name: string): Promise<boolean>;
+    /**
+     * Expand ~ in paths to home directory.
+     */
+    private expandPath;
+    /**
+     * Check if filename matches skill file patterns.
+     */
+    private isSkillFile;
+    /**
+     * Match a trigger against the provided context.
+     */
+    private matchTrigger;
+}
+//# sourceMappingURL=skill-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skills/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,qBAAqB,EACrB,UAAU,EAEX,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAkC;gBAE7C,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM;IAezD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B;;;;;;OAMG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4CpE;;;;;;OAMG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAmDtE;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe;IA8B9D;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,qBAAqB;IAmG5D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IActC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASjC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;OAIG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,UAAU,EAAE;IAmChB;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAejD;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAwErB"}