@backendkit-labs/agent-coding 0.29.0 → 0.31.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 (212) hide show
  1. package/README.md +20 -10
  2. package/dist/__tests__/cli-baseline.test.d.ts +2 -0
  3. package/dist/__tests__/cli-baseline.test.d.ts.map +1 -0
  4. package/dist/__tests__/cli-baseline.test.js +114 -0
  5. package/dist/__tests__/cli-baseline.test.js.map +1 -0
  6. package/dist/__tests__/createCodingEngine.forwarding.test.js +2 -1
  7. package/dist/__tests__/createCodingEngine.forwarding.test.js.map +1 -1
  8. package/dist/__tests__/createCodingEngine.learning.test.d.ts +2 -0
  9. package/dist/__tests__/createCodingEngine.learning.test.d.ts.map +1 -0
  10. package/dist/__tests__/createCodingEngine.learning.test.js +81 -0
  11. package/dist/__tests__/createCodingEngine.learning.test.js.map +1 -0
  12. package/dist/__tests__/workspace-trust.test.js +7 -5
  13. package/dist/__tests__/workspace-trust.test.js.map +1 -1
  14. package/dist/agents/AgentLoader.d.ts.map +1 -1
  15. package/dist/agents/AgentLoader.js +2 -1
  16. package/dist/agents/AgentLoader.js.map +1 -1
  17. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts +22 -0
  18. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts.map +1 -0
  19. package/dist/cli/agent-discovery/AgentPackageLoader.js +100 -0
  20. package/dist/cli/agent-discovery/AgentPackageLoader.js.map +1 -0
  21. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts +31 -0
  22. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts.map +1 -0
  23. package/dist/cli/agent-discovery/RemoteAgentRegistry.js +106 -0
  24. package/dist/cli/agent-discovery/RemoteAgentRegistry.js.map +1 -0
  25. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts +2 -0
  26. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts.map +1 -0
  27. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js +34 -0
  28. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js.map +1 -0
  29. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts +2 -0
  30. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts.map +1 -0
  31. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js +147 -0
  32. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js.map +1 -0
  33. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts +2 -0
  34. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts.map +1 -0
  35. package/dist/cli/agent-discovery/__tests__/download-guard.test.js +47 -0
  36. package/dist/cli/agent-discovery/__tests__/download-guard.test.js.map +1 -0
  37. package/dist/cli/agent-discovery/discoverAgents.d.ts +21 -0
  38. package/dist/cli/agent-discovery/discoverAgents.d.ts.map +1 -0
  39. package/dist/cli/agent-discovery/discoverAgents.js +74 -0
  40. package/dist/cli/agent-discovery/discoverAgents.js.map +1 -0
  41. package/dist/cli/agent-discovery/download-guard.d.ts +20 -0
  42. package/dist/cli/agent-discovery/download-guard.d.ts.map +1 -0
  43. package/dist/cli/agent-discovery/download-guard.js +84 -0
  44. package/dist/cli/agent-discovery/download-guard.js.map +1 -0
  45. package/dist/cli/agent-discovery/index.d.ts +5 -0
  46. package/dist/cli/agent-discovery/index.d.ts.map +1 -0
  47. package/dist/cli/agent-discovery/index.js +12 -0
  48. package/dist/cli/agent-discovery/index.js.map +1 -0
  49. package/dist/cli/agent-discovery/types.d.ts +48 -0
  50. package/dist/cli/agent-discovery/types.d.ts.map +1 -0
  51. package/dist/cli/agent-discovery/types.js +3 -0
  52. package/dist/cli/agent-discovery/types.js.map +1 -0
  53. package/dist/cli/bootstrap/GlobalSeed.d.ts +46 -0
  54. package/dist/cli/bootstrap/GlobalSeed.d.ts.map +1 -0
  55. package/dist/cli/bootstrap/GlobalSeed.js +285 -0
  56. package/dist/cli/bootstrap/GlobalSeed.js.map +1 -0
  57. package/dist/cli/bootstrap/config.d.ts +24 -0
  58. package/dist/cli/bootstrap/config.d.ts.map +1 -0
  59. package/dist/cli/bootstrap/config.js +71 -0
  60. package/dist/cli/bootstrap/config.js.map +1 -0
  61. package/dist/cli/checkpoint/index.d.ts +17 -0
  62. package/dist/cli/checkpoint/index.d.ts.map +1 -0
  63. package/dist/cli/checkpoint/index.js +207 -0
  64. package/dist/cli/checkpoint/index.js.map +1 -0
  65. package/dist/cli/commands/builtin.d.ts +7 -0
  66. package/dist/cli/commands/builtin.d.ts.map +1 -0
  67. package/dist/cli/commands/builtin.js +962 -0
  68. package/dist/cli/commands/builtin.js.map +1 -0
  69. package/dist/cli/context/__tests__/formatPipeline.test.d.ts +2 -0
  70. package/dist/cli/context/__tests__/formatPipeline.test.d.ts.map +1 -0
  71. package/dist/cli/context/__tests__/formatPipeline.test.js +25 -0
  72. package/dist/cli/context/__tests__/formatPipeline.test.js.map +1 -0
  73. package/dist/cli/context/index.d.ts +8 -0
  74. package/dist/cli/context/index.d.ts.map +1 -0
  75. package/dist/cli/context/index.js +8 -0
  76. package/dist/cli/context/index.js.map +1 -0
  77. package/dist/cli/context/pipeline.d.ts +46 -0
  78. package/dist/cli/context/pipeline.d.ts.map +1 -0
  79. package/dist/cli/context/pipeline.js +112 -0
  80. package/dist/cli/context/pipeline.js.map +1 -0
  81. package/dist/cli/context/stages/stage-instructions.d.ts +12 -0
  82. package/dist/cli/context/stages/stage-instructions.d.ts.map +1 -0
  83. package/dist/cli/context/stages/stage-instructions.js +76 -0
  84. package/dist/cli/context/stages/stage-instructions.js.map +1 -0
  85. package/dist/cli/context/stages/stage-lessons.d.ts +13 -0
  86. package/dist/cli/context/stages/stage-lessons.d.ts.map +1 -0
  87. package/dist/cli/context/stages/stage-lessons.js +83 -0
  88. package/dist/cli/context/stages/stage-lessons.js.map +1 -0
  89. package/dist/cli/context/stages/stage-manifest.d.ts +11 -0
  90. package/dist/cli/context/stages/stage-manifest.d.ts.map +1 -0
  91. package/dist/cli/context/stages/stage-manifest.js +62 -0
  92. package/dist/cli/context/stages/stage-manifest.js.map +1 -0
  93. package/dist/cli/context/stages/stage-project.d.ts +10 -0
  94. package/dist/cli/context/stages/stage-project.d.ts.map +1 -0
  95. package/dist/cli/context/stages/stage-project.js +55 -0
  96. package/dist/cli/context/stages/stage-project.js.map +1 -0
  97. package/dist/cli/context/stages/stage-session.d.ts +12 -0
  98. package/dist/cli/context/stages/stage-session.d.ts.map +1 -0
  99. package/dist/cli/context/stages/stage-session.js +69 -0
  100. package/dist/cli/context/stages/stage-session.js.map +1 -0
  101. package/dist/cli/file-sources.d.ts +17 -0
  102. package/dist/cli/file-sources.d.ts.map +1 -0
  103. package/dist/cli/file-sources.js +42 -0
  104. package/dist/cli/file-sources.js.map +1 -0
  105. package/dist/cli/index.d.ts +26 -0
  106. package/dist/cli/index.d.ts.map +1 -0
  107. package/dist/cli/index.js +55 -0
  108. package/dist/cli/index.js.map +1 -0
  109. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts +2 -0
  110. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts.map +1 -0
  111. package/dist/cli/skills/__tests__/SkillLoader.test.js +285 -0
  112. package/dist/cli/skills/__tests__/SkillLoader.test.js.map +1 -0
  113. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts +2 -0
  114. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts.map +1 -0
  115. package/dist/cli/skills/__tests__/SkillManager.safety.test.js +87 -0
  116. package/dist/cli/skills/__tests__/SkillManager.safety.test.js.map +1 -0
  117. package/dist/cli/skills/__tests__/stack.test.d.ts +2 -0
  118. package/dist/cli/skills/__tests__/stack.test.d.ts.map +1 -0
  119. package/dist/cli/skills/__tests__/stack.test.js +81 -0
  120. package/dist/cli/skills/__tests__/stack.test.js.map +1 -0
  121. package/dist/cli/skills/loader.d.ts +42 -0
  122. package/dist/cli/skills/loader.d.ts.map +1 -0
  123. package/dist/cli/skills/loader.js +158 -0
  124. package/dist/cli/skills/loader.js.map +1 -0
  125. package/dist/cli/skills/manager.d.ts +97 -0
  126. package/dist/cli/skills/manager.d.ts.map +1 -0
  127. package/dist/cli/skills/manager.js +304 -0
  128. package/dist/cli/skills/manager.js.map +1 -0
  129. package/dist/cli/skills/parse-md-skill.d.ts +14 -0
  130. package/dist/cli/skills/parse-md-skill.d.ts.map +1 -0
  131. package/dist/cli/skills/parse-md-skill.js +86 -0
  132. package/dist/cli/skills/parse-md-skill.js.map +1 -0
  133. package/dist/cli/skills/providers/github.d.ts +21 -0
  134. package/dist/cli/skills/providers/github.d.ts.map +1 -0
  135. package/dist/cli/skills/providers/github.js +146 -0
  136. package/dist/cli/skills/providers/github.js.map +1 -0
  137. package/dist/cli/skills/providers/index.d.ts +6 -0
  138. package/dist/cli/skills/providers/index.d.ts.map +1 -0
  139. package/dist/cli/skills/providers/index.js +12 -0
  140. package/dist/cli/skills/providers/index.js.map +1 -0
  141. package/dist/cli/skills/providers/local.d.ts +16 -0
  142. package/dist/cli/skills/providers/local.d.ts.map +1 -0
  143. package/dist/cli/skills/providers/local.js +91 -0
  144. package/dist/cli/skills/providers/local.js.map +1 -0
  145. package/dist/cli/skills/providers/obsidian.d.ts +31 -0
  146. package/dist/cli/skills/providers/obsidian.d.ts.map +1 -0
  147. package/dist/cli/skills/providers/obsidian.js +141 -0
  148. package/dist/cli/skills/providers/obsidian.js.map +1 -0
  149. package/dist/cli/skills/providers/skills-sh.d.ts +32 -0
  150. package/dist/cli/skills/providers/skills-sh.d.ts.map +1 -0
  151. package/dist/cli/skills/providers/skills-sh.js +53 -0
  152. package/dist/cli/skills/providers/skills-sh.js.map +1 -0
  153. package/dist/cli/skills/providers/types.d.ts +25 -0
  154. package/dist/cli/skills/providers/types.d.ts.map +1 -0
  155. package/dist/cli/skills/providers/types.js +3 -0
  156. package/dist/cli/skills/providers/types.js.map +1 -0
  157. package/dist/cli/skills/safe-name.d.ts +2 -0
  158. package/dist/cli/skills/safe-name.d.ts.map +1 -0
  159. package/dist/cli/skills/safe-name.js +22 -0
  160. package/dist/cli/skills/safe-name.js.map +1 -0
  161. package/dist/cli/skills/stack.d.ts +3 -0
  162. package/dist/cli/skills/stack.d.ts.map +1 -0
  163. package/dist/cli/skills/stack.js +64 -0
  164. package/dist/cli/skills/stack.js.map +1 -0
  165. package/dist/cli/skills/types.d.ts +28 -0
  166. package/dist/cli/skills/types.d.ts.map +1 -0
  167. package/dist/cli/skills/types.js +3 -0
  168. package/dist/cli/skills/types.js.map +1 -0
  169. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts +2 -0
  170. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts.map +1 -0
  171. package/dist/cli/trust/__tests__/workspace-trust.test.js +252 -0
  172. package/dist/cli/trust/__tests__/workspace-trust.test.js.map +1 -0
  173. package/dist/cli/trust/workspace-trust.d.ts +49 -0
  174. package/dist/cli/trust/workspace-trust.d.ts.map +1 -0
  175. package/dist/cli/trust/workspace-trust.js +163 -0
  176. package/dist/cli/trust/workspace-trust.js.map +1 -0
  177. package/dist/cli/workspace/index.d.ts +68 -0
  178. package/dist/cli/workspace/index.d.ts.map +1 -0
  179. package/dist/cli/workspace/index.js +231 -0
  180. package/dist/cli/workspace/index.js.map +1 -0
  181. package/dist/index.d.ts +13 -1
  182. package/dist/index.d.ts.map +1 -1
  183. package/dist/index.js +17 -7
  184. package/dist/index.js.map +1 -1
  185. package/dist/pipeline/index.d.ts +2 -0
  186. package/dist/pipeline/index.d.ts.map +1 -1
  187. package/dist/pipeline/index.js +7 -1
  188. package/dist/pipeline/index.js.map +1 -1
  189. package/dist/pipeline/learning/__tests__/learning.test.d.ts +2 -0
  190. package/dist/pipeline/learning/__tests__/learning.test.d.ts.map +1 -0
  191. package/dist/pipeline/learning/__tests__/learning.test.js +145 -0
  192. package/dist/pipeline/learning/__tests__/learning.test.js.map +1 -0
  193. package/dist/pipeline/learning/index.d.ts +33 -0
  194. package/dist/pipeline/learning/index.d.ts.map +1 -0
  195. package/dist/pipeline/learning/index.js +131 -0
  196. package/dist/pipeline/learning/index.js.map +1 -0
  197. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts +8 -2
  198. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts.map +1 -1
  199. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js +19 -3
  200. package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js.map +1 -1
  201. package/dist/pipeline/orchestration/audit-reporter.d.ts +5 -1
  202. package/dist/pipeline/orchestration/audit-reporter.d.ts.map +1 -1
  203. package/dist/pipeline/orchestration/audit-reporter.js +6 -0
  204. package/dist/pipeline/orchestration/audit-reporter.js.map +1 -1
  205. package/dist/pipeline/orchestration/orchestrator.d.ts +9 -0
  206. package/dist/pipeline/orchestration/orchestrator.d.ts.map +1 -1
  207. package/dist/pipeline/orchestration/orchestrator.js +15 -0
  208. package/dist/pipeline/orchestration/orchestrator.js.map +1 -1
  209. package/dist/store/ProjectStore.d.ts.map +1 -1
  210. package/dist/store/ProjectStore.js +2 -1
  211. package/dist/store/ProjectStore.js.map +1 -1
  212. package/package.json +10 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../src/cli/skills/providers/local.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIjE;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACrD,QAAQ,CAAC,EAAE,WAAW;IAEtB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAuBxE"}
@@ -0,0 +1,91 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.LocalProvider = void 0;
37
+ const fs = __importStar(require("fs/promises"));
38
+ const path = __importStar(require("path"));
39
+ const yaml = __importStar(require("yaml"));
40
+ const result_1 = require("@backendkit-labs/result");
41
+ const parse_md_skill_1 = require("../parse-md-skill");
42
+ const SKILL_FILE_RE = /\.(ya?ml|md)$/i;
43
+ /**
44
+ * Fetches skills from a local filesystem directory.
45
+ * Supports both .yaml/.yml and .md (with frontmatter) skill files.
46
+ *
47
+ * Accepted source formats:
48
+ * /absolute/path/to/skills
49
+ * ./relative/path/to/skills
50
+ */
51
+ class LocalProvider {
52
+ id = 'local';
53
+ canHandle(source) {
54
+ return source.startsWith('/') || source.startsWith('.') || /^[A-Za-z]:[/\\]/.test(source);
55
+ }
56
+ async fetch(source, options) {
57
+ const dir = path.resolve(source);
58
+ const filesResult = await (0, result_1.run)(() => fs.readdir(dir));
59
+ if (!(0, result_1.isOk)(filesResult))
60
+ throw new Error(`Cannot read directory: ${dir}`);
61
+ const skills = [];
62
+ for (const file of filesResult.value) {
63
+ if (!SKILL_FILE_RE.test(file))
64
+ continue;
65
+ const filePath = path.join(dir, file);
66
+ const contentResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
67
+ if (!(0, result_1.isOk)(contentResult))
68
+ continue;
69
+ const skill = /\.md$/i.test(file)
70
+ ? (0, parse_md_skill_1.parseMdSkill)(contentResult.value)
71
+ : parseYamlSkill(contentResult.value);
72
+ if (!skill?.name)
73
+ continue;
74
+ if (options?.skill && skill.name !== options.skill)
75
+ continue;
76
+ skills.push(skill);
77
+ }
78
+ return skills;
79
+ }
80
+ }
81
+ exports.LocalProvider = LocalProvider;
82
+ function parseYamlSkill(text) {
83
+ const parsed = (0, result_1.fromThrowable)(() => yaml.parse(text));
84
+ if (!parsed.ok || !parsed.value?.name)
85
+ return null;
86
+ const skill = parsed.value;
87
+ if (!Array.isArray(skill.triggers))
88
+ skill.triggers = [];
89
+ return skill;
90
+ }
91
+ //# sourceMappingURL=local.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/cli/skills/providers/local.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAC7B,2CAA6B;AAC7B,oDAAmE;AACnE,sDAAiD;AAIjD,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAa,aAAa;IACb,EAAE,GAAG,OAAO,CAAC;IAEtB,SAAS,CAAC,MAAc;QACpB,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAsB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,IAAA,aAAI,EAAC,WAAW,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;QAEzE,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,aAAa,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,IAAA,aAAI,EAAC,aAAa,CAAC;gBAAE,SAAS;YAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC7B,CAAC,CAAC,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC;gBACnC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,CAAC,KAAK,EAAE,IAAI;gBAAE,SAAS;YAC3B,IAAI,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK;gBAAE,SAAS;YAC7D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AA9BD,sCA8BC;AAED,SAAS,cAAc,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;IACxD,OAAO,KAAK,CAAC;AACjB,CAAC"}
@@ -0,0 +1,31 @@
1
+ import type { Skill } from '@backendkit-labs/agent-core';
2
+ import type { FetchOptions, SkillSourceProvider } from './types';
3
+ /**
4
+ * Fetches skills from an Obsidian vault.
5
+ * Skills are .md files with YAML frontmatter stored inside the vault.
6
+ *
7
+ * Source format:
8
+ * obsidian:///path/to/vault — scans vault root, filters by tag='skill'
9
+ * obsidian:///path/to/vault?folder=Coding/Skills — scans folder, filters by tag='skill'
10
+ * obsidian:///path/to/vault?tag=agent-skill — custom tag, scans vault root
11
+ * obsidian:///path/to/vault?folder=Skills&tag= — folder only, no tag filter (tag= empty)
12
+ *
13
+ * Tag filter is always active (default: 'skill') unless explicitly disabled with ?tag= (empty).
14
+ * This prevents loading every .md in the vault accidentally.
15
+ *
16
+ * On Windows, use forward slashes:
17
+ * obsidian:///C:/Users/name/Obsidian Vault?folder=Skills
18
+ */
19
+ export declare class ObsidianProvider implements SkillSourceProvider {
20
+ readonly id = "obsidian";
21
+ canHandle(source: string): boolean;
22
+ fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
23
+ private parseSource;
24
+ private collectMdFiles;
25
+ /**
26
+ * Checks whether a file's frontmatter tags array includes the target tag.
27
+ * Handles both inline (`tags: [a, b]`) and block (`tags:\n - a`) YAML formats.
28
+ */
29
+ private hasTag;
30
+ }
31
+ //# sourceMappingURL=obsidian.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../../../src/cli/skills/providers/obsidian.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IACxD,QAAQ,CAAC,EAAE,cAAc;IAEzB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA0BrE,OAAO,CAAC,WAAW;YAsBL,cAAc;IAiB5B;;;OAGG;IACH,OAAO,CAAC,MAAM;CAajB"}
@@ -0,0 +1,141 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.ObsidianProvider = void 0;
37
+ const fs = __importStar(require("fs/promises"));
38
+ const path = __importStar(require("path"));
39
+ const yaml = __importStar(require("yaml"));
40
+ const result_1 = require("@backendkit-labs/result");
41
+ const parse_md_skill_1 = require("../parse-md-skill");
42
+ /**
43
+ * Fetches skills from an Obsidian vault.
44
+ * Skills are .md files with YAML frontmatter stored inside the vault.
45
+ *
46
+ * Source format:
47
+ * obsidian:///path/to/vault — scans vault root, filters by tag='skill'
48
+ * obsidian:///path/to/vault?folder=Coding/Skills — scans folder, filters by tag='skill'
49
+ * obsidian:///path/to/vault?tag=agent-skill — custom tag, scans vault root
50
+ * obsidian:///path/to/vault?folder=Skills&tag= — folder only, no tag filter (tag= empty)
51
+ *
52
+ * Tag filter is always active (default: 'skill') unless explicitly disabled with ?tag= (empty).
53
+ * This prevents loading every .md in the vault accidentally.
54
+ *
55
+ * On Windows, use forward slashes:
56
+ * obsidian:///C:/Users/name/Obsidian Vault?folder=Skills
57
+ */
58
+ class ObsidianProvider {
59
+ id = 'obsidian';
60
+ canHandle(source) {
61
+ return source.startsWith('obsidian://');
62
+ }
63
+ async fetch(source, options) {
64
+ const { vaultPath, folder, tag } = this.parseSource(source);
65
+ const scanDir = folder
66
+ ? path.join(vaultPath, ...folder.split('/'))
67
+ : vaultPath;
68
+ const mdFiles = await this.collectMdFiles(scanDir);
69
+ const skills = [];
70
+ for (const filePath of mdFiles) {
71
+ const contentResult = await (0, result_1.run)(() => fs.readFile(filePath, 'utf-8'));
72
+ if (!(0, result_1.isOk)(contentResult))
73
+ continue;
74
+ const skill = (0, parse_md_skill_1.parseMdSkill)(contentResult.value);
75
+ if (!skill?.name || !Array.isArray(skill.triggers))
76
+ continue;
77
+ if (tag && !this.hasTag(contentResult.value, tag))
78
+ continue;
79
+ if (options?.skill && skill.name !== options.skill)
80
+ continue;
81
+ skills.push(skill);
82
+ }
83
+ return skills;
84
+ }
85
+ parseSource(source) {
86
+ const withoutScheme = source.replace(/^obsidian:\/\//, '');
87
+ const [rawPath, queryString] = withoutScheme.split('?');
88
+ // Normalize Windows paths: /C:/Users/... → C:/Users/...
89
+ const vaultPath = path.normalize(rawPath.startsWith('/') && /^\/[A-Za-z]:/.test(rawPath)
90
+ ? rawPath.slice(1)
91
+ : rawPath);
92
+ const params = new URLSearchParams(queryString ?? '');
93
+ const folder = params.get('folder') ?? undefined;
94
+ const tagParam = params.get('tag');
95
+ // Tag filter is always on by default.
96
+ // Disable explicitly with ?tag= (empty string) when using folder as the scope.
97
+ const tag = tagParam === null ? 'skill' : (tagParam || undefined);
98
+ return { vaultPath, folder, tag };
99
+ }
100
+ async collectMdFiles(dir) {
101
+ const entriesResult = await (0, result_1.run)(() => fs.readdir(dir, { withFileTypes: true }));
102
+ if (!(0, result_1.isOk)(entriesResult))
103
+ return [];
104
+ const files = [];
105
+ for (const entry of entriesResult.value) {
106
+ if (entry.name.startsWith('.'))
107
+ continue; // skip .obsidian, .trash, etc.
108
+ const fullPath = path.join(dir, entry.name);
109
+ if (entry.isDirectory()) {
110
+ files.push(...await this.collectMdFiles(fullPath));
111
+ }
112
+ else if (entry.isFile() && entry.name.endsWith('.md')) {
113
+ files.push(fullPath);
114
+ }
115
+ }
116
+ return files;
117
+ }
118
+ /**
119
+ * Checks whether a file's frontmatter tags array includes the target tag.
120
+ * Handles both inline (`tags: [a, b]`) and block (`tags:\n - a`) YAML formats.
121
+ */
122
+ hasTag(content, tag) {
123
+ const frontmatterMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
124
+ if (!frontmatterMatch)
125
+ return false;
126
+ try {
127
+ const parsed = yaml.parse(frontmatterMatch[1]);
128
+ const tags = parsed?.tags;
129
+ if (Array.isArray(tags))
130
+ return tags.map(String).includes(tag);
131
+ if (typeof tags === 'string')
132
+ return tags === tag;
133
+ return false;
134
+ }
135
+ catch {
136
+ return false;
137
+ }
138
+ }
139
+ }
140
+ exports.ObsidianProvider = ObsidianProvider;
141
+ //# sourceMappingURL=obsidian.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"obsidian.js","sourceRoot":"","sources":["../../../../src/cli/skills/providers/obsidian.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import type { FetchOptions, SkillSourceProvider } from './types';
2
+ import type { Skill } from '@backendkit-labs/agent-core';
3
+ /**
4
+ * Fetches skills from the skills.sh registry.
5
+ *
6
+ * skills.sh is a discovery directory — actual skill files live on GitHub.
7
+ * This provider resolves a skills.sh URL to its underlying GitHub repo
8
+ * and delegates fetching to GitHubProvider.
9
+ *
10
+ * Accepted source formats:
11
+ * https://skills.sh/{owner}/{repo} — fetch all skills from the repo
12
+ * https://www.skills.sh/{owner}/{repo} — same (www prefix)
13
+ * https://skills.sh/{owner}/{repo}/{skill-name} — fetch a specific skill
14
+ *
15
+ * Example:
16
+ * https://skills.sh/vercel-labs/skills
17
+ * → resolves to https://github.com/vercel-labs/skills
18
+ * → GitHubProvider fetches skill files from the /skills folder or root
19
+ */
20
+ export declare class SkillsShProvider implements SkillSourceProvider {
21
+ readonly id = "skills-sh";
22
+ private readonly github;
23
+ constructor(appName?: string);
24
+ canHandle(source: string): boolean;
25
+ fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
26
+ /**
27
+ * Maps https://skills.sh/{owner}/{repo}/{skill?}
28
+ * to https://github.com/{owner}/{repo}
29
+ */
30
+ private resolveToGitHub;
31
+ }
32
+ //# sourceMappingURL=skills-sh.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills-sh.d.ts","sourceRoot":"","sources":["../../../../src/cli/skills/providers/skills-sh.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IACxD,QAAQ,CAAC,EAAE,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,OAAO,SAAU;IAI7B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOrE;;;OAGG;IACH,OAAO,CAAC,eAAe;CAS1B"}
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SkillsShProvider = void 0;
4
+ const github_1 = require("./github");
5
+ /**
6
+ * Fetches skills from the skills.sh registry.
7
+ *
8
+ * skills.sh is a discovery directory — actual skill files live on GitHub.
9
+ * This provider resolves a skills.sh URL to its underlying GitHub repo
10
+ * and delegates fetching to GitHubProvider.
11
+ *
12
+ * Accepted source formats:
13
+ * https://skills.sh/{owner}/{repo} — fetch all skills from the repo
14
+ * https://www.skills.sh/{owner}/{repo} — same (www prefix)
15
+ * https://skills.sh/{owner}/{repo}/{skill-name} — fetch a specific skill
16
+ *
17
+ * Example:
18
+ * https://skills.sh/vercel-labs/skills
19
+ * → resolves to https://github.com/vercel-labs/skills
20
+ * → GitHubProvider fetches skill files from the /skills folder or root
21
+ */
22
+ class SkillsShProvider {
23
+ id = 'skills-sh';
24
+ github;
25
+ constructor(appName = 'agent') {
26
+ this.github = new github_1.GitHubProvider(appName);
27
+ }
28
+ canHandle(source) {
29
+ return /^https?:\/\/(www\.)?skills\.sh\//i.test(source);
30
+ }
31
+ async fetch(source, options) {
32
+ const { githubUrl, skillName } = this.resolveToGitHub(source);
33
+ return this.github.fetch(githubUrl, {
34
+ skill: options?.skill ?? skillName,
35
+ });
36
+ }
37
+ /**
38
+ * Maps https://skills.sh/{owner}/{repo}/{skill?}
39
+ * to https://github.com/{owner}/{repo}
40
+ */
41
+ resolveToGitHub(source) {
42
+ const match = source.match(/skills\.sh\/([^/?#]+)\/([^/?#]+)(?:\/([^/?#]+))?/i);
43
+ if (!match)
44
+ throw new Error(`Cannot parse skills.sh URL: ${source}`);
45
+ const [, owner, repo, skillName] = match;
46
+ return {
47
+ githubUrl: `https://github.com/${owner}/${repo}`,
48
+ skillName: skillName || undefined,
49
+ };
50
+ }
51
+ }
52
+ exports.SkillsShProvider = SkillsShProvider;
53
+ //# sourceMappingURL=skills-sh.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills-sh.js","sourceRoot":"","sources":["../../../../src/cli/skills/providers/skills-sh.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAI1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,gBAAgB;IAChB,EAAE,GAAG,WAAW,CAAC;IAET,MAAM,CAAiB;IAExC,YAAY,OAAO,GAAG,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,uBAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,OAAO,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,OAAsB;QAC9C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE;YAChC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS;SACrC,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,MAAc;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO;YACH,SAAS,EAAE,sBAAsB,KAAK,IAAI,IAAI,EAAE;YAChD,SAAS,EAAE,SAAS,IAAI,SAAS;SACpC,CAAC;IACN,CAAC;CACJ;AAjCD,4CAiCC"}
@@ -0,0 +1,25 @@
1
+ import type { Skill } from '@backendkit-labs/agent-core';
2
+ export interface FetchOptions {
3
+ /** Only fetch this specific skill by name */
4
+ skill?: string;
5
+ }
6
+ /**
7
+ * A pluggable source for skill packs.
8
+ * Implement this interface to add support for new registries (skills.sh, npm, etc.)
9
+ * or custom storage (Obsidian vaults, internal wikis, etc.).
10
+ *
11
+ * Registration:
12
+ * manager.use(new MyProvider())
13
+ *
14
+ * Providers are tried in registration order (last registered = highest priority).
15
+ * The first provider whose canHandle() returns true is used.
16
+ */
17
+ export interface SkillSourceProvider {
18
+ /** Unique identifier, e.g. 'github', 'local', 'skills-sh', 'obsidian' */
19
+ readonly id: string;
20
+ /** Returns true if this provider knows how to fetch from the given source string */
21
+ canHandle(source: string): boolean;
22
+ /** Fetches skills from the source and returns them normalized as Skill[] */
23
+ fetch(source: string, options?: FetchOptions): Promise<Skill[]>;
24
+ }
25
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/skills/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,MAAM,WAAW,YAAY;IACzB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACnE"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/skills/providers/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export declare function assertSafeFileName(kind: string, value: string): void;
2
+ //# sourceMappingURL=safe-name.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-name.d.ts","sourceRoot":"","sources":["../../../src/cli/skills/safe-name.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAapE"}
@@ -0,0 +1,22 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.assertSafeFileName = assertSafeFileName;
4
+ /**
5
+ * A skill or pack name ends up as a file or directory name, and it comes from content the installer does
6
+ * not control (a downloaded skill's frontmatter, a source URL). Anything that could leave the target
7
+ * directory or address a different file is refused: path separators, drive/stream colons, NUL, "." and "..".
8
+ */
9
+ const MAX_NAME_LENGTH = 100;
10
+ const FORBIDDEN_CHARS = /[\\/:\u0000]/;
11
+ function assertSafeFileName(kind, value) {
12
+ const bad = value.length === 0 ||
13
+ value.length > MAX_NAME_LENGTH ||
14
+ value === '.' ||
15
+ value === '..' ||
16
+ FORBIDDEN_CHARS.test(value);
17
+ if (bad) {
18
+ throw new Error(`Unsafe ${kind} ${JSON.stringify(value.slice(0, 60))}: it must be 1-${MAX_NAME_LENGTH} characters, ` +
19
+ 'not "." or "..", and contain no "/", "\\", ":" or NUL.');
20
+ }
21
+ }
22
+ //# sourceMappingURL=safe-name.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-name.js","sourceRoot":"","sources":["../../../src/cli/skills/safe-name.ts"],"names":[],"mappings":";;AASA,gDAaC;AAtBD;;;;GAIG;AACH,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,MAAM,eAAe,GAAG,cAAc,CAAC;AAEvC,SAAgB,kBAAkB,CAAC,IAAY,EAAE,KAAa;IAC1D,MAAM,GAAG,GACL,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,eAAe;QAC9B,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,IAAI;QACd,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,GAAG,EAAE,CAAC;QACN,MAAM,IAAI,KAAK,CACX,UAAU,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,eAAe,eAAe;YACpG,wDAAwD,CAC3D,CAAC;IACN,CAAC;AACL,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Detects the project stack by checking for indicator files in `cwd`. Feeds `detectedStack` of the engine. */
2
+ export declare function detectStack(cwd: string): Promise<string[]>;
3
+ //# sourceMappingURL=stack.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../../src/cli/skills/stack.ts"],"names":[],"mappings":"AAmBA,+GAA+G;AAC/G,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAShE"}
@@ -0,0 +1,64 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.detectStack = detectStack;
37
+ const fs = __importStar(require("fs/promises"));
38
+ const path = __importStar(require("path"));
39
+ const result_1 = require("@backendkit-labs/result");
40
+ /** Detectable stacks mapped to their indicator files. */
41
+ const STACK_INDICATORS = [
42
+ { file: 'package.json', stack: 'node' },
43
+ { file: 'tsconfig.json', stack: 'typescript' },
44
+ { file: 'requirements.txt', stack: 'python' },
45
+ { file: 'pyproject.toml', stack: 'python' },
46
+ { file: 'pom.xml', stack: 'java' },
47
+ { file: 'build.gradle', stack: 'java' },
48
+ { file: 'Cargo.toml', stack: 'rust' },
49
+ { file: 'go.mod', stack: 'go' },
50
+ { file: 'composer.json', stack: 'php' },
51
+ { file: 'Gemfile', stack: 'ruby' },
52
+ { file: 'mix.exs', stack: 'elixir' },
53
+ ];
54
+ /** Detects the project stack by checking for indicator files in `cwd`. Feeds `detectedStack` of the engine. */
55
+ async function detectStack(cwd) {
56
+ const stacks = [];
57
+ await Promise.all(STACK_INDICATORS.map(async ({ file, stack }) => {
58
+ const result = await (0, result_1.run)(() => fs.access(path.join(cwd, file)));
59
+ if ((0, result_1.isOk)(result) && !stacks.includes(stack))
60
+ stacks.push(stack);
61
+ }));
62
+ return stacks;
63
+ }
64
+ //# sourceMappingURL=stack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/cli/skills/stack.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,kCASC;AA7BD,gDAAkC;AAClC,2CAA6B;AAC7B,oDAAoD;AAEpD,yDAAyD;AACzD,MAAM,gBAAgB,GAA2C;IAC7D,EAAE,IAAI,EAAE,cAAc,EAAO,KAAK,EAAE,MAAM,EAAE;IAC5C,EAAE,IAAI,EAAE,eAAe,EAAM,KAAK,EAAE,YAAY,EAAE;IAClD,EAAE,IAAI,EAAE,kBAAkB,EAAG,KAAK,EAAE,QAAQ,EAAE;IAC9C,EAAE,IAAI,EAAE,gBAAgB,EAAK,KAAK,EAAE,QAAQ,EAAE;IAC9C,EAAE,IAAI,EAAE,SAAS,EAAY,KAAK,EAAE,MAAM,EAAE;IAC5C,EAAE,IAAI,EAAE,cAAc,EAAO,KAAK,EAAE,MAAM,EAAE;IAC5C,EAAE,IAAI,EAAE,YAAY,EAAS,KAAK,EAAE,MAAM,EAAE;IAC5C,EAAE,IAAI,EAAE,QAAQ,EAAa,KAAK,EAAE,IAAI,EAAE;IAC1C,EAAE,IAAI,EAAE,eAAe,EAAM,KAAK,EAAE,KAAK,EAAE;IAC3C,EAAE,IAAI,EAAE,SAAS,EAAY,KAAK,EAAE,MAAM,EAAE;IAC5C,EAAE,IAAI,EAAE,SAAS,EAAY,KAAK,EAAE,QAAQ,EAAE;CACjD,CAAC;AAEF,+GAA+G;AACxG,KAAK,UAAU,WAAW,CAAC,GAAW;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,GAAG,CACb,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAA,YAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,IAAA,aAAI,EAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CACL,CAAC;IACF,OAAO,MAAM,CAAC;AAClB,CAAC"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Security configuration for SkillManager.
3
+ * Controls which sources are trusted and how much content a skill can inject.
4
+ */
5
+ export interface TrustConfig {
6
+ /**
7
+ * Source prefix allowlist. Only sources that start with one of these strings
8
+ * can be installed. Leave undefined to allow any source (open mode).
9
+ *
10
+ * Examples:
11
+ * ['https://github.com/my-org/', 'https://skills.sh/', './local-skills']
12
+ */
13
+ allowedSources?: string[];
14
+ /**
15
+ * Max bytes allowed for a skill's systemPromptAddition.
16
+ * Prevents prompt-flooding even from trusted sources.
17
+ * Default: 20_000 bytes (~20 KB).
18
+ */
19
+ maxPromptBytes?: number;
20
+ }
21
+ /** Metadata written to sources.json when a pack is installed */
22
+ export interface SkillPackSource {
23
+ pack: string;
24
+ source: string;
25
+ installedAt: string;
26
+ version?: string;
27
+ }
28
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/skills/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/skills/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=workspace-trust.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-trust.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/trust/__tests__/workspace-trust.test.ts"],"names":[],"mappings":""}