@sundial-ai/cli 0.0.1

package/dist/commands/show-dev.js

@@ -0,0 +1,195 @@
+/**
+ * Dev-only show commands for debugging and exploration.
+ * These search the entire file system starting from home directory.
+ */
+import chalk from 'chalk';
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { SUPPORTED_AGENTS } from '../core/agents.js';
+import { readSkillMetadata } from '../core/skill-info.js';
+const execAsync = promisify(exec);
+// Timeout for find commands (60 seconds)
+const FIND_TIMEOUT = 60000;
+/**
+ * List skills in a directory, returning name and description.
+ */
+async function listSkillsInDir(skillsDir) {
+    const skills = [];
+    if (!await fs.pathExists(skillsDir)) {
+        return skills;
+    }
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const skillPath = path.join(skillsDir, entry.name);
+            const metadata = await readSkillMetadata(skillPath);
+            if (metadata) {
+                skills.push({
+                    name: metadata.name,
+                    description: metadata.description
+                });
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * sun show all-agent-folders
+ * Find ALL agent folders (.claude, .codex, .gemini) starting from ~ and show skills in each.
+ */
+export async function showAllAgentFolders() {
+    const homeDir = os.homedir();
+    // Build find command: find ~ -type d \( -name ".claude" -o -name ".codex" -o -name ".gemini" \)
+    const namePatterns = SUPPORTED_AGENTS.map(a => `-name "${a.folderName}"`).join(' -o ');
+    const findCmd = `find "${homeDir}" -type d \\( ${namePatterns} \\)`;
+    console.log(chalk.cyan('All Agent Folders'));
+    console.log(chalk.gray('─'.repeat(40)));
+    console.log();
+    let stdout = '';
+    try {
+        const result = await execAsync(findCmd, { maxBuffer: 10 * 1024 * 1024, timeout: FIND_TIMEOUT });
+        stdout = result.stdout;
+    }
+    catch (err) {
+        // find exits non-zero on permission errors but still produces output
+        if (err.stdout) {
+            stdout = err.stdout;
+        }
+        else {
+            console.log(chalk.red('Failed to search for agent folders.'));
+            console.log(chalk.gray(String(err)));
+            return;
+        }
+    }
+    const agentPaths = stdout.trim().split('\n').filter(Boolean);
+    if (agentPaths.length === 0) {
+        console.log(chalk.yellow('No agent folders found.'));
+        return;
+    }
+    for (const agentPath of agentPaths) {
+        const folderName = path.basename(agentPath);
+        const agent = SUPPORTED_AGENTS.find(a => a.folderName === folderName);
+        if (!agent)
+            continue;
+        console.log(chalk.white.bold(agent.name));
+        console.log(chalk.gray(`  ${agentPath}`));
+        // List skills
+        const skillsDir = path.join(agentPath, 'skills');
+        const skills = await listSkillsInDir(skillsDir);
+        if (skills.length === 0) {
+            console.log(chalk.gray('  No skills installed'));
+        }
+        else {
+            console.log(`  Skills (${skills.length}):`);
+            for (const skill of skills) {
+                console.log(`    - ${skill.name} ${chalk.gray(`- ${skill.description}`)}`);
+            }
+        }
+        console.log();
+    }
+}
+/**
+ * sun show all-agent-skills-folders
+ * Find ALL <agent>/skills folders starting from ~ and show skills in each.
+ */
+export async function showAllAgentSkillsFolders() {
+    const homeDir = os.homedir();
+    // Build find command for skills directories inside agent folders
+    // e.g., find ~ -type d \( -path "*/.claude/skills" -o -path "*/.codex/skills" -o -path "*/.gemini/skills" \)
+    const pathPatterns = SUPPORTED_AGENTS.map(a => `-path "*/${a.folderName}/skills"`).join(' -o ');
+    const findCmd = `find "${homeDir}" -type d \\( ${pathPatterns} \\)`;
+    console.log(chalk.cyan('All Agent Skills Folders'));
+    console.log(chalk.gray('─'.repeat(40)));
+    console.log();
+    let stdout = '';
+    try {
+        const result = await execAsync(findCmd, { maxBuffer: 10 * 1024 * 1024, timeout: FIND_TIMEOUT });
+        stdout = result.stdout;
+    }
+    catch (err) {
+        if (err.stdout) {
+            stdout = err.stdout;
+        }
+        else {
+            console.log(chalk.red('Failed to search for skills folders.'));
+            console.log(chalk.gray(String(err)));
+            return;
+        }
+    }
+    const skillsDirs = stdout.trim().split('\n').filter(Boolean);
+    if (skillsDirs.length === 0) {
+        console.log(chalk.yellow('No agent skills folders found.'));
+        return;
+    }
+    for (const skillsDir of skillsDirs) {
+        // Get agent name from parent folder
+        const agentFolder = path.basename(path.dirname(skillsDir));
+        const agent = SUPPORTED_AGENTS.find(a => a.folderName === agentFolder);
+        console.log(chalk.white.bold(agent?.name ?? agentFolder));
+        console.log(chalk.gray(`  ${skillsDir}`));
+        // List skills
+        const skills = await listSkillsInDir(skillsDir);
+        if (skills.length === 0) {
+            console.log(chalk.gray('  No skills installed'));
+        }
+        else {
+            console.log(`  Skills (${skills.length}):`);
+            for (const skill of skills) {
+                console.log(`    - ${skill.name} ${chalk.gray(`- ${skill.description}`)}`);
+            }
+        }
+        console.log();
+    }
+}
+/**
+ * sun show all-skill-folders
+ * Find ALL folders containing a valid SKILL.md (with name/description frontmatter).
+ */
+export async function showAllSkillFolders() {
+    const homeDir = os.homedir();
+    // Find all SKILL.md files
+    const findCmd = `find "${homeDir}" -name "SKILL.md" -type f`;
+    console.log(chalk.cyan('All Skill Folders'));
+    console.log(chalk.gray('─'.repeat(40)));
+    console.log();
+    let stdout = '';
+    try {
+        const result = await execAsync(findCmd, { maxBuffer: 10 * 1024 * 1024, timeout: FIND_TIMEOUT });
+        stdout = result.stdout;
+    }
+    catch (err) {
+        if (err.stdout) {
+            stdout = err.stdout;
+        }
+        else {
+            console.log(chalk.red('Failed to search for SKILL.md files.'));
+            console.log(chalk.gray(String(err)));
+            return;
+        }
+    }
+    const skillMdPaths = stdout.trim().split('\n').filter(Boolean);
+    if (skillMdPaths.length === 0) {
+        console.log(chalk.yellow('No SKILL.md files found.'));
+        return;
+    }
+    let validCount = 0;
+    for (const skillMdPath of skillMdPaths) {
+        const skillDir = path.dirname(skillMdPath);
+        const metadata = await readSkillMetadata(skillDir);
+        // Only show if it has valid name and description
+        if (metadata && metadata.name && metadata.description) {
+            validCount++;
+            console.log(chalk.white.bold(metadata.name));
+            console.log(chalk.gray(`  ${skillDir}`));
+            console.log(`  ${metadata.description}`);
+            console.log();
+        }
+    }
+    if (validCount === 0) {
+        console.log(chalk.yellow('No valid SKILL.md files found (missing name/description frontmatter).'));
+    }
+}
+//# sourceMappingURL=show-dev.js.map

package/dist/commands/show-dev.js.map

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

package/dist/commands/show.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Show skill details and installation locations.
+ * If no skill specified, shows all agent folders and their packages.
+ *
+ * Secret commands (not in README, documented in DEV.md):
+ * - all-agent-folders: Find all agent folders on the system
+ * - all-agent-skills-folders: Find all <agent>/skills folders
+ * - all-skill-folders: Find all folders with valid SKILL.md
+ */
+export declare function showCommand(skillName?: string): Promise<void>;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AA2FA;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGnE"}

package/dist/commands/show.js

@@ -0,0 +1,175 @@
+import chalk from 'chalk';
+import path from 'path';
+import { findSkillInstallations, readSkillMetadata } from '../core/skill-info.js';
+import { getAgentByFlag } from '../core/agents.js';
+import { detectAllAgents, detectLocalAgents } from '../core/agent-detect.js';
+import { getDefaultAgents } from '../core/config-manager.js';
+import { showAllAgentFolders, showAllAgentSkillsFolders, showAllSkillFolders } from './show-dev.js';
+import fs from 'fs-extra';
+/**
+ * List all skills in a given skills directory path.
+ */
+async function listSkillsInPath(skillsDir) {
+    const skills = [];
+    if (!await fs.pathExists(skillsDir)) {
+        return skills;
+    }
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const skillPath = path.join(skillsDir, entry.name);
+            const metadata = await readSkillMetadata(skillPath);
+            if (metadata) {
+                skills.push({
+                    name: metadata.name,
+                    description: metadata.description
+                });
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Show all agent folders and their installed skills.
+ */
+async function showAllAgents() {
+    const allAgents = await detectAllAgents();
+    const defaultAgents = await getDefaultAgents();
+    const defaultSet = new Set(defaultAgents);
+    const localAgents = await detectLocalAgents();
+    const localAgentFlags = new Set(localAgents.map(a => a.agent.flag));
+    if (allAgents.length === 0) {
+        console.log(chalk.yellow('No agent folders found.'));
+        console.log(chalk.gray('Agent folders are directories like .claude/, .codex/, .gemini/'));
+        return;
+    }
+    console.log(chalk.cyan('Agent Folders & Installed Skills'));
+    console.log(chalk.gray('─'.repeat(40)));
+    console.log();
+    for (const detected of allAgents) {
+        const { agent, path: agentPath, isGlobal } = detected;
+        const locationLabel = isGlobal ? chalk.gray('(global)') : chalk.gray('(local)');
+        const isDefault = defaultSet.has(agent.flag);
+        const hasLocalFolder = localAgentFlags.has(agent.flag);
+        // Show checkmark if this folder would be affected by sun add/remove:
+        // - Local folder: affected if agent is selected
+        // - Global folder: affected if agent is selected AND no local folder exists
+        const wouldBeAffected = isDefault && (isGlobal ? !hasLocalFolder : true);
+        const marker = wouldBeAffected ? chalk.green('✓') : chalk.gray('○');
+        console.log(`${marker} ${chalk.white.bold(agent.name)} ${locationLabel}`);
+        console.log(chalk.gray(`  ${agentPath}`));
+        // List skills in this agent folder
+        const skillsDir = path.join(agentPath, 'skills');
+        const skills = await listSkillsInPath(skillsDir);
+        if (skills.length === 0) {
+            console.log(chalk.gray('  No skills installed'));
+        }
+        else {
+            console.log(`  Skills (${skills.length}):`);
+            for (const skill of skills) {
+                console.log(`    - ${skill.name} ${chalk.gray(`- ${skill.description}`)}`);
+            }
+        }
+        console.log();
+    }
+    console.log(`${chalk.green('✓')} = affected by sun add/remove in this directory`);
+    console.log('Run "sun config" to change selected agents.');
+}
+/**
+ * Show skill details and installation locations.
+ * If no skill specified, shows all agent folders and their packages.
+ *
+ * Secret commands (not in README, documented in DEV.md):
+ * - all-agent-folders: Find all agent folders on the system
+ * - all-agent-skills-folders: Find all <agent>/skills folders
+ * - all-skill-folders: Find all folders with valid SKILL.md
+ */
+export async function showCommand(skillName) {
+    // Handle secret dev commands
+    if (skillName === 'all-agent-folders') {
+        await showAllAgentFolders();
+        return;
+    }
+    if (skillName === 'all-agent-skills-folders') {
+        await showAllAgentSkillsFolders();
+        return;
+    }
+    if (skillName === 'all-skill-folders') {
+        await showAllSkillFolders();
+        return;
+    }
+    // If no skill specified, show all agents and their packages
+    if (!skillName) {
+        await showAllAgents();
+        return;
+    }
+    const installations = await findSkillInstallations(skillName);
+    if (installations.length === 0) {
+        console.error(chalk.yellow(`Skill "${skillName}" is not installed.`));
+        process.exit(1);
+    }
+    // Check if there are multiple versions (different content hashes)
+    const uniqueHashes = new Set(installations.map(i => i.contentHash));
+    const hasMultipleVersions = uniqueHashes.size > 1;
+    if (hasMultipleVersions) {
+        // Multiple versions detected
+        console.log(chalk.cyan(`Skill: ${skillName}`));
+        console.log(chalk.yellow('Warning: Multiple versions detected'));
+        console.log();
+        // Group by content hash
+        const byHash = new Map();
+        for (const inst of installations) {
+            const existing = byHash.get(inst.contentHash) || [];
+            existing.push(inst);
+            byHash.set(inst.contentHash, existing);
+        }
+        let versionNum = 1;
+        for (const [hash, insts] of byHash) {
+            const firstInst = insts[0];
+            const locations = insts.map(i => {
+                const agent = getAgentByFlag(i.agent);
+                return i.isGlobal ? `~/${agent.folderName}/` : `${agent.folderName}/`;
+            });
+            console.log(chalk.white(`Version ${versionNum} (${locations.join(', ')}):`));
+            console.log(`  Description: ${firstInst.metadata.description}`);
+            if (firstInst.metadata.metadata?.author) {
+                console.log(`  Author: ${firstInst.metadata.metadata.author}`);
+            }
+            if (firstInst.metadata.metadata?.version) {
+                console.log(`  Version: ${firstInst.metadata.metadata.version}`);
+            }
+            if (firstInst.metadata.license) {
+                console.log(`  License: ${firstInst.metadata.license}`);
+            }
+            console.log(`  Content hash: ${hash}`);
+            console.log();
+            versionNum++;
+        }
+    }
+    else {
+        // Single version across all installations
+        const firstInst = installations[0];
+        console.log(chalk.cyan(`Skill: ${skillName}`));
+        console.log(`Description: ${firstInst.metadata.description}`);
+        if (firstInst.metadata.metadata?.author) {
+            console.log(`Author: ${firstInst.metadata.metadata.author}`);
+        }
+        if (firstInst.metadata.metadata?.version) {
+            console.log(`Version: ${firstInst.metadata.metadata.version}`);
+        }
+        if (firstInst.metadata.license) {
+            console.log(`License: ${firstInst.metadata.license}`);
+        }
+        if (firstInst.metadata.compatibility) {
+            console.log(`Compatibility: ${firstInst.metadata.compatibility}`);
+        }
+        console.log();
+        console.log('Installed in:');
+        for (const inst of installations) {
+            const agent = getAgentByFlag(inst.agent);
+            const location = inst.isGlobal ? '(global)' : '(local)';
+            console.log(`  - ${agent.folderName}/ ${chalk.gray(location)}`);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/core/agent-detect.d.ts

@@ -0,0 +1,22 @@
+import type { DetectedAgent, AgentConfig } from '../types/index.js';
+export declare function detectAgentsInDirectory(directory: string, isGlobal: boolean): Promise<DetectedAgent[]>;
+export declare function detectLocalAgents(): Promise<DetectedAgent[]>;
+export declare function detectGlobalAgents(): Promise<DetectedAgent[]>;
+/**
+ * Search the entire file system for all agent folders.
+ * Uses `find -type d -name` for efficiency.
+ */
+export declare function detectAllAgentFolders(): Promise<DetectedAgent[]>;
+/**
+ * Search the entire file system for agent folders that contain skills.
+ * Uses `find` to locate skills directories with content.
+ */
+export declare function detectAllSkillsFolders(): Promise<DetectedAgent[]>;
+/**
+ * Detect agents in local and global directories only (fast).
+ */
+export declare function detectAllAgents(): Promise<DetectedAgent[]>;
+export declare function getAgentPath(agent: AgentConfig, isGlobal: boolean): string;
+export declare function getSkillsPath(agent: AgentConfig, isGlobal: boolean): string;
+export declare function ensureSkillsDirectory(agent: AgentConfig, isGlobal: boolean): Promise<string>;
+//# sourceMappingURL=agent-detect.d.ts.map

package/dist/core/agent-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detect.d.ts","sourceRoot":"","sources":["../../src/core/agent-detect.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOpE,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAe5G;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAElE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAEnE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAkCtE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAMhE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAG1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE3E;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlG"}

package/dist/core/agent-detect.js

@@ -0,0 +1,107 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { SUPPORTED_AGENTS } from './agents.js';
+const execAsync = promisify(exec);
+// Agent folder names to search for
+const AGENT_FOLDER_NAMES = new Set(SUPPORTED_AGENTS.map(a => a.folderName));
+export async function detectAgentsInDirectory(directory, isGlobal) {
+    const detected = [];
+    for (const agent of SUPPORTED_AGENTS) {
+        const agentPath = path.join(directory, agent.folderName);
+        if (await fs.pathExists(agentPath)) {
+            detected.push({
+                agent,
+                path: agentPath,
+                isGlobal
+            });
+        }
+    }
+    return detected;
+}
+export async function detectLocalAgents() {
+    return detectAgentsInDirectory(process.cwd(), false);
+}
+export async function detectGlobalAgents() {
+    return detectAgentsInDirectory(os.homedir(), true);
+}
+/**
+ * Search the entire file system for all agent folders.
+ * Uses `find -type d -name` for efficiency.
+ */
+export async function detectAllAgentFolders() {
+    const results = [];
+    const homeDir = os.homedir();
+    // Build find command: find ~ -type d \( -name ".claude" -o -name ".codex" -o -name ".gemini" \)
+    const namePatterns = SUPPORTED_AGENTS.map(a => `-name "${a.folderName}"`).join(' -o ');
+    const findCmd = `find "${homeDir}" -type d \\( ${namePatterns} \\) 2>/dev/null`;
+    try {
+        const { stdout } = await execAsync(findCmd, { maxBuffer: 10 * 1024 * 1024 });
+        const agentPaths = stdout.trim().split('\n').filter(Boolean);
+        for (const agentPath of agentPaths) {
+            const folderName = path.basename(agentPath);
+            const agent = SUPPORTED_AGENTS.find(a => a.folderName === folderName);
+            if (!agent)
+                continue;
+            const isGlobal = path.dirname(agentPath) === homeDir;
+            results.push({
+                agent,
+                path: agentPath,
+                isGlobal
+            });
+        }
+    }
+    catch {
+        // find command failed - fall back to simple detection
+        const [local, global] = await Promise.all([
+            detectLocalAgents(),
+            detectGlobalAgents()
+        ]);
+        return [...local, ...global];
+    }
+    return results;
+}
+/**
+ * Search the entire file system for agent folders that contain skills.
+ * Uses `find` to locate skills directories with content.
+ */
+export async function detectAllSkillsFolders() {
+    const allAgents = await detectAllAgentFolders();
+    // Filter to only those with skills installed
+    const withSkills = [];
+    for (const detected of allAgents) {
+        const skillsDir = path.join(detected.path, 'skills');
+        if (await fs.pathExists(skillsDir)) {
+            const entries = await fs.readdir(skillsDir);
+            if (entries.length > 0) {
+                withSkills.push(detected);
+            }
+        }
+    }
+    return withSkills;
+}
+/**
+ * Detect agents in local and global directories only (fast).
+ */
+export async function detectAllAgents() {
+    const [local, global] = await Promise.all([
+        detectLocalAgents(),
+        detectGlobalAgents()
+    ]);
+    return [...local, ...global];
+}
+export function getAgentPath(agent, isGlobal) {
+    const baseDir = isGlobal ? os.homedir() : process.cwd();
+    return path.join(baseDir, agent.folderName);
+}
+export function getSkillsPath(agent, isGlobal) {
+    return path.join(getAgentPath(agent, isGlobal), 'skills');
+}
+export async function ensureSkillsDirectory(agent, isGlobal) {
+    const skillsPath = getSkillsPath(agent, isGlobal);
+    await fs.ensureDir(skillsPath);
+    return skillsPath;
+}
+//# sourceMappingURL=agent-detect.js.map

package/dist/core/agent-detect.js.map

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

package/dist/core/agents.d.ts

@@ -0,0 +1,8 @@
+import type { AgentConfig, AgentType } from '../types/index.js';
+export declare const SUPPORTED_AGENTS: AgentConfig[];
+export declare function getAgentByFlag(flag: string): AgentConfig | undefined;
+export declare function getAgentByFolder(folderName: string): AgentConfig | undefined;
+export declare function getSupportedAgentsMessage(): string;
+export declare function isValidAgentType(flag: string): flag is AgentType;
+export declare function getAgentFlags(): string[];
+//# sourceMappingURL=agents.d.ts.map

package/dist/core/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/core/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAgBzC,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5E;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEhE;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/core/agents.js

@@ -0,0 +1,34 @@
+export const SUPPORTED_AGENTS = [
+    {
+        name: 'Claude Code',
+        flag: 'claude',
+        folderName: '.claude'
+    },
+    {
+        name: 'Codex',
+        flag: 'codex',
+        folderName: '.codex'
+    },
+    {
+        name: 'Gemini',
+        flag: 'gemini',
+        folderName: '.gemini'
+    }
+];
+export function getAgentByFlag(flag) {
+    return SUPPORTED_AGENTS.find(agent => agent.flag === flag);
+}
+export function getAgentByFolder(folderName) {
+    return SUPPORTED_AGENTS.find(agent => agent.folderName === folderName);
+}
+export function getSupportedAgentsMessage() {
+    const agentNames = SUPPORTED_AGENTS.map(a => a.name).join(', ');
+    return `Currently supported agents: ${agentNames}`;
+}
+export function isValidAgentType(flag) {
+    return SUPPORTED_AGENTS.some(agent => agent.flag === flag);
+}
+export function getAgentFlags() {
+    return SUPPORTED_AGENTS.map(a => a.flag);
+}
+//# sourceMappingURL=agents.js.map

package/dist/core/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/core/agents.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,SAAS;KACtB;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,QAAQ;KACrB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,SAAS;KACtB;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,+BAA+B,UAAU,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/config-manager.d.ts

@@ -0,0 +1,9 @@
+import type { SunConfig, AgentType } from '../types/index.js';
+export declare function ensureConfigDir(): Promise<void>;
+export declare function loadConfig(): Promise<SunConfig>;
+export declare function saveConfig(config: SunConfig): Promise<void>;
+export declare function isFirstRun(): Promise<boolean>;
+export declare function getDefaultAgents(): Promise<AgentType[]>;
+export declare function setDefaultAgents(agents: AgentType[]): Promise<void>;
+export declare function getConfigPath(): string;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/core/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/core/config-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAU9D,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAWrD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAGnD;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAG7D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}