pi-harness-runtime 1.1.95 → 1.1.97

package/packages/skills/dist/loader.js

@@ -0,0 +1,280 @@
+/**
+ * Skill Registry
+ *
+ * Stores and manages skills with progressive disclosure.
+ * Based on pi.dev Agent Skills specification.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseSkillFile } from "./parser.js";
+/**
+ * Skill Registry - manages loaded and indexed skills
+ */
+export class SkillRegistry {
+    skills = new Map();
+    index = { entries: [], loadedAt: 0 };
+    loading = new Map();
+    /**
+     * Register a skill
+     */
+    register(skill) {
+        this.skills.set(skill.id, skill);
+        this.updateIndex(skill);
+    }
+    /**
+     * Unregister a skill by ID
+     */
+    unregister(skillId) {
+        const skill = this.skills.get(skillId);
+        if (skill) {
+            this.skills.delete(skillId);
+            this.index.entries = this.index.entries.filter((e) => e.id !== skillId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get a skill by ID
+     */
+    get(skillId) {
+        return this.skills.get(skillId);
+    }
+    /**
+     * List all registered skills
+     */
+    list() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Get skill index (lightweight)
+     */
+    getIndex() {
+        return this.index;
+    }
+    /**
+     * Find skills matching a trigger/query
+     */
+    find(query, options) {
+        const results = [];
+        const threshold = options?.threshold ?? 0.3;
+        const queryLower = query.toLowerCase();
+        for (const skill of this.skills.values()) {
+            // Skip disabled skills if requested
+            if (!options?.includeDisabled &&
+                skill.frontmatter.disable_model_invocation) {
+                continue;
+            }
+            let score = 0;
+            const matchedTriggers = [];
+            // Check name match
+            if (skill.id.toLowerCase().includes(queryLower)) {
+                score += 0.8;
+                matchedTriggers.push(`name:${skill.id}`);
+            }
+            // Check description match
+            if (skill.frontmatter.description.toLowerCase().includes(queryLower)) {
+                score += 0.5;
+                matchedTriggers.push("description");
+            }
+            // Check triggers
+            if (skill.hermes?.triggers) {
+                for (const trigger of skill.hermes.triggers) {
+                    if (trigger.toLowerCase().includes(queryLower)) {
+                        score += 0.9;
+                        matchedTriggers.push(`trigger:${trigger}`);
+                    }
+                    // Also check regex-style triggers
+                    try {
+                        const regex = new RegExp(trigger, "i");
+                        if (regex.test(query)) {
+                            score += 0.9;
+                            matchedTriggers.push(`regex:${trigger}`);
+                        }
+                    }
+                    catch {
+                        // Invalid regex, skip
+                    }
+                }
+            }
+            // Check tags
+            if (skill.hermes?.anti_patterns) {
+                for (const anti of skill.hermes.anti_patterns) {
+                    if (anti.toLowerCase().includes(queryLower)) {
+                        score += 0.3;
+                        matchedTriggers.push("anti-pattern");
+                    }
+                }
+            }
+            // Usage bonus
+            if (skill.hermes?.usage_count && skill.hermes.usage_count > 0) {
+                score += Math.min(0.2, skill.hermes.usage_count * 0.01);
+            }
+            if (score >= threshold) {
+                results.push({ skill, score, matchedTriggers });
+            }
+        }
+        // Sort results
+        const sortBy = options?.sortBy ?? "score";
+        results.sort((a, b) => {
+            if (sortBy === "score")
+                return b.score - a.score;
+            if (sortBy === "usage") {
+                const aUsage = a.skill.hermes?.usage_count ?? 0;
+                const bUsage = b.skill.hermes?.usage_count ?? 0;
+                return bUsage - aUsage;
+            }
+            return a.skill.id.localeCompare(b.skill.id);
+        });
+        return results;
+    }
+    /**
+     * Find best matching skill for a query
+     */
+    findBestMatch(query, options) {
+        const results = this.find(query, { ...options, threshold: 0 });
+        return results[0] ?? null;
+    }
+    /**
+     * Load a skill's full content (progressive disclosure)
+     */
+    async load(skillId, options) {
+        const skill = this.skills.get(skillId);
+        if (!skill) {
+            return null;
+        }
+        // If already loaded, return cached
+        if (skill.loaded && !options?.loadReferences && !options?.loadExamples) {
+            return skill;
+        }
+        // Check if already loading
+        if (this.loading.has(skillId)) {
+            return this.loading.get(skillId);
+        }
+        // Load the skill
+        const loadPromise = this.loadSkill(skill, options);
+        this.loading.set(skillId, loadPromise);
+        try {
+            const loadedSkill = await loadPromise;
+            this.loading.delete(skillId);
+            return loadedSkill;
+        }
+        catch (err) {
+            this.loading.delete(skillId);
+            throw err;
+        }
+    }
+    /**
+     * Load skill content from disk
+     */
+    async loadSkill(skill, options) {
+        const loadedSkill = { ...skill };
+        const skillMdPath = join(skill.path, "SKILL.md");
+        // Re-parse to get fresh content
+        if (existsSync(skillMdPath)) {
+            const parsed = parseSkillFile(skillMdPath);
+            loadedSkill.body = parsed.body;
+            loadedSkill.frontmatter = parsed.frontmatter;
+            loadedSkill.hermes = parsed.hermes;
+        }
+        // Load references if requested
+        if (options?.loadReferences) {
+            loadedSkill.referencesContent = new Map();
+            for (const ref of skill.references) {
+                if (existsSync(ref.path)) {
+                    try {
+                        const content = readFileSync(ref.path, "utf-8");
+                        loadedSkill.referencesContent.set(ref.name, content);
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        }
+        // Load examples if requested
+        if (options?.loadExamples) {
+            loadedSkill.examplesContent = new Map();
+            for (const example of skill.examples) {
+                if (existsSync(example.path)) {
+                    try {
+                        const content = readFileSync(example.path, "utf-8");
+                        loadedSkill.examplesContent.set(example.name, content);
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+        }
+        // Mark as loaded
+        loadedSkill.loaded = true;
+        loadedSkill.lastUsed = Date.now();
+        // Update usage count
+        if (loadedSkill.hermes) {
+            loadedSkill.hermes.usage_count =
+                (loadedSkill.hermes.usage_count ?? 0) + 1;
+        }
+        // Update in registry
+        this.skills.set(skill.id, loadedSkill);
+        return loadedSkill;
+    }
+    /**
+     * Update skill index entry
+     */
+    updateIndex(skill) {
+        // Remove existing entry if present
+        this.index.entries = this.index.entries.filter((e) => e.id !== skill.id);
+        // Add new entry
+        this.index.entries.push({
+            id: skill.id,
+            name: skill.frontmatter.name,
+            description: skill.frontmatter.description,
+            path: skill.path,
+            version: skill.frontmatter.version,
+            triggers: skill.hermes?.triggers,
+            loaded: skill.loaded,
+        });
+        // Update load time
+        this.index.loadedAt = Date.now();
+    }
+    /**
+     * Clear all skills
+     */
+    clear() {
+        this.skills.clear();
+        this.index = { entries: [], loadedAt: 0 };
+        this.loading.clear();
+    }
+    /**
+     * Get count of registered skills
+     */
+    get size() {
+        return this.skills.size;
+    }
+    /**
+     * Check if skill exists
+     */
+    has(skillId) {
+        return this.skills.has(skillId);
+    }
+}
+/**
+ * Create a new skill registry
+ */
+export function createSkillRegistry() {
+    return new SkillRegistry();
+}
+/**
+ * Global skill registry instance (singleton)
+ */
+let globalRegistry = null;
+export function getGlobalSkillRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = createSkillRegistry();
+    }
+    return globalRegistry;
+}
+export function setGlobalSkillRegistry(registry) {
+    globalRegistry = registry;
+}
+//# sourceMappingURL=loader.js.map

package/packages/skills/dist/loader.js.map

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

package/packages/skills/dist/parser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SKILL.md Parser
+ *
+ * Parses skill files with YAML frontmatter and markdown body.
+ * Based on pi.dev Agent Skills specification.
+ */
+import type { Skill, SkillFrontmatter, SkillReference, SkillExample } from "./types.js";
+/**
+ * Parse a SKILL.md file
+ */
+export declare function parseSkillFile(filePath: string): Skill;
+/**
+ * Parse SKILL.md content string
+ */
+export declare function parseSkillContent(content: string, filePath?: string): Skill;
+/**
+ * Scan skill directory for references and examples
+ */
+export declare function scanSkillDirectory(skillDir: string): {
+    references: SkillReference[];
+    examples: SkillExample[];
+};
+/**
+ * Serialize skill back to SKILL.md format
+ */
+export declare function serializeSkill(skill: Skill): string;
+/**
+ * Generate SKILL.md from trajectory or partial skill
+ */
+export declare function generateSkillFromTemplate(template: Partial<Skill>, overrides?: Partial<SkillFrontmatter>): string;
+export type { SkillPitfall } from "./types.js";
+//# sourceMappingURL=parser.d.ts.map

package/packages/skills/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAEhB,cAAc,EACd,YAAY,EAGb,MAAM,YAAY,CAAC;AAgHpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAOtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAoD3E;AAoID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACpD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,CAyFA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuFnD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,EACxB,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,MAAM,CAsBR;AAGD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}