@uipath/delegate-sdk 1.203.0 → 1.203.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -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 +215 -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 +81 -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,274 @@
1
+ # Recipe: Create Issue
2
+
3
+ ## When to Use
4
+ User asks: "Create a ticket for...", "Log a bug in Jira", "Open an issue", "Create a story for..."
5
+
6
+ ## ⚠️ CRITICAL SAFETY WARNING
7
+
8
+ This is a **write operation** that creates a **real issue in Jira**.
9
+
10
+ ### Safety Protocol
11
+
12
+ 1. **ALWAYS** ask for explicit user confirmation before executing
13
+ 2. **SHOW** the user exactly what will be created (project, summary, type, description)
14
+ 3. **VERIFY** project key exists and user has permission
15
+ 4. **VALIDATE** required fields before execution
16
+ 5. **DO NOT** create issues in production projects without permission
17
+
18
+ ### Confirmation Template
19
+
20
+ Before creating an issue, present this to the user:
21
+
22
+ ```
23
+ I will create the following Jira issue:
24
+
25
+ Project: [PROJECT_KEY]
26
+ Type: [Bug/Story/Task/Epic]
27
+ Summary: [Issue title]
28
+ Description: [Brief description]
29
+ Priority: [if set]
30
+ Assignee: [if set]
31
+
32
+ Do you want me to proceed?
33
+ ```
34
+
35
+ **Only execute after receiving explicit "yes" or confirmation.**
36
+
37
+ ## Workflow
38
+
39
+ ### Step 1: Get Jira Connection
40
+ ```
41
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
42
+ ```
43
+
44
+ Extract from response:
45
+ - `connectionId` = `response.id`
46
+ - `elementInstanceId` = `response.elementInstanceId`
47
+
48
+ ### Step 2: (Optional) Get Issue Types for Project
49
+ ```
50
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
51
+ ```
52
+
53
+ ```json
54
+ {
55
+ "authentication": "connector",
56
+ "targetConnector": "uipath-atlassian-jira",
57
+ "connection": "{connectionId}",
58
+ "method": "GET",
59
+ "url": "/issue/createmeta",
60
+ "headers": {},
61
+ "query": {
62
+ "projectKeys": "PROJ",
63
+ "expand": "projects.issuetypes.fields"
64
+ },
65
+ "body": ""
66
+ }
67
+ ```
68
+
69
+ This tells you what issue types and fields are available.
70
+
71
+ ### Step 3: Create the Issue
72
+ ```
73
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
74
+ ```
75
+
76
+ ```json
77
+ {
78
+ "authentication": "connector",
79
+ "targetConnector": "uipath-atlassian-jira",
80
+ "connection": "{connectionId}",
81
+ "method": "POST",
82
+ "url": "/issue",
83
+ "headers": {},
84
+ "query": {},
85
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Issue title here\", \"description\": \"Issue description here.\\n\\n- Bullet point one\\n- Bullet point two\", \"issuetype\": {\"name\": \"Bug\"}}}"
86
+ }
87
+ ```
88
+
89
+ ## ⚠️ CRITICAL: Description Is a Plain String (API v2)
90
+
91
+ The UiPath IS connector uses **Jira API v2**, where `description` and comment `body` are **plain strings**, NOT ADF objects.
92
+
93
+ ❌ **WRONG** — ADF object (causes `"Operation value must be a string"` 400 error):
94
+ ```json
95
+ {
96
+ "body": "{\"fields\": {\"description\": {\"type\": \"doc\", \"version\": 1, \"content\": [...]}}}"
97
+ }
98
+ ```
99
+
100
+ ✅ **CORRECT** — Plain string with `\n` for newlines:
101
+ ```json
102
+ {
103
+ "body": "{\"fields\": {\"description\": \"First paragraph.\\n\\n- Bullet one\\n- Bullet two\"}}"
104
+ }
105
+ ```
106
+
107
+ **Plain text formatting (API v2 wiki markup):**
108
+ - Paragraph break: `\n\n`
109
+ - Bullet item: `- item` (each on its own line with `\n`)
110
+ - Bold: `*text*`
111
+ - Code: `{{text}}`
112
+ - Heading: `h1. Title`, `h2. Subtitle`
113
+
114
+ **Note:** The `body` field must be a JSON string (escaped). Required fields:
115
+ - `project.key` - Project key (e.g., "PROJ")
116
+ - `summary` - Issue title
117
+ - `issuetype.name` - Issue type (Bug, Story, Task, Epic, etc.)
118
+
119
+ Parse response (status code 201 = Created successfully):
120
+ - `issue` = `response.body`
121
+ - `issue.id` - Issue ID (e.g., "10042")
122
+ - `issue.key` - Issue key (e.g., "PROJ-123")
123
+ - `issue.self` - API URL to issue
124
+
125
+ ## Example Output
126
+
127
+ Present to user:
128
+
129
+ ✅ **Issue created successfully!**
130
+
131
+ | Field | Value |
132
+ |-------|-------|
133
+ | **Key** | PROJ-123 |
134
+ | **Summary** | Bug: Login timeout after 30 seconds |
135
+ | **Project** | My Project (PROJ) |
136
+ | **Link** | [View in Jira](https://your-domain.atlassian.net/browse/PROJ-123) |
137
+
138
+ ## Variations
139
+
140
+ ### Create Bug with Priority
141
+ ```json
142
+ {
143
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Login page crashes on mobile\", \"description\": \"Steps to reproduce:\\n\\n- Open the app on mobile\\n- Navigate to login page\\n- Tap the login button\\n\\nExpected: Login succeeds\\nActual: App crashes\", \"issuetype\": {\"name\": \"Bug\"}, \"priority\": {\"name\": \"High\"}}}"
144
+ }
145
+ ```
146
+
147
+ ### Create Story with Labels
148
+ ```json
149
+ {
150
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Add user profile page\", \"description\": \"As a user, I want to view and edit my profile so that I can keep my information up to date.\", \"issuetype\": {\"name\": \"Story\"}, \"labels\": [\"frontend\", \"user-experience\"]}}"
151
+ }
152
+ ```
153
+
154
+ ### Create Task with Assignee
155
+ ```json
156
+ {
157
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Update documentation\", \"issuetype\": {\"name\": \"Task\"}, \"assignee\": {\"accountId\": \"5b10ac8d82e05b22cc7d4ef5\"}}}"
158
+ }
159
+ ```
160
+
161
+ **Note:** Get accountId from `/user/search` or `/myself` endpoint.
162
+
163
+ ### Create with Components
164
+ ```json
165
+ {
166
+ "body": "{\"fields\": {\"project\": {\"key\": \"PROJ\"}, \"summary\": \"Backend API issue\", \"issuetype\": {\"name\": \"Bug\"}, \"components\": [{\"name\": \"Backend\"}]}}"
167
+ }
168
+ ```
169
+
170
+ ## Atlassian Document Format (ADF)
171
+
172
+ Jira Cloud requires ADF for description and comments. Simple text:
173
+ ```json
174
+ {
175
+ "type": "doc",
176
+ "version": 1,
177
+ "content": [
178
+ {
179
+ "type": "paragraph",
180
+ "content": [
181
+ {"type": "text", "text": "Your text here"}
182
+ ]
183
+ }
184
+ ]
185
+ }
186
+ ```
187
+
188
+ With bullet list:
189
+ ```json
190
+ {
191
+ "type": "doc",
192
+ "version": 1,
193
+ "content": [
194
+ {"type": "paragraph", "content": [{"type": "text", "text": "Steps to reproduce:"}]},
195
+ {
196
+ "type": "bulletList",
197
+ "content": [
198
+ {"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Step 1"}]}]},
199
+ {"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Step 2"}]}]}
200
+ ]
201
+ }
202
+ ]
203
+ }
204
+ ```
205
+
206
+ ## Pre-Creation Validation
207
+
208
+ ### Step-by-Step Validation Process
209
+
210
+ **Validation steps:**
211
+ 1. **Validate connection:** Check `connection.state === "Enabled"`, else error
212
+ 2. **Verify project exists:** Get project by key, if not found error
213
+ 3. **Get and validate issue type:**
214
+ - Fetch create metadata for project
215
+ - Extract valid issue types from `metadata.projects[0].issuetypes[]`
216
+ - Check if requested type is in list
217
+ 4. **Validate required fields:**
218
+ - Find issue type in metadata
219
+ - Extract fields where `field.required === true`
220
+ - Check all required fields are provided
221
+ 5. **Validate ADF structure:**
222
+ - Must have `type: "doc"`
223
+ - Must have `version: 1`
224
+ - Must have `content` array
225
+
226
+ ### Recommended Workflow
227
+
228
+ **Option A: Quick Create (Simple Cases)**
229
+ - When creating simple issues with known project and standard fields
230
+ - Skip metadata fetching for speed
231
+ - Handles common failures gracefully
232
+
233
+ **Option B: Safe Create (Production)**
234
+ 1. Fetch project details
235
+ 2. Get create metadata
236
+ 3. Validate all fields
237
+ 4. Confirm with user
238
+ 5. Create issue
239
+ 6. Verify creation successful
240
+
241
+ ## Error Handling
242
+
243
+ | Error Code | Cause | Solution |
244
+ |------------|-------|----------|
245
+ | `400 Bad Request` | Missing required field or invalid ADF | Fetch createmeta to see required fields |
246
+ | `400 "project is required"` | Missing project in body | Include `"project": {"key": "PROJ"}` |
247
+ | `400 "ADF validation error"` | Invalid description format | Use proper ADF structure (see examples) |
248
+ | `401 Unauthorized` | Connection expired | Re-authorize in UiPath Cloud |
249
+ | `403 Forbidden` | No permission to create issues | Check user has project creation permission |
250
+ | `404 Not Found` | Project doesn't exist | Verify project key is correct |
251
+
252
+ ### Response Validation
253
+
254
+ **Verification steps:**
255
+ 1. Check `response.statusCode === 201` (Created)
256
+ 2. Extract `issueKey` from `response.body.key`
257
+ 3. Build issue URL: `https://your-domain.atlassian.net/browse/{issueKey}`
258
+ 4. Optionally verify by fetching the issue with GET `/issue/{issueKey}`
259
+ 5. If not 201, log unexpected status code
260
+
261
+ ## Key Learnings
262
+
263
+ 1. **Body must be escaped JSON string** - The outer `body` field contains a JSON string with the issue payload
264
+ 2. **⚠️ Description is a plain string (API v2)** - The IS connector uses Jira API v2. Use `"description": "text with \\n for newlines"` — NOT ADF objects. ADF causes `"Operation value must be a string"` (400).
265
+ 3. **201 = success** - Response code 201 (Created) indicates success, not 200
266
+ 4. **Get project key first** - You need to know the project key (e.g., "PROJ")
267
+ 5. **Issue types vary** - Different projects may have different issue types; use createmeta to discover
268
+ 6. **Always confirm first** - This creates a real issue; get user permission before executing
269
+ 7. **Custom fields** - Some projects have required custom fields; use createmeta to discover them
270
+ 8. **Validate before create** - Check project exists, issue type is valid, and all required fields are present
271
+ 9. **Use metadata API** - Fetch `/issue/createmeta` to discover available fields and types
272
+ 10. **Verify creation** - After creating, fetch the issue to confirm it was created correctly
273
+ 11. **Browse links** - Always present `{baseUrl}/browse/{issueKey}` links to users, never `api.atlassian.com` URLs
274
+
@@ -0,0 +1,154 @@
1
+ # Recipe: Get Issue Details
2
+
3
+ ## When to Use
4
+ User asks: "What's the status of PROJ-123?", "Show me issue details", "Get ticket info", "Tell me about this issue"
5
+
6
+ ## Workflow
7
+
8
+ ### Step 1: Get Jira Connection
9
+ ```
10
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
11
+ ```
12
+
13
+ Extract from response:
14
+ - `connectionId` = `response.id`
15
+ - `elementInstanceId` = `response.elementInstanceId`
16
+
17
+ ### Step 2: Get Issue Details
18
+ ```
19
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
20
+ ```
21
+
22
+ ```json
23
+ {
24
+ "authentication": "connector",
25
+ "targetConnector": "uipath-atlassian-jira",
26
+ "connection": "{connectionId}",
27
+ "method": "GET",
28
+ "url": "/issue/{issueKey}",
29
+ "headers": {},
30
+ "query": {
31
+ "fields": "summary,description,status,assignee,reporter,priority,created,updated,comment,labels,components,fixVersions"
32
+ },
33
+ "body": ""
34
+ }
35
+ ```
36
+
37
+ Parse response - key fields from `response.body`:
38
+
39
+ **Basic info:**
40
+ - `key` - Issue key (e.g., "PROJ-123")
41
+ - `fields.summary` - Issue title
42
+ - `fields.status.name` - Status (e.g., "In Progress")
43
+ - `fields.priority.name` - Priority (e.g., "High")
44
+ - `fields.issuetype.name` - Issue type (e.g., "Bug")
45
+
46
+ **People:**
47
+ - `fields.assignee.displayName` - Assigned user (may be null)
48
+ - `fields.assignee.accountId` - Assignee account ID
49
+ - `fields.reporter.displayName` - Person who created the issue
50
+
51
+ **Dates:**
52
+ - `fields.created` - ISO timestamp of creation
53
+ - `fields.updated` - ISO timestamp of last update
54
+
55
+ **Description:**
56
+ - `fields.description` - Atlassian Document Format object
57
+
58
+ **Labels and components:**
59
+ - `fields.labels` - Array of label strings
60
+ - `fields.components` - Array of component objects
61
+
62
+ **Comments:**
63
+ - `fields.comment.comments` - Array of comment objects
64
+ - `fields.comment.total` - Total number of comments
65
+
66
+ ## Example Output
67
+
68
+ Present to user as:
69
+
70
+ ### Issue PROJ-123: Login timeout after 30 seconds
71
+
72
+ | Field | Value |
73
+ |-------|-------|
74
+ | **Type** | Bug |
75
+ | **Status** | In Progress |
76
+ | **Priority** | High |
77
+ | **Assignee** | John Doe |
78
+ | **Reporter** | Jane Smith |
79
+ | **Created** | Jan 20, 2026 at 10:30 AM |
80
+ | **Updated** | Jan 27, 2026 at 2:15 PM |
81
+ | **Labels** | `production`, `urgent` |
82
+ | **Components** | Backend, Authentication |
83
+
84
+ **Description:**
85
+ > Users are experiencing timeout errors when attempting to log in during peak hours...
86
+
87
+ **Comments (3):**
88
+ - *John Doe (Jan 21):* Investigating the issue...
89
+ - *Jane Smith (Jan 22):* Any updates on this?
90
+ - *John Doe (Jan 27):* Found the root cause, working on a fix.
91
+
92
+ ## Variations
93
+
94
+ ### Get All Fields
95
+ ```json
96
+ {
97
+ "query": {
98
+ "fields": "*all"
99
+ }
100
+ }
101
+ ```
102
+
103
+ ### Get with Changelog
104
+ ```json
105
+ {
106
+ "query": {
107
+ "expand": "changelog"
108
+ }
109
+ }
110
+ ```
111
+
112
+ This returns the full history of changes to the issue.
113
+
114
+ ### Get Rendered Description
115
+ ```json
116
+ {
117
+ "query": {
118
+ "expand": "renderedFields"
119
+ }
120
+ }
121
+ ```
122
+
123
+ This returns HTML-rendered version of description and comments.
124
+
125
+ ### Get Specific Fields Only
126
+ ```json
127
+ {
128
+ "query": {
129
+ "fields": "summary,status,assignee"
130
+ }
131
+ }
132
+ ```
133
+
134
+ ## Parsing ADF Description
135
+
136
+ The description field uses Atlassian Document Format. To extract plain text:
137
+
138
+ **Steps:**
139
+ 1. Check if ADF exists and has `content` array
140
+ 2. Iterate through each node in `content`
141
+ 3. For `paragraph` nodes: extract text from `content[].text`
142
+ 4. For `bulletList` nodes: extract list items recursively
143
+ 5. Join all text with newlines
144
+
145
+ ## Key Learnings
146
+
147
+ 1. **Issue key format** - Always `{PROJECT}-{NUMBER}` (e.g., "PROJ-123")
148
+ 2. **Nullable fields** - `assignee`, `description`, etc. may be null
149
+ 3. **ADF for description** - Description is in Atlassian Document Format, not plain text
150
+ 4. **Comments are nested** - Access via `issue.fields.comment.comments`
151
+ 5. **Use specific fields** - Request only needed fields for faster responses
152
+ 6. **Expand for more data** - Use `expand=changelog` for history, `expand=renderedFields` for HTML
153
+ 7. **404 = not found** - Issue key doesn't exist or user lacks permission
154
+
@@ -0,0 +1,151 @@
1
+ # Recipe: List Projects
2
+
3
+ ## When to Use
4
+ User asks: "What projects do I have access to?", "List Jira projects", "Show available projects", "Which projects can I use?"
5
+
6
+ ## Workflow
7
+
8
+ ### Step 1: Get Jira Connection
9
+ ```
10
+ GET connections_/api/v1/Connectors/uipath-atlassian-jira/connection
11
+ ```
12
+
13
+ Extract from response:
14
+ - `connectionId` = `response.id`
15
+ - `elementInstanceId` = `response.elementInstanceId`
16
+
17
+ ### Step 2: List Projects
18
+ ```
19
+ POST elements_/v3/element/instances/{elementInstanceId}/http-request
20
+ ```
21
+
22
+ ```json
23
+ {
24
+ "authentication": "connector",
25
+ "targetConnector": "uipath-atlassian-jira",
26
+ "connection": "{connectionId}",
27
+ "method": "GET",
28
+ "url": "/project",
29
+ "headers": {},
30
+ "query": {},
31
+ "body": ""
32
+ }
33
+ ```
34
+
35
+ Parse response:
36
+ - `projects` = `response.body` (array of project objects)
37
+
38
+ **Each project contains:**
39
+ - `id` - Project ID (e.g., "10000")
40
+ - `key` - Project key (e.g., "PROJ")
41
+ - `name` - Project name (e.g., "My Project")
42
+ - `projectTypeKey` - Type (e.g., "software", "business")
43
+ - `simplified` - Boolean
44
+ - `style` - "classic" or "next-gen"
45
+ - `self` - API URL to project
46
+
47
+ ## Example Output
48
+
49
+ Present to user:
50
+
51
+ ### Available Jira Projects
52
+
53
+ | Key | Name | Type |
54
+ |-----|------|------|
55
+ | PROJ | My Project | Software |
56
+ | TEAM | Team Tasks | Business |
57
+ | DEV | Development | Software |
58
+ | OPS | Operations | Business |
59
+
60
+ ## Variations
61
+
62
+ ### Get Project Details
63
+ ```json
64
+ {
65
+ "method": "GET",
66
+ "url": "/project/{projectKeyOrId}",
67
+ "query": {"expand": "description,lead,issueTypes"}
68
+ }
69
+ ```
70
+
71
+ Returns:
72
+ - `id`: "10000"
73
+ - `key`: "PROJ"
74
+ - `name`: "My Project"
75
+ - `description`: "Project description"
76
+ - `lead.accountId`: "..."
77
+ - `lead.displayName`: "John Doe"
78
+ - `issueTypes[]` - Array of issue types:
79
+ - `name`: "Bug", `id`: "10001"
80
+ - `name`: "Story", `id`: "10002"
81
+ - `name`: "Task", `id`: "10003"
82
+
83
+ ### Paginated Project List
84
+ ```json
85
+ {
86
+ "method": "GET",
87
+ "url": "/project/search",
88
+ "query": {
89
+ "maxResults": "50",
90
+ "startAt": "0",
91
+ "orderBy": "name"
92
+ }
93
+ }
94
+ ```
95
+
96
+ ### Search Projects by Name
97
+ ```json
98
+ {
99
+ "method": "GET",
100
+ "url": "/project/search",
101
+ "query": {
102
+ "query": "dev",
103
+ "maxResults": "20"
104
+ }
105
+ }
106
+ ```
107
+
108
+ ### Get Project Components
109
+ ```json
110
+ {
111
+ "method": "GET",
112
+ "url": "/project/{projectKey}/components",
113
+ "query": {}
114
+ }
115
+ ```
116
+
117
+ ### Get Project Versions
118
+ ```json
119
+ {
120
+ "method": "GET",
121
+ "url": "/project/{projectKey}/versions",
122
+ "query": {}
123
+ }
124
+ ```
125
+
126
+ ### Get Project Roles
127
+ ```json
128
+ {
129
+ "method": "GET",
130
+ "url": "/project/{projectKey}/role",
131
+ "query": {}
132
+ }
133
+ ```
134
+
135
+ ## Project Types
136
+
137
+ | Type Key | Description |
138
+ |----------|-------------|
139
+ | `software` | Jira Software project |
140
+ | `service_desk` | Jira Service Management |
141
+ | `business` | Jira Work Management |
142
+
143
+ ## Key Learnings
144
+
145
+ 1. **Key vs ID** - Project key (e.g., "PROJ") is human-readable; ID is numeric
146
+ 2. **Permissions apply** - Only shows projects user has access to
147
+ 3. **Use /project/search** - For large instances with pagination
148
+ 4. **expand parameter** - Use to get additional details like lead, issueTypes
149
+ 5. **Next-gen vs Classic** - `style` field indicates project type
150
+ 6. **Components and Versions** - Separate endpoints to get these details
151
+