@skillhouse/cli 0.1.1 → 0.3.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.
Files changed (73) hide show
  1. package/dist/cli.js +56 -2
  2. package/dist/cli.js.map +1 -1
  3. package/dist/commands/check.d.ts +6 -0
  4. package/dist/commands/check.d.ts.map +1 -0
  5. package/dist/commands/check.js +61 -0
  6. package/dist/commands/check.js.map +1 -0
  7. package/dist/commands/index.d.ts +3 -0
  8. package/dist/commands/index.d.ts.map +1 -1
  9. package/dist/commands/index.js +3 -0
  10. package/dist/commands/index.js.map +1 -1
  11. package/dist/commands/install.d.ts +3 -0
  12. package/dist/commands/install.d.ts.map +1 -1
  13. package/dist/commands/install.js +62 -3
  14. package/dist/commands/install.js.map +1 -1
  15. package/dist/commands/publish.d.ts +7 -0
  16. package/dist/commands/publish.d.ts.map +1 -0
  17. package/dist/commands/publish.js +74 -0
  18. package/dist/commands/publish.js.map +1 -0
  19. package/dist/commands/uninstall.d.ts +11 -0
  20. package/dist/commands/uninstall.d.ts.map +1 -0
  21. package/dist/commands/uninstall.js +111 -0
  22. package/dist/commands/uninstall.js.map +1 -0
  23. package/dist/commands/updates.d.ts +2 -0
  24. package/dist/commands/updates.d.ts.map +1 -1
  25. package/dist/commands/updates.js +19 -6
  26. package/dist/commands/updates.js.map +1 -1
  27. package/dist/index.d.ts +2 -0
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +2 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/lib/api.d.ts +26 -0
  32. package/dist/lib/api.d.ts.map +1 -1
  33. package/dist/lib/api.js +55 -0
  34. package/dist/lib/api.js.map +1 -1
  35. package/dist/lib/config.d.ts +4 -1
  36. package/dist/lib/config.d.ts.map +1 -1
  37. package/dist/lib/config.js +17 -0
  38. package/dist/lib/config.js.map +1 -1
  39. package/dist/lib/package.d.ts +12 -0
  40. package/dist/lib/package.d.ts.map +1 -0
  41. package/dist/lib/package.js +165 -0
  42. package/dist/lib/package.js.map +1 -0
  43. package/dist/lib/skill-checks/engine.d.ts +10 -0
  44. package/dist/lib/skill-checks/engine.d.ts.map +1 -0
  45. package/dist/lib/skill-checks/engine.js +322 -0
  46. package/dist/lib/skill-checks/engine.js.map +1 -0
  47. package/dist/lib/skill-checks/executables.d.ts +10 -0
  48. package/dist/lib/skill-checks/executables.d.ts.map +1 -0
  49. package/dist/lib/skill-checks/executables.js +35 -0
  50. package/dist/lib/skill-checks/executables.js.map +1 -0
  51. package/dist/lib/skill-checks/index.d.ts +5 -0
  52. package/dist/lib/skill-checks/index.d.ts.map +1 -0
  53. package/dist/lib/skill-checks/index.js +5 -0
  54. package/dist/lib/skill-checks/index.js.map +1 -0
  55. package/dist/lib/skill-checks/types.d.ts +53 -0
  56. package/dist/lib/skill-checks/types.d.ts.map +1 -0
  57. package/dist/lib/skill-checks/types.js +18 -0
  58. package/dist/lib/skill-checks/types.js.map +1 -0
  59. package/dist/lib/skill-checks/verdict.d.ts +9 -0
  60. package/dist/lib/skill-checks/verdict.d.ts.map +1 -0
  61. package/dist/lib/skill-checks/verdict.js +14 -0
  62. package/dist/lib/skill-checks/verdict.js.map +1 -0
  63. package/dist/lib/unpack.d.ts +10 -1
  64. package/dist/lib/unpack.d.ts.map +1 -1
  65. package/dist/lib/unpack.js +58 -16
  66. package/dist/lib/unpack.js.map +1 -1
  67. package/dist/lib/version-check.d.ts +10 -0
  68. package/dist/lib/version-check.d.ts.map +1 -0
  69. package/dist/lib/version-check.js +87 -0
  70. package/dist/lib/version-check.js.map +1 -0
  71. package/dist/types.d.ts +14 -0
  72. package/dist/types.d.ts.map +1 -1
  73. package/package.json +9 -1
@@ -0,0 +1,322 @@
1
+ import { FINDING_CODES, } from './types.js';
2
+ import { verdictFromFindings } from './verdict.js';
3
+ export const RULE_SET_VERSION = '2026-11-13.1';
4
+ const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
5
+ const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
6
+ const MAX_TOTAL_UNCOMPRESSED_BYTES = 10 * 1024 * 1024; // 10MB (blocks)
7
+ const WARN_TOTAL_UNCOMPRESSED_BYTES = 2 * 1024 * 1024; // 2MB (warns, passes)
8
+ const MAX_SINGLE_FILE_BYTES = 5 * 1024 * 1024; // 5MB (blocks)
9
+ const MAX_PACKAGE_FILES = 500; // 500 files (blocks)
10
+ const BINARY_EXTENSIONS = new Set([
11
+ '.png',
12
+ '.jpg',
13
+ '.jpeg',
14
+ '.gif',
15
+ '.webp',
16
+ '.ico',
17
+ '.bmp',
18
+ '.tiff',
19
+ '.zip',
20
+ '.tar',
21
+ '.gz',
22
+ '.tgz',
23
+ '.bz2',
24
+ '.7z',
25
+ '.wasm',
26
+ '.bin',
27
+ '.pdf',
28
+ '.mp3',
29
+ '.mp4',
30
+ '.mov',
31
+ '.avi',
32
+ '.woff',
33
+ '.woff2',
34
+ '.ttf',
35
+ '.eot',
36
+ ]);
37
+ function isBinaryFile(file) {
38
+ const lastDot = file.path.lastIndexOf('.');
39
+ if (lastDot !== -1) {
40
+ const ext = file.path.slice(lastDot).toLowerCase();
41
+ if (BINARY_EXTENSIONS.has(ext))
42
+ return true;
43
+ }
44
+ const checkLen = Math.min(file.content.length, 8192);
45
+ for (let i = 0; i < checkLen; i++) {
46
+ if (file.content[i] === 0)
47
+ return true;
48
+ }
49
+ return false;
50
+ }
51
+ function isInvalidPath(path) {
52
+ if (typeof path !== 'string' || path.trim().length === 0)
53
+ return true;
54
+ if (path.includes('\0'))
55
+ return true;
56
+ if (/^[\\/]/.test(path))
57
+ return true;
58
+ if (/^[a-zA-Z]:/.test(path))
59
+ return true;
60
+ const segments = path.split(/[\\/]/);
61
+ if (segments.some((seg) => seg === '..' || seg === '.'))
62
+ return true;
63
+ return false;
64
+ }
65
+ const RM_DESTRUCTIVE_PATTERN = /\brm\s+(?:-[a-zA-Z0-9]+\s+)*(?:-[a-zA-Z]*r[a-zA-Z]*f[a-zA-Z]*|-[a-zA-Z]*f[a-zA-Z]*r[a-zA-Z]*)\s+(?:--\s+)?(?:\/|\/\w+|~|\*)/i;
66
+ const FORK_BOMB_PATTERN = /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:/;
67
+ const SHELL_PIPE_PATTERN = /\b(?:curl|wget)\b.*?\|\s*(?:sudo\s+)?(?:ba|z)?sh\b/i;
68
+ const DISK_DESTRUCTIVE_PATTERN = /\b(?:mkfs(?:\.[a-z0-9]+)?\b|dd\b.*?\bof=\/dev\/)/i;
69
+ const SSH_KEY_PATTERN = /(?:~|\/(?:root|home\/[^/\s]+))\/\.ssh\/id_[a-zA-Z0-9_-]+/i;
70
+ const CLOUD_CRED_PATTERN = /(?:~|\/(?:root|home\/[^/\s]+))\/\.(?:aws\/credentials|config\/gcloud|kube\/config)\b/i;
71
+ const ENV_EXFIL_PATTERN = /\b(?:curl|wget)\b.*?(?:-d|--data(?:-binary|-raw)?)\s+@\.env(?:\.[a-zA-Z0-9_-]+)?\b/i;
72
+ const HIDDEN_TEXT_PATTERN = /[\u200B-\u200D\uFEFF\u202A-\u202E\u2066-\u2069]|[\u{E0001}-\u{E007F}]/u;
73
+ const AGENT_OVERRIDE_PATTERNS = [
74
+ /\bignore\s+(?:all\s+)?(?:previous|prior|above)\s+instructions\b/i,
75
+ /\bdisregard\s+(?:all\s+)?(?:previous|prior|above)\s+(?:instructions|directives)\b/i,
76
+ /\byou\s+are\s+now\s+in\s+developer\s+mode\b/i,
77
+ /\bdeveloper\s+mode\s+and\s+have\s+no\s+restrictions\b/i,
78
+ /\bbypass\s+(?:all\s+)?(?:safety|security)\s+(?:guidelines|rules|filters|checks|restrictions)\b/i,
79
+ /\bsystem\s+prompt\s+override\b/i,
80
+ ];
81
+ /**
82
+ * Pure quality and safety checker for skill packages.
83
+ * Runs locally before upload to provide immediate creator feedback.
84
+ */
85
+ export class DefaultSkillChecker {
86
+ async check(pkg) {
87
+ const findings = [];
88
+ if (!pkg || typeof pkg !== 'object') {
89
+ findings.push({
90
+ code: FINDING_CODES.MANIFEST_INVALID,
91
+ category: 'quality',
92
+ severity: 'high',
93
+ message: 'Invalid package: package payload is missing or empty.',
94
+ });
95
+ return {
96
+ verdict: 'block',
97
+ findings,
98
+ ruleSetVersion: RULE_SET_VERSION,
99
+ };
100
+ }
101
+ const manifest = pkg.manifest || {};
102
+ const files = Array.isArray(pkg.files) ? pkg.files : [];
103
+ // --- Quality Check: Manifest validation ---
104
+ if (!manifest.id ||
105
+ typeof manifest.id !== 'string' ||
106
+ manifest.id.length < 2 ||
107
+ manifest.id.length > 100 ||
108
+ !SLUG_REGEX.test(manifest.id)) {
109
+ findings.push({
110
+ code: FINDING_CODES.MANIFEST_INVALID,
111
+ category: 'quality',
112
+ severity: 'high',
113
+ message: 'Skill id must be a lowercase slug between 2 and 100 characters (e.g. "my-skill").',
114
+ });
115
+ }
116
+ if (!manifest.title ||
117
+ typeof manifest.title !== 'string' ||
118
+ manifest.title.trim().length === 0 ||
119
+ manifest.title.length > 100) {
120
+ findings.push({
121
+ code: FINDING_CODES.MANIFEST_INVALID,
122
+ category: 'quality',
123
+ severity: 'high',
124
+ message: 'Skill title must be between 1 and 100 characters.',
125
+ });
126
+ }
127
+ if (!manifest.summary ||
128
+ typeof manifest.summary !== 'string' ||
129
+ manifest.summary.trim().length === 0 ||
130
+ manifest.summary.length > 300) {
131
+ findings.push({
132
+ code: FINDING_CODES.MANIFEST_INVALID,
133
+ category: 'quality',
134
+ severity: 'high',
135
+ message: 'Skill summary must be between 1 and 300 characters.',
136
+ });
137
+ }
138
+ if (!manifest.category ||
139
+ typeof manifest.category !== 'string' ||
140
+ manifest.category.trim().length === 0 ||
141
+ manifest.category.length > 50) {
142
+ findings.push({
143
+ code: FINDING_CODES.MANIFEST_INVALID,
144
+ category: 'quality',
145
+ severity: 'high',
146
+ message: 'Skill category must be between 1 and 50 characters.',
147
+ });
148
+ }
149
+ if (!manifest.version ||
150
+ typeof manifest.version !== 'string' ||
151
+ !SEMVER_REGEX.test(manifest.version)) {
152
+ findings.push({
153
+ code: FINDING_CODES.MANIFEST_INVALID,
154
+ category: 'quality',
155
+ severity: 'high',
156
+ message: 'Skill version must be valid semver (e.g. "1.0.0").',
157
+ });
158
+ }
159
+ if (!Array.isArray(manifest.agents) ||
160
+ manifest.agents.length === 0 ||
161
+ manifest.agents.some((a) => typeof a !== 'string' || a.trim().length === 0 || a.length > 50)) {
162
+ findings.push({
163
+ code: FINDING_CODES.MANIFEST_INVALID,
164
+ category: 'quality',
165
+ severity: 'high',
166
+ message: 'Skill agents must contain at least one valid agent name (max 50 chars each).',
167
+ });
168
+ }
169
+ if (manifest.access !== 'free' && manifest.access !== 'premium') {
170
+ findings.push({
171
+ code: FINDING_CODES.MANIFEST_INVALID,
172
+ category: 'quality',
173
+ severity: 'high',
174
+ message: 'Skill access tier must be "free" or "premium".',
175
+ });
176
+ }
177
+ // --- Quality Check: File Paths & Counts ---
178
+ let totalUncompressedBytes = 0;
179
+ let hasSkillMd = false;
180
+ let skillMdEmpty = true;
181
+ if (files.length > MAX_PACKAGE_FILES) {
182
+ findings.push({
183
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
184
+ category: 'quality',
185
+ severity: 'high',
186
+ message: `Package contains ${files.length} files (maximum allowed is ${MAX_PACKAGE_FILES}).`,
187
+ });
188
+ }
189
+ for (const file of files) {
190
+ if (isInvalidPath(file.path)) {
191
+ findings.push({
192
+ code: FINDING_CODES.MANIFEST_INVALID,
193
+ category: 'quality',
194
+ severity: 'high',
195
+ message: 'Package file path is invalid or unsafe.',
196
+ file: file.path,
197
+ });
198
+ }
199
+ const fileLen = file.content ? file.content.length : 0;
200
+ totalUncompressedBytes += fileLen;
201
+ if (fileLen > MAX_SINGLE_FILE_BYTES) {
202
+ findings.push({
203
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
204
+ category: 'quality',
205
+ severity: 'high',
206
+ message: 'File exceeds maximum single file size limit of 5MB.',
207
+ file: file.path,
208
+ });
209
+ }
210
+ if (file.path === 'SKILL.md') {
211
+ hasSkillMd = true;
212
+ if (file.content && file.content.toString('utf-8').trim().length > 0) {
213
+ skillMdEmpty = false;
214
+ }
215
+ }
216
+ }
217
+ if (!hasSkillMd) {
218
+ findings.push({
219
+ code: FINDING_CODES.REQUIRED_FILE_MISSING,
220
+ category: 'quality',
221
+ severity: 'high',
222
+ message: 'Required file SKILL.md is missing from the package.',
223
+ file: 'SKILL.md',
224
+ });
225
+ }
226
+ else if (skillMdEmpty) {
227
+ findings.push({
228
+ code: FINDING_CODES.REQUIRED_FILE_MISSING,
229
+ category: 'quality',
230
+ severity: 'high',
231
+ message: 'Required file SKILL.md is empty.',
232
+ file: 'SKILL.md',
233
+ });
234
+ }
235
+ if (totalUncompressedBytes > MAX_TOTAL_UNCOMPRESSED_BYTES) {
236
+ findings.push({
237
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
238
+ category: 'quality',
239
+ severity: 'high',
240
+ message: `Total package size (${totalUncompressedBytes} bytes) exceeds the 10MB limit.`,
241
+ });
242
+ }
243
+ else if (totalUncompressedBytes > WARN_TOTAL_UNCOMPRESSED_BYTES) {
244
+ findings.push({
245
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
246
+ category: 'quality',
247
+ severity: 'medium',
248
+ message: `Total package size (${totalUncompressedBytes} bytes) exceeds 2MB warning threshold.`,
249
+ });
250
+ }
251
+ // --- Safety Checks: Text files scanning ---
252
+ for (const file of files) {
253
+ if (isBinaryFile(file)) {
254
+ continue;
255
+ }
256
+ const text = file.content.toString('utf-8');
257
+ const lines = text.split(/\r?\n/);
258
+ for (let i = 0; i < lines.length; i++) {
259
+ const line = lines[i];
260
+ const lineNum = i + 1;
261
+ // 1. Dangerous system commands
262
+ if (RM_DESTRUCTIVE_PATTERN.test(line) ||
263
+ FORK_BOMB_PATTERN.test(line) ||
264
+ SHELL_PIPE_PATTERN.test(line) ||
265
+ DISK_DESTRUCTIVE_PATTERN.test(line)) {
266
+ findings.push({
267
+ code: FINDING_CODES.DANGEROUS_COMMAND,
268
+ category: 'safety',
269
+ severity: 'high',
270
+ message: 'Potentially dangerous system command detected.',
271
+ file: file.path,
272
+ line: lineNum,
273
+ });
274
+ }
275
+ // 2. Data exfiltration and credential reading
276
+ if (SSH_KEY_PATTERN.test(line) ||
277
+ CLOUD_CRED_PATTERN.test(line) ||
278
+ ENV_EXFIL_PATTERN.test(line)) {
279
+ findings.push({
280
+ code: FINDING_CODES.DATA_EXFILTRATION,
281
+ category: 'safety',
282
+ severity: 'high',
283
+ message: 'Potential credential access or secret exfiltration detected.',
284
+ file: file.path,
285
+ line: lineNum,
286
+ });
287
+ }
288
+ // 3. Hidden or invisible text
289
+ if (HIDDEN_TEXT_PATTERN.test(line)) {
290
+ findings.push({
291
+ code: FINDING_CODES.HIDDEN_TEXT,
292
+ category: 'safety',
293
+ severity: 'medium',
294
+ message: 'Hidden or zero-width characters detected.',
295
+ file: file.path,
296
+ line: lineNum,
297
+ });
298
+ }
299
+ // 4. Agent prompt overrides
300
+ for (const overridePattern of AGENT_OVERRIDE_PATTERNS) {
301
+ if (overridePattern.test(line)) {
302
+ findings.push({
303
+ code: FINDING_CODES.AGENT_OVERRIDE,
304
+ category: 'safety',
305
+ severity: 'medium',
306
+ message: 'Attempted agent instruction override detected.',
307
+ file: file.path,
308
+ line: lineNum,
309
+ });
310
+ break;
311
+ }
312
+ }
313
+ }
314
+ }
315
+ return {
316
+ verdict: verdictFromFindings(findings),
317
+ findings,
318
+ ruleSetVersion: RULE_SET_VERSION,
319
+ };
320
+ }
321
+ }
322
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { SkillPackageFile } from './types.js';
2
+ /**
3
+ * Files in a package that might run code on a person's machine. Fails closed: a file counts as plain only if
4
+ * its ending is a known plain-content type (or it is a well-known text file like LICENSE) AND its first bytes are
5
+ * not a program or a `#!` line AND it is not inside a scripts/ or bin/ folder at any depth. Everything else is
6
+ * reported, so renaming a script to `notes.txt`-style tricks or using an unknown ending does not hide it.
7
+ * This is a "heads up" so the terminal can ask first, not a verdict on whether the contents are harmful.
8
+ */
9
+ export declare function detectExecutables(files: SkillPackageFile[]): string[];
10
+ //# sourceMappingURL=executables.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executables.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/executables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsBnD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CASrE"}
@@ -0,0 +1,35 @@
1
+ /** File endings that are plain content: text, data and images an agent reads but nothing runs. */
2
+ const PLAIN_EXTENSIONS = new Set(['md', 'markdown', 'txt', 'json', 'yaml', 'yml', 'csv', 'png', 'jpg', 'jpeg', 'gif', 'webp', 'svg']);
3
+ /** Well-known files with no ending that are plain text. */
4
+ const PLAIN_NAMES = new Set(['license', 'licence', 'readme', 'notice', 'changelog']);
5
+ /** First bytes of programs: ELF, Mach-O (all variants, fat), Windows PE, WebAssembly. */
6
+ const MAGIC = [
7
+ [0x7f, 0x45, 0x4c, 0x46],
8
+ [0xfe, 0xed, 0xfa, 0xce],
9
+ [0xfe, 0xed, 0xfa, 0xcf],
10
+ [0xce, 0xfa, 0xed, 0xfe],
11
+ [0xcf, 0xfa, 0xed, 0xfe],
12
+ [0xca, 0xfe, 0xba, 0xbe],
13
+ [0x4d, 0x5a],
14
+ [0x00, 0x61, 0x73, 0x6d],
15
+ [0x23, 0x21], // "#!" script
16
+ ];
17
+ const startsWith = (b, sig) => b.length >= sig.length && sig.every((x, i) => b[i] === x);
18
+ /**
19
+ * Files in a package that might run code on a person's machine. Fails closed: a file counts as plain only if
20
+ * its ending is a known plain-content type (or it is a well-known text file like LICENSE) AND its first bytes are
21
+ * not a program or a `#!` line AND it is not inside a scripts/ or bin/ folder at any depth. Everything else is
22
+ * reported, so renaming a script to `notes.txt`-style tricks or using an unknown ending does not hide it.
23
+ * This is a "heads up" so the terminal can ask first, not a verdict on whether the contents are harmful.
24
+ */
25
+ export function detectExecutables(files) {
26
+ const found = files.filter((f) => {
27
+ const name = (f.path.split('/').pop() ?? '').toLowerCase();
28
+ const dot = name.lastIndexOf('.');
29
+ const plainName = dot > 0 ? PLAIN_EXTENSIONS.has(name.slice(dot + 1)) : PLAIN_NAMES.has(name);
30
+ const inScripts = /(^|\/)(scripts|bin)\//i.test(f.path);
31
+ return !plainName || inScripts || MAGIC.some((sig) => startsWith(f.content, sig));
32
+ });
33
+ return found.map((f) => f.path).sort();
34
+ }
35
+ //# sourceMappingURL=executables.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executables.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/executables.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACtI,2DAA2D;AAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAErF,yFAAyF;AACzF,MAAM,KAAK,GAAe;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,CAAC;IACZ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc;CAC7B,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAsB,EAAE,GAAa,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAExH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9F,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './types.js';
2
+ export * from './verdict.js';
3
+ export * from './engine.js';
4
+ export * from './executables.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './types.js';
2
+ export * from './verdict.js';
3
+ export * from './engine.js';
4
+ export * from './executables.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Skill checks: the shared seam between the `skillhouse` CLI and the API.
3
+ *
4
+ * Runs identically in the CLI (locally before upload) and on the API server.
5
+ */
6
+ export interface SkillPackageFile {
7
+ path: string;
8
+ content: Buffer;
9
+ }
10
+ export interface SkillManifest {
11
+ id: string;
12
+ title: string;
13
+ summary: string;
14
+ category: string;
15
+ version: string;
16
+ agents: string[];
17
+ access: 'free' | 'premium';
18
+ }
19
+ export interface SkillPackage {
20
+ manifest: SkillManifest;
21
+ files: SkillPackageFile[];
22
+ }
23
+ export type FindingCategory = 'quality' | 'safety';
24
+ export type FindingSeverity = 'low' | 'medium' | 'high';
25
+ export declare const FINDING_CODES: {
26
+ readonly MANIFEST_INVALID: "manifest_invalid";
27
+ readonly REQUIRED_FILE_MISSING: "required_file_missing";
28
+ readonly PACKAGE_TOO_LARGE: "package_too_large";
29
+ readonly VERSION_NOT_NEWER: "version_not_newer";
30
+ readonly DANGEROUS_COMMAND: "dangerous_command";
31
+ readonly DATA_EXFILTRATION: "data_exfiltration";
32
+ readonly HIDDEN_TEXT: "hidden_text";
33
+ readonly AGENT_OVERRIDE: "agent_override";
34
+ };
35
+ export type FindingCode = (typeof FINDING_CODES)[keyof typeof FINDING_CODES];
36
+ export interface Finding {
37
+ code: FindingCode;
38
+ category: FindingCategory;
39
+ severity: FindingSeverity;
40
+ message: string;
41
+ file?: string;
42
+ line?: number;
43
+ }
44
+ export type Verdict = 'pass' | 'review' | 'block';
45
+ export interface CheckReport {
46
+ verdict: Verdict;
47
+ findings: Finding[];
48
+ ruleSetVersion: string;
49
+ }
50
+ export interface SkillChecker {
51
+ check(pkg: SkillPackage): Promise<CheckReport>;
52
+ }
53
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;CAWhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChD"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Skill checks: the shared seam between the `skillhouse` CLI and the API.
3
+ *
4
+ * Runs identically in the CLI (locally before upload) and on the API server.
5
+ */
6
+ export const FINDING_CODES = {
7
+ // quality
8
+ MANIFEST_INVALID: 'manifest_invalid',
9
+ REQUIRED_FILE_MISSING: 'required_file_missing',
10
+ PACKAGE_TOO_LARGE: 'package_too_large',
11
+ VERSION_NOT_NEWER: 'version_not_newer',
12
+ // safety
13
+ DANGEROUS_COMMAND: 'dangerous_command',
14
+ DATA_EXFILTRATION: 'data_exfiltration',
15
+ HIDDEN_TEXT: 'hidden_text',
16
+ AGENT_OVERRIDE: 'agent_override',
17
+ };
18
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,UAAU;IACV,gBAAgB,EAAE,kBAAkB;IACpC,qBAAqB,EAAE,uBAAuB;IAC9C,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,SAAS;IACT,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;CACxB,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { Finding, Verdict } from './types.js';
2
+ /**
3
+ * Turns findings into a decision:
4
+ * - any `high` finding blocks the skill (quality or safety);
5
+ * - otherwise any `medium` safety finding sends it to a person for review;
6
+ * - everything else (including `medium` quality and any `low`) passes with findings as warnings.
7
+ */
8
+ export declare function verdictFromFindings(findings: readonly Finding[]): Verdict;
9
+ //# sourceMappingURL=verdict.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAIzE"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Turns findings into a decision:
3
+ * - any `high` finding blocks the skill (quality or safety);
4
+ * - otherwise any `medium` safety finding sends it to a person for review;
5
+ * - everything else (including `medium` quality and any `low`) passes with findings as warnings.
6
+ */
7
+ export function verdictFromFindings(findings) {
8
+ if (findings.some((f) => f.severity === 'high'))
9
+ return 'block';
10
+ if (findings.some((f) => f.severity === 'medium' && f.category === 'safety'))
11
+ return 'review';
12
+ return 'pass';
13
+ }
14
+ //# sourceMappingURL=verdict.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/verdict.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA4B;IAC9D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAChE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9F,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -1,6 +1,10 @@
1
1
  export declare class IntegrityError extends Error {
2
2
  constructor(message: string);
3
3
  }
4
+ export declare class ExecutableConsentRequiredError extends Error {
5
+ readonly executableFiles: string[];
6
+ constructor(files: string[]);
7
+ }
4
8
  /**
5
9
  * Calculates SHA-256 checksum for a given Buffer.
6
10
  */
@@ -14,8 +18,13 @@ export interface ExtractResult {
14
18
  targetDir: string;
15
19
  files: string[];
16
20
  }
21
+ export interface ExtractOptions {
22
+ allowExecutables?: boolean;
23
+ knownExecutables?: string[];
24
+ }
17
25
  /**
18
26
  * Extracts a zip archive buffer into the target destination directory.
27
+ * Refuses to write executable files unless allowExecutables is true.
19
28
  */
20
- export declare function extractZipArchive(buffer: Buffer, targetDir: string): ExtractResult;
29
+ export declare function extractZipArchive(buffer: Buffer, targetDir: string, options?: ExtractOptions): ExtractResult;
21
30
  //# sourceMappingURL=unpack.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"unpack.d.ts","sourceRoot":"","sources":["../../src/lib/unpack.ts"],"names":[],"mappings":"AAKA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAWhF;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAuClF"}
1
+ {"version":3,"file":"unpack.d.ts","sourceRoot":"","sources":["../../src/lib/unpack.ts"],"names":[],"mappings":"AAOA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;gBAEvB,KAAK,EAAE,MAAM,EAAE;CAS5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAWhF;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA+Ef"}