botrun-horse 2.29.2 → 2.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (574) hide show
  1. package/botrun-c/.claude/skills/DOCX/351/226/261/350/256/200/346/212/200/350/203/275/SKILL.md +103 -0
  2. package/botrun-c/.claude/skills/DOCX/351/226/261/350/256/200/346/212/200/350/203/275/scripts/docx-to-markdown.mjs +206 -0
  3. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/SKILL.md +1093 -0
  4. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-branch.mjs +73 -0
  5. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-branches.mjs +77 -0
  6. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-checkout.mjs +72 -0
  7. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-clone.mjs +72 -0
  8. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-commit.mjs +75 -0
  9. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-delete-branch.mjs +75 -0
  10. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-delete-file.mjs +72 -0
  11. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-diff.mjs +80 -0
  12. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-list-tree.mjs +336 -0
  13. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-list.mjs +199 -0
  14. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-merge.mjs +86 -0
  15. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-move.mjs +75 -0
  16. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-create.mjs +81 -0
  17. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-list.mjs +74 -0
  18. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-merge.mjs +83 -0
  19. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-view.mjs +71 -0
  20. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-push.mjs +71 -0
  21. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-read.mjs +277 -0
  22. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-search.mjs +370 -0
  23. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-stash.mjs +116 -0
  24. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-sync.mjs +71 -0
  25. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-write.mjs +74 -0
  26. package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/lib/path-validator.mjs +167 -0
  27. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/SKILL.md +605 -0
  28. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-create.mjs +127 -0
  29. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-delete.mjs +77 -0
  30. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-diff.mjs +87 -0
  31. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-history.mjs +99 -0
  32. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-list.mjs +174 -0
  33. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-read.mjs +214 -0
  34. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-restore.mjs +75 -0
  35. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-search.mjs +270 -0
  36. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-sync-back.mjs +155 -0
  37. package/botrun-c/.claude/skills/GoogleDrive/346/212/200/350/203/275/scripts/gdrive-update.mjs +100 -0
  38. package/botrun-c/.claude/skills/HTML/347/224/237/346/210/220/346/212/200/350/203/275/SKILL.md +414 -0
  39. package/botrun-c/.claude/skills/HTML/347/224/237/346/210/220/346/212/200/350/203/275/scripts/create-project.mjs +91 -0
  40. package/botrun-c/.claude/skills/HTML/347/224/237/346/210/220/346/212/200/350/203/275/scripts/finalize-project.mjs +162 -0
  41. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/SKILL.md +206 -0
  42. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/package.json +19 -0
  43. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/pdf-analyze.mjs +309 -0
  44. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/pdf-compress.mjs +315 -0
  45. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/pdf-split.mjs +275 -0
  46. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/pdf-to-text.mjs +336 -0
  47. package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/test-pdf-scripts.mjs +491 -0
  48. package/botrun-c/.claude/skills/docx-to-markdown/SKILL.md +76 -0
  49. package/botrun-c/.claude/skills/docx-to-markdown/scripts/convert_docx.py +183 -0
  50. package/botrun-c/.claude/skills/gcp-coord-ml-ocr/SKILL.md +133 -0
  51. package/botrun-c/.claude/skills/gcp-coord-ml-ocr/scripts/ocr_processor.py +381 -0
  52. package/botrun-c/.claude/skills/gemini-transcribe/SKILL.md +115 -0
  53. package/botrun-c/.claude/skills/gemini-transcribe/scripts/transcribe.py +499 -0
  54. package/botrun-c/.claude/skills/nchc-transcribe/SKILL.md +131 -0
  55. package/botrun-c/.claude/skills/nchc-transcribe/scripts/transcribe.py +522 -0
  56. package/botrun-c/.claude/skills/p320-moj-review/SKILL.md +200 -0
  57. package/botrun-c/.claude/skills/p320-moj-review/references/guideline.md +118 -0
  58. package/botrun-c/.claude/skills/pdf-multimodal-processor/SKILL.md +186 -0
  59. package/botrun-c/.claude/skills/pdf-multimodal-processor/scripts/process_pdf.py +515 -0
  60. package/botrun-c/.claude/skills/ripgrep/346/220/234/345/260/213/346/212/200/350/203/275/SKILL.md +81 -0
  61. package/botrun-c/.claude/skills/ripgrep/346/220/234/345/260/213/346/212/200/350/203/275/scripts/package.json +13 -0
  62. package/botrun-c/.claude/skills/ripgrep/346/220/234/345/260/213/346/212/200/350/203/275/scripts/secure-search.mjs +232 -0
  63. package/botrun-c/.claude/skills/top100/351/240/230/350/242/226/351/240/220/346/270/254/346/212/200/350/203/275/SKILL.md +518 -0
  64. package/botrun-c/.claude/skills//345/216/273/350/255/230/345/210/245/346/212/200/350/203/275/SKILL.md +125 -0
  65. package/botrun-c/.claude/skills//345/233/236/346/206/266/346/212/200/350/203/275/SKILL.md +123 -0
  66. package/botrun-c/.claude/skills//345/233/236/346/206/266/346/212/200/350/203/275/scripts/recall.mjs +339 -0
  67. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/SKILL.md +156 -0
  68. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/__tests__/utils.test.mjs +139 -0
  69. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/constants.mjs +40 -0
  70. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/gcs-uploader.mjs +195 -0
  71. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/gemini-image-client.mjs +307 -0
  72. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/generate-image.mjs +103 -0
  73. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/image-session-manager.mjs +219 -0
  74. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/output-formatter.mjs +209 -0
  75. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/package.json +20 -0
  76. package/botrun-c/.claude/skills//345/234/226/347/211/207/347/224/237/346/210/220/346/212/200/350/203/275/scripts/utils.mjs +115 -0
  77. package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/SKILL.md +86 -0
  78. package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/scripts/multimodal-read.mjs +304 -0
  79. package/botrun-c/.claude/skills//345/244/232/346/250/241/346/205/213/351/226/261/350/256/200/346/212/200/350/203/275/scripts/package.json +17 -0
  80. package/botrun-c/.claude/skills//345/255/265/345/214/226/346/212/200/350/203/275/SKILL.md +131 -0
  81. package/botrun-c/.claude/skills//345/255/265/345/214/226/346/212/200/350/203/275/scripts/skill-manager.mjs +542 -0
  82. package/botrun-c/.claude/skills//346/234/203/350/255/260/350/250/230/351/214/204/346/212/200/350/203/275/SKILL.md +127 -0
  83. package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/SKILL.md +53 -0
  84. package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/scripts/package.json +13 -0
  85. package/botrun-c/.claude/skills//347/233/256/351/214/204/345/210/227/350/241/250/346/212/200/350/203/275/scripts/tree-view.mjs +149 -0
  86. package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/SKILL.md +82 -0
  87. package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/scripts/package.json +16 -0
  88. package/botrun-c/.claude/skills//347/264/224/346/226/207/345/255/227/345/244/232/346/252/224/346/241/210/350/256/200/345/217/226/346/212/200/350/203/275/scripts/secure-read.mjs +260 -0
  89. package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/SKILL.md +156 -0
  90. package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/package.json +16 -0
  91. package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/search.js +139 -0
  92. package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/search.mjs +272 -0
  93. package/botrun-c/.claude/skills//347/266/262/350/267/257/346/220/234/345/260/213/346/212/200/350/203/275/scripts/search.ts +166 -0
  94. package/botrun-c/.claude/skills//350/250/230/346/206/266/346/212/200/350/203/275/SKILL.md +114 -0
  95. package/botrun-c/.claude/skills//350/250/230/346/206/266/346/212/200/350/203/275/scripts/remember.mjs +159 -0
  96. package/botrun-c/.claude/skills//350/250/230/346/206/266/346/212/200/350/203/275/scripts/test-advanced.mjs +342 -0
  97. package/botrun-c/.claude/skills//350/250/230/346/206/266/346/212/200/350/203/275/scripts/test.mjs +430 -0
  98. package/botrun-c/.claude/skills//350/252/236/351/237/263/350/275/211/346/226/207/345/255/227/346/212/200/350/203/275/SKILL.md +30 -0
  99. package/botrun-c/.claude/skills//350/252/236/351/237/263/350/275/211/346/226/207/345/255/227/346/212/200/350/203/275/scripts/package.json +13 -0
  100. package/botrun-c/.claude/skills//350/252/236/351/237/263/350/275/211/346/226/207/345/255/227/346/212/200/350/203/275/scripts/transcribe.mjs +294 -0
  101. package/botrun-c/.claude/skills//351/233/266/345/271/273/350/246/272/350/255/211/346/230/216/346/212/200/350/203/275/SKILL.md +338 -0
  102. package/botrun-c/.dockerignore +131 -0
  103. package/botrun-c/.dockeroptimize +13 -0
  104. package/botrun-c/.firebase/hosting.b3V0.cache +30 -0
  105. package/botrun-c/.firebaserc +5 -0
  106. package/botrun-c/.gcloudignore +56 -0
  107. package/botrun-c/.ruby-version +1 -0
  108. package/botrun-c/CHANGELOG.md +224 -0
  109. package/botrun-c/Dockerfile.gcp +365 -0
  110. package/botrun-c/Dockerfile.slim +195 -0
  111. package/botrun-c/Gemfile +8 -0
  112. package/botrun-c/Gemfile.lock +233 -0
  113. package/botrun-c/LOCAL-DEVELOPMENT-GUIDE.md +393 -0
  114. package/botrun-c/PLAN.md +131 -0
  115. package/botrun-c/README.md +129 -0
  116. package/botrun-c/TODO-CAPACITOR-INTEGRATION.md +482 -0
  117. package/botrun-c/VERIFICATION.md +121 -0
  118. package/botrun-c/admin/RATE_LIMIT_MANAGEMENT.md +312 -0
  119. package/botrun-c/admin/README.md +338 -0
  120. package/botrun-c/admin/botrun-billing-report-1765235244038.csv +22 -0
  121. package/botrun-c/admin/botrun-billing-report-1765235323089.csv +22 -0
  122. package/botrun-c/admin/botrun-dashboard-1765235244039.html +278 -0
  123. package/botrun-c/admin/botrun-dashboard-1765235323089.html +278 -0
  124. package/botrun-c/admin/botrun-timeseries-074xGzIKWyfKTBt1NMIj9lxi5mO2-1765235244039.html +161 -0
  125. package/botrun-c/admin/botrun-timeseries-074xGzIKWyfKTBt1NMIj9lxi5mO2-1765235323090.html +161 -0
  126. package/botrun-c/admin/check-billing.ts +48 -0
  127. package/botrun-c/admin/count-all-users.ts +65 -0
  128. package/botrun-c/admin/generate-analytics-report.ts +188 -0
  129. package/botrun-c/admin/jest.config.ts +43 -0
  130. package/botrun-c/admin/lib/__tests__/formatters.test.ts +264 -0
  131. package/botrun-c/admin/lib/__tests__/mocks/firebase.mock.ts +112 -0
  132. package/botrun-c/admin/lib/__tests__/services/UserService.test.ts +83 -0
  133. package/botrun-c/admin/lib/__tests__/user-resolver.test.ts +439 -0
  134. package/botrun-c/admin/lib/analyzers/BillingAnalyticsService.ts +242 -0
  135. package/botrun-c/admin/lib/analyzers/CsvExporter.ts +263 -0
  136. package/botrun-c/admin/lib/analyzers/HtmlChartGenerator.ts +530 -0
  137. package/botrun-c/admin/lib/analyzers/SpikeAnalyzer.ts +608 -0
  138. package/botrun-c/admin/lib/analyzers/TimeSeriesAnalyzer.ts +344 -0
  139. package/botrun-c/admin/lib/cli/CLIBootstrapper.ts +40 -0
  140. package/botrun-c/admin/lib/commands/AbstractCommand.ts +69 -0
  141. package/botrun-c/admin/lib/commands/AnalyticsCommand.ts +215 -0
  142. package/botrun-c/admin/lib/commands/ListCommand.ts +85 -0
  143. package/botrun-c/admin/lib/commands/QueryCommand.ts +81 -0
  144. package/botrun-c/admin/lib/commands/SpikeCommand.ts +83 -0
  145. package/botrun-c/admin/lib/domain/User.ts +38 -0
  146. package/botrun-c/admin/lib/firebase.ts +92 -0
  147. package/botrun-c/admin/lib/firestore-safe.ts +105 -0
  148. package/botrun-c/admin/lib/formatters.ts +154 -0
  149. package/botrun-c/admin/lib/rate-limit-detailed.ts +355 -0
  150. package/botrun-c/admin/lib/rate-limit.ts +286 -0
  151. package/botrun-c/admin/lib/repositories/UserRepository.ts +104 -0
  152. package/botrun-c/admin/lib/services/UserService.ts +108 -0
  153. package/botrun-c/admin/lib/types.ts +56 -0
  154. package/botrun-c/admin/lib/user-resolver.ts +275 -0
  155. package/botrun-c/admin/manage-auth-domains.js +178 -0
  156. package/botrun-c/admin/migrate-plan-free.sh +64 -0
  157. package/botrun-c/admin/package-lock.json +5656 -0
  158. package/botrun-c/admin/package.json +28 -0
  159. package/botrun-c/admin/rate-limit.sh +55 -0
  160. package/botrun-c/admin/remove-custom-limits.ts +75 -0
  161. package/botrun-c/admin/reset-rate.sh +70 -0
  162. package/botrun-c/admin/reset-trial.sh +68 -0
  163. package/botrun-c/admin/seed-trial-data.sh +38 -0
  164. package/botrun-c/admin/trial.sh +55 -0
  165. package/botrun-c/admin/tsconfig.json +20 -0
  166. package/botrun-c/admin/users-cli.py +298 -0
  167. package/botrun-c/admin/users.sh +12 -0
  168. package/botrun-c/admin/users.ts +1321 -0
  169. package/botrun-c/api/admin-tools/check-whitelist.mjs.migration-bak +74 -0
  170. package/botrun-c/api/admin-tools/create-user.mjs +92 -0
  171. package/botrun-c/api/admin-tools/create-user.mjs.migration-bak +92 -0
  172. package/botrun-c/api/admin-tools/firebase-auth-domains-v2.py +287 -0
  173. package/botrun-c/api/admin-tools/firebase-auth-domains-v2.py.migration-bak +287 -0
  174. package/botrun-c/api/admin-tools/init-firestore.mjs +75 -0
  175. package/botrun-c/api/admin-tools/init-firestore.mjs.migration-bak +101 -0
  176. package/botrun-c/api/admin-tools/list-users.mjs +43 -0
  177. package/botrun-c/api/admin-tools/list-users.mjs.migration-bak +43 -0
  178. package/botrun-c/api/admin-tools/manage-authorized-domains.ts +255 -0
  179. package/botrun-c/api/admin-tools/manage-authorized-domains.ts.migration-bak +255 -0
  180. package/botrun-c/api/admin-tools/setup-custom-claims.ts.migration-bak +155 -0
  181. package/botrun-c/api/admin-tools/test-claims.mjs +69 -0
  182. package/botrun-c/api/admin-tools/test-claims.mjs.migration-bak +69 -0
  183. package/botrun-c/api/admin-tools/update-service-urls-gcloud.mjs +72 -0
  184. package/botrun-c/api/admin-tools/update-service-urls-gcloud.mjs.migration-bak +72 -0
  185. package/botrun-c/api/admin-tools/update-service-urls-to-lb.mjs +159 -0
  186. package/botrun-c/api/admin-tools/update-service-urls-to-lb.mjs.migration-bak +159 -0
  187. package/botrun-c/api/admin-tools/update-service-urls.mjs +82 -0
  188. package/botrun-c/api/admin-tools/update-service-urls.mjs.migration-bak +82 -0
  189. package/botrun-c/api/package-lock.json +5031 -0
  190. package/botrun-c/api/package.json +63 -0
  191. package/botrun-c/api/pnpm-lock.yaml +4157 -0
  192. package/botrun-c/api/rate-limit-export-1763620678737.csv +79 -0
  193. package/botrun-c/api/scripts/README-migrate-plan-free.md +197 -0
  194. package/botrun-c/api/scripts/check-users.ts +45 -0
  195. package/botrun-c/api/scripts/delete-firestore-docs.js +43 -0
  196. package/botrun-c/api/scripts/dump-subscriptions.ts +395 -0
  197. package/botrun-c/api/scripts/list-all-users.ts +65 -0
  198. package/botrun-c/api/scripts/migrate-plan-free-rpd-16to32.ts +262 -0
  199. package/botrun-c/api/scripts/migrate-plan-names-to-lite-max.ts +269 -0
  200. package/botrun-c/api/scripts/query-user-info.ts +304 -0
  201. package/botrun-c/api/scripts/reset-rate-limit.ts +206 -0
  202. package/botrun-c/api/scripts/reset-trial-subscription.ts +166 -0
  203. package/botrun-c/api/scripts/rollback-plan-names-from-lite-max.ts +139 -0
  204. package/botrun-c/api/scripts/seed-rate-limit-test-data.ts +114 -0
  205. package/botrun-c/api/scripts/seed-subscription-test-data.ts +173 -0
  206. package/botrun-c/api/scripts/test-rate-limit-message.ts +108 -0
  207. package/botrun-c/api/test-billing-write.ts +103 -0
  208. package/botrun-c/api/test-billing.ts +81 -0
  209. package/botrun-c/api/test-chat-upload.sh +162 -0
  210. package/botrun-c/api/test-nchc-whisper.ts +87 -0
  211. package/botrun-c/api/test-skills-loading.js +77 -0
  212. package/botrun-c/api/test-skills-symlink.js +118 -0
  213. package/botrun-c/api/test-upload-multimodal.sh +167 -0
  214. package/botrun-c/api/tsconfig.json +27 -0
  215. package/botrun-c/api/verify-form-2-1.mjs +229 -0
  216. package/botrun-c/api/vitest.config.ts +9 -0
  217. package/botrun-c/appium-capabilities.json +20 -0
  218. package/botrun-c/cors.json +26 -0
  219. package/botrun-c/delete-old.sh +44 -0
  220. package/botrun-c/design/google-drive/01-architecture.md +186 -0
  221. package/botrun-c/design/google-drive/02-api-design.md +314 -0
  222. package/botrun-c/design/google-drive/03-frontend-design.md +278 -0
  223. package/botrun-c/design/google-drive/04-skill-design.md +384 -0
  224. package/botrun-c/design/google-drive/05-test-plan.md +507 -0
  225. package/botrun-c/design/google-drive/README.md +32 -0
  226. package/botrun-c/dev/mcp-token-calculator/README.md +92 -0
  227. package/botrun-c/dev/mcp-token-calculator/RESULTS.md +188 -0
  228. package/botrun-c/dev/mcp-token-calculator/calculate-current-tokens.ts +369 -0
  229. package/botrun-c/dev/mcp-token-calculator/calculate-mcp-tokens.ts +464 -0
  230. package/botrun-c/dev/mcp-token-calculator/optimization-proposals.ts +316 -0
  231. package/botrun-c/dev/mcp-token-calculator/package-lock.json +599 -0
  232. package/botrun-c/dev/mcp-token-calculator/package.json +22 -0
  233. package/botrun-c/dev/mcp-token-calculator/test-all-schemas.ts +314 -0
  234. package/botrun-c/dev/mcp-token-calculator/test-schema-correctness.ts +221 -0
  235. package/botrun-c/dev/mcp-token-calculator/verify-optimization.ts +159 -0
  236. package/botrun-c/fastlane/ANDROID-DEPLOYMENT-SETUP.md +825 -0
  237. package/botrun-c/fastlane/IOS-DEPLOYMENT-SETUP.md +431 -0
  238. package/botrun-c/fastlane/Pluginfile +5 -0
  239. package/botrun-c/fastlane/QUICK-START.md +133 -0
  240. package/botrun-c/fastlane/README.md +424 -0
  241. package/botrun-c/fastlane/RUBY-SETUP.md +449 -0
  242. package/botrun-c/fastlane/android/Appfile +11 -0
  243. package/botrun-c/fastlane/android/Fastfile +240 -0
  244. package/botrun-c/firebase.json +46 -0
  245. package/botrun-c/firestore-init-data.json +40 -0
  246. package/botrun-c/firestore.indexes.json +55 -0
  247. package/botrun-c/firestore.rules +53 -0
  248. package/botrun-c/fix-codex-permissions.sh +56 -0
  249. package/botrun-c/gcs-lifecycle-30day-retention.json +12 -0
  250. package/botrun-c/html-architecture/architecture/deployment.html +664 -0
  251. package/botrun-c/html-architecture/architecture/index.html +309 -0
  252. package/botrun-c/html-architecture/architecture/styles.css +500 -0
  253. package/botrun-c/html-architecture/architecture/system-components.html +538 -0
  254. package/botrun-c/html-architecture/architecture/user-flow.html +370 -0
  255. package/botrun-c/mobile-android/FIREBASE-AUTH-SETUP.md +302 -0
  256. package/botrun-c/mobile-android/WSL-ANDROID-SETUP.md +252 -0
  257. package/botrun-c/mobile-android/android/app/build.gradle +75 -0
  258. package/botrun-c/mobile-android/android/app/capacitor.build.gradle +31 -0
  259. package/botrun-c/mobile-android/android/app/proguard-rules.pro +21 -0
  260. package/botrun-c/mobile-android/android/build.gradle +29 -0
  261. package/botrun-c/mobile-android/android/capacitor.settings.gradle +42 -0
  262. package/botrun-c/mobile-android/android/gradle/wrapper/gradle-wrapper.jar +0 -0
  263. package/botrun-c/mobile-android/android/gradle/wrapper/gradle-wrapper.properties +7 -0
  264. package/botrun-c/mobile-android/android/gradle.properties +22 -0
  265. package/botrun-c/mobile-android/android/gradlew +252 -0
  266. package/botrun-c/mobile-android/android/gradlew.bat +94 -0
  267. package/botrun-c/mobile-android/android/settings.gradle +5 -0
  268. package/botrun-c/mobile-android/android/variables.gradle +16 -0
  269. package/botrun-c/mobile-android/capacitor.config.ts +44 -0
  270. package/botrun-c/mobile-android/fastlane/Appfile +11 -0
  271. package/botrun-c/mobile-android/fastlane/Fastfile +202 -0
  272. package/botrun-c/mobile-android/fastlane/README.md +96 -0
  273. package/botrun-c/mobile-android/google-services.json.template +39 -0
  274. package/botrun-c/mobile-android/package.json +32 -0
  275. package/botrun-c/mobile-android/resources/icon.png +0 -0
  276. package/botrun-c/mobile-android/tsconfig.json +15 -0
  277. package/botrun-c/mobile-ios/.ruby-version +1 -0
  278. package/botrun-c/mobile-ios/BUILD-LOG.md +82 -0
  279. package/botrun-c/mobile-ios/Gemfile +4 -0
  280. package/botrun-c/mobile-ios/Gemfile.lock +299 -0
  281. package/botrun-c/mobile-ios/GoogleService-Info.plist.template +34 -0
  282. package/botrun-c/mobile-ios/IOS-PERMISSIONS.md +80 -0
  283. package/botrun-c/mobile-ios/QUICK-START.md +189 -0
  284. package/botrun-c/mobile-ios/README.md +231 -0
  285. package/botrun-c/mobile-ios/capacitor.config.ts +46 -0
  286. package/botrun-c/mobile-ios/fastlane/Fastfile +326 -0
  287. package/botrun-c/mobile-ios/fastlane/README.md +88 -0
  288. package/botrun-c/mobile-ios/ios/App/App/App.entitlements +10 -0
  289. package/botrun-c/mobile-ios/ios/App/App/AppDelegate.swift +49 -0
  290. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/AppIcon.appiconset/AppIcon-512@2x.png +0 -0
  291. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json +14 -0
  292. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Contents.json +6 -0
  293. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Contents.json +56 -0
  294. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@1x~universal~anyany-dark.png +0 -0
  295. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@1x~universal~anyany.png +0 -0
  296. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@2x~universal~anyany-dark.png +0 -0
  297. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@2x~universal~anyany.png +0 -0
  298. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@3x~universal~anyany-dark.png +0 -0
  299. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/Default@3x~universal~anyany.png +0 -0
  300. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-1.png +0 -0
  301. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732-2.png +0 -0
  302. package/botrun-c/mobile-ios/ios/App/App/Assets.xcassets/Splash.imageset/splash-2732x2732.png +0 -0
  303. package/botrun-c/mobile-ios/ios/App/App/Base.lproj/LaunchScreen.storyboard +32 -0
  304. package/botrun-c/mobile-ios/ios/App/App/Base.lproj/Main.storyboard +19 -0
  305. package/botrun-c/mobile-ios/ios/App/App/Info.plist +72 -0
  306. package/botrun-c/mobile-ios/ios/App/App.xcodeproj/project.pbxproj +446 -0
  307. package/botrun-c/mobile-ios/ios/App/App.xcodeproj/xcshareddata/xcschemes/App.xcscheme +78 -0
  308. package/botrun-c/mobile-ios/ios/App/App.xcworkspace/contents.xcworkspacedata +10 -0
  309. package/botrun-c/mobile-ios/ios/App/App.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  310. package/botrun-c/mobile-ios/ios/App/Podfile +52 -0
  311. package/botrun-c/mobile-ios/ios/App/Podfile.lock +205 -0
  312. package/botrun-c/mobile-ios/ios/App/add_plist.rb +30 -0
  313. package/botrun-c/mobile-ios/ios/App/fix_plist_path.rb +22 -0
  314. package/botrun-c/mobile-ios/package.json +29 -0
  315. package/botrun-c/mobile-ios/resources/icon.png +0 -0
  316. package/botrun-c/mobile-ios/run-simulator.sh +34 -0
  317. package/botrun-c/mobile-ios/screenshot-after-clean-rebuild.png +0 -0
  318. package/botrun-c/mobile-ios/screenshot-final-version.png +0 -0
  319. package/botrun-c/mobile-ios/screenshot-simulator.png +0 -0
  320. package/botrun-c/mobile-ios/screenshot-version-1009.png +0 -0
  321. package/botrun-c/mobile-ios/screenshot-with-version.png +0 -0
  322. package/botrun-c/mobile-ios/screenshot-working.png +0 -0
  323. package/botrun-c/mobile-ios/setup-ios.sh +106 -0
  324. package/botrun-c/mobile-ios/tsconfig.json +16 -0
  325. package/botrun-c/org-policy-allow-all-users.yaml +3 -0
  326. package/botrun-c/package.json +68 -0
  327. package/botrun-c/pnpm-lock.yaml +10198 -0
  328. package/botrun-c/pnpm-workspace.yaml +6 -0
  329. package/botrun-c/prompts/BOTRUN-1.md +13 -0
  330. package/botrun-c/prompts/BOTRUN-2.md +70 -0
  331. package/botrun-c/prompts/BOTRUN-3.md +139 -0
  332. package/botrun-c/prototypes/firestore-gax-debug/package-lock.json +1204 -0
  333. package/botrun-c/prototypes/firestore-gax-debug/package.json +12 -0
  334. package/botrun-c/prototypes/firestore-gax-debug/pnpm-workspace.yaml +2 -0
  335. package/botrun-c/prototypes/firestore-gax-debug/test.js +98 -0
  336. package/botrun-c/prototypes/taiwan-haiku/README.md +93 -0
  337. package/botrun-c/prototypes/taiwan-haiku/index.ts +139 -0
  338. package/botrun-c/prototypes/taiwan-haiku/package.json +23 -0
  339. package/botrun-c/prototypes/taiwan-haiku/pnpm-lock.yaml +730 -0
  340. package/botrun-c/prototypes/taiwan-haiku/test-vertex-direct.ts +83 -0
  341. package/botrun-c/prototypes/taiwan-haiku/tsconfig.json +18 -0
  342. package/botrun-c/prototypes/web-search/FINDINGS-STAGE-1.md +48 -0
  343. package/botrun-c/prototypes/web-search/README.md +46 -0
  344. package/botrun-c/prototypes/web-search/VERIFICATION-REPORT.md +310 -0
  345. package/botrun-c/prototypes/web-search/package-lock.json +595 -0
  346. package/botrun-c/prototypes/web-search/package.json +18 -0
  347. package/botrun-c/prototypes/web-search/stage-1.1-basic-connection.js +123 -0
  348. package/botrun-c/prototypes/web-search/stage-1.2-with-websearch.js +154 -0
  349. package/botrun-c/prototypes/web-search/stage-1.3-search-query.js +192 -0
  350. package/botrun-c/prototypes/web-search/stage-2-agent-sdk-websearch.js +265 -0
  351. package/botrun-c/runtime-scripts/env-detect.sh +64 -0
  352. package/botrun-c/scripts/github-collaborator-manager.sh +297 -0
  353. package/botrun-c/scripts/github-collaborator-manager.ts +325 -0
  354. package/botrun-c/scripts/manage-collaborators.sh +91 -0
  355. package/botrun-c/scripts/setup-secrets.sh +202 -0
  356. package/botrun-c/scripts/stress-test-17-users.sh +113 -0
  357. package/botrun-c/scripts/stress-test-api.sh +119 -0
  358. package/botrun-c/scripts/stress-test-full-report.sh +385 -0
  359. package/botrun-c/specs/infra-vm/design.md +0 -0
  360. package/botrun-c/specs/share-skill/design.md +1146 -0
  361. package/botrun-c/specs/share-skill/tasks.md +444 -0
  362. package/botrun-c/stress-test-results/20260121-162630/config.json +7 -0
  363. package/botrun-c/stress-test-results/20260121-162630/user-1-status.txt +1 -0
  364. package/botrun-c/stress-test-results/20260121-162630/user-1-timing.txt +1 -0
  365. package/botrun-c/stress-test-results/20260121-162630/user-1.json +2 -0
  366. package/botrun-c/stress-test-results/20260121-162646/config.json +7 -0
  367. package/botrun-c/stress-test-results/20260121-162646/user-1-status.txt +1 -0
  368. package/botrun-c/stress-test-results/20260121-162646/user-1-timing.txt +1 -0
  369. package/botrun-c/stress-test-results/20260121-162646/user-1.json +2 -0
  370. package/botrun-c/stress-test-results/20260121-162646/user-10-status.txt +1 -0
  371. package/botrun-c/stress-test-results/20260121-162646/user-10-timing.txt +1 -0
  372. package/botrun-c/stress-test-results/20260121-162646/user-10.json +2 -0
  373. package/botrun-c/stress-test-results/20260121-162646/user-11-status.txt +1 -0
  374. package/botrun-c/stress-test-results/20260121-162646/user-11-timing.txt +1 -0
  375. package/botrun-c/stress-test-results/20260121-162646/user-11.json +2 -0
  376. package/botrun-c/stress-test-results/20260121-162646/user-12-status.txt +1 -0
  377. package/botrun-c/stress-test-results/20260121-162646/user-12-timing.txt +1 -0
  378. package/botrun-c/stress-test-results/20260121-162646/user-12.json +2 -0
  379. package/botrun-c/stress-test-results/20260121-162646/user-13-status.txt +1 -0
  380. package/botrun-c/stress-test-results/20260121-162646/user-13-timing.txt +1 -0
  381. package/botrun-c/stress-test-results/20260121-162646/user-13.json +2 -0
  382. package/botrun-c/stress-test-results/20260121-162646/user-14-status.txt +1 -0
  383. package/botrun-c/stress-test-results/20260121-162646/user-14-timing.txt +1 -0
  384. package/botrun-c/stress-test-results/20260121-162646/user-14.json +2 -0
  385. package/botrun-c/stress-test-results/20260121-162646/user-15-status.txt +1 -0
  386. package/botrun-c/stress-test-results/20260121-162646/user-15-timing.txt +1 -0
  387. package/botrun-c/stress-test-results/20260121-162646/user-15.json +2 -0
  388. package/botrun-c/stress-test-results/20260121-162646/user-16-status.txt +1 -0
  389. package/botrun-c/stress-test-results/20260121-162646/user-16-timing.txt +1 -0
  390. package/botrun-c/stress-test-results/20260121-162646/user-16.json +2 -0
  391. package/botrun-c/stress-test-results/20260121-162646/user-17-status.txt +1 -0
  392. package/botrun-c/stress-test-results/20260121-162646/user-17-timing.txt +1 -0
  393. package/botrun-c/stress-test-results/20260121-162646/user-17.json +2 -0
  394. package/botrun-c/stress-test-results/20260121-162646/user-2-status.txt +1 -0
  395. package/botrun-c/stress-test-results/20260121-162646/user-2-timing.txt +1 -0
  396. package/botrun-c/stress-test-results/20260121-162646/user-2.json +2 -0
  397. package/botrun-c/stress-test-results/20260121-162646/user-3-status.txt +1 -0
  398. package/botrun-c/stress-test-results/20260121-162646/user-3-timing.txt +1 -0
  399. package/botrun-c/stress-test-results/20260121-162646/user-3.json +2 -0
  400. package/botrun-c/stress-test-results/20260121-162646/user-4-status.txt +1 -0
  401. package/botrun-c/stress-test-results/20260121-162646/user-4-timing.txt +1 -0
  402. package/botrun-c/stress-test-results/20260121-162646/user-4.json +2 -0
  403. package/botrun-c/stress-test-results/20260121-162646/user-5-status.txt +1 -0
  404. package/botrun-c/stress-test-results/20260121-162646/user-5-timing.txt +1 -0
  405. package/botrun-c/stress-test-results/20260121-162646/user-5.json +2 -0
  406. package/botrun-c/stress-test-results/20260121-162646/user-6-status.txt +1 -0
  407. package/botrun-c/stress-test-results/20260121-162646/user-6-timing.txt +1 -0
  408. package/botrun-c/stress-test-results/20260121-162646/user-6.json +2 -0
  409. package/botrun-c/stress-test-results/20260121-162646/user-7-status.txt +1 -0
  410. package/botrun-c/stress-test-results/20260121-162646/user-7-timing.txt +1 -0
  411. package/botrun-c/stress-test-results/20260121-162646/user-7.json +2 -0
  412. package/botrun-c/stress-test-results/20260121-162646/user-8-status.txt +1 -0
  413. package/botrun-c/stress-test-results/20260121-162646/user-8-timing.txt +1 -0
  414. package/botrun-c/stress-test-results/20260121-162646/user-8.json +2 -0
  415. package/botrun-c/stress-test-results/20260121-162646/user-9-status.txt +1 -0
  416. package/botrun-c/stress-test-results/20260121-162646/user-9-timing.txt +1 -0
  417. package/botrun-c/stress-test-results/20260121-162646/user-9.json +2 -0
  418. package/botrun-c/stress-test-results/20260121-163148/REPORT.html +344 -0
  419. package/botrun-c/stress-test-results/20260121-163148/REPORT.md +93 -0
  420. package/botrun-c/stress-test-results/20260121-163148/REPORT.pdf +0 -0
  421. package/botrun-c/stress-test-results/20260121-163148/config.json +7 -0
  422. package/botrun-c/stress-test-results/20260121-163148/summary.json +26 -0
  423. package/botrun-c/stress-test-results/20260121-163148/user-1-status.txt +1 -0
  424. package/botrun-c/stress-test-results/20260121-163148/user-1-timing.txt +1 -0
  425. package/botrun-c/stress-test-results/20260121-163148/user-1.json +206 -0
  426. package/botrun-c/stress-test-results/20260121-163148/user-10-status.txt +1 -0
  427. package/botrun-c/stress-test-results/20260121-163148/user-10-timing.txt +1 -0
  428. package/botrun-c/stress-test-results/20260121-163148/user-10.json +110 -0
  429. package/botrun-c/stress-test-results/20260121-163148/user-11-status.txt +1 -0
  430. package/botrun-c/stress-test-results/20260121-163148/user-11-timing.txt +1 -0
  431. package/botrun-c/stress-test-results/20260121-163148/user-11.json +104 -0
  432. package/botrun-c/stress-test-results/20260121-163148/user-12-status.txt +1 -0
  433. package/botrun-c/stress-test-results/20260121-163148/user-12-timing.txt +1 -0
  434. package/botrun-c/stress-test-results/20260121-163148/user-12.json +98 -0
  435. package/botrun-c/stress-test-results/20260121-163148/user-13-status.txt +1 -0
  436. package/botrun-c/stress-test-results/20260121-163148/user-13-timing.txt +1 -0
  437. package/botrun-c/stress-test-results/20260121-163148/user-13.json +68 -0
  438. package/botrun-c/stress-test-results/20260121-163148/user-14-status.txt +1 -0
  439. package/botrun-c/stress-test-results/20260121-163148/user-14-timing.txt +1 -0
  440. package/botrun-c/stress-test-results/20260121-163148/user-14.json +116 -0
  441. package/botrun-c/stress-test-results/20260121-163148/user-15-status.txt +1 -0
  442. package/botrun-c/stress-test-results/20260121-163148/user-15-timing.txt +1 -0
  443. package/botrun-c/stress-test-results/20260121-163148/user-15.json +131 -0
  444. package/botrun-c/stress-test-results/20260121-163148/user-16-status.txt +1 -0
  445. package/botrun-c/stress-test-results/20260121-163148/user-16-timing.txt +1 -0
  446. package/botrun-c/stress-test-results/20260121-163148/user-16.json +110 -0
  447. package/botrun-c/stress-test-results/20260121-163148/user-17-status.txt +1 -0
  448. package/botrun-c/stress-test-results/20260121-163148/user-17-timing.txt +1 -0
  449. package/botrun-c/stress-test-results/20260121-163148/user-17.json +116 -0
  450. package/botrun-c/stress-test-results/20260121-163148/user-2-status.txt +1 -0
  451. package/botrun-c/stress-test-results/20260121-163148/user-2-timing.txt +1 -0
  452. package/botrun-c/stress-test-results/20260121-163148/user-2.json +98 -0
  453. package/botrun-c/stress-test-results/20260121-163148/user-3-status.txt +1 -0
  454. package/botrun-c/stress-test-results/20260121-163148/user-3-timing.txt +1 -0
  455. package/botrun-c/stress-test-results/20260121-163148/user-3.json +62 -0
  456. package/botrun-c/stress-test-results/20260121-163148/user-4-status.txt +1 -0
  457. package/botrun-c/stress-test-results/20260121-163148/user-4-timing.txt +1 -0
  458. package/botrun-c/stress-test-results/20260121-163148/user-4.json +113 -0
  459. package/botrun-c/stress-test-results/20260121-163148/user-5-status.txt +1 -0
  460. package/botrun-c/stress-test-results/20260121-163148/user-5-timing.txt +1 -0
  461. package/botrun-c/stress-test-results/20260121-163148/user-5.json +83 -0
  462. package/botrun-c/stress-test-results/20260121-163148/user-6-status.txt +1 -0
  463. package/botrun-c/stress-test-results/20260121-163148/user-6-timing.txt +1 -0
  464. package/botrun-c/stress-test-results/20260121-163148/user-6.json +125 -0
  465. package/botrun-c/stress-test-results/20260121-163148/user-7-status.txt +1 -0
  466. package/botrun-c/stress-test-results/20260121-163148/user-7-timing.txt +1 -0
  467. package/botrun-c/stress-test-results/20260121-163148/user-7.json +62 -0
  468. package/botrun-c/stress-test-results/20260121-163148/user-8-status.txt +1 -0
  469. package/botrun-c/stress-test-results/20260121-163148/user-8-timing.txt +1 -0
  470. package/botrun-c/stress-test-results/20260121-163148/user-8.json +41 -0
  471. package/botrun-c/stress-test-results/20260121-163148/user-9-status.txt +1 -0
  472. package/botrun-c/stress-test-results/20260121-163148/user-9-timing.txt +1 -0
  473. package/botrun-c/stress-test-results/20260121-163148/user-9.json +53 -0
  474. package/botrun-c/test-merge.md +1 -0
  475. package/botrun-c/version.txt +1 -0
  476. package/botrun-c/web/.version +1 -0
  477. package/botrun-c/web/ALLOW-PUBLIC-ACCESS.md +57 -0
  478. package/botrun-c/web/FINAL-SETUP-STEPS.md +71 -0
  479. package/botrun-c/web/FIREBASE-MANUAL-STEPS.md +41 -0
  480. package/botrun-c/web/QUICK-SETUP-HELPER.md +79 -0
  481. package/botrun-c/web/README.md +162 -0
  482. package/botrun-c/web/__tests__/image-extractor.test.ts +147 -0
  483. package/botrun-c/web/__tests__/useGitHub.test.ts +245 -0
  484. package/botrun-c/web/app/favicon.ico +0 -0
  485. package/botrun-c/web/app/globals.css +215 -0
  486. package/botrun-c/web/app/image-preview/page.tsx +213 -0
  487. package/botrun-c/web/app/layout.tsx +46 -0
  488. package/botrun-c/web/app/page.tsx +45 -0
  489. package/botrun-c/web/components/CapacitorProvider.tsx +43 -0
  490. package/botrun-c/web/components/ChatPage.tsx +1736 -0
  491. package/botrun-c/web/components/ConversationList.tsx +237 -0
  492. package/botrun-c/web/components/ConversationListItem.tsx +121 -0
  493. package/botrun-c/web/components/LoginPage.tsx +212 -0
  494. package/botrun-c/web/components/Providers.tsx +12 -0
  495. package/botrun-c/web/components/StatusBarProvider.tsx +16 -0
  496. package/botrun-c/web/components/attachment-preview.tsx +193 -0
  497. package/botrun-c/web/components/botrun-incubator/BotrunIncubator.tsx +266 -0
  498. package/botrun-c/web/components/botrun-incubator/index.ts +1 -0
  499. package/botrun-c/web/components/chat-input.tsx +1251 -0
  500. package/botrun-c/web/components/chat-message.tsx +598 -0
  501. package/botrun-c/web/components/drop-zone.tsx +143 -0
  502. package/botrun-c/web/components/gdrive/gdrive-add-dialog.tsx +254 -0
  503. package/botrun-c/web/components/gdrive/gdrive-drawer.tsx +236 -0
  504. package/botrun-c/web/components/gdrive/gdrive-selector.tsx +226 -0
  505. package/botrun-c/web/components/gdrive/index.ts +7 -0
  506. package/botrun-c/web/components/generated-image-card.tsx +363 -0
  507. package/botrun-c/web/components/github/GitHubConnect.tsx +366 -0
  508. package/botrun-c/web/components/github/index.ts +2 -0
  509. package/botrun-c/web/components/import-skill-dialog.tsx +208 -0
  510. package/botrun-c/web/components/scroll-to-bottom-button.tsx +90 -0
  511. package/botrun-c/web/components/share-skill-dialog.tsx +175 -0
  512. package/botrun-c/web/components/skills-editor.tsx +443 -0
  513. package/botrun-c/web/components/skills-manager-drawer.tsx +586 -0
  514. package/botrun-c/web/components/smart-button-group.tsx +132 -0
  515. package/botrun-c/web/config/smart-buttons.ts +295 -0
  516. package/botrun-c/web/config/welcome-messages.ts +29 -0
  517. package/botrun-c/web/contexts/AuthContext.tsx +220 -0
  518. package/botrun-c/web/hooks/use-toast.ts +187 -0
  519. package/botrun-c/web/hooks/useAppStoreUpdate.ts +356 -0
  520. package/botrun-c/web/hooks/useAppVersion.ts +113 -0
  521. package/botrun-c/web/hooks/useAttachments.ts +269 -0
  522. package/botrun-c/web/hooks/useAuthToken.ts +59 -0
  523. package/botrun-c/web/hooks/useAutoWelcome.ts +89 -0
  524. package/botrun-c/web/hooks/useCapacitorPlatform.ts +113 -0
  525. package/botrun-c/web/hooks/useCapawesomeLiveUpdate.ts +149 -0
  526. package/botrun-c/web/hooks/useClaudeModel.ts +118 -0
  527. package/botrun-c/web/hooks/useConversation.ts +115 -0
  528. package/botrun-c/web/hooks/useConversations.ts +235 -0
  529. package/botrun-c/web/hooks/useGdriveFolders.ts +199 -0
  530. package/botrun-c/web/hooks/useGdriveSync.ts +107 -0
  531. package/botrun-c/web/hooks/useGitHub.ts +409 -0
  532. package/botrun-c/web/hooks/useScrollToBottom.ts +150 -0
  533. package/botrun-c/web/hooks/useStatusBar.ts +42 -0
  534. package/botrun-c/web/hooks/useUserPlan.ts +153 -0
  535. package/botrun-c/web/lib/api-config.ts +162 -0
  536. package/botrun-c/web/lib/api-url.ts +62 -0
  537. package/botrun-c/web/lib/api.ts +105 -0
  538. package/botrun-c/web/lib/attachment-utils.ts +168 -0
  539. package/botrun-c/web/lib/build-version.ts +11 -0
  540. package/botrun-c/web/lib/clipboard-utils.ts +199 -0
  541. package/botrun-c/web/lib/constants.ts +62 -0
  542. package/botrun-c/web/lib/conversation-storage.ts +324 -0
  543. package/botrun-c/web/lib/firebase-capacitor.ts +135 -0
  544. package/botrun-c/web/lib/firebase.ts +137 -0
  545. package/botrun-c/web/lib/firestore-auth.ts +61 -0
  546. package/botrun-c/web/lib/firestore-auth.ts.migration-bak +319 -0
  547. package/botrun-c/web/lib/image-extractor.ts +156 -0
  548. package/botrun-c/web/lib/path-utils.ts +48 -0
  549. package/botrun-c/web/lib/rehype-del-to-mark.ts +19 -0
  550. package/botrun-c/web/lib/upload-service.ts +326 -0
  551. package/botrun-c/web/lib/utils.ts +6 -0
  552. package/botrun-c/web/next.config.js +49 -0
  553. package/botrun-c/web/package-lock.json +6711 -0
  554. package/botrun-c/web/package.json +63 -0
  555. package/botrun-c/web/postcss.config.js +6 -0
  556. package/botrun-c/web/public/apple_icon.png +0 -0
  557. package/botrun-c/web/public/google_icon.png +0 -0
  558. package/botrun-c/web/public/logo-48-small.png +0 -0
  559. package/botrun-c/web/public/logo-48.png +0 -0
  560. package/botrun-c/web/scripts/generate-version.js +36 -0
  561. package/botrun-c/web/scripts/update-build-version.js +41 -0
  562. package/botrun-c/web/tailwind.config.ts +80 -0
  563. package/botrun-c/web/test-welcome-message.mjs +115 -0
  564. package/botrun-c/web/tsconfig.json +42 -0
  565. package/botrun-c/web/types/agent.ts +6 -0
  566. package/botrun-c/web/types/attachment.ts +39 -0
  567. package/botrun-c/web/types/conversation.ts +68 -0
  568. package/botrun-c/web/types/flutter.d.ts +6 -0
  569. package/botrun-c/web/types/project.ts +41 -0
  570. package/botrun-c/web/types/skills.ts +13 -0
  571. package/botrun-c/web//350/250/272/346/226/267-Skills-/345/211/215/347/253/257/351/241/257/347/244/272/345/225/217/351/241/214.md +83 -0
  572. package/lib/prompt/prompts/zero-framework/fullstack.md +17 -0
  573. package/lib/prompt/prompts/zero-framework/segment.md +13 -0
  574. package/package.json +1 -1
@@ -0,0 +1,162 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * finalize-project.mjs - 完成 HTML 專案並產生預覽連結
4
+ *
5
+ * 用法:node finalize-project.mjs --project <projectId>
6
+ *
7
+ * 功能:
8
+ * - 自動掃描專案目錄中的所有檔案
9
+ * - 更新 manifest.json 的檔案列表
10
+ * - 輸出預覽連結(可直接在瀏覽器開啟)
11
+ *
12
+ * URL 格式:/api/html-preview/{hashedUserId}/{token}
13
+ * - hashedUserId = sha256(userId + secret).slice(0, 8)
14
+ */
15
+ import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'fs';
16
+ import { join, relative } from 'path';
17
+ import { parseArgs } from 'util';
18
+ import { createHash } from 'crypto';
19
+
20
+ /**
21
+ * 產生 hashed userId(8 字元)
22
+ * 必須與 api/src/routes/html-preview.ts 中的 hashUserId 函數保持一致
23
+ */
24
+ function hashUserId(userId) {
25
+ const secret = process.env.HTML_PREVIEW_SECRET || 'botrun-html-preview-2024';
26
+ return createHash('sha256')
27
+ .update(userId + secret)
28
+ .digest('hex')
29
+ .substring(0, 8);
30
+ }
31
+
32
+ // 解析命令列參數
33
+ const { values } = parseArgs({
34
+ options: {
35
+ project: { type: 'string', short: 'p' },
36
+ },
37
+ strict: true,
38
+ });
39
+
40
+ const projectId = values.project;
41
+
42
+ if (!projectId) {
43
+ console.error('錯誤:必須提供 --project 參數');
44
+ console.error('用法:node finalize-project.mjs --project <projectId>');
45
+ process.exit(1);
46
+ }
47
+
48
+ // 取得使用者工作目錄
49
+ // DATA_ROOT = /mnt/data(資料根目錄)
50
+ // USER_ID = 使用者 ID
51
+ // 完整路徑 = /mnt/data/{userId}/projects/default/html-projects
52
+ const dataRoot = process.env.DATA_ROOT || join(process.cwd(), 'data');
53
+ const userId = process.env.USER_ID;
54
+
55
+ if (!userId) {
56
+ console.error('錯誤:缺少 USER_ID 環境變數');
57
+ process.exit(1);
58
+ }
59
+
60
+ // 專案路徑:/mnt/data/{userId}/projects/default/html-projects/{projectId}
61
+ const projectsRoot = join(dataRoot, userId, 'projects', 'default', 'html-projects');
62
+ const projectPath = join(projectsRoot, projectId);
63
+ const manifestPath = join(projectPath, 'manifest.json');
64
+
65
+ // 檢查專案是否存在
66
+ if (!existsSync(projectPath)) {
67
+ console.error(`錯誤:專案不存在: ${projectId}`);
68
+ process.exit(1);
69
+ }
70
+
71
+ // 檢查 index.html 是否存在
72
+ const indexPath = join(projectPath, 'index.html');
73
+ if (!existsSync(indexPath)) {
74
+ console.error('錯誤:專案缺少 index.html');
75
+ console.error('請先使用 Write 工具建立 index.html');
76
+ process.exit(1);
77
+ }
78
+
79
+ // 讀取並更新 manifest
80
+ let manifest;
81
+ try {
82
+ manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
83
+ } catch (error) {
84
+ console.error('錯誤:無法讀取 manifest.json');
85
+ process.exit(1);
86
+ }
87
+
88
+ // 自動掃描專案目錄,收集所有檔案
89
+ const allowedExtensions = ['.html', '.htm', '.css', '.js', '.mjs', '.json', '.txt', '.svg', '.png', '.jpg', '.jpeg', '.gif', '.ico', '.woff', '.woff2', '.ttf'];
90
+
91
+ function scanDirectory(dir, baseDir) {
92
+ const files = [];
93
+ const entries = readdirSync(dir, { withFileTypes: true });
94
+
95
+ for (const entry of entries) {
96
+ const fullPath = join(dir, entry.name);
97
+ const relativePath = relative(baseDir, fullPath);
98
+
99
+ if (entry.isDirectory()) {
100
+ // 遞迴掃描子目錄
101
+ files.push(...scanDirectory(fullPath, baseDir));
102
+ } else if (entry.isFile()) {
103
+ // 排除 manifest.json
104
+ if (entry.name === 'manifest.json') continue;
105
+
106
+ // 檢查副檔名
107
+ const ext = entry.name.substring(entry.name.lastIndexOf('.')).toLowerCase();
108
+ if (allowedExtensions.includes(ext)) {
109
+ files.push(relativePath);
110
+ }
111
+ }
112
+ }
113
+
114
+ return files;
115
+ }
116
+
117
+ // 掃描並更新檔案列表
118
+ const scannedFiles = scanDirectory(projectPath, projectPath);
119
+ manifest.files = scannedFiles;
120
+
121
+ // 更新狀態為已完成
122
+ manifest.status = 'completed';
123
+ manifest.completedAt = new Date().toISOString();
124
+
125
+ writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
126
+
127
+ // 取得 API 基礎 URL
128
+ const apiBaseUrl = process.env.API_BASE_URL || '';
129
+
130
+ // 輸出預覽資訊
131
+ console.log('');
132
+ console.log('═══════════════════════════════════════════════════════');
133
+ console.log(`✅ HTML 專案完成!`);
134
+ console.log('═══════════════════════════════════════════════════════');
135
+ console.log('');
136
+ console.log(`📦 專案名稱: ${manifest.name}`);
137
+ console.log(`📝 描述: ${manifest.description || '無'}`);
138
+ console.log(`📁 檔案數量: ${manifest.files.length}`);
139
+ console.log(` ${manifest.files.join(', ')}`);
140
+ console.log('');
141
+
142
+ // 產生 hashed userId
143
+ const hashedId = hashUserId(userId);
144
+
145
+ // 輸出特殊格式,讓前端可以偵測並渲染為可點擊連結
146
+ // 格式:<!-- html-preview:hashedUserId/projectId -->
147
+ // 前端會將此標記轉換為安全的 iframe 或新分頁連結
148
+ console.log('🔗 預覽連結:');
149
+ console.log('');
150
+ console.log(`<!-- html-preview:${hashedId}/${projectId} -->`);
151
+ console.log('');
152
+
153
+ // 同時輸出完整 URL 供使用者參考
154
+ if (apiBaseUrl) {
155
+ console.log(`📎 完整 URL: ${apiBaseUrl}/api/html-preview/${hashedId}/${projectId}/`);
156
+ } else {
157
+ console.log(`📎 相對路徑: /api/html-preview/${hashedId}/${projectId}/`);
158
+ }
159
+ console.log('');
160
+ console.log('💡 提示:點擊上方連結可在新分頁安全預覽網頁');
161
+ console.log('');
162
+ console.log('═══════════════════════════════════════════════════════');
@@ -0,0 +1,206 @@
1
+ ---
2
+ name: PDF技能
3
+ description: 智慧 PDF 閱讀助理。當使用者輸入本技能的完整名稱(「PDF技能」),即代表要求 AI 載入並啟動本技能。當使用者說「PDF」、「讀取 PDF」、「分析 PDF」、「PDF 技能」、「翻到第 X 頁」、「查看目錄」、「照片」、「圖片」、「圖表」、「圖像」、「多模態」、「多模態分析」、「多模態閱讀」或上傳 PDF 後提問時使用。根據檔案大小自動選擇策略:小檔案(<5MB)支援直接多模態閱讀;大檔案(≥5MB)自動切割+轉文字+智慧搜尋。(v5.1121.1500)
4
+ allowed-tools: Bash
5
+ ---
6
+
7
+ # 📄 PDF 技能(v2.0 智慧決策樹版)
8
+
9
+ ## 功能說明
10
+
11
+ 根據 PDF 檔案特徵自動選擇最佳處理策略:
12
+
13
+ | 類型 | 特徵 | 處理策略 |
14
+ |------|------|----------|
15
+ | **A 型** | < 5MB,小型文件 | 直接多模態閱讀 |
16
+ | **B 型** | ≥ 5MB,文字為主 | 壓縮 → 切割 → 純文字搜尋 |
17
+ | **C 型** | ≥ 5MB,掃描/圖表為主 | 激進壓縮 → 切割 → 多模態閱讀 |
18
+ | **D 型** | > 300 頁,超大文件 | 壓縮 → 切割 → 建索引 → 智慧搜尋 |
19
+
20
+ ## 觸發條件
21
+
22
+ - 使用者上傳 PDF 檔案
23
+ - 提到「PDF」、「讀取 PDF」、「分析 PDF」、「翻到第 X 頁」
24
+ - 詢問「照片」、「圖片」、「圖表」、「圖像」、「多模態」
25
+
26
+ ---
27
+
28
+ ## 執行流程
29
+
30
+ ### Step 1:分析 PDF
31
+
32
+ 執行分析腳本取得檔案特徵:
33
+
34
+ ```bash
35
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-analyze.mjs "檔案路徑"
36
+ ```
37
+
38
+ **輸出 JSON 包含:**
39
+ - `analysis.sizeBytes` - 檔案大小
40
+ - `analysis.pages` - 頁數
41
+ - `analysis.avgCharsPerPage` - 平均每頁文字數
42
+ - `classification.type` - 分類(A/B/C/D)
43
+ - `classification.recommendation` - 處理建議
44
+
45
+ ---
46
+
47
+ ### Step 2:分類判斷(決策樹)
48
+
49
+ 根據分析結果判斷文件類型:
50
+
51
+ ```
52
+ sizeBytes < 5MB?
53
+
54
+ ┌────┴────┐
55
+ YES NO
56
+ │ │
57
+ ▼ ▼
58
+ ┌─────┐ pages > 300?
59
+ │ A型 │ │
60
+ │直接讀│ ┌────┴────┐
61
+ └─────┘ YES NO
62
+ │ │
63
+ ▼ ▼
64
+ ┌─────┐ avgCharsPerPage > 1000?
65
+ │ D型 │ │
66
+ │超大 │ ┌────┴────┐
67
+ └─────┘ YES NO
68
+ │ │
69
+ ▼ ▼
70
+ ┌─────┐ ┌─────┐
71
+ │ B型 │ │ C型 │
72
+ │純文字│ │掃描 │
73
+ └─────┘ └─────┘
74
+ ```
75
+
76
+ ---
77
+
78
+ ### Step 3:詢問使用者意圖(B/C/D 型)
79
+
80
+ 若為大檔案(B/C/D 型),詢問使用者偏好:
81
+
82
+ > 「這是一份 **{pages}** 頁的 **{類型描述}** 文件({sizeMB} MB),您希望:」
83
+ > 1. **快速搜尋** - 純文字模式,搜尋特定內容
84
+ > 2. **詳細閱讀** - 多模態模式,查看圖表圖片
85
+ > 3. **全面分析** - 混合模式,文字+視覺
86
+
87
+ ---
88
+
89
+ ### Step 4:執行前處理
90
+
91
+ 根據類型執行對應處理:
92
+
93
+ #### A 型:直接使用
94
+ 無需前處理,直接進入問答階段。
95
+
96
+ #### B 型:純文字文件
97
+ ```bash
98
+ # 1. 保守壓縮(保留文字品質)
99
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "檔案路徑" --mode printer
100
+
101
+ # 2. 切割成單頁
102
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "壓縮後檔案"
103
+
104
+ # 3. 批次轉文字
105
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "切割目錄/"
106
+ ```
107
+
108
+ #### C 型:掃描/圖表文件
109
+ ```bash
110
+ # 1. 激進壓縮(大幅縮小圖片)
111
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "檔案路徑" --mode ebook
112
+
113
+ # 2. 切割成單頁
114
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "壓縮後檔案"
115
+
116
+ # 3. 批次轉文字(用於搜尋定位)
117
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "切割目錄/"
118
+ ```
119
+
120
+ #### D 型:超大文件
121
+ ```bash
122
+ # 同 B/C 型處理,額外建立索引
123
+ # 執行前三步驟後,記錄章節/頁碼對應關係
124
+ ```
125
+
126
+ ---
127
+
128
+ ### Step 5:問答階段
129
+
130
+ #### A 型查詢:直接多模態
131
+ ```bash
132
+ # 使用多模態閱讀技能直接讀取整份 PDF
133
+ node $OFFICIAL_SKILLS_DIR/多模態閱讀技能/scripts/multimodal-read.mjs "檔案路徑" --prompt "使用者問題"
134
+ ```
135
+
136
+ #### B/C/D 型查詢策略
137
+
138
+ | 使用者意圖 | 查詢方式 |
139
+ |------------|----------|
140
+ | **快速搜尋** | `rg "關鍵字" *.txt` → 讀取相關 TXT |
141
+ | **詳細閱讀** | `rg` 定位頁碼 → 多模態讀取對應 PDF 分頁 |
142
+ | **全面分析** | 先搜 TXT 定位 → 再讀 PDF 分頁補充視覺資訊 |
143
+
144
+ #### 特殊查詢處理
145
+
146
+ | 查詢類型 | 處理方式 |
147
+ |----------|----------|
148
+ | 「第 X 頁」 | 直接讀取 `page-XXX.pdf`(多模態) |
149
+ | 「圖表/圖片」 | 強制多模態模式 |
150
+ | 「目錄/大綱」 | 讀取前 5 頁 PDF + 搜尋「目錄」「contents」 |
151
+ | 「全文搜尋 Y」 | `rg "Y" *.txt`,列出所有匹配頁碼 |
152
+
153
+ ---
154
+
155
+ ## 腳本參考
156
+
157
+ ### pdf-analyze.mjs
158
+ ```bash
159
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-analyze.mjs "file.pdf"
160
+ # 輸出:JSON 分析結果,包含分類建議
161
+ ```
162
+
163
+ ### pdf-compress.mjs
164
+ ```bash
165
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "file.pdf" --mode ebook
166
+ # 模式:ebook(激進)、printer(保守)、screen(最激進)
167
+ # 輸出:壓縮後檔案路徑、壓縮率
168
+ ```
169
+
170
+ ### pdf-split.mjs
171
+ ```bash
172
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "file.pdf"
173
+ # 輸出:page-001.pdf, page-002.pdf, ... 在 {檔名}_pages/ 目錄
174
+ ```
175
+
176
+ ### pdf-to-text.mjs
177
+ ```bash
178
+ node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "pages_dir/"
179
+ # 輸出:page-001.txt, page-002.txt, ... 在同目錄
180
+ ```
181
+
182
+ ---
183
+
184
+ ## 核心原則
185
+
186
+ - ✅ **先分析再處理**:用 pdf-analyze 判斷類型
187
+ - ✅ **智慧壓縮**:B 型用 printer,C 型用 ebook
188
+ - ✅ **保留頁碼**:切割後檔名包含頁碼(page-XXX)
189
+ - ✅ **平行讀取**:一次讀取 5-10 個相關檔案
190
+ - ✅ **使用者互動**:大檔案詢問偏好
191
+ - ❌ **禁止**:直接讀取 > 5MB 的完整 PDF
192
+ - ❌ **禁止**:逐個讀取檔案(效率低)
193
+
194
+ ---
195
+
196
+ ## 檢查前處理狀態
197
+
198
+ 執行前先檢查是否已有處理過的檔案:
199
+
200
+ ```bash
201
+ # 檢查是否已有切割檔案
202
+ ls {檔名}_pages/page-*.pdf 2>/dev/null | head -5
203
+ ls {檔名}_pages/page-*.txt 2>/dev/null | head -5
204
+ ```
205
+
206
+ 若已存在,跳過前處理,直接進入問答階段。
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "pdf-skill-scripts",
3
+ "version": "1.0.0",
4
+ "description": "PDF 技能腳本集:分析、壓縮、切割、轉文字",
5
+ "type": "module",
6
+ "scripts": {
7
+ "test": "node test-pdf-scripts.mjs",
8
+ "analyze": "node pdf-analyze.mjs",
9
+ "compress": "node pdf-compress.mjs",
10
+ "split": "node pdf-split.mjs",
11
+ "to-text": "node pdf-to-text.mjs"
12
+ },
13
+ "keywords": ["pdf", "compress", "split", "ghostscript", "qpdf"],
14
+ "author": "Botrun",
15
+ "license": "MIT",
16
+ "dependencies": {
17
+ "glob": "^11.0.0"
18
+ }
19
+ }
@@ -0,0 +1,309 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * PDF 分析腳本 - 分析 PDF 特徵並分類
4
+ *
5
+ * Usage: node pdf-analyze.mjs "file.pdf"
6
+ *
7
+ * 輸出 JSON 包含:
8
+ * - 基本資訊(頁數、大小)
9
+ * - 文字密度分析
10
+ * - 圖片密度分析
11
+ * - 自動分類(A/B/C/D 型)
12
+ *
13
+ * 分類標準:
14
+ * - A 型:< 5MB,小型文件,直接多模態閱讀
15
+ * - B 型:≥ 5MB,文字密度高,純文字處理
16
+ * - C 型:≥ 5MB,圖片密度高,掃描/圖表文件
17
+ * - D 型:> 300 頁,超大文件,需要索引
18
+ */
19
+
20
+ import { execSync } from 'child_process';
21
+ import { existsSync, statSync } from 'fs';
22
+ import { basename, resolve, isAbsolute } from 'path';
23
+
24
+ // ============================================================================
25
+ // 配置
26
+ // ============================================================================
27
+
28
+ const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
29
+ const SIZE_THRESHOLD = 5 * 1024 * 1024; // 5MB
30
+ const PAGE_THRESHOLD = 300; // 超大文件閾值
31
+ const TEXT_DENSITY_THRESHOLD = 1000; // 字元/頁,低於此為掃描文件
32
+
33
+ // ============================================================================
34
+ // 日誌
35
+ // ============================================================================
36
+
37
+ function log(...args) {
38
+ console.error('[PDF-Analyze]', ...args);
39
+ }
40
+
41
+ // ============================================================================
42
+ // 執行命令
43
+ // ============================================================================
44
+
45
+ function execCommand(command) {
46
+ try {
47
+ const result = execSync(command, {
48
+ encoding: 'utf-8',
49
+ timeout: 30000,
50
+ stdio: ['pipe', 'pipe', 'pipe']
51
+ });
52
+ return { success: true, output: result.trim() };
53
+ } catch (error) {
54
+ return { success: false, error: error.message, output: '' };
55
+ }
56
+ }
57
+
58
+ // ============================================================================
59
+ // 路徑驗證
60
+ // ============================================================================
61
+
62
+ function validatePath(filePath) {
63
+ const absolutePath = isAbsolute(filePath) ? filePath : resolve(WORKING_DIR, filePath);
64
+
65
+ if (!existsSync(absolutePath)) {
66
+ return { valid: false, error: `檔案不存在: ${filePath}` };
67
+ }
68
+
69
+ const stats = statSync(absolutePath);
70
+ if (!stats.isFile()) {
71
+ return { valid: false, error: `不是檔案: ${filePath}` };
72
+ }
73
+
74
+ if (!absolutePath.toLowerCase().endsWith('.pdf')) {
75
+ return { valid: false, error: `不是 PDF 檔案: ${filePath}` };
76
+ }
77
+
78
+ return { valid: true, absolutePath, sizeBytes: stats.size };
79
+ }
80
+
81
+ // ============================================================================
82
+ // PDF 分析函數
83
+ // ============================================================================
84
+
85
+ function getPageCount(pdfPath) {
86
+ // 使用 pdfinfo 取得頁數
87
+ const result = execCommand(`pdfinfo "${pdfPath}" 2>/dev/null | grep -i "^Pages:" | awk '{print $2}'`);
88
+ if (result.success && result.output) {
89
+ return parseInt(result.output, 10) || 0;
90
+ }
91
+
92
+ // 備用:使用 qpdf
93
+ const qpdfResult = execCommand(`qpdf --show-npages "${pdfPath}" 2>/dev/null`);
94
+ if (qpdfResult.success && qpdfResult.output) {
95
+ return parseInt(qpdfResult.output, 10) || 0;
96
+ }
97
+
98
+ return 0;
99
+ }
100
+
101
+ function getTextCharCount(pdfPath) {
102
+ // 使用 pdftotext 提取文字並計算字元數
103
+ const result = execCommand(`pdftotext "${pdfPath}" - 2>/dev/null | wc -c`);
104
+ if (result.success && result.output) {
105
+ return parseInt(result.output.trim(), 10) || 0;
106
+ }
107
+ return 0;
108
+ }
109
+
110
+ function getImageCount(pdfPath) {
111
+ // 使用 pdfimages -list 計算圖片數量
112
+ const result = execCommand(`pdfimages -list "${pdfPath}" 2>/dev/null | tail -n +3 | wc -l`);
113
+ if (result.success && result.output) {
114
+ return parseInt(result.output.trim(), 10) || 0;
115
+ }
116
+ return 0;
117
+ }
118
+
119
+ function checkToolsAvailable() {
120
+ const tools = ['pdfinfo', 'pdftotext', 'pdfimages', 'qpdf', 'gs'];
121
+ const available = {};
122
+
123
+ for (const tool of tools) {
124
+ const result = execCommand(`which ${tool} 2>/dev/null`);
125
+ available[tool] = result.success && result.output.length > 0;
126
+ }
127
+
128
+ return available;
129
+ }
130
+
131
+ // ============================================================================
132
+ // 分類邏輯
133
+ // ============================================================================
134
+
135
+ function classifyPdf(analysis) {
136
+ const { sizeBytes, pages, avgCharsPerPage, avgImagesPerPage } = analysis;
137
+
138
+ // A 型:小檔案 (< 5MB)
139
+ if (sizeBytes < SIZE_THRESHOLD) {
140
+ return {
141
+ type: 'A',
142
+ name: '小型文件',
143
+ description: '可直接多模態閱讀',
144
+ recommendation: {
145
+ compress: false,
146
+ split: false,
147
+ toText: false,
148
+ queryMode: 'multimodal'
149
+ }
150
+ };
151
+ }
152
+
153
+ // D 型:超大文件 (> 300 頁)
154
+ if (pages > PAGE_THRESHOLD) {
155
+ return {
156
+ type: 'D',
157
+ name: '超大文件',
158
+ description: '需要索引和分塊處理',
159
+ recommendation: {
160
+ compress: true,
161
+ compressMode: 'printer', // 保守壓縮
162
+ split: true,
163
+ toText: true,
164
+ buildIndex: true,
165
+ queryMode: 'hybrid'
166
+ }
167
+ };
168
+ }
169
+
170
+ // B 型:文字密度高
171
+ if (avgCharsPerPage >= TEXT_DENSITY_THRESHOLD) {
172
+ return {
173
+ type: 'B',
174
+ name: '純文字文件',
175
+ description: '文字為主,適合純文字搜尋',
176
+ recommendation: {
177
+ compress: true,
178
+ compressMode: 'printer', // 保守壓縮,保留文字品質
179
+ split: true,
180
+ toText: true,
181
+ queryMode: 'text'
182
+ }
183
+ };
184
+ }
185
+
186
+ // C 型:圖片/掃描文件
187
+ return {
188
+ type: 'C',
189
+ name: '掃描/圖表文件',
190
+ description: '圖片為主,需要多模態閱讀',
191
+ recommendation: {
192
+ compress: true,
193
+ compressMode: 'ebook', // 激進壓縮
194
+ split: true,
195
+ toText: true, // 仍然轉文字以供搜尋定位
196
+ queryMode: 'multimodal'
197
+ }
198
+ };
199
+ }
200
+
201
+ // ============================================================================
202
+ // 主分析函數
203
+ // ============================================================================
204
+
205
+ async function analyzePdf(pdfPath) {
206
+ log(`分析中: ${pdfPath}`);
207
+
208
+ // 驗證路徑
209
+ const validation = validatePath(pdfPath);
210
+ if (!validation.valid) {
211
+ return {
212
+ success: false,
213
+ error: validation.error
214
+ };
215
+ }
216
+
217
+ const { absolutePath, sizeBytes } = validation;
218
+ const fileName = basename(absolutePath);
219
+
220
+ // 檢查工具可用性
221
+ const tools = checkToolsAvailable();
222
+ log('可用工具:', tools);
223
+
224
+ if (!tools.pdfinfo && !tools.qpdf) {
225
+ return {
226
+ success: false,
227
+ error: '缺少必要工具: pdfinfo 或 qpdf'
228
+ };
229
+ }
230
+
231
+ // 取得基本資訊
232
+ const pages = getPageCount(absolutePath);
233
+ if (pages === 0) {
234
+ return {
235
+ success: false,
236
+ error: '無法取得頁數,可能不是有效的 PDF'
237
+ };
238
+ }
239
+
240
+ // 取得文字和圖片資訊
241
+ const textChars = getTextCharCount(absolutePath);
242
+ const imageCount = getImageCount(absolutePath);
243
+
244
+ // 計算密度指標
245
+ const avgCharsPerPage = Math.round(textChars / pages);
246
+ const avgImagesPerPage = Math.round((imageCount / pages) * 100) / 100;
247
+ const bytesPerPage = Math.round(sizeBytes / pages);
248
+
249
+ // 組裝分析結果
250
+ const analysis = {
251
+ file: fileName,
252
+ path: absolutePath,
253
+ sizeBytes,
254
+ sizeMB: Math.round(sizeBytes / 1024 / 1024 * 100) / 100,
255
+ pages,
256
+ textChars,
257
+ imageCount,
258
+ avgCharsPerPage,
259
+ avgImagesPerPage,
260
+ bytesPerPage,
261
+ bytesPerPageKB: Math.round(bytesPerPage / 1024 * 100) / 100
262
+ };
263
+
264
+ // 分類
265
+ const classification = classifyPdf(analysis);
266
+
267
+ // 輸出結果
268
+ const result = {
269
+ success: true,
270
+ analysis,
271
+ classification,
272
+ tools
273
+ };
274
+
275
+ log(`分析完成: ${classification.type} 型 (${classification.name})`);
276
+
277
+ return result;
278
+ }
279
+
280
+ // ============================================================================
281
+ // Main
282
+ // ============================================================================
283
+
284
+ async function main() {
285
+ const args = process.argv.slice(2);
286
+
287
+ if (args.length === 0) {
288
+ console.error('Usage: node pdf-analyze.mjs "file.pdf"');
289
+ console.error('');
290
+ console.error('分析 PDF 檔案特徵並分類:');
291
+ console.error(' A 型:< 5MB,小型文件');
292
+ console.error(' B 型:≥ 5MB,文字為主');
293
+ console.error(' C 型:≥ 5MB,圖片/掃描為主');
294
+ console.error(' D 型:> 300 頁,超大文件');
295
+ process.exit(1);
296
+ }
297
+
298
+ const pdfPath = args[0];
299
+ const result = await analyzePdf(pdfPath);
300
+
301
+ // 輸出 JSON 結果(stdout)
302
+ console.log(JSON.stringify(result, null, 2));
303
+
304
+ if (!result.success) {
305
+ process.exit(1);
306
+ }
307
+ }
308
+
309
+ main();