@hasna/skills 0.1.26 → 0.1.29

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 (491) hide show
  1. package/LICENSE +1 -10
  2. package/README.md +141 -39
  3. package/bin/index.js +30122 -27575
  4. package/bin/mcp.js +22112 -18593
  5. package/dist/cli/cli.test-utils.d.ts +15 -0
  6. package/dist/cli/commands/auth.d.ts +2 -0
  7. package/dist/cli/commands/install.d.ts +1 -1
  8. package/dist/cli/commands/runtime-mcp.d.ts +4 -0
  9. package/dist/index.d.ts +9 -4
  10. package/dist/index.js +11607 -597
  11. package/dist/lib/auth-store.d.ts +13 -0
  12. package/dist/lib/installer.d.ts +58 -55
  13. package/dist/lib/mcp-contracts.d.ts +86 -0
  14. package/dist/lib/project-state.d.ts +43 -0
  15. package/dist/lib/registry-data/business-marketing.d.ts +2 -0
  16. package/dist/lib/registry-data/communication.d.ts +2 -0
  17. package/dist/lib/registry-data/content-generation.d.ts +2 -0
  18. package/dist/lib/registry-data/data-analysis.d.ts +2 -0
  19. package/dist/lib/registry-data/design-branding.d.ts +2 -0
  20. package/dist/lib/registry-data/development-tools.d.ts +2 -0
  21. package/dist/lib/registry-data/education-learning.d.ts +2 -0
  22. package/dist/lib/registry-data/event-management.d.ts +2 -0
  23. package/dist/lib/registry-data/finance-compliance.d.ts +2 -0
  24. package/dist/lib/registry-data/health-wellness.d.ts +2 -0
  25. package/dist/lib/registry-data/index.d.ts +2 -0
  26. package/dist/lib/registry-data/media-processing.d.ts +2 -0
  27. package/dist/lib/registry-data/productivity-organization.d.ts +2 -0
  28. package/dist/lib/registry-data/project-management.d.ts +2 -0
  29. package/dist/lib/registry-data/research-writing.d.ts +2 -0
  30. package/dist/lib/registry-data/science-academic.d.ts +2 -0
  31. package/dist/lib/registry-data/travel-lifestyle.d.ts +2 -0
  32. package/dist/lib/registry-data/web-browser.d.ts +2 -0
  33. package/dist/lib/registry-types.d.ts +27 -0
  34. package/dist/lib/registry.d.ts +6 -18
  35. package/dist/lib/remote-registry.d.ts +3 -0
  36. package/dist/lib/run-state.d.ts +60 -0
  37. package/dist/lib/skill-aliases.d.ts +17 -0
  38. package/dist/lib/skillinfo.d.ts +5 -1
  39. package/dist/mcp/discovery-tools.d.ts +2 -0
  40. package/dist/mcp/helpers.d.ts +26 -0
  41. package/dist/mcp/http.d.ts +10 -0
  42. package/dist/mcp/index.d.ts +3 -2
  43. package/dist/mcp/operation-tools.d.ts +2 -0
  44. package/dist/mcp/resource-meta-tools.d.ts +2 -0
  45. package/dist/mcp/schedule-tools.d.ts +2 -0
  46. package/dist/mcp/server.d.ts +4 -0
  47. package/dist/types/api.d.ts +7 -4
  48. package/package.json +23 -10
  49. package/skills/_common/http-client.ts +1 -1
  50. package/skills/_common/index.ts +2 -3
  51. package/skills/_common/install.sh +5 -110
  52. package/skills/_common/installer.ts +31 -282
  53. package/skills/_common/skill-install.ts +14 -181
  54. package/skills/ad-creative-pack/SKILL.md +45 -0
  55. package/skills/ad-creative-pack/package.json +14 -0
  56. package/skills/advanced-math/package.json +3 -1
  57. package/skills/advanced-math/src/calculators.ts +118 -0
  58. package/skills/advanced-math/src/cli.ts +130 -0
  59. package/skills/advanced-math/src/conversion.ts +90 -0
  60. package/skills/advanced-math/src/finance.ts +75 -0
  61. package/skills/advanced-math/src/formatting.ts +95 -0
  62. package/skills/advanced-math/src/index.ts +24 -702
  63. package/skills/advanced-math/src/runtime.ts +49 -0
  64. package/skills/advanced-math/src/symbolic.ts +110 -0
  65. package/skills/advanced-math/src/types.ts +36 -0
  66. package/skills/analyze-data/SKILL.md +2 -2
  67. package/skills/analyze-data/src/analysis.ts +401 -0
  68. package/skills/analyze-data/src/cli.ts +66 -0
  69. package/skills/analyze-data/src/formatters.ts +235 -0
  70. package/skills/analyze-data/src/index.ts +6 -1027
  71. package/skills/analyze-data/src/logger.ts +36 -0
  72. package/skills/analyze-data/src/parsers.ts +57 -0
  73. package/skills/analyze-data/src/stats.ts +151 -0
  74. package/skills/analyze-data/src/types.ts +85 -0
  75. package/skills/api-docs-portal/SKILL.md +46 -0
  76. package/skills/api-docs-portal/package.json +9 -0
  77. package/skills/api-test-suite/src/index.ts +13 -0
  78. package/skills/apidocs/package.json +1 -1
  79. package/skills/apidocs/src/index.ts +3 -0
  80. package/skills/audio/package.json +2 -3
  81. package/skills/audio-cleanup-lab/SKILL.md +2 -2
  82. package/skills/audio-extract/CLAUDE.md +1 -1
  83. package/skills/audio-transcript-pack/SKILL.md +43 -0
  84. package/skills/audio-transcript-pack/package.json +10 -0
  85. package/skills/blog-article/CLAUDE.md +12 -0
  86. package/skills/blog-article/SKILL.md +45 -0
  87. package/skills/{create-blog-article → blog-article}/package.json +3 -3
  88. package/skills/brand-kit/SKILL.md +45 -0
  89. package/skills/brand-kit/package.json +14 -0
  90. package/skills/brand-photo-shoot/SKILL.md +28 -0
  91. package/skills/brand-photo-shoot/package.json +10 -0
  92. package/skills/brand-style-guide/SKILL.md +2 -2
  93. package/skills/brand-style-guide/src/index.ts +0 -0
  94. package/skills/budget-variance-analyzer/SKILL.md +2 -2
  95. package/skills/businessactivity/package.json +1 -1
  96. package/skills/businessactivity/src/index.ts +3 -0
  97. package/skills/calendar-events/src/ai-parser.ts +103 -0
  98. package/skills/calendar-events/src/api.ts +157 -0
  99. package/skills/calendar-events/src/auth.ts +22 -0
  100. package/skills/calendar-events/src/config.ts +6 -0
  101. package/skills/calendar-events/src/format.ts +96 -0
  102. package/skills/calendar-events/src/help.ts +54 -0
  103. package/skills/calendar-events/src/index.ts +21 -524
  104. package/skills/calendar-events/src/logger.ts +34 -0
  105. package/skills/calendar-events/src/types.ts +67 -0
  106. package/skills/compress-video/SKILL.md +2 -2
  107. package/skills/consolelog/package.json +1 -1
  108. package/skills/consolelog/src/index.ts +3 -0
  109. package/skills/contract-review-report/SKILL.md +43 -0
  110. package/skills/contract-review-report/package.json +10 -0
  111. package/skills/convert/SKILL.md +2 -3
  112. package/skills/customer-feedback-report/SKILL.md +44 -0
  113. package/skills/customer-feedback-report/package.json +10 -0
  114. package/skills/dashboard-builder/package.json +3 -1
  115. package/skills/database-explorer/package.json +3 -1
  116. package/skills/deepresearch/README.md +4 -13
  117. package/skills/deploy/src/http-client.ts +1 -1
  118. package/skills/diff-viewer/package.json +4 -1
  119. package/skills/doc-generate/package.json +0 -1
  120. package/skills/doc-generate/src/ai.ts +50 -0
  121. package/skills/doc-generate/src/cli.ts +203 -0
  122. package/skills/doc-generate/src/dependencies.ts +44 -0
  123. package/skills/doc-generate/src/document-builder.ts +299 -0
  124. package/skills/doc-generate/src/index.ts +40 -764
  125. package/skills/doc-generate/src/markdown-parser.ts +125 -0
  126. package/skills/doc-generate/src/types.ts +68 -0
  127. package/skills/domainpurchase/SKILL.md +1 -1
  128. package/skills/domainpurchase/package.json +1 -1
  129. package/skills/domainpurchase/src/index.ts +3 -0
  130. package/skills/domainsearch/SKILL.md +1 -1
  131. package/skills/domainsearch/package.json +1 -1
  132. package/skills/domainsearch/src/index.ts +3 -0
  133. package/skills/email-sequence/SKILL.md +44 -0
  134. package/skills/email-sequence/package.json +14 -0
  135. package/skills/excel/CLAUDE.md +2 -2
  136. package/skills/experiment-power-calculator/package.json +3 -1
  137. package/skills/extract-invoice/src/cli.ts +97 -0
  138. package/skills/extract-invoice/src/extractor.ts +170 -0
  139. package/skills/extract-invoice/src/file-utils.ts +46 -0
  140. package/skills/extract-invoice/src/formatters.ts +144 -0
  141. package/skills/extract-invoice/src/index.ts +44 -629
  142. package/skills/extract-invoice/src/runtime.ts +46 -0
  143. package/skills/extract-invoice/src/types.ts +88 -0
  144. package/skills/folder-tree/package.json +3 -1
  145. package/skills/form-filler/package.json +3 -1
  146. package/skills/generate-api-client/package.json +3 -1
  147. package/skills/generate-api-client/src/generator.ts +47 -0
  148. package/skills/generate-api-client/src/index.ts +3 -777
  149. package/skills/generate-api-client/src/logger.ts +34 -0
  150. package/skills/generate-api-client/src/python-generator.ts +245 -0
  151. package/skills/generate-api-client/src/spec-loader.ts +48 -0
  152. package/skills/generate-api-client/src/type-mappers.ts +79 -0
  153. package/skills/generate-api-client/src/types.ts +76 -0
  154. package/skills/generate-api-client/src/typescript-generator.ts +247 -0
  155. package/skills/generate-book-cover/package.json +3 -1
  156. package/skills/generate-dockerfile/src/cli.ts +78 -0
  157. package/skills/generate-dockerfile/src/dockerfile-templates.ts +392 -0
  158. package/skills/generate-dockerfile/src/index.ts +12 -790
  159. package/skills/generate-dockerfile/src/logger.ts +30 -0
  160. package/skills/generate-dockerfile/src/project-detection.ts +68 -0
  161. package/skills/generate-dockerfile/src/support-files.ts +171 -0
  162. package/skills/generate-dockerfile/src/types.ts +29 -0
  163. package/skills/generate-documentation/src/ai.ts +131 -0
  164. package/skills/generate-documentation/src/cli.ts +71 -0
  165. package/skills/generate-documentation/src/code-parser.ts +300 -0
  166. package/skills/generate-documentation/src/file-processing.ts +182 -0
  167. package/skills/generate-documentation/src/index.ts +13 -753
  168. package/skills/generate-documentation/src/runtime.ts +35 -0
  169. package/skills/generate-documentation/src/types.ts +30 -0
  170. package/skills/generate-env/package.json +3 -1
  171. package/skills/generate-env/src/cli.ts +85 -0
  172. package/skills/generate-env/src/detection.ts +161 -0
  173. package/skills/generate-env/src/env-data.ts +66 -0
  174. package/skills/generate-env/src/generators.ts +240 -0
  175. package/skills/generate-env/src/index.ts +76 -676
  176. package/skills/generate-env/src/runtime.ts +30 -0
  177. package/skills/generate-env/src/types.ts +32 -0
  178. package/skills/generate-favicon/package.json +3 -1
  179. package/skills/generate-mock-data/package.json +3 -1
  180. package/skills/generate-mock-data/src/ai.ts +102 -0
  181. package/skills/generate-mock-data/src/formatters.ts +84 -0
  182. package/skills/generate-mock-data/src/generator.ts +377 -0
  183. package/skills/generate-mock-data/src/index.ts +15 -716
  184. package/skills/generate-mock-data/src/logger.ts +37 -0
  185. package/skills/generate-mock-data/src/presets.ts +110 -0
  186. package/skills/generate-mock-data/src/types.ts +21 -0
  187. package/skills/generate-pr-description/src/ai.ts +144 -0
  188. package/skills/generate-pr-description/src/cli.ts +80 -0
  189. package/skills/generate-pr-description/src/clipboard.ts +30 -0
  190. package/skills/generate-pr-description/src/formatters.ts +231 -0
  191. package/skills/generate-pr-description/src/git.ts +153 -0
  192. package/skills/generate-pr-description/src/index.ts +21 -714
  193. package/skills/generate-pr-description/src/types.ts +49 -0
  194. package/skills/generate-presentation/src/ai-clients.ts +61 -0
  195. package/skills/generate-presentation/src/cli.ts +126 -0
  196. package/skills/generate-presentation/src/index.ts +3 -751
  197. package/skills/generate-presentation/src/logger.ts +67 -0
  198. package/skills/generate-presentation/src/presentation-generator.ts +425 -0
  199. package/skills/generate-presentation/src/runtime.ts +6 -0
  200. package/skills/generate-presentation/src/security.ts +12 -0
  201. package/skills/generate-presentation/src/types.ts +28 -0
  202. package/skills/generate-qrcode/package.json +4 -1
  203. package/skills/generate-regex/package.json +3 -1
  204. package/skills/generate-resume/src/cli.ts +157 -0
  205. package/skills/generate-resume/src/index.ts +13 -917
  206. package/skills/generate-resume/src/parsers.ts +95 -0
  207. package/skills/generate-resume/src/renderers.ts +538 -0
  208. package/skills/generate-resume/src/security.ts +39 -0
  209. package/skills/generate-resume/src/types.ts +86 -0
  210. package/skills/generate-social-posts/src/ai.ts +88 -0
  211. package/skills/generate-social-posts/src/cli.ts +118 -0
  212. package/skills/generate-social-posts/src/exporters.ts +126 -0
  213. package/skills/generate-social-posts/src/generator.ts +130 -0
  214. package/skills/generate-social-posts/src/index.ts +19 -709
  215. package/skills/generate-social-posts/src/platforms.ts +39 -0
  216. package/skills/generate-social-posts/src/runtime.ts +34 -0
  217. package/skills/generate-social-posts/src/source.ts +116 -0
  218. package/skills/generate-social-posts/src/types.ts +58 -0
  219. package/skills/gif-maker/package.json +4 -1
  220. package/skills/github-manager/package.json +3 -1
  221. package/skills/gmail/CLAUDE.md +1 -1
  222. package/skills/highlight-reel-generator/src/index.ts +19 -0
  223. package/skills/hook/src/commands/create.ts +20 -845
  224. package/skills/hook/src/templates/root.ts +196 -0
  225. package/skills/hook/src/templates/source.ts +647 -0
  226. package/skills/http-server/package.json +3 -1
  227. package/skills/icon-pack/README.md +28 -0
  228. package/skills/icon-pack/SKILL.md +23 -0
  229. package/skills/icon-pack/package.json +29 -0
  230. package/skills/{audio → icon-pack}/tsconfig.json +10 -12
  231. package/skills/image/package.json +1 -2
  232. package/skills/implementation-agent/package.json +3 -1
  233. package/skills/implementation-agent/src/ai-generation.ts +225 -0
  234. package/skills/implementation-agent/src/index.ts +3 -960
  235. package/skills/implementation-agent/src/minimist.d.ts +15 -0
  236. package/skills/implementation-agent/src/templates.ts +686 -0
  237. package/skills/implementation-agent/src/types.ts +53 -0
  238. package/skills/implementation-plan/package.json +3 -1
  239. package/skills/implementation-todo/package.json +3 -1
  240. package/skills/invoice/package.json +1 -1
  241. package/skills/invoice/src/index.ts +3 -0
  242. package/skills/invoice-reconciliation/SKILL.md +42 -0
  243. package/skills/invoice-reconciliation/package.json +10 -0
  244. package/skills/landing-page-pack/SKILL.md +47 -0
  245. package/skills/landing-page-pack/package.json +14 -0
  246. package/skills/latex-table-generator/package.json +3 -1
  247. package/skills/logo-design/SKILL.md +25 -44
  248. package/skills/logo-design/package.json +3 -15
  249. package/skills/lorem-generator/package.json +3 -1
  250. package/skills/lorem-generator/src/index.ts +13 -0
  251. package/skills/managehook/package.json +1 -1
  252. package/skills/managehook/src/index.ts +3 -0
  253. package/skills/managemcp/package.json +1 -1
  254. package/skills/managemcp/src/index.ts +3 -0
  255. package/skills/manageskill/package.json +1 -1
  256. package/skills/manageskill/src/index.ts +3 -0
  257. package/skills/markdown-validator/package.json +3 -1
  258. package/skills/markdown-validator/src/index.ts +1 -4
  259. package/skills/market-research-report/SKILL.md +41 -0
  260. package/skills/market-research-report/package.json +10 -0
  261. package/skills/mcp-builder/package.json +4 -1
  262. package/skills/mcp-builder/src/ai-descriptions.ts +37 -0
  263. package/skills/mcp-builder/src/generators.ts +513 -0
  264. package/skills/mcp-builder/src/index.ts +7 -908
  265. package/skills/mcp-builder/src/minimist.d.ts +15 -0
  266. package/skills/mcp-builder/src/naming.ts +12 -0
  267. package/skills/mcp-builder/src/options.ts +170 -0
  268. package/skills/mcp-builder/src/templates.ts +149 -0
  269. package/skills/mcp-builder/src/types.ts +42 -0
  270. package/skills/meeting-pack/SKILL.md +43 -0
  271. package/skills/meeting-pack/package.json +10 -0
  272. package/skills/merge-pdfs/package.json +5 -1
  273. package/skills/migration-plan-pack/SKILL.md +45 -0
  274. package/skills/migration-plan-pack/package.json +10 -0
  275. package/skills/music/package.json +2 -3
  276. package/skills/music-album/SKILL.md +37 -0
  277. package/skills/music-album/package.json +10 -0
  278. package/skills/notion-manager/package.json +3 -1
  279. package/skills/npmpublish/CLAUDE.md +5 -8
  280. package/skills/npmpublish/README.md +5 -26
  281. package/skills/npmpublish/src/index.ts +9 -147
  282. package/skills/one-page-website/SKILL.md +46 -0
  283. package/skills/one-page-website/package.json +10 -0
  284. package/skills/one-page-website/tsconfig.json +8 -0
  285. package/skills/pdf-generate/src/cli.ts +162 -0
  286. package/skills/pdf-generate/src/html.ts +84 -0
  287. package/skills/pdf-generate/src/index.ts +11 -800
  288. package/skills/pdf-generate/src/markdown.ts +27 -0
  289. package/skills/pdf-generate/src/pdf-writer.ts +78 -0
  290. package/skills/pdf-generate/src/runtime.ts +34 -0
  291. package/skills/pdf-generate/src/security.ts +37 -0
  292. package/skills/pdf-generate/src/templates.ts +311 -0
  293. package/skills/pdf-generate/src/types.ts +28 -0
  294. package/skills/pdf-read/SKILL.md +10 -10
  295. package/skills/pdf-to-dataset/SKILL.md +45 -0
  296. package/skills/pdf-to-dataset/package.json +10 -0
  297. package/skills/pdf-to-markdown/SKILL.md +49 -0
  298. package/skills/pdf-to-markdown/package.json +10 -0
  299. package/skills/pdf-to-markdown/tsconfig.json +10 -0
  300. package/skills/performance-audit-report/SKILL.md +42 -0
  301. package/skills/performance-audit-report/package.json +10 -0
  302. package/skills/persona-based-adwriter/src/index.ts +19 -0
  303. package/skills/photo-album/SKILL.md +29 -0
  304. package/skills/photo-album/package.json +9 -0
  305. package/skills/photo-album/tsconfig.json +4 -0
  306. package/skills/pitch-deck/SKILL.md +43 -0
  307. package/skills/pitch-deck/package.json +9 -0
  308. package/skills/playlist-maker/SKILL.md +33 -0
  309. package/skills/playlist-maker/package.json +9 -0
  310. package/skills/playlist-maker/tsconfig.json +4 -0
  311. package/skills/product-mockup/SKILL.md +45 -0
  312. package/skills/product-mockup/package.json +3 -20
  313. package/skills/product-mockup/tsconfig.json +3 -5
  314. package/skills/project-retro-companion/src/index.ts +19 -0
  315. package/skills/proposal-pack/SKILL.md +45 -0
  316. package/skills/proposal-pack/package.json +10 -0
  317. package/skills/read-pdf/SKILL.md +5 -4
  318. package/skills/repo-onboarding-report/SKILL.md +42 -0
  319. package/skills/repo-onboarding-report/package.json +10 -0
  320. package/skills/sales-call-recapper/src/index.ts +20 -0
  321. package/skills/salescopy/package.json +1 -1
  322. package/skills/salescopy/src/index.ts +3 -0
  323. package/skills/scaffold-project/src/ai-detect.ts +136 -0
  324. package/skills/scaffold-project/src/file-generators.ts +292 -0
  325. package/skills/scaffold-project/src/index.ts +8 -991
  326. package/skills/scaffold-project/src/project-config.ts +338 -0
  327. package/skills/scaffold-project/src/templates.ts +173 -0
  328. package/skills/scaffold-project/src/types.ts +58 -0
  329. package/skills/scientific-figure-check/package.json +3 -1
  330. package/skills/sdk-generator/SKILL.md +45 -0
  331. package/skills/sdk-generator/package.json +10 -0
  332. package/skills/sdk-generator/tsconfig.json +8 -0
  333. package/skills/security-audit/src/index.ts +25 -6
  334. package/skills/security-audit-report/SKILL.md +40 -0
  335. package/skills/security-audit-report/package.json +10 -0
  336. package/skills/seo-content-pack/SKILL.md +44 -0
  337. package/skills/seo-content-pack/package.json +9 -0
  338. package/skills/short-video-pack/SKILL.md +30 -0
  339. package/skills/short-video-pack/package.json +10 -0
  340. package/skills/slack-assistant/package.json +3 -1
  341. package/skills/slide-deck-generator/SKILL.md +44 -0
  342. package/skills/slide-deck-generator/package.json +10 -0
  343. package/skills/sms/package.json +1 -1
  344. package/skills/sms/src/index.ts +15 -0
  345. package/skills/social-content-calendar/SKILL.md +45 -0
  346. package/skills/social-content-calendar/package.json +14 -0
  347. package/skills/split-pdf/package.json +4 -1
  348. package/skills/subtitle/package.json +2 -1
  349. package/skills/subtitle/src/index.ts +3 -0
  350. package/skills/terraform-generator/package.json +3 -1
  351. package/skills/test-suite-generator/SKILL.md +41 -0
  352. package/skills/test-suite-generator/package.json +10 -0
  353. package/skills/timesheet/package.json +1 -1
  354. package/skills/timesheet/src/index.ts +3 -0
  355. package/skills/transcript/SKILL.md +1 -8
  356. package/skills/validate-config/package.json +3 -1
  357. package/skills/video/package.json +6 -4
  358. package/skills/video-downloader/package.json +3 -1
  359. package/skills/video-highlight-pack/SKILL.md +44 -0
  360. package/skills/video-highlight-pack/package.json +10 -0
  361. package/skills/voiceover-jingle-pack/SKILL.md +28 -0
  362. package/skills/voiceover-jingle-pack/package.json +10 -0
  363. package/skills/watermark/package.json +6 -1
  364. package/skills/webcrawling/package.json +2 -1
  365. package/skills/write/SKILL.md +6 -6
  366. package/dist/server/serve.d.ts +0 -11
  367. package/skills/apidocs/.claude/settings.json +0 -5
  368. package/skills/audio/.env.example +0 -14
  369. package/skills/audio/QUICKSTART.md +0 -158
  370. package/skills/audio/README.md +0 -256
  371. package/skills/audio/src/index-local.ts +0 -206
  372. package/skills/audio/src/index.ts +0 -95
  373. package/skills/audio/src/providers/elevenlabs.ts +0 -115
  374. package/skills/audio/src/providers/google.ts +0 -116
  375. package/skills/audio/src/providers/minimax.ts +0 -83
  376. package/skills/audio/src/providers/openai.ts +0 -115
  377. package/skills/audio/src/types.ts +0 -79
  378. package/skills/audiobook-chapter-proofer/CLAUDE.md +0 -19
  379. package/skills/audiobook-chapter-proofer/package.json +0 -27
  380. package/skills/audiobook-chapter-proofer/src/index.ts +0 -285
  381. package/skills/browse/src/client.ts +0 -373
  382. package/skills/browse/src/index-local.ts +0 -430
  383. package/skills/browse/src/index.ts +0 -110
  384. package/skills/browse/src/sse-server.ts +0 -919
  385. package/skills/browse/src/types.ts +0 -104
  386. package/skills/consolelog/src/server/index.ts +0 -508
  387. package/skills/create-blog-article/CLAUDE.md +0 -19
  388. package/skills/create-blog-article/src/index.ts +0 -745
  389. package/skills/create-blog-article/tsconfig.json +0 -10
  390. package/skills/deepresearch/src/agents/query-generator.ts +0 -91
  391. package/skills/deepresearch/src/agents/synthesizer.ts +0 -111
  392. package/skills/deepresearch/src/index.ts +0 -224
  393. package/skills/deepresearch/src/research.ts +0 -166
  394. package/skills/deepresearch/src/services/anthropic.ts +0 -69
  395. package/skills/deepresearch/src/services/exa.ts +0 -108
  396. package/skills/deepresearch/src/services/firecrawl.ts +0 -88
  397. package/skills/deepresearch/src/services/openai.ts +0 -81
  398. package/skills/deepresearch/src/types.ts +0 -76
  399. package/skills/deepresearch/src/utils/file.ts +0 -111
  400. package/skills/deepresearch/src/utils/logger.ts +0 -84
  401. package/skills/domainpurchase/src/server/index.ts +0 -332
  402. package/skills/domainsearch/src/server/index.ts +0 -229
  403. package/skills/e2bswarm/README.md +0 -135
  404. package/skills/e2bswarm/SKILL.md +0 -118
  405. package/skills/e2bswarm/examples/tasks-example.json +0 -38
  406. package/skills/e2bswarm/package.json +0 -59
  407. package/skills/e2bswarm/src/commands/collect.ts +0 -135
  408. package/skills/e2bswarm/src/commands/install.ts +0 -164
  409. package/skills/e2bswarm/src/commands/kill.ts +0 -62
  410. package/skills/e2bswarm/src/commands/spawn.ts +0 -134
  411. package/skills/e2bswarm/src/commands/status.ts +0 -90
  412. package/skills/e2bswarm/src/commands/sync.ts +0 -208
  413. package/skills/e2bswarm/src/index.ts +0 -121
  414. package/skills/e2bswarm/src/lib/config.ts +0 -75
  415. package/skills/e2bswarm/src/lib/e2b.ts +0 -490
  416. package/skills/e2bswarm/src/lib/github.ts +0 -253
  417. package/skills/e2bswarm/src/lib/logger.ts +0 -41
  418. package/skills/e2bswarm/src/lib/paths.ts +0 -75
  419. package/skills/e2bswarm/src/lib/tasks.ts +0 -320
  420. package/skills/e2bswarm/src/types/index.ts +0 -107
  421. package/skills/e2bswarm/templates/codebox/e2b.Dockerfile +0 -38
  422. package/skills/e2bswarm/templates/codebox/e2b.toml +0 -3
  423. package/skills/e2bswarm/templates/setup.sh +0 -21
  424. package/skills/e2bswarm/tsconfig.json +0 -19
  425. package/skills/generate-book-cover/src/index.ts +0 -694
  426. package/skills/image/src/index-local.ts +0 -206
  427. package/skills/image/src/index.ts +0 -96
  428. package/skills/image/src/providers/google.ts +0 -79
  429. package/skills/image/src/providers/minimax.ts +0 -94
  430. package/skills/image/src/providers/openai.ts +0 -80
  431. package/skills/image/src/providers/xai.ts +0 -73
  432. package/skills/image/src/types.ts +0 -37
  433. package/skills/logo-design/CLAUDE.md +0 -30
  434. package/skills/logo-design/src/index.ts +0 -322
  435. package/skills/managehook/src/server/index.ts +0 -108
  436. package/skills/managemcp/src/server/index.ts +0 -108
  437. package/skills/manageskill/src/server/index.ts +0 -108
  438. package/skills/music/CLAUDE.md +0 -9
  439. package/skills/music/src/index.ts +0 -94
  440. package/skills/music/tsconfig.json +0 -10
  441. package/skills/pdf-read/src/index.ts +0 -320
  442. package/skills/product-mockup/CLAUDE.md +0 -19
  443. package/skills/product-mockup/src/index.ts +0 -290
  444. package/skills/read-pdf/src/index.ts +0 -388
  445. package/skills/remove-background/src/index.ts +0 -405
  446. package/skills/scaffold-project/my-app/.env.example +0 -2
  447. package/skills/scaffold-project/my-app/README.md +0 -72
  448. package/skills/scaffold-project/my-app/package.json +0 -29
  449. package/skills/scaffold-project/my-app/src/index.ts +0 -23
  450. package/skills/scaffold-project/my-app/tsconfig.json +0 -33
  451. package/skills/sound-effects/SKILL.md +0 -34
  452. package/skills/sound-effects/package.json +0 -21
  453. package/skills/sound-effects/src/index.ts +0 -172
  454. package/skills/sound-effects/tsconfig.json +0 -8
  455. package/skills/transcript/src/chunker.ts +0 -215
  456. package/skills/transcript/src/formatter.ts +0 -134
  457. package/skills/transcript/src/index-local.ts +0 -226
  458. package/skills/transcript/src/index.ts +0 -110
  459. package/skills/transcript/src/providers/elevenlabs.ts +0 -133
  460. package/skills/transcript/src/providers/gemini.ts +0 -192
  461. package/skills/transcript/src/providers/index.ts +0 -54
  462. package/skills/transcript/src/providers/openai.ts +0 -203
  463. package/skills/transcript/src/types.ts +0 -106
  464. package/skills/video/.env.example +0 -14
  465. package/skills/video/EXAMPLES.md +0 -266
  466. package/skills/video/LICENSE +0 -192
  467. package/skills/video/README.md +0 -174
  468. package/skills/video/src/cli.ts +0 -155
  469. package/skills/video/src/index-local.ts +0 -148
  470. package/skills/video/src/index.ts +0 -96
  471. package/skills/video/src/providers/google-veo.ts +0 -126
  472. package/skills/video/src/providers/index.ts +0 -22
  473. package/skills/video/src/providers/minimax.ts +0 -100
  474. package/skills/video/src/providers/openai-sora.ts +0 -164
  475. package/skills/video/src/providers/runway.ts +0 -159
  476. package/skills/video/src/types.ts +0 -35
  477. package/skills/video/tsconfig.json +0 -22
  478. package/skills/voiceover-casting-assistant/CLAUDE.md +0 -19
  479. package/skills/voiceover-casting-assistant/package.json +0 -27
  480. package/skills/voiceover-casting-assistant/src/index.ts +0 -255
  481. package/skills/voiceover-casting-assistant/tsconfig.json +0 -10
  482. package/skills/webcrawling/src/commands/config.ts +0 -34
  483. package/skills/webcrawling/src/commands/crawl.ts +0 -33
  484. package/skills/webcrawling/src/commands/scrape.ts +0 -32
  485. package/skills/webcrawling/src/commands/sessions.ts +0 -42
  486. package/skills/webcrawling/src/lib/crawler.ts +0 -174
  487. package/skills/webcrawling/src/lib/storage.ts +0 -130
  488. package/skills/webcrawling/src/types/index.ts +0 -45
  489. package/skills/webcrawling/src/utils/logger.ts +0 -30
  490. package/skills/webcrawling/src/utils/paths.ts +0 -28
  491. /package/skills/{audiobook-chapter-proofer → blog-article}/tsconfig.json +0 -0
@@ -5,782 +5,10 @@
5
5
  */
6
6
 
7
7
  import { parseArgs } from "util";
8
- import { mkdirSync, writeFileSync, appendFileSync, existsSync, readFileSync } from "fs";
9
- import { join, basename, extname, dirname } from "path";
10
- import { randomUUID } from "crypto";
11
- import * as yaml from "yaml";
8
+ import { join } from "path";
9
+ import { generateApiClient } from "./generator";
10
+ import { LOGS_DIR, SESSION_ID, SESSION_TIMESTAMP, log } from "./logger";
12
11
 
13
- // Types
14
- interface GenerateOptions {
15
- specPath: string;
16
- language: "typescript" | "javascript" | "python";
17
- client: "fetch" | "axios" | "ky" | "requests";
18
- output?: string;
19
- auth: "bearer" | "apikey" | "oauth2" | "basic" | "none";
20
- style: "modular" | "class" | "functional";
21
- async: boolean;
22
- sync: boolean;
23
- baseUrl?: string;
24
- name?: string;
25
- typesOnly: boolean;
26
- }
27
-
28
- interface OpenAPISpec {
29
- openapi?: string;
30
- swagger?: string;
31
- info: {
32
- title: string;
33
- version: string;
34
- description?: string;
35
- };
36
- servers?: Array<{ url: string }>;
37
- paths: Record<string, Record<string, PathItem>>;
38
- components?: {
39
- schemas?: Record<string, SchemaObject>;
40
- securitySchemes?: Record<string, SecurityScheme>;
41
- };
42
- }
43
-
44
- interface PathItem {
45
- summary?: string;
46
- description?: string;
47
- parameters?: Parameter[];
48
- requestBody?: RequestBody;
49
- responses?: Record<string, Response>;
50
- security?: Array<Record<string, string[]>>;
51
- }
52
-
53
- interface Parameter {
54
- name: string;
55
- in: "path" | "query" | "header" | "cookie";
56
- required?: boolean;
57
- schema?: SchemaObject;
58
- description?: string;
59
- }
60
-
61
- interface RequestBody {
62
- required?: boolean;
63
- content?: Record<string, { schema?: SchemaObject }>;
64
- }
65
-
66
- interface Response {
67
- description?: string;
68
- content?: Record<string, { schema?: SchemaObject }>;
69
- }
70
-
71
- interface SchemaObject {
72
- type?: string;
73
- properties?: Record<string, SchemaObject>;
74
- items?: SchemaObject;
75
- required?: string[];
76
- enum?: Array<string | number>;
77
- $ref?: string;
78
- description?: string;
79
- nullable?: boolean;
80
- format?: string;
81
- }
82
-
83
- interface SecurityScheme {
84
- type: string;
85
- scheme?: string;
86
- bearerFormat?: string;
87
- in?: string;
88
- name?: string;
89
- }
90
-
91
- // Constants
92
- const SKILL_NAME = "generate-api-client";
93
- const SESSION_ID = randomUUID().slice(0, 8);
94
-
95
- // Use SKILLS_OUTPUT_DIR from CLI if available, otherwise fall back to cwd
96
- const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
97
- const EXPORTS_DIR = join(SKILLS_OUTPUT_DIR, "exports", SKILL_NAME);
98
- const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
99
-
100
- // Ensure directories exist
101
- function ensureDir(dir: string) {
102
- if (!existsSync(dir)) {
103
- mkdirSync(dir, { recursive: true });
104
- }
105
- }
106
-
107
- // Session timestamp for log filename
108
- const SESSION_TIMESTAMP = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
109
-
110
- // Logger
111
- function log(message: string, level: "info" | "error" | "success" | "warn" = "info") {
112
- const timestamp = new Date().toISOString();
113
- const logFile = join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`);
114
-
115
- ensureDir(LOGS_DIR);
116
-
117
- const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
118
- appendFileSync(logFile, logEntry);
119
-
120
- const prefix = level === "error" ? "āŒ" : level === "success" ? "āœ…" : level === "warn" ? "āš ļø" : "ā„¹ļø";
121
- console.log(`${prefix} ${message}`);
122
- }
123
-
124
- // Load OpenAPI spec from URL or file
125
- async function loadSpec(specPath: string): Promise<OpenAPISpec> {
126
- log(`Loading OpenAPI spec from: ${specPath}`);
127
-
128
- let content: string;
129
-
130
- if (specPath.startsWith("http://") || specPath.startsWith("https://")) {
131
- log("Fetching spec from URL...");
132
- const response = await fetch(specPath);
133
- if (!response.ok) {
134
- throw new Error(`Failed to fetch spec: ${response.statusText}`);
135
- }
136
- content = await response.text();
137
- } else {
138
- log("Reading spec from local file...");
139
- if (!existsSync(specPath)) {
140
- throw new Error(`Spec file not found: ${specPath}`);
141
- }
142
- content = readFileSync(specPath, "utf-8");
143
- }
144
-
145
- const ext = extname(specPath).toLowerCase();
146
- let spec: OpenAPISpec;
147
-
148
- if (ext === ".yaml" || ext === ".yml" || content.trim().startsWith("openapi:") || content.trim().startsWith("swagger:")) {
149
- log("Parsing YAML spec...");
150
- spec = yaml.parse(content);
151
- } else {
152
- log("Parsing JSON spec...");
153
- spec = JSON.parse(content);
154
- }
155
-
156
- // Validate spec
157
- if (!spec.openapi && !spec.swagger) {
158
- throw new Error("Invalid OpenAPI/Swagger specification: missing version field");
159
- }
160
-
161
- if (!spec.info?.title) {
162
- throw new Error("Invalid OpenAPI/Swagger specification: missing info.title");
163
- }
164
-
165
- log(`Loaded spec: ${spec.info.title} v${spec.info.version}`, "success");
166
- return spec;
167
- }
168
-
169
- // Convert OpenAPI type to TypeScript type
170
- function openApiTypeToTS(schema: SchemaObject | undefined, refs: Record<string, SchemaObject> = {}): string {
171
- if (!schema) return "any";
172
-
173
- if (schema.$ref) {
174
- const refName = schema.$ref.split("/").pop() || "any";
175
- return refName;
176
- }
177
-
178
- if (schema.enum) {
179
- return schema.enum.map(v => typeof v === "string" ? `"${v}"` : v).join(" | ");
180
- }
181
-
182
- const baseType = (() => {
183
- switch (schema.type) {
184
- case "string":
185
- if (schema.format === "date-time") return "Date | string";
186
- if (schema.format === "date") return "Date | string";
187
- return "string";
188
- case "number":
189
- case "integer":
190
- return "number";
191
- case "boolean":
192
- return "boolean";
193
- case "array":
194
- return `Array<${openApiTypeToTS(schema.items, refs)}>`;
195
- case "object":
196
- if (!schema.properties) return "Record<string, any>";
197
- const props = Object.entries(schema.properties).map(([key, prop]) => {
198
- const optional = !schema.required?.includes(key) ? "?" : "";
199
- return ` ${key}${optional}: ${openApiTypeToTS(prop, refs)};`;
200
- }).join("\n");
201
- return `{\n${props}\n}`;
202
- default:
203
- return "any";
204
- }
205
- })();
206
-
207
- return schema.nullable ? `${baseType} | null` : baseType;
208
- }
209
-
210
- // Convert OpenAPI type to Python type
211
- function openApiTypeToPython(schema: SchemaObject | undefined): string {
212
- if (!schema) return "Any";
213
-
214
- if (schema.$ref) {
215
- const refName = schema.$ref.split("/").pop() || "Any";
216
- return refName;
217
- }
218
-
219
- if (schema.enum) {
220
- return "Literal[" + schema.enum.map(v => typeof v === "string" ? `"${v}"` : v).join(", ") + "]";
221
- }
222
-
223
- const baseType = (() => {
224
- switch (schema.type) {
225
- case "string":
226
- if (schema.format === "date-time") return "datetime";
227
- if (schema.format === "date") return "date";
228
- return "str";
229
- case "number":
230
- return "float";
231
- case "integer":
232
- return "int";
233
- case "boolean":
234
- return "bool";
235
- case "array":
236
- return `List[${openApiTypeToPython(schema.items)}]`;
237
- case "object":
238
- if (!schema.properties) return "Dict[str, Any]";
239
- return "dict"; // For complex objects, we'll generate Pydantic models separately
240
- default:
241
- return "Any";
242
- }
243
- })();
244
-
245
- return schema.nullable ? `Optional[${baseType}]` : baseType;
246
- }
247
-
248
- // Generate TypeScript types
249
- function generateTypeScriptTypes(spec: OpenAPISpec): string {
250
- let output = "// Generated types from OpenAPI specification\n\n";
251
-
252
- if (!spec.components?.schemas) {
253
- return output + "export type EmptyTypes = Record<string, never>;\n";
254
- }
255
-
256
- // Generate interfaces for each schema
257
- for (const [name, schema] of Object.entries(spec.components.schemas)) {
258
- if (schema.description) {
259
- output += `/**\n * ${schema.description}\n */\n`;
260
- }
261
- output += `export interface ${name} ${openApiTypeToTS(schema, spec.components.schemas)}\n\n`;
262
- }
263
-
264
- return output;
265
- }
266
-
267
- // Generate TypeScript fetch client
268
- function generateTypeScriptFetchClient(spec: OpenAPISpec, options: GenerateOptions): Record<string, string> {
269
- const files: Record<string, string> = {};
270
- const clientName = options.name || spec.info.title.replace(/[^a-zA-Z0-9]/g, "") + "Client";
271
- const baseUrl = options.baseUrl || spec.servers?.[0]?.url || "";
272
-
273
- // Generate types file
274
- files["types.ts"] = generateTypeScriptTypes(spec);
275
-
276
- // Generate config file
277
- let configContent = `// API Client Configuration\n\n`;
278
- configContent += `export interface ApiConfig {\n`;
279
- configContent += ` baseURL?: string;\n`;
280
- configContent += ` timeout?: number;\n`;
281
- configContent += ` headers?: Record<string, string>;\n`;
282
-
283
- if (options.auth !== "none") {
284
- configContent += ` auth?: {\n`;
285
- configContent += ` type: "${options.auth}";\n`;
286
- if (options.auth === "bearer") {
287
- configContent += ` token: string;\n`;
288
- } else if (options.auth === "apikey") {
289
- configContent += ` key: string;\n`;
290
- configContent += ` header?: string;\n`;
291
- }
292
- configContent += ` };\n`;
293
- }
294
-
295
- configContent += `}\n\n`;
296
- configContent += `export const defaultConfig: ApiConfig = {\n`;
297
- configContent += ` baseURL: "${baseUrl}",\n`;
298
- configContent += ` timeout: 30000,\n`;
299
- configContent += ` headers: {\n`;
300
- configContent += ` "Content-Type": "application/json",\n`;
301
- configContent += ` },\n`;
302
- configContent += `};\n`;
303
-
304
- files["config.ts"] = configContent;
305
-
306
- // Generate main client file based on style
307
- if (options.style === "class") {
308
- let clientContent = `// ${clientName}\n`;
309
- clientContent += `import type { ApiConfig } from "./config";\n`;
310
- clientContent += `import { defaultConfig } from "./config";\n\n`;
311
-
312
- clientContent += `export class ${clientName} {\n`;
313
- clientContent += ` private config: ApiConfig;\n\n`;
314
- clientContent += ` constructor(config: Partial<ApiConfig> = {}) {\n`;
315
- clientContent += ` this.config = { ...defaultConfig, ...config };\n`;
316
- clientContent += ` }\n\n`;
317
-
318
- clientContent += ` private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n`;
319
- clientContent += ` const url = \`\${this.config.baseURL}\${path}\`;\n`;
320
- clientContent += ` const headers = { ...this.config.headers, ...options.headers };\n\n`;
321
-
322
- if (options.auth === "bearer") {
323
- clientContent += ` if (this.config.auth?.type === "bearer") {\n`;
324
- clientContent += ` headers["Authorization"] = \`Bearer \${this.config.auth.token}\`;\n`;
325
- clientContent += ` }\n\n`;
326
- }
327
-
328
- clientContent += ` const response = await fetch(url, { ...options, headers });\n\n`;
329
- clientContent += ` if (!response.ok) {\n`;
330
- clientContent += ` throw new Error(\`API Error: \${response.status} \${response.statusText}\`);\n`;
331
- clientContent += ` }\n\n`;
332
- clientContent += ` return response.json();\n`;
333
- clientContent += ` }\n\n`;
334
-
335
- // Generate methods for each endpoint
336
- for (const [path, methods] of Object.entries(spec.paths)) {
337
- for (const [method, operation] of Object.entries(methods)) {
338
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
339
-
340
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "") ||
341
- `${method}${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "")}`;
342
- const lowerMethodName = methodName.charAt(0).toLowerCase() + methodName.slice(1);
343
-
344
- clientContent += ` /**\n`;
345
- clientContent += ` * ${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}\n`;
346
- clientContent += ` */\n`;
347
- clientContent += ` async ${lowerMethodName}(`;
348
-
349
- // Add parameters
350
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
351
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
352
- const hasBody = operation.requestBody && method !== "get";
353
-
354
- if (pathParams.length > 0 || queryParams.length > 0 || hasBody) {
355
- clientContent += `params: {\n`;
356
- pathParams.forEach(p => {
357
- clientContent += ` ${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)};\n`;
358
- });
359
- queryParams.forEach(p => {
360
- clientContent += ` ${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)};\n`;
361
- });
362
- if (hasBody) {
363
- clientContent += ` body?: any;\n`;
364
- }
365
- clientContent += ` }`;
366
- }
367
-
368
- clientContent += `): Promise<any> {\n`;
369
-
370
- // Build URL with path params
371
- clientContent += ` let path = "${path}";\n`;
372
- pathParams.forEach(p => {
373
- clientContent += ` path = path.replace("{${p.name}}", String(params.${p.name}));\n`;
374
- });
375
-
376
- // Add query params
377
- if (queryParams.length > 0) {
378
- clientContent += ` const queryParams = new URLSearchParams();\n`;
379
- queryParams.forEach(p => {
380
- clientContent += ` if (params.${p.name} !== undefined) queryParams.append("${p.name}", String(params.${p.name}));\n`;
381
- });
382
- clientContent += ` if (queryParams.toString()) path += \`?\${queryParams.toString()}\`;\n`;
383
- }
384
-
385
- // Make request
386
- clientContent += ` return this.request(path, {\n`;
387
- clientContent += ` method: "${method.toUpperCase()}",\n`;
388
- if (hasBody) {
389
- clientContent += ` body: JSON.stringify(params.body),\n`;
390
- }
391
- clientContent += ` });\n`;
392
- clientContent += ` }\n\n`;
393
- }
394
- }
395
-
396
- clientContent += `}\n`;
397
- files["client.ts"] = clientContent;
398
-
399
- } else if (options.style === "modular") {
400
- // Generate modular exports
401
- let indexContent = `// ${clientName} - Modular API\n`;
402
- indexContent += `import type { ApiConfig } from "./config";\n`;
403
- indexContent += `import { defaultConfig } from "./config";\n\n`;
404
-
405
- indexContent += `let config: ApiConfig = defaultConfig;\n\n`;
406
- indexContent += `export function configure(newConfig: Partial<ApiConfig>) {\n`;
407
- indexContent += ` config = { ...config, ...newConfig };\n`;
408
- indexContent += `}\n\n`;
409
-
410
- indexContent += `async function request<T>(path: string, options: RequestInit = {}): Promise<T> {\n`;
411
- indexContent += ` const url = \`\${config.baseURL}\${path}\`;\n`;
412
- indexContent += ` const headers = { ...config.headers, ...options.headers };\n\n`;
413
-
414
- if (options.auth === "bearer") {
415
- indexContent += ` if (config.auth?.type === "bearer") {\n`;
416
- indexContent += ` headers["Authorization"] = \`Bearer \${config.auth.token}\`;\n`;
417
- indexContent += ` }\n\n`;
418
- }
419
-
420
- indexContent += ` const response = await fetch(url, { ...options, headers });\n\n`;
421
- indexContent += ` if (!response.ok) {\n`;
422
- indexContent += ` throw new Error(\`API Error: \${response.status} \${response.statusText}\`);\n`;
423
- indexContent += ` }\n\n`;
424
- indexContent += ` return response.json();\n`;
425
- indexContent += `}\n\n`;
426
-
427
- // Generate function exports
428
- for (const [path, methods] of Object.entries(spec.paths)) {
429
- for (const [method, operation] of Object.entries(methods)) {
430
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
431
-
432
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "") ||
433
- `${method}${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "")}`;
434
- const lowerMethodName = methodName.charAt(0).toLowerCase() + methodName.slice(1);
435
-
436
- indexContent += `/**\n * ${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}\n */\n`;
437
- indexContent += `export async function ${lowerMethodName}(`;
438
-
439
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
440
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
441
- const hasBody = operation.requestBody && method !== "get";
442
-
443
- if (pathParams.length > 0 || queryParams.length > 0 || hasBody) {
444
- indexContent += `params: { `;
445
- pathParams.forEach(p => {
446
- indexContent += `${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)}; `;
447
- });
448
- queryParams.forEach(p => {
449
- indexContent += `${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)}; `;
450
- });
451
- if (hasBody) {
452
- indexContent += `body?: any; `;
453
- }
454
- indexContent += `}`;
455
- }
456
-
457
- indexContent += `): Promise<any> {\n`;
458
- indexContent += ` let path = "${path}";\n`;
459
-
460
- pathParams.forEach(p => {
461
- indexContent += ` path = path.replace("{${p.name}}", String(params.${p.name}));\n`;
462
- });
463
-
464
- if (queryParams.length > 0) {
465
- indexContent += ` const queryParams = new URLSearchParams();\n`;
466
- queryParams.forEach(p => {
467
- indexContent += ` if (params.${p.name} !== undefined) queryParams.append("${p.name}", String(params.${p.name}));\n`;
468
- });
469
- indexContent += ` if (queryParams.toString()) path += \`?\${queryParams.toString()}\`;\n`;
470
- }
471
-
472
- indexContent += ` return request(path, { method: "${method.toUpperCase()}"`;
473
- if (hasBody) {
474
- indexContent += `, body: JSON.stringify(params.body)`;
475
- }
476
- indexContent += ` });\n`;
477
- indexContent += `}\n\n`;
478
- }
479
- }
480
-
481
- files["index.ts"] = indexContent;
482
- }
483
-
484
- // Generate README
485
- let readme = `# ${spec.info.title} API Client\n\n`;
486
- readme += `${spec.info.description || "Generated API client"}\n\n`;
487
- readme += `## Installation\n\n\`\`\`bash\nnpm install\n\`\`\`\n\n`;
488
- readme += `## Usage\n\n`;
489
-
490
- if (options.style === "class") {
491
- readme += `\`\`\`typescript\nimport { ${clientName} } from "./client";\n\n`;
492
- readme += `const client = new ${clientName}({\n`;
493
- readme += ` baseURL: "${baseUrl}",\n`;
494
- if (options.auth === "bearer") {
495
- readme += ` auth: { type: "bearer", token: "your-token" },\n`;
496
- }
497
- readme += `});\n\n`;
498
- readme += `// Use the client\nconst data = await client.someMethod();\n\`\`\`\n`;
499
- } else {
500
- readme += `\`\`\`typescript\nimport { configure } from "./index";\n\n`;
501
- readme += `configure({\n`;
502
- readme += ` baseURL: "${baseUrl}",\n`;
503
- if (options.auth === "bearer") {
504
- readme += ` auth: { type: "bearer", token: "your-token" },\n`;
505
- }
506
- readme += `});\n\`\`\`\n`;
507
- }
508
-
509
- files["README.md"] = readme;
510
-
511
- return files;
512
- }
513
-
514
- // Generate Python client
515
- function generatePythonClient(spec: OpenAPISpec, options: GenerateOptions): Record<string, string> {
516
- const files: Record<string, string> = {};
517
- const clientName = options.name || spec.info.title.replace(/[^a-zA-Z0-9]/g, "");
518
- const className = clientName.charAt(0).toUpperCase() + clientName.slice(1) + "Client";
519
- const baseUrl = options.baseUrl || spec.servers?.[0]?.url || "";
520
-
521
- // Generate __init__.py
522
- files["__init__.py"] = `"""${spec.info.title} API Client"""\n\nfrom .client import ${className}\n\n__all__ = ["${className}"]\n`;
523
-
524
- // Generate models.py with Pydantic
525
- let modelsContent = `"""Pydantic models for ${spec.info.title}"""\n\n`;
526
- modelsContent += `from typing import Any, Optional, List, Dict\n`;
527
- modelsContent += `from datetime import datetime, date\n`;
528
- modelsContent += `from pydantic import BaseModel\n\n`;
529
-
530
- if (spec.components?.schemas) {
531
- for (const [name, schema] of Object.entries(spec.components.schemas)) {
532
- if (schema.description) {
533
- modelsContent += `class ${name}(BaseModel):\n`;
534
- modelsContent += ` """${schema.description}"""\n`;
535
- } else {
536
- modelsContent += `class ${name}(BaseModel):\n`;
537
- }
538
-
539
- if (schema.properties) {
540
- for (const [propName, propSchema] of Object.entries(schema.properties)) {
541
- const required = schema.required?.includes(propName);
542
- const pyType = openApiTypeToPython(propSchema);
543
- modelsContent += ` ${propName}: ${required ? pyType : `Optional[${pyType}]`}${required ? "" : " = None"}\n`;
544
- }
545
- } else {
546
- modelsContent += ` pass\n`;
547
- }
548
- modelsContent += `\n`;
549
- }
550
- }
551
-
552
- files["models.py"] = modelsContent;
553
-
554
- // Generate client.py
555
- let clientContent = `"""${spec.info.title} API Client"""\n\n`;
556
- clientContent += `from typing import Any, Optional, Dict\n`;
557
- clientContent += `import requests\n`;
558
- if (options.async) {
559
- clientContent += `import aiohttp\n`;
560
- }
561
- clientContent += `\n`;
562
-
563
- clientContent += `class ${className}:\n`;
564
- clientContent += ` """API client for ${spec.info.title}"""\n\n`;
565
- clientContent += ` def __init__(self, base_url: str = "${baseUrl}", `;
566
-
567
- if (options.auth === "bearer") {
568
- clientContent += `token: Optional[str] = None, `;
569
- } else if (options.auth === "apikey") {
570
- clientContent += `api_key: Optional[str] = None, `;
571
- }
572
-
573
- clientContent += `timeout: int = 30):\n`;
574
- clientContent += ` self.base_url = base_url\n`;
575
- clientContent += ` self.timeout = timeout\n`;
576
-
577
- if (options.auth === "bearer") {
578
- clientContent += ` self.token = token\n`;
579
- } else if (options.auth === "apikey") {
580
- clientContent += ` self.api_key = api_key\n`;
581
- }
582
-
583
- clientContent += ` self.session = requests.Session()\n`;
584
- clientContent += ` self._setup_headers()\n\n`;
585
-
586
- clientContent += ` def _setup_headers(self) -> None:\n`;
587
- clientContent += ` """Setup default headers"""\n`;
588
- clientContent += ` self.session.headers.update({"Content-Type": "application/json"})\n`;
589
-
590
- if (options.auth === "bearer") {
591
- clientContent += ` if self.token:\n`;
592
- clientContent += ` self.session.headers.update({"Authorization": f"Bearer {self.token}"})\n`;
593
- }
594
-
595
- clientContent += `\n`;
596
-
597
- // Add sync request method
598
- if (options.sync) {
599
- clientContent += ` def _request(self, method: str, path: str, **kwargs) -> Any:\n`;
600
- clientContent += ` """Make HTTP request"""\n`;
601
- clientContent += ` url = f"{self.base_url}{path}"\n`;
602
- clientContent += ` response = self.session.request(method, url, timeout=self.timeout, **kwargs)\n`;
603
- clientContent += ` response.raise_for_status()\n`;
604
- clientContent += ` return response.json()\n\n`;
605
- }
606
-
607
- // Add async request method
608
- if (options.async) {
609
- clientContent += ` async def _request_async(self, method: str, path: str, **kwargs) -> Any:\n`;
610
- clientContent += ` """Make async HTTP request"""\n`;
611
- clientContent += ` url = f"{self.base_url}{path}"\n`;
612
- clientContent += ` async with aiohttp.ClientSession() as session:\n`;
613
- clientContent += ` async with session.request(method, url, timeout=self.timeout, **kwargs) as response:\n`;
614
- clientContent += ` response.raise_for_status()\n`;
615
- clientContent += ` return await response.json()\n\n`;
616
- }
617
-
618
- // Generate methods for endpoints
619
- for (const [path, methods] of Object.entries(spec.paths)) {
620
- for (const [method, operation] of Object.entries(methods)) {
621
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
622
-
623
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "").toLowerCase() ||
624
- `${method}_${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "").toLowerCase()}`;
625
-
626
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
627
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
628
- const hasBody = operation.requestBody && method !== "get";
629
-
630
- // Sync version
631
- if (options.sync) {
632
- clientContent += ` def ${methodName}(self`;
633
-
634
- pathParams.forEach(p => {
635
- clientContent += `, ${p.name}: ${openApiTypeToPython(p.schema)}`;
636
- });
637
-
638
- queryParams.forEach(p => {
639
- const pyType = openApiTypeToPython(p.schema);
640
- clientContent += `, ${p.name}: ${p.required ? pyType : `Optional[${pyType}]`}${p.required ? "" : " = None"}`;
641
- });
642
-
643
- if (hasBody) {
644
- clientContent += `, data: Optional[Dict[str, Any]] = None`;
645
- }
646
-
647
- clientContent += `) -> Any:\n`;
648
- clientContent += ` """${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}"""\n`;
649
- clientContent += ` path = "${path}"\n`;
650
-
651
- pathParams.forEach(p => {
652
- clientContent += ` path = path.replace("{${p.name}}", str(${p.name}))\n`;
653
- });
654
-
655
- if (queryParams.length > 0) {
656
- clientContent += ` params = {}\n`;
657
- queryParams.forEach(p => {
658
- clientContent += ` if ${p.name} is not None:\n`;
659
- clientContent += ` params["${p.name}"] = ${p.name}\n`;
660
- });
661
- clientContent += ` return self._request("${method.toUpperCase()}", path, params=params`;
662
- } else {
663
- clientContent += ` return self._request("${method.toUpperCase()}", path`;
664
- }
665
-
666
- if (hasBody) {
667
- clientContent += `, json=data`;
668
- }
669
-
670
- clientContent += `)\n\n`;
671
- }
672
-
673
- // Async version
674
- if (options.async) {
675
- clientContent += ` async def ${methodName}_async(self`;
676
-
677
- pathParams.forEach(p => {
678
- clientContent += `, ${p.name}: ${openApiTypeToPython(p.schema)}`;
679
- });
680
-
681
- queryParams.forEach(p => {
682
- const pyType = openApiTypeToPython(p.schema);
683
- clientContent += `, ${p.name}: ${p.required ? pyType : `Optional[${pyType}]`}${p.required ? "" : " = None"}`;
684
- });
685
-
686
- if (hasBody) {
687
- clientContent += `, data: Optional[Dict[str, Any]] = None`;
688
- }
689
-
690
- clientContent += `) -> Any:\n`;
691
- clientContent += ` """${operation.description || operation.summary || `${method.toUpperCase()} ${path}`} (async)"""\n`;
692
- clientContent += ` path = "${path}"\n`;
693
-
694
- pathParams.forEach(p => {
695
- clientContent += ` path = path.replace("{${p.name}}", str(${p.name}))\n`;
696
- });
697
-
698
- if (queryParams.length > 0) {
699
- clientContent += ` params = {}\n`;
700
- queryParams.forEach(p => {
701
- clientContent += ` if ${p.name} is not None:\n`;
702
- clientContent += ` params["${p.name}"] = ${p.name}\n`;
703
- });
704
- clientContent += ` return await self._request_async("${method.toUpperCase()}", path, params=params`;
705
- } else {
706
- clientContent += ` return await self._request_async("${method.toUpperCase()}", path`;
707
- }
708
-
709
- if (hasBody) {
710
- clientContent += `, json=data`;
711
- }
712
-
713
- clientContent += `)\n\n`;
714
- }
715
- }
716
- }
717
-
718
- files["client.py"] = clientContent;
719
-
720
- // Generate README
721
- let readme = `# ${spec.info.title} API Client\n\n`;
722
- readme += `${spec.info.description || "Generated Python API client"}\n\n`;
723
- readme += `## Installation\n\n\`\`\`bash\npip install requests pydantic\n\`\`\`\n\n`;
724
- if (options.async) {
725
- readme += `For async support:\n\`\`\`bash\npip install aiohttp\n\`\`\`\n\n`;
726
- }
727
- readme += `## Usage\n\n\`\`\`python\nfrom ${clientName} import ${className}\n\n`;
728
- readme += `client = ${className}(base_url="${baseUrl}"`;
729
- if (options.auth === "bearer") {
730
- readme += `, token="your-token"`;
731
- }
732
- readme += `)\n\n`;
733
- readme += `# Use the client\ndata = client.some_method()\n\`\`\`\n`;
734
-
735
- files["README.md"] = readme;
736
-
737
- return files;
738
- }
739
-
740
- // Generate API client
741
- async function generateApiClient(options: GenerateOptions): Promise<string> {
742
- log(`Generating ${options.language} API client...`);
743
-
744
- // Load spec
745
- const spec = await loadSpec(options.specPath);
746
-
747
- // Generate files based on language
748
- let files: Record<string, string>;
749
-
750
- if (options.language === "typescript" || options.language === "javascript") {
751
- if (options.typesOnly) {
752
- files = { "types.ts": generateTypeScriptTypes(spec) };
753
- } else {
754
- files = generateTypeScriptFetchClient(spec, options);
755
- }
756
- } else if (options.language === "python") {
757
- files = generatePythonClient(spec, options);
758
- } else {
759
- throw new Error(`Unsupported language: ${options.language}`);
760
- }
761
-
762
- // Determine output directory
763
- const timestamp = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
764
- const apiName = spec.info.title.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
765
- const defaultOutput = join(EXPORTS_DIR, `export_${timestamp}_${apiName}`);
766
- const outputDir = options.output || defaultOutput;
767
-
768
- // Write files
769
- log(`Writing files to: ${outputDir}`);
770
- ensureDir(outputDir);
771
-
772
- for (const [filename, content] of Object.entries(files)) {
773
- const filePath = join(outputDir, filename);
774
- ensureDir(dirname(filePath));
775
- writeFileSync(filePath, content, "utf-8");
776
- log(`Created: ${filename}`);
777
- }
778
-
779
- log(`Generated ${Object.keys(files).length} files`, "success");
780
- return outputDir;
781
- }
782
-
783
- // Main function
784
12
  async function main() {
785
13
  const { values, positionals } = parseArgs({
786
14
  args: Bun.argv.slice(2),
@@ -800,7 +28,6 @@ async function main() {
800
28
  allowPositionals: true,
801
29
  });
802
30
 
803
- // Show help
804
31
  if (values.help || positionals.length === 0) {
805
32
  console.log(`
806
33
  Generate API Client - Generate typed API clients from OpenAPI/Swagger specs
@@ -856,7 +83,6 @@ Examples:
856
83
  console.log(`\n✨ API client generated successfully!`);
857
84
  console.log(` šŸ“ Output: ${outputDir}`);
858
85
  console.log(` šŸ“‹ Log: ${join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`)}`);
859
-
860
86
  } catch (error) {
861
87
  log(`Error: ${error instanceof Error ? error.message : "Unknown error"}`, "error");
862
88
  process.exit(1);