@uipath/delegate-sdk 1.203.1 → 1.203.3

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 (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +729 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +444 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +224 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,446 @@
1
+ ---
2
+ name: GitHub
3
+ version: 1.0.0
4
+ description: GitHub repos, issues, PRs, branches, commits, and files via Integration Service API.
5
+ icon: github
6
+ color: 181717
7
+ type: skill
8
+ assets:
9
+ integration_services:
10
+ key: uipath-microsoft-github
11
+ ---
12
+
13
+ # GitHub Integration
14
+
15
+ Execute GitHub operations through UiPath Integration Service.
16
+
17
+ ## ⚠️ CRITICAL SAFETY RULE
18
+
19
+ > **NEVER execute write operations (POST/PUT/PATCH/DELETE) without explicit user permission!**
20
+
21
+ Write operations will create real issues, PRs, branches, or modify actual repositories.
22
+
23
+ **Safe (no permission needed):** GET requests - listing repos, issues, PRs, branches, commits
24
+
25
+ **Requires explicit permission:** Creating/updating issues, PRs, branches, merging, file uploads/deletes
26
+
27
+ ---
28
+
29
+ ## Tool
30
+
31
+ Use `SendUiPathRequest` to execute all GitHub API calls.
32
+
33
+ ---
34
+
35
+ ## How It Works
36
+
37
+ Integration Service acts as an **authenticated proxy** to GitHub's REST API. It:
38
+ 1. Handles OAuth authentication automatically
39
+ 2. Forwards your request to GitHub's API **in GitHub's native format**
40
+ 3. Returns GitHub's response directly
41
+
42
+ ## 🔌 Connection Details
43
+
44
+ {ConnectionDetails}
45
+
46
+ **Use GitHub's official REST API format** for:
47
+ - Endpoints: `/repos/{owner}/{repo}/issues`
48
+ - Query parameters: `?state=open&per_page=30`
49
+ - Request body: GitHub's JSON schema
50
+
51
+ 📖 **References:**
52
+ - [GitHub REST API Docs](https://docs.github.com/en/rest)
53
+ - For Integration Service details, see the **UiPath Integrations** skill
54
+
55
+ ---
56
+
57
+ ## Connector Key
58
+
59
+ ```
60
+ uipath-microsoft-github
61
+ ```
62
+
63
+ ---
64
+
65
+ ## Quick Reference
66
+
67
+ | Task | Operation Name | Type |
68
+ |------|----------------|------|
69
+ | List repositories | `repos` | GET |
70
+ | Get repository details | `repos` | GET |
71
+ | Create repository | `create_repos` | POST ⚠️ |
72
+ | List branches | `branches` or `list_branches` | GET |
73
+ | Create branch | `create_branch` | POST ⚠️ |
74
+ | Compare branches | `compare` | GET |
75
+ | List commits | `commits` or `git::commits` | GET |
76
+ | List issues | `issues` or `issues_in_repo` | GET |
77
+ | Get single issue | `issue` | GET |
78
+ | Create issue | `create_issues` | POST ⚠️ |
79
+ | Update issue | `update_issues` | PATCH ⚠️ |
80
+ | Create issue comment | `create_issue_comment` | POST ⚠️ |
81
+ | Search issues | `search_issues` | GET |
82
+ | List pull requests | `pulls` or `pulls_in_repo` | GET |
83
+ | Get single PR | `pull` | GET |
84
+ | Create pull request | `create_pulls` | POST ⚠️ |
85
+ | Update pull request | `update_pulls_events` | PATCH ⚠️ |
86
+ | Merge pull request | `merge_pull_request` | PUT ⚠️ |
87
+ | Get merge status | `merge_pull_request_status` | GET |
88
+ | List PR commits | `pulls::commits` | GET |
89
+ | List PR files | `pulls::files` | GET |
90
+ | Get file contents | `repository::contents` | GET |
91
+ | Upload file | `upload_file` | PUT ⚠️ |
92
+ | Delete file | `delete_file` | DELETE ⚠️ |
93
+ | Download file | `download_file` | GET |
94
+ | Search repositories | `search_repositories` | GET |
95
+ | Search users | `search_users` | GET |
96
+ | Get user | `user` or `users` | GET |
97
+ | List user repos | `user_repos` | GET |
98
+ | List teams | `teams` | GET |
99
+ | List forks | `forks` | GET |
100
+ | Get git tree | `git::trees` | GET |
101
+ | Get git refs | `git::refs` or `git::refs::tags` | GET |
102
+ | Get matching refs | `git::matching-refs` | GET |
103
+
104
+ ---
105
+
106
+ ## Workflow: Execute GitHub API Call
107
+
108
+ ### Step 1: Find GitHub Connection
109
+
110
+ elementInstanceId can be found in 'Connection Details' section above. If not available, use fallback:
111
+
112
+ **Option A: Get Default Connection (Recommended)**
113
+
114
+ ```
115
+ GET connections_/api/v1/Connectors/uipath-microsoft-github/connection
116
+ ```
117
+
118
+ This returns the user's default GitHub connection directly. Much more efficient than fetching all connections.
119
+
120
+ Extract: `id`, `elementInstanceId`, `name`
121
+
122
+ **Option B: Get All Connections and Filter**
123
+
124
+ Use this if you need to list all GitHub connections or find a specific non-default one:
125
+
126
+ ```
127
+ GET connections_/api/v1/Connections?allFolders=true
128
+ ```
129
+
130
+ Filter response for `connector.key === "uipath-microsoft-github"` and `state === "Enabled"`.
131
+
132
+ > **Note:** The Connections API only supports `allFolders=true` as a query parameter. Parameters like `?connectorKey=X` or `?type=X` don't work for server-side filtering.
133
+
134
+ ### Step 2: Verify Connection Health
135
+
136
+ ```
137
+ GET connections_/api/v1/Connections/{id}/ping
138
+ ```
139
+
140
+ ### Step 3: Execute API Call
141
+
142
+ ```
143
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
144
+ ```
145
+
146
+ **Request Body Structure:**
147
+ ```json
148
+ {
149
+ "authentication": "connector",
150
+ "targetConnector": "uipath-microsoft-github",
151
+ "connection": "{connection_id}",
152
+ "method": "GET|POST|PUT|PATCH|DELETE",
153
+ "url": "/repos/{owner}/{repo}/...",
154
+ "path": "/repos/{owner}/{repo}/...",
155
+ "headers": {},
156
+ "query": {},
157
+ "body": ""
158
+ }
159
+ ```
160
+
161
+ **Critical:** Query values MUST be strings: `{"per_page": "100"}` not `{"per_page": 100}`
162
+
163
+ ---
164
+
165
+ ## Common Examples
166
+
167
+ ### List User's Repositories
168
+ ```json
169
+ {
170
+ "authentication": "connector",
171
+ "targetConnector": "uipath-microsoft-github",
172
+ "connection": "{connection_id}",
173
+ "method": "GET",
174
+ "url": "/user/repos",
175
+ "path": "/user/repos",
176
+ "headers": {},
177
+ "query": {"per_page": "30", "sort": "updated"},
178
+ "body": ""
179
+ }
180
+ ```
181
+
182
+ ### Get Repository Details
183
+ ```json
184
+ {
185
+ "method": "GET",
186
+ "url": "/repos/{owner}/{repo}",
187
+ "path": "/repos/{owner}/{repo}",
188
+ "query": {}
189
+ }
190
+ ```
191
+
192
+ ### List Repository Issues
193
+ ```json
194
+ {
195
+ "method": "GET",
196
+ "url": "/repos/{owner}/{repo}/issues",
197
+ "path": "/repos/{owner}/{repo}/issues",
198
+ "query": {"state": "open", "per_page": "30"}
199
+ }
200
+ ```
201
+
202
+ ### Create Issue ⚠️
203
+ ```json
204
+ {
205
+ "method": "POST",
206
+ "url": "/repos/{owner}/{repo}/issues",
207
+ "path": "/repos/{owner}/{repo}/issues",
208
+ "body": "{\"title\": \"Bug: Something is broken\", \"body\": \"Description here\", \"labels\": [\"bug\"]}"
209
+ }
210
+ ```
211
+
212
+ ### List Pull Requests
213
+ ```json
214
+ {
215
+ "method": "GET",
216
+ "url": "/repos/{owner}/{repo}/pulls",
217
+ "path": "/repos/{owner}/{repo}/pulls",
218
+ "query": {"state": "open", "per_page": "30"}
219
+ }
220
+ ```
221
+
222
+ ### Create Pull Request ⚠️
223
+ ```json
224
+ {
225
+ "method": "POST",
226
+ "url": "/repos/{owner}/{repo}/pulls",
227
+ "path": "/repos/{owner}/{repo}/pulls",
228
+ "body": "{\"title\": \"Feature: Add new functionality\", \"body\": \"Description\", \"head\": \"feature-branch\", \"base\": \"main\"}"
229
+ }
230
+ ```
231
+
232
+ ### Merge Pull Request ⚠️
233
+ ```json
234
+ {
235
+ "method": "PUT",
236
+ "url": "/repos/{owner}/{repo}/pulls/{pull_number}/merge",
237
+ "path": "/repos/{owner}/{repo}/pulls/{pull_number}/merge",
238
+ "body": "{\"commit_title\": \"Merge PR #123\", \"merge_method\": \"squash\"}"
239
+ }
240
+ ```
241
+
242
+ ### List Branches
243
+ ```json
244
+ {
245
+ "method": "GET",
246
+ "url": "/repos/{owner}/{repo}/branches",
247
+ "path": "/repos/{owner}/{repo}/branches",
248
+ "query": {"per_page": "100"}
249
+ }
250
+ ```
251
+
252
+ ### Create Branch ⚠️
253
+ ```json
254
+ {
255
+ "method": "POST",
256
+ "url": "/repos/{owner}/{repo}/git/refs",
257
+ "path": "/repos/{owner}/{repo}/git/refs",
258
+ "body": "{\"ref\": \"refs/heads/new-branch-name\", \"sha\": \"{commit_sha}\"}"
259
+ }
260
+ ```
261
+
262
+ ### List Commits
263
+ ```json
264
+ {
265
+ "method": "GET",
266
+ "url": "/repos/{owner}/{repo}/commits",
267
+ "path": "/repos/{owner}/{repo}/commits",
268
+ "query": {"sha": "main", "per_page": "30"}
269
+ }
270
+ ```
271
+
272
+ ### Get File Contents
273
+ ```json
274
+ {
275
+ "method": "GET",
276
+ "url": "/repos/{owner}/{repo}/contents/{path}",
277
+ "path": "/repos/{owner}/{repo}/contents/{path}",
278
+ "query": {"ref": "main"}
279
+ }
280
+ ```
281
+
282
+ **⚠️ Base64 Decoding Tip:** File contents are returned base64-encoded. To decode:
283
+
284
+ 1. Use SendUiPathRequest with `maxInlineBytes: 500` to force dump with small preview
285
+ 2. Decode with PowerShell:
286
+
287
+ ```powershell
288
+ $json = Get-Content "path/to/dumped/file.json" | ConvertFrom-Json
289
+ $base64 = $json.body.content -replace '\n',''
290
+ [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($base64))
291
+ ```
292
+
293
+ > **Note:** Don't use `download_url` for private repos - the embedded token expires immediately.
294
+
295
+ ### Upload/Update File ⚠️
296
+ ```json
297
+ {
298
+ "method": "PUT",
299
+ "url": "/repos/{owner}/{repo}/contents/{path}",
300
+ "path": "/repos/{owner}/{repo}/contents/{path}",
301
+ "body": "{\"message\": \"Add new file\", \"content\": \"{base64_encoded_content}\", \"branch\": \"main\"}"
302
+ }
303
+ ```
304
+ Note: For updates, include `"sha": "{existing_file_sha}"` in body.
305
+
306
+ ### Search Repositories
307
+ ```json
308
+ {
309
+ "method": "GET",
310
+ "url": "/search/repositories",
311
+ "path": "/search/repositories",
312
+ "query": {"q": "language:python stars:>1000", "sort": "stars", "per_page": "10"}
313
+ }
314
+ ```
315
+
316
+ ### Search Issues
317
+ ```json
318
+ {
319
+ "method": "GET",
320
+ "url": "/search/issues",
321
+ "path": "/search/issues",
322
+ "query": {"q": "repo:{owner}/{repo} is:issue is:open", "per_page": "30"}
323
+ }
324
+ ```
325
+
326
+ ### Compare Branches
327
+ ```json
328
+ {
329
+ "method": "GET",
330
+ "url": "/repos/{owner}/{repo}/compare/{base}...{head}",
331
+ "path": "/repos/{owner}/{repo}/compare/{base}...{head}",
332
+ "query": {}
333
+ }
334
+ ```
335
+
336
+ ### Add Issue Comment ⚠️
337
+ ```json
338
+ {
339
+ "method": "POST",
340
+ "url": "/repos/{owner}/{repo}/issues/{issue_number}/comments",
341
+ "path": "/repos/{owner}/{repo}/issues/{issue_number}/comments",
342
+ "body": "{\"body\": \"This is a comment on the issue.\"}"
343
+ }
344
+ ```
345
+
346
+ ---
347
+
348
+ ## GitHub API Endpoints Reference
349
+
350
+ | Category | Endpoint Pattern |
351
+ |----------|------------------|
352
+ | **User** | `/user`, `/users/{username}` |
353
+ | **Repos** | `/user/repos`, `/repos/{owner}/{repo}` |
354
+ | **Branches** | `/repos/{owner}/{repo}/branches`, `/repos/{owner}/{repo}/branches/{branch}` |
355
+ | **Commits** | `/repos/{owner}/{repo}/commits`, `/repos/{owner}/{repo}/commits/{sha}` |
356
+ | **Issues** | `/repos/{owner}/{repo}/issues`, `/repos/{owner}/{repo}/issues/{number}` |
357
+ | **PRs** | `/repos/{owner}/{repo}/pulls`, `/repos/{owner}/{repo}/pulls/{number}` |
358
+ | **Contents** | `/repos/{owner}/{repo}/contents/{path}` |
359
+ | **Search** | `/search/repositories`, `/search/issues`, `/search/users` |
360
+ | **Git Data** | `/repos/{owner}/{repo}/git/refs`, `/repos/{owner}/{repo}/git/commits` |
361
+
362
+ ---
363
+
364
+ ## Query Parameters
365
+
366
+ | Parameter | Description | Example |
367
+ |-----------|-------------|---------|
368
+ | `per_page` | Results per page (max 100) | `"100"` |
369
+ | `page` | Page number | `"1"` |
370
+ | `state` | Filter by state | `"open"`, `"closed"`, `"all"` |
371
+ | `sort` | Sort field | `"created"`, `"updated"`, `"stars"` |
372
+ | `direction` | Sort direction | `"asc"`, `"desc"` |
373
+ | `sha` | Branch/commit SHA | `"main"` |
374
+ | `ref` | Git reference | `"main"` |
375
+ | `q` | Search query | `"language:python"` |
376
+
377
+ ---
378
+
379
+ ## Connection States
380
+
381
+ | State | Agent Action |
382
+ |-------|--------------|
383
+ | `Enabled` | Proceed with API calls |
384
+ | `Disabled` | Tell user to enable connection in UiPath Cloud |
385
+ | `Expired` | Tell user to re-authorize connection in UiPath Cloud |
386
+
387
+ ---
388
+
389
+ ## Error Handling
390
+
391
+ | Status | Meaning | Action |
392
+ |--------|---------|--------|
393
+ | 200/201 | Success | Process response |
394
+ | 401 | Unauthorized | Connection needs re-auth in UiPath Cloud |
395
+ | 403 | Forbidden | Check permissions/rate limits |
396
+ | 404 | Not Found | Verify owner/repo/path exists |
397
+ | 422 | Validation Error | Check request body format |
398
+ | 429 | Rate Limited | Wait and retry |
399
+
400
+ ---
401
+
402
+ ## Retry Strategy
403
+
404
+ | Error | Action |
405
+ |-------|--------|
406
+ | `429 Rate Limited` | Wait `Retry-After` header seconds, then retry |
407
+ | `5xx Server Error` | Retry with exponential backoff: 1s, 2s, 4s |
408
+ | `401 Unauthorized` | Do not retry - connection needs re-auth in UiPath Cloud |
409
+ | `403 Forbidden` | Do not retry - check rate limits or repository permissions |
410
+
411
+ ---
412
+
413
+ ## Rate Limits
414
+
415
+ GitHub API has rate limits:
416
+ - **Authenticated:** 5,000 requests/hour
417
+ - **Search API:** 30 requests/minute
418
+
419
+ Check `X-RateLimit-Remaining` header in responses.
420
+
421
+ ---
422
+
423
+ ## 📁 Recipes
424
+
425
+ For step-by-step guides to common GitHub tasks, see the **`recipes/`** folder:
426
+
427
+ | Recipe | Description |
428
+ |--------|-------------|
429
+ | `get-last-commit.md` | Get the user's most recent commit |
430
+ | `list-my-open-prs.md` | List PRs the user has open |
431
+ | `check-pr-status.md` | Get detailed PR status with checks |
432
+ | `search-issues.md` | Search issues with various filters |
433
+ | `create-issue.md` | Create a new issue ⚠️ |
434
+ | `get-file-contents.md` | Read file content from a repo |
435
+ | `compare-branches.md` | Compare two branches |
436
+ | `list-recent-commits.md` | List recent commits on a branch |
437
+ | `create-pr.md` | Create a pull request ⚠️ |
438
+ | `add-comment.md` | Add comment to issue or PR ⚠️ |
439
+
440
+ Each recipe includes:
441
+ - **When to use** - Trigger phrases
442
+ - **Step-by-step workflow** - Exact API calls
443
+ - **Example output** - How to present results
444
+ - **Key learnings** - Gotchas and tips
445
+
446
+ ⚠️ = Write operation (requires user permission)
@@ -0,0 +1,85 @@
1
+ # Recipe: Add Comment to Issue/PR
2
+
3
+ ## When to Use
4
+ User asks: "Comment on issue #123", "Add a note to the PR", "Reply to the issue"
5
+
6
+ ## ⚠️ Safety Warning
7
+ This is a **write operation** that posts a real comment. Always confirm with the user before executing.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 1: Get GitHub Connection
12
+ ```
13
+ GET connections_/api/v1/Connectors/uipath-microsoft-github/connection
14
+ ```
15
+
16
+ ### Step 2: Add Comment
17
+ ```
18
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
19
+ ```
20
+
21
+ ```json
22
+ {
23
+ "authentication": "connector",
24
+ "targetConnector": "uipath-microsoft-github",
25
+ "connection": "{connectionId}",
26
+ "method": "POST",
27
+ "url": "/repos/{owner}/{repo}/issues/{issue_number}/comments",
28
+ "path": "/repos/{owner}/{repo}/issues/{issue_number}/comments",
29
+ "headers": {},
30
+ "query": {},
31
+ "body": "{\"body\": \"Your comment text here\"}"
32
+ }
33
+ ```
34
+
35
+ **Note:** This endpoint works for both issues AND pull requests (PRs are issues in GitHub's API).
36
+
37
+ Parse response:
38
+ ```javascript
39
+ // Response code 201 = Created successfully
40
+ const comment = response.body;
41
+
42
+ comment.id // Comment ID
43
+ comment.html_url // Direct link to comment
44
+ comment.body // Comment text
45
+ comment.user.login // Author (authenticated user)
46
+ comment.created_at // ISO timestamp
47
+ ```
48
+
49
+ ## Example Output
50
+
51
+ ✅ **Comment added!**
52
+
53
+ | Field | Value |
54
+ |-------|-------|
55
+ | **Issue** | #649 |
56
+ | **Comment ID** | 3786455242 |
57
+ | **Link** | [View comment](https://github.com/UiPath/DNA.Recorder/issues/649#issuecomment-3786455242) |
58
+
59
+ ## Variations
60
+
61
+ ### Comment with Markdown
62
+ ```json
63
+ {
64
+ "body": "{\"body\": \"## Summary\\n\\nThis looks good! ✅\\n\\n**Notes:**\\n- Item 1\\n- Item 2\"}"
65
+ }
66
+ ```
67
+
68
+ ### Comment on PR Review (different endpoint)
69
+ For review comments on specific code lines:
70
+ ```json
71
+ {
72
+ "method": "POST",
73
+ "url": "/repos/{owner}/{repo}/pulls/{pull_number}/comments",
74
+ "body": "{\"body\": \"Comment on code\", \"commit_id\": \"sha\", \"path\": \"file.js\", \"line\": 10}"
75
+ }
76
+ ```
77
+
78
+ ## Key Learnings
79
+
80
+ 1. **Same endpoint for issues and PRs** - `/issues/{number}/comments` works for both
81
+ 2. **Markdown supported** - Use `\\n` for newlines in escaped JSON
82
+ 3. **Emoji supported** - Include emoji directly in the body text
83
+ 4. **201 = success** - Response code 201 (Created) indicates success
84
+ 5. **html_url for sharing** - Use `response.body.html_url` for direct link to comment
85
+ 6. **Always ask permission** - This posts a real comment; get user confirmation first
@@ -0,0 +1,122 @@
1
+ # Recipe: Check PR Status
2
+
3
+ ## When to Use
4
+ User asks: "What's the status of PR #123?", "Check my PR", "Is PR ready to merge?", "PR details"
5
+
6
+ ## Workflow
7
+
8
+ ### Step 1: Get GitHub Connection
9
+ ```
10
+ GET connections_/api/v1/Connectors/uipath-microsoft-github/connection
11
+ ```
12
+
13
+ Extract from response:
14
+ ```javascript
15
+ const connectionId = response.id;
16
+ const elementInstanceId = response.elementInstanceId;
17
+ ```
18
+
19
+ ### Step 2: Get PR Details
20
+ ```
21
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
22
+ ```
23
+
24
+ ```json
25
+ {
26
+ "authentication": "connector",
27
+ "targetConnector": "uipath-microsoft-github",
28
+ "connection": "{connectionId}",
29
+ "method": "GET",
30
+ "url": "/repos/{owner}/{repo}/pulls/{pr_number}",
31
+ "path": "/repos/{owner}/{repo}/pulls/{pr_number}",
32
+ "headers": {},
33
+ "query": {},
34
+ "body": ""
35
+ }
36
+ ```
37
+
38
+ Parse response - key fields:
39
+ ```javascript
40
+ const pr = response.body;
41
+
42
+ // Basic info
43
+ pr.number // PR number
44
+ pr.title // PR title
45
+ pr.state // "open" or "closed"
46
+ pr.draft // Boolean - is it a draft?
47
+ pr.user.login // Author username
48
+ pr.html_url // Link to PR on GitHub
49
+
50
+ // Branch info
51
+ pr.base.ref // Target branch (e.g., "main")
52
+ pr.head.ref // Source branch (e.g., "feature-branch")
53
+
54
+ // Timestamps
55
+ pr.created_at // ISO timestamp
56
+ pr.updated_at // ISO timestamp
57
+ pr.merged_at // ISO timestamp (null if not merged)
58
+ pr.closed_at // ISO timestamp (null if still open)
59
+
60
+ // Merge status
61
+ pr.mergeable // Boolean or null (may need refresh)
62
+ pr.mergeable_state // "clean", "dirty", "blocked", "unknown"
63
+ pr.merged // Boolean - has it been merged?
64
+
65
+ // Stats
66
+ pr.commits // Number of commits
67
+ pr.additions // Lines added
68
+ pr.deletions // Lines deleted
69
+ pr.changed_files // Number of files changed
70
+ pr.comments // Number of issue comments
71
+ pr.review_comments // Number of review comments
72
+ ```
73
+
74
+ ## Example Output
75
+
76
+ Present to user as:
77
+
78
+ ### Pull Request #1346 - Store text attachments from ReadFile tool in DB
79
+
80
+ | Field | Value |
81
+ |-------|-------|
82
+ | **Status** | Open (Ready for review) |
83
+ | **Author** | viktor-zhyvodorov |
84
+ | **Branch** | `feature-branch` → `main` |
85
+ | **Created** | Jan 21, 2026 at 3:26 PM |
86
+ | **Updated** | Jan 22, 2026 at 10:10 AM |
87
+ | **Commits** | 3 |
88
+ | **Changes** | +1,107 / -61 across 3 files |
89
+ | **Comments** | 4 comments, 7 review comments |
90
+ | **Mergeable** | Yes / No / Unknown |
91
+
92
+ ## Variations
93
+
94
+ ### Get PR Files Changed
95
+ To see which files were modified:
96
+ ```json
97
+ {
98
+ "method": "GET",
99
+ "url": "/repos/{owner}/{repo}/pulls/{pr_number}/files",
100
+ "path": "/repos/{owner}/{repo}/pulls/{pr_number}/files",
101
+ "query": {"per_page": "100"}
102
+ }
103
+ ```
104
+
105
+ ### Get PR Reviews
106
+ To see review status (approved, changes requested, etc.):
107
+ ```json
108
+ {
109
+ "method": "GET",
110
+ "url": "/repos/{owner}/{repo}/pulls/{pr_number}/reviews",
111
+ "path": "/repos/{owner}/{repo}/pulls/{pr_number}/reviews",
112
+ "query": {}
113
+ }
114
+ ```
115
+
116
+ ## Key Learnings
117
+
118
+ 1. **mergeable can be null** - GitHub may need time to compute merge status; `mergeable_state: "unknown"` means it's still calculating
119
+ 2. **draft vs ready** - Check `draft` boolean to show correct status
120
+ 3. **merged vs closed** - A closed PR isn't necessarily merged; check `merged` boolean
121
+ 4. **Review comments vs comments** - `review_comments` are inline code comments; `comments` are issue-style comments
122
+ 5. **Need owner/repo and PR number** - User must provide these or you extract from context