@sundial-ai/cli 0.0.1

package/dist/core/config-manager.js

@@ -0,0 +1,47 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+const CONFIG_DIR = path.join(os.homedir(), '.sun');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    defaultAgents: [],
+    firstRunComplete: false
+};
+export async function ensureConfigDir() {
+    await fs.ensureDir(CONFIG_DIR);
+}
+export async function loadConfig() {
+    try {
+        await ensureConfigDir();
+        if (await fs.pathExists(CONFIG_FILE)) {
+            const content = await fs.readFile(CONFIG_FILE, 'utf-8');
+            return { ...DEFAULT_CONFIG, ...JSON.parse(content) };
+        }
+    }
+    catch {
+        // Config doesn't exist or is invalid, return default
+    }
+    return { ...DEFAULT_CONFIG };
+}
+export async function saveConfig(config) {
+    await ensureConfigDir();
+    await fs.writeFile(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export async function isFirstRun() {
+    const config = await loadConfig();
+    return !config.firstRunComplete;
+}
+export async function getDefaultAgents() {
+    const config = await loadConfig();
+    return config.defaultAgents;
+}
+export async function setDefaultAgents(agents) {
+    const config = await loadConfig();
+    config.defaultAgents = agents;
+    config.firstRunComplete = true;
+    await saveConfig(config);
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/core/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sourceRoot":"","sources":["../../src/core/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AACnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,cAAc,GAAc;IAChC,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,eAAe,EAAE,CAAC;QACxB,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACxD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IACD,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAiB;IAChD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,aAAa,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAmB;IACxD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/core/skill-hash.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compute a SHA-256 hash of all files in a skill folder.
+ * This allows detecting if two skills with the same name have different content.
+ *
+ * The hash is computed by:
+ * 1. Getting all files recursively
+ * 2. Sorting them by path for consistency
+ * 3. Hashing each file's relative path + content
+ * 4. Combining into a final hash
+ */
+export declare function computeContentHash(skillPath: string): Promise<string>;
+//# sourceMappingURL=skill-hash.d.ts.map

package/dist/core/skill-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-hash.d.ts","sourceRoot":"","sources":["../../src/core/skill-hash.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB3E"}

package/dist/core/skill-hash.js

@@ -0,0 +1,53 @@
+import crypto from 'crypto';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Get all files in a directory recursively, sorted for consistency.
+ */
+async function getAllFiles(dir) {
+    const files = [];
+    async function walk(currentDir) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    // Sort for consistent ordering across platforms
+    return files.sort();
+}
+/**
+ * Compute a SHA-256 hash of all files in a skill folder.
+ * This allows detecting if two skills with the same name have different content.
+ *
+ * The hash is computed by:
+ * 1. Getting all files recursively
+ * 2. Sorting them by path for consistency
+ * 3. Hashing each file's relative path + content
+ * 4. Combining into a final hash
+ */
+export async function computeContentHash(skillPath) {
+    const files = await getAllFiles(skillPath);
+    if (files.length === 0) {
+        // Empty folder - return hash of empty string
+        return crypto.createHash('sha256').update('').digest('hex').slice(0, 12);
+    }
+    const hash = crypto.createHash('sha256');
+    for (const file of files) {
+        // Include relative path in hash (so moving files changes the hash)
+        const relativePath = path.relative(skillPath, file);
+        hash.update(relativePath);
+        // Include file content
+        const content = await fs.readFile(file);
+        hash.update(content);
+    }
+    // Return first 12 chars for readability
+    return hash.digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=skill-hash.js.map

package/dist/core/skill-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-hash.js","sourceRoot":"","sources":["../../src/core/skill-hash.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,IAAI,CAAC,UAAkB;QACpC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,gDAAgD;IAChD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACxD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,6CAA6C;QAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mEAAmE;QACnE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAE1B,uBAAuB;QACvB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,wCAAwC;IACxC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/skill-info.d.ts

@@ -0,0 +1,34 @@
+import type { SkillMetadata, SkillInstallation } from '../types/index.js';
+/**
+ * Check if a directory is a valid skill.
+ * A valid skill must contain a SKILL.md with required frontmatter (name, description).
+ */
+export declare function isValidSkillDirectory(dirPath: string): Promise<boolean>;
+/**
+ * Find skill directories within a given path by searching recursively for SKILL.md files.
+ * A skill is any directory containing a valid SKILL.md file (with name + description).
+ */
+export declare function findSkillDirectories(searchPath: string): Promise<string[]>;
+/**
+ * Read skill metadata from SKILL.md frontmatter.
+ * The canonical skill name comes from the frontmatter, not the folder name.
+ */
+export declare function readSkillMetadata(skillPath: string): Promise<SkillMetadata | null>;
+/**
+ * Get the canonical skill name from SKILL.md frontmatter.
+ * Returns null if not a valid skill.
+ */
+export declare function getSkillName(skillPath: string): Promise<string | null>;
+/**
+ * Find all installations of a skill by name across all agents.
+ */
+export declare function findSkillInstallations(skillName: string): Promise<SkillInstallation[]>;
+/**
+ * List all installed skills for a specific agent.
+ */
+export declare function listSkillsForAgent(agentFolderName: string, isGlobal: boolean): Promise<string[]>;
+/**
+ * Check if a skill exists in an agent's folder.
+ */
+export declare function skillExists(skillName: string, agentFolderName: string, isGlobal: boolean): Promise<boolean>;
+//# sourceMappingURL=skill-info.d.ts.map

package/dist/core/skill-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-info.d.ts","sourceRoot":"","sources":["../../src/core/skill-info.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAa,MAAM,mBAAmB,CAAC;AAuFrF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc7E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BhF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CASxF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG5E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA+B5F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/core/skill-info.js

@@ -0,0 +1,213 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { SUPPORTED_AGENTS } from './agents.js';
+import { computeContentHash } from './skill-hash.js';
+/**
+ * Parse YAML-like frontmatter from SKILL.md content.
+ * Frontmatter is delimited by --- at start and end.
+ * Handles nested metadata field as key-value pairs.
+ */
+function parseFrontmatter(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        return null;
+    }
+    const lines = frontmatterMatch[1].split('\n');
+    let name = '';
+    let description = '';
+    let license;
+    let compatibility;
+    let allowedTools;
+    const metadata = {};
+    let inMetadata = false;
+    for (const line of lines) {
+        // Check if we're entering metadata block (indented or explicit)
+        if (line.match(/^metadata:\s*$/)) {
+            inMetadata = true;
+            continue;
+        }
+        // If line starts with non-whitespace, we're out of metadata block
+        if (inMetadata && line.match(/^\S/)) {
+            inMetadata = false;
+        }
+        const colonIndex = line.indexOf(':');
+        if (colonIndex > 0) {
+            const key = line.slice(0, colonIndex).trim();
+            let value = line.slice(colonIndex + 1).trim();
+            // Remove surrounding quotes if present
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (inMetadata) {
+                // Nested under metadata
+                metadata[key] = value;
+            }
+            else {
+                // Top-level fields
+                switch (key) {
+                    case 'name':
+                        name = value;
+                        break;
+                    case 'description':
+                        description = value;
+                        break;
+                    case 'license':
+                        license = value;
+                        break;
+                    case 'compatibility':
+                        compatibility = value;
+                        break;
+                    case 'allowed-tools':
+                        allowedTools = value;
+                        break;
+                }
+            }
+        }
+    }
+    // name and description are required
+    if (!name || !description) {
+        return null;
+    }
+    return {
+        name,
+        description,
+        license,
+        compatibility,
+        metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+        allowedTools
+    };
+}
+/**
+ * Check if a directory is a valid skill.
+ * A valid skill must contain a SKILL.md with required frontmatter (name, description).
+ */
+export async function isValidSkillDirectory(dirPath) {
+    const skillMdPath = path.join(dirPath, 'SKILL.md');
+    if (!await fs.pathExists(skillMdPath)) {
+        return false;
+    }
+    try {
+        const content = await fs.readFile(skillMdPath, 'utf-8');
+        const metadata = parseFrontmatter(content);
+        return metadata !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find skill directories within a given path by searching recursively for SKILL.md files.
+ * A skill is any directory containing a valid SKILL.md file (with name + description).
+ */
+export async function findSkillDirectories(searchPath) {
+    const skills = [];
+    // Recursively find all SKILL.md files
+    async function searchRecursively(dir) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isFile() && entry.name === 'SKILL.md') {
+                    // Found a SKILL.md - check if it's valid
+                    if (await isValidSkillDirectory(dir)) {
+                        skills.push(dir);
+                    }
+                }
+                else if (entry.isDirectory() && !entry.name.startsWith('.git')) {
+                    // Skip .git directories but recurse into others
+                    await searchRecursively(fullPath);
+                }
+            }
+        }
+        catch {
+            // Permission denied or other error, skip this directory
+        }
+    }
+    await searchRecursively(searchPath);
+    return skills;
+}
+/**
+ * Read skill metadata from SKILL.md frontmatter.
+ * The canonical skill name comes from the frontmatter, not the folder name.
+ */
+export async function readSkillMetadata(skillPath) {
+    const skillMdPath = path.join(skillPath, 'SKILL.md');
+    try {
+        const content = await fs.readFile(skillMdPath, 'utf-8');
+        return parseFrontmatter(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the canonical skill name from SKILL.md frontmatter.
+ * Returns null if not a valid skill.
+ */
+export async function getSkillName(skillPath) {
+    const metadata = await readSkillMetadata(skillPath);
+    return metadata?.name || null;
+}
+/**
+ * Find all installations of a skill by name across all agents.
+ */
+export async function findSkillInstallations(skillName) {
+    const installations = [];
+    // Check both local and global for each agent
+    const locations = [
+        { base: process.cwd(), isGlobal: false },
+        { base: os.homedir(), isGlobal: true }
+    ];
+    for (const { base, isGlobal } of locations) {
+        for (const agent of SUPPORTED_AGENTS) {
+            const skillPath = path.join(base, agent.folderName, 'skills', skillName);
+            if (await fs.pathExists(skillPath)) {
+                const metadata = await readSkillMetadata(skillPath);
+                if (metadata) {
+                    const contentHash = await computeContentHash(skillPath);
+                    installations.push({
+                        agent: agent.flag,
+                        path: skillPath,
+                        isGlobal,
+                        metadata,
+                        contentHash
+                    });
+                }
+            }
+        }
+    }
+    return installations;
+}
+/**
+ * List all installed skills for a specific agent.
+ */
+export async function listSkillsForAgent(agentFolderName, isGlobal) {
+    const base = isGlobal ? os.homedir() : process.cwd();
+    const skillsDir = path.join(base, agentFolderName, 'skills');
+    if (!await fs.pathExists(skillsDir)) {
+        return [];
+    }
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const skillPath = path.join(skillsDir, entry.name);
+            const skillName = await getSkillName(skillPath);
+            if (skillName) {
+                skills.push(skillName);
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Check if a skill exists in an agent's folder.
+ */
+export async function skillExists(skillName, agentFolderName, isGlobal) {
+    const base = isGlobal ? os.homedir() : process.cwd();
+    const skillPath = path.join(base, agentFolderName, 'skills', skillName);
+    return (await fs.pathExists(skillPath)) && (await isValidSkillDirectory(skillPath));
+}
+//# sourceMappingURL=skill-info.js.map

package/dist/core/skill-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-info.js","sourceRoot":"","sources":["../../src/core/skill-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAChE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,OAA2B,CAAC;IAChC,IAAI,aAAiC,CAAC;IACtC,IAAI,YAAgC,CAAC;IACrC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,gEAAgE;QAChE,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjC,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,kEAAkE;QAClE,IAAI,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE9C,uCAAuC;YACvC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACnD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,UAAU,EAAE,CAAC;gBACf,wBAAwB;gBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,QAAQ,GAAG,EAAE,CAAC;oBACZ,KAAK,MAAM;wBACT,IAAI,GAAG,KAAK,CAAC;wBACb,MAAM;oBACR,KAAK,aAAa;wBAChB,WAAW,GAAG,KAAK,CAAC;wBACpB,MAAM;oBACR,KAAK,SAAS;wBACZ,OAAO,GAAG,KAAK,CAAC;wBAChB,MAAM;oBACR,KAAK,eAAe;wBAClB,aAAa,GAAG,KAAK,CAAC;wBACtB,MAAM;oBACR,KAAK,eAAe;wBAClB,YAAY,GAAG,KAAK,CAAC;wBACrB,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI;QACJ,WAAW;QACX,OAAO;QACP,aAAa;QACb,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACjE,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAe;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEnD,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,QAAQ,KAAK,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,sCAAsC;IACtC,KAAK,UAAU,iBAAiB,CAAC,GAAW;QAC1C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE5C,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAChD,yCAAyC;oBACzC,IAAI,MAAM,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;wBACrC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjE,gDAAgD;oBAChD,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB;IAC5D,MAAM,aAAa,GAAwB,EAAE,CAAC;IAE9C,6CAA6C;IAC7C,MAAM,SAAS,GAAG;QAChB,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;QACxC,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KACvC,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEzE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;gBACpD,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;oBAExD,aAAa,CAAC,IAAI,CAAC;wBACjB,KAAK,EAAE,KAAK,CAAC,IAAiB;wBAC9B,IAAI,EAAE,SAAS;wBACf,QAAQ;wBACR,QAAQ;wBACR,WAAW;qBACZ,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,eAAuB,EACvB,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;IAE7D,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,eAAuB,EACvB,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxE,OAAO,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/core/skill-install.d.ts

@@ -0,0 +1,24 @@
+import type { AgentType, SkillSource } from '../types/index.js';
+/**
+ * Install skill(s) from a local path.
+ * Checks if path is a skill, otherwise checks direct children for SKILL.md.
+ */
+export declare function installFromLocal(source: SkillSource, agentFlag: AgentType, isGlobal: boolean): Promise<string[]>;
+/**
+ * Install skill(s) from GitHub using degit.
+ * After downloading, checks if it's a skill or searches direct children for SKILL.md.
+ */
+export declare function installFromGithub(source: SkillSource, agentFlag: AgentType, isGlobal: boolean): Promise<string[]>;
+/**
+ * Install skill(s) from any source to an agent.
+ * Returns list of installed skill names.
+ */
+export declare function installSkill(skillInput: string, agentFlag: AgentType, isGlobal: boolean): Promise<{
+    skillNames: string[];
+    source: SkillSource;
+}>;
+/**
+ * Remove a skill from an agent.
+ */
+export declare function removeSkill(skillName: string, agentFlag: AgentType, isGlobal: boolean): Promise<boolean>;
+//# sourceMappingURL=skill-install.d.ts.map

package/dist/core/skill-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-install.d.ts","sourceRoot":"","sources":["../../src/core/skill-install.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA2ChE;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CAkBxD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/core/skill-install.js

@@ -0,0 +1,123 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+import { getAgentByFlag } from './agents.js';
+import { resolveSkillSource } from './skill-source.js';
+import { findSkillDirectories, readSkillMetadata } from './skill-info.js';
+/**
+ * Get the destination path for installing a skill.
+ * Skill name comes from SKILL.md frontmatter.
+ */
+function getSkillDestination(skillName, agentFlag, isGlobal) {
+    const agent = getAgentByFlag(agentFlag);
+    if (!agent) {
+        throw new Error(`Unknown agent: ${agentFlag}`);
+    }
+    const base = isGlobal ? os.homedir() : process.cwd();
+    return path.join(base, agent.folderName, 'skills', skillName);
+}
+/**
+ * Install a single skill directory to an agent.
+ * The skill name is taken from SKILL.md frontmatter (not the folder name).
+ * The destination folder will be named after the frontmatter name.
+ */
+async function installSkillDirectory(skillDir, agentFlag, isGlobal) {
+    // Get metadata from SKILL.md frontmatter (name and description are required)
+    const metadata = await readSkillMetadata(skillDir);
+    if (!metadata) {
+        throw new Error(`Invalid skill at "${skillDir}": SKILL.md must have name and description in frontmatter`);
+    }
+    const dest = getSkillDestination(metadata.name, agentFlag, isGlobal);
+    // Ensure parent directory exists
+    await fs.ensureDir(path.dirname(dest));
+    // Copy the skill folder (folder will be renamed to match frontmatter name)
+    await fs.copy(skillDir, dest, { overwrite: true });
+    return metadata.name;
+}
+/**
+ * Install skill(s) from a local path.
+ * Checks if path is a skill, otherwise checks direct children for SKILL.md.
+ */
+export async function installFromLocal(source, agentFlag, isGlobal) {
+    const skillDirs = await findSkillDirectories(source.location);
+    if (skillDirs.length === 0) {
+        throw new Error(`No skills found in "${source.location}". A skill must contain a SKILL.md file.`);
+    }
+    const installedSkills = [];
+    for (const skillDir of skillDirs) {
+        const skillName = await installSkillDirectory(skillDir, agentFlag, isGlobal);
+        installedSkills.push(skillName);
+    }
+    return installedSkills;
+}
+/**
+ * Install skill(s) from GitHub using degit.
+ * After downloading, checks if it's a skill or searches direct children for SKILL.md.
+ */
+export async function installFromGithub(source, agentFlag, isGlobal) {
+    // Create a temp directory to download to
+    const tempDir = path.join(os.tmpdir(), `sun-install-${Date.now()}`);
+    try {
+        // Download using degit
+        await fs.ensureDir(tempDir);
+        try {
+            execSync(`npx degit ${source.location} "${tempDir}"`, {
+                stdio: 'pipe'
+            });
+        }
+        catch (error) {
+            const err = error;
+            const stderr = err.stderr?.toString() || err.message;
+            throw new Error(`Failed to download from GitHub: ${stderr}`);
+        }
+        // Find skills in downloaded content (checks itself and direct children)
+        const skillDirs = await findSkillDirectories(tempDir);
+        if (skillDirs.length === 0) {
+            throw new Error(`No skills found in "${source.originalInput}". A skill must contain a SKILL.md file.`);
+        }
+        // Install each skill found (name comes from SKILL.md frontmatter)
+        const installedSkills = [];
+        for (const skillDir of skillDirs) {
+            const skillName = await installSkillDirectory(skillDir, agentFlag, isGlobal);
+            installedSkills.push(skillName);
+        }
+        return installedSkills;
+    }
+    finally {
+        // Clean up temp directory
+        await fs.remove(tempDir).catch(() => { });
+    }
+}
+/**
+ * Install skill(s) from any source to an agent.
+ * Returns list of installed skill names.
+ */
+export async function installSkill(skillInput, agentFlag, isGlobal) {
+    const source = resolveSkillSource(skillInput);
+    let skillNames;
+    switch (source.type) {
+        case 'local':
+            skillNames = await installFromLocal(source, agentFlag, isGlobal);
+            break;
+        case 'github':
+        case 'shortcut':
+            skillNames = await installFromGithub(source, agentFlag, isGlobal);
+            break;
+        default:
+            throw new Error(`Unknown source type: ${source.type}`);
+    }
+    return { skillNames, source };
+}
+/**
+ * Remove a skill from an agent.
+ */
+export async function removeSkill(skillName, agentFlag, isGlobal) {
+    const dest = getSkillDestination(skillName, agentFlag, isGlobal);
+    if (await fs.pathExists(dest)) {
+        await fs.remove(dest);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=skill-install.js.map

package/dist/core/skill-install.js.map

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

package/dist/core/skill-source.d.ts

@@ -0,0 +1,29 @@
+import type { SkillSource } from '../types/index.js';
+/**
+ * Check if input looks like a GitHub URL or reference.
+ * Matches: github.com/user/repo, https://github.com/..., etc.
+ */
+export declare function isGithubUrl(input: string): boolean;
+/**
+ * Check if input looks like a local file path.
+ * Matches: ./path, ../path, ~/path, /absolute/path
+ */
+export declare function isLocalPath(input: string): boolean;
+/**
+ * Resolve a skill input to its source type and location.
+ *
+ * Resolution order:
+ * 1. Check if it's a registered shortcut (e.g., "tinker")
+ * 2. Check if it contains "github.com" (treat as GitHub URL)
+ * 3. Check if it's a valid local path
+ * 4. Otherwise, throw error
+ */
+export declare function resolveSkillSource(input: string): SkillSource;
+/**
+ * Extract skill name from a source.
+ * For GitHub: last path segment
+ * For local: folder name
+ * For shortcut: the shortcut name itself
+ */
+export declare function getSkillNameFromSource(source: SkillSource): string;
+//# sourceMappingURL=skill-source.d.ts.map

package/dist/core/skill-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-source.d.ts","sourceRoot":"","sources":["../../src/core/skill-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AA0BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAsC7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAclE"}