@revealui/ai 0.1.0

package/dist/skills/parser/skill-md-parser.js

@@ -0,0 +1,242 @@
+/**
+ * SKILL.md Parser
+ *
+ * Parses SKILL.md files to extract YAML frontmatter and markdown instructions.
+ */
+import { SkillMetadataSchema } from '../types.js';
+// ---------------------------------------------------------------------------
+// Minimal YAML parser/stringifier — replaces the `yaml` package.
+// Handles the flat key-value + block-sequence subset used in SKILL.md files.
+// ---------------------------------------------------------------------------
+function yamlParseScalar(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    if (s === 'true')
+        return true;
+    if (s === 'false')
+        return false;
+    if (s === 'null' || s === '~')
+        return null;
+    if (/^-?\d+$/.test(s))
+        return Number(s);
+    if (/^-?\d+\.\d+$/.test(s))
+        return Number(s);
+    return s;
+}
+function yamlParseString(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function yamlParse(input) {
+    const result = {};
+    const lines = input.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i++];
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const valuePart = line.slice(colonIdx + 1).trim();
+        if (valuePart === '') {
+            // Inline array: key: [a, b]  OR  block sequence (items follow indented with `- `)
+            const peek = lines[i]?.trim() ?? '';
+            if (peek.startsWith('[')) {
+                // inline — handled below on next iteration; should not happen in this branch
+            }
+            const items = [];
+            while (i < lines.length) {
+                const next = lines[i].trim();
+                if (next.startsWith('- ')) {
+                    items.push(yamlParseString(next.slice(2).trim()));
+                    i++;
+                }
+                else if (next === '-') {
+                    items.push('');
+                    i++;
+                }
+                else {
+                    break;
+                }
+            }
+            if (items.length > 0)
+                result[key] = items;
+        }
+        else if (valuePart.startsWith('[') && valuePart.endsWith(']')) {
+            result[key] = valuePart
+                .slice(1, -1)
+                .split(',')
+                .map((s) => yamlParseString(s.trim()))
+                .filter(Boolean);
+        }
+        else {
+            result[key] = yamlParseScalar(valuePart);
+        }
+    }
+    return result;
+}
+function yamlQuote(s) {
+    if (s === '' ||
+        s === 'true' ||
+        s === 'false' ||
+        s === 'null' ||
+        /[:#[\]{}&*!|>'"@`]/.test(s) ||
+        /^\s|\s$/.test(s) ||
+        /^[\d-]/.test(s)) {
+        return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return s;
+}
+function yamlStringify(obj, indent = 2) {
+    const pad = ' '.repeat(indent);
+    const lines = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            lines.push(`${key}:`);
+            for (const item of value) {
+                lines.push(`${pad}- ${typeof item === 'string' ? yamlQuote(item) : String(item)}`);
+            }
+        }
+        else if (typeof value === 'string') {
+            lines.push(`${key}: ${yamlQuote(value)}`);
+        }
+        else {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Parse a SKILL.md file content into metadata and instructions.
+ *
+ * SKILL.md format:
+ * ```
+ * ---
+ * name: skill-name
+ * description: What this skill does
+ * ---
+ *
+ * # Instructions
+ *
+ * Markdown content here...
+ * ```
+ *
+ * @param content - Raw SKILL.md file content
+ * @returns Parsed skill metadata and instructions
+ * @throws Error if frontmatter is missing or invalid
+ */
+export function parseSkillMd(content) {
+    // Extract frontmatter using --- delimiters
+    const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        throw new Error('SKILL.md must contain YAML frontmatter between --- delimiters');
+    }
+    const rawFrontmatter = frontmatterMatch[1] ?? '';
+    const instructions = frontmatterMatch[2] ?? '';
+    // Parse YAML
+    let parsedYaml;
+    try {
+        parsedYaml = yamlParse(rawFrontmatter);
+    }
+    catch (error) {
+        throw new Error(`Invalid YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Normalize allowed-tools field
+    if (parsedYaml['allowed-tools'] && !parsedYaml.allowedTools) {
+        parsedYaml.allowedTools = parsedYaml['allowed-tools'];
+        parsedYaml['allowed-tools'] = undefined;
+    }
+    // Parse allowed-tools string format: "Bash(git:*) Read Write"
+    if (typeof parsedYaml.allowedTools === 'string') {
+        parsedYaml.allowedTools = parseAllowedToolsString(parsedYaml.allowedTools);
+    }
+    // Validate against schema
+    const parseResult = SkillMetadataSchema.safeParse(parsedYaml);
+    if (!parseResult.success) {
+        const errors = parseResult.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`);
+        throw new Error(`Invalid skill metadata:\n${errors.join('\n')}`);
+    }
+    return {
+        metadata: parseResult.data,
+        instructions: instructions.trim(),
+        rawFrontmatter,
+    };
+}
+/**
+ * Parse allowed-tools string format into array.
+ *
+ * Example: "Bash(git:*) Read Write(*.ts)" -> ["Bash(git:*)", "Read", "Write(*.ts)"]
+ */
+export function parseAllowedToolsString(spec) {
+    const tools = [];
+    let current = '';
+    let parenDepth = 0;
+    for (const char of spec) {
+        if (char === '(') {
+            parenDepth++;
+            current += char;
+        }
+        else if (char === ')') {
+            parenDepth--;
+            current += char;
+        }
+        else if (char === ' ' && parenDepth === 0) {
+            if (current.trim()) {
+                tools.push(current.trim());
+            }
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim()) {
+        tools.push(current.trim());
+    }
+    return tools;
+}
+/**
+ * Extract only the metadata from a SKILL.md file (lightweight parsing).
+ * Used for loading skill listings without full content.
+ *
+ * @param content - Raw SKILL.md file content
+ * @returns Just the metadata portion
+ */
+export function parseSkillMetadataOnly(content) {
+    const result = parseSkillMd(content);
+    return result.metadata;
+}
+/**
+ * Validate that a string is valid SKILL.md format.
+ *
+ * @param content - Content to validate
+ * @returns true if valid, error message if invalid
+ */
+export function validateSkillMd(content) {
+    try {
+        parseSkillMd(content);
+        return true;
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+/**
+ * Generate a SKILL.md file from metadata and instructions.
+ *
+ * @param metadata - Skill metadata
+ * @param instructions - Markdown instructions
+ * @returns SKILL.md file content
+ */
+export function generateSkillMd(metadata, instructions) {
+    const frontmatter = yamlStringify(metadata);
+    return `---\n${frontmatter}---\n\n${instructions}`;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Skill Registry
+ *
+ * Central registry for managing installed skills.
+ */
+export { globalSkillRegistry, SkillRegistry, type SkillStorageConfig } from './skill-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/skills/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/skills/registry/index.js

@@ -0,0 +1,6 @@
+/**
+ * Skill Registry
+ *
+ * Central registry for managing installed skills.
+ */
+export { globalSkillRegistry, SkillRegistry } from './skill-registry.js';

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

@@ -0,0 +1,133 @@
+/**
+ * Skill Registry
+ *
+ * Central registry for managing installed skills.
+ * Follows the pattern from tools/registry.ts.
+ */
+import type { Skill, SkillMetadata } from '../types.js';
+/**
+ * Storage location configuration.
+ */
+export interface SkillStorageConfig {
+    /** Global skill directory (default: ~/.revealui/skills/) */
+    globalDir?: string;
+    /** Project-local skill directory (default: .revealui/skills/) */
+    localDir?: string;
+    /** Project root for resolving local paths */
+    projectRoot?: string;
+}
+/**
+ * Skill registry for managing installed skills.
+ */
+export declare class SkillRegistry {
+    private skills;
+    private metadataCache;
+    /** Maps skill name (metadata or directory) to directory path */
+    private nameToPath;
+    private globalDir;
+    private localDir;
+    private projectRoot;
+    constructor(config?: SkillStorageConfig);
+    /**
+     * Get the resolved local directory path.
+     */
+    private getLocalDirPath;
+    /**
+     * Register a skill.
+     *
+     * @throws Error if skill name already registered
+     */
+    register(skill: Skill): void;
+    /**
+     * Unregister a skill by name.
+     */
+    unregister(name: string): void;
+    /**
+     * Get a skill by name.
+     */
+    get(name: string): Skill | undefined;
+    /**
+     * Check if a skill exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered skills.
+     */
+    getAll(): Skill[];
+    /**
+     * Get all skill names.
+     */
+    getNames(): string[];
+    /**
+     * Load all skill metadata from disk (lightweight).
+     * Only loads frontmatter, not full instructions.
+     */
+    loadAllMetadata(): Promise<void>;
+    /**
+     * Load metadata from a specific directory.
+     */
+    private loadMetadataFromDirectory;
+    /**
+     * Get all loaded metadata (lightweight listing).
+     */
+    getAllMetadata(): SkillMetadata[];
+    /**
+     * Get metadata for a specific skill.
+     */
+    getMetadata(name: string): SkillMetadata | undefined;
+    /**
+     * Load a full skill from disk (including instructions and resources).
+     *
+     * @param name - Skill name (metadata name or directory name)
+     * @param generateEmbed - Whether to generate embedding for the skill
+     */
+    loadSkill(name: string, generateEmbed?: boolean): Promise<Skill | undefined>;
+    /**
+     * Load all skills from disk (full loading).
+     */
+    loadAllSkills(generateEmbeddings?: boolean): Promise<void>;
+    /**
+     * Load resources from a skill directory.
+     */
+    private loadResources;
+    /**
+     * Recursively walk a directory.
+     */
+    private walkDirectory;
+    /**
+     * Get install date from directory stats.
+     */
+    private getInstallDate;
+    /**
+     * Search skills by embedding similarity.
+     *
+     * @param query - Search query text
+     * @param threshold - Minimum similarity score (default 0.7)
+     * @param limit - Maximum results to return
+     */
+    searchByEmbedding(query: string, threshold?: number, limit?: number): Promise<Array<{
+        skill: Skill;
+        score: number;
+    }>>;
+    /**
+     * Search skills by keyword matching.
+     */
+    searchByKeyword(query: string): Skill[];
+    /**
+     * Get the installation directory for a skill.
+     */
+    getSkillDirectory(name: string, scope?: 'local' | 'global'): string;
+    /**
+     * Ensure a directory exists.
+     */
+    ensureDirectory(dir: string): void;
+    /**
+     * Clear the registry (for testing).
+     */
+    clear(): void;
+}
+/**
+ * Global skill registry instance.
+ */
+export declare const globalSkillRegistry: SkillRegistry;
+//# sourceMappingURL=skill-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../../src/skills/registry/skill-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAA;AA0BtE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,aAAa,CAAwC;IAC7D,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAQ;gBAEf,MAAM,GAAE,kBAAuB;IAM3C;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQ5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAStC;;OAEG;YACW,yBAAyB;IA+BvC;;OAEG;IACH,cAAc,IAAI,aAAa,EAAE;IAIjC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIpD;;;;;OAKG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAsEhF;;OAEG;IACG,aAAa,CAAC,kBAAkB,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D;;OAEG;YACW,aAAa;IA4B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;OAMG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,SAAS,SAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA2BlD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE;IAmCvC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,OAAO,GAAG,QAAkB,GAAG,MAAM;IAO5E;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAsB,CAAA"}