@sundial-ai/cli 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PLAN.md +497 -0
- package/README.md +30 -0
- package/dist/commands/add.d.ts +13 -0
- package/dist/commands/add.d.ts.map +1 -0
- package/dist/commands/add.js +112 -0
- package/dist/commands/add.js.map +1 -0
- package/dist/commands/config.d.ts +5 -0
- package/dist/commands/config.d.ts.map +1 -0
- package/dist/commands/config.js +42 -0
- package/dist/commands/config.js.map +1 -0
- package/dist/commands/list.d.ts +5 -0
- package/dist/commands/list.d.ts.map +1 -0
- package/dist/commands/list.js +53 -0
- package/dist/commands/list.js.map +1 -0
- package/dist/commands/remove.d.ts +13 -0
- package/dist/commands/remove.d.ts.map +1 -0
- package/dist/commands/remove.js +127 -0
- package/dist/commands/remove.js.map +1 -0
- package/dist/commands/show.d.ts +5 -0
- package/dist/commands/show.d.ts.map +1 -0
- package/dist/commands/show.js +81 -0
- package/dist/commands/show.js.map +1 -0
- package/dist/core/agent-detect.d.ts +9 -0
- package/dist/core/agent-detect.d.ts.map +1 -0
- package/dist/core/agent-detect.js +44 -0
- package/dist/core/agent-detect.js.map +1 -0
- package/dist/core/agents.d.ts +8 -0
- package/dist/core/agents.d.ts.map +1 -0
- package/dist/core/agents.js +34 -0
- package/dist/core/agents.js.map +1 -0
- package/dist/core/config-manager.d.ts +9 -0
- package/dist/core/config-manager.d.ts.map +1 -0
- package/dist/core/config-manager.js +47 -0
- package/dist/core/config-manager.js.map +1 -0
- package/dist/core/skill-hash.d.ts +12 -0
- package/dist/core/skill-hash.d.ts.map +1 -0
- package/dist/core/skill-hash.js +53 -0
- package/dist/core/skill-hash.js.map +1 -0
- package/dist/core/skill-info.d.ts +35 -0
- package/dist/core/skill-info.d.ts.map +1 -0
- package/dist/core/skill-info.js +211 -0
- package/dist/core/skill-info.js.map +1 -0
- package/dist/core/skill-install.d.ts +24 -0
- package/dist/core/skill-install.d.ts.map +1 -0
- package/dist/core/skill-install.js +123 -0
- package/dist/core/skill-install.js.map +1 -0
- package/dist/core/skill-source.d.ts +29 -0
- package/dist/core/skill-source.d.ts.map +1 -0
- package/dist/core/skill-source.js +105 -0
- package/dist/core/skill-source.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +104 -0
- package/dist/index.js.map +1 -0
- package/dist/types/index.d.ts +57 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +2 -0
- package/dist/types/index.js.map +1 -0
- package/dist/utils/fuzzy-match.d.ts +16 -0
- package/dist/utils/fuzzy-match.d.ts.map +1 -0
- package/dist/utils/fuzzy-match.js +37 -0
- package/dist/utils/fuzzy-match.js.map +1 -0
- package/dist/utils/prompts.d.ts +16 -0
- package/dist/utils/prompts.d.ts.map +1 -0
- package/dist/utils/prompts.js +80 -0
- package/dist/utils/prompts.js.map +1 -0
- package/dist/utils/registry.d.ts +6 -0
- package/dist/utils/registry.d.ts.map +1 -0
- package/dist/utils/registry.js +14 -0
- package/dist/utils/registry.js.map +1 -0
- package/package.json +43 -0
- package/publish.sh +2 -0
- package/src/commands/add.ts +137 -0
- package/src/commands/config.ts +49 -0
- package/src/commands/list.ts +68 -0
- package/src/commands/remove.ts +152 -0
- package/src/commands/show.ts +93 -0
- package/src/core/agent-detect.ts +53 -0
- package/src/core/agents.ts +40 -0
- package/src/core/config-manager.ts +55 -0
- package/src/core/skill-hash.ts +61 -0
- package/src/core/skill-info.ts +246 -0
- package/src/core/skill-install.ts +165 -0
- package/src/core/skill-source.ts +118 -0
- package/src/index.ts +116 -0
- package/src/types/index.ts +64 -0
- package/src/utils/fuzzy-match.ts +48 -0
- package/src/utils/prompts.ts +92 -0
- package/src/utils/registry.ts +16 -0
- package/test/agents.test.ts +86 -0
- package/test/fuzzy-match.test.ts +58 -0
- package/test/registry.test.ts +48 -0
- package/test/skill-hash.test.ts +77 -0
- package/test/skill-info.test.ts +195 -0
- package/test/skill-source.test.ts +89 -0
- package/tsconfig.json +20 -0
- package/vitest.config.ts +15 -0
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { SkillMetadata, SkillInstallation } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Check if a directory is a valid skill.
|
|
4
|
+
* A valid skill must contain a SKILL.md with required frontmatter (name, description).
|
|
5
|
+
*/
|
|
6
|
+
export declare function isValidSkillDirectory(dirPath: string): Promise<boolean>;
|
|
7
|
+
/**
|
|
8
|
+
* Find skill directories within a given path.
|
|
9
|
+
* Only checks the path itself and its direct children.
|
|
10
|
+
* A skill is any directory containing a valid SKILL.md file (with name + description).
|
|
11
|
+
*/
|
|
12
|
+
export declare function findSkillDirectories(searchPath: string): Promise<string[]>;
|
|
13
|
+
/**
|
|
14
|
+
* Read skill metadata from SKILL.md frontmatter.
|
|
15
|
+
* The canonical skill name comes from the frontmatter, not the folder name.
|
|
16
|
+
*/
|
|
17
|
+
export declare function readSkillMetadata(skillPath: string): Promise<SkillMetadata | null>;
|
|
18
|
+
/**
|
|
19
|
+
* Get the canonical skill name from SKILL.md frontmatter.
|
|
20
|
+
* Returns null if not a valid skill.
|
|
21
|
+
*/
|
|
22
|
+
export declare function getSkillName(skillPath: string): Promise<string | null>;
|
|
23
|
+
/**
|
|
24
|
+
* Find all installations of a skill by name across all agents.
|
|
25
|
+
*/
|
|
26
|
+
export declare function findSkillInstallations(skillName: string): Promise<SkillInstallation[]>;
|
|
27
|
+
/**
|
|
28
|
+
* List all installed skills for a specific agent.
|
|
29
|
+
*/
|
|
30
|
+
export declare function listSkillsForAgent(agentFolderName: string, isGlobal: boolean): Promise<string[]>;
|
|
31
|
+
/**
|
|
32
|
+
* Check if a skill exists in an agent's folder.
|
|
33
|
+
*/
|
|
34
|
+
export declare function skillExists(skillName: string, agentFolderName: string, isGlobal: boolean): Promise<boolean>;
|
|
35
|
+
//# sourceMappingURL=skill-info.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBhF;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"}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
import fs from 'fs-extra';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import os from 'os';
|
|
4
|
+
import { SUPPORTED_AGENTS } from './agents.js';
|
|
5
|
+
import { computeContentHash } from './skill-hash.js';
|
|
6
|
+
/**
|
|
7
|
+
* Parse YAML-like frontmatter from SKILL.md content.
|
|
8
|
+
* Frontmatter is delimited by --- at start and end.
|
|
9
|
+
* Handles nested metadata field as key-value pairs.
|
|
10
|
+
*/
|
|
11
|
+
function parseFrontmatter(content) {
|
|
12
|
+
const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
|
|
13
|
+
if (!frontmatterMatch) {
|
|
14
|
+
return null;
|
|
15
|
+
}
|
|
16
|
+
const lines = frontmatterMatch[1].split('\n');
|
|
17
|
+
let name = '';
|
|
18
|
+
let description = '';
|
|
19
|
+
let license;
|
|
20
|
+
let compatibility;
|
|
21
|
+
let allowedTools;
|
|
22
|
+
const metadata = {};
|
|
23
|
+
let inMetadata = false;
|
|
24
|
+
for (const line of lines) {
|
|
25
|
+
// Check if we're entering metadata block (indented or explicit)
|
|
26
|
+
if (line.match(/^metadata:\s*$/)) {
|
|
27
|
+
inMetadata = true;
|
|
28
|
+
continue;
|
|
29
|
+
}
|
|
30
|
+
// If line starts with non-whitespace, we're out of metadata block
|
|
31
|
+
if (inMetadata && line.match(/^\S/)) {
|
|
32
|
+
inMetadata = false;
|
|
33
|
+
}
|
|
34
|
+
const colonIndex = line.indexOf(':');
|
|
35
|
+
if (colonIndex > 0) {
|
|
36
|
+
const key = line.slice(0, colonIndex).trim();
|
|
37
|
+
let value = line.slice(colonIndex + 1).trim();
|
|
38
|
+
// Remove surrounding quotes if present
|
|
39
|
+
if ((value.startsWith('"') && value.endsWith('"')) ||
|
|
40
|
+
(value.startsWith("'") && value.endsWith("'"))) {
|
|
41
|
+
value = value.slice(1, -1);
|
|
42
|
+
}
|
|
43
|
+
if (inMetadata) {
|
|
44
|
+
// Nested under metadata
|
|
45
|
+
metadata[key] = value;
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
// Top-level fields
|
|
49
|
+
switch (key) {
|
|
50
|
+
case 'name':
|
|
51
|
+
name = value;
|
|
52
|
+
break;
|
|
53
|
+
case 'description':
|
|
54
|
+
description = value;
|
|
55
|
+
break;
|
|
56
|
+
case 'license':
|
|
57
|
+
license = value;
|
|
58
|
+
break;
|
|
59
|
+
case 'compatibility':
|
|
60
|
+
compatibility = value;
|
|
61
|
+
break;
|
|
62
|
+
case 'allowed-tools':
|
|
63
|
+
allowedTools = value;
|
|
64
|
+
break;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
// name and description are required
|
|
70
|
+
if (!name || !description) {
|
|
71
|
+
return null;
|
|
72
|
+
}
|
|
73
|
+
return {
|
|
74
|
+
name,
|
|
75
|
+
description,
|
|
76
|
+
license,
|
|
77
|
+
compatibility,
|
|
78
|
+
metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
|
|
79
|
+
allowedTools
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Check if a directory is a valid skill.
|
|
84
|
+
* A valid skill must contain a SKILL.md with required frontmatter (name, description).
|
|
85
|
+
*/
|
|
86
|
+
export async function isValidSkillDirectory(dirPath) {
|
|
87
|
+
const skillMdPath = path.join(dirPath, 'SKILL.md');
|
|
88
|
+
if (!await fs.pathExists(skillMdPath)) {
|
|
89
|
+
return false;
|
|
90
|
+
}
|
|
91
|
+
try {
|
|
92
|
+
const content = await fs.readFile(skillMdPath, 'utf-8');
|
|
93
|
+
const metadata = parseFrontmatter(content);
|
|
94
|
+
return metadata !== null;
|
|
95
|
+
}
|
|
96
|
+
catch {
|
|
97
|
+
return false;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Find skill directories within a given path.
|
|
102
|
+
* Only checks the path itself and its direct children.
|
|
103
|
+
* A skill is any directory containing a valid SKILL.md file (with name + description).
|
|
104
|
+
*/
|
|
105
|
+
export async function findSkillDirectories(searchPath) {
|
|
106
|
+
const skills = [];
|
|
107
|
+
// Check if the path itself is a skill
|
|
108
|
+
if (await isValidSkillDirectory(searchPath)) {
|
|
109
|
+
skills.push(searchPath);
|
|
110
|
+
return skills;
|
|
111
|
+
}
|
|
112
|
+
// Check direct children only
|
|
113
|
+
try {
|
|
114
|
+
const entries = await fs.readdir(searchPath, { withFileTypes: true });
|
|
115
|
+
for (const entry of entries) {
|
|
116
|
+
if (entry.isDirectory()) {
|
|
117
|
+
const childPath = path.join(searchPath, entry.name);
|
|
118
|
+
if (await isValidSkillDirectory(childPath)) {
|
|
119
|
+
skills.push(childPath);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
// Permission denied or other error, skip
|
|
126
|
+
}
|
|
127
|
+
return skills;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Read skill metadata from SKILL.md frontmatter.
|
|
131
|
+
* The canonical skill name comes from the frontmatter, not the folder name.
|
|
132
|
+
*/
|
|
133
|
+
export async function readSkillMetadata(skillPath) {
|
|
134
|
+
const skillMdPath = path.join(skillPath, 'SKILL.md');
|
|
135
|
+
try {
|
|
136
|
+
const content = await fs.readFile(skillMdPath, 'utf-8');
|
|
137
|
+
return parseFrontmatter(content);
|
|
138
|
+
}
|
|
139
|
+
catch {
|
|
140
|
+
return null;
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Get the canonical skill name from SKILL.md frontmatter.
|
|
145
|
+
* Returns null if not a valid skill.
|
|
146
|
+
*/
|
|
147
|
+
export async function getSkillName(skillPath) {
|
|
148
|
+
const metadata = await readSkillMetadata(skillPath);
|
|
149
|
+
return metadata?.name || null;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Find all installations of a skill by name across all agents.
|
|
153
|
+
*/
|
|
154
|
+
export async function findSkillInstallations(skillName) {
|
|
155
|
+
const installations = [];
|
|
156
|
+
// Check both local and global for each agent
|
|
157
|
+
const locations = [
|
|
158
|
+
{ base: process.cwd(), isGlobal: false },
|
|
159
|
+
{ base: os.homedir(), isGlobal: true }
|
|
160
|
+
];
|
|
161
|
+
for (const { base, isGlobal } of locations) {
|
|
162
|
+
for (const agent of SUPPORTED_AGENTS) {
|
|
163
|
+
const skillPath = path.join(base, agent.folderName, 'skills', skillName);
|
|
164
|
+
if (await fs.pathExists(skillPath)) {
|
|
165
|
+
const metadata = await readSkillMetadata(skillPath);
|
|
166
|
+
if (metadata) {
|
|
167
|
+
const contentHash = await computeContentHash(skillPath);
|
|
168
|
+
installations.push({
|
|
169
|
+
agent: agent.flag,
|
|
170
|
+
path: skillPath,
|
|
171
|
+
isGlobal,
|
|
172
|
+
metadata,
|
|
173
|
+
contentHash
|
|
174
|
+
});
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
return installations;
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* List all installed skills for a specific agent.
|
|
183
|
+
*/
|
|
184
|
+
export async function listSkillsForAgent(agentFolderName, isGlobal) {
|
|
185
|
+
const base = isGlobal ? os.homedir() : process.cwd();
|
|
186
|
+
const skillsDir = path.join(base, agentFolderName, 'skills');
|
|
187
|
+
if (!await fs.pathExists(skillsDir)) {
|
|
188
|
+
return [];
|
|
189
|
+
}
|
|
190
|
+
const entries = await fs.readdir(skillsDir, { withFileTypes: true });
|
|
191
|
+
const skills = [];
|
|
192
|
+
for (const entry of entries) {
|
|
193
|
+
if (entry.isDirectory()) {
|
|
194
|
+
const skillPath = path.join(skillsDir, entry.name);
|
|
195
|
+
const skillName = await getSkillName(skillPath);
|
|
196
|
+
if (skillName) {
|
|
197
|
+
skills.push(skillName);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
return skills;
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* Check if a skill exists in an agent's folder.
|
|
205
|
+
*/
|
|
206
|
+
export async function skillExists(skillName, agentFolderName, isGlobal) {
|
|
207
|
+
const base = isGlobal ? os.homedir() : process.cwd();
|
|
208
|
+
const skillPath = path.join(base, agentFolderName, 'skills', skillName);
|
|
209
|
+
return (await fs.pathExists(skillPath)) && (await isValidSkillDirectory(skillPath));
|
|
210
|
+
}
|
|
211
|
+
//# sourceMappingURL=skill-info.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill-info.js","sourceRoot":"","sources":["../../src/core/skill-info.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { AgentType, SkillSource } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Install skill(s) from a local path.
|
|
4
|
+
* Checks if path is a skill, otherwise checks direct children for SKILL.md.
|
|
5
|
+
*/
|
|
6
|
+
export declare function installFromLocal(source: SkillSource, agentFlag: AgentType, isGlobal: boolean): Promise<string[]>;
|
|
7
|
+
/**
|
|
8
|
+
* Install skill(s) from GitHub using degit.
|
|
9
|
+
* After downloading, checks if it's a skill or searches direct children for SKILL.md.
|
|
10
|
+
*/
|
|
11
|
+
export declare function installFromGithub(source: SkillSource, agentFlag: AgentType, isGlobal: boolean): Promise<string[]>;
|
|
12
|
+
/**
|
|
13
|
+
* Install skill(s) from any source to an agent.
|
|
14
|
+
* Returns list of installed skill names.
|
|
15
|
+
*/
|
|
16
|
+
export declare function installSkill(skillInput: string, agentFlag: AgentType, isGlobal: boolean): Promise<{
|
|
17
|
+
skillNames: string[];
|
|
18
|
+
source: SkillSource;
|
|
19
|
+
}>;
|
|
20
|
+
/**
|
|
21
|
+
* Remove a skill from an agent.
|
|
22
|
+
*/
|
|
23
|
+
export declare function removeSkill(skillName: string, agentFlag: AgentType, isGlobal: boolean): Promise<boolean>;
|
|
24
|
+
//# sourceMappingURL=skill-install.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import fs from 'fs-extra';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import os from 'os';
|
|
4
|
+
import { execSync } from 'child_process';
|
|
5
|
+
import { getAgentByFlag } from './agents.js';
|
|
6
|
+
import { resolveSkillSource } from './skill-source.js';
|
|
7
|
+
import { findSkillDirectories, readSkillMetadata } from './skill-info.js';
|
|
8
|
+
/**
|
|
9
|
+
* Get the destination path for installing a skill.
|
|
10
|
+
* Skill name comes from SKILL.md frontmatter.
|
|
11
|
+
*/
|
|
12
|
+
function getSkillDestination(skillName, agentFlag, isGlobal) {
|
|
13
|
+
const agent = getAgentByFlag(agentFlag);
|
|
14
|
+
if (!agent) {
|
|
15
|
+
throw new Error(`Unknown agent: ${agentFlag}`);
|
|
16
|
+
}
|
|
17
|
+
const base = isGlobal ? os.homedir() : process.cwd();
|
|
18
|
+
return path.join(base, agent.folderName, 'skills', skillName);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Install a single skill directory to an agent.
|
|
22
|
+
* The skill name is taken from SKILL.md frontmatter (not the folder name).
|
|
23
|
+
* The destination folder will be named after the frontmatter name.
|
|
24
|
+
*/
|
|
25
|
+
async function installSkillDirectory(skillDir, agentFlag, isGlobal) {
|
|
26
|
+
// Get metadata from SKILL.md frontmatter (name and description are required)
|
|
27
|
+
const metadata = await readSkillMetadata(skillDir);
|
|
28
|
+
if (!metadata) {
|
|
29
|
+
throw new Error(`Invalid skill at "${skillDir}": SKILL.md must have name and description in frontmatter`);
|
|
30
|
+
}
|
|
31
|
+
const dest = getSkillDestination(metadata.name, agentFlag, isGlobal);
|
|
32
|
+
// Ensure parent directory exists
|
|
33
|
+
await fs.ensureDir(path.dirname(dest));
|
|
34
|
+
// Copy the skill folder (folder will be renamed to match frontmatter name)
|
|
35
|
+
await fs.copy(skillDir, dest, { overwrite: true });
|
|
36
|
+
return metadata.name;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Install skill(s) from a local path.
|
|
40
|
+
* Checks if path is a skill, otherwise checks direct children for SKILL.md.
|
|
41
|
+
*/
|
|
42
|
+
export async function installFromLocal(source, agentFlag, isGlobal) {
|
|
43
|
+
const skillDirs = await findSkillDirectories(source.location);
|
|
44
|
+
if (skillDirs.length === 0) {
|
|
45
|
+
throw new Error(`No skills found in "${source.location}". A skill must contain a SKILL.md file.`);
|
|
46
|
+
}
|
|
47
|
+
const installedSkills = [];
|
|
48
|
+
for (const skillDir of skillDirs) {
|
|
49
|
+
const skillName = await installSkillDirectory(skillDir, agentFlag, isGlobal);
|
|
50
|
+
installedSkills.push(skillName);
|
|
51
|
+
}
|
|
52
|
+
return installedSkills;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Install skill(s) from GitHub using degit.
|
|
56
|
+
* After downloading, checks if it's a skill or searches direct children for SKILL.md.
|
|
57
|
+
*/
|
|
58
|
+
export async function installFromGithub(source, agentFlag, isGlobal) {
|
|
59
|
+
// Create a temp directory to download to
|
|
60
|
+
const tempDir = path.join(os.tmpdir(), `sun-install-${Date.now()}`);
|
|
61
|
+
try {
|
|
62
|
+
// Download using degit
|
|
63
|
+
await fs.ensureDir(tempDir);
|
|
64
|
+
try {
|
|
65
|
+
execSync(`npx degit ${source.location} "${tempDir}"`, {
|
|
66
|
+
stdio: 'pipe'
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
catch (error) {
|
|
70
|
+
const err = error;
|
|
71
|
+
const stderr = err.stderr?.toString() || err.message;
|
|
72
|
+
throw new Error(`Failed to download from GitHub: ${stderr}`);
|
|
73
|
+
}
|
|
74
|
+
// Find skills in downloaded content (checks itself and direct children)
|
|
75
|
+
const skillDirs = await findSkillDirectories(tempDir);
|
|
76
|
+
if (skillDirs.length === 0) {
|
|
77
|
+
throw new Error(`No skills found in "${source.originalInput}". A skill must contain a SKILL.md file.`);
|
|
78
|
+
}
|
|
79
|
+
// Install each skill found (name comes from SKILL.md frontmatter)
|
|
80
|
+
const installedSkills = [];
|
|
81
|
+
for (const skillDir of skillDirs) {
|
|
82
|
+
const skillName = await installSkillDirectory(skillDir, agentFlag, isGlobal);
|
|
83
|
+
installedSkills.push(skillName);
|
|
84
|
+
}
|
|
85
|
+
return installedSkills;
|
|
86
|
+
}
|
|
87
|
+
finally {
|
|
88
|
+
// Clean up temp directory
|
|
89
|
+
await fs.remove(tempDir).catch(() => { });
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Install skill(s) from any source to an agent.
|
|
94
|
+
* Returns list of installed skill names.
|
|
95
|
+
*/
|
|
96
|
+
export async function installSkill(skillInput, agentFlag, isGlobal) {
|
|
97
|
+
const source = resolveSkillSource(skillInput);
|
|
98
|
+
let skillNames;
|
|
99
|
+
switch (source.type) {
|
|
100
|
+
case 'local':
|
|
101
|
+
skillNames = await installFromLocal(source, agentFlag, isGlobal);
|
|
102
|
+
break;
|
|
103
|
+
case 'github':
|
|
104
|
+
case 'shortcut':
|
|
105
|
+
skillNames = await installFromGithub(source, agentFlag, isGlobal);
|
|
106
|
+
break;
|
|
107
|
+
default:
|
|
108
|
+
throw new Error(`Unknown source type: ${source.type}`);
|
|
109
|
+
}
|
|
110
|
+
return { skillNames, source };
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Remove a skill from an agent.
|
|
114
|
+
*/
|
|
115
|
+
export async function removeSkill(skillName, agentFlag, isGlobal) {
|
|
116
|
+
const dest = getSkillDestination(skillName, agentFlag, isGlobal);
|
|
117
|
+
if (await fs.pathExists(dest)) {
|
|
118
|
+
await fs.remove(dest);
|
|
119
|
+
return true;
|
|
120
|
+
}
|
|
121
|
+
return false;
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=skill-install.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill-install.js","sourceRoot":"","sources":["../../src/core/skill-install.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { SkillSource } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Check if input looks like a GitHub URL or reference.
|
|
4
|
+
* Matches: github.com/user/repo, https://github.com/..., etc.
|
|
5
|
+
*/
|
|
6
|
+
export declare function isGithubUrl(input: string): boolean;
|
|
7
|
+
/**
|
|
8
|
+
* Check if input looks like a local file path.
|
|
9
|
+
* Matches: ./path, ../path, ~/path, /absolute/path
|
|
10
|
+
*/
|
|
11
|
+
export declare function isLocalPath(input: string): boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Resolve a skill input to its source type and location.
|
|
14
|
+
*
|
|
15
|
+
* Resolution order:
|
|
16
|
+
* 1. Check if it's a registered shortcut (e.g., "tinker")
|
|
17
|
+
* 2. Check if it contains "github.com" (treat as GitHub URL)
|
|
18
|
+
* 3. Check if it's a valid local path
|
|
19
|
+
* 4. Otherwise, throw error
|
|
20
|
+
*/
|
|
21
|
+
export declare function resolveSkillSource(input: string): SkillSource;
|
|
22
|
+
/**
|
|
23
|
+
* Extract skill name from a source.
|
|
24
|
+
* For GitHub: last path segment
|
|
25
|
+
* For local: folder name
|
|
26
|
+
* For shortcut: the shortcut name itself
|
|
27
|
+
*/
|
|
28
|
+
export declare function getSkillNameFromSource(source: SkillSource): string;
|
|
29
|
+
//# sourceMappingURL=skill-source.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuD7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAclE"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import fs from 'fs-extra';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { isShortcut, getShortcutUrl } from '../utils/registry.js';
|
|
4
|
+
/**
|
|
5
|
+
* Check if input looks like a GitHub URL or reference.
|
|
6
|
+
* Matches: github.com/user/repo, https://github.com/..., etc.
|
|
7
|
+
*/
|
|
8
|
+
export function isGithubUrl(input) {
|
|
9
|
+
return input.includes('github.com');
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Check if input looks like a local file path.
|
|
13
|
+
* Matches: ./path, ../path, ~/path, /absolute/path
|
|
14
|
+
*/
|
|
15
|
+
export function isLocalPath(input) {
|
|
16
|
+
// Check if it starts with path indicators
|
|
17
|
+
if (input.startsWith('./') ||
|
|
18
|
+
input.startsWith('../') ||
|
|
19
|
+
input.startsWith('~/') ||
|
|
20
|
+
input.startsWith('/')) {
|
|
21
|
+
return true;
|
|
22
|
+
}
|
|
23
|
+
// Check if it's an existing path on disk
|
|
24
|
+
const resolved = path.resolve(input);
|
|
25
|
+
return fs.pathExistsSync(resolved);
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Resolve a skill input to its source type and location.
|
|
29
|
+
*
|
|
30
|
+
* Resolution order:
|
|
31
|
+
* 1. Check if it's a registered shortcut (e.g., "tinker")
|
|
32
|
+
* 2. Check if it contains "github.com" (treat as GitHub URL)
|
|
33
|
+
* 3. Check if it's a valid local path
|
|
34
|
+
* 4. Otherwise, throw error
|
|
35
|
+
*/
|
|
36
|
+
export function resolveSkillSource(input) {
|
|
37
|
+
// 1. Check shortcuts first
|
|
38
|
+
if (isShortcut(input)) {
|
|
39
|
+
const url = getShortcutUrl(input);
|
|
40
|
+
return {
|
|
41
|
+
type: 'shortcut',
|
|
42
|
+
location: url,
|
|
43
|
+
originalInput: input
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
// 2. Check if it's a GitHub URL
|
|
47
|
+
if (isGithubUrl(input)) {
|
|
48
|
+
// Normalize the URL for degit
|
|
49
|
+
let location = input;
|
|
50
|
+
// Remove https:// or http:// prefix if present
|
|
51
|
+
location = location.replace(/^https?:\/\//, '');
|
|
52
|
+
// Handle github.com/user/repo/tree/branch/path format
|
|
53
|
+
// Convert to degit format: user/repo/path#branch
|
|
54
|
+
const treeMatch = location.match(/^github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)$/);
|
|
55
|
+
if (treeMatch) {
|
|
56
|
+
const [, user, repo, branch, subpath] = treeMatch;
|
|
57
|
+
location = `${user}/${repo}/${subpath}#${branch}`;
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
// Simple format: github.com/user/repo -> user/repo
|
|
61
|
+
location = location.replace(/^github\.com\//, '');
|
|
62
|
+
}
|
|
63
|
+
return {
|
|
64
|
+
type: 'github',
|
|
65
|
+
location,
|
|
66
|
+
originalInput: input
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
// 3. Check if it's a local path
|
|
70
|
+
if (isLocalPath(input)) {
|
|
71
|
+
// Resolve to absolute path, handling ~
|
|
72
|
+
let location = input;
|
|
73
|
+
if (location.startsWith('~/')) {
|
|
74
|
+
location = path.join(process.env.HOME || '', location.slice(2));
|
|
75
|
+
}
|
|
76
|
+
location = path.resolve(location);
|
|
77
|
+
return {
|
|
78
|
+
type: 'local',
|
|
79
|
+
location,
|
|
80
|
+
originalInput: input
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
// 4. Not found
|
|
84
|
+
throw new Error(`Skill not found: "${input}". Expected a shortcut name, GitHub URL, or local path.`);
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Extract skill name from a source.
|
|
88
|
+
* For GitHub: last path segment
|
|
89
|
+
* For local: folder name
|
|
90
|
+
* For shortcut: the shortcut name itself
|
|
91
|
+
*/
|
|
92
|
+
export function getSkillNameFromSource(source) {
|
|
93
|
+
if (source.type === 'shortcut') {
|
|
94
|
+
return source.originalInput;
|
|
95
|
+
}
|
|
96
|
+
if (source.type === 'local') {
|
|
97
|
+
return path.basename(source.location);
|
|
98
|
+
}
|
|
99
|
+
// GitHub: extract from path (e.g., "user/repo/skills/tinker#main" -> "tinker")
|
|
100
|
+
const parts = source.location.split('/');
|
|
101
|
+
const lastPart = parts[parts.length - 1];
|
|
102
|
+
// Remove branch suffix if present (e.g., "tinker#main" -> "tinker")
|
|
103
|
+
return lastPart.split('#')[0];
|
|
104
|
+
}
|
|
105
|
+
//# sourceMappingURL=skill-source.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skill-source.js","sourceRoot":"","sources":["../../src/core/skill-source.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
|