heyio 0.42.1 → 1.0.0

package/dist/copilot/skills.js

@@ -1,385 +1,60 @@
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
-import { join, basename, resolve } from "path";
-import { execFileSync } from "child_process";
-import { SKILLS_DIR } from "../paths.js";
-/**
- * Scan SKILLS_DIR for subdirectories that contain a SKILL.md file.
- * Returns absolute paths to qualifying skill directories.
- */
-export function getSkillDirectories() {
-    if (!existsSync(SKILLS_DIR))
-        return [];
-    const dirs = [];
-    for (const entry of readdirSync(SKILLS_DIR)) {
-        const skillDir = join(SKILLS_DIR, entry);
-        if (!statSync(skillDir).isDirectory())
-            continue;
-        const skillMd = join(skillDir, "SKILL.md");
-        if (!existsSync(skillMd))
-            continue;
-        dirs.push(skillDir);
-        // Check for an agents subdirectory (Copilot SDK custom agents)
-        const agentsDir = join(skillDir, "agents");
-        if (existsSync(agentsDir) && statSync(agentsDir).isDirectory()) {
-            dirs.push(agentsDir);
-        }
-    }
-    return dirs;
-}
-function parseSkillMd(content) {
-    const lines = content.split(/\r?\n/);
-    let name = "";
-    let description = "";
-    let foundHeading = false;
-    const descLines = [];
-    for (const line of lines) {
-        if (!foundHeading) {
-            const match = line.match(/^#\s+(.+)/);
-            if (match) {
-                name = match[1].trim();
-                foundHeading = true;
-            }
-            continue;
-        }
-        // Skip blank lines between heading and first paragraph
-        if (descLines.length === 0 && line.trim() === "")
-            continue;
-        // Stop at the next blank line after collecting description text
-        if (descLines.length > 0 && line.trim() === "")
-            break;
-        // Stop at another heading
-        if (line.match(/^#+\s/))
-            break;
-        descLines.push(line.trim());
-    }
-    description = descLines.join(" ");
-    return { name, description };
-}
-/**
- * List all installed skills with metadata parsed from their SKILL.md files.
- */
-export function listSkills() {
-    if (!existsSync(SKILLS_DIR))
+import { existsSync, readdirSync, readFileSync, rmSync } from "node:fs";
+import { join, basename } from "node:path";
+import { execSync } from "node:child_process";
+import { PATHS } from "../paths.js";
+export async function listSkills() {
+    if (!existsSync(PATHS.skills))
         return [];
+    const entries = readdirSync(PATHS.skills, { withFileTypes: true });
     const skills = [];
-    for (const entry of readdirSync(SKILLS_DIR)) {
-        const skillDir = join(SKILLS_DIR, entry);
-        if (!statSync(skillDir).isDirectory())
+    for (const entry of entries) {
+        if (!entry.isDirectory())
             continue;
-        const skillMdPath = join(skillDir, "SKILL.md");
-        if (!existsSync(skillMdPath))
+        const skillMd = join(PATHS.skills, entry.name, "SKILL.md");
+        if (!existsSync(skillMd))
             continue;
-        const content = readFileSync(skillMdPath, "utf-8");
-        const { name, description } = parseSkillMd(content);
+        const content = readFileSync(skillMd, "utf-8");
+        const firstLine = content.split("\n").find((l) => l.startsWith("# "));
+        const name = firstLine?.replace(/^#\s+/, "") ?? entry.name;
+        const descLine = content
+            .split("\n")
+            .find((l) => l.trim() && !l.startsWith("#"));
+        const description = descLine?.trim() ?? "";
         skills.push({
-            name: name || entry,
-            slug: entry,
+            name,
+            slug: entry.name,
             description,
-            path: skillDir,
+            path: join(PATHS.skills, entry.name),
         });
     }
     return skills;
 }
-const GITHUB_BLOB_RE = /^https:\/\/github\.com\/([^\/]+)\/([^\/]+)\/blob\/([^\/]+)\/(.+\/)?SKILL\.md$/i;
-const RAW_GH_RE = /^https:\/\/raw\.githubusercontent\.com\/([^\/]+)\/([^\/]+)\/([^\/]+)\/(.+\/)?SKILL\.md$/i;
-const GENERIC_SKILL_MD_RE = /\/SKILL\.md$/i;
-function deriveSlug(repo, pathPrefix) {
-    if (!pathPrefix)
-        return repo;
-    const segments = pathPrefix.replace(/\/$/, "").split("/").filter(Boolean);
-    const last = segments[segments.length - 1];
-    return last ? `${repo}-${last}` : repo;
-}
-/**
- * Determine whether the input URL points to a full repo or a specific
- * SKILL.md file. For GitHub blob URLs the raw download URL is derived
- * automatically.
- */
-export function parseSkillUrl(input) {
-    const blobMatch = input.match(GITHUB_BLOB_RE);
-    if (blobMatch) {
-        const [, owner, repo, branch, pathPrefix] = blobMatch;
-        const rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${pathPrefix ?? ""}SKILL.md`;
-        return { type: "file", rawUrl, slug: deriveSlug(repo, pathPrefix) };
-    }
-    const rawMatch = input.match(RAW_GH_RE);
-    if (rawMatch) {
-        const [, _owner, repo, _branch, pathPrefix] = rawMatch;
-        return { type: "file", rawUrl: input, slug: deriveSlug(repo, pathPrefix) };
-    }
-    if (GENERIC_SKILL_MD_RE.test(input)) {
-        if (!input.startsWith("https://")) {
-            throw new Error("Only https:// URLs are supported for SKILL.md installs.");
-        }
-        let urlObj;
-        try {
-            urlObj = new URL(input);
-        }
-        catch {
-            throw new Error(`Invalid URL: ${input}`);
-        }
-        const segments = urlObj.pathname.split("/").filter(Boolean);
-        // Use the segment before SKILL.md, or the hostname as slug fallback
-        const slug = segments.length >= 2
-            ? segments[segments.length - 2]
-            : urlObj.hostname.replace(/\./g, "-");
-        return { type: "file", rawUrl: input, slug };
-    }
-    return { type: "repo", url: input };
-}
-async function installSkillFromFile(rawUrl, slug) {
-    if (!rawUrl.startsWith("https://")) {
-        throw new Error("Only https:// URLs are supported for SKILL.md installs.");
-    }
-    const destDir = join(SKILLS_DIR, slug);
-    if (existsSync(destDir)) {
-        throw new Error(`Skill "${slug}" is already installed.`);
-    }
-    const response = await fetch(rawUrl);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch SKILL.md from ${rawUrl} (HTTP ${response.status})`);
-    }
-    const content = await response.text();
-    // Validate: at least one markdown heading in the first 10 lines
-    const first10 = content.split(/\r?\n/).slice(0, 10);
-    if (!first10.some((line) => /^#{1,6}\s/.test(line))) {
-        throw new Error("URL does not appear to contain a valid SKILL.md file.");
-    }
-    mkdirSync(destDir, { recursive: true });
-    writeFileSync(join(destDir, "SKILL.md"), content, "utf-8");
-    const { name, description } = parseSkillMd(content);
-    return {
-        name: name || slug,
-        slug,
-        description,
-        path: destDir,
-    };
-}
-function isValidSkillContent(content) {
-    const first10 = content.split(/\r?\n/).slice(0, 10);
-    return first10.some((line) => /^#{1,6}\s/.test(line));
-}
-/**
- * Install a skill from raw markdown content and a caller-chosen slug.
- * Useful for paste-to-install workflows.
- */
-export function installSkillFromContent(content, slug) {
-    if (!slug || /[\/\\]/.test(slug) || slug === "." || slug === ".." || slug.includes("..")) {
-        throw new Error("Invalid slug — must be a non-empty string without path separators or traversals.");
-    }
-    const destDir = join(SKILLS_DIR, slug);
-    if (!resolve(destDir).startsWith(resolve(SKILLS_DIR) + "/")) {
-        throw new Error("Invalid slug — resolved path escapes the skills directory.");
-    }
-    if (existsSync(destDir)) {
+export async function addSkill(url) {
+    const slug = basename(url, ".git").replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+    const dest = join(PATHS.skills, slug);
+    if (existsSync(dest)) {
         throw new Error(`Skill "${slug}" is already installed.`);
     }
-    if (!isValidSkillContent(content)) {
-        throw new Error("Content does not appear to be a valid SKILL.md (no heading found in first 10 lines).");
+    execSync(`git clone --depth 1 ${url} ${dest}`, { stdio: "pipe" });
+    // Verify SKILL.md exists
+    if (!existsSync(join(dest, "SKILL.md"))) {
+        rmSync(dest, { recursive: true, force: true });
+        throw new Error("Repository does not contain a SKILL.md file.");
     }
-    mkdirSync(destDir, { recursive: true });
-    writeFileSync(join(destDir, "SKILL.md"), content, "utf-8");
-    const { name, description } = parseSkillMd(content);
-    return {
-        name: name || slug,
-        slug,
-        description,
-        path: destDir,
-    };
 }
-/**
- * Scan a cloned repo for SKILL.md files in subdirectories (1 level deep).
- * Returns an array of { subdir, skillMdPath } for each found skill.
- */
-function discoverSkillsInRepo(repoDir) {
-    const found = [];
-    for (const entry of readdirSync(repoDir)) {
-        const subPath = join(repoDir, entry);
-        if (!statSync(subPath).isDirectory())
-            continue;
-        if (entry.startsWith(".") || entry === ".." || entry.includes(".."))
-            continue;
-        const mdPath = join(subPath, "SKILL.md");
-        if (existsSync(mdPath)) {
-            found.push({ subdir: entry, skillMdPath: mdPath });
-        }
+export async function removeSkill(slug) {
+    const dest = join(PATHS.skills, slug);
+    if (!existsSync(dest)) {
+        throw new Error(`Skill "${slug}" not found.`);
     }
-    return found;
-}
-/**
- * Install a skill from a git repo URL or a direct SKILL.md file URL.
- * Returns a single SkillInfo for single-skill repos/files, or an array
- * for repos containing multiple SKILL.md files in subdirectories.
- */
-export async function installSkill(input) {
-    let destDir;
-    try {
-        const parsed = parseSkillUrl(input);
-        if (parsed.type === "file") {
-            return await installSkillFromFile(parsed.rawUrl, parsed.slug);
-        }
-        const repoUrl = parsed.url;
-        const repoName = basename(repoUrl, ".git").replace(/\.git$/, "");
-        if (!repoName) {
-            throw new Error("Could not determine skill name from URL.");
-        }
-        destDir = join(SKILLS_DIR, repoName);
-        execFileSync("git", ["clone", repoUrl, destDir], {
-            stdio: "pipe",
-            timeout: 60_000,
-        });
-        const skillMdPath = join(destDir, "SKILL.md");
-        if (existsSync(skillMdPath)) {
-            // Single-skill repo (root SKILL.md)
-            const content = readFileSync(skillMdPath, "utf-8");
-            const { name, description } = parseSkillMd(content);
-            return {
-                name: name || repoName,
-                slug: repoName,
-                description,
-                path: destDir,
-            };
-        }
-        // No root SKILL.md — scan subdirectories for multi-skill repos
-        const discovered = discoverSkillsInRepo(destDir);
-        if (discovered.length === 0) {
-            rmSync(destDir, { recursive: true, force: true });
-            destDir = undefined;
-            throw new Error(`Repository "${repoUrl}" does not contain a SKILL.md file at the root or in any subdirectory. ` +
-                `If skills are nested deeper, try installing with a direct URL to the SKILL.md file.`);
-        }
-        // Install each discovered skill into its own SKILLS_DIR/<slug> directory
-        const installed = [];
-        for (const { subdir, skillMdPath: mdPath } of discovered) {
-            const skillDest = join(SKILLS_DIR, subdir);
-            if (existsSync(skillDest)) {
-                console.error(`[io] Skipping "${subdir}" — already installed.`);
-                continue;
-            }
-            mkdirSync(skillDest, { recursive: true });
-            copyFileSync(mdPath, join(skillDest, "SKILL.md"));
-            // Also copy agents/ subdirectory if present
-            const agentsDir = join(destDir, subdir, "agents");
-            if (existsSync(agentsDir) && statSync(agentsDir).isDirectory()) {
-                execFileSync("cp", ["-r", agentsDir, join(skillDest, "agents")], { stdio: "pipe" });
-            }
-            const content = readFileSync(mdPath, "utf-8");
-            const { name, description } = parseSkillMd(content);
-            installed.push({ name: name || subdir, slug: subdir, description, path: skillDest });
-        }
-        // Clean up cloned repo — individual skills have been extracted
-        rmSync(destDir, { recursive: true, force: true });
-        destDir = undefined;
-        if (installed.length === 0) {
-            throw new Error("All skills in the repository are already installed.");
-        }
-        return installed.length === 1 ? installed[0] : installed;
-    }
-    catch (e) {
-        // Clean up partially-created directory on failure
-        if (destDir && existsSync(destDir)) {
-            rmSync(destDir, { recursive: true, force: true });
-        }
-        throw e instanceof Error ? e : new Error(String(e));
-    }
-}
-/**
- * Remove a skill directory by its slug. Returns true if it existed.
- */
-export function removeSkill(slug) {
-    const skillDir = join(SKILLS_DIR, slug);
-    if (!existsSync(skillDir))
-        return false;
-    rmSync(skillDir, { recursive: true, force: true });
-    return true;
+    rmSync(dest, { recursive: true, force: true });
 }
-/**
- * Search the skills registry for skills matching the given query.
- * Returns an empty array on network or parsing errors.
- */
-export async function searchSkillsRegistry(query) {
-    try {
-        const url = `https://skills.sh/api/search?q=${encodeURIComponent(query)}`;
-        const response = await fetch(url);
-        if (!response.ok)
-            return [];
-        const data = (await response.json());
-        return Array.isArray(data) ? data : [];
-    }
-    catch {
+export async function loadSkillDirectories() {
+    if (!existsSync(PATHS.skills))
         return [];
-    }
-}
-/**
- * Update a skill's metadata (name and/or description).
- * Rewrites the SKILL.md file with the updated frontmatter while preserving content.
- * Throws if the skill doesn't exist.
- */
-export function updateSkill(slug, updates) {
-    const skillDir = join(SKILLS_DIR, slug);
-    if (!existsSync(skillDir)) {
-        throw new Error(`Skill not found: ${slug}`);
-    }
-    const skillMdPath = join(skillDir, "SKILL.md");
-    if (!existsSync(skillMdPath)) {
-        throw new Error(`SKILL.md not found for skill: ${slug}`);
-    }
-    const currentContent = readFileSync(skillMdPath, "utf-8");
-    const { name: currentName, description: currentDescription } = parseSkillMd(currentContent);
-    // Use provided updates or fall back to current values
-    const newName = updates.name ?? currentName;
-    const newDescription = updates.description ?? currentDescription;
-    // Rebuild SKILL.md with new metadata
-    // Keep everything after the description intact (preserve any extra content)
-    const lines = currentContent.split(/\r?\n/);
-    const newLines = [];
-    // Add the new heading
-    newLines.push(`# ${newName}`);
-    newLines.push("");
-    // Add the new description
-    if (newDescription) {
-        newLines.push(newDescription);
-        newLines.push("");
-    }
-    // Find where the original description ends and append the rest
-    let foundHeading = false;
-    let skippedDescription = false;
-    let blankLinesSeen = 0;
-    for (const line of lines) {
-        if (!foundHeading) {
-            if (line.match(/^#\s+(.+)/)) {
-                foundHeading = true;
-            }
-            continue;
-        }
-        if (!skippedDescription) {
-            if (line.trim() === "") {
-                blankLinesSeen++;
-                if (blankLinesSeen >= 2) {
-                    skippedDescription = true;
-                }
-            }
-            else {
-                blankLinesSeen = 0;
-            }
-            continue;
-        }
-        // We're past the description now
-        newLines.push(line);
-    }
-    const newContent = newLines.join("\n");
-    writeFileSync(skillMdPath, newContent, "utf-8");
-    return {
-        name: newName,
-        slug,
-        description: newDescription,
-        path: skillDir,
-    };
-}
-/**
- * Delete a skill (alias for removeSkill for consistency with other store modules).
- */
-export function deleteSkill(slug) {
-    return removeSkill(slug);
+    const entries = readdirSync(PATHS.skills, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory() && existsSync(join(PATHS.skills, e.name, "SKILL.md")))
+        .map((e) => join(PATHS.skills, e.name));
 }
 //# sourceMappingURL=skills.js.map