@uipath/delegate-sdk 1.203.1 → 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,32 @@
1
+ {
2
+ "description": "Canonical AppAct action -> UiPath activity map. Single source, read during Phase 1 classify and Phase 5 authoring; also the step-action vocabulary for automation.spec.md (Phase 3). Action names track the AppAct discriminated union in src/aria/lib/tools/arguments/ui/UiActions.ts - every literal there needs an entry here. Edit here only; do not restate the table in prose - it drifts.",
3
+ "handling": {
4
+ "include": "becomes an activity in the workflow",
5
+ "flag": "surface to the user; port only if trivial",
6
+ "exclude": "no workflow equivalent by design; drop",
7
+ "fold": "not its own step; merges into the paired action"
8
+ },
9
+ "actions": {
10
+ "open": { "handling": "include", "activity": "Use Application/Browser", "notes": "url: browser type + URL; app: identifier/path" },
11
+ "navigate_url": { "handling": "include", "activity": "Navigate Browser (Go to URL)", "notes": "within an open browser" },
12
+ "go_back": { "handling": "include", "activity": "Navigate Browser (Back)" },
13
+ "go_forward": { "handling": "include", "activity": "Navigate Browser (Forward)" },
14
+ "click": { "handling": "include", "activity": "Click", "needsSelector": true },
15
+ "hover": { "handling": "include", "activity": "Hover", "needsSelector": true },
16
+ "scroll": { "handling": "include", "activity": "Mouse Scroll", "needsSelector": true },
17
+ "text_type": { "handling": "include", "activity": "Type Into", "needsSelector": true, "notes": "selector + text; set field-clear if the run cleared first" },
18
+ "key_press": { "handling": "include", "activity": "Send Keyboard Shortcuts", "notes": "key combo" },
19
+ "select_item": { "handling": "include", "activity": "Select Item", "needsSelector": true, "notes": "selector + value" },
20
+ "paste_content": { "handling": "include", "activity": "Type Into (or Set to Clipboard + paste hotkey)", "notes": "prefer Type Into for text" },
21
+ "get_selected_text": { "handling": "include", "activity": "Get Text", "notes": "capture to a variable/output" },
22
+ "extract_web_element": { "handling": "include", "activity": "Get Text / Extract Table Data", "notes": "structured extraction" },
23
+ "type_from_credential": { "handling": "include", "activity": "Get Credential + Type Into (secure)", "needsSelector": true, "notes": "reference the Orchestrator asset, never the captured value - see the credential rule in action-activity-map.md" },
24
+ "wait": { "handling": "include", "activity": "Delay, or Check App State / wait-for-element", "notes": "prefer wait-for-element over fixed Delay" },
25
+ "drag": { "handling": "flag", "notes": "coordinate drags do not port; a range-selection drag (click start, Shift/Ctrl-click end) maps to two Click activities with a modifier - see coded-workflow-authoring.md § Targeting > Range drag. Any other drag has no proven mapping; port only if trivial" },
26
+ "execute_js": { "handling": "flag", "activity": "Invoke JS", "notes": "arbitrary script; port only if trivial" },
27
+ "print_to_pdf": { "handling": "flag" },
28
+ "handle_dialog": { "handling": "fold", "notes": "map the paired action, then a follow-up Click on the dialog button if one was pressed" },
29
+ "crop": { "handling": "exclude", "notes": "vision-only" },
30
+ "extract": { "handling": "exclude", "notes": "exploratory read" }
31
+ }
32
+ }
@@ -0,0 +1,44 @@
1
+ # Action classification and activity mapping
2
+
3
+ How to turn a Delegate session's `AppAct` actions into UiPath UIAutomation activities.
4
+
5
+ ## 1. Classify
6
+
7
+ A coded workflow is a deterministic function over its inputs. Include actions that run the same way every time; exclude anything needing judgment.
8
+
9
+ Per-action classification lives in **`action-activity-map.json`** (same directory) - the single source. Read it; each action carries `handling`: `include` (becomes an activity), `flag` (surface to the user; port only if trivial), `exclude` (no workflow equivalent), `fold` (merges into its paired action).
10
+
11
+ Beyond per-action handling, always exclude:
12
+ - Judgment or branching on page content ("is this VIP?", "pick the option that fits").
13
+ - Exploratory reads and screenshots that only informed the agent.
14
+ - `AskUser`, proven retries (`SKILL.md` Phase 1; any other repeat stays), and dead-end actions that were later undone.
15
+
16
+ **Parameterize**: values the user typed that vary per run (names, amounts, search terms) become spec `inputs`, not hardcoded literals. Ask the user which typed values are fixed vs per-run.
17
+
18
+ **Litmus**: writable as a finite function over inputs with no judgment branch → include. Needs reading something ambiguous and deciding → exclude, keep it in the live agent flow.
19
+
20
+ ## 2. Map `AppAct` action → activity
21
+
22
+ Both `AppAct` and the UiPath UIAutomation activities drive the same automation engine, so the mapping is direct. The action → activity table is `action-activity-map.json`; `references/coded-workflow-authoring.md` gives the coded (C#) call for each activity. Do not restate the table here or in generated docs - it drifts.
23
+
24
+ The same `action-activity-map.json` action names are the step-action vocabulary in `automation-spec.md`'s spec — do not invent a second naming scheme there.
25
+
26
+ ## 3. Targets
27
+
28
+ Coordinate points never port; never emit a coordinate click. Selectors come pre-captured from AppAct, read out of the session task log (`<Delegate userData>/captures/<sessionId>/task-log-<runId>.jsonl` segments, read per `SKILL.md` Phase 1; `AppGetDescriptor` re-probes without acting). Targeting rules — model factories, the shortcut/selector-candidate/semantic ladder, selector dialect — are in `coded-workflow-authoring.md` § Targeting.
29
+
30
+ - Top-level target: web → the browser URL; desktop → `<wnd app='...' />`. Inner selectors cannot find windows.
31
+ - Selector attribute priority (most to least reliable): `id` → `name` → `aaname` → `placeholder` → `type` → `class` (avoid `class`).
32
+ - If neither a selector nor a usable description resolves, flag the step and ask the user whether to drop it.
33
+
34
+ ## 4. Credentials
35
+
36
+ Never embed a captured secret in the workflow. Any `type_from_credential` (or a login the user performed) maps to **Get Credential** reading an Orchestrator asset, feeding a secure **Type Into**. The generated `.cs` references the asset name, never the value.
37
+
38
+ ## 5. Inputs and outputs
39
+
40
+ The entry-point signature is fixed to `Execute(string inputJson, bool dryRun)` — nothing here becomes a new C# parameter, and `out`/`ref` params are a compile error on a `[Workflow]` method (`CS1620`).
41
+
42
+ - Per-run typed values → `## Inputs` in `automation.spec.md`, read out of the `inputJson` payload at run time.
43
+ - `get_selected_text` / `extract_web_element` results → fields on the JSON envelope's `result`.
44
+ - Keep everything else as local state inside `Execute()`.
@@ -0,0 +1,63 @@
1
+ # App profiles
2
+
3
+ Known desktop apps' launch technique, window selector, and preferred (shortcut-first) interaction — check here before deriving a fresh selector in Phase 2. Saves rediscovering UWP launch quirks (see `coded-workflow-authoring.md` § Targeting → UWP apps) every session, and stops the skill from assuming every packaged app is exposed through `ApplicationFrameHost.exe` when it might already be a direct Win32 process.
4
+
5
+ Add a new profile here, in this file, after a session captures one — do not speculatively invent selectors for apps not yet seen live.
6
+
7
+ ## The only store there is
8
+
9
+ This file is it: hand-written, reviewed, and shipped with the skill, covering launch quirks and window shapes that are stable across machines. It is authoritative for *technique* (how to launch a UWP app, which control class holds the text) and no more than a documented shape for any selector it names — one that may not match this machine's build.
10
+
11
+ There is **no** learned or per-machine companion to it. Nothing accumulates confirmed selectors across sessions, and this skill writes no such file: a store of that kind would outlive the chat whose task log it was derived from, which is precisely the global state this design does without. A run's own evidence lives in that automation's `automation.spec.md`, in its project.
12
+
13
+ So a selector here enters the Phase 2 candidate list like any other — most specific first — and the Phase 6 smoke run is still what proves it.
14
+
15
+ ## Notepad (Windows 11, UWP-packaged)
16
+
17
+ - **Launch** (App-Path launchers fail — the System32 stub hands off and exits, so UIA's pid tracker sees a dead pid, `ApplicationOpenException`): launch via the shell URI, not `AppTarget.FromPath`.
18
+ ```csharp
19
+ System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo {
20
+ FileName = "explorer.exe",
21
+ Arguments = @"shell:AppsFolder\Microsoft.WindowsNotepad_8wekyb3d8bbwe!App",
22
+ UseShellExecute = true
23
+ });
24
+ ```
25
+ - **Window selector candidates** (most to least specific; confirm against a live `AppAct` capture, do not assume verbatim):
26
+ 1. `<wnd app='notepad.exe' appid='Microsoft.WindowsNotepad_8wekyb3d8bbwe!App' />`
27
+ 2. `<wnd app='ApplicationFrameHost.exe' cls='ApplicationFrameWindow' title='*Notepad' />` (fallback shape shared by every UWP window; disambiguate by `title`)
28
+ - **Editor control**: `RichEditD2DPT` class.
29
+ - **Preferred formatting actions**: keyboard shortcuts over the ribbon — `Ctrl+B` (bold), `Ctrl+I` (italic), `Ctrl+U` (underline), `Ctrl+A` (select all) — the ribbon buttons are a broad, less stable toolbar host; see the targeting ladder in `coded-workflow-authoring.md` § Targeting.
30
+
31
+ ## Calculator (Windows 11, UWP-packaged)
32
+
33
+ Same `ApplicationFrameHost.exe` fallback shape as Notepad, disambiguated by `title='Calculator'`. Full worked example (AppUserModelID discovery via `Get-StartApps`, `TargetAppModel.Selector` construction) in `coded-workflow-authoring.md` § Targeting → UWP apps. No editor-equivalent control or shortcut set documented yet — add one after a live capture.
34
+
35
+ ## Native macOS apps — one profile for all of them
36
+
37
+ Native (AppKit) macOS apps share one shape; derive any macOS app's profile from this section instead of adding a per-app entry below. Add an app-specific entry only for facts this shape cannot predict — control identifiers, a display element that needs a particular read method, a shortcut set. Detailed rules and the selector capture flow live in `coded-workflow-authoring.md` § Targeting → macOS apps; this is the profile-shaped summary.
38
+
39
+ - **Launch + attach**: launch with `open -a "<AppName>"` — always quote the name; an unquoted name with spaces (`open -a System Settings`) makes the shell pass `System` as the app and `Settings` as a file operand (`AppTarget.FromPath` cannot open a `.app` bundle). Then attach by window shape:
40
+ ```
41
+ <wnd app='<AppName>' role='AXWindow' title='<window title>' />
42
+ ```
43
+ Single-window apps usually title the window after the app; confirm with a live capture rather than assuming.
44
+ - **Interaction mode**: `Simulate` drives controls without foregrounding. Menu-bar items are the one exception — `Simulate` menu clicks silently no-op; bring the app to the foreground first.
45
+ - **Element selectors**: `<ax>` dialect with the `identifier` attribute (NOT the Windows `automationid`), e.g. `<ax role='AXButton' identifier='<Identifier>' />`. Generate them with the capture flow and copy verbatim — never hand-compose from an AX dump.
46
+ - **Reading values**: `GetText` — when `Native`/`TextAttribute` returns empty on an AX container whose value is visibly present, retry with the **Fulltext** method. Never leave a target on the OCR default (cloud CV dependency, fails offline).
47
+
48
+ ### Calculator (macOS)
49
+
50
+ Instance of the profile above — attach `<wnd app='Calculator' role='AXWindow' title='Calculator' />`, `Simulate` interaction. App-specifics:
51
+
52
+ - **Keypad identifiers** (in `<ax role='AXButton' identifier='…' />` form): digits `Zero`–`Nine`, `Decimal` (the display label is `Point`), `Add`, `Subtract`, `Multiply`, `Divide`, `Equals`, `Negate` (labelled "Change Sign"), `Delete`, `All Clear`, `Per cent`.
53
+ - **Result display**: `GetText` with the **Fulltext** method on the display element (identifier `StandardInputView`) — `Native`/`TextAttribute` returns empty on this AXScrollArea even though the AX value is present.
54
+
55
+ ## Template for a new profile
56
+
57
+ ```
58
+ <AppName> (<OS>, <packaging: UWP | Win32 | web>)
59
+ - Launch: <AppTarget.FromPath / FromUrl / shell URI — whichever this app needs>
60
+ - Window selector candidates: <ordered list, most specific first>
61
+ - Key controls: <stable selectors for controls reused across automations, e.g. an editor/input area>
62
+ - Preferred shortcuts: <keyboard shortcuts that beat a toolbar/ribbon click for common actions>
63
+ ```
@@ -0,0 +1,88 @@
1
+ # automation.spec.md
2
+
3
+ The reviewable description of the automation, written between Phase 1 (slice + classify the task log) and Phase 5 (author the C#). Markdown, not JSON: its job is to be **read and corrected by the user in one pass**, and then to be the single source Phase 5 writes code from.
4
+
5
+ It is prose plus tables on purpose. Nothing parses this file — the model reads it and writes the workflow — so it should say exactly what a person needs to check (is that the right window? is that value fixed or per-run? does that postcondition prove the task worked?) and nothing that only a parser would care about.
6
+
7
+ Action names come from the canonical vocabulary in `action-activity-map.json`. Use those names so the activity mapping stays unambiguous; do not invent parallel ones.
8
+
9
+ ## Shape
10
+
11
+ Save as `automation.spec.md` in the project root. A task can span more than one app — read a value in one, key it into another — so `## Applications` is a list, and every step names the app it runs on.
12
+
13
+ ```markdown
14
+ # NotepadPhraseFormatting
15
+
16
+ Requests: "type the lyric in notepad" → "now bold the last two words".
17
+
18
+ ## Applications
19
+
20
+ ### notepad — Notepad
21
+ - Selector: `<wnd app='notepad.exe' appid='Microsoft.WindowsNotepad_8wekyb3d8bbwe!App' />`
22
+ - Fallback: `<wnd app='ApplicationFrameHost.exe' cls='ApplicationFrameWindow' title='*Notepad' />`
23
+ - Launch: UWP — shell URI from the `appid` (see coded-workflow-authoring.md § Targeting → UWP apps)
24
+ - InteractionMode: `WindowMessages`
25
+ - Handle: `app`
26
+
27
+ ## Inputs
28
+
29
+ | Name | Example value | Fixed or per-run |
30
+ |---|---|---|
31
+ | `text` | `I'm the problem, it's me` | per-run |
32
+
33
+ ## Steps
34
+
35
+ | # | App | Action | Target | Value | Operands | Purpose |
36
+ |---|---|---|---|---|---|---|
37
+ | 1 | notepad | `key_press` | — (window) | `Ctrl+N` | — | new blank tab |
38
+ | 2 | notepad | `text_type` | `<wnd cls='RichEditD2DPT' />` — "the Notepad editor" | `${text}` | `clearBeforeType: true` | type the phrase |
39
+ | 3 | notepad | `key_press` | — (window) | `Ctrl+Shift+Left` ×2 | — | select the last two words |
40
+ | 4 | notepad | `key_press` | — (window) | `Ctrl+B` | — | bold the selection |
41
+
42
+ No step here is irreversible.
43
+
44
+ ## Postconditions
45
+
46
+ 1. `get_selected_text` on the editor equals `${text}` — proves the text survived formatting.
47
+
48
+ ## Open questions
49
+
50
+ _None — resolved in review._
51
+ ```
52
+
53
+ ## Sections
54
+
55
+ - **Title + the requests sliced.** Name the automation, then the requests you sliced, quoted *in the user's own words* from each `input` record's `label`, in order. Their `turnId`s are internal — the user cannot check an id, and can check their own sentence at a glance. This is the first thing to get wrong and the cheapest to check.
56
+ - **`## Applications`.** One `###` block per app, in first-touched order. Each carries a short `id` (used by steps), the most-specific selector, any fallback candidates, how it launches, the `InteractionMode`, and the C# handle name (`app` when there is one app; `appExpenses`/`appCrm` when there are several). Never share one handle across apps.
57
+ - **`## Inputs`.** Per-run values, referenced as `${name}` in step values and postconditions. These ride inside the `inputJson` payload at run time — never new C# parameters, never `entryPoints.input` items (the entry-point signature is fixed).
58
+ - **`## Steps`.** One row per included action, in execution order. `Target` carries the selector and, after an em dash, the semantic description used as the AI fallback; `—` means the action goes to the window rather than an element. `Operands` carries every one the step's `operands` held, `—` when it held none: a click type, held modifiers, `clearBeforeType`, a drag's destination, an `open`'s `openReason`. They are not detail — an operand dropped here is a step Phase 5 will emit wrongly while the row still reads as right. Mark an irreversible step explicitly (a bold **irreversible** in Purpose, or a note under the table) — that is what tells Phase 5 to write the `dryRun` gate, and omitting it silently ships an ungated destructive step.
59
+ - **`## Postconditions`.** What proves the run worked, each as a check plus expected value. Phase 5 turns each into a real assertion that throws `BusinessRuleException`; Phase 7 reports each as passed, failed, or unverified. A check that reads state produced by a `dryRun`-gated step cannot pass in the smoke run — say so here rather than letting Phase 7 discover it.
60
+ - **`## Open questions`.** Everything Phases 1–2 would have stopped to ask, so one review answers all of it. Leave the section with `_None_` once resolved; **do not start Phase 5 while a question is open.**
61
+
62
+ ## Deriving it from the task log
63
+
64
+ The confirmed slice carries most of this; the rest is judgment:
65
+
66
+ | Spec field | From the log | Judgment needed |
67
+ |---|---|---|
68
+ | Turn range | `step.turnId` groups matched to `input.label` (`labelRedacted` → identify by steps) | which consecutive turns form the task; partial turns (`SKILL.md` Phase 1) |
69
+ | Applications | the distinct `step.app` scopes (`identifier`, `url`) across the slice | how many are really in scope; naming each `id`; the handle names |
70
+ | Selector / fallbacks | the leading `<wnd …/>` / `<html …/>` node of that app's `target.uipathSelector`s, harvests applied | which is most specific; a known-stable shape from `app-profiles.md` |
71
+ | Launch / InteractionMode | the `open` step's `operands.openReason` (`launch` \| `attach` \| `restore`) | per app; UWP needs the shell-URI path, and `HardwareEvents` is the least reliable default (`reliability-guide.md`) |
72
+ | Steps: action + order | `step.action` for the turn range, in execution order (segment, then `i`) | which dead-ends to drop; repeats stay unless a proven retry (`SKILL.md` Phase 1) |
73
+ | Steps: app | `step.app` matched to an application block | which `id` |
74
+ | Steps: target | `step.target` (`uipathSelector`, `description`) with its `harvest` overlaid on `runId` + `i`; else `noSelector` / `step.targetDescription` | ladder order; whether a shortcut beats the selector |
75
+ | Steps: value | `step.value`; `valueRedacted` → an Input | which values are fixed vs `${input}` — **ask the user** |
76
+ | Steps: operands | `step.operands` | none — carry every one present through (click type, modifiers, `clearBeforeType`, a drag's destination, `openReason`); a dropped operand is a silently wrong step |
77
+ | Steps: purpose | `step.purpose` | tightening the wording |
78
+ | Irreversible | `step.irreversible` — `true` always gates, `false` clears nothing | re-derive from the action (`SKILL.md` Phase 1), since it drives the `dryRun` gate |
79
+ | Inputs | the values the user says vary, plus every `valueRedacted` step | naming; an example value from the user only where the Phase 6 run needs one; a credential from an Orchestrator asset |
80
+ | Postconditions | — | entirely judgment: what proves the run worked |
81
+
82
+ ## Workflow
83
+
84
+ 1. Phase 3 drafts the spec from the Phase 1 slice + Phase 2 targets and shows it inline as the review artifact. Markdown renders in chat, so the user reads the actual steps rather than a schema.
85
+ 2. Save it as `automation.spec.md` in the project root once agreed (Phase 0 already scaffolded the project).
86
+ 3. Phase 5 authors the C# from this file — not from the task log again. Regenerating after a selector fix means editing the spec and re-running Phase 5, so the file stays the truth about what the workflow does.
87
+
88
+ Keep it in the project next to `Main.cs`: it is the only human-readable record of *why* the workflow looks the way it does, and the starting point for the next person who has to change it.
@@ -0,0 +1,115 @@
1
+ # Before/After Hooks Template
2
+
3
+ ## IBeforeAfterRun on Individual Workflow/Test Case
4
+
5
+ **File: `TestLoginFlow.cs`**
6
+
7
+ ```csharp
8
+ using UiPath.CodedWorkflows;
9
+
10
+ namespace {{PROJECT_NAME}}
11
+ {
12
+ public class TestLoginFlow : CodedWorkflow, IBeforeAfterRun
13
+ {
14
+ public void Before(BeforeRunContext context)
15
+ {
16
+ Log($"[BEFORE] Starting {context.RelativeFilePath}");
17
+ // Open browser, navigate to login page
18
+ }
19
+
20
+ public void After(AfterRunContext context)
21
+ {
22
+ Log($"[AFTER] Finished {context.RelativeFilePath}");
23
+ // Close browser, clean up
24
+ }
25
+
26
+ [TestCase]
27
+ public void Execute()
28
+ {
29
+ // Before() has already run
30
+
31
+ // Arrange
32
+ string username = "testuser";
33
+
34
+ // Act
35
+ var result = workflows.Login(username: username, password: "pass123");
36
+
37
+ // Assert
38
+ testing.VerifyExpression(result.success, "Login should succeed");
39
+
40
+ // After() will run automatically
41
+ }
42
+ }
43
+ }
44
+ ```
45
+
46
+ ## Partial Class CodedWorkflow — Hooks for ALL Files
47
+
48
+ **File: `CodedWorkflowHooks.cs`** (Coded Source File — NOT a workflow, no entry point)
49
+
50
+ ```csharp
51
+ using UiPath.CodedWorkflows;
52
+
53
+ namespace {{PROJECT_NAME}}
54
+ {
55
+ public partial class CodedWorkflow : IBeforeAfterRun
56
+ {
57
+ public void Before(BeforeRunContext context)
58
+ {
59
+ Log($"[BEFORE] Execution started for {context.RelativeFilePath}");
60
+
61
+ // Example: Open application
62
+ // var app = uiAutomation.Open("myApp");
63
+
64
+ // Example: Log in
65
+ // Login("testuser", "password");
66
+ }
67
+
68
+ public void After(AfterRunContext context)
69
+ {
70
+ Log($"[AFTER] Execution finished for {context.RelativeFilePath}");
71
+
72
+ // Example: Close application
73
+ // uiAutomation.Close(app);
74
+
75
+ // Example: Clean up test data
76
+ // DeleteTestData();
77
+ }
78
+ }
79
+ }
80
+ ```
81
+
82
+ ## Partial Class CodedWorkflow — Shared Logic (Without Hooks)
83
+
84
+ **File: `CodedWorkflowExtensions.cs`** (Coded Source File)
85
+
86
+ ```csharp
87
+ using UiPath.CodedWorkflows;
88
+
89
+ namespace {{PROJECT_NAME}}
90
+ {
91
+ public partial class CodedWorkflow
92
+ {
93
+ // Shared helper available in all workflows and test cases
94
+ protected string GetEnvironmentUrl()
95
+ {
96
+ var env = system.GetAsset("Environment").ToString();
97
+ return env == "prod" ? "https://app.example.com" : "https://staging.example.com";
98
+ }
99
+
100
+ // Shared constant
101
+ protected const int MaxRetries = 3;
102
+ }
103
+ }
104
+ ```
105
+
106
+ ## Usage in Any Workflow
107
+
108
+ ```csharp
109
+ [Workflow]
110
+ public void Execute()
111
+ {
112
+ string url = GetEnvironmentUrl(); // available via partial class
113
+ Log($"Using environment: {url}");
114
+ }
115
+ ```
@@ -0,0 +1,186 @@
1
+ # UiPath Coded Workflow Templates
2
+
3
+ Ready-to-use templates for UiPath coded workflow files. Replace placeholders in `{{PLACEHOLDER}}` format.
4
+
5
+ > **Using statements:** These templates include only the minimal required usings. Add service-specific usings based on actual usage — see [coding-guidelines.md](../coded/coding-guidelines.md) for the full mapping.
6
+
7
+ ---
8
+
9
+ ## Coded Workflow (.cs) — Void
10
+
11
+ ```csharp
12
+ using System;
13
+ using System.Collections.Generic;
14
+ using UiPath.CodedWorkflows;
15
+ // Add service-specific usings as needed — see references/coding-guidelines.md
16
+
17
+ namespace {{PROJECT_NAME}}
18
+ {
19
+ public class {{CLASS_NAME}} : CodedWorkflow
20
+ {
21
+ [Workflow]
22
+ public void Execute()
23
+ {
24
+ {{IMPLEMENTATION}}
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+ ## Coded Workflow (.cs) — With Return Value
31
+
32
+ ```csharp
33
+ using System;
34
+ using System.Collections.Generic;
35
+ using UiPath.CodedWorkflows;
36
+ // Add service-specific usings as needed — see references/coding-guidelines.md
37
+
38
+ namespace {{PROJECT_NAME}}
39
+ {
40
+ public class {{CLASS_NAME}} : CodedWorkflow
41
+ {
42
+ [Workflow]
43
+ public {{RETURN_TYPE}} Execute({{PARAMETERS}})
44
+ {
45
+ {{IMPLEMENTATION}}
46
+ return {{RETURN_TYPE}};
47
+ }
48
+ }
49
+ }
50
+ ```
51
+
52
+ ## Coded Workflow (.cs) — With Tuple Return (Multiple Outputs)
53
+
54
+ ```csharp
55
+ using System;
56
+ using System.Collections.Generic;
57
+ using UiPath.CodedWorkflows;
58
+ // Add service-specific usings as needed — see references/coding-guidelines.md
59
+
60
+ namespace {{PROJECT_NAME}}
61
+ {
62
+ public class {{CLASS_NAME}} : CodedWorkflow
63
+ {
64
+ [Workflow]
65
+ public ({{TYPE1}} {{name1}}, {{TYPE2}} {{name2}}) Execute({{PARAMETERS}})
66
+ {
67
+ {{IMPLEMENTATION}}
68
+ return ({{name1}}: value1, {{name2}}: value2);
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ ## Coded Workflow (.cs) — With Single InOut Argument
75
+
76
+ A single input argument named `Output` with the same type as the return value becomes an InOut argument.
77
+
78
+ ```csharp
79
+ using System;
80
+ using System.Collections.Generic;
81
+ using UiPath.CodedWorkflows;
82
+ // Add service-specific usings as needed — see references/coding-guidelines.md
83
+
84
+ namespace {{PROJECT_NAME}}
85
+ {
86
+ public class {{CLASS_NAME}} : CodedWorkflow
87
+ {
88
+ [Workflow]
89
+ public {{RETURN_TYPE}} Execute({{RETURN_TYPE}} Output)
90
+ {
91
+ {{IMPLEMENTATION}}
92
+ return Output;
93
+ }
94
+ }
95
+ }
96
+ ```
97
+
98
+ ## Coded Workflow (.cs) — With Multiple InOut Arguments (Tuple Return)
99
+
100
+ When multiple arguments are both input and output, the return type must be a tuple whose names and types match the input parameters.
101
+
102
+ ```csharp
103
+ using System;
104
+ using System.Collections.Generic;
105
+ using UiPath.CodedWorkflows;
106
+ // Add service-specific usings as needed — see references/coding-guidelines.md
107
+
108
+ namespace {{PROJECT_NAME}}
109
+ {
110
+ public class {{CLASS_NAME}} : CodedWorkflow
111
+ {
112
+ [Workflow]
113
+ public ({{TYPE1}} {{name1}}, {{TYPE2}} {{name2}}) Execute({{TYPE1}} {{name1}}, {{TYPE2}} {{name2}})
114
+ {
115
+ {{IMPLEMENTATION}}
116
+ return ({{name1}}: value1, {{name2}}: value2);
117
+ }
118
+ }
119
+ }
120
+ ```
121
+
122
+ ## Coded Workflow (.cs) — Async
123
+
124
+ ```csharp
125
+ using System;
126
+ using System.Collections.Generic;
127
+ using System.Threading.Tasks;
128
+ using UiPath.CodedWorkflows;
129
+ // Add service-specific usings as needed — see references/coding-guidelines.md
130
+
131
+ namespace {{PROJECT_NAME}}
132
+ {
133
+ public class {{CLASS_NAME}} : CodedWorkflow
134
+ {
135
+ [Workflow]
136
+ public async Task Execute()
137
+ {
138
+ {{IMPLEMENTATION}}
139
+ }
140
+ }
141
+ }
142
+ ```
143
+
144
+ ## Coded Workflow (.cs) — With Default Parameters
145
+
146
+ Parameters with default values become **optional** when the workflow is invoked via `workflows.MyWorkflow()` — callers can omit them to use the defaults, or pass explicit values to override.
147
+
148
+ ```csharp
149
+ using System;
150
+ using System.Collections.Generic;
151
+ using UiPath.CodedWorkflows;
152
+ // Add service-specific usings as needed — see references/coding-guidelines.md
153
+
154
+ namespace {{PROJECT_NAME}}
155
+ {
156
+ public class {{CLASS_NAME}} : CodedWorkflow
157
+ {
158
+ [Workflow]
159
+ public void Execute({{TYPE}} {{paramName}} = {{defaultValue}})
160
+ {
161
+ {{IMPLEMENTATION}}
162
+ }
163
+ }
164
+ }
165
+ ```
166
+
167
+ **Example:**
168
+ ```csharp
169
+ [Workflow]
170
+ public void Execute(string browser = "chrome.exe", int retryCount = 3)
171
+ {
172
+ Log($"Using browser: {browser}, retries: {retryCount}");
173
+ }
174
+ ```
175
+
176
+ **Calling from another workflow:**
177
+ ```csharp
178
+ // All defaults — browser="chrome.exe", retryCount=3
179
+ workflows.LaunchApp();
180
+
181
+ // Override one, keep the other default
182
+ workflows.LaunchApp(browser: "msedge.exe");
183
+
184
+ // Override both
185
+ workflows.LaunchApp(browser: "msedge.exe", retryCount: 5);
186
+ ```
@@ -0,0 +1,22 @@
1
+ # UiPath Coded Helper/Utility Classes Templates
2
+
3
+ Ready-to-use templates for UiPath coded class files. Replace placeholders in `{{PLACEHOLDER}}` format.
4
+
5
+ ---
6
+
7
+ ## Helper/Utility Class (.cs) — No Attribute
8
+
9
+ ```csharp
10
+ using System;
11
+ using System.Collections.Generic;
12
+
13
+ namespace {{PROJECT_NAME}}
14
+ {
15
+ public class {{CLASS_NAME}}
16
+ {
17
+ {{IMPLEMENTATION}}
18
+ }
19
+ }
20
+ ```
21
+
22
+ IMPORTANT!: Helper classes do NOT inherit from `CodedWorkflow`, do NOT have `[Workflow]` or `[TestCase]` attributes. They are NOT entry points and do not appear in the fileInfoCollection attribute from `project.json`.
@@ -0,0 +1,91 @@
1
+ # project.json Snippets
2
+
3
+ Hand-editable snippets for the sections of `project.json` the agent legitimately modifies after `uip rpa init` has scaffolded the project.
4
+
5
+ > **DO NOT use these snippets to write `project.json` from scratch.** Always run `uip rpa init` first — it generates correct schema versions, metadata directories, default dependencies, and version-matched configuration. Use these snippets only to add entries to an existing scaffolded `project.json`.
6
+
7
+ > **Sections NOT shown here** (`runtimeOptions`, `designOptions.processOptions`, `schemaVersion`, `studioVersion`, `expressionLanguage`, `targetFramework`, etc.) are written by `init` and should not be hand-edited unless the user explicitly asks.
8
+
9
+ ---
10
+
11
+ ## `entryPoints` entry (Process projects only)
12
+
13
+ For each `.cs` workflow file added to a Process project, append one entry to the `entryPoints` array. Tests and Library projects do NOT use `entryPoints`.
14
+
15
+ ```json
16
+ {
17
+ "filePath": "{{FILE_NAME}}.cs",
18
+ "uniqueId": "{{UUID_V4}}",
19
+ "input": [],
20
+ "output": []
21
+ }
22
+ ```
23
+
24
+ ### Entry point with parameters
25
+
26
+ When the workflow's `Execute` method has parameters or a return value, populate `input` / `output`:
27
+
28
+ ```json
29
+ {
30
+ "filePath": "{{FILE_NAME}}.cs",
31
+ "uniqueId": "{{UUID_V4}}",
32
+ "input": [
33
+ {
34
+ "name": "{{PARAM_NAME}}",
35
+ "type": "{{DOTNET_TYPE}}",
36
+ "required": true
37
+ }
38
+ ],
39
+ "output": [
40
+ {
41
+ "name": "{{OUTPUT_NAME}}",
42
+ "type": "{{DOTNET_TYPE}}"
43
+ }
44
+ ]
45
+ }
46
+ ```
47
+
48
+ Common `type` values: `System.String`, `System.Int32`, `System.Boolean`, `System.Double`, `System.DateTime`, `System.Data.DataTable`, `System.Collections.Generic.Dictionary<System.String,System.Object>`
49
+
50
+ ---
51
+
52
+ ## `fileInfoCollection` entry (test cases)
53
+
54
+ For each `.cs` test case file (in any project type — Process, Tests, or Library), append one entry to `designOptions.fileInfoCollection`. Test cases do NOT go in `entryPoints`.
55
+
56
+ ```json
57
+ {
58
+ "editingStatus": "InProgress",
59
+ "testCaseId": "{{UUID_V4}}",
60
+ "testCaseType": "TestCase",
61
+ "fileName": "{{TestCase}}.cs",
62
+ "publishAsTestCase": true
63
+ }
64
+ ```
65
+
66
+ > **`editingStatus` lifecycle:** Set `"InProgress"` when creating a new test case. Update to `"Publishable"` only when the user explicitly asks to mark the test case as ready.
67
+
68
+ ### Data-driven test case (with variations file)
69
+
70
+ When a test case uses parameter variations, add `dataVariationFilePath` to its `fileInfoCollection` entry:
71
+
72
+ ```json
73
+ {
74
+ "editingStatus": "InProgress",
75
+ "testCaseId": "{{UUID_V4}}",
76
+ "testCaseType": "TestCase",
77
+ "fileName": "{{TestCase}}.cs",
78
+ "publishAsTestCase": true,
79
+ "dataVariationFilePath": ".variations\\{{variationName}}_Sheet1.json"
80
+ }
81
+ ```
82
+
83
+ The variations file lives at `.variations/{{variationName}}_Sheet1.json` with shape:
84
+
85
+ ```json
86
+ [
87
+ { "{{paramName}}": "value1" },
88
+ { "{{paramName}}": "value2" },
89
+ { "{{paramName}}": "value3" }
90
+ ]
91
+ ```