@vicoa/cli 1.5.2-win32-x64 → 1.5.2

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 (318) hide show
  1. package/README.md +82 -0
  2. package/bin/vicoa.js +38 -0
  3. package/package.json +29 -10
  4. package/bin/_internal/81d243bd2c585b0f4821__mypyc.cp312-win_amd64.pyd +0 -0
  5. package/bin/_internal/VCRUNTIME140.dll +0 -0
  6. package/bin/_internal/VCRUNTIME140_1.dll +0 -0
  7. package/bin/_internal/_asyncio.pyd +0 -0
  8. package/bin/_internal/_bz2.pyd +0 -0
  9. package/bin/_internal/_cffi_backend.cp312-win_amd64.pyd +0 -0
  10. package/bin/_internal/_ctypes.pyd +0 -0
  11. package/bin/_internal/_decimal.pyd +0 -0
  12. package/bin/_internal/_hashlib.pyd +0 -0
  13. package/bin/_internal/_lzma.pyd +0 -0
  14. package/bin/_internal/_multiprocessing.pyd +0 -0
  15. package/bin/_internal/_overlapped.pyd +0 -0
  16. package/bin/_internal/_queue.pyd +0 -0
  17. package/bin/_internal/_socket.pyd +0 -0
  18. package/bin/_internal/_ssl.pyd +0 -0
  19. package/bin/_internal/_uuid.pyd +0 -0
  20. package/bin/_internal/_wmi.pyd +0 -0
  21. package/bin/_internal/_zoneinfo.pyd +0 -0
  22. package/bin/_internal/aiofile-3.11.1.dist-info/INSTALLER +0 -1
  23. package/bin/_internal/aiofile-3.11.1.dist-info/METADATA +0 -511
  24. package/bin/_internal/aiofile-3.11.1.dist-info/RECORD +0 -15
  25. package/bin/_internal/aiofile-3.11.1.dist-info/WHEEL +0 -4
  26. package/bin/_internal/aiofile-3.11.1.dist-info/licenses/LICENCE +0 -195
  27. package/bin/_internal/aiofile-3.11.1.dist-info/licenses/LICENCE.md +0 -195
  28. package/bin/_internal/aiohttp/_http_parser.cp312-win_amd64.pyd +0 -0
  29. package/bin/_internal/aiohttp/_http_writer.cp312-win_amd64.pyd +0 -0
  30. package/bin/_internal/aiohttp/_websocket/mask.cp312-win_amd64.pyd +0 -0
  31. package/bin/_internal/aiohttp/_websocket/reader_c.cp312-win_amd64.pyd +0 -0
  32. package/bin/_internal/api-ms-win-core-console-l1-1-0.dll +0 -0
  33. package/bin/_internal/api-ms-win-core-datetime-l1-1-0.dll +0 -0
  34. package/bin/_internal/api-ms-win-core-debug-l1-1-0.dll +0 -0
  35. package/bin/_internal/api-ms-win-core-errorhandling-l1-1-0.dll +0 -0
  36. package/bin/_internal/api-ms-win-core-fibers-l1-1-0.dll +0 -0
  37. package/bin/_internal/api-ms-win-core-fibers-l1-1-1.dll +0 -0
  38. package/bin/_internal/api-ms-win-core-file-l1-1-0.dll +0 -0
  39. package/bin/_internal/api-ms-win-core-file-l1-2-0.dll +0 -0
  40. package/bin/_internal/api-ms-win-core-file-l2-1-0.dll +0 -0
  41. package/bin/_internal/api-ms-win-core-handle-l1-1-0.dll +0 -0
  42. package/bin/_internal/api-ms-win-core-heap-l1-1-0.dll +0 -0
  43. package/bin/_internal/api-ms-win-core-interlocked-l1-1-0.dll +0 -0
  44. package/bin/_internal/api-ms-win-core-kernel32-legacy-l1-1-1.dll +0 -0
  45. package/bin/_internal/api-ms-win-core-libraryloader-l1-1-0.dll +0 -0
  46. package/bin/_internal/api-ms-win-core-localization-l1-2-0.dll +0 -0
  47. package/bin/_internal/api-ms-win-core-memory-l1-1-0.dll +0 -0
  48. package/bin/_internal/api-ms-win-core-namedpipe-l1-1-0.dll +0 -0
  49. package/bin/_internal/api-ms-win-core-processenvironment-l1-1-0.dll +0 -0
  50. package/bin/_internal/api-ms-win-core-processthreads-l1-1-0.dll +0 -0
  51. package/bin/_internal/api-ms-win-core-processthreads-l1-1-1.dll +0 -0
  52. package/bin/_internal/api-ms-win-core-profile-l1-1-0.dll +0 -0
  53. package/bin/_internal/api-ms-win-core-rtlsupport-l1-1-0.dll +0 -0
  54. package/bin/_internal/api-ms-win-core-string-l1-1-0.dll +0 -0
  55. package/bin/_internal/api-ms-win-core-synch-l1-1-0.dll +0 -0
  56. package/bin/_internal/api-ms-win-core-synch-l1-2-0.dll +0 -0
  57. package/bin/_internal/api-ms-win-core-sysinfo-l1-1-0.dll +0 -0
  58. package/bin/_internal/api-ms-win-core-sysinfo-l1-2-0.dll +0 -0
  59. package/bin/_internal/api-ms-win-core-timezone-l1-1-0.dll +0 -0
  60. package/bin/_internal/api-ms-win-core-util-l1-1-0.dll +0 -0
  61. package/bin/_internal/api-ms-win-crt-conio-l1-1-0.dll +0 -0
  62. package/bin/_internal/api-ms-win-crt-convert-l1-1-0.dll +0 -0
  63. package/bin/_internal/api-ms-win-crt-environment-l1-1-0.dll +0 -0
  64. package/bin/_internal/api-ms-win-crt-filesystem-l1-1-0.dll +0 -0
  65. package/bin/_internal/api-ms-win-crt-heap-l1-1-0.dll +0 -0
  66. package/bin/_internal/api-ms-win-crt-locale-l1-1-0.dll +0 -0
  67. package/bin/_internal/api-ms-win-crt-math-l1-1-0.dll +0 -0
  68. package/bin/_internal/api-ms-win-crt-process-l1-1-0.dll +0 -0
  69. package/bin/_internal/api-ms-win-crt-runtime-l1-1-0.dll +0 -0
  70. package/bin/_internal/api-ms-win-crt-stdio-l1-1-0.dll +0 -0
  71. package/bin/_internal/api-ms-win-crt-string-l1-1-0.dll +0 -0
  72. package/bin/_internal/api-ms-win-crt-time-l1-1-0.dll +0 -0
  73. package/bin/_internal/api-ms-win-crt-utility-l1-1-0.dll +0 -0
  74. package/bin/_internal/attrs-26.1.0.dist-info/INSTALLER +0 -1
  75. package/bin/_internal/attrs-26.1.0.dist-info/METADATA +0 -199
  76. package/bin/_internal/attrs-26.1.0.dist-info/RECORD +0 -55
  77. package/bin/_internal/attrs-26.1.0.dist-info/WHEEL +0 -4
  78. package/bin/_internal/attrs-26.1.0.dist-info/licenses/LICENSE +0 -21
  79. package/bin/_internal/base_library.zip +0 -0
  80. package/bin/_internal/certifi/cacert.pem +0 -3892
  81. package/bin/_internal/certifi/py.typed +0 -0
  82. package/bin/_internal/charset_normalizer/cd.cp312-win_amd64.pyd +0 -0
  83. package/bin/_internal/charset_normalizer/md.cp312-win_amd64.pyd +0 -0
  84. package/bin/_internal/click-8.4.0.dist-info/INSTALLER +0 -1
  85. package/bin/_internal/click-8.4.0.dist-info/METADATA +0 -84
  86. package/bin/_internal/click-8.4.0.dist-info/RECORD +0 -40
  87. package/bin/_internal/click-8.4.0.dist-info/WHEEL +0 -4
  88. package/bin/_internal/click-8.4.0.dist-info/licenses/LICENSE.txt +0 -28
  89. package/bin/_internal/cryptography/hazmat/bindings/_rust.pyd +0 -0
  90. package/bin/_internal/cryptography-48.0.0.dist-info/INSTALLER +0 -1
  91. package/bin/_internal/cryptography-48.0.0.dist-info/METADATA +0 -110
  92. package/bin/_internal/cryptography-48.0.0.dist-info/RECORD +0 -195
  93. package/bin/_internal/cryptography-48.0.0.dist-info/WHEEL +0 -4
  94. package/bin/_internal/cryptography-48.0.0.dist-info/licenses/LICENSE +0 -3
  95. package/bin/_internal/cryptography-48.0.0.dist-info/licenses/LICENSE.APACHE +0 -202
  96. package/bin/_internal/cryptography-48.0.0.dist-info/licenses/LICENSE.BSD +0 -27
  97. package/bin/_internal/cryptography-48.0.0.dist-info/sboms/cryptography-rust.cyclonedx.json +0 -1362
  98. package/bin/_internal/cryptography-48.0.0.dist-info/sboms/sbom.json +0 -43
  99. package/bin/_internal/email_validator-2.3.0.dist-info/INSTALLER +0 -1
  100. package/bin/_internal/email_validator-2.3.0.dist-info/METADATA +0 -466
  101. package/bin/_internal/email_validator-2.3.0.dist-info/RECORD +0 -27
  102. package/bin/_internal/email_validator-2.3.0.dist-info/WHEEL +0 -5
  103. package/bin/_internal/email_validator-2.3.0.dist-info/entry_points.txt +0 -2
  104. package/bin/_internal/email_validator-2.3.0.dist-info/licenses/LICENSE +0 -27
  105. package/bin/_internal/email_validator-2.3.0.dist-info/top_level.txt +0 -1
  106. package/bin/_internal/fastmcp-3.3.1.dist-info/INSTALLER +0 -1
  107. package/bin/_internal/fastmcp-3.3.1.dist-info/METADATA +0 -157
  108. package/bin/_internal/fastmcp-3.3.1.dist-info/RECORD +0 -5
  109. package/bin/_internal/fastmcp-3.3.1.dist-info/WHEEL +0 -4
  110. package/bin/_internal/fastmcp-3.3.1.dist-info/licenses/LICENSE +0 -201
  111. package/bin/_internal/frozenlist/_frozenlist.cp312-win_amd64.pyd +0 -0
  112. package/bin/_internal/integrations/cli_wrappers/IMPORTANT_USE_CASES.md +0 -33
  113. package/bin/_internal/integrations/github/claude-code-action/CLAUDE.md +0 -136
  114. package/bin/_internal/integrations/github/claude-code-action/CODE_OF_CONDUCT.md +0 -128
  115. package/bin/_internal/integrations/github/claude-code-action/CONTRIBUTING.md +0 -116
  116. package/bin/_internal/integrations/github/claude-code-action/LICENSE +0 -21
  117. package/bin/_internal/integrations/github/claude-code-action/README.md +0 -53
  118. package/bin/_internal/integrations/github/claude-code-action/ROADMAP.md +0 -20
  119. package/bin/_internal/integrations/github/claude-code-action/SECURITY.md +0 -15
  120. package/bin/_internal/integrations/github/claude-code-action/action.yml +0 -294
  121. package/bin/_internal/integrations/github/claude-code-action/base-action/CLAUDE.md +0 -60
  122. package/bin/_internal/integrations/github/claude-code-action/base-action/CODE_OF_CONDUCT.md +0 -128
  123. package/bin/_internal/integrations/github/claude-code-action/base-action/CONTRIBUTING.md +0 -136
  124. package/bin/_internal/integrations/github/claude-code-action/base-action/LICENSE +0 -21
  125. package/bin/_internal/integrations/github/claude-code-action/base-action/MIRROR_DISCLAIMER.md +0 -11
  126. package/bin/_internal/integrations/github/claude-code-action/base-action/README.md +0 -521
  127. package/bin/_internal/integrations/github/claude-code-action/base-action/action.yml +0 -149
  128. package/bin/_internal/integrations/github/claude-code-action/base-action/bun.lock +0 -54
  129. package/bin/_internal/integrations/github/claude-code-action/base-action/examples/issue-triage.yml +0 -108
  130. package/bin/_internal/integrations/github/claude-code-action/base-action/package.json +0 -23
  131. package/bin/_internal/integrations/github/claude-code-action/base-action/scripts/install-hooks.sh +0 -13
  132. package/bin/_internal/integrations/github/claude-code-action/base-action/scripts/pre-push +0 -46
  133. package/bin/_internal/integrations/github/claude-code-action/base-action/src/index.ts +0 -82
  134. package/bin/_internal/integrations/github/claude-code-action/base-action/src/prepare-prompt.ts +0 -82
  135. package/bin/_internal/integrations/github/claude-code-action/base-action/src/run-claude.ts +0 -257
  136. package/bin/_internal/integrations/github/claude-code-action/base-action/src/run-vicoa.ts +0 -301
  137. package/bin/_internal/integrations/github/claude-code-action/base-action/src/setup-claude-code-settings.ts +0 -68
  138. package/bin/_internal/integrations/github/claude-code-action/base-action/src/validate-env.ts +0 -54
  139. package/bin/_internal/integrations/github/claude-code-action/base-action/test-local.sh +0 -12
  140. package/bin/_internal/integrations/github/claude-code-action/base-action/test-mcp-local.sh +0 -18
  141. package/bin/_internal/integrations/github/claude-code-action/base-action/tsconfig.json +0 -30
  142. package/bin/_internal/integrations/github/claude-code-action/bun.lock +0 -384
  143. package/bin/_internal/integrations/github/claude-code-action/docs/capabilities-and-limitations.md +0 -33
  144. package/bin/_internal/integrations/github/claude-code-action/docs/cloud-providers.md +0 -99
  145. package/bin/_internal/integrations/github/claude-code-action/docs/configuration.md +0 -345
  146. package/bin/_internal/integrations/github/claude-code-action/docs/custom-automations.md +0 -113
  147. package/bin/_internal/integrations/github/claude-code-action/docs/experimental.md +0 -128
  148. package/bin/_internal/integrations/github/claude-code-action/docs/faq.md +0 -205
  149. package/bin/_internal/integrations/github/claude-code-action/docs/migration-guide.md +0 -261
  150. package/bin/_internal/integrations/github/claude-code-action/docs/security.md +0 -38
  151. package/bin/_internal/integrations/github/claude-code-action/docs/setup.md +0 -146
  152. package/bin/_internal/integrations/github/claude-code-action/docs/usage.md +0 -213
  153. package/bin/_internal/integrations/github/claude-code-action/examples/auto-fix-ci/auto-fix-ci.yml +0 -97
  154. package/bin/_internal/integrations/github/claude-code-action/examples/auto-fix-ci/commands/fix-ci.md +0 -127
  155. package/bin/_internal/integrations/github/claude-code-action/examples/auto-fix-ci-signed/auto-fix-ci-signed.yml +0 -97
  156. package/bin/_internal/integrations/github/claude-code-action/examples/auto-fix-ci-signed/commands/fix-ci-signed.md +0 -148
  157. package/bin/_internal/integrations/github/claude-code-action/examples/issue-deduplication.yml +0 -63
  158. package/bin/_internal/integrations/github/claude-code-action/examples/issue-triage.yml +0 -75
  159. package/bin/_internal/integrations/github/claude-code-action/examples/vicoa.yml +0 -75
  160. package/bin/_internal/integrations/github/claude-code-action/package.json +0 -31
  161. package/bin/_internal/integrations/github/claude-code-action/scripts/install-hooks.sh +0 -13
  162. package/bin/_internal/integrations/github/claude-code-action/scripts/pre-commit +0 -46
  163. package/bin/_internal/integrations/github/claude-code-action/scripts/setup-network-restrictions.sh +0 -123
  164. package/bin/_internal/integrations/github/claude-code-action/src/create-prompt/index.ts +0 -799
  165. package/bin/_internal/integrations/github/claude-code-action/src/create-prompt/types.ts +0 -102
  166. package/bin/_internal/integrations/github/claude-code-action/src/entrypoints/collect-inputs.ts +0 -58
  167. package/bin/_internal/integrations/github/claude-code-action/src/entrypoints/format-turns.ts +0 -465
  168. package/bin/_internal/integrations/github/claude-code-action/src/entrypoints/prepare.ts +0 -98
  169. package/bin/_internal/integrations/github/claude-code-action/src/entrypoints/update-comment-link.ts +0 -245
  170. package/bin/_internal/integrations/github/claude-code-action/src/github/api/client.ts +0 -23
  171. package/bin/_internal/integrations/github/claude-code-action/src/github/api/config.ts +0 -4
  172. package/bin/_internal/integrations/github/claude-code-action/src/github/api/queries/github.ts +0 -117
  173. package/bin/_internal/integrations/github/claude-code-action/src/github/context.ts +0 -277
  174. package/bin/_internal/integrations/github/claude-code-action/src/github/data/fetcher.ts +0 -233
  175. package/bin/_internal/integrations/github/claude-code-action/src/github/data/formatter.ts +0 -144
  176. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/branch-cleanup.ts +0 -132
  177. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/branch.ts +0 -163
  178. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/comment-logic.ts +0 -203
  179. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/comments/common.ts +0 -33
  180. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/comments/create-initial.ts +0 -111
  181. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/comments/update-claude-comment.ts +0 -70
  182. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/comments/update-with-branch.ts +0 -57
  183. package/bin/_internal/integrations/github/claude-code-action/src/github/operations/git-config.ts +0 -62
  184. package/bin/_internal/integrations/github/claude-code-action/src/github/token.ts +0 -108
  185. package/bin/_internal/integrations/github/claude-code-action/src/github/types.ts +0 -98
  186. package/bin/_internal/integrations/github/claude-code-action/src/github/utils/image-downloader.ts +0 -246
  187. package/bin/_internal/integrations/github/claude-code-action/src/github/utils/sanitizer.ts +0 -100
  188. package/bin/_internal/integrations/github/claude-code-action/src/github/validation/actor.ts +0 -64
  189. package/bin/_internal/integrations/github/claude-code-action/src/github/validation/permissions.ts +0 -47
  190. package/bin/_internal/integrations/github/claude-code-action/src/github/validation/trigger.ts +0 -148
  191. package/bin/_internal/integrations/github/claude-code-action/src/mcp/github-actions-server.ts +0 -279
  192. package/bin/_internal/integrations/github/claude-code-action/src/mcp/github-comment-server.ts +0 -101
  193. package/bin/_internal/integrations/github/claude-code-action/src/mcp/github-file-ops-server.ts +0 -677
  194. package/bin/_internal/integrations/github/claude-code-action/src/mcp/github-inline-comment-server.ts +0 -184
  195. package/bin/_internal/integrations/github/claude-code-action/src/mcp/install-mcp-server.ts +0 -201
  196. package/bin/_internal/integrations/github/claude-code-action/src/modes/agent/index.ts +0 -152
  197. package/bin/_internal/integrations/github/claude-code-action/src/modes/agent/parse-tools.ts +0 -22
  198. package/bin/_internal/integrations/github/claude-code-action/src/modes/detector.ts +0 -66
  199. package/bin/_internal/integrations/github/claude-code-action/src/modes/registry.ts +0 -54
  200. package/bin/_internal/integrations/github/claude-code-action/src/modes/tag/index.ts +0 -187
  201. package/bin/_internal/integrations/github/claude-code-action/src/modes/types.ts +0 -100
  202. package/bin/_internal/integrations/github/claude-code-action/src/prepare/index.ts +0 -20
  203. package/bin/_internal/integrations/github/claude-code-action/src/prepare/types.ts +0 -20
  204. package/bin/_internal/integrations/github/claude-code-action/src/utils/retry.ts +0 -40
  205. package/bin/_internal/integrations/github/claude-code-action/tsconfig.json +0 -30
  206. package/bin/_internal/integrations/headless/tests/README.md +0 -58
  207. package/bin/_internal/integrations/n8n/LICENSE +0 -21
  208. package/bin/_internal/integrations/n8n/README.md +0 -298
  209. package/bin/_internal/integrations/n8n/package-lock.json +0 -2989
  210. package/bin/_internal/integrations/n8n/package.json +0 -68
  211. package/bin/_internal/integrations/n8n/src/credentials/OmnaraApi.credentials.ts +0 -52
  212. package/bin/_internal/integrations/n8n/src/nodes/Omnara/Omnara.node.json +0 -35
  213. package/bin/_internal/integrations/n8n/src/nodes/Omnara/Omnara.node.ts +0 -304
  214. package/bin/_internal/integrations/n8n/src/nodes/Omnara/actions/message/index.ts +0 -37
  215. package/bin/_internal/integrations/n8n/src/nodes/Omnara/actions/message/send.operation.ts +0 -151
  216. package/bin/_internal/integrations/n8n/src/nodes/Omnara/actions/message/sendAndWait.operation.ts +0 -252
  217. package/bin/_internal/integrations/n8n/src/nodes/Omnara/actions/session/end.operation.ts +0 -56
  218. package/bin/_internal/integrations/n8n/src/nodes/Omnara/actions/session/index.ts +0 -29
  219. package/bin/_internal/integrations/n8n/src/nodes/Omnara/vicoa.png +0 -0
  220. package/bin/_internal/integrations/n8n/src/utils/GenericFunctions.ts +0 -93
  221. package/bin/_internal/integrations/n8n/src/utils/sendAndWait/configureWaitTillDate.ts +0 -42
  222. package/bin/_internal/integrations/n8n/src/utils/sendAndWait/descriptions.ts +0 -20
  223. package/bin/_internal/integrations/n8n/src/utils/sendAndWaitWebhook.ts +0 -72
  224. package/bin/_internal/integrations/n8n/tsconfig.json +0 -20
  225. package/bin/_internal/jiter/jiter.cp312-win_amd64.pyd +0 -0
  226. package/bin/_internal/jsonschema/benchmarks/issue232/issue.json +0 -2653
  227. package/bin/_internal/jsonschema-4.26.0.dist-info/INSTALLER +0 -1
  228. package/bin/_internal/jsonschema-4.26.0.dist-info/METADATA +0 -170
  229. package/bin/_internal/jsonschema-4.26.0.dist-info/RECORD +0 -82
  230. package/bin/_internal/jsonschema-4.26.0.dist-info/WHEEL +0 -4
  231. package/bin/_internal/jsonschema-4.26.0.dist-info/entry_points.txt +0 -2
  232. package/bin/_internal/jsonschema-4.26.0.dist-info/licenses/COPYING +0 -19
  233. package/bin/_internal/jsonschema_specifications/schemas/draft201909/metaschema.json +0 -42
  234. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/applicator +0 -56
  235. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/content +0 -17
  236. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/core +0 -57
  237. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/format +0 -14
  238. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/meta-data +0 -37
  239. package/bin/_internal/jsonschema_specifications/schemas/draft201909/vocabularies/validation +0 -98
  240. package/bin/_internal/jsonschema_specifications/schemas/draft202012/metaschema.json +0 -58
  241. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/applicator +0 -48
  242. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/content +0 -17
  243. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/core +0 -51
  244. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation +0 -14
  245. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion +0 -14
  246. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/meta-data +0 -37
  247. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated +0 -15
  248. package/bin/_internal/jsonschema_specifications/schemas/draft202012/vocabularies/validation +0 -98
  249. package/bin/_internal/jsonschema_specifications/schemas/draft3/metaschema.json +0 -172
  250. package/bin/_internal/jsonschema_specifications/schemas/draft4/metaschema.json +0 -149
  251. package/bin/_internal/jsonschema_specifications/schemas/draft6/metaschema.json +0 -153
  252. package/bin/_internal/jsonschema_specifications/schemas/draft7/metaschema.json +0 -166
  253. package/bin/_internal/libcrypto-3.dll +0 -0
  254. package/bin/_internal/libffi-8.dll +0 -0
  255. package/bin/_internal/libssl-3.dll +0 -0
  256. package/bin/_internal/mcp-1.27.1.dist-info/INSTALLER +0 -1
  257. package/bin/_internal/mcp-1.27.1.dist-info/METADATA +0 -230
  258. package/bin/_internal/mcp-1.27.1.dist-info/RECORD +0 -226
  259. package/bin/_internal/mcp-1.27.1.dist-info/WHEEL +0 -4
  260. package/bin/_internal/mcp-1.27.1.dist-info/entry_points.txt +0 -2
  261. package/bin/_internal/mcp-1.27.1.dist-info/licenses/LICENSE +0 -21
  262. package/bin/_internal/multidict/_multidict.cp312-win_amd64.pyd +0 -0
  263. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/INSTALLER +0 -1
  264. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/METADATA +0 -43
  265. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/RECORD +0 -81
  266. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/WHEEL +0 -4
  267. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/entry_points.txt +0 -15
  268. package/bin/_internal/opentelemetry_api-1.42.1.dist-info/licenses/LICENSE +0 -201
  269. package/bin/_internal/propcache/_helpers_c.cp312-win_amd64.pyd +0 -0
  270. package/bin/_internal/pydantic-2.13.4.dist-info/INSTALLER +0 -1
  271. package/bin/_internal/pydantic-2.13.4.dist-info/METADATA +0 -1294
  272. package/bin/_internal/pydantic-2.13.4.dist-info/RECORD +0 -217
  273. package/bin/_internal/pydantic-2.13.4.dist-info/WHEEL +0 -4
  274. package/bin/_internal/pydantic-2.13.4.dist-info/licenses/LICENSE +0 -21
  275. package/bin/_internal/pydantic_core/_pydantic_core.cp312-win_amd64.pyd +0 -0
  276. package/bin/_internal/pyexpat.pyd +0 -0
  277. package/bin/_internal/python3.dll +0 -0
  278. package/bin/_internal/python312.dll +0 -0
  279. package/bin/_internal/pywin32_system32/pythoncom312.dll +0 -0
  280. package/bin/_internal/pywin32_system32/pywintypes312.dll +0 -0
  281. package/bin/_internal/rpds/rpds.cp312-win_amd64.pyd +0 -0
  282. package/bin/_internal/select.pyd +0 -0
  283. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/INSTALLER +0 -1
  284. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/METADATA +0 -133
  285. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/RECORD +0 -21
  286. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/REQUESTED +0 -0
  287. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/WHEEL +0 -5
  288. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/licenses/LICENSE +0 -73
  289. package/bin/_internal/setuptools/_vendor/importlib_metadata-8.7.1.dist-info/top_level.txt +0 -1
  290. package/bin/_internal/setuptools/_vendor/jaraco/text/Lorem ipsum.txt +0 -2
  291. package/bin/_internal/ucrtbase.dll +0 -0
  292. package/bin/_internal/unicodedata.pyd +0 -0
  293. package/bin/_internal/vicoa/_bin/README.md +0 -28
  294. package/bin/_internal/vicoa-1.5.2.dist-info/INSTALLER +0 -1
  295. package/bin/_internal/vicoa-1.5.2.dist-info/METADATA +0 -312
  296. package/bin/_internal/vicoa-1.5.2.dist-info/RECORD +0 -11
  297. package/bin/_internal/vicoa-1.5.2.dist-info/REQUESTED +0 -0
  298. package/bin/_internal/vicoa-1.5.2.dist-info/WHEEL +0 -5
  299. package/bin/_internal/vicoa-1.5.2.dist-info/direct_url.json +0 -1
  300. package/bin/_internal/vicoa-1.5.2.dist-info/entry_points.txt +0 -2
  301. package/bin/_internal/vicoa-1.5.2.dist-info/licenses/LICENSE +0 -201
  302. package/bin/_internal/vicoa-1.5.2.dist-info/top_level.txt +0 -3
  303. package/bin/_internal/watchfiles/_rust_notify.cp312-win_amd64.pyd +0 -0
  304. package/bin/_internal/websockets/speedups.cp312-win_amd64.pyd +0 -0
  305. package/bin/_internal/websockets-16.0.dist-info/INSTALLER +0 -1
  306. package/bin/_internal/websockets-16.0.dist-info/METADATA +0 -179
  307. package/bin/_internal/websockets-16.0.dist-info/RECORD +0 -108
  308. package/bin/_internal/websockets-16.0.dist-info/WHEEL +0 -5
  309. package/bin/_internal/websockets-16.0.dist-info/entry_points.txt +0 -2
  310. package/bin/_internal/websockets-16.0.dist-info/licenses/LICENSE +0 -24
  311. package/bin/_internal/websockets-16.0.dist-info/top_level.txt +0 -1
  312. package/bin/_internal/win32/_win32sysloader.pyd +0 -0
  313. package/bin/_internal/win32/win32api.pyd +0 -0
  314. package/bin/_internal/win32/win32evtlog.pyd +0 -0
  315. package/bin/_internal/win32/win32job.pyd +0 -0
  316. package/bin/_internal/yaml/_yaml.cp312-win_amd64.pyd +0 -0
  317. package/bin/_internal/yarl/_quoting_c.cp312-win_amd64.pyd +0 -0
  318. package/bin/vicoa.exe +0 -0
@@ -1,157 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: fastmcp
3
- Version: 3.3.1
4
- Summary: The fast, Pythonic way to build MCP servers and clients.
5
- Project-URL: Homepage, https://gofastmcp.com
6
- Project-URL: Repository, https://github.com/PrefectHQ/fastmcp
7
- Project-URL: Documentation, https://gofastmcp.com
8
- Author: Jeremiah Lowin
9
- License-Expression: Apache-2.0
10
- License-File: LICENSE
11
- Keywords: agent,fastmcp,llm,mcp,mcp client,mcp server,model context protocol
12
- Classifier: Intended Audience :: Developers
13
- Classifier: License :: OSI Approved :: Apache Software License
14
- Classifier: Programming Language :: Python :: 3.10
15
- Classifier: Programming Language :: Python :: 3.11
16
- Classifier: Programming Language :: Python :: 3.12
17
- Classifier: Programming Language :: Python :: 3.13
18
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
19
- Classifier: Typing :: Typed
20
- Requires-Python: >=3.10
21
- Requires-Dist: fastmcp-slim[client,server]==3.3.1
22
- Provides-Extra: anthropic
23
- Requires-Dist: fastmcp-slim[anthropic]==3.3.1; extra == 'anthropic'
24
- Provides-Extra: apps
25
- Requires-Dist: fastmcp-slim[apps]==3.3.1; extra == 'apps'
26
- Provides-Extra: azure
27
- Requires-Dist: fastmcp-slim[azure]==3.3.1; extra == 'azure'
28
- Provides-Extra: code-mode
29
- Requires-Dist: fastmcp-slim[code-mode]==3.3.1; extra == 'code-mode'
30
- Provides-Extra: gemini
31
- Requires-Dist: fastmcp-slim[gemini]==3.3.1; extra == 'gemini'
32
- Provides-Extra: openai
33
- Requires-Dist: fastmcp-slim[openai]==3.3.1; extra == 'openai'
34
- Provides-Extra: tasks
35
- Requires-Dist: fastmcp-slim[tasks]==3.3.1; extra == 'tasks'
36
- Description-Content-Type: text/markdown
37
-
38
- <div align="center">
39
-
40
- <!-- omit in toc -->
41
-
42
- <picture>
43
- <source width="550" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/brand/f-watercolor-waves-4-dark.png">
44
- <source width="550" media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/brand/f-watercolor-waves-4.png">
45
- <img width="550" alt="FastMCP Logo" src="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/brand/f-watercolor-waves-2.png">
46
- </picture>
47
-
48
- # FastMCP 🚀
49
-
50
- <strong>Move fast and make things.</strong>
51
-
52
- *Made with 💙 by [Prefect](https://www.prefect.io/)*
53
-
54
- [![Docs](https://img.shields.io/badge/docs-gofastmcp.com-blue)](https://gofastmcp.com)
55
- [![Discord](https://img.shields.io/badge/community-discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/uu8dJCgttd)
56
- [![PyPI - Version](https://img.shields.io/pypi/v/fastmcp.svg)](https://pypi.org/project/fastmcp)
57
- [![Tests](https://github.com/PrefectHQ/fastmcp/actions/workflows/run-tests.yml/badge.svg)](https://github.com/PrefectHQ/fastmcp/actions/workflows/run-tests.yml)
58
- [![License](https://img.shields.io/github/license/PrefectHQ/fastmcp.svg)](https://github.com/PrefectHQ/fastmcp/blob/main/LICENSE)
59
-
60
- <a href="https://trendshift.io/repositories/13266" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13266" alt="prefecthq%2Ffastmcp | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
61
- </div>
62
-
63
- ---
64
-
65
- The [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) connects LLMs to tools and data. FastMCP gives you everything you need to go from prototype to production:
66
-
67
- ```python
68
- from fastmcp import FastMCP
69
-
70
- mcp = FastMCP("Demo 🚀")
71
-
72
- @mcp.tool
73
- def add(a: int, b: int) -> int:
74
- """Add two numbers"""
75
- return a + b
76
-
77
- if __name__ == "__main__":
78
- mcp.run()
79
- ```
80
-
81
- ## Why FastMCP
82
-
83
- Building an effective MCP application is harder than it looks. FastMCP handles all of it. Declare a tool with a Python function, and the schema, validation, and documentation are generated automatically. Connect to a server with a URL, and transport negotiation, authentication, and protocol lifecycle are managed for you. You focus on your logic, and the MCP part just works: **with FastMCP, best practices are built in.**
84
-
85
- **That's why FastMCP is the standard framework for working with MCP.** FastMCP 1.0 was incorporated into the official MCP Python SDK in 2024. Today, the actively maintained standalone project is downloaded a million times a day, and some version of FastMCP powers 70% of MCP servers across all languages.
86
-
87
- FastMCP has three pillars:
88
-
89
- <table>
90
- <tr>
91
- <td align="center" valign="top" width="33%">
92
- <a href="https://gofastmcp.com/servers/server">
93
- <img src="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/images/servers-card.png" alt="Servers" />
94
- <br /><strong>Servers</strong>
95
- </a>
96
- <br />Expose tools, resources, and prompts to LLMs.
97
- </td>
98
- <td align="center" valign="top" width="33%">
99
- <a href="https://gofastmcp.com/apps/overview">
100
- <img src="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/images/apps-card.png" alt="Apps" />
101
- <br /><strong>Apps</strong>
102
- </a>
103
- <br />Give your tools interactive UIs rendered directly in the conversation.
104
- </td>
105
- <td align="center" valign="top" width="33%">
106
- <a href="https://gofastmcp.com/clients/client">
107
- <img src="https://raw.githubusercontent.com/PrefectHQ/fastmcp/main/docs/assets/images/clients-card.png" alt="Clients" />
108
- <br /><strong>Clients</strong>
109
- </a>
110
- <br />Connect to any MCP server — local or remote, programmatic or CLI.
111
- </td>
112
- </tr>
113
- </table>
114
-
115
- **[Servers](https://gofastmcp.com/servers/server)** wrap your Python functions into MCP-compliant tools, resources, and prompts. **[Clients](https://gofastmcp.com/clients/client)** connect to any server with full protocol support. And **[Apps](https://gofastmcp.com/apps/overview)** give your tools interactive UIs rendered directly in the conversation.
116
-
117
- Ready to build? Start with the [installation guide](https://gofastmcp.com/getting-started/installation) or jump straight to the [quickstart](https://gofastmcp.com/getting-started/quickstart).
118
-
119
- ## Run FastMCP in production with Horizon
120
-
121
- FastMCP is the standard way to build MCP servers. **[Prefect Horizon](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_body)** is the enterprise MCP gateway for running them safely.
122
-
123
- Built by the FastMCP team, Horizon packages the best practices we've learned shipping the world's most popular MCP framework.
124
-
125
- Deploy FastMCP servers from GitHub with branch previews and instant rollback. Create a private registry of every MCP your company uses. Secure access with SSO and tool-level RBAC. Get audit logs, observability, and governance across your MCP stack. Remix approved tools into purpose-built endpoints for teams and agents.
126
-
127
- Start with FastMCP. [Scale with Horizon →](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_cta)
128
-
129
- ## Installation
130
-
131
- We recommend installing FastMCP with [uv](https://docs.astral.sh/uv/):
132
-
133
- ```bash
134
- uv pip install fastmcp
135
- ```
136
-
137
- For full installation instructions, including verification and upgrading, see the [**Installation Guide**](https://gofastmcp.com/getting-started/installation).
138
-
139
- **Upgrading?** We have guides for:
140
- - [Upgrading from FastMCP v2](https://gofastmcp.com/getting-started/upgrading/from-fastmcp-2)
141
- - [Upgrading from the MCP Python SDK](https://gofastmcp.com/getting-started/upgrading/from-mcp-sdk)
142
- - [Upgrading from the low-level SDK](https://gofastmcp.com/getting-started/upgrading/from-low-level-sdk)
143
-
144
- ## 📚 Documentation
145
-
146
- FastMCP's complete documentation is available at **[gofastmcp.com](https://gofastmcp.com)**, including detailed guides, API references, and advanced patterns.
147
-
148
- Documentation is also available in [llms.txt format](https://llmstxt.org/), which is a simple markdown standard that LLMs can consume easily:
149
-
150
- - [`llms.txt`](https://gofastmcp.com/llms.txt) is essentially a sitemap, listing all the pages in the documentation.
151
- - [`llms-full.txt`](https://gofastmcp.com/llms-full.txt) contains the entire documentation. Note this may exceed the context window of your LLM.
152
-
153
- **Community:** Join our [Discord server](https://discord.gg/uu8dJCgttd) to connect with other FastMCP developers and share what you're building.
154
-
155
- ## Contributing
156
-
157
- We welcome contributions! See the [Contributing Guide](https://gofastmcp.com/development/contributing) for setup instructions, testing requirements, and PR guidelines.
@@ -1,5 +0,0 @@
1
- fastmcp-3.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
2
- fastmcp-3.3.1.dist-info/METADATA,sha256=Dc5C6X9Wg4fBN-UOo7MXB45xKt9oOw7aMD92MdhJz5M,8211
3
- fastmcp-3.3.1.dist-info/RECORD,,
4
- fastmcp-3.3.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
5
- fastmcp-3.3.1.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
@@ -1,4 +0,0 @@
1
- Wheel-Version: 1.0
2
- Generator: hatchling 1.29.0
3
- Root-Is-Purelib: true
4
- Tag: py3-none-any
@@ -1,201 +0,0 @@
1
- Apache License
2
- Version 2.0, January 2004
3
- http://www.apache.org/licenses/
4
-
5
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
-
7
- 1. Definitions.
8
-
9
- "License" shall mean the terms and conditions for use, reproduction,
10
- and distribution as defined by Sections 1 through 9 of this document.
11
-
12
- "Licensor" shall mean the copyright owner or entity authorized by
13
- the copyright owner that is granting the License.
14
-
15
- "Legal Entity" shall mean the union of the acting entity and all
16
- other entities that control, are controlled by, or are under common
17
- control with that entity. For the purposes of this definition,
18
- "control" means (i) the power, direct or indirect, to cause the
19
- direction or management of such entity, whether by contract or
20
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
- outstanding shares, or (iii) beneficial ownership of such entity.
22
-
23
- "You" (or "Your") shall mean an individual or Legal Entity
24
- exercising permissions granted by this License.
25
-
26
- "Source" form shall mean the preferred form for making modifications,
27
- including but not limited to software source code, documentation
28
- source, and configuration files.
29
-
30
- "Object" form shall mean any form resulting from mechanical
31
- transformation or translation of a Source form, including but
32
- not limited to compiled object code, generated documentation,
33
- and conversions to other media types.
34
-
35
- "Work" shall mean the work of authorship, whether in Source or
36
- Object form, made available under the License, as indicated by a
37
- copyright notice that is included in or attached to the work
38
- (an example is provided in the Appendix below).
39
-
40
- "Derivative Works" shall mean any work, whether in Source or Object
41
- form, that is based on (or derived from) the Work and for which the
42
- editorial revisions, annotations, elaborations, or other modifications
43
- represent, as a whole, an original work of authorship. For the purposes
44
- of this License, Derivative Works shall not include works that remain
45
- separable from, or merely link (or bind by name) to the interfaces of,
46
- the Work and Derivative Works thereof.
47
-
48
- "Contribution" shall mean any work of authorship, including
49
- the original version of the Work and any modifications or additions
50
- to that Work or Derivative Works thereof, that is intentionally
51
- submitted to Licensor for inclusion in the Work by the copyright owner
52
- or by an individual or Legal Entity authorized to submit on behalf of
53
- the copyright owner. For the purposes of this definition, "submitted"
54
- means any form of electronic, verbal, or written communication sent
55
- to the Licensor or its representatives, including but not limited to
56
- communication on electronic mailing lists, source code control systems,
57
- and issue tracking systems that are managed by, or on behalf of, the
58
- Licensor for the purpose of discussing and improving the Work, but
59
- excluding communication that is conspicuously marked or otherwise
60
- designated in writing by the copyright owner as "Not a Contribution."
61
-
62
- "Contributor" shall mean Licensor and any individual or Legal Entity
63
- on behalf of whom a Contribution has been received by Licensor and
64
- subsequently incorporated within the Work.
65
-
66
- 2. Grant of Copyright License. Subject to the terms and conditions of
67
- this License, each Contributor hereby grants to You a perpetual,
68
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
- copyright license to reproduce, prepare Derivative Works of,
70
- publicly display, publicly perform, sublicense, and distribute the
71
- Work and such Derivative Works in Source or Object form.
72
-
73
- 3. Grant of Patent License. Subject to the terms and conditions of
74
- this License, each Contributor hereby grants to You a perpetual,
75
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
- (except as stated in this section) patent license to make, have made,
77
- use, offer to sell, sell, import, and otherwise transfer the Work,
78
- where such license applies only to those patent claims licensable
79
- by such Contributor that are necessarily infringed by their
80
- Contribution(s) alone or by combination of their Contribution(s)
81
- with the Work to which such Contribution(s) was submitted. If You
82
- institute patent litigation against any entity (including a
83
- cross-claim or counterclaim in a lawsuit) alleging that the Work
84
- or a Contribution incorporated within the Work constitutes direct
85
- or contributory patent infringement, then any patent licenses
86
- granted to You under this License for that Work shall terminate
87
- as of the date such litigation is filed.
88
-
89
- 4. Redistribution. You may reproduce and distribute copies of the
90
- Work or Derivative Works thereof in any medium, with or without
91
- modifications, and in Source or Object form, provided that You
92
- meet the following conditions:
93
-
94
- (a) You must give any other recipients of the Work or
95
- Derivative Works a copy of this License; and
96
-
97
- (b) You must cause any modified files to carry prominent notices
98
- stating that You changed the files; and
99
-
100
- (c) You must retain, in the Source form of any Derivative Works
101
- that You distribute, all copyright, patent, trademark, and
102
- attribution notices from the Source form of the Work,
103
- excluding those notices that do not pertain to any part of
104
- the Derivative Works; and
105
-
106
- (d) If the Work includes a "NOTICE" text file as part of its
107
- distribution, then any Derivative Works that You distribute must
108
- include a readable copy of the attribution notices contained
109
- within such NOTICE file, excluding those notices that do not
110
- pertain to any part of the Derivative Works, in at least one
111
- of the following places: within a NOTICE text file distributed
112
- as part of the Derivative Works; within the Source form or
113
- documentation, if provided along with the Derivative Works; or,
114
- within a display generated by the Derivative Works, if and
115
- wherever such third-party notices normally appear. The contents
116
- of the NOTICE file are for informational purposes only and
117
- do not modify the License. You may add Your own attribution
118
- notices within Derivative Works that You distribute, alongside
119
- or as an addendum to the NOTICE text from the Work, provided
120
- that such additional attribution notices cannot be construed
121
- as modifying the License.
122
-
123
- You may add Your own copyright statement to Your modifications and
124
- may provide additional or different license terms and conditions
125
- for use, reproduction, or distribution of Your modifications, or
126
- for any such Derivative Works as a whole, provided Your use,
127
- reproduction, and distribution of the Work otherwise complies with
128
- the conditions stated in this License.
129
-
130
- 5. Submission of Contributions. Unless You explicitly state otherwise,
131
- any Contribution intentionally submitted for inclusion in the Work
132
- by You to the Licensor shall be under the terms and conditions of
133
- this License, without any additional terms or conditions.
134
- Notwithstanding the above, nothing herein shall supersede or modify
135
- the terms of any separate license agreement you may have executed
136
- with Licensor regarding such Contributions.
137
-
138
- 6. Trademarks. This License does not grant permission to use the trade
139
- names, trademarks, service marks, or product names of the Licensor,
140
- except as required for reasonable and customary use in describing the
141
- origin of the Work and reproducing the content of the NOTICE file.
142
-
143
- 7. Disclaimer of Warranty. Unless required by applicable law or
144
- agreed to in writing, Licensor provides the Work (and each
145
- Contributor provides its Contributions) on an "AS IS" BASIS,
146
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
- implied, including, without limitation, any warranties or conditions
148
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
- PARTICULAR PURPOSE. You are solely responsible for determining the
150
- appropriateness of using or redistributing the Work and assume any
151
- risks associated with Your exercise of permissions under this License.
152
-
153
- 8. Limitation of Liability. In no event and under no legal theory,
154
- whether in tort (including negligence), contract, or otherwise,
155
- unless required by applicable law (such as deliberate and grossly
156
- negligent acts) or agreed to in writing, shall any Contributor be
157
- liable to You for damages, including any direct, indirect, special,
158
- incidental, or consequential damages of any character arising as a
159
- result of this License or out of the use or inability to use the
160
- Work (including but not limited to damages for loss of goodwill,
161
- work stoppage, computer failure or malfunction, or any and all
162
- other commercial damages or losses), even if such Contributor
163
- has been advised of the possibility of such damages.
164
-
165
- 9. Accepting Warranty or Additional Liability. While redistributing
166
- the Work or Derivative Works thereof, You may choose to offer,
167
- and charge a fee for, acceptance of support, warranty, indemnity,
168
- or other liability obligations and/or rights consistent with this
169
- License. However, in accepting such obligations, You may act only
170
- on Your own behalf and on Your sole responsibility, not on behalf
171
- of any other Contributor, and only if You agree to indemnify,
172
- defend, and hold each Contributor harmless for any liability
173
- incurred by, or claims asserted against, such Contributor by reason
174
- of your accepting any such warranty or additional liability.
175
-
176
- END OF TERMS AND CONDITIONS
177
-
178
- APPENDIX: How to apply the Apache License to your work.
179
-
180
- To apply the Apache License to your work, attach the following
181
- boilerplate notice, with the fields enclosed by brackets "[]"
182
- replaced with your own identifying information. (Don't include
183
- the brackets!) The text should be enclosed in the appropriate
184
- comment syntax for the file format. We also recommend that a
185
- file or class name and description of purpose be included on the
186
- same "printed page" as the copyright notice for easier
187
- identification within third-party archives.
188
-
189
- Copyright [yyyy] [name of copyright owner]
190
-
191
- Licensed under the Apache License, Version 2.0 (the "License");
192
- you may not use this file except in compliance with the License.
193
- You may obtain a copy of the License at
194
-
195
- http://www.apache.org/licenses/LICENSE-2.0
196
-
197
- Unless required by applicable law or agreed to in writing, software
198
- distributed under the License is distributed on an "AS IS" BASIS,
199
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
- See the License for the specific language governing permissions and
201
- limitations under the License.
@@ -1,33 +0,0 @@
1
- # Important Use Cases
2
-
3
- This document summarizes important use cases for testing whether the wrapper works.
4
-
5
- ## Normal messages
6
-
7
- 1. User message sent from UI should be sent and submitted to terminal
8
- 2. User message sent from terminal should be displayed in UI.
9
- 3. Agent message from terminal should be displayed in UI.
10
- 4. No duplicate of user or agent messages
11
-
12
- ## Push Notifications
13
-
14
- 5. Push notifications should be sent to user when agent completes a task, not while it is running.
15
-
16
- ## Permission Requests
17
-
18
- 6. Permission request response options should be properly displayed in UI.
19
- 7. Selecting an option of permission request in UI should be sent to terminal.
20
- 8. Selecting options like "No" of permission request response options, it should be able to send new messages from UI to terminal.
21
-
22
- ## Control Messages
23
-
24
- e.g. interruption, change permission mode, change model, change agent, etc.
25
-
26
- 9. Interrupt the agent from UI while it is busy.
27
- 10. User messages sent while agent is busy should be handled directly, control messages are processed, other messages are send to the terminal directly.
28
- 11. Permission mode changes in terminal is reflected in UI with a response.
29
- 12. Permission mode changes from UI should be reflected in terminal.
30
-
31
- ## Close Terminal
32
-
33
- 13. Closing the terminal should update the session status.
@@ -1,136 +0,0 @@
1
- # CLAUDE.md
2
-
3
- This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4
-
5
- ## Development Tools
6
-
7
- - Runtime: Bun 1.2.11
8
- - TypeScript with strict configuration
9
-
10
- ## Common Development Tasks
11
-
12
- ### Available npm/bun scripts from package.json:
13
-
14
- ```bash
15
- # Test
16
- bun test
17
-
18
- # Formatting
19
- bun run format # Format code with prettier
20
- bun run format:check # Check code formatting
21
-
22
- # Type checking
23
- bun run typecheck # Run TypeScript type checker
24
- ```
25
-
26
- ## Architecture Overview
27
-
28
- This is a GitHub Action that enables Claude to interact with GitHub PRs and issues. The action operates in two main phases:
29
-
30
- ### Phase 1: Preparation (`src/entrypoints/prepare.ts`)
31
-
32
- 1. **Authentication Setup**: Establishes GitHub token via OIDC or GitHub App
33
- 2. **Permission Validation**: Verifies actor has write permissions
34
- 3. **Trigger Detection**: Uses mode-specific logic to determine if Claude should respond
35
- 4. **Context Creation**: Prepares GitHub context and initial tracking comment
36
-
37
- ### Phase 2: Execution (`base-action/`)
38
-
39
- The `base-action/` directory contains the core Claude Code execution logic, which serves a dual purpose:
40
-
41
- - **Standalone Action**: Published separately as `@anthropic-ai/claude-code-base-action` for direct use
42
- - **Inner Logic**: Used internally by this GitHub Action after preparation phase completes
43
-
44
- Execution steps:
45
-
46
- 1. **MCP Server Setup**: Installs and configures GitHub MCP server for tool access
47
- 2. **Prompt Generation**: Creates context-rich prompts from GitHub data
48
- 3. **Claude Integration**: Executes via multiple providers (Anthropic API, AWS Bedrock, Google Vertex AI)
49
- 4. **Result Processing**: Updates comments and creates branches/PRs as needed
50
-
51
- ### Key Architectural Components
52
-
53
- #### Mode System (`src/modes/`)
54
-
55
- - **Tag Mode** (`tag/`): Responds to `@claude` mentions and issue assignments
56
- - **Agent Mode** (`agent/`): Direct execution when explicit prompt is provided
57
- - Extensible registry pattern in `modes/registry.ts`
58
-
59
- #### GitHub Integration (`src/github/`)
60
-
61
- - **Context Parsing** (`context.ts`): Unified GitHub event handling
62
- - **Data Fetching** (`data/fetcher.ts`): Retrieves PR/issue data via GraphQL/REST
63
- - **Data Formatting** (`data/formatter.ts`): Converts GitHub data to Claude-readable format
64
- - **Branch Operations** (`operations/branch.ts`): Handles branch creation and cleanup
65
- - **Comment Management** (`operations/comments/`): Creates and updates tracking comments
66
-
67
- #### MCP Server Integration (`src/mcp/`)
68
-
69
- - **GitHub Actions Server** (`github-actions-server.ts`): Workflow and CI access
70
- - **GitHub Comment Server** (`github-comment-server.ts`): Comment operations
71
- - **GitHub File Operations** (`github-file-ops-server.ts`): File system access
72
- - Auto-installation and configuration in `install-mcp-server.ts`
73
-
74
- #### Authentication & Security (`src/github/`)
75
-
76
- - **Token Management** (`token.ts`): OIDC token exchange and GitHub App authentication
77
- - **Permission Validation** (`validation/permissions.ts`): Write access verification
78
- - **Actor Validation** (`validation/actor.ts`): Human vs bot detection
79
-
80
- ### Project Structure
81
-
82
- ```
83
- src/
84
- ├── entrypoints/ # Action entry points
85
- │ ├── prepare.ts # Main preparation logic
86
- │ ├── update-comment-link.ts # Post-execution comment updates
87
- │ └── format-turns.ts # Claude conversation formatting
88
- ├── github/ # GitHub integration layer
89
- │ ├── api/ # REST/GraphQL clients
90
- │ ├── data/ # Data fetching and formatting
91
- │ ├── operations/ # Branch, comment, git operations
92
- │ ├── validation/ # Permission and trigger validation
93
- │ └── utils/ # Image downloading, sanitization
94
- ├── modes/ # Execution modes
95
- │ ├── tag/ # @claude mention mode
96
- │ ├── agent/ # Automation mode
97
- │ └── registry.ts # Mode selection logic
98
- ├── mcp/ # MCP server implementations
99
- ├── prepare/ # Preparation orchestration
100
- └── utils/ # Shared utilities
101
- ```
102
-
103
- ## Important Implementation Notes
104
-
105
- ### Authentication Flow
106
-
107
- - Uses GitHub OIDC token exchange for secure authentication
108
- - Supports custom GitHub Apps via `APP_ID` and `APP_PRIVATE_KEY`
109
- - Falls back to official Claude GitHub App if no custom app provided
110
-
111
- ### MCP Server Architecture
112
-
113
- - Each MCP server has specific GitHub API access patterns
114
- - Servers are auto-installed in `~/.claude/mcp/github-{type}-server/`
115
- - Configuration merged with user-provided MCP config via `mcp_config` input
116
-
117
- ### Mode System Design
118
-
119
- - Modes implement `Mode` interface with `shouldTrigger()` and `prepare()` methods
120
- - Registry validates mode compatibility with GitHub event types
121
- - Agent mode triggers when explicit prompt is provided
122
-
123
- ### Comment Threading
124
-
125
- - Single tracking comment updated throughout execution
126
- - Progress indicated via dynamic checkboxes
127
- - Links to job runs and created branches/PRs
128
- - Sticky comment option for consolidated PR comments
129
-
130
- ## Code Conventions
131
-
132
- - Use Bun-specific TypeScript configuration with `moduleResolution: "bundler"`
133
- - Strict TypeScript with `noUnusedLocals` and `noUnusedParameters` enabled
134
- - Prefer explicit error handling with detailed error messages
135
- - Use discriminated unions for GitHub context types
136
- - Implement retry logic for GitHub API operations via `utils/retry.ts`
@@ -1,128 +0,0 @@
1
- # Contributor Covenant Code of Conduct
2
-
3
- ## Our Pledge
4
-
5
- We as members, contributors, and leaders pledge to make participation in our
6
- community a harassment-free experience for everyone, regardless of age, body
7
- size, visible or invisible disability, ethnicity, sex characteristics, gender
8
- identity and expression, level of experience, education, socio-economic status,
9
- nationality, personal appearance, race, religion, or sexual identity
10
- and orientation.
11
-
12
- We pledge to act and interact in ways that contribute to an open, welcoming,
13
- diverse, inclusive, and healthy community.
14
-
15
- ## Our Standards
16
-
17
- Examples of behavior that contributes to a positive environment for our
18
- community include:
19
-
20
- - Demonstrating empathy and kindness toward other people
21
- - Being respectful of differing opinions, viewpoints, and experiences
22
- - Giving and gracefully accepting constructive feedback
23
- - Accepting responsibility and apologizing to those affected by our mistakes,
24
- and learning from the experience
25
- - Focusing on what is best not just for us as individuals, but for the
26
- overall community
27
-
28
- Examples of unacceptable behavior include:
29
-
30
- - The use of sexualized language or imagery, and sexual attention or
31
- advances of any kind
32
- - Trolling, insulting or derogatory comments, and personal or political attacks
33
- - Public or private harassment
34
- - Publishing others' private information, such as a physical or email
35
- address, without their explicit permission
36
- - Other conduct which could reasonably be considered inappropriate in a
37
- professional setting
38
-
39
- ## Enforcement Responsibilities
40
-
41
- Community leaders are responsible for clarifying and enforcing our standards of
42
- acceptable behavior and will take appropriate and fair corrective action in
43
- response to any behavior that they deem inappropriate, threatening, offensive,
44
- or harmful.
45
-
46
- Community leaders have the right and responsibility to remove, edit, or reject
47
- comments, commits, code, wiki edits, issues, and other contributions that are
48
- not aligned to this Code of Conduct, and will communicate reasons for moderation
49
- decisions when appropriate.
50
-
51
- ## Scope
52
-
53
- This Code of Conduct applies within all community spaces, and also applies when
54
- an individual is officially representing the community in public spaces.
55
- Examples of representing our community include using an official e-mail address,
56
- posting via an official social media account, or acting as an appointed
57
- representative at an online or offline event.
58
-
59
- ## Enforcement
60
-
61
- Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
- reported to the community leaders responsible for enforcement at
63
- claude-code-action-coc@anthropic.com.
64
- All complaints will be reviewed and investigated promptly and fairly.
65
-
66
- All community leaders are obligated to respect the privacy and security of the
67
- reporter of any incident.
68
-
69
- ## Enforcement Guidelines
70
-
71
- Community leaders will follow these Community Impact Guidelines in determining
72
- the consequences for any action they deem in violation of this Code of Conduct:
73
-
74
- ### 1. Correction
75
-
76
- **Community Impact**: Use of inappropriate language or other behavior deemed
77
- unprofessional or unwelcome in the community.
78
-
79
- **Consequence**: A private, written warning from community leaders, providing
80
- clarity around the nature of the violation and an explanation of why the
81
- behavior was inappropriate. A public apology may be requested.
82
-
83
- ### 2. Warning
84
-
85
- **Community Impact**: A violation through a single incident or series
86
- of actions.
87
-
88
- **Consequence**: A warning with consequences for continued behavior. No
89
- interaction with the people involved, including unsolicited interaction with
90
- those enforcing the Code of Conduct, for a specified period of time. This
91
- includes avoiding interactions in community spaces as well as external channels
92
- like social media. Violating these terms may lead to a temporary or
93
- permanent ban.
94
-
95
- ### 3. Temporary Ban
96
-
97
- **Community Impact**: A serious violation of community standards, including
98
- sustained inappropriate behavior.
99
-
100
- **Consequence**: A temporary ban from any sort of interaction or public
101
- communication with the community for a specified period of time. No public or
102
- private interaction with the people involved, including unsolicited interaction
103
- with those enforcing the Code of Conduct, is allowed during this period.
104
- Violating these terms may lead to a permanent ban.
105
-
106
- ### 4. Permanent Ban
107
-
108
- **Community Impact**: Demonstrating a pattern of violation of community
109
- standards, including sustained inappropriate behavior, harassment of an
110
- individual, or aggression toward or disparagement of classes of individuals.
111
-
112
- **Consequence**: A permanent ban from any sort of public interaction within
113
- the community.
114
-
115
- ## Attribution
116
-
117
- This Code of Conduct is adapted from the [Contributor Covenant][homepage],
118
- version 2.0, available at
119
- https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
120
-
121
- Community Impact Guidelines were inspired by [Mozilla's code of conduct
122
- enforcement ladder](https://github.com/mozilla/diversity).
123
-
124
- [homepage]: https://www.contributor-covenant.org
125
-
126
- For answers to common questions about this code of conduct, see the FAQ at
127
- https://www.contributor-covenant.org/faq. Translations are available at
128
- https://www.contributor-covenant.org/translations.