@hasna/skills 0.1.27 → 0.1.30

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 (671) hide show
  1. package/LICENSE +1 -10
  2. package/README.md +141 -39
  3. package/bin/index.js +30121 -27576
  4. package/bin/mcp.js +22073 -18556
  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 +11606 -598
  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 +11 -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 +22 -11
  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/exports/products-2025-12-14T13-50-53-041Z.csv +16 -0
  108. package/skills/consolelog/exports/products-2025-12-14T13-50-53-041Z.json +227 -0
  109. package/skills/consolelog/package.json +1 -1
  110. package/skills/consolelog/src/index.ts +3 -0
  111. package/skills/contract-review-report/SKILL.md +43 -0
  112. package/skills/contract-review-report/package.json +10 -0
  113. package/skills/convert/SKILL.md +2 -3
  114. package/skills/customer-feedback-report/SKILL.md +44 -0
  115. package/skills/customer-feedback-report/package.json +10 -0
  116. package/skills/dashboard-builder/package.json +3 -1
  117. package/skills/database-explorer/package.json +3 -1
  118. package/skills/deepresearch/README.md +4 -13
  119. package/skills/deploy/src/http-client.ts +1 -1
  120. package/skills/diff-viewer/package.json +4 -1
  121. package/skills/doc-generate/package.json +0 -1
  122. package/skills/doc-generate/src/ai.ts +50 -0
  123. package/skills/doc-generate/src/cli.ts +203 -0
  124. package/skills/doc-generate/src/dependencies.ts +44 -0
  125. package/skills/doc-generate/src/document-builder.ts +299 -0
  126. package/skills/doc-generate/src/index.ts +40 -764
  127. package/skills/doc-generate/src/markdown-parser.ts +125 -0
  128. package/skills/doc-generate/src/types.ts +68 -0
  129. package/skills/domainpurchase/SKILL.md +1 -1
  130. package/skills/domainpurchase/package.json +1 -1
  131. package/skills/domainpurchase/src/index.ts +3 -0
  132. package/skills/domainsearch/SKILL.md +1 -1
  133. package/skills/domainsearch/package.json +1 -1
  134. package/skills/domainsearch/src/index.ts +3 -0
  135. package/skills/email-sequence/SKILL.md +44 -0
  136. package/skills/email-sequence/package.json +14 -0
  137. package/skills/excel/CLAUDE.md +2 -2
  138. package/skills/experiment-power-calculator/package.json +3 -1
  139. package/skills/extract-invoice/src/cli.ts +97 -0
  140. package/skills/extract-invoice/src/extractor.ts +170 -0
  141. package/skills/extract-invoice/src/file-utils.ts +46 -0
  142. package/skills/extract-invoice/src/formatters.ts +144 -0
  143. package/skills/extract-invoice/src/index.ts +44 -629
  144. package/skills/extract-invoice/src/runtime.ts +46 -0
  145. package/skills/extract-invoice/src/types.ts +88 -0
  146. package/skills/folder-tree/package.json +3 -1
  147. package/skills/form-filler/package.json +3 -1
  148. package/skills/generate-api-client/package.json +3 -1
  149. package/skills/generate-api-client/src/generator.ts +47 -0
  150. package/skills/generate-api-client/src/index.ts +3 -777
  151. package/skills/generate-api-client/src/logger.ts +34 -0
  152. package/skills/generate-api-client/src/python-generator.ts +245 -0
  153. package/skills/generate-api-client/src/spec-loader.ts +48 -0
  154. package/skills/generate-api-client/src/type-mappers.ts +79 -0
  155. package/skills/generate-api-client/src/types.ts +76 -0
  156. package/skills/generate-api-client/src/typescript-generator.ts +247 -0
  157. package/skills/generate-book-cover/package.json +3 -1
  158. package/skills/generate-dockerfile/src/cli.ts +78 -0
  159. package/skills/generate-dockerfile/src/dockerfile-templates.ts +392 -0
  160. package/skills/generate-dockerfile/src/index.ts +12 -790
  161. package/skills/generate-dockerfile/src/logger.ts +30 -0
  162. package/skills/generate-dockerfile/src/project-detection.ts +68 -0
  163. package/skills/generate-dockerfile/src/support-files.ts +171 -0
  164. package/skills/generate-dockerfile/src/types.ts +29 -0
  165. package/skills/generate-documentation/src/ai.ts +131 -0
  166. package/skills/generate-documentation/src/cli.ts +71 -0
  167. package/skills/generate-documentation/src/code-parser.ts +300 -0
  168. package/skills/generate-documentation/src/file-processing.ts +182 -0
  169. package/skills/generate-documentation/src/index.ts +13 -753
  170. package/skills/generate-documentation/src/runtime.ts +35 -0
  171. package/skills/generate-documentation/src/types.ts +30 -0
  172. package/skills/generate-env/package.json +3 -1
  173. package/skills/generate-env/src/cli.ts +85 -0
  174. package/skills/generate-env/src/detection.ts +161 -0
  175. package/skills/generate-env/src/env-data.ts +66 -0
  176. package/skills/generate-env/src/generators.ts +240 -0
  177. package/skills/generate-env/src/index.ts +76 -676
  178. package/skills/generate-env/src/runtime.ts +30 -0
  179. package/skills/generate-env/src/types.ts +32 -0
  180. package/skills/generate-favicon/package.json +3 -1
  181. package/skills/generate-mock-data/package.json +3 -1
  182. package/skills/generate-mock-data/src/ai.ts +102 -0
  183. package/skills/generate-mock-data/src/formatters.ts +84 -0
  184. package/skills/generate-mock-data/src/generator.ts +377 -0
  185. package/skills/generate-mock-data/src/index.ts +15 -716
  186. package/skills/generate-mock-data/src/logger.ts +37 -0
  187. package/skills/generate-mock-data/src/presets.ts +110 -0
  188. package/skills/generate-mock-data/src/types.ts +21 -0
  189. package/skills/generate-pr-description/src/ai.ts +144 -0
  190. package/skills/generate-pr-description/src/cli.ts +80 -0
  191. package/skills/generate-pr-description/src/clipboard.ts +30 -0
  192. package/skills/generate-pr-description/src/formatters.ts +231 -0
  193. package/skills/generate-pr-description/src/git.ts +153 -0
  194. package/skills/generate-pr-description/src/index.ts +21 -714
  195. package/skills/generate-pr-description/src/types.ts +49 -0
  196. package/skills/generate-presentation/src/ai-clients.ts +61 -0
  197. package/skills/generate-presentation/src/cli.ts +126 -0
  198. package/skills/generate-presentation/src/index.ts +3 -751
  199. package/skills/generate-presentation/src/logger.ts +67 -0
  200. package/skills/generate-presentation/src/presentation-generator.ts +425 -0
  201. package/skills/generate-presentation/src/runtime.ts +6 -0
  202. package/skills/generate-presentation/src/security.ts +12 -0
  203. package/skills/generate-presentation/src/types.ts +28 -0
  204. package/skills/generate-qrcode/package.json +4 -1
  205. package/skills/generate-regex/package.json +3 -1
  206. package/skills/generate-resume/src/cli.ts +157 -0
  207. package/skills/generate-resume/src/index.ts +13 -917
  208. package/skills/generate-resume/src/parsers.ts +95 -0
  209. package/skills/generate-resume/src/renderers.ts +538 -0
  210. package/skills/generate-resume/src/security.ts +39 -0
  211. package/skills/generate-resume/src/types.ts +86 -0
  212. package/skills/generate-social-posts/src/ai.ts +88 -0
  213. package/skills/generate-social-posts/src/cli.ts +118 -0
  214. package/skills/generate-social-posts/src/exporters.ts +126 -0
  215. package/skills/generate-social-posts/src/generator.ts +130 -0
  216. package/skills/generate-social-posts/src/index.ts +19 -709
  217. package/skills/generate-social-posts/src/platforms.ts +39 -0
  218. package/skills/generate-social-posts/src/runtime.ts +34 -0
  219. package/skills/generate-social-posts/src/source.ts +116 -0
  220. package/skills/generate-social-posts/src/types.ts +58 -0
  221. package/skills/gif-maker/package.json +4 -1
  222. package/skills/github-manager/package.json +3 -1
  223. package/skills/gmail/CLAUDE.md +1 -1
  224. package/skills/highlight-reel-generator/src/index.ts +19 -0
  225. package/skills/hook/src/commands/create.ts +20 -845
  226. package/skills/hook/src/templates/root.ts +196 -0
  227. package/skills/hook/src/templates/source.ts +647 -0
  228. package/skills/http-server/package.json +3 -1
  229. package/skills/icon-pack/README.md +28 -0
  230. package/skills/icon-pack/SKILL.md +23 -0
  231. package/skills/icon-pack/package.json +29 -0
  232. package/skills/{audio → icon-pack}/tsconfig.json +10 -12
  233. package/skills/image/package.json +1 -2
  234. package/skills/implementation-agent/package.json +3 -1
  235. package/skills/implementation-agent/src/ai-generation.ts +225 -0
  236. package/skills/implementation-agent/src/index.ts +3 -960
  237. package/skills/implementation-agent/src/minimist.d.ts +15 -0
  238. package/skills/implementation-agent/src/templates.ts +686 -0
  239. package/skills/implementation-agent/src/types.ts +53 -0
  240. package/skills/implementation-plan/package.json +3 -1
  241. package/skills/implementation-todo/package.json +3 -1
  242. package/skills/invoice/package.json +1 -1
  243. package/skills/invoice/src/index.ts +3 -0
  244. package/skills/invoice-reconciliation/SKILL.md +42 -0
  245. package/skills/invoice-reconciliation/package.json +10 -0
  246. package/skills/landing-page-pack/SKILL.md +47 -0
  247. package/skills/landing-page-pack/package.json +14 -0
  248. package/skills/latex-table-generator/package.json +3 -1
  249. package/skills/logo-design/SKILL.md +25 -44
  250. package/skills/logo-design/package.json +3 -15
  251. package/skills/lorem-generator/package.json +3 -1
  252. package/skills/lorem-generator/src/index.ts +13 -0
  253. package/skills/managehook/package.json +1 -1
  254. package/skills/managehook/src/index.ts +3 -0
  255. package/skills/managemcp/package.json +1 -1
  256. package/skills/managemcp/src/index.ts +3 -0
  257. package/skills/manageskill/package.json +1 -1
  258. package/skills/manageskill/src/index.ts +3 -0
  259. package/skills/markdown-validator/package.json +3 -1
  260. package/skills/markdown-validator/src/index.ts +1 -4
  261. package/skills/market-research-report/SKILL.md +41 -0
  262. package/skills/market-research-report/package.json +10 -0
  263. package/skills/mcp-builder/package.json +4 -1
  264. package/skills/mcp-builder/src/ai-descriptions.ts +37 -0
  265. package/skills/mcp-builder/src/generators.ts +513 -0
  266. package/skills/mcp-builder/src/index.ts +7 -908
  267. package/skills/mcp-builder/src/minimist.d.ts +15 -0
  268. package/skills/mcp-builder/src/naming.ts +12 -0
  269. package/skills/mcp-builder/src/options.ts +170 -0
  270. package/skills/mcp-builder/src/templates.ts +149 -0
  271. package/skills/mcp-builder/src/types.ts +42 -0
  272. package/skills/meeting-pack/SKILL.md +43 -0
  273. package/skills/meeting-pack/package.json +10 -0
  274. package/skills/merge-pdfs/package.json +5 -1
  275. package/skills/migration-plan-pack/SKILL.md +45 -0
  276. package/skills/migration-plan-pack/package.json +10 -0
  277. package/skills/music/package.json +2 -3
  278. package/skills/music-album/SKILL.md +37 -0
  279. package/skills/music-album/package.json +10 -0
  280. package/skills/notion-manager/package.json +3 -1
  281. package/skills/npmpublish/CLAUDE.md +5 -8
  282. package/skills/npmpublish/README.md +5 -26
  283. package/skills/npmpublish/src/index.ts +9 -147
  284. package/skills/one-page-website/SKILL.md +46 -0
  285. package/skills/one-page-website/package.json +10 -0
  286. package/skills/one-page-website/tsconfig.json +8 -0
  287. package/skills/pdf-generate/src/cli.ts +162 -0
  288. package/skills/pdf-generate/src/html.ts +84 -0
  289. package/skills/pdf-generate/src/index.ts +11 -800
  290. package/skills/pdf-generate/src/markdown.ts +27 -0
  291. package/skills/pdf-generate/src/pdf-writer.ts +78 -0
  292. package/skills/pdf-generate/src/runtime.ts +34 -0
  293. package/skills/pdf-generate/src/security.ts +37 -0
  294. package/skills/pdf-generate/src/templates.ts +311 -0
  295. package/skills/pdf-generate/src/types.ts +28 -0
  296. package/skills/pdf-read/SKILL.md +10 -10
  297. package/skills/pdf-to-dataset/SKILL.md +45 -0
  298. package/skills/pdf-to-dataset/package.json +10 -0
  299. package/skills/pdf-to-markdown/SKILL.md +49 -0
  300. package/skills/pdf-to-markdown/package.json +10 -0
  301. package/skills/pdf-to-markdown/tsconfig.json +10 -0
  302. package/skills/performance-audit-report/SKILL.md +42 -0
  303. package/skills/performance-audit-report/package.json +10 -0
  304. package/skills/persona-based-adwriter/src/index.ts +19 -0
  305. package/skills/photo-album/SKILL.md +29 -0
  306. package/skills/photo-album/package.json +9 -0
  307. package/skills/photo-album/tsconfig.json +4 -0
  308. package/skills/pitch-deck/SKILL.md +43 -0
  309. package/skills/pitch-deck/package.json +9 -0
  310. package/skills/playlist-maker/SKILL.md +33 -0
  311. package/skills/playlist-maker/package.json +9 -0
  312. package/skills/playlist-maker/tsconfig.json +4 -0
  313. package/skills/product-mockup/SKILL.md +45 -0
  314. package/skills/product-mockup/package.json +3 -20
  315. package/skills/product-mockup/tsconfig.json +3 -5
  316. package/skills/project-retro-companion/src/index.ts +19 -0
  317. package/skills/proposal-pack/SKILL.md +45 -0
  318. package/skills/proposal-pack/package.json +10 -0
  319. package/skills/read-pdf/SKILL.md +5 -4
  320. package/skills/repo-onboarding-report/SKILL.md +42 -0
  321. package/skills/repo-onboarding-report/package.json +10 -0
  322. package/skills/sales-call-recapper/src/index.ts +20 -0
  323. package/skills/salescopy/package.json +1 -1
  324. package/skills/salescopy/src/index.ts +3 -0
  325. package/skills/scaffold-project/src/ai-detect.ts +136 -0
  326. package/skills/scaffold-project/src/file-generators.ts +292 -0
  327. package/skills/scaffold-project/src/index.ts +8 -991
  328. package/skills/scaffold-project/src/project-config.ts +338 -0
  329. package/skills/scaffold-project/src/templates.ts +173 -0
  330. package/skills/scaffold-project/src/types.ts +58 -0
  331. package/skills/scientific-figure-check/package.json +3 -1
  332. package/skills/sdk-generator/SKILL.md +45 -0
  333. package/skills/sdk-generator/package.json +10 -0
  334. package/skills/sdk-generator/tsconfig.json +8 -0
  335. package/skills/security-audit/src/index.ts +25 -6
  336. package/skills/security-audit-report/SKILL.md +40 -0
  337. package/skills/security-audit-report/package.json +10 -0
  338. package/skills/seo-content-pack/SKILL.md +44 -0
  339. package/skills/seo-content-pack/package.json +9 -0
  340. package/skills/short-video-pack/SKILL.md +30 -0
  341. package/skills/short-video-pack/package.json +10 -0
  342. package/skills/skill-academic-journal-matcher/bin/cli.ts +34 -0
  343. package/skills/skill-action-item-router/bin/cli.ts +34 -0
  344. package/skills/skill-ad-creative-generator/bin/cli.ts +34 -0
  345. package/skills/skill-advanced-math/bin/cli.ts +34 -0
  346. package/skills/skill-analyze-data/bin/cli.ts +19 -0
  347. package/skills/skill-anomaly-investigator/bin/cli.ts +34 -0
  348. package/skills/skill-api-test-suite/bin/cli.ts +34 -0
  349. package/skills/skill-apidocs/bin/cli.ts +87 -0
  350. package/skills/skill-audio-cleanup-lab/bin/cli.ts +6 -0
  351. package/skills/skill-audiobook-chapter-proofer/bin/cli.ts +34 -0
  352. package/skills/skill-banner-ad-suite/bin/cli.ts +34 -0
  353. package/skills/skill-benchmark-finder/bin/cli.ts +34 -0
  354. package/skills/skill-bio-sequence-tool/bin/cli.ts +34 -0
  355. package/skills/skill-blog-topic-cluster/bin/cli.ts +34 -0
  356. package/skills/skill-brand-style-guide/bin/cli.ts +19 -0
  357. package/skills/skill-brand-voice-audit/bin/cli.ts +34 -0
  358. package/skills/skill-budget-variance-analyzer/bin/cli.ts +6 -0
  359. package/skills/skill-businessactivity/bin/cli.ts +28 -0
  360. package/skills/skill-calendar-events/bin/cli.ts +34 -0
  361. package/skills/skill-campaign-metric-brief/bin/cli.ts +34 -0
  362. package/skills/skill-campaign-moodboard/bin/cli.ts +34 -0
  363. package/skills/skill-caption-style-stylist/bin/cli.ts +34 -0
  364. package/skills/skill-chemistry-calculator/bin/cli.ts +34 -0
  365. package/skills/skill-churn-risk-notifier/bin/cli.ts +34 -0
  366. package/skills/skill-citation-formatter/bin/cli.ts +34 -0
  367. package/skills/skill-classroom-newsletter-kit/bin/cli.ts +34 -0
  368. package/skills/skill-color-palette-harmonizer/bin/cli.ts +34 -0
  369. package/skills/skill-competitor-ad-analyzer/bin/cli.ts +34 -0
  370. package/skills/skill-compliance-copy-check/bin/cli.ts +34 -0
  371. package/skills/skill-compliance-report-pack/bin/cli.ts +34 -0
  372. package/skills/skill-compress-video/bin/cli.ts +19 -0
  373. package/skills/skill-consolelog/bin/cli.ts +884 -0
  374. package/skills/skill-contract-plainlanguage/bin/cli.ts +34 -0
  375. package/skills/skill-copytone-translator/bin/cli.ts +34 -0
  376. package/skills/skill-create-blog-article/bin/cli.ts +34 -0
  377. package/skills/skill-create-ebook/bin/cli.ts +34 -0
  378. package/skills/skill-crm-note-enhancer/bin/cli.ts +34 -0
  379. package/skills/skill-customer-journey-mapper/bin/cli.ts +34 -0
  380. package/skills/skill-dashboard-builder/bin/cli.ts +34 -0
  381. package/skills/skill-dashboard-narrator/bin/cli.ts +34 -0
  382. package/skills/skill-data-anonymizer/bin/cli.ts +34 -0
  383. package/skills/skill-database-explorer/bin/cli.ts +34 -0
  384. package/skills/skill-dataset-health-check/bin/cli.ts +34 -0
  385. package/skills/skill-decision-journal/bin/cli.ts +34 -0
  386. package/skills/skill-delegation-brief-writer/bin/cli.ts +34 -0
  387. package/skills/skill-destination-briefing/bin/cli.ts +34 -0
  388. package/skills/skill-diff-viewer/bin/cli.ts +34 -0
  389. package/skills/skill-domainpurchase/bin/cli.ts +683 -0
  390. package/skills/skill-domainsearch/bin/cli.ts +410 -0
  391. package/skills/skill-educational-resource-finder/bin/cli.ts +34 -0
  392. package/skills/skill-email-campaign/bin/cli.ts +34 -0
  393. package/skills/skill-exam-readiness-check/bin/cli.ts +34 -0
  394. package/skills/skill-experiment-power-calculator/bin/cli.ts +34 -0
  395. package/skills/skill-extract-audio/bin/cli.ts +19 -0
  396. package/skills/skill-extract-frames/bin/cli.ts +34 -0
  397. package/skills/skill-extract-invoice/bin/cli.ts +34 -0
  398. package/skills/skill-family-activity-curator/bin/cli.ts +34 -0
  399. package/skills/skill-faq-packager/bin/cli.ts +34 -0
  400. package/skills/skill-feedback-survey-designer/bin/cli.ts +34 -0
  401. package/skills/skill-field-trip-planner/bin/cli.ts +34 -0
  402. package/skills/skill-file-organizer/bin/cli.ts +34 -0
  403. package/skills/skill-folder-tree/bin/cli.ts +34 -0
  404. package/skills/skill-forecast-scenario-lab/bin/cli.ts +34 -0
  405. package/skills/skill-form-filler/bin/cli.ts +34 -0
  406. package/skills/skill-generate-api-client/bin/cli.ts +34 -0
  407. package/skills/skill-generate-book-cover/bin/cli.ts +34 -0
  408. package/skills/skill-generate-chart/bin/cli.ts +34 -0
  409. package/skills/skill-generate-diagram/bin/cli.ts +34 -0
  410. package/skills/skill-generate-dockerfile/bin/cli.ts +34 -0
  411. package/skills/skill-generate-documentation/bin/cli.ts +34 -0
  412. package/skills/skill-generate-docx/bin/cli.ts +6 -0
  413. package/skills/skill-generate-env/bin/cli.ts +34 -0
  414. package/skills/skill-generate-excel/bin/cli.ts +34 -0
  415. package/skills/skill-generate-favicon/bin/cli.ts +34 -0
  416. package/skills/skill-generate-mock-data/bin/cli.ts +34 -0
  417. package/skills/skill-generate-pdf/bin/cli.ts +6 -0
  418. package/skills/skill-generate-pr-description/bin/cli.ts +34 -0
  419. package/skills/skill-generate-presentation/bin/cli.ts +34 -0
  420. package/skills/skill-generate-qrcode/bin/cli.ts +34 -0
  421. package/skills/skill-generate-regex/bin/cli.ts +34 -0
  422. package/skills/skill-generate-resume/bin/cli.ts +34 -0
  423. package/skills/skill-generate-sitemap/bin/cli.ts +34 -0
  424. package/skills/skill-generate-social-posts/bin/cli.ts +34 -0
  425. package/skills/skill-generate-sql/bin/cli.ts +34 -0
  426. package/skills/skill-gif-maker/bin/cli.ts +34 -0
  427. package/skills/skill-github-manager/bin/cli.ts +34 -0
  428. package/skills/skill-gmail/bin/cli.ts +34 -0
  429. package/skills/skill-goal-quarterly-roadmap/bin/cli.ts +34 -0
  430. package/skills/skill-grant-application-drafter/bin/cli.ts +34 -0
  431. package/skills/skill-grocery-basket-optimizer/bin/cli.ts +34 -0
  432. package/skills/skill-guest-communication-suite/bin/cli.ts +34 -0
  433. package/skills/skill-habit-reflection-digest/bin/cli.ts +34 -0
  434. package/skills/skill-highlight-reel-generator/bin/cli.ts +34 -0
  435. package/skills/skill-homework-feedback-coach/bin/cli.ts +34 -0
  436. package/skills/skill-household-maintenance-mgr/bin/cli.ts +34 -0
  437. package/skills/skill-http-server/bin/cli.ts +34 -0
  438. package/skills/skill-implementation-agent/bin/cli.ts +34 -0
  439. package/skills/skill-implementation-plan/bin/cli.ts +34 -0
  440. package/skills/skill-implementation-todo/bin/cli.ts +34 -0
  441. package/skills/skill-inbox-priority-planner/bin/cli.ts +34 -0
  442. package/skills/skill-invoice/bin/cli.ts +20 -0
  443. package/skills/skill-invoice-dispute-helper/bin/cli.ts +34 -0
  444. package/skills/skill-itinerary-architect/bin/cli.ts +34 -0
  445. package/skills/skill-jingle-composer/bin/cli.ts +34 -0
  446. package/skills/skill-kpi-digest-generator/bin/cli.ts +34 -0
  447. package/skills/skill-lab-notebook-formatter/bin/cli.ts +34 -0
  448. package/skills/skill-landing-page-copy/bin/cli.ts +34 -0
  449. package/skills/skill-latex-table-generator/bin/cli.ts +34 -0
  450. package/skills/skill-learning-style-profiler/bin/cli.ts +34 -0
  451. package/skills/skill-lesson-plan-customizer/bin/cli.ts +34 -0
  452. package/skills/skill-livestream-runofshow/bin/cli.ts +34 -0
  453. package/skills/skill-longform-structurer/bin/cli.ts +34 -0
  454. package/skills/skill-lorem-generator/bin/cli.ts +34 -0
  455. package/skills/skill-managehook/bin/cli.ts +241 -0
  456. package/skills/skill-managemcp/bin/cli.ts +241 -0
  457. package/skills/skill-manageskill/bin/cli.ts +241 -0
  458. package/skills/skill-markdown-validator/bin/cli.ts +34 -0
  459. package/skills/skill-mcp-builder/bin/cli.ts +34 -0
  460. package/skills/skill-meal-plan-designer/bin/cli.ts +34 -0
  461. package/skills/skill-meeting-insight-summarizer/bin/cli.ts +34 -0
  462. package/skills/skill-merge-pdfs/bin/cli.ts +34 -0
  463. package/skills/skill-microcopy-generator/bin/cli.ts +34 -0
  464. package/skills/skill-mindfulness-prompt-cache/bin/cli.ts +34 -0
  465. package/skills/skill-notion-manager/bin/cli.ts +34 -0
  466. package/skills/skill-onboarding-sequence-builder/bin/cli.ts +34 -0
  467. package/skills/skill-onsite-ops-checklist/bin/cli.ts +34 -0
  468. package/skills/skill-outreach-cadence-designer/bin/cli.ts +34 -0
  469. package/skills/skill-packaging-concept-studio/bin/cli.ts +34 -0
  470. package/skills/skill-packing-plan-pro/bin/cli.ts +34 -0
  471. package/skills/skill-parent-teacher-brief/bin/cli.ts +34 -0
  472. package/skills/skill-partner-kit-assembler/bin/cli.ts +34 -0
  473. package/skills/skill-payroll-change-prepper/bin/cli.ts +34 -0
  474. package/skills/skill-persona-based-adwriter/bin/cli.ts +34 -0
  475. package/skills/skill-persona-generator/bin/cli.ts +34 -0
  476. package/skills/skill-personal-daily-ops/bin/cli.ts +34 -0
  477. package/skills/skill-pet-care-scheduler/bin/cli.ts +34 -0
  478. package/skills/skill-podcast-show-notes/bin/cli.ts +34 -0
  479. package/skills/skill-presentation-theme-maker/bin/cli.ts +34 -0
  480. package/skills/skill-press-release-drafter/bin/cli.ts +34 -0
  481. package/skills/skill-print-collateral-designer/bin/cli.ts +34 -0
  482. package/skills/skill-procurement-scorecard/bin/cli.ts +34 -0
  483. package/skills/skill-product-demo-script/bin/cli.ts +34 -0
  484. package/skills/skill-product-mockup/bin/cli.ts +34 -0
  485. package/skills/skill-project-retro-companion/bin/cli.ts +34 -0
  486. package/skills/skill-proposal-redline-advisor/bin/cli.ts +34 -0
  487. package/skills/skill-regex-tester/bin/cli.ts +34 -0
  488. package/skills/skill-remove-background/bin/cli.ts +34 -0
  489. package/skills/skill-risk-disclosure-kit/bin/cli.ts +34 -0
  490. package/skills/skill-roi-comparison-tool/bin/cli.ts +34 -0
  491. package/skills/skill-sales-call-recapper/bin/cli.ts +34 -0
  492. package/skills/skill-salescopy/bin/cli.ts +20 -0
  493. package/skills/skill-scaffold-project/bin/cli.ts +34 -0
  494. package/skills/skill-scholarship-tracker/bin/cli.ts +34 -0
  495. package/skills/skill-scientific-figure-check/bin/cli.ts +34 -0
  496. package/skills/skill-seating-chart-maker/bin/cli.ts +34 -0
  497. package/skills/skill-security-audit/bin/cli.ts +34 -0
  498. package/skills/skill-seo-brief-builder/bin/cli.ts +34 -0
  499. package/skills/skill-slack-assistant/bin/cli.ts +34 -0
  500. package/skills/skill-sleep-routine-analyzer/bin/cli.ts +34 -0
  501. package/skills/skill-social-media-kit/bin/cli.ts +34 -0
  502. package/skills/skill-split-pdf/bin/cli.ts +34 -0
  503. package/skills/skill-sponsorship-proposal-lab/bin/cli.ts +34 -0
  504. package/skills/skill-spreadsheet-cleanroom/bin/cli.ts +34 -0
  505. package/skills/skill-statistical-test-selector/bin/cli.ts +34 -0
  506. package/skills/skill-stress-relief-playbook/bin/cli.ts +34 -0
  507. package/skills/skill-study-guide-builder/bin/cli.ts +34 -0
  508. package/skills/skill-subscription-spend-watcher/bin/cli.ts +34 -0
  509. package/skills/skill-subtitle/bin/cli.ts +20 -0
  510. package/skills/skill-survey-insight-extractor/bin/cli.ts +34 -0
  511. package/skills/skill-terraform-generator/bin/cli.ts +34 -0
  512. package/skills/skill-testimonial-graphics/bin/cli.ts +34 -0
  513. package/skills/skill-timesheet/bin/cli.ts +47 -0
  514. package/skills/skill-travel-budget-balancer/bin/cli.ts +34 -0
  515. package/skills/skill-validate-config/bin/cli.ts +34 -0
  516. package/skills/skill-video-cut-suggester/bin/cli.ts +34 -0
  517. package/skills/skill-video-downloader/bin/cli.ts +34 -0
  518. package/skills/skill-video-thumbnail/bin/cli.ts +34 -0
  519. package/skills/skill-voiceover-casting-assistant/bin/cli.ts +34 -0
  520. package/skills/skill-watermark/bin/cli.ts +34 -0
  521. package/skills/skill-webcrawling/bin/cli.ts +21 -0
  522. package/skills/skill-webinar-script-coach/bin/cli.ts +34 -0
  523. package/skills/skill-wellness-progress-reporter/bin/cli.ts +34 -0
  524. package/skills/skill-workout-cycle-planner/bin/cli.ts +34 -0
  525. package/skills/slack-assistant/package.json +3 -1
  526. package/skills/slide-deck-generator/SKILL.md +44 -0
  527. package/skills/slide-deck-generator/package.json +10 -0
  528. package/skills/sms/package.json +1 -1
  529. package/skills/sms/src/index.ts +15 -0
  530. package/skills/social-content-calendar/SKILL.md +45 -0
  531. package/skills/social-content-calendar/package.json +14 -0
  532. package/skills/split-pdf/package.json +4 -1
  533. package/skills/subtitle/package.json +2 -1
  534. package/skills/subtitle/src/index.ts +3 -0
  535. package/skills/terraform-generator/package.json +3 -1
  536. package/skills/test-suite-generator/SKILL.md +41 -0
  537. package/skills/test-suite-generator/package.json +10 -0
  538. package/skills/timesheet/package.json +1 -1
  539. package/skills/timesheet/src/index.ts +3 -0
  540. package/skills/transcript/SKILL.md +1 -8
  541. package/skills/validate-config/package.json +3 -1
  542. package/skills/video/package.json +6 -4
  543. package/skills/video-downloader/package.json +3 -1
  544. package/skills/video-highlight-pack/SKILL.md +44 -0
  545. package/skills/video-highlight-pack/package.json +10 -0
  546. package/skills/voiceover-jingle-pack/SKILL.md +28 -0
  547. package/skills/voiceover-jingle-pack/package.json +10 -0
  548. package/skills/watermark/package.json +6 -1
  549. package/skills/webcrawling/package.json +2 -1
  550. package/skills/write/SKILL.md +6 -6
  551. package/dist/server/serve.d.ts +0 -11
  552. package/skills/apidocs/.claude/settings.json +0 -5
  553. package/skills/audio/.env.example +0 -14
  554. package/skills/audio/QUICKSTART.md +0 -158
  555. package/skills/audio/README.md +0 -256
  556. package/skills/audio/src/index-local.ts +0 -206
  557. package/skills/audio/src/index.ts +0 -95
  558. package/skills/audio/src/providers/elevenlabs.ts +0 -115
  559. package/skills/audio/src/providers/google.ts +0 -116
  560. package/skills/audio/src/providers/minimax.ts +0 -83
  561. package/skills/audio/src/providers/openai.ts +0 -115
  562. package/skills/audio/src/types.ts +0 -79
  563. package/skills/audiobook-chapter-proofer/CLAUDE.md +0 -19
  564. package/skills/audiobook-chapter-proofer/package.json +0 -27
  565. package/skills/audiobook-chapter-proofer/src/index.ts +0 -285
  566. package/skills/browse/src/client.ts +0 -373
  567. package/skills/browse/src/index-local.ts +0 -430
  568. package/skills/browse/src/index.ts +0 -110
  569. package/skills/browse/src/sse-server.ts +0 -919
  570. package/skills/browse/src/types.ts +0 -104
  571. package/skills/consolelog/src/server/index.ts +0 -508
  572. package/skills/create-blog-article/CLAUDE.md +0 -19
  573. package/skills/create-blog-article/src/index.ts +0 -745
  574. package/skills/create-blog-article/tsconfig.json +0 -10
  575. package/skills/deepresearch/src/agents/query-generator.ts +0 -91
  576. package/skills/deepresearch/src/agents/synthesizer.ts +0 -111
  577. package/skills/deepresearch/src/index.ts +0 -224
  578. package/skills/deepresearch/src/research.ts +0 -166
  579. package/skills/deepresearch/src/services/anthropic.ts +0 -69
  580. package/skills/deepresearch/src/services/exa.ts +0 -108
  581. package/skills/deepresearch/src/services/firecrawl.ts +0 -88
  582. package/skills/deepresearch/src/services/openai.ts +0 -81
  583. package/skills/deepresearch/src/types.ts +0 -76
  584. package/skills/deepresearch/src/utils/file.ts +0 -111
  585. package/skills/deepresearch/src/utils/logger.ts +0 -84
  586. package/skills/domainpurchase/src/server/index.ts +0 -332
  587. package/skills/domainsearch/src/server/index.ts +0 -229
  588. package/skills/e2bswarm/README.md +0 -135
  589. package/skills/e2bswarm/SKILL.md +0 -118
  590. package/skills/e2bswarm/examples/tasks-example.json +0 -38
  591. package/skills/e2bswarm/package.json +0 -59
  592. package/skills/e2bswarm/src/commands/collect.ts +0 -135
  593. package/skills/e2bswarm/src/commands/install.ts +0 -164
  594. package/skills/e2bswarm/src/commands/kill.ts +0 -62
  595. package/skills/e2bswarm/src/commands/spawn.ts +0 -134
  596. package/skills/e2bswarm/src/commands/status.ts +0 -90
  597. package/skills/e2bswarm/src/commands/sync.ts +0 -208
  598. package/skills/e2bswarm/src/index.ts +0 -121
  599. package/skills/e2bswarm/src/lib/config.ts +0 -75
  600. package/skills/e2bswarm/src/lib/e2b.ts +0 -490
  601. package/skills/e2bswarm/src/lib/github.ts +0 -253
  602. package/skills/e2bswarm/src/lib/logger.ts +0 -41
  603. package/skills/e2bswarm/src/lib/paths.ts +0 -75
  604. package/skills/e2bswarm/src/lib/tasks.ts +0 -320
  605. package/skills/e2bswarm/src/types/index.ts +0 -107
  606. package/skills/e2bswarm/templates/codebox/e2b.Dockerfile +0 -38
  607. package/skills/e2bswarm/templates/codebox/e2b.toml +0 -3
  608. package/skills/e2bswarm/templates/setup.sh +0 -21
  609. package/skills/e2bswarm/tsconfig.json +0 -19
  610. package/skills/generate-book-cover/src/index.ts +0 -694
  611. package/skills/image/src/index-local.ts +0 -206
  612. package/skills/image/src/index.ts +0 -96
  613. package/skills/image/src/providers/google.ts +0 -79
  614. package/skills/image/src/providers/minimax.ts +0 -94
  615. package/skills/image/src/providers/openai.ts +0 -80
  616. package/skills/image/src/providers/xai.ts +0 -73
  617. package/skills/image/src/types.ts +0 -37
  618. package/skills/logo-design/CLAUDE.md +0 -30
  619. package/skills/logo-design/src/index.ts +0 -322
  620. package/skills/managehook/src/server/index.ts +0 -108
  621. package/skills/managemcp/src/server/index.ts +0 -108
  622. package/skills/manageskill/src/server/index.ts +0 -108
  623. package/skills/music/CLAUDE.md +0 -9
  624. package/skills/music/src/index.ts +0 -94
  625. package/skills/music/tsconfig.json +0 -10
  626. package/skills/pdf-read/src/index.ts +0 -320
  627. package/skills/product-mockup/CLAUDE.md +0 -19
  628. package/skills/product-mockup/src/index.ts +0 -290
  629. package/skills/read-pdf/src/index.ts +0 -388
  630. package/skills/remove-background/src/index.ts +0 -405
  631. package/skills/sound-effects/SKILL.md +0 -34
  632. package/skills/sound-effects/package.json +0 -21
  633. package/skills/sound-effects/src/index.ts +0 -172
  634. package/skills/sound-effects/tsconfig.json +0 -8
  635. package/skills/transcript/src/chunker.ts +0 -215
  636. package/skills/transcript/src/formatter.ts +0 -134
  637. package/skills/transcript/src/index-local.ts +0 -226
  638. package/skills/transcript/src/index.ts +0 -110
  639. package/skills/transcript/src/providers/elevenlabs.ts +0 -133
  640. package/skills/transcript/src/providers/gemini.ts +0 -192
  641. package/skills/transcript/src/providers/index.ts +0 -54
  642. package/skills/transcript/src/providers/openai.ts +0 -203
  643. package/skills/transcript/src/types.ts +0 -106
  644. package/skills/video/.env.example +0 -14
  645. package/skills/video/EXAMPLES.md +0 -266
  646. package/skills/video/LICENSE +0 -192
  647. package/skills/video/README.md +0 -174
  648. package/skills/video/src/cli.ts +0 -155
  649. package/skills/video/src/index-local.ts +0 -148
  650. package/skills/video/src/index.ts +0 -96
  651. package/skills/video/src/providers/google-veo.ts +0 -126
  652. package/skills/video/src/providers/index.ts +0 -22
  653. package/skills/video/src/providers/minimax.ts +0 -100
  654. package/skills/video/src/providers/openai-sora.ts +0 -164
  655. package/skills/video/src/providers/runway.ts +0 -159
  656. package/skills/video/src/types.ts +0 -35
  657. package/skills/video/tsconfig.json +0 -22
  658. package/skills/voiceover-casting-assistant/CLAUDE.md +0 -19
  659. package/skills/voiceover-casting-assistant/package.json +0 -27
  660. package/skills/voiceover-casting-assistant/src/index.ts +0 -255
  661. package/skills/voiceover-casting-assistant/tsconfig.json +0 -10
  662. package/skills/webcrawling/src/commands/config.ts +0 -34
  663. package/skills/webcrawling/src/commands/crawl.ts +0 -33
  664. package/skills/webcrawling/src/commands/scrape.ts +0 -32
  665. package/skills/webcrawling/src/commands/sessions.ts +0 -42
  666. package/skills/webcrawling/src/lib/crawler.ts +0 -174
  667. package/skills/webcrawling/src/lib/storage.ts +0 -130
  668. package/skills/webcrawling/src/types/index.ts +0 -45
  669. package/skills/webcrawling/src/utils/logger.ts +0 -30
  670. package/skills/webcrawling/src/utils/paths.ts +0 -28
  671. /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);