@gadicc/loom 0.0.0-oidc-bootstrap.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 (342) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +6 -0
  3. package/README.md +448 -0
  4. package/THIRD_PARTY_NOTICES.md +25 -0
  5. package/db/drizzle-config.d.ts +20 -0
  6. package/db/drizzle-config.js +34 -0
  7. package/db/fixtures.d.ts +31 -0
  8. package/db/fixtures.js +52 -0
  9. package/db/neon.d.ts +3 -0
  10. package/db/neon.js +20 -0
  11. package/db/neonFull.d.ts +12 -0
  12. package/db/neonFull.js +33 -0
  13. package/db/package.json +3 -0
  14. package/db/testing.d.ts +26 -0
  15. package/db/testing.js +76 -0
  16. package/db/testing.test.ts +28 -0
  17. package/db/valibot.d.ts +23 -0
  18. package/db/valibot.js +8 -0
  19. package/esm/_dnt.polyfills.d.ts +149 -0
  20. package/esm/_dnt.polyfills.d.ts.map +1 -0
  21. package/esm/_dnt.polyfills.js +163 -0
  22. package/esm/_dnt.shims.d.ts +2 -0
  23. package/esm/_dnt.shims.d.ts.map +1 -0
  24. package/esm/_dnt.shims.js +57 -0
  25. package/esm/bin/loom.d.ts +2 -0
  26. package/esm/bin/loom.d.ts.map +1 -0
  27. package/esm/bin/loom.js +11 -0
  28. package/esm/mod.d.ts +9 -0
  29. package/esm/mod.d.ts.map +1 -0
  30. package/esm/mod.js +8 -0
  31. package/esm/package.json +3 -0
  32. package/esm/src/apiKeys/authorize.d.ts +4 -0
  33. package/esm/src/apiKeys/authorize.d.ts.map +1 -0
  34. package/esm/src/apiKeys/authorize.js +184 -0
  35. package/esm/src/apiKeys/country.d.ts +3 -0
  36. package/esm/src/apiKeys/country.d.ts.map +1 -0
  37. package/esm/src/apiKeys/country.js +7 -0
  38. package/esm/src/apiKeys/credentials.d.ts +4 -0
  39. package/esm/src/apiKeys/credentials.d.ts.map +1 -0
  40. package/esm/src/apiKeys/credentials.js +55 -0
  41. package/esm/src/apiKeys/fingerprint.d.ts +3 -0
  42. package/esm/src/apiKeys/fingerprint.d.ts.map +1 -0
  43. package/esm/src/apiKeys/fingerprint.js +5 -0
  44. package/esm/src/apiKeys/mod.d.ts +9 -0
  45. package/esm/src/apiKeys/mod.d.ts.map +1 -0
  46. package/esm/src/apiKeys/mod.js +8 -0
  47. package/esm/src/apiKeys/policy.d.ts +59 -0
  48. package/esm/src/apiKeys/policy.d.ts.map +1 -0
  49. package/esm/src/apiKeys/policy.js +88 -0
  50. package/esm/src/apiKeys/retention.d.ts +55 -0
  51. package/esm/src/apiKeys/retention.d.ts.map +1 -0
  52. package/esm/src/apiKeys/retention.js +65 -0
  53. package/esm/src/apiKeys/types.d.ts +175 -0
  54. package/esm/src/apiKeys/types.d.ts.map +1 -0
  55. package/esm/src/apiKeys/types.js +1 -0
  56. package/esm/src/cli/externalSkills.d.ts +39 -0
  57. package/esm/src/cli/externalSkills.d.ts.map +1 -0
  58. package/esm/src/cli/externalSkills.js +177 -0
  59. package/esm/src/cli/mod.d.ts +337 -0
  60. package/esm/src/cli/mod.d.ts.map +1 -0
  61. package/esm/src/cli/mod.js +9268 -0
  62. package/esm/src/cli/projectSkills.d.ts +102 -0
  63. package/esm/src/cli/projectSkills.d.ts.map +1 -0
  64. package/esm/src/cli/projectSkills.js +592 -0
  65. package/esm/src/files/client.d.ts +29 -0
  66. package/esm/src/files/client.d.ts.map +1 -0
  67. package/esm/src/files/client.js +41 -0
  68. package/esm/src/files/errors.d.ts +37 -0
  69. package/esm/src/files/errors.d.ts.map +1 -0
  70. package/esm/src/files/errors.js +66 -0
  71. package/esm/src/files/hash.d.ts +15 -0
  72. package/esm/src/files/hash.d.ts.map +1 -0
  73. package/esm/src/files/hash.js +82 -0
  74. package/esm/src/files/memory.d.ts +29 -0
  75. package/esm/src/files/memory.d.ts.map +1 -0
  76. package/esm/src/files/memory.js +109 -0
  77. package/esm/src/files/metadata.d.ts +10 -0
  78. package/esm/src/files/metadata.d.ts.map +1 -0
  79. package/esm/src/files/metadata.js +186 -0
  80. package/esm/src/files/mod.d.ts +10 -0
  81. package/esm/src/files/mod.d.ts.map +1 -0
  82. package/esm/src/files/mod.js +9 -0
  83. package/esm/src/files/s3.d.ts +29 -0
  84. package/esm/src/files/s3.d.ts.map +1 -0
  85. package/esm/src/files/s3.js +107 -0
  86. package/esm/src/files/service.d.ts +27 -0
  87. package/esm/src/files/service.d.ts.map +1 -0
  88. package/esm/src/files/service.js +136 -0
  89. package/esm/src/files/types.d.ts +134 -0
  90. package/esm/src/files/types.d.ts.map +1 -0
  91. package/esm/src/files/types.js +1 -0
  92. package/esm/src/jobs/catalog.d.ts +32 -0
  93. package/esm/src/jobs/catalog.d.ts.map +1 -0
  94. package/esm/src/jobs/catalog.js +208 -0
  95. package/esm/src/jobs/controller.d.ts +28 -0
  96. package/esm/src/jobs/controller.d.ts.map +1 -0
  97. package/esm/src/jobs/controller.js +95 -0
  98. package/esm/src/jobs/direct.d.ts +36 -0
  99. package/esm/src/jobs/direct.d.ts.map +1 -0
  100. package/esm/src/jobs/direct.js +122 -0
  101. package/esm/src/jobs/events.d.ts +15 -0
  102. package/esm/src/jobs/events.d.ts.map +1 -0
  103. package/esm/src/jobs/events.js +30 -0
  104. package/esm/src/jobs/format.d.ts +16 -0
  105. package/esm/src/jobs/format.d.ts.map +1 -0
  106. package/esm/src/jobs/format.js +183 -0
  107. package/esm/src/jobs/http.d.ts +22 -0
  108. package/esm/src/jobs/http.d.ts.map +1 -0
  109. package/esm/src/jobs/http.js +44 -0
  110. package/esm/src/jobs/log.d.ts +2 -0
  111. package/esm/src/jobs/log.d.ts.map +1 -0
  112. package/esm/src/jobs/log.js +10 -0
  113. package/esm/src/jobs/mod.d.ts +10 -0
  114. package/esm/src/jobs/mod.d.ts.map +1 -0
  115. package/esm/src/jobs/mod.js +9 -0
  116. package/esm/src/jobs/run.d.ts +20 -0
  117. package/esm/src/jobs/run.d.ts.map +1 -0
  118. package/esm/src/jobs/run.js +57 -0
  119. package/esm/src/jobs/types.d.ts +31 -0
  120. package/esm/src/jobs/types.d.ts.map +1 -0
  121. package/esm/src/jobs/types.js +1 -0
  122. package/esm/src/mui/apiKeys.d.ts +65 -0
  123. package/esm/src/mui/apiKeys.d.ts.map +1 -0
  124. package/esm/src/mui/apiKeys.js +301 -0
  125. package/esm/src/mui/apiKeysView.d.ts +48 -0
  126. package/esm/src/mui/apiKeysView.d.ts.map +1 -0
  127. package/esm/src/mui/apiKeysView.js +34 -0
  128. package/esm/src/mui/confirm.d.ts +12 -0
  129. package/esm/src/mui/confirm.d.ts.map +1 -0
  130. package/esm/src/mui/confirm.js +78 -0
  131. package/esm/src/mui/mod.d.ts +4 -0
  132. package/esm/src/mui/mod.d.ts.map +1 -0
  133. package/esm/src/mui/mod.js +2 -0
  134. package/esm/src/next/apiKeys/mod.d.ts +64 -0
  135. package/esm/src/next/apiKeys/mod.d.ts.map +1 -0
  136. package/esm/src/next/apiKeys/mod.js +217 -0
  137. package/esm/src/next/auth/config.d.ts +34 -0
  138. package/esm/src/next/auth/config.d.ts.map +1 -0
  139. package/esm/src/next/auth/config.js +103 -0
  140. package/esm/src/next/auth/mod.d.ts +3 -0
  141. package/esm/src/next/auth/mod.d.ts.map +1 -0
  142. package/esm/src/next/auth/mod.js +2 -0
  143. package/esm/src/next/auth/server.d.ts +28 -0
  144. package/esm/src/next/auth/server.d.ts.map +1 -0
  145. package/esm/src/next/auth/server.js +24 -0
  146. package/esm/src/next/files/mod.d.ts +3 -0
  147. package/esm/src/next/files/mod.d.ts.map +1 -0
  148. package/esm/src/next/files/mod.js +2 -0
  149. package/esm/src/next/files/route.d.ts +99 -0
  150. package/esm/src/next/files/route.d.ts.map +1 -0
  151. package/esm/src/next/files/route.js +349 -0
  152. package/esm/src/next/jobs/list.d.ts +25 -0
  153. package/esm/src/next/jobs/list.d.ts.map +1 -0
  154. package/esm/src/next/jobs/list.js +39 -0
  155. package/esm/src/next/jobs/mod.d.ts +6 -0
  156. package/esm/src/next/jobs/mod.d.ts.map +1 -0
  157. package/esm/src/next/jobs/mod.js +5 -0
  158. package/esm/src/next/jobs/paths.d.ts +14 -0
  159. package/esm/src/next/jobs/paths.d.ts.map +1 -0
  160. package/esm/src/next/jobs/paths.js +40 -0
  161. package/esm/src/next/jobs/route.d.ts +48 -0
  162. package/esm/src/next/jobs/route.d.ts.map +1 -0
  163. package/esm/src/next/jobs/route.js +101 -0
  164. package/esm/src/next/jobs/run.d.ts +51 -0
  165. package/esm/src/next/jobs/run.d.ts.map +1 -0
  166. package/esm/src/next/jobs/run.js +563 -0
  167. package/esm/src/next/jobs/stream.d.ts +3 -0
  168. package/esm/src/next/jobs/stream.d.ts.map +1 -0
  169. package/esm/src/next/jobs/stream.js +25 -0
  170. package/esm/src/next/pwa/mod.d.ts +104 -0
  171. package/esm/src/next/pwa/mod.d.ts.map +1 -0
  172. package/esm/src/next/pwa/mod.js +169 -0
  173. package/esm/src/next/pwa/worker.d.ts +27 -0
  174. package/esm/src/next/pwa/worker.d.ts.map +1 -0
  175. package/esm/src/next/pwa/worker.js +27 -0
  176. package/package.json +293 -0
  177. package/script/_dnt.polyfills.d.ts +149 -0
  178. package/script/_dnt.polyfills.d.ts.map +1 -0
  179. package/script/_dnt.polyfills.js +166 -0
  180. package/script/_dnt.shims.d.ts +2 -0
  181. package/script/_dnt.shims.d.ts.map +1 -0
  182. package/script/_dnt.shims.js +60 -0
  183. package/script/bin/loom.d.ts +2 -0
  184. package/script/bin/loom.d.ts.map +1 -0
  185. package/script/bin/loom.js +17 -0
  186. package/script/mod.d.ts +9 -0
  187. package/script/mod.d.ts.map +1 -0
  188. package/script/mod.js +24 -0
  189. package/script/package.json +3 -0
  190. package/script/src/apiKeys/authorize.d.ts +4 -0
  191. package/script/src/apiKeys/authorize.d.ts.map +1 -0
  192. package/script/src/apiKeys/authorize.js +187 -0
  193. package/script/src/apiKeys/country.d.ts +3 -0
  194. package/script/src/apiKeys/country.d.ts.map +1 -0
  195. package/script/src/apiKeys/country.js +10 -0
  196. package/script/src/apiKeys/credentials.d.ts +4 -0
  197. package/script/src/apiKeys/credentials.d.ts.map +1 -0
  198. package/script/src/apiKeys/credentials.js +58 -0
  199. package/script/src/apiKeys/fingerprint.d.ts +3 -0
  200. package/script/src/apiKeys/fingerprint.d.ts.map +1 -0
  201. package/script/src/apiKeys/fingerprint.js +8 -0
  202. package/script/src/apiKeys/mod.d.ts +9 -0
  203. package/script/src/apiKeys/mod.d.ts.map +1 -0
  204. package/script/src/apiKeys/mod.js +24 -0
  205. package/script/src/apiKeys/policy.d.ts +59 -0
  206. package/script/src/apiKeys/policy.d.ts.map +1 -0
  207. package/script/src/apiKeys/policy.js +92 -0
  208. package/script/src/apiKeys/retention.d.ts +55 -0
  209. package/script/src/apiKeys/retention.d.ts.map +1 -0
  210. package/script/src/apiKeys/retention.js +70 -0
  211. package/script/src/apiKeys/types.d.ts +175 -0
  212. package/script/src/apiKeys/types.d.ts.map +1 -0
  213. package/script/src/apiKeys/types.js +2 -0
  214. package/script/src/cli/externalSkills.d.ts +39 -0
  215. package/script/src/cli/externalSkills.d.ts.map +1 -0
  216. package/script/src/cli/externalSkills.js +181 -0
  217. package/script/src/cli/mod.d.ts +337 -0
  218. package/script/src/cli/mod.d.ts.map +1 -0
  219. package/script/src/cli/mod.js +9337 -0
  220. package/script/src/cli/projectSkills.d.ts +102 -0
  221. package/script/src/cli/projectSkills.d.ts.map +1 -0
  222. package/script/src/cli/projectSkills.js +606 -0
  223. package/script/src/files/client.d.ts +29 -0
  224. package/script/src/files/client.d.ts.map +1 -0
  225. package/script/src/files/client.js +45 -0
  226. package/script/src/files/errors.d.ts +37 -0
  227. package/script/src/files/errors.d.ts.map +1 -0
  228. package/script/src/files/errors.js +76 -0
  229. package/script/src/files/hash.d.ts +15 -0
  230. package/script/src/files/hash.d.ts.map +1 -0
  231. package/script/src/files/hash.js +89 -0
  232. package/script/src/files/memory.d.ts +29 -0
  233. package/script/src/files/memory.d.ts.map +1 -0
  234. package/script/src/files/memory.js +113 -0
  235. package/script/src/files/metadata.d.ts +10 -0
  236. package/script/src/files/metadata.d.ts.map +1 -0
  237. package/script/src/files/metadata.js +189 -0
  238. package/script/src/files/mod.d.ts +10 -0
  239. package/script/src/files/mod.d.ts.map +1 -0
  240. package/script/src/files/mod.js +25 -0
  241. package/script/src/files/s3.d.ts +29 -0
  242. package/script/src/files/s3.d.ts.map +1 -0
  243. package/script/src/files/s3.js +110 -0
  244. package/script/src/files/service.d.ts +27 -0
  245. package/script/src/files/service.d.ts.map +1 -0
  246. package/script/src/files/service.js +139 -0
  247. package/script/src/files/types.d.ts +134 -0
  248. package/script/src/files/types.d.ts.map +1 -0
  249. package/script/src/files/types.js +2 -0
  250. package/script/src/jobs/catalog.d.ts +32 -0
  251. package/script/src/jobs/catalog.d.ts.map +1 -0
  252. package/script/src/jobs/catalog.js +223 -0
  253. package/script/src/jobs/controller.d.ts +28 -0
  254. package/script/src/jobs/controller.d.ts.map +1 -0
  255. package/script/src/jobs/controller.js +100 -0
  256. package/script/src/jobs/direct.d.ts +36 -0
  257. package/script/src/jobs/direct.d.ts.map +1 -0
  258. package/script/src/jobs/direct.js +128 -0
  259. package/script/src/jobs/events.d.ts +15 -0
  260. package/script/src/jobs/events.d.ts.map +1 -0
  261. package/script/src/jobs/events.js +37 -0
  262. package/script/src/jobs/format.d.ts +16 -0
  263. package/script/src/jobs/format.d.ts.map +1 -0
  264. package/script/src/jobs/format.js +193 -0
  265. package/script/src/jobs/http.d.ts +22 -0
  266. package/script/src/jobs/http.d.ts.map +1 -0
  267. package/script/src/jobs/http.js +50 -0
  268. package/script/src/jobs/log.d.ts +2 -0
  269. package/script/src/jobs/log.d.ts.map +1 -0
  270. package/script/src/jobs/log.js +13 -0
  271. package/script/src/jobs/mod.d.ts +10 -0
  272. package/script/src/jobs/mod.d.ts.map +1 -0
  273. package/script/src/jobs/mod.js +25 -0
  274. package/script/src/jobs/run.d.ts +20 -0
  275. package/script/src/jobs/run.d.ts.map +1 -0
  276. package/script/src/jobs/run.js +61 -0
  277. package/script/src/jobs/types.d.ts +31 -0
  278. package/script/src/jobs/types.d.ts.map +1 -0
  279. package/script/src/jobs/types.js +2 -0
  280. package/script/src/mui/apiKeys.d.ts +65 -0
  281. package/script/src/mui/apiKeys.d.ts.map +1 -0
  282. package/script/src/mui/apiKeys.js +327 -0
  283. package/script/src/mui/apiKeysView.d.ts +48 -0
  284. package/script/src/mui/apiKeysView.d.ts.map +1 -0
  285. package/script/src/mui/apiKeysView.js +40 -0
  286. package/script/src/mui/confirm.d.ts +12 -0
  287. package/script/src/mui/confirm.d.ts.map +1 -0
  288. package/script/src/mui/confirm.js +85 -0
  289. package/script/src/mui/mod.d.ts +4 -0
  290. package/script/src/mui/mod.d.ts.map +1 -0
  291. package/script/src/mui/mod.js +19 -0
  292. package/script/src/next/apiKeys/mod.d.ts +64 -0
  293. package/script/src/next/apiKeys/mod.d.ts.map +1 -0
  294. package/script/src/next/apiKeys/mod.js +224 -0
  295. package/script/src/next/auth/config.d.ts +34 -0
  296. package/script/src/next/auth/config.d.ts.map +1 -0
  297. package/script/src/next/auth/config.js +142 -0
  298. package/script/src/next/auth/mod.d.ts +3 -0
  299. package/script/src/next/auth/mod.d.ts.map +1 -0
  300. package/script/src/next/auth/mod.js +18 -0
  301. package/script/src/next/auth/server.d.ts +28 -0
  302. package/script/src/next/auth/server.d.ts.map +1 -0
  303. package/script/src/next/auth/server.js +27 -0
  304. package/script/src/next/files/mod.d.ts +3 -0
  305. package/script/src/next/files/mod.d.ts.map +1 -0
  306. package/script/src/next/files/mod.js +18 -0
  307. package/script/src/next/files/route.d.ts +99 -0
  308. package/script/src/next/files/route.d.ts.map +1 -0
  309. package/script/src/next/files/route.js +353 -0
  310. package/script/src/next/jobs/list.d.ts +25 -0
  311. package/script/src/next/jobs/list.d.ts.map +1 -0
  312. package/script/src/next/jobs/list.js +48 -0
  313. package/script/src/next/jobs/mod.d.ts +6 -0
  314. package/script/src/next/jobs/mod.d.ts.map +1 -0
  315. package/script/src/next/jobs/mod.js +21 -0
  316. package/script/src/next/jobs/paths.d.ts +14 -0
  317. package/script/src/next/jobs/paths.d.ts.map +1 -0
  318. package/script/src/next/jobs/paths.js +47 -0
  319. package/script/src/next/jobs/route.d.ts +48 -0
  320. package/script/src/next/jobs/route.d.ts.map +1 -0
  321. package/script/src/next/jobs/route.js +105 -0
  322. package/script/src/next/jobs/run.d.ts +51 -0
  323. package/script/src/next/jobs/run.d.ts.map +1 -0
  324. package/script/src/next/jobs/run.js +570 -0
  325. package/script/src/next/jobs/stream.d.ts +3 -0
  326. package/script/src/next/jobs/stream.d.ts.map +1 -0
  327. package/script/src/next/jobs/stream.js +28 -0
  328. package/script/src/next/pwa/mod.d.ts +104 -0
  329. package/script/src/next/pwa/mod.d.ts.map +1 -0
  330. package/script/src/next/pwa/mod.js +192 -0
  331. package/script/src/next/pwa/worker.d.ts +27 -0
  332. package/script/src/next/pwa/worker.d.ts.map +1 -0
  333. package/script/src/next/pwa/worker.js +33 -0
  334. package/skills/loom/SKILL.md +200 -0
  335. package/skills/loom-api-keys/SKILL.md +123 -0
  336. package/skills/loom-auth/SKILL.md +70 -0
  337. package/skills/loom-db/SKILL.md +94 -0
  338. package/skills/loom-db/references/db-stack.md +39 -0
  339. package/skills/loom-files/SKILL.md +97 -0
  340. package/skills/loom-jobs/SKILL.md +148 -0
  341. package/skills/upgrade-deps/SKILL.md +165 -0
  342. package/skills/upgrade-deps/agents/openai.yaml +4 -0
@@ -0,0 +1,592 @@
1
+ import { createHash } from "node:crypto";
2
+ import { copyFile, lstat, mkdir, mkdtemp, readdir, readFile, readlink, rename, rm, symlink, unlink, writeFile, } from "node:fs/promises";
3
+ import { tmpdir } from "node:os";
4
+ import { dirname, join, relative, resolve, sep } from "node:path";
5
+ import process from "node:process";
6
+ import { getAllExternalSkills, getRecommendedExternalSkills, } from "./externalSkills.js";
7
+ export const LOOM_SKILLS_LOCK = "loom-skills.lock.json";
8
+ export const LOOM_EXTERNAL_SKILLS_CACHE = ".loom/skills";
9
+ export const LOOM_EXTERNAL_SKILLS_GITIGNORE_LINE = ".loom/skills/";
10
+ const LEGACY_EXTERNAL_TARGET_FRAGMENT = "/node_modules/@gadicc/loom/skills/recommended/";
11
+ function emptyLock() {
12
+ return { disabled: [], skills: {}, version: 1 };
13
+ }
14
+ async function pathExists(path) {
15
+ try {
16
+ await lstat(path);
17
+ return true;
18
+ }
19
+ catch (error) {
20
+ if (error.code === "ENOENT")
21
+ return false;
22
+ throw error;
23
+ }
24
+ }
25
+ async function readJsonIfExists(path) {
26
+ try {
27
+ return JSON.parse(await readFile(path, "utf8"));
28
+ }
29
+ catch (error) {
30
+ if (error.code === "ENOENT")
31
+ return null;
32
+ throw error;
33
+ }
34
+ }
35
+ /** Reads the committed project skill policy, returning an empty v1 policy when absent. */
36
+ export async function readProjectSkillsLock(cwd) {
37
+ const lock = await readJsonIfExists(join(cwd, LOOM_SKILLS_LOCK));
38
+ if (!lock)
39
+ return emptyLock();
40
+ if (lock.version !== 1 || !lock.skills || !Array.isArray(lock.disabled)) {
41
+ throw new Error(`Unsupported or invalid ${LOOM_SKILLS_LOCK}.`);
42
+ }
43
+ return lock;
44
+ }
45
+ function stableLock(lock) {
46
+ return {
47
+ disabled: [...new Set(lock.disabled)].sort(),
48
+ skills: Object.fromEntries(Object.entries(lock.skills).sort(([left], [right]) => left.localeCompare(right))),
49
+ version: 1,
50
+ };
51
+ }
52
+ async function writeLockIfChanged(cwd, lock) {
53
+ const path = join(cwd, LOOM_SKILLS_LOCK);
54
+ const text = `${JSON.stringify(stableLock(lock), null, 2)}\n`;
55
+ let current = null;
56
+ try {
57
+ current = await readFile(path, "utf8");
58
+ }
59
+ catch (error) {
60
+ if (error.code !== "ENOENT")
61
+ throw error;
62
+ }
63
+ if (current === text)
64
+ return false;
65
+ await writeFile(path, text, "utf8");
66
+ return true;
67
+ }
68
+ async function collectSkillFiles(root, current, files) {
69
+ for (const entry of await readdir(current, { withFileTypes: true })) {
70
+ const path = join(current, entry.name);
71
+ if (entry.isDirectory()) {
72
+ if (entry.name !== ".git" && entry.name !== "node_modules") {
73
+ await collectSkillFiles(root, path, files);
74
+ }
75
+ }
76
+ else if (entry.isFile()) {
77
+ files.push({
78
+ content: await readFile(path),
79
+ relativePath: relative(root, path).split(sep).join("/"),
80
+ });
81
+ }
82
+ else if (entry.isSymbolicLink()) {
83
+ throw new Error(`Skill directories may not contain symlinks: ${path}`);
84
+ }
85
+ }
86
+ }
87
+ /** Computes Loom's deterministic path-and-content digest for one skill tree. */
88
+ export async function computeSkillContentHash(skillPath) {
89
+ const files = [];
90
+ await collectSkillFiles(skillPath, skillPath, files);
91
+ files.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
92
+ const hash = createHash("sha256");
93
+ for (const file of files) {
94
+ hash.update(file.relativePath);
95
+ hash.update(file.content);
96
+ }
97
+ return hash.digest("hex");
98
+ }
99
+ async function parseSkillName(skillFile) {
100
+ try {
101
+ const text = await readFile(skillFile, "utf8");
102
+ const frontmatter = text.match(/^---\s*\n([\s\S]*?)\n---(?:\s*\n|$)/)?.[1];
103
+ const name = frontmatter?.match(/^name:\s*["']?([^\s"']+)["']?\s*$/m)?.[1];
104
+ return name && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name) ? name : null;
105
+ }
106
+ catch (error) {
107
+ if (error.code === "ENOENT")
108
+ return null;
109
+ throw error;
110
+ }
111
+ }
112
+ async function packageRoots(nodeModules) {
113
+ const roots = [];
114
+ let entries;
115
+ try {
116
+ entries = await readdir(nodeModules, { withFileTypes: true });
117
+ }
118
+ catch (error) {
119
+ if (error.code === "ENOENT")
120
+ return roots;
121
+ throw error;
122
+ }
123
+ for (const entry of entries) {
124
+ if (entry.name.startsWith("."))
125
+ continue;
126
+ const path = join(nodeModules, entry.name);
127
+ if (entry.name.startsWith("@")) {
128
+ let scopedEntries;
129
+ try {
130
+ scopedEntries = await readdir(path, { withFileTypes: true });
131
+ }
132
+ catch {
133
+ continue;
134
+ }
135
+ for (const scoped of scopedEntries) {
136
+ roots.push({
137
+ packageName: `${entry.name}/${scoped.name}`,
138
+ path: join(path, scoped.name),
139
+ });
140
+ }
141
+ }
142
+ else {
143
+ roots.push({ packageName: entry.name, path });
144
+ }
145
+ }
146
+ return roots;
147
+ }
148
+ async function discoverPackageSkills(cwd) {
149
+ const found = [];
150
+ for (const root of await packageRoots(join(cwd, "node_modules"))) {
151
+ if (root.packageName === "@gadicc/loom")
152
+ continue;
153
+ const packageJson = await readJsonIfExists(join(root.path, "package.json"));
154
+ if (!packageJson)
155
+ continue;
156
+ const candidates = [
157
+ root.path,
158
+ join(root.path, "skills"),
159
+ join(root.path, ".agents", "skills"),
160
+ ];
161
+ const rootName = await parseSkillName(join(root.path, "SKILL.md"));
162
+ if (rootName) {
163
+ const contentHash = await computeSkillContentHash(root.path);
164
+ found.push({
165
+ contentHash,
166
+ packageName: root.packageName,
167
+ packageVersion: packageJson.version,
168
+ path: root.path,
169
+ selector: `npm:${root.packageName}:${rootName}`,
170
+ skillName: rootName,
171
+ sourcePath: relative(cwd, root.path),
172
+ });
173
+ continue;
174
+ }
175
+ for (const candidate of candidates) {
176
+ let entries;
177
+ try {
178
+ entries = await readdir(candidate, { withFileTypes: true });
179
+ }
180
+ catch {
181
+ continue;
182
+ }
183
+ for (const entry of entries) {
184
+ if (!entry.isDirectory() && !entry.isSymbolicLink())
185
+ continue;
186
+ const skillPath = join(candidate, entry.name);
187
+ const skillName = await parseSkillName(join(skillPath, "SKILL.md"));
188
+ if (!skillName)
189
+ continue;
190
+ found.push({
191
+ contentHash: await computeSkillContentHash(skillPath),
192
+ packageName: root.packageName,
193
+ packageVersion: packageJson.version,
194
+ path: skillPath,
195
+ selector: `npm:${root.packageName}:${skillName}`,
196
+ skillName,
197
+ sourcePath: relative(cwd, skillPath),
198
+ });
199
+ }
200
+ }
201
+ }
202
+ return found.sort((left, right) => left.skillName.localeCompare(right.skillName) ||
203
+ left.packageName.localeCompare(right.packageName));
204
+ }
205
+ function projectSkillPath(cwd, skillName) {
206
+ return join(cwd, ".agents", "skills", skillName);
207
+ }
208
+ async function linkState(path, expectedTarget) {
209
+ try {
210
+ const info = await lstat(path);
211
+ if (!info.isSymbolicLink())
212
+ return "custom";
213
+ const target = await readlink(path);
214
+ const resolved = resolve(dirname(path), target);
215
+ if (resolved === resolve(expectedTarget))
216
+ return "expected";
217
+ if (resolved.split(sep).join("/").includes(LEGACY_EXTERNAL_TARGET_FRAGMENT)) {
218
+ return "legacy";
219
+ }
220
+ return "custom";
221
+ }
222
+ catch (error) {
223
+ if (error.code === "ENOENT") {
224
+ return "missing";
225
+ }
226
+ throw error;
227
+ }
228
+ }
229
+ async function ensureSkillLink(cwd, skillName, target, allowLegacyReplacement) {
230
+ const path = projectSkillPath(cwd, skillName);
231
+ const state = await linkState(path, target);
232
+ if (state === "expected")
233
+ return { changed: false, preserved: false };
234
+ if (state === "custom" || (state === "legacy" && !allowLegacyReplacement)) {
235
+ return { changed: false, preserved: true };
236
+ }
237
+ if (state === "legacy")
238
+ await unlink(path);
239
+ await mkdir(dirname(path), { recursive: true });
240
+ await symlink(relative(dirname(path), target), path, "dir");
241
+ return { changed: true, preserved: false };
242
+ }
243
+ async function removeManagedLink(cwd, skillName, target) {
244
+ const path = projectSkillPath(cwd, skillName);
245
+ if (await linkState(path, target) !== "expected")
246
+ return false;
247
+ await unlink(path);
248
+ return true;
249
+ }
250
+ async function removeLegacyPackagedSkillLink(cwd, skillName) {
251
+ const path = projectSkillPath(cwd, skillName);
252
+ try {
253
+ const info = await lstat(path);
254
+ if (!info.isSymbolicLink())
255
+ return false;
256
+ const target = resolve(dirname(path), await readlink(path))
257
+ .split(sep)
258
+ .join("/");
259
+ if (!target.includes(`${LEGACY_EXTERNAL_TARGET_FRAGMENT}${skillName}`)) {
260
+ return false;
261
+ }
262
+ await unlink(path);
263
+ return true;
264
+ }
265
+ catch (error) {
266
+ if (error.code === "ENOENT")
267
+ return false;
268
+ throw error;
269
+ }
270
+ }
271
+ /** Discovers and activates skills exposed by installed npm packages. */
272
+ export async function syncInstalledPackageSkills(cwd) {
273
+ const changedFiles = [];
274
+ const notes = [];
275
+ const hadLock = await pathExists(join(cwd, LOOM_SKILLS_LOCK));
276
+ const lock = await readProjectSkillsLock(cwd);
277
+ const discovered = await discoverPackageSkills(cwd);
278
+ const activeSelectors = new Set();
279
+ const claimedNames = new Map();
280
+ for (const skill of discovered) {
281
+ activeSelectors.add(skill.selector);
282
+ if (lock.disabled.includes(skill.selector))
283
+ continue;
284
+ const claimedBy = claimedNames.get(skill.skillName);
285
+ if (claimedBy && claimedBy !== skill.packageName) {
286
+ notes.push(`Skipped npm skill ${skill.skillName} from ${skill.packageName}; ${claimedBy} already provides that name.`);
287
+ continue;
288
+ }
289
+ claimedNames.set(skill.skillName, skill.packageName);
290
+ const existing = lock.skills[skill.skillName];
291
+ if (existing?.kind === "external")
292
+ continue;
293
+ const linked = await ensureSkillLink(cwd, skill.skillName, skill.path, false);
294
+ if (linked.preserved) {
295
+ notes.push(`Preserved existing skill path instead of activating ${skill.skillName} from ${skill.packageName}.`);
296
+ continue;
297
+ }
298
+ lock.skills[skill.skillName] = {
299
+ contentHash: skill.contentHash,
300
+ kind: "package",
301
+ packageName: skill.packageName,
302
+ packageVersion: skill.packageVersion,
303
+ sourcePath: skill.sourcePath,
304
+ };
305
+ if (linked.changed) {
306
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skill.skillName)));
307
+ notes.push(`Activated npm package skill ${skill.skillName} from ${skill.packageName}. Disable with \`loom skills disable ${skill.skillName}\`.`);
308
+ }
309
+ }
310
+ for (const [skillName, entry] of Object.entries(lock.skills)) {
311
+ if (entry.kind !== "package")
312
+ continue;
313
+ const selector = `npm:${entry.packageName}:${skillName}`;
314
+ if (activeSelectors.has(selector))
315
+ continue;
316
+ if (await removeManagedLink(cwd, skillName, join(cwd, entry.sourcePath))) {
317
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skillName)));
318
+ }
319
+ delete lock.skills[skillName];
320
+ notes.push(`Deactivated npm package skill ${skillName}; ${entry.packageName} is no longer installed.`);
321
+ }
322
+ if ((hadLock || discovered.length > 0) &&
323
+ await writeLockIfChanged(cwd, lock)) {
324
+ changedFiles.push(LOOM_SKILLS_LOCK);
325
+ }
326
+ return { changedFiles: [...new Set(changedFiles)], notes };
327
+ }
328
+ async function runGit(runner, args, cwd, env) {
329
+ const result = await runner("git", args, { cwd, env, stdio: "pipe" });
330
+ if (result.code !== 0) {
331
+ throw new Error(`git ${args.join(" ")} failed: ${result.stderr.trim() || result.code}`);
332
+ }
333
+ }
334
+ async function checkoutExternalSource(skill, checkoutRoot, runner, env) {
335
+ const checkout = join(checkoutRoot, `${skill.skillName}-${skill.source.revision.slice(0, 12)}`);
336
+ await mkdir(checkout, { recursive: true });
337
+ await runGit(runner, ["init", "--quiet"], checkout, env);
338
+ await runGit(runner, ["remote", "add", "origin", skill.source.repositoryUrl], checkout, env);
339
+ await runGit(runner, ["fetch", "--depth", "1", "origin", skill.source.revision], checkout, env);
340
+ await runGit(runner, ["checkout", "--detach", "FETCH_HEAD"], checkout, env);
341
+ const sourcePath = resolve(checkout, skill.source.sourcePath);
342
+ if (sourcePath !== resolve(checkout) &&
343
+ !sourcePath.startsWith(`${resolve(checkout)}${sep}`)) {
344
+ throw new Error(`External skill path escapes its checkout: ${skill.skillName}`);
345
+ }
346
+ if (!await parseSkillName(join(sourcePath, "SKILL.md"))) {
347
+ throw new Error(`External skill has no valid SKILL.md: ${skill.skillName}`);
348
+ }
349
+ return sourcePath;
350
+ }
351
+ async function copySkillDirectory(source, destination) {
352
+ await mkdir(destination, { recursive: true });
353
+ for (const entry of await readdir(source, { withFileTypes: true })) {
354
+ const from = join(source, entry.name);
355
+ const to = join(destination, entry.name);
356
+ if (entry.isDirectory())
357
+ await copySkillDirectory(from, to);
358
+ else if (entry.isFile())
359
+ await copyFile(from, to);
360
+ else
361
+ throw new Error(`External skill contains unsupported link: ${from}`);
362
+ }
363
+ }
364
+ function externalCachePath(cwd, skill) {
365
+ return join(cwd, LOOM_EXTERNAL_SKILLS_CACHE, skill.skillName, skill.source.revision);
366
+ }
367
+ async function hydrateExternalSkill(cwd, skill, runner, env) {
368
+ const destination = externalCachePath(cwd, skill);
369
+ if (await pathExists(join(destination, "SKILL.md"))) {
370
+ const currentHash = await computeSkillContentHash(destination);
371
+ if (currentHash === skill.source.contentHash)
372
+ return false;
373
+ }
374
+ const checkoutRoot = await mkdtemp(join(tmpdir(), "loom-skill-checkout-"));
375
+ const partial = `${destination}.partial-${process.pid}`;
376
+ try {
377
+ const sourcePath = await checkoutExternalSource(skill, checkoutRoot, runner, env);
378
+ const hash = await computeSkillContentHash(sourcePath);
379
+ if (hash !== skill.source.contentHash) {
380
+ throw new Error(`Content hash mismatch for ${skill.skillName} at ${skill.source.revision}.`);
381
+ }
382
+ await rm(partial, { force: true, recursive: true });
383
+ await copySkillDirectory(sourcePath, partial);
384
+ await mkdir(dirname(destination), { recursive: true });
385
+ await rm(destination, { force: true, recursive: true });
386
+ await rename(partial, destination);
387
+ return true;
388
+ }
389
+ finally {
390
+ await rm(partial, { force: true, recursive: true });
391
+ await rm(checkoutRoot, { force: true, recursive: true });
392
+ }
393
+ }
394
+ /** Hydrates selected external skills at catalog-pinned revisions and updates links. */
395
+ export async function syncExternalProjectSkills(cwd, context, options) {
396
+ const changedFiles = [];
397
+ const notes = [];
398
+ const env = options.env ?? process.env;
399
+ const lock = await readProjectSkillsLock(cwd);
400
+ const all = options.skills ?? getAllExternalSkills();
401
+ const applicable = options.skills ?? getRecommendedExternalSkills(context.packageJson, context.activeFeatureKeys, await pathExists(join(cwd, "pnpm-lock.yaml")));
402
+ const byName = new Map(all.map((skill) => [skill.skillName, skill]));
403
+ const selected = new Set(options.skillNames ?? []);
404
+ if (options.adoptRecommended) {
405
+ for (const skill of applicable)
406
+ selected.add(skill.skillName);
407
+ }
408
+ for (const [name, entry] of Object.entries(lock.skills)) {
409
+ if (entry.kind === "external")
410
+ selected.add(name);
411
+ }
412
+ const unknown = [...selected].filter((name) => !byName.has(name));
413
+ if (unknown.length) {
414
+ throw new Error(`Unknown external skill: ${unknown.join(", ")}`);
415
+ }
416
+ const accepted = new Set(options.acceptUnknownLicense ?? []);
417
+ for (const skillName of [...selected].sort()) {
418
+ const skill = byName.get(skillName);
419
+ const selector = `external:${skillName}`;
420
+ if (lock.disabled.includes(selector)) {
421
+ if (await removeLegacyPackagedSkillLink(cwd, skillName)) {
422
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skillName)));
423
+ notes.push(`Removed legacy packaged link for disabled skill ${skillName}.`);
424
+ }
425
+ continue;
426
+ }
427
+ const existing = lock.skills[skillName];
428
+ const acknowledged = existing?.kind === "external" &&
429
+ existing.licenseAcknowledged === true || accepted.has(skillName);
430
+ if (skill.license.status !== "verified" && !acknowledged) {
431
+ if (await removeLegacyPackagedSkillLink(cwd, skillName)) {
432
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skillName)));
433
+ notes.push(`Removed the legacy packaged ${skillName} link because Loom no longer redistributes its content.`);
434
+ }
435
+ notes.push(`Did not install ${skillName}: upstream declares no clear license. Re-run with \`--accept-unknown-license ${skillName}\` after reviewing ${skill.sourceUrl}.`);
436
+ continue;
437
+ }
438
+ const hydrated = await hydrateExternalSkill(cwd, skill, options.commandRunner, env);
439
+ const target = externalCachePath(cwd, skill);
440
+ const linked = await ensureSkillLink(cwd, skillName, target, true);
441
+ if (linked.preserved) {
442
+ notes.push(`Preserved custom skill path for ${skillName}.`);
443
+ continue;
444
+ }
445
+ lock.skills[skillName] = {
446
+ contentHash: skill.source.contentHash,
447
+ kind: "external",
448
+ licenseAcknowledged: acknowledged || undefined,
449
+ licenseStatus: skill.license.status,
450
+ repositoryUrl: skill.source.repositoryUrl,
451
+ revision: skill.source.revision,
452
+ sourcePath: skill.source.sourcePath,
453
+ };
454
+ if (hydrated) {
455
+ notes.push(`Installed ${skillName} at ${skill.source.revision.slice(0, 12)}.`);
456
+ }
457
+ if (linked.changed) {
458
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skillName)));
459
+ notes.push(`Linked external skill ${skillName} from the project cache.`);
460
+ }
461
+ }
462
+ if (await writeLockIfChanged(cwd, lock))
463
+ changedFiles.push(LOOM_SKILLS_LOCK);
464
+ return { changedFiles: [...new Set(changedFiles)], notes };
465
+ }
466
+ /** Removes only the retired Next skill symlink created by older Loom releases. */
467
+ export async function removeLegacyNextSkillLink(cwd) {
468
+ return await removeLegacyPackagedSkillLink(cwd, "next-best-practices");
469
+ }
470
+ /** Checks package activations and external skill locks, caches, and catalog revisions. */
471
+ export async function checkProjectSkills(cwd, context, strict = false) {
472
+ const warnings = [];
473
+ const issues = [];
474
+ const suggestions = new Set();
475
+ const lock = await readProjectSkillsLock(cwd);
476
+ const discovered = await discoverPackageSkills(cwd);
477
+ for (const skill of discovered) {
478
+ if (lock.disabled.includes(skill.selector))
479
+ continue;
480
+ const entry = lock.skills[skill.skillName];
481
+ if (entry?.kind === "package" &&
482
+ await linkState(projectSkillPath(cwd, skill.skillName), skill.path) ===
483
+ "expected") {
484
+ continue;
485
+ }
486
+ warnings.push(`Installed npm package ${skill.packageName} provides inactive skill ${skill.skillName}.`);
487
+ suggestions.add("Run `loom skills sync` to activate installed package skills.");
488
+ }
489
+ const applicable = getRecommendedExternalSkills(context.packageJson, context.activeFeatureKeys, await pathExists(join(cwd, "pnpm-lock.yaml")));
490
+ const applicableNames = new Set(applicable.map((skill) => skill.skillName));
491
+ const catalog = new Map(getAllExternalSkills().map((skill) => [skill.skillName, skill]));
492
+ const names = new Set(applicableNames);
493
+ for (const [skillName, entry] of Object.entries(lock.skills)) {
494
+ if (entry.kind === "external")
495
+ names.add(skillName);
496
+ }
497
+ for (const skillName of names) {
498
+ const skill = catalog.get(skillName);
499
+ const entry = lock.skills[skillName];
500
+ if (!skill) {
501
+ (strict ? issues : warnings).push(`Locked external skill is no longer present in Loom's catalog: ${skillName}.`);
502
+ suggestions.add(`Review and disable or replace ${skillName}.`);
503
+ continue;
504
+ }
505
+ if (entry?.kind !== "external") {
506
+ if (!applicableNames.has(skillName))
507
+ continue;
508
+ const message = skill.license.status === "verified"
509
+ ? `Recommended external skill is not adopted: ${skill.skillName} (${skill.sourceLabel}).`
510
+ : `Recommended external skill requires license review before adoption: ${skill.skillName} (${skill.sourceLabel}).`;
511
+ if (strict) {
512
+ issues.push(message);
513
+ suggestions.add(`Run \`loom skills add ${skill.skillName}\`.`);
514
+ }
515
+ continue;
516
+ }
517
+ const target = join(cwd, LOOM_EXTERNAL_SKILLS_CACHE, skill.skillName, entry.revision);
518
+ const state = await linkState(projectSkillPath(cwd, skill.skillName), target);
519
+ if (state !== "expected" || !await pathExists(join(target, "SKILL.md"))) {
520
+ (strict ? issues : warnings).push(`External skill is not hydrated and linked: ${skill.skillName}.`);
521
+ suggestions.add("Run `loom skills sync`.");
522
+ continue;
523
+ }
524
+ if (entry.revision !== skill.source.revision ||
525
+ entry.contentHash !== skill.source.contentHash) {
526
+ (strict ? issues : warnings).push(`External skill is behind Loom's reviewed catalog: ${skill.skillName}.`);
527
+ suggestions.add(`Run \`loom skills update ${skillName}\`.`);
528
+ }
529
+ }
530
+ return { issues, suggestions: [...suggestions], warnings };
531
+ }
532
+ /** Enables or disables automatic activation for a project skill name. */
533
+ export async function setProjectSkillDisabled(cwd, skillName, disabled) {
534
+ const lock = await readProjectSkillsLock(cwd);
535
+ const entry = lock.skills[skillName];
536
+ const selectors = entry?.kind === "package"
537
+ ? [`npm:${entry.packageName}:${skillName}`]
538
+ : [`external:${skillName}`];
539
+ if (disabled)
540
+ lock.disabled.push(...selectors);
541
+ else {
542
+ lock.disabled = lock.disabled.filter((item) => !selectors.includes(item) && !item.endsWith(`:${skillName}`));
543
+ }
544
+ const changedFiles = [];
545
+ if (disabled && entry) {
546
+ const target = entry.kind === "package"
547
+ ? join(cwd, entry.sourcePath)
548
+ : join(cwd, LOOM_EXTERNAL_SKILLS_CACHE, skillName, entry.revision);
549
+ if (await removeManagedLink(cwd, skillName, target)) {
550
+ changedFiles.push(relative(cwd, projectSkillPath(cwd, skillName)));
551
+ }
552
+ delete lock.skills[skillName];
553
+ }
554
+ if (await writeLockIfChanged(cwd, lock))
555
+ changedFiles.push(LOOM_SKILLS_LOCK);
556
+ return {
557
+ changedFiles,
558
+ notes: [
559
+ disabled
560
+ ? `Disabled automatic activation for ${skillName}.`
561
+ : `Enabled automatic activation for ${skillName}; run \`loom skills sync\` to activate it.`,
562
+ ],
563
+ };
564
+ }
565
+ /** Returns display-oriented project skill status without mutating the project. */
566
+ export async function getProjectSkillStatus(cwd, context) {
567
+ const lock = await readProjectSkillsLock(cwd);
568
+ const discovered = await discoverPackageSkills(cwd);
569
+ const applicable = new Set(getRecommendedExternalSkills(context.packageJson, context.activeFeatureKeys, await pathExists(join(cwd, "pnpm-lock.yaml"))).map((skill) => skill.skillName));
570
+ const external = await Promise.all(getAllExternalSkills().map(async (skill) => {
571
+ const entry = lock.skills[skill.skillName];
572
+ const installed = entry?.kind === "external" && await pathExists(join(cwd, LOOM_EXTERNAL_SKILLS_CACHE, skill.skillName, entry.revision, "SKILL.md"));
573
+ return {
574
+ adopted: entry?.kind === "external",
575
+ applicable: applicable.has(skill.skillName),
576
+ installed,
577
+ licenseStatus: skill.license.status,
578
+ skillName: skill.skillName,
579
+ revision: skill.source.revision,
580
+ };
581
+ }));
582
+ return {
583
+ disabled: lock.disabled,
584
+ external,
585
+ packageSkills: discovered.map((skill) => ({
586
+ active: lock.skills[skill.skillName]?.kind === "package",
587
+ disabled: lock.disabled.includes(skill.selector),
588
+ packageName: skill.packageName,
589
+ skillName: skill.skillName,
590
+ })),
591
+ };
592
+ }
@@ -0,0 +1,29 @@
1
+ import type { LoomFileRecord } from "./types.js";
2
+ export interface LoomFileUploadResponse<TRecord extends LoomFileRecord = LoomFileRecord> {
3
+ created: boolean;
4
+ file: TRecord;
5
+ reusedExisting: boolean;
6
+ sha256: string;
7
+ stored: boolean;
8
+ }
9
+ export interface UploadLoomFileOptions {
10
+ computeSha256?: boolean;
11
+ endpoint?: string;
12
+ extraFields?: Record<string, string>;
13
+ fetch?: typeof fetch;
14
+ fieldName?: string;
15
+ file: Blob;
16
+ filename?: string;
17
+ headers?: HeadersInit;
18
+ sha256?: string;
19
+ }
20
+ export declare function createLoomFileUploadFormData(options: UploadLoomFileOptions): Promise<{
21
+ formData: any;
22
+ sha256: string | null;
23
+ }>;
24
+ /**
25
+ * Uploads a blob through the shared multipart route contract. UI libraries can
26
+ * wrap this helper without coupling Loom to a specific component package.
27
+ */
28
+ export declare function uploadLoomFile<TRecord extends LoomFileRecord = LoomFileRecord>(options: UploadLoomFileOptions): Promise<LoomFileUploadResponse<TRecord>>;
29
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/src/files/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,sBAAsB,CACrC,OAAO,SAAS,cAAc,GAAG,cAAc;IAE/C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,qBAAqB;;;GAmB/B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAc1E"}
@@ -0,0 +1,41 @@
1
+ import { sha256Hex } from "./hash.js";
2
+ function getBlobFilename(file, fallback = "file") {
3
+ const candidate = "name" in file && typeof file.name === "string"
4
+ ? file.name
5
+ : null;
6
+ return candidate || fallback;
7
+ }
8
+ export async function createLoomFileUploadFormData(options) {
9
+ const formData = new FormData();
10
+ const fieldName = options.fieldName ?? "file";
11
+ const filename = options.filename ?? getBlobFilename(options.file);
12
+ const sha256 = options.sha256 ??
13
+ (options.computeSha256 === false
14
+ ? null
15
+ : await sha256Hex(await options.file.arrayBuffer()));
16
+ formData.set(fieldName, options.file, filename);
17
+ if (sha256) {
18
+ formData.set("sha256", sha256);
19
+ }
20
+ for (const [key, value] of Object.entries(options.extraFields ?? {})) {
21
+ formData.set(key, value);
22
+ }
23
+ return { formData, sha256 };
24
+ }
25
+ /**
26
+ * Uploads a blob through the shared multipart route contract. UI libraries can
27
+ * wrap this helper without coupling Loom to a specific component package.
28
+ */
29
+ export async function uploadLoomFile(options) {
30
+ const fetchImpl = options.fetch ?? fetch;
31
+ const { formData } = await createLoomFileUploadFormData(options);
32
+ const response = await fetchImpl(options.endpoint ?? "/api/files", {
33
+ body: formData,
34
+ headers: options.headers,
35
+ method: "POST",
36
+ });
37
+ if (!response.ok) {
38
+ throw new Error(`Loom file upload failed with HTTP ${response.status}.`);
39
+ }
40
+ return await response.json();
41
+ }