@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,397 @@
1
+ ---
2
+ name: Jira
3
+ version: 1.0.0
4
+ description: Jira projects, issues, sprints, comments, and transitions via Integration Service API.
5
+ icon: jira
6
+ color: 0052CC
7
+ type: skill
8
+ assets:
9
+ integration_services:
10
+ key: uipath-atlassian-jira
11
+ ---
12
+
13
+ # Jira Integration
14
+
15
+ Execute Jira operations through UiPath Integration Service.
16
+
17
+ ## 🔌 Connection Details
18
+
19
+ {ConnectionDetails}
20
+
21
+ ## ⚠️ CRITICAL SAFETY RULE
22
+
23
+ > **NEVER execute write operations (POST/PUT/DELETE) without explicit user permission!**
24
+
25
+ Write operations will create real issues, comments, or modify actual Jira data.
26
+
27
+ **Safe (no permission needed):** GET requests - listing projects, issues, comments, searching
28
+
29
+ **Requires explicit permission:** Creating/updating issues, adding comments, transitioning issues, modifying fields
30
+
31
+ ---
32
+
33
+ ## Tool
34
+
35
+ Use `SendUiPathRequest` to execute all Jira API calls.
36
+
37
+ **API usage:**
38
+ elementInstanceId can be founded in 'Connection Details' section.
39
+ Top is high priority id, use others only if unable to use top one.
40
+
41
+ ```
42
+ elements_/v3/element/instances/{{elementInstanceId}}/http-request
43
+ ```
44
+
45
+ ---
46
+
47
+ **No connection id or all fails**
48
+ Note: use only as a last resort:
49
+ ```
50
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
51
+ ```
52
+
53
+ ## How It Works
54
+
55
+ Integration Service acts as an **authenticated proxy** to Jira's REST API. It:
56
+ 1. Handles OAuth authentication automatically
57
+ 2. Forwards your request to Jira's API **in Jira's native format**
58
+ 3. Returns Jira's response directly
59
+
60
+ ## ⚠️ CRITICAL: Issue Links Shown to Users
61
+
62
+ **NEVER present `api.atlassian.com/ex/jira/...` links to users.** These are internal API URLs returned in response bodies (e.g. `issue.self`). They are not human-browsable.
63
+
64
+ **ALWAYS construct browse links using the instance's `baseUrl`:**
65
+ ```
66
+ {baseUrl}/browse/{issueKey}
67
+ ```
68
+
69
+ **Example:**
70
+ - ❌ `https://api.atlassian.com/ex/jira/2e10c12a-.../rest/api/2/issue/3024715` (internal API URL — never show this)
71
+ - ✅ `https://uipath.atlassian.net/browse/PILOT-3763` (human-friendly browse URL — always use this)
72
+
73
+ To get the `baseUrl` for the connected instance, call `GET /serverInfo` — the `baseUrl` field contains the correct hostname (e.g. `https://uipath.atlassian.net`).
74
+
75
+ ---
76
+
77
+ ## ⚠️ CRITICAL: URL Path Rules
78
+
79
+ **TOP PRIORITY - Always follow this rule:**
80
+
81
+ **When using UiPath connector via `http-request`:**
82
+ - ✅ OMIT `/rest/api/3` prefix
83
+ - Use paths like: `/project`, `/issue/{key}`, `/search/jql`
84
+ - Integration Service automatically adds the API prefix
85
+
86
+
87
+ ### Examples
88
+
89
+ **✅ CORRECT (UiPath connector):**
90
+ ```json
91
+ {
92
+ "url": "/project",
93
+ "url": "/issue/PROJ-123",
94
+ "url": "/search/jql"
95
+ }
96
+ ```
97
+
98
+ **❌ WRONG (UiPath connector):**
99
+ ```json
100
+ {
101
+ "url": "/rest/api/3/project", // DON'T include prefix
102
+ "url": "/rest/api/3/issue/PROJ-123", // Will cause 200 OK with 401 error
103
+ "url": "/rest/api/3/search/jql" // Integration Service adds this
104
+ }
105
+ ```
106
+
107
+ **Use Jira's REST API format** for:
108
+ - Endpoints: `/project`, `/issue/{issueIdOrKey}`, `/search/jql`
109
+ - Query parameters: `?jql=project=PROJ&maxResults=50`
110
+ - Request body: Jira's JSON schema
111
+
112
+ ⚠️ **Important:** The legacy `/search` endpoint is deprecated (replaced by `/search/jql` after August 1, 2025). Always use `/search/jql` for JQL queries.
113
+
114
+ 📖 **References:**
115
+ - [Jira Cloud REST API v3 Docs](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
116
+ - [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search) - For JQL syntax and troubleshooting
117
+ - For Integration Service details, see the **UiPath Integrations** skill
118
+
119
+ ---
120
+
121
+ ## Quick Reference
122
+
123
+ | Task | Endpoint | Type |
124
+ |------|----------|------|
125
+ | List projects | `/project` | GET |
126
+ | Get project | `/project/{projectIdOrKey}` | GET |
127
+ | Search issues (JQL) | `/search/jql` | GET/POST |
128
+ | Get issue | `/issue/{issueIdOrKey}` | GET |
129
+ | Create issue | `/issue` | POST ⚠️ |
130
+ | Update issue | `/issue/{issueIdOrKey}` | PUT ⚠️ |
131
+ | Delete issue | `/issue/{issueIdOrKey}` | DELETE ⚠️ |
132
+ | Get issue comments | `/issue/{issueIdOrKey}/comment` | GET |
133
+ | Add comment | `/issue/{issueIdOrKey}/comment` | POST ⚠️ |
134
+ | Get transitions | `/issue/{issueIdOrKey}/transitions` | GET |
135
+ | Transition issue | `/issue/{issueIdOrKey}/transitions` | POST ⚠️ |
136
+ | Assign issue | `/issue/{issueIdOrKey}/assignee` | PUT ⚠️ |
137
+ | Get myself | `/myself` | GET |
138
+ | Search users | `/user/search` | GET |
139
+ | Get issue types | `/issuetype` | GET |
140
+ | Get priorities | `/priority` | GET |
141
+ | Get statuses | `/status` | GET |
142
+ | Get fields | `/field` | GET |
143
+ | Get boards (Agile) | `/board` | GET |
144
+ | Get sprints | `/board/{boardId}/sprint` | GET |
145
+ | Get issue create metadata | `/issue/createmeta` | GET |
146
+
147
+ ---
148
+
149
+ ## Executing API Calls
150
+
151
+ Use `SendUiPathRequest` with the following structure:
152
+
153
+ ```typescript
154
+ SendUiPathRequest({
155
+ method: "POST",
156
+ path: "elements_/v3/element/instances/{{elementInstanceId}}/http-request",
157
+ body: {
158
+ method: "GET", // Jira HTTP method
159
+ url: "/project", // Jira endpoint
160
+ query: { ... }, // Query params (optional)
161
+ body: "..." // Request body as string (optional)
162
+ }
163
+ })
164
+ ```
165
+
166
+ **Request Body Fields:**
167
+ - `method`: HTTP method for Jira (GET, POST, PUT, DELETE)
168
+ - `url`: Jira API endpoint (e.g., `/project`, `/issue/PROJ-123`, `/search/jql`)
169
+ - `query`: Query parameters as key-value pairs (all values must be strings)
170
+ - `body`: Request body as JSON (for POST/PUT)
171
+
172
+ **Important Notes:**
173
+ - Query parameter values MUST be strings: `{"maxResults": "50"}` not `{"maxResults": 50}`
174
+
175
+ ---
176
+
177
+ ## Common Request Patterns
178
+
179
+ ### Read Operations (Safe)
180
+ ```json
181
+ {
182
+ "method": "GET",
183
+ "url": "/search/jql",
184
+ "query": {
185
+ "jql": "project = PROJ AND status = 'In Progress'",
186
+ "maxResults": "50",
187
+ "fields": "summary,status,assignee"
188
+ }
189
+ }
190
+ ```
191
+
192
+ **Note:** Empty JQL queries cause 400 errors. Always specify valid JQL.
193
+
194
+ ### Create Issue ⚠️
195
+ ```json
196
+ {
197
+ "method": "POST",
198
+ "url": "/issue",
199
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Title\", \"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [{\"type\": \"paragraph\", \"content\": [{\"type\": \"text\", \"text\": \"Description\"}]}]}, \"issuetype\": {\"name\": \"Bug\"}}}"
200
+ }
201
+ ```
202
+
203
+ ### Update Issue ⚠️
204
+ ```json
205
+ {
206
+ "method": "PUT",
207
+ "url": "/issue/{issueKey}",
208
+ "body": "{\"fields\": {\"summary\": \"New title\"}}"
209
+ }
210
+ ```
211
+
212
+ ### Add Comment ⚠️
213
+ ```json
214
+ {
215
+ "method": "POST",
216
+ "url": "/issue/{issueKey}/comment",
217
+ "body": "{\"body\": {\"type\": \"doc\", \"version\": 1, \"content\": [{\"type\": \"paragraph\", \"content\": [{\"type\": \"text\", \"text\": \"Comment text\"}]}]}}"
218
+ }
219
+ ```
220
+
221
+ **For detailed examples, see the `recipes/` folder.**
222
+
223
+ ---
224
+
225
+ ## JQL Quick Reference
226
+
227
+ | Query | Description |
228
+ |-------|-------------|
229
+ | `project = PROJ` | Issues in project |
230
+ | `assignee = currentUser()` | Assigned to me |
231
+ | `status = "In Progress"` | Specific status (quote multi-word values) |
232
+ | `status in (Open, Done)` | Multiple statuses |
233
+ | `priority = High` | Priority filter |
234
+ | `created >= -7d` | Last 7 days |
235
+ | `sprint in openSprints()` | Open sprints |
236
+ | `type = Bug` | Issue type |
237
+ | `text ~ "keyword"` | Full-text search |
238
+ | `ORDER BY created DESC` | Sorting |
239
+
240
+ **Combine:** `project = PROJ AND status = "In Progress" AND assignee = currentUser()`
241
+
242
+ **📖 [JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)** - For syntax and troubleshooting
243
+
244
+
245
+ ## Query Parameters
246
+
247
+ | Parameter | Description |
248
+ |-----------|-------------|
249
+ | `jql` | JQL query (required, non-empty). Example: `"project=PROJ"` |
250
+ | `maxResults` | Max results (default 50). Example: `"100"` |
251
+ | `nextPageToken` | Pagination for `/search/jql` (from previous response) |
252
+ | `startAt` | Pagination for legacy endpoints. Example: `"0"` |
253
+ | `fields` | Comma-separated fields. Example: `"summary,status,assignee"` |
254
+ | `expand` | Additional data. Example: `"changelog"` |
255
+
256
+ ---
257
+
258
+ ## Atlassian Document Format (ADF)
259
+
260
+ Jira Cloud uses ADF for rich text fields (description, comments):
261
+
262
+ ```json
263
+ {
264
+ "type": "doc",
265
+ "version": 1,
266
+ "content": [
267
+ {
268
+ "type": "paragraph",
269
+ "content": [
270
+ {"type": "text", "text": "Plain text here"}
271
+ ]
272
+ }
273
+ ]
274
+ }
275
+ ```
276
+
277
+ ## ⚠️ CRITICAL: Description and Comments Are Plain Strings (API v2)
278
+
279
+ The UiPath IS connector uses **Jira API v2**, where `description` and comment `body` are **plain strings**, NOT Atlassian Document Format (ADF) objects.
280
+
281
+ **❌ WRONG — ADF object** (causes `"Operation value must be a string"` 400 error):
282
+ ```json
283
+ {
284
+ "body": "{\"fields\": {\"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}}"
285
+ }
286
+ ```
287
+
288
+ **✅ CORRECT — Plain string with newlines for formatting:**
289
+ ```json
290
+ {
291
+ "body": "{\"fields\": {\"description\": \"First paragraph.\\n\\n- Bullet one\\n- Bullet two\\n- Bullet three\"}}"
292
+ }
293
+ ```
294
+
295
+ **Formatting in plain text (API v2 wiki markup):**
296
+ - Newline: `\n`
297
+ - Blank line / paragraph break: `\n\n`
298
+ - Bullet list item: `- item` (preceded by `\n`)
299
+ - Bold: `*text*`
300
+ - Code: `{{text}}`
301
+ - Heading: `h1. Title`, `h2. Subtitle`
302
+
303
+ **Note:** ADF (Atlassian Document Format) is only used with the **direct Jira REST API v3** — not via the UiPath IS connector.
304
+
305
+ **For formatting examples, see recipes.**
306
+
307
+ ---
308
+
309
+ ## Error Handling & Retry Strategy
310
+
311
+ | Status | Meaning | Retry? | Action |
312
+ |--------|---------|--------|--------|
313
+ | 200/201 | Success | N/A | Process response |
314
+ | 400 | Bad Request | No | Check JQL syntax ([JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)) or body format |
315
+ | 401 | Unauthorized | No | Connection needs re-auth - inform user |
316
+ | 403 | Forbidden | No | User lacks permissions - inform user |
317
+ | 404 | Not Found | No | Verify project/issue key exists |
318
+ | 429 | Rate Limited | Yes (3x) | Wait `Retry-After` header seconds (default 60s), retry |
319
+ | 5xx | Server Error | Yes (3x) | Exponential backoff: 1s, 2s, 4s |
320
+
321
+ ### ⚠️ CRITICAL: 200 OK with 401 Error
322
+
323
+ `http-request` may return **200 OK** with **401 in response body** - this means **wrong URL path** (included `/rest/api/3` when using UiPath connector). Fix: Remove `/rest/api/3` prefix and retry.
324
+
325
+ ---
326
+
327
+ ## Rate Limits
328
+
329
+ Jira Cloud API has rate limits:
330
+ - Varies by plan and usage
331
+ - Check `X-RateLimit-Remaining` header in responses
332
+ - Typically allows thousands of requests per minute
333
+ - **Best Practice:** Check headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
334
+
335
+ ---
336
+
337
+ ## Common Mistakes
338
+
339
+ | Mistake | Fix |
340
+ |---------|-----|
341
+ | **⚠️ Including `/rest/api/3` in URL** | **OMIT for UiPath connector** (causes 200 OK with 401 error) |
342
+ | Integer query params | Use strings: `"maxResults": "50"` not `50` |
343
+ | Missing JQL quotes | Use `'In Progress'` not `In Progress` ([JQL Cheat Sheet](https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#advanced-search)) |
344
+ | Empty JQL | Always provide valid JQL (causes 400 error) |
345
+ | Plain text description | Use ADF format with `type`, `version`, `content` |
346
+ | Body as object | Stringify JSON: `"body": "{...}"` not `"body": {...}` |
347
+ | **⚠️ ADF object as description** | **The IS connector uses API v2 — description and comment body are plain strings, NOT ADF objects.** Use `"description": "plain text with \\n for newlines"`. ADF objects cause `"Operation value must be a string"` (400). |
348
+ | Using `/search` | Use `/search/jql` (legacy endpoint deprecated) |
349
+
350
+ ---
351
+
352
+ ## Performance Best Practices
353
+
354
+ **Use field filtering:** `"fields": "key,summary,status"` reduces response size by 70%
355
+
356
+ **Batch operations:** Use `/search/jql` with `key in (PROJ-1, PROJ-2)` instead of multiple `/issue/{key}` calls
357
+
358
+ **Parallel requests:** Same connection supports concurrent operations
359
+
360
+ ---
361
+
362
+ ## 📁 Recipes
363
+
364
+ For step-by-step guides to common Jira tasks, see the **`recipes/`** folder:
365
+
366
+ ### Core Operations
367
+
368
+ | Recipe | Description | Safety |
369
+ |--------|-------------|--------|
370
+ | `search-issues.md` | Search issues with JQL | ✅ Safe (read-only) |
371
+ | `get-issue-details.md` | Get full issue details | ✅ Safe (read-only) |
372
+ | `my-issues.md` | List issues assigned to current user | ✅ Safe (read-only) |
373
+ | `list-projects.md` | List available projects | ✅ Safe (read-only) |
374
+
375
+ ### Write Operations
376
+
377
+ | Recipe | Description | Safety |
378
+ |--------|-------------|--------|
379
+ | `create-issue.md` | Create a new issue | ⚠️ **Requires user confirmation** |
380
+ | `add-comment.md` | Add comment to an issue | ⚠️ **Requires user confirmation** |
381
+ | `transition-issue.md` | Change issue status | ⚠️ **Requires user confirmation** |
382
+ | `assign-issue.md` | Assign issue to a user | ⚠️ **Requires user confirmation** |
383
+
384
+ ### Troubleshooting
385
+
386
+ | Recipe | Description |
387
+ |--------|-------------|
388
+ | `troubleshooting.md` | Debug common Jira API issues, error patterns, and recovery strategies |
389
+
390
+ Each recipe includes:
391
+ - **When to use** - Trigger phrases and scenarios
392
+ - **Step-by-step workflow** - Exact API calls with validation
393
+ - **Example output** - How to present results to users
394
+ - **Error handling** - Common errors and solutions
395
+ - **Key learnings** - Gotchas, tips, and best practices
396
+
397
+ ⚠️ = Write operation (requires explicit user permission before execution)
@@ -0,0 +1,123 @@
1
+ # Recipe: Add Comment to Issue
2
+
3
+ ## When to Use
4
+ User asks: "Comment on PROJ-123", "Add a note to the ticket", "Reply to the issue", "Post an update"
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 Jira Connection
12
+ ```
13
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
14
+ ```
15
+
16
+ Extract from response:
17
+ - `connectionId` = `response.id`
18
+ - `elementInstanceId` = `response.elementInstanceId`
19
+
20
+ ### Step 2: Add Comment
21
+ ```
22
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
23
+ ```
24
+
25
+ **Body Format:** Use plain text or markdown (API v2):
26
+ ```json
27
+ {
28
+ "authentication": "connector",
29
+ "targetConnector": "uipath-atlassian-jira",
30
+ "connection": "{connectionId}",
31
+ "method": "POST",
32
+ "url": "/issue/{issueKey}/comment",
33
+ "headers": {},
34
+ "query": {},
35
+ "body": "{\"body\": \"Your comment text here\"}"
36
+ }
37
+ ```
38
+
39
+ Parse response (status code 201 = Created successfully):
40
+ - `comment` = `response.body`
41
+ - `comment.id` - Comment ID
42
+ - `comment.author.displayName` - Author name
43
+ - `comment.body` - Comment body
44
+ - `comment.created` - ISO timestamp
45
+ - `comment.updated` - ISO timestamp
46
+ - `comment.self` - API URL to comment
47
+
48
+ ## Example Output
49
+
50
+ ✅ **Comment added!**
51
+
52
+ | Field | Value |
53
+ |-------|-------|
54
+ | **Issue** | PROJ-123 |
55
+ | **Comment ID** | 10042 |
56
+ | **Author** | John Doe |
57
+ | **Time** | Jan 27, 2026 at 4:15 PM |
58
+
59
+ ## Variations
60
+
61
+ ### Comment with Markdown Formatting
62
+ The UiPath connector (API v2) supports basic markdown in plain text:
63
+ ```json
64
+ {
65
+ "body": "{\"body\": \"*Status update:*\\n- Fixed the timeout issue\\n- Added error logging\\n\\nSee {code}config.js{code} for details.\"}"
66
+ }
67
+ ```
68
+
69
+ ### Comment with Mention
70
+ To mention a user, use the `[~accountId:xxx]` format:
71
+ ```json
72
+ {
73
+ "body": "{\"body\": \"[~accountId:5b10ac8d82e05b22cc7d4ef5] please review this.\"}"
74
+ }
75
+ ```
76
+
77
+ ### Internal Comment (Restrict Visibility)
78
+ ```json
79
+ {
80
+ "body": "{\"body\": \"Internal note - not visible to customers\", \"visibility\": {\"type\": \"role\", \"value\": \"Administrators\"}}"
81
+ }
82
+ ```
83
+
84
+ ### Rich Text with ADF (API v3 - Direct API Only)
85
+ The UiPath IS connector uses **Jira API v2** — comment `body` is a **plain string**, not ADF.
86
+
87
+ ✅ **CORRECT — Plain string with wiki markup:**
88
+ ```json
89
+ {
90
+ "body": "{\"body\": \"*Status update:*\\n- Fixed the timeout issue\\n- Added error logging\\n\\nSee {{config.js}} for details.\"}"
91
+ }
92
+ ```
93
+
94
+ ❌ **WRONG — ADF object** (causes `"body: Operation value must be a string"` 400 error):
95
+ ```json
96
+ {
97
+ "body": "{\"body\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}"
98
+ }
99
+ ```
100
+
101
+ ADF is only supported when calling the **direct Jira REST API v3** — not via the UiPath IS connector.
102
+
103
+ ## Get Existing Comments
104
+
105
+ To read comments before adding:
106
+ ```json
107
+ {
108
+ "method": "GET",
109
+ "url": "/issue/{issueKey}/comment",
110
+ "query": {"orderBy": "-created", "maxResults": "10"}
111
+ }
112
+ ```
113
+
114
+ ## Key Learnings
115
+
116
+ 1. **Plain text works** - UiPath connector uses API v2; simple `{"body": "text"}` is sufficient
117
+ 2. **No ADF required** - Unlike API v3, the connector doesn't require Atlassian Document Format
118
+ 3. **Markdown supported** - Basic markdown like `*bold*`, `-` lists, `{code}` blocks work
119
+ 4. **201 = success** - Response code 201 (Created) indicates success
120
+ 5. **Mentions format** - Use `[~accountId:xxx]` syntax for mentions in plain text
121
+ 6. **Comments are public** - Unless you specify visibility restrictions
122
+ 7. **Edit vs new** - To edit, use PUT to `/issue/{key}/comment/{commentId}`
123
+ 8. **Always ask permission** - This posts a real comment; get user confirmation first
@@ -0,0 +1,157 @@
1
+ # Recipe: Assign Issue
2
+
3
+ ## When to Use
4
+ User asks: "Assign PROJ-123 to John", "Take ownership of the ticket", "Assign to me", "Reassign the issue"
5
+
6
+ ## ⚠️ Safety Warning
7
+ This is a **write operation** that changes the issue assignee. Always confirm with the user before executing.
8
+
9
+ ## Workflow
10
+
11
+ ### Step 1: Get Jira Connection
12
+ ```
13
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
14
+ ```
15
+
16
+ Extract from response:
17
+ - `connectionId` = `response.id`
18
+ - `elementInstanceId` = `response.elementInstanceId`
19
+
20
+ ### Step 2: (If needed) Find User Account ID
21
+
22
+ If assigning to someone other than yourself, search for the user:
23
+
24
+ ```
25
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
26
+ ```
27
+
28
+ ```json
29
+ {
30
+ "authentication": "connector",
31
+ "targetConnector": "uipath-atlassian-jira",
32
+ "connection": "{connectionId}",
33
+ "method": "GET",
34
+ "url": "/user/search",
35
+ "headers": {},
36
+ "query": {"query": "john"},
37
+ "body": ""
38
+ }
39
+ ```
40
+
41
+ Parse response:
42
+ - `users` = `response.body` (array of user objects)
43
+
44
+ **Each user contains:**
45
+ - `accountId` - "5b10ac8d82e05b22cc7d4ef5" (required for assignment)
46
+ - `displayName` - "John Doe"
47
+ - `emailAddress` - "john.doe@example.com" (may be hidden)
48
+ - `active` - true/false
49
+
50
+ ### Step 3: Assign the Issue
51
+ ```
52
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
53
+ ```
54
+
55
+ ```json
56
+ {
57
+ "authentication": "connector",
58
+ "targetConnector": "uipath-atlassian-jira",
59
+ "connection": "{connectionId}",
60
+ "method": "PUT",
61
+ "url": "/issue/{issueKey}/assignee",
62
+ "headers": {},
63
+ "query": {},
64
+ "body": "{\"accountId\": \"5b10ac8d82e05b22cc7d4ef5\"}"
65
+ }
66
+ ```
67
+
68
+ Parse response:
69
+ - Status code 204 = Success (No Content)
70
+ - Issue has been assigned
71
+
72
+ ## Example Output
73
+
74
+ ✅ **Issue assigned!**
75
+
76
+ | Field | Value |
77
+ |-------|-------|
78
+ | **Issue** | PROJ-123 |
79
+ | **Assignee** | John Doe |
80
+
81
+ ## Variations
82
+
83
+ ### Assign to Current User
84
+ First get current user's accountId:
85
+
86
+ ```json
87
+ {
88
+ "method": "GET",
89
+ "url": "/myself",
90
+ "query": {}
91
+ }
92
+ ```
93
+
94
+ Then use that accountId to assign:
95
+ ```json
96
+ {
97
+ "method": "PUT",
98
+ "url": "/issue/{issueKey}/assignee",
99
+ "body": "{\"accountId\": \"{myAccountId}\"}"
100
+ }
101
+ ```
102
+
103
+ ### Unassign (Remove Assignee)
104
+ ```json
105
+ {
106
+ "method": "PUT",
107
+ "url": "/issue/{issueKey}/assignee",
108
+ "body": "{\"accountId\": null}"
109
+ }
110
+ ```
111
+
112
+ ### Assign via Issue Update
113
+ Alternative method using issue update:
114
+ ```json
115
+ {
116
+ "method": "PUT",
117
+ "url": "/issue/{issueKey}",
118
+ "body": "{\"fields\": {\"assignee\": {\"accountId\": \"5b10ac8d82e05b22cc7d4ef5\"}}}"
119
+ }
120
+ ```
121
+
122
+ ### Assign with Default Assignee
123
+ Some projects have automatic assignment rules. To trigger:
124
+ ```json
125
+ {
126
+ "method": "PUT",
127
+ "url": "/issue/{issueKey}/assignee",
128
+ "body": "{\"accountId\": \"-1\"}"
129
+ }
130
+ ```
131
+ This sets to project default or component lead.
132
+
133
+ ## Finding Assignable Users
134
+
135
+ Get users who can be assigned to an issue in a specific project:
136
+
137
+ ```json
138
+ {
139
+ "method": "GET",
140
+ "url": "/user/assignable/search",
141
+ "query": {
142
+ "project": "PROJ",
143
+ "query": "john"
144
+ }
145
+ }
146
+ ```
147
+
148
+ ## Key Learnings
149
+
150
+ 1. **accountId required** - Cannot assign by email or display name
151
+ 2. **Get accountId first** - Use `/user/search` or `/myself` to get accountId
152
+ 3. **204 = success** - Response code 204 (No Content) indicates success
153
+ 4. **null = unassign** - Set accountId to null to remove assignee
154
+ 5. **-1 = default** - Set accountId to "-1" to use project/component default
155
+ 6. **Permission required** - User must have permission to assign issues
156
+ 7. **Always confirm** - This changes real issue assignment; get user permission first
157
+