attocode 0.2.3 → 0.2.5

package/dist/src/integrations/skills/skill-executor.js

@@ -0,0 +1,270 @@
+/**
+ * Skill Executor
+ *
+ * Handles invocation of skills with argument parsing and template substitution.
+ * Skills can be invoked like commands: /review --file src/main.ts --focus security
+ */
+// =============================================================================
+// SKILL EXECUTOR
+// =============================================================================
+/**
+ * Executes invokable skills with argument parsing and template substitution.
+ */
+export class SkillExecutor {
+    skillManager;
+    eventListeners = new Set();
+    constructor(skillManager) {
+        this.skillManager = skillManager;
+    }
+    /**
+     * Check if an input string is a potential skill invocation.
+     * Returns the skill name if it matches, null otherwise.
+     */
+    isSkillInvocation(input) {
+        if (!input.startsWith('/'))
+            return null;
+        const parts = input.split(/\s+/);
+        const cmdName = parts[0].slice(1); // Remove leading /
+        const skill = this.skillManager.getSkill(cmdName);
+        if (skill && skill.invokable) {
+            return cmdName;
+        }
+        return null;
+    }
+    /**
+     * Parse command-line style arguments.
+     */
+    parseArguments(skill, rawArgs) {
+        const result = {
+            named: {},
+            positional: [],
+            errors: [],
+        };
+        const argDefs = skill.arguments || [];
+        // Build alias map
+        const aliasMap = new Map();
+        for (const arg of argDefs) {
+            aliasMap.set(`--${arg.name}`, arg);
+            if (arg.aliases) {
+                for (const alias of arg.aliases) {
+                    aliasMap.set(alias, arg);
+                }
+            }
+        }
+        // Parse arguments
+        let i = 0;
+        while (i < rawArgs.length) {
+            const token = rawArgs[i];
+            if (token.startsWith('-')) {
+                // Check for --flag=value syntax
+                const eqIndex = token.indexOf('=');
+                let key;
+                let value;
+                if (eqIndex !== -1) {
+                    key = token.slice(0, eqIndex);
+                    value = token.slice(eqIndex + 1);
+                }
+                else {
+                    key = token;
+                }
+                const argDef = aliasMap.get(key);
+                if (argDef) {
+                    // Get value
+                    if (argDef.type === 'boolean') {
+                        result.named[argDef.name] = value !== undefined ? value === 'true' : true;
+                    }
+                    else {
+                        if (value === undefined) {
+                            i++;
+                            if (i < rawArgs.length && !rawArgs[i].startsWith('-')) {
+                                value = rawArgs[i];
+                            }
+                            else {
+                                result.errors.push(`Missing value for argument: ${key}`);
+                                continue;
+                            }
+                        }
+                        // Type conversion
+                        if (argDef.type === 'number') {
+                            const num = parseFloat(value);
+                            if (isNaN(num)) {
+                                result.errors.push(`Invalid number for ${argDef.name}: ${value}`);
+                            }
+                            else {
+                                result.named[argDef.name] = num;
+                            }
+                        }
+                        else {
+                            result.named[argDef.name] = value;
+                        }
+                    }
+                }
+                else {
+                    // Unknown argument - treat as positional? Or error?
+                    result.errors.push(`Unknown argument: ${key}`);
+                }
+            }
+            else {
+                result.positional.push(token);
+            }
+            i++;
+        }
+        // Apply defaults
+        for (const arg of argDefs) {
+            if (result.named[arg.name] === undefined && arg.default !== undefined) {
+                result.named[arg.name] = arg.default;
+            }
+        }
+        // Check required arguments
+        for (const arg of argDefs) {
+            if (arg.required && result.named[arg.name] === undefined) {
+                result.errors.push(`Missing required argument: --${arg.name}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * Substitute template variables in skill content.
+     * Variables are in the form {{name}} or {{name|default}}.
+     */
+    substituteTemplate(content, args) {
+        return content.replace(/\{\{(\w+)(?:\|([^}]*))?\}\}/g, (match, name, defaultVal) => {
+            if (args.named[name] !== undefined) {
+                return String(args.named[name]);
+            }
+            if (defaultVal !== undefined) {
+                return defaultVal;
+            }
+            return match; // Keep original if no value
+        });
+    }
+    /**
+     * Execute a skill by name with arguments.
+     */
+    async executeSkill(skillName, rawArgs, ctx) {
+        this.emit({ type: 'skill.invoke.start', skillName, args: rawArgs });
+        const skill = this.skillManager.getSkill(skillName);
+        if (!skill) {
+            const error = `Skill not found: ${skillName}`;
+            this.emit({ type: 'skill.invoke.error', skillName, error });
+            return { success: false, output: '', error };
+        }
+        if (!skill.invokable) {
+            const error = `Skill "${skillName}" is not invokable. It can only be activated passively.`;
+            this.emit({ type: 'skill.invoke.error', skillName, error });
+            return { success: false, output: '', error };
+        }
+        // Parse arguments
+        const parsed = this.parseArguments(skill, rawArgs);
+        this.emit({ type: 'skill.invoke.parsed', skillName, parsed });
+        if (parsed.errors.length > 0) {
+            const error = `Argument errors:\n${parsed.errors.map(e => `  - ${e}`).join('\n')}\n\n${this.formatSkillHelp(skill)}`;
+            this.emit({ type: 'skill.invoke.error', skillName, error });
+            return { success: false, output: '', error };
+        }
+        // Add positional args as a special variable
+        if (parsed.positional.length > 0) {
+            parsed.named['_positional'] = parsed.positional.join(' ');
+            parsed.named['_args'] = parsed.positional;
+        }
+        // Add context variables
+        parsed.named['_cwd'] = ctx.cwd;
+        if (ctx.sessionId) {
+            parsed.named['_sessionId'] = ctx.sessionId;
+        }
+        // Substitute template variables in content
+        const processedContent = this.substituteTemplate(skill.content, parsed);
+        // For prompt-injection mode, create the injected prompt
+        if (skill.executionMode === 'prompt-injection' || !skill.executionMode) {
+            const injectedPrompt = this.buildInjectedPrompt(skill, processedContent, parsed);
+            const result = {
+                success: true,
+                output: `Skill "${skillName}" activated with injected prompt.`,
+                injectedPrompt,
+            };
+            this.emit({ type: 'skill.invoke.complete', skillName, result });
+            return result;
+        }
+        // Workflow mode would require running multiple steps
+        // For now, treat it like prompt-injection
+        const injectedPrompt = this.buildInjectedPrompt(skill, processedContent, parsed);
+        const result = {
+            success: true,
+            output: `Skill "${skillName}" activated in workflow mode.`,
+            injectedPrompt,
+        };
+        this.emit({ type: 'skill.invoke.complete', skillName, result });
+        return result;
+    }
+    /**
+     * Build the prompt to inject based on skill content and arguments.
+     */
+    buildInjectedPrompt(skill, content, args) {
+        const parts = [];
+        parts.push(`<skill name="${skill.name}">`);
+        parts.push(content);
+        // Add argument context if any were provided
+        const namedArgs = Object.entries(args.named)
+            .filter(([k]) => !k.startsWith('_'))
+            .map(([k, v]) => `  ${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        if (namedArgs) {
+            parts.push(`\n<arguments>\n${namedArgs}\n</arguments>`);
+        }
+        parts.push('</skill>');
+        return parts.join('\n');
+    }
+    /**
+     * Format help text for a skill.
+     */
+    formatSkillHelp(skill) {
+        const lines = [
+            `Usage: /${skill.name} [options]`,
+            '',
+            skill.description,
+        ];
+        if (skill.arguments && skill.arguments.length > 0) {
+            lines.push('', 'Options:');
+            for (const arg of skill.arguments) {
+                const aliases = arg.aliases ? arg.aliases.join(', ') + ', ' : '';
+                const required = arg.required ? ' (required)' : '';
+                const defaultVal = arg.default !== undefined ? ` [default: ${arg.default}]` : '';
+                lines.push(`  ${aliases}--${arg.name}  ${arg.description}${required}${defaultVal}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get all invokable skills.
+     */
+    getInvokableSkills() {
+        return this.skillManager.getAllSkills().filter(s => s.invokable);
+    }
+    /**
+     * Subscribe to executor events.
+     */
+    subscribe(listener) {
+        this.eventListeners.add(listener);
+        return () => this.eventListeners.delete(listener);
+    }
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Create a skill executor.
+ */
+export function createSkillExecutor(skillManager) {
+    return new SkillExecutor(skillManager);
+}
+//# sourceMappingURL=skill-executor.js.map

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

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

package/dist/src/integrations/skills/skills.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Skills Standard (Crush-inspired)
+ *
+ * Discoverable skill packages that provide specialized agent capabilities.
+ * Skills are defined as markdown files with YAML frontmatter containing
+ * metadata like name, description, and required tools.
+ *
+ * Directory structure (priority: later overrides earlier):
+ * - Built-in skills: attocode/skills/
+ * - User skills: ~/.attocode/skills/
+ * - Project skills: .attocode/skills/
+ * - Legacy paths (.agent/) supported for backward compatibility
+ *
+ * Usage:
+ *   const skills = createSkillManager({ directories: getDefaultSkillDirectories() });
+ *   await skills.loadSkills();
+ *   await skills.activateSkill('code-review', context);
+ */
+/**
+ * Skill argument definition for invokable skills.
+ */
+export interface SkillArgument {
+    /** Argument name (used in templates as {{name}}) */
+    name: string;
+    /** Human-readable description shown in help */
+    description: string;
+    /** Argument type for validation */
+    type: 'string' | 'boolean' | 'file' | 'number';
+    /** Whether this argument is required */
+    required?: boolean;
+    /** Default value if not provided */
+    default?: unknown;
+    /** CLI aliases (e.g., ['-f', '--file']) */
+    aliases?: string[];
+}
+/**
+ * Skill source type for display and management.
+ */
+export type SkillSourceType = 'builtin' | 'user' | 'project' | 'legacy';
+/**
+ * Skill definition from SKILL.md or skill.md file.
+ */
+export interface Skill {
+    /** Unique skill name (derived from directory or frontmatter) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Tools this skill can use */
+    tools: string[];
+    /** The markdown content (instructions for the agent) */
+    content: string;
+    /** Source file path */
+    sourcePath: string;
+    /** Source type (builtin, user, project, legacy) */
+    sourceType?: SkillSourceType;
+    /** Optional version */
+    version?: string;
+    /** Optional author */
+    author?: string;
+    /** Optional tags for discovery */
+    tags?: string[];
+    /** Whether this skill is active */
+    active?: boolean;
+    /** When to auto-activate this skill */
+    triggers?: SkillTrigger[];
+    /** Whether this skill can be invoked via /skillname command */
+    invokable?: boolean;
+    /** Arguments for invokable skills */
+    arguments?: SkillArgument[];
+    /** Execution mode: prompt-injection (default) or workflow (multi-step) */
+    executionMode?: 'prompt-injection' | 'workflow';
+}
+/**
+ * Skill trigger definition.
+ */
+export interface SkillTrigger {
+    /** Trigger type */
+    type: 'keyword' | 'file_pattern' | 'context';
+    /** Pattern to match */
+    pattern: string;
+}
+/**
+ * Skill manager configuration.
+ */
+export interface SkillsConfig {
+    /** Enable/disable skills */
+    enabled?: boolean;
+    /** Directories to search for skills */
+    directories?: string[];
+    /** Whether to load built-in skills */
+    loadBuiltIn?: boolean;
+    /** Auto-activate skills based on triggers */
+    autoActivate?: boolean;
+}
+/**
+ * Skill event types.
+ */
+export type SkillEvent = {
+    type: 'skill.loaded';
+    name: string;
+    path: string;
+} | {
+    type: 'skill.activated';
+    name: string;
+} | {
+    type: 'skill.deactivated';
+    name: string;
+} | {
+    type: 'skill.error';
+    name: string;
+    error: string;
+};
+export type SkillEventListener = (event: SkillEvent) => void;
+/**
+ * Default skill directories with priority hierarchy:
+ * built-in < ~/.attocode/ < .attocode/ (later entries override earlier)
+ *
+ * Legacy paths (.agent/) are included for backward compatibility.
+ */
+export declare function getDefaultSkillDirectories(): string[];
+/**
+ * Get the directory where new skills should be created.
+ * Prefers .attocode/skills/ in the project root.
+ */
+export declare function getSkillCreationDirectory(): string;
+/**
+ * Get the user-level skill directory.
+ */
+export declare function getUserSkillDirectory(): string;
+/**
+ * Determine the source type of a skill based on its path.
+ */
+export declare function getSkillSourceType(skillPath: string): SkillSourceType;
+/**
+ * Get a human-readable location string for a skill.
+ */
+export declare function getSkillLocationDisplay(skill: Skill): string;
+/**
+ * Manages skill discovery, loading, and activation.
+ */
+export declare class SkillManager {
+    private config;
+    private skills;
+    private activeSkills;
+    private eventListeners;
+    constructor(config?: SkillsConfig);
+    /**
+     * Load skills from all configured directories.
+     */
+    loadSkills(): Promise<number>;
+    /**
+     * Load skills from a specific directory.
+     */
+    loadSkillsFromDirectory(directory: string): Promise<number>;
+    /**
+     * Load a skill from a subdirectory (expects SKILL.md).
+     */
+    private loadSkillFromSubdirectory;
+    /**
+     * Load a skill from a markdown file.
+     */
+    private loadSkillFromFile;
+    /**
+     * Get a skill by name.
+     */
+    getSkill(name: string): Skill | undefined;
+    /**
+     * Get all loaded skills.
+     */
+    getAllSkills(): Skill[];
+    /**
+     * Get active skills.
+     */
+    getActiveSkills(): Skill[];
+    /**
+     * Activate a skill.
+     */
+    activateSkill(name: string): boolean;
+    /**
+     * Deactivate a skill.
+     */
+    deactivateSkill(name: string): boolean;
+    /**
+     * Check if a skill is active.
+     */
+    isSkillActive(name: string): boolean;
+    /**
+     * Get the combined system prompt from all active skills.
+     */
+    getActiveSkillsPrompt(): string;
+    /**
+     * Get tools required by active skills.
+     */
+    getActiveSkillTools(): string[];
+    /**
+     * Find skills matching keywords in a query.
+     */
+    findMatchingSkills(query: string): Skill[];
+    /**
+     * Subscribe to skill events.
+     */
+    subscribe(listener: SkillEventListener): () => void;
+    /**
+     * Cleanup resources.
+     */
+    cleanup(): void;
+    private emit;
+}
+/**
+ * Create a skill manager.
+ */
+export declare function createSkillManager(config?: SkillsConfig): SkillManager;
+/**
+ * Format skills list for display.
+ */
+export declare function formatSkillList(skills: Skill[]): string;
+/**
+ * Create a sample skill file content (basic).
+ */
+export declare function getSampleSkillContent(name: string, description: string): string;
+/**
+ * Get a skill scaffold template with all options.
+ */
+export declare function getSkillScaffold(name: string, options?: {
+    invokable?: boolean;
+    description?: string;
+    args?: Array<{
+        name: string;
+        description: string;
+        type?: string;
+        required?: boolean;
+    }>;
+    triggers?: string[];
+}): string;
+/**
+ * Result of creating a skill scaffold.
+ */
+export interface SkillScaffoldResult {
+    success: boolean;
+    path?: string;
+    error?: string;
+}
+/**
+ * Create a skill scaffold in the .attocode/skills/ directory.
+ */
+export declare function createSkillScaffold(name: string, options?: {
+    invokable?: boolean;
+    description?: string;
+    args?: Array<{
+        name: string;
+        description: string;
+        type?: string;
+        required?: boolean;
+    }>;
+    triggers?: string[];
+    userLevel?: boolean;
+}): Promise<SkillScaffoldResult>;
+/**
+ * Get statistics about loaded skills by source.
+ */
+export declare function getSkillStats(skills: Skill[]): Record<SkillSourceType, number>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/src/integrations/skills/skills.d.ts.map

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