@nexus-cortex/executors 4.26.0

package/dist/implementations/extensions/SkillTool.js

@@ -0,0 +1,351 @@
+/**
+ * Skill Tool - Invoke specialized skills from .agents/skills/ or .cortex/skills/
+ *
+ * Loads and invokes skills defined as directories containing SKILL.md files
+ * with YAML frontmatter. Skills are model-invoked capabilities that extend
+ * the agent's functionality.
+ *
+ * Search order: .agents/skills/ → .cortex/skills/ → ~/.cortex/skills/
+ */
+import { BaseTool } from '../../base/index.js';
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { homedir } from 'node:os';
+/**
+ * Skill Tool Executor
+ *
+ * Invokes specialized skills from skill directories.
+ * Skills are model-invoked capabilities defined in SKILL.md files.
+ *
+ * Example skill directory structure:
+ * ```
+ * .agents/skills/pdf-documents/
+ * ├── SKILL.md          # Required: skill definition
+ * ├── sections/         # Optional: spoke files referenced by hub
+ * ├── reference.md      # Optional: reference docs
+ * └── scripts/          # Optional: helper scripts
+ * ```
+ *
+ * Search order (first match wins — cwd-specific overrides/extends central):
+ * 1. Project `.agents/skills/` (cwd-specific overlay — cross-harness convention)
+ * 2. Project `.cortex/skills/` (cwd-specific overlay — nexus-cortex native)
+ * 3. Central `~/.agents/skills/` (the universal master list, shared across cwds)
+ * 4. Personal `~/.cortex/skills/` (nexus-cortex personal skills)
+ *
+ * Skills are mostly universal, so they live centrally in `~/.agents/skills/`
+ * and are reachable from any cwd; a project may add cwd-specific skills (or
+ * override a central one) by name in its own `.agents/skills/`, searched first.
+ *
+ * Usage: Skill({ command: "pdf-documents" })
+ */
+export class SkillToolExecutor extends BaseTool {
+    skillsCache = null;
+    skillsDirs;
+    constructor(config) {
+        super('Skill', 'Skill', 'Invoke specialized skills', {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'Use "list" to see all available skills, or a skill name to load it. E.g., "list", "pdf-documents", "spacetimedb-rust"',
+                },
+            },
+            required: ['command'],
+        });
+        this.skillsDirs = [
+            // cwd-specific overlay (searched first → overrides/extends the central list)
+            { path: join(config.workingDirectory, '.agents', 'skills'), location: 'project' },
+            { path: join(config.workingDirectory, '.cortex', 'skills'), location: 'project' },
+            // central universal master list (shared across all cwds) + nexus-cortex personal
+            { path: join(homedir(), '.agents', 'skills'), location: 'central' },
+            { path: join(homedir(), '.cortex', 'skills'), location: 'personal' },
+            // shipped/builtin tier (lowest priority) — $CORTEX_ROOT/.cortex/skills, the
+            // skills packed with the install (git clone root, or the npm package's vendored
+            // scaffold). Mirrors AgentStore's builtin agent tier. Absent when CORTEX_ROOT
+            // is unset; a missing dir is skipped harmlessly at load time.
+            ...(process.env.CORTEX_ROOT
+                ? [{ path: join(process.env.CORTEX_ROOT, '.cortex', 'skills'), location: 'builtin' }]
+                : []),
+        ];
+    }
+    validateToolParams(params) {
+        if (!params.command || typeof params.command !== 'string') {
+            return 'command must be a non-empty string';
+        }
+        // Trim and validate skill name
+        const trimmedCommand = params.command.trim();
+        if (!trimmedCommand) {
+            return 'command must be a non-empty string';
+        }
+        // Skill names should be simple (no slashes, no special chars except hyphens)
+        if (!/^[a-zA-Z0-9-]+$/.test(trimmedCommand)) {
+            return 'skill name must contain only letters, numbers, and hyphens';
+        }
+        return null;
+    }
+    getDescription(params) {
+        if (params.command?.trim() === 'list')
+            return 'Listing available skills';
+        return `Invoking skill: ${params.command}`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: { executionTime: Date.now() - startTime },
+                };
+            }
+            // Parse skill name
+            const skillName = params.command.trim();
+            // Handle "list" command — enumerate all available skills
+            if (skillName === 'list') {
+                if (!this.skillsCache) {
+                    await this.loadAllSkills(signal);
+                }
+                const listing = this.formatSkillListing();
+                return {
+                    ...this.createSuccessResult(listing),
+                    metadata: { executionTime: Date.now() - startTime },
+                };
+            }
+            // Load skill definition
+            const skillDef = await this.loadSkill(skillName, signal);
+            if (!skillDef) {
+                return {
+                    ...this.createErrorResult(`Skill '${skillName}' not found.\n` +
+                        `Searched: .agents/skills/, .cortex/skills/, ~/.agents/skills/, ~/.cortex/skills/\n\n` +
+                        `Available skills: ${await this.getAvailableSkills()}`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        skillName,
+                    },
+                };
+            }
+            // Return the skill's content
+            const output = this.formatSkillOutput(skillDef);
+            return {
+                ...this.createSuccessResult(output),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    skillName: skillDef.name,
+                    location: skillDef.location,
+                    description: skillDef.description,
+                    allowedTools: skillDef.allowedTools,
+                },
+            };
+        }
+        catch (error) {
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Skill invocation was cancelled'),
+                    metadata: { executionTime: Date.now() - startTime },
+                };
+            }
+            return {
+                ...this.createErrorResult(`Error invoking skill: ${error.message || String(error)}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: error.message || String(error),
+                },
+            };
+        }
+    }
+    /**
+     * Load skill definition from .cortex/skills/ directories
+     * Searches project skills first, then personal skills
+     */
+    async loadSkill(skillName, signal) {
+        // Load all skills if not cached
+        if (!this.skillsCache) {
+            await this.loadAllSkills(signal);
+        }
+        if (!this.skillsCache) {
+            return null;
+        }
+        return this.skillsCache.get(skillName) || null;
+    }
+    /**
+     * Load all skill definitions from project and personal directories.
+     * First match wins — earlier dirs in skillsDirs take precedence.
+     */
+    async loadAllSkills(signal) {
+        this.skillsCache = new Map();
+        for (const dir of this.skillsDirs) {
+            await this.loadSkillsFromDirectory(dir.path, dir.location, signal);
+        }
+    }
+    /**
+     * Load skills from a specific directory
+     */
+    async loadSkillsFromDirectory(baseDir, location, signal) {
+        try {
+            // Check if directory exists
+            try {
+                await fs.access(baseDir);
+            }
+            catch {
+                // Directory doesn't exist, skip
+                return;
+            }
+            // Find all SKILL.md files in skill directories
+            const skillFiles = await glob('*/SKILL.md', {
+                cwd: baseDir,
+                nodir: true,
+                dot: false,
+                signal,
+            });
+            // Load each skill
+            for (const file of skillFiles) {
+                const parts = file.split('/');
+                const skillDir = parts[0] || ''; // Get directory name
+                if (!skillDir)
+                    continue; // Skip if no directory
+                const skillPath = join(baseDir, file);
+                const skillDef = await this.parseSkillFile(skillPath, skillDir, location);
+                if (skillDef && !this.skillsCache.has(skillDef.name)) {
+                    // Only add if not already present (project skills take precedence)
+                    this.skillsCache.set(skillDef.name, skillDef);
+                }
+            }
+        }
+        catch (error) {
+            // Silently fail if directory doesn't exist or can't be read
+            if (error.code !== 'ENOENT') {
+                console.error(`[Skill] Error loading skills from ${baseDir}: ${error.message}`);
+            }
+        }
+    }
+    /**
+     * Parse skill definition from SKILL.md file
+     *
+     * Format:
+     * ```markdown
+     * ---
+     * name: skill-name
+     * description: What this skill does
+     * allowed-tools: Read, Write, Grep  # Optional
+     * ---
+     *
+     * # Skill Name
+     *
+     * ## Instructions
+     * Step-by-step guidance...
+     * ```
+     */
+    async parseSkillFile(filePath, skillDir, location) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Extract frontmatter and body
+            const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
+            if (!frontmatterMatch) {
+                console.error(`[Skill] Invalid SKILL.md format: ${filePath} (missing frontmatter)`);
+                return null;
+            }
+            const frontmatterText = frontmatterMatch[1] || '';
+            const body = frontmatterMatch[2] || '';
+            // Parse frontmatter
+            const frontmatter = this.parseFrontmatter(frontmatterText);
+            // Get skill name (from frontmatter or fallback to directory name)
+            const skillName = frontmatter.name || skillDir;
+            // Parse allowed-tools if present
+            let allowedTools;
+            if (frontmatter['allowed-tools']) {
+                allowedTools = frontmatter['allowed-tools']
+                    .split(',')
+                    .map((tool) => tool.trim())
+                    .filter(Boolean);
+            }
+            return {
+                name: skillName,
+                description: frontmatter.description || `Skill: ${skillName}`,
+                allowedTools,
+                content: body.trim(),
+                location,
+                path: filePath,
+            };
+        }
+        catch (error) {
+            console.error(`[Skill] Error parsing skill file ${filePath}: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Simple YAML frontmatter parser
+     * Handles basic key: value pairs
+     */
+    parseFrontmatter(text) {
+        const result = {};
+        const lines = text.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^(\S+):\s*(.*)$/);
+            if (match && match[1] && match[2] !== undefined) {
+                const key = match[1].trim();
+                const value = match[2].trim();
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Format skill output for display
+     */
+    formatSkillOutput(skillDef) {
+        const parts = [];
+        // Skill header
+        parts.push(`# Skill: ${skillDef.name}`);
+        parts.push('');
+        parts.push(`**Description**: ${skillDef.description}`);
+        parts.push(`**Location**: ${skillDef.path}`);
+        if (skillDef.allowedTools && skillDef.allowedTools.length > 0) {
+            parts.push(`**Allowed Tools**: ${skillDef.allowedTools.join(', ')}`);
+        }
+        parts.push('');
+        parts.push('---');
+        parts.push('');
+        // Skill content (instructions)
+        parts.push(skillDef.content);
+        return parts.join('\n');
+    }
+    /**
+     * Format a readable listing of all available skills
+     */
+    formatSkillListing() {
+        if (!this.skillsCache || this.skillsCache.size === 0) {
+            return 'No skills found.\n\nSkill directories searched:\n- .agents/skills/\n- .cortex/skills/\n- ~/.agents/skills/\n- ~/.cortex/skills/';
+        }
+        const parts = [];
+        parts.push(`# Available Skills (${this.skillsCache.size})\n`);
+        for (const skill of this.skillsCache.values()) {
+            parts.push(`- **${skill.name}** (${skill.location}): ${skill.description}`);
+        }
+        parts.push('');
+        parts.push('To load a skill: `Skill({ command: "skill-name" })`');
+        return parts.join('\n');
+    }
+    /**
+     * Get list of available skills (for error messages)
+     */
+    async getAvailableSkills() {
+        if (!this.skillsCache) {
+            await this.loadAllSkills(new AbortController().signal);
+        }
+        if (!this.skillsCache || this.skillsCache.size === 0) {
+            return '(none found)';
+        }
+        return Array.from(this.skillsCache.values())
+            .map((skill) => `${skill.name} (${skill.location})`)
+            .join(', ');
+    }
+    /**
+     * Clear the skills cache (useful for testing or reloading)
+     */
+    clearCache() {
+        this.skillsCache = null;
+    }
+}
+//# sourceMappingURL=SkillTool.js.map

package/dist/implementations/extensions/SkillTool.js.map

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

package/dist/implementations/extensions/SlashCommandTool.d.ts

@@ -0,0 +1,112 @@
+/**
+ * SlashCommand Tool - Execute custom slash commands from .cortex/commands/
+ *
+ * Loads and executes custom commands defined in Markdown files with YAML frontmatter.
+ * Supports argument substitution using $1, $2, etc.
+ *
+ * Command Format (.md files):
+ * ```markdown
+ * ---
+ * description: Command description
+ * argument-hint: [arg1] [arg2]
+ * ---
+ *
+ * Command body with $1 and $2 placeholders
+ * ```
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+/**
+ * Parameters for the SlashCommand tool
+ */
+export interface SlashCommandParams {
+    /** The slash command to execute with its arguments (e.g., "/review-pr 123") */
+    command: string;
+}
+/**
+ * SlashCommand Tool Executor
+ *
+ * Executes custom slash commands from .cortex/commands/ directory.
+ * Commands are defined in Markdown files with YAML frontmatter.
+ *
+ * Example command file (.cortex/commands/review-pr.md):
+ * ```markdown
+ * ---
+ * description: Review a pull request
+ * argument-hint: [pr-number]
+ * ---
+ *
+ * Review pull request #$1
+ *
+ * Instructions:
+ * 1. Fetch PR details from GitHub
+ * 2. Analyze the code changes
+ * 3. Provide feedback
+ * ```
+ *
+ * Usage: SlashCommand({ command: "/review-pr 123" })
+ */
+export declare class SlashCommandToolExecutor extends BaseTool<SlashCommandParams, ToolResult> {
+    private commandsCache;
+    private commandsDir;
+    constructor(config: {
+        workingDirectory: string;
+    });
+    validateToolParams(params: SlashCommandParams): string | null;
+    getDescription(params: SlashCommandParams): string;
+    execute(params: SlashCommandParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Parse command string into name and arguments
+     * Example: "/review-pr 123 --verbose" → { commandName: "review-pr", args: ["123", "--verbose"] }
+     */
+    private parseCommand;
+    /**
+     * Parse just the command name (for display purposes)
+     */
+    private parseCommandName;
+    /**
+     * Load command definition from .cortex/commands/ directory
+     * Supports recursive directory structure
+     */
+    private loadCommand;
+    /**
+     * Load all command definitions from .cortex/commands/
+     */
+    private loadAllCommands;
+    /**
+     * Parse command definition from .md file
+     *
+     * Format:
+     * ```markdown
+     * ---
+     * description: Command description
+     * argument-hint: [arg1] [arg2]
+     * ---
+     *
+     * Command body with $1 and $2 placeholders
+     * ```
+     */
+    private parseCommandFile;
+    /**
+     * Simple YAML frontmatter parser
+     * Handles basic key: value pairs
+     */
+    private parseFrontmatter;
+    /**
+     * Substitute arguments in command body
+     * Replaces $1, $2, etc. with actual argument values
+     */
+    private substituteArguments;
+    /**
+     * Format command output for display
+     */
+    private formatCommandOutput;
+    /**
+     * Get list of available commands (for error messages)
+     */
+    private getAvailableCommands;
+    /**
+     * Clear the commands cache (useful for testing or reloading)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=SlashCommandTool.d.ts.map

package/dist/implementations/extensions/SlashCommandTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/extensions/SlashCommandTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKhE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ,CACpD,kBAAkB,EAClB,UAAU,CACX;IACC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAqBhD,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI;IAgB7D,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAK5C,OAAO,CACX,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAuEtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;OAGG;YACW,WAAW;IAgBzB;;OAEG;YACW,eAAe;IAqC7B;;;;;;;;;;;;OAYG;YACW,gBAAgB;IAqC9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;YACW,oBAAoB;IAclC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}