pi-harness-runtime 1.1.95 → 1.1.97

package/packages/skills/dist/scanner.js

@@ -0,0 +1,257 @@
+/**
+ * Skill Directory Scanner
+ *
+ * Recursively scans directories for skills (directories containing SKILL.md).
+ * Supports pi.dev Agent Skills locations:
+ * - ~/.pi-harness/skills
+ * - skills/ (relative to cwd)
+ * - .agents/skills/ (pi.dev compatible)
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, normalize } from "node:path";
+import { homedir } from "node:os";
+import { parseSkillFile, scanSkillDirectory } from "./parser.js";
+/**
+ * Default scan options
+ */
+const DEFAULT_SCAN_OPTIONS = {
+    directories: [
+        "~/.pi-harness/skills",
+        "skills",
+        ".agents/skills",
+    ],
+    maxDepth: 10,
+    includeHidden: false,
+};
+/**
+ * Expand ~ in paths to home directory
+ */
+function expandPath(path) {
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Check if a path should be included based on patterns
+ */
+function matchesPattern(path, patterns) {
+    if (!patterns || patterns.length === 0) {
+        return true;
+    }
+    for (const pattern of patterns) {
+        if (path.includes(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Recursively scan a directory for skills
+ */
+function scanDirectory(dir, options, scannedPaths, errors, depth = 0) {
+    const skillDirs = [];
+    // Skip if max depth exceeded
+    if (options.maxDepth !== undefined && depth > options.maxDepth) {
+        return skillDirs;
+    }
+    // Normalize and resolve path
+    const normalizedPath = normalize(expandPath(dir));
+    // Skip if already scanned
+    if (scannedPaths.has(normalizedPath)) {
+        return skillDirs;
+    }
+    scannedPaths.add(normalizedPath);
+    // Skip if doesn't exist
+    if (!existsSync(normalizedPath)) {
+        return skillDirs;
+    }
+    try {
+        const entries = readdirSync(normalizedPath);
+        for (const entry of entries) {
+            // Skip hidden directories if not included
+            if (entry.startsWith(".") && !options.includeHidden) {
+                continue;
+            }
+            const fullPath = join(normalizedPath, entry);
+            try {
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    // Check if this directory contains a SKILL.md
+                    const skillMdPath = join(fullPath, "SKILL.md");
+                    if (existsSync(skillMdPath)) {
+                        // Found a skill!
+                        skillDirs.push(fullPath);
+                    }
+                    else {
+                        // Recurse into subdirectory
+                        const subSkills = scanDirectory(fullPath, options, scannedPaths, errors, depth + 1);
+                        skillDirs.push(...subSkills);
+                    }
+                }
+            }
+            catch (err) {
+                errors.push({
+                    path: fullPath,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    catch (err) {
+        errors.push({
+            path: normalizedPath,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+    return skillDirs;
+}
+/**
+ * Scan multiple directories for skills
+ */
+export async function scanForSkills(options) {
+    const startTime = Date.now();
+    const mergedOptions = {
+        ...DEFAULT_SCAN_OPTIONS,
+        ...options,
+    };
+    const scannedPaths = new Set();
+    const errors = [];
+    const skillDirs = [];
+    for (const dir of mergedOptions.directories) {
+        const dirs = scanDirectory(dir, mergedOptions, scannedPaths, errors, 0);
+        skillDirs.push(...dirs);
+    }
+    // Parse each skill directory
+    const skills = [];
+    for (const skillDir of skillDirs) {
+        try {
+            const skillMdPath = join(skillDir, "SKILL.md");
+            const skill = parseSkillFile(skillMdPath);
+            // Scan for references and examples
+            const { references, examples } = scanSkillDirectory(skillDir);
+            skill.references = references;
+            skill.examples = examples;
+            skills.push(skill);
+        }
+        catch (err) {
+            errors.push({
+                path: skillDir,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        skills,
+        errors,
+        scannedPaths: Array.from(scannedPaths),
+        durationMs: Date.now() - startTime,
+    };
+}
+/**
+ * Scan for skills synchronously (for use at startup)
+ */
+export function scanForSkillsSync(options) {
+    const startTime = Date.now();
+    const mergedOptions = {
+        ...DEFAULT_SCAN_OPTIONS,
+        ...options,
+    };
+    const scannedPaths = new Set();
+    const errors = [];
+    const skillDirs = [];
+    for (const dir of mergedOptions.directories) {
+        const dirs = scanDirectory(dir, mergedOptions, scannedPaths, errors, 0);
+        skillDirs.push(...dirs);
+    }
+    // Parse each skill directory
+    const skills = [];
+    for (const skillDir of skillDirs) {
+        try {
+            const skillMdPath = join(skillDir, "SKILL.md");
+            const skill = parseSkillFile(skillMdPath);
+            // Scan for references and examples
+            const { references, examples } = scanSkillDirectory(skillDir);
+            skill.references = references;
+            skill.examples = examples;
+            skills.push(skill);
+        }
+        catch (err) {
+            errors.push({
+                path: skillDir,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        skills,
+        errors,
+        scannedPaths: Array.from(scannedPaths),
+        durationMs: Date.now() - startTime,
+    };
+}
+/**
+ * Resolve skill locations from options
+ */
+export function resolveSkillLocations(locations) {
+    const defaults = DEFAULT_SCAN_OPTIONS.directories;
+    if (!locations || locations.length === 0) {
+        return defaults.map(expandPath);
+    }
+    return locations.map(expandPath);
+}
+/**
+ * Check if a path is a valid skill directory
+ */
+export function isSkillDirectory(path) {
+    const skillMdPath = join(expandPath(path), "SKILL.md");
+    return existsSync(skillMdPath);
+}
+/**
+ * Watch directories for skill changes
+ */
+export function watchSkillDirectories(directories, onChange, options) {
+    const pollInterval = options?.pollInterval ?? 5000;
+    const lastModified = new Map();
+    const check = () => {
+        for (const dir of directories) {
+            const expandedDir = expandPath(dir);
+            if (!existsSync(expandedDir))
+                continue;
+            try {
+                const entries = readdirSync(expandedDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory() || entry.name.startsWith("."))
+                        continue;
+                    const skillPath = join(expandedDir, entry.name);
+                    const skillMdPath = join(skillPath, "SKILL.md");
+                    if (!existsSync(skillMdPath))
+                        continue;
+                    try {
+                        const stat = statSync(skillMdPath);
+                        const mtime = stat.mtimeMs;
+                        const lastMtime = lastModified.get(skillPath);
+                        if (!lastMtime) {
+                            lastModified.set(skillPath, mtime);
+                            onChange("add", skillPath);
+                        }
+                        else if (mtime > lastMtime) {
+                            lastModified.set(skillPath, mtime);
+                            onChange("change", skillPath);
+                        }
+                    }
+                    catch {
+                        // File might have been deleted
+                    }
+                }
+            }
+            catch {
+                // Directory might not exist
+            }
+        }
+    };
+    const interval = setInterval(check, pollInterval);
+    // Return cleanup function
+    return () => clearInterval(interval);
+}
+//# sourceMappingURL=scanner.js.map

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

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

package/packages/skills/dist/skill-commands.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skill Commands - /skill:name slash command handler
+ *
+ * Registers /skill:name commands for explicit skill invocation.
+ * Based on pi.dev skill command specification.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * Skill command configuration
+ */
+export interface SkillCommandConfig {
+    /** Enable skill commands */
+    enabled: boolean;
+    /** Prefix for skill commands (default: "skill:") */
+    prefix: string;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_COMMAND_CONFIG: SkillCommandConfig;
+/**
+ * Initialize skill commands with ExtensionAPI
+ */
+export declare function initSkillCommands(pi: ExtensionAPI, config?: Partial<SkillCommandConfig>): void;
+/**
+ * Get skill index for system prompt injection
+ */
+export declare function getSkillIndexForSystemPrompt(): string;
+/**
+ * Refresh skill commands (re-register after skills change)
+ */
+export declare function refreshSkillCommands(pi: ExtensionAPI, prefix?: string): void;
+//# sourceMappingURL=skill-commands.d.ts.map

package/packages/skills/dist/skill-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-commands.d.ts","sourceRoot":"","sources":["../src/skill-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,iCAAiC,CAAC;AAI/G;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,kBAGpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,YAAY,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,IAAI,CAoCN;AA4MD;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAuBrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAQN"}

package/packages/skills/dist/skill-commands.js

@@ -0,0 +1,239 @@
+/**
+ * Skill Commands - /skill:name slash command handler
+ *
+ * Registers /skill:name commands for explicit skill invocation.
+ * Based on pi.dev skill command specification.
+ */
+import { getGlobalSkillRegistry } from "./loader.js";
+import { scanForSkillsSync } from "./scanner.js";
+/**
+ * Default configuration
+ */
+export const DEFAULT_COMMAND_CONFIG = {
+    enabled: true,
+    prefix: "skill:",
+};
+/**
+ * Initialize skill commands with ExtensionAPI
+ */
+export function initSkillCommands(pi, config) {
+    const cfg = { ...DEFAULT_COMMAND_CONFIG, ...config };
+    if (!cfg.enabled)
+        return;
+    const registry = getGlobalSkillRegistry();
+    // Initialize registry with existing skills
+    const result = scanForSkillsSync();
+    for (const skill of result.skills) {
+        registry.register(skill);
+    }
+    // Register /skill command for listing
+    pi.registerCommand("skill", {
+        description: "Interact with skills. Usage: /skill [list|search <query>|info <name>]",
+        handler: async (args, ctx) => {
+            const parts = args.trim().split(/\s+/);
+            const subcommand = parts[0] || "list";
+            const query = parts.slice(1).join(" ");
+            switch (subcommand) {
+                case "list":
+                    return handleSkillList(registry, ctx);
+                case "search":
+                    return handleSkillSearch(registry, query, ctx);
+                case "info":
+                    return handleSkillInfo(registry, query, ctx);
+                default:
+                    ctx.ui.notify(`Unknown subcommand: ${subcommand}. Use: /skill [list|search|info]`, "warning");
+            }
+        },
+    });
+    // Register individual skill commands dynamically
+    registerSkillCommands(pi, registry, cfg.prefix);
+}
+/**
+ * Register individual skill commands
+ */
+function registerSkillCommands(pi, registry, prefix) {
+    // Get all registered skills
+    const skills = registry.list();
+    for (const skill of skills) {
+        const commandName = `${prefix}${skill.id}`;
+        // Skip if command name is too long or conflicts
+        if (commandName.length > 50)
+            continue;
+        // Register the command
+        try {
+            pi.registerCommand(commandName, {
+                description: skill.frontmatter.description,
+                handler: async (_skillArgs, ctx) => {
+                    // Load the full skill content
+                    const loaded = await registry.load(skill.id, {
+                        loadReferences: true,
+                        loadExamples: true,
+                    });
+                    if (!loaded) {
+                        ctx.ui.notify(`Skill not found: ${skill.id}`, "error");
+                        return;
+                    }
+                    // Build response with skill content
+                    const response = [];
+                    response.push(`# ${loaded.frontmatter.name}`);
+                    response.push(`**${loaded.frontmatter.description}**`);
+                    response.push("");
+                    response.push("---");
+                    response.push(loaded.body);
+                    // Append references
+                    if (loaded.references.length > 0) {
+                        response.push("");
+                        response.push("## References");
+                        for (const ref of loaded.references) {
+                            response.push(`- ${ref.relativePath}`);
+                        }
+                    }
+                    // Show skill details
+                    ctx.ui.notify(`Skill '${loaded.frontmatter.name}' - ${loaded.body.length} chars. ` +
+                        `Use /skill info ${loaded.id} for full details.`, "info");
+                },
+            });
+        }
+        catch (err) {
+            // Skip if command registration fails (e.g., name conflict)
+            console.debug(`[SkillCommands] Skipped registering ${commandName}:`, err);
+        }
+    }
+}
+/**
+ * Handle /skill list
+ */
+async function handleSkillList(registry, ctx) {
+    const skills = registry.list();
+    if (skills.length === 0) {
+        ctx.ui.notify("No skills registered. Skills are loaded from ~/.pi-harness/skills/, skills/, or .agents/skills/", "info");
+        return;
+    }
+    const lines = ["# Available Skills", ""];
+    for (const skill of skills) {
+        const author = skill.hermes?.author ?? "unknown";
+        const usage = skill.hermes?.usage_count ?? 0;
+        lines.push(`## ${skill.frontmatter.name} ${author === "agent" ? "(agent)" : author === "curator" ? "(curator)" : ""}`);
+        lines.push(skill.frontmatter.description);
+        lines.push(`- Usage: ${usage}x`);
+        if (skill.hermes?.triggers?.length) {
+            lines.push(`- Triggers: ${skill.hermes.triggers.join(", ")}`);
+        }
+        lines.push("");
+    }
+    // Send as a message using the context's session if available
+    ctx.ui.notify(`Found ${skills.length} skills. Use /skill info <name> for details.`, "info");
+}
+/**
+ * Handle /skill search
+ */
+async function handleSkillSearch(registry, query, ctx) {
+    if (!query) {
+        ctx.ui.notify("Usage: /skill search <query>", "warning");
+        return;
+    }
+    const results = registry.find(query, { threshold: 0.2 });
+    if (results.length === 0) {
+        ctx.ui.notify(`No skills found matching: ${query}`, "info");
+        return;
+    }
+    const lines = [`# Skills matching: ${query}`, ""];
+    for (const result of results.slice(0, 10)) {
+        lines.push(`## ${result.skill.frontmatter.name} (${Math.round(result.score * 100)}% match)`);
+        lines.push(result.skill.frontmatter.description);
+        if (result.matchedTriggers.length > 0) {
+            lines.push(`Matched: ${result.matchedTriggers.join(", ")}`);
+        }
+        lines.push("");
+    }
+    ctx.ui.notify(`Found ${results.length} matching skills. Use /skill info <name> for details.`, "info");
+}
+/**
+ * Handle /skill info
+ */
+async function handleSkillInfo(registry, skillName, ctx) {
+    if (!skillName) {
+        ctx.ui.notify("Usage: /skill info <name>", "warning");
+        return;
+    }
+    const skill = registry.get(skillName);
+    if (!skill) {
+        ctx.ui.notify(`Skill not found: ${skillName}`, "error");
+        return;
+    }
+    // Load full content
+    const loaded = await registry.load(skill.id, { loadReferences: true });
+    if (!loaded) {
+        ctx.ui.notify(`Failed to load skill: ${skillName}`, "error");
+        return;
+    }
+    const lines = [];
+    lines.push(`# ${loaded.frontmatter.name}`);
+    lines.push("");
+    lines.push("**Description:** " + loaded.frontmatter.description);
+    if (loaded.frontmatter.version) {
+        lines.push("**Version:** " + loaded.frontmatter.version);
+    }
+    if (loaded.hermes?.author) {
+        lines.push("**Author:** " + loaded.hermes.author);
+    }
+    if (loaded.hermes?.confidence !== undefined) {
+        lines.push("**Confidence:** " + Math.round(loaded.hermes.confidence * 100) + "%");
+    }
+    if (loaded.hermes?.usage_count !== undefined) {
+        lines.push("**Used:** " + loaded.hermes.usage_count + " times");
+    }
+    lines.push("");
+    lines.push("## Content");
+    lines.push(loaded.body);
+    if (loaded.references.length > 0) {
+        lines.push("");
+        lines.push("## References");
+        for (const ref of loaded.references) {
+            lines.push(`- ${ref.relativePath}`);
+        }
+    }
+    if (loaded.hermes?.pitfalls?.length) {
+        lines.push("");
+        lines.push("## Pitfalls");
+        for (const pitfall of loaded.hermes.pitfalls) {
+            lines.push(`- **${pitfall.name}**: ${pitfall.why}`);
+        }
+    }
+    // Show skill content via notification (simplified approach)
+    ctx.ui.notify(`Skill '${loaded.frontmatter.name}' loaded with ${loaded.body.length} chars. Use /skill:${skill.id} to activate.`, "info");
+}
+/**
+ * Get skill index for system prompt injection
+ */
+export function getSkillIndexForSystemPrompt() {
+    const registry = getGlobalSkillRegistry();
+    const skills = registry.list();
+    if (skills.length === 0) {
+        return "";
+    }
+    const lines = [];
+    lines.push("## Available Skills");
+    lines.push("");
+    for (const skill of skills) {
+        lines.push(`- **${skill.frontmatter.name}**: ${skill.frontmatter.description}`);
+        if (skill.hermes?.triggers?.length) {
+            lines.push(`  Triggers: ${skill.hermes.triggers.join(", ")}`);
+        }
+    }
+    lines.push("");
+    lines.push("Use `/skill:name` to activate a skill.");
+    return lines.join("\n");
+}
+/**
+ * Refresh skill commands (re-register after skills change)
+ */
+export function refreshSkillCommands(pi, prefix) {
+    const cfg = {
+        enabled: true,
+        prefix: prefix ?? DEFAULT_COMMAND_CONFIG.prefix,
+    };
+    const registry = getGlobalSkillRegistry();
+    registerSkillCommands(pi, registry, cfg.prefix);
+}
+//# sourceMappingURL=skill-commands.js.map

package/packages/skills/dist/skill-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-commands.js","sourceRoot":"","sources":["../src/skill-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAYjD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuB;IACxD,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAgB,EAChB,MAAoC;IAEpC,MAAM,GAAG,GAAG,EAAE,GAAG,sBAAsB,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO;IAEzB,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAE1C,2CAA2C;IAC3C,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,sCAAsC;IACtC,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE;QAC1B,WAAW,EAAE,uEAAuE;QACpF,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,GAAqB,EAAE,EAAE;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEvC,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,MAAM;oBACT,OAAO,eAAe,CAAC,QAAQ,EAAE,GAA8B,CAAC,CAAC;gBACnE,KAAK,QAAQ;oBACX,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAA8B,CAAC,CAAC;gBAC5E,KAAK,MAAM;oBACT,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,GAA8B,CAAC,CAAC;gBAC1E;oBACE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,UAAU,kCAAkC,EAAE,SAAS,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,EAAgB,EAChB,QAAmD,EACnD,MAAc;IAEd,4BAA4B;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC;QAE3C,gDAAgD;QAChD,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QAEtC,uBAAuB;QACvB,IAAI,CAAC;YACH,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE;gBAC9B,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,WAAW;gBAC1C,OAAO,EAAE,KAAK,EAAE,UAAkB,EAAE,GAAqB,EAAE,EAAE;oBAC3D,8BAA8B;oBAC9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE;wBAC3C,cAAc,EAAE,IAAI;wBACpB,YAAY,EAAE,IAAI;qBACnB,CAAC,CAAC;oBAEH,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;wBACvD,OAAO;oBACT,CAAC;oBAED,oCAAoC;oBACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;oBACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAE3B,oBAAoB;oBACpB,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAClB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;wBAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;4BACpC,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;wBACzC,CAAC;oBACH,CAAC;oBAED,qBAAqB;oBACrB,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,UAAU,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,UAAU;wBACpE,mBAAmB,MAAM,CAAC,EAAE,oBAAoB,EAChD,MAAM,CACP,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,2DAA2D;YAC3D,OAAO,CAAC,KAAK,CAAC,uCAAuC,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,QAAmD,EACnD,GAA4B;IAE5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,iGAAiG,EAAE,MAAM,CAAC,CAAC;QACzH,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAEnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6DAA6D;IAC7D,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,8CAA8C,EAAE,MAAM,CAAC,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,QAAmD,EACnD,KAAa,EACb,GAA4B;IAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,8BAA8B,EAAE,SAAS,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAGzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,6BAA6B,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IAGD,MAAM,KAAK,GAAa,CAAC,sBAAsB,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAE5D,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,MAAM,uDAAuD,EAAE,MAAM,CAAC,CAAC;AACxG,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,QAAmD,EACnD,SAAiB,EACjB,GAA4B;IAE5B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,SAAS,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,yBAAyB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACjE,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExB,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,MAAM,CAAC,WAAW,CAAC,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,MAAM,sBAAsB,KAAK,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;AAC3I,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QAChF,IAAI,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IAErD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAgB,EAChB,MAAe;IAEf,MAAM,GAAG,GAAuB;QAC9B,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,MAAM,IAAI,sBAAsB,CAAC,MAAM;KAChD,CAAC;IAEF,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/packages/skills/dist/skill-tool.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Skill Tool - Agent-accessible skill management
+ *
+ * Tool for agent to create, update, delete skills autonomously.
+ * Implements Hermes-style skill management with write_approval gate.
+ *
+ * Note: Full tool integration requires matching handler registration.
+ */
+import { getGlobalSkillRegistry } from "./loader.js";
+/**
+ * Skill tool configuration
+ */
+export interface SkillToolConfig {
+    /** Enable skill tool */
+    enabled: boolean;
+    /** Require approval for writes */
+    writeApproval: boolean;
+    /** Auto-create directory if missing */
+    autoCreateDir: boolean;
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_TOOL_CONFIG: SkillToolConfig;
+/**
+ * Skill manage tool parameters
+ */
+export interface SkillManageParams {
+    action: "create" | "patch" | "delete" | "list" | "info" | "search" | "lint" | "write_file" | "remove_file";
+    name?: string;
+    body?: string;
+    description?: string;
+    content?: string;
+    file?: string;
+    old_text?: string;
+    author?: "agent" | "user" | "curator";
+}
+/**
+ * Skill manage result
+ */
+export interface SkillManageResult {
+    success: boolean;
+    message: string;
+    skillId?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Create skill tool definition (for registration with ExtensionAPI)
+ */
+export declare function createSkillToolDefinition(handler: (params: SkillManageParams) => Promise<SkillManageResult>): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            action: {
+                type: "string";
+                enum: readonly ["create", "patch", "delete", "list", "info", "search", "lint", "write_file", "remove_file"];
+                description: string;
+            };
+            name: {
+                type: "string";
+                description: string;
+            };
+            body: {
+                type: "string";
+                description: string;
+            };
+            description: {
+                type: "string";
+                description: string;
+            };
+            content: {
+                type: "string";
+                description: string;
+            };
+            file: {
+                type: "string";
+                description: string;
+            };
+            old_text: {
+                type: "string";
+                description: string;
+            };
+            author: {
+                type: "string";
+                enum: readonly ["agent", "user", "curator"];
+                description: string;
+            };
+        };
+        required: readonly ["action"];
+    };
+    handler: (params: SkillManageParams) => Promise<SkillManageResult>;
+};
+/**
+ * Handle skill creation
+ */
+export declare function handleSkillCreate(registry: ReturnType<typeof getGlobalSkillRegistry>, name: string, body?: string, description?: string, author?: "agent" | "user" | "curator"): SkillManageResult;
+/**
+ * Handle skill listing
+ */
+export declare function handleSkillList(registry: ReturnType<typeof getGlobalSkillRegistry>): SkillManageResult;
+/**
+ * Handle skill info
+ */
+export declare function handleSkillInfo(registry: ReturnType<typeof getGlobalSkillRegistry>, name: string): SkillManageResult;
+/**
+ * Handle skill search
+ */
+export declare function handleSkillSearch(registry: ReturnType<typeof getGlobalSkillRegistry>, query: string): SkillManageResult;
+/**
+ * Handle skill linting
+ */
+export declare function handleSkillLint(registry: ReturnType<typeof getGlobalSkillRegistry>, name: string): SkillManageResult;
+/**
+ * Process skill manage action
+ */
+export declare function processSkillManage(params: SkillManageParams, registry?: ReturnType<typeof getGlobalSkillRegistry>): Promise<SkillManageResult>;
+//# sourceMappingURL=skill-tool.d.ts.map