@uipath/delegate-sdk 1.203.1 → 1.203.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +729 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +444 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +224 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,204 @@
1
+ ---
2
+ name: media-tools
3
+ friendly_name: Media Tools
4
+ version: 1.0.0
5
+ description: "Edits local audio/video with ffmpeg/ffprobe (from the Delegate bundle, else PATH): trims/cuts clips, converts format or codec, compresses to a target file size, extracts audio, extracts frames, builds thumbnails or a contact sheet, makes GIFs, merges/concatenates clips, changes speed, resizes/scales, and burns in subtitles. Use when a task mentions cut, clip, trim, shorten, convert, compress, shrink, reduce size, rip audio, grab a frame or screenshot from a video, gif, stitch, join, concat, slow-mo, timelapse, rescale, or hardcode/burn captions on a media file. Input is a local file/resource path or a URL (download it first). Not for transcription (use transcribe-media) or recorded-task conversion."
6
+ icon: FaFilm
7
+ color: F97316
8
+ ---
9
+
10
+ # Media Tools
11
+
12
+ Edits one media file with ffmpeg/ffprobe. Input: a local file/resource path, or a URL — download it first (seeking needs a local file). Not for transcription (use `transcribe-media`) or recorded-task conversion.
13
+
14
+ ## Resolve the binaries
15
+
16
+ First action, before any recipe: read `references/resolve-binaries.md`, run its snippets, set `$FFMPEG`/`$FFPROBE`, and confirm `"$FFMPEG" -version` exits 0. Order, first hit wins: Delegate bundle → PATH → existing install → install (last, needs user consent).
17
+
18
+ ## Run a recipe
19
+
20
+ Every recipe block below is tagged `usage`: an **argument template**, not a runnable command line. Never paste a recipe verbatim into a shell. Determine the OS first (win32 vs macOS) and run only that platform's invocation (below): take everything after `ffmpeg`/`ffprobe` in the recipe and feed it through the matching method. A bash recipe run in PowerShell (or vice-versa) hangs or errors.
21
+
22
+ Shared rules (both platforms):
23
+ - Prepend the resolved binary + `-nostdin` (recipes elide both): `"$FFMPEG" -nostdin <args>`. `-nostdin` goes before `-i` — without it ffmpeg inherits parent stdin and hangs to timeout. `ffprobe` skips `-nostdin`.
24
+ - Recipes show `libsvtav1` (bundled + most modern builds); with a full PATH ffmpeg prefer `-c:v libx264 -crf 20 -preset medium` (wider playback). Missing encoder (`Unknown encoder`) → check `ffmpeg -hide_banner -encoders`, pick an available one (codec rules below).
25
+ - Timeout: generous (max 600s). Re-encode of a source ≥ 60s → delegate to a subagent (Long re-encodes below), never one blocking call.
26
+ - Verify before reporting done: `ffprobe` reads the output, size > 0 (trims/concat: duration ≈ expected). Report output path + size.
27
+
28
+ ### macOS invocation (`ExecuteBashCommand`)
29
+
30
+ Run recipe args nearly verbatim: `"$FFMPEG" -nostdin <args>` / `"$FFPROBE" <args>`. Some subagents omit the bash tool — then use `ExecuteOsaScript` (JXA): set `Application.currentApplication().includeStandardAdditions = true`, then `return Application.currentApplication().doShellScript("<pipeline>");` (single-quote the inner pipeline).
31
+
32
+ ### Windows invocation (`ExecutePowershellCommand`)
33
+
34
+ Do NOT run bash recipe lines here. Never `& $FFMPEG` — bare-`&` native calls hang to timeout (exit -1). Wrap every recipe through this `Invoke-FF` helper (clean exit code, captured stderr, spaces handled):
35
+
36
+ ```powershell
37
+ function Invoke-FF {
38
+ param([string]$Exe, [string[]]$FfArgs)
39
+ $q = $FfArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"','\"') + '"' } else { $_ } }
40
+ $psi = New-Object System.Diagnostics.ProcessStartInfo
41
+ $psi.FileName = $Exe; $psi.Arguments = ($q -join ' ')
42
+ $psi.RedirectStandardOutput = $true; $psi.RedirectStandardError = $true; $psi.UseShellExecute = $false
43
+ $p = [System.Diagnostics.Process]::Start($psi)
44
+ # Drain BOTH streams concurrently. Sequential ReadToEnd() deadlocks: ffmpeg floods stderr with
45
+ # progress lines, fills the ~4KB pipe buffer, and blocks while the parent waits on stdout EOF.
46
+ $outTask = $p.StandardOutput.ReadToEndAsync()
47
+ $errTask = $p.StandardError.ReadToEndAsync()
48
+ $p.WaitForExit()
49
+ $out = $outTask.Result; $err = $errTask.Result
50
+ if ($p.ExitCode -ne 0) { throw "ffmpeg exit $($p.ExitCode): $err" }
51
+ $out.Trim()
52
+ }
53
+ ```
54
+
55
+ Pass a recipe's args (everything after `ffmpeg`/`ffprobe`) as array elements, unquoted — the helper quotes paths. `.ArgumentList` is unavailable in PowerShell 5.1; the `.Arguments` string + manual quoting is required.
56
+ ```powershell
57
+ Invoke-FF $FFMPEG @("-nostdin","-i",$in,"-ss","00:01:30","-to","00:02:15","-c:v","libsvtav1","-crf","23","-preset","6","-c:a","aac",$out)
58
+ ```
59
+
60
+ ## Long re-encodes — delegate to a subagent
61
+
62
+ Trigger: any re-encode (anything not pure `-c copy`) of a source ≥ 60s (ffprobe) — compress, format/codec convert, gif, filtered concat, speed change, resize, subtitle burn-in. These outlast the 600s shell cap and give no feedback. Stream-copy ops (`-c copy` trim/convert/merge) stay fast: one blocking `Invoke-FF` call in the main loop, no subagent.
63
+
64
+ Don't encode in the main loop. Spawn an `Agent` (`agent_type: "general"`, `automation_mode: none`, `description: "Encode <op>"`) that owns the whole launch → poll → verify cycle and returns one line. Keeps polling off the main turn loop for every long re-encode — unconditional, no permission ask, no mode question.
65
+
66
+ Parent's job:
67
+ 1. Get duration (ffprobe, below). Write a start line to the user: op + rough ETA (e.g. `Compressing ~10 min clip → ~100 MB…`). The subagent's per-poll percent streams to the user live from there.
68
+ 2. Delegate via `Agent` (`agent_type: "general"`). The general agent inherits the parent's tools — including `Wait` (poll delays) and the shell tool (`ExecuteBashCommand` macOS / `ExecutePowershellCommand` Windows) — so no tool list is passed. Put in `prompt`, verbatim: the resolved `$FFMPEG`/`$FFPROBE` paths (so the subagent skips re-resolving); this skill's absolute `<skill-path>`; absolute input/output paths; the exact recipe args (everything after `ffmpeg`); the source duration in seconds; and the instruction to read and follow `<skill-path>/references/encode-runbook.md` (mint tmp → launch → poll → report → verify). The launch script mints its own unique scratch dir per job; concurrent jobs must target distinct output paths.
69
+ 3. On return, relay the subagent's final line to the user (`Done → <path> (<size>)` or the ffmpeg error). Never just stop.
70
+
71
+ ## Rules
72
+
73
+ - Quote every path. Never overwrite the source — write a new output; `-y` overwrites the output only.
74
+ - `in.mp4`/`out.mp4` in recipes are placeholders — substitute the actual input path and an output container that fits the user's request and the chosen codec. Don't default to `.mp4`: H.264/AV1 → `.mp4`/`.mkv`, VP9/Opus → `.webm`, audio-only → `.m4a`/`.mp3`. Input can be any container ffmpeg reads (`.mov`, `.mkv`, `.webm`, `.avi`, …).
75
+ - Prefer `-c copy` (stream-copy, no quality loss): container convert, keyframe-aligned trim, same-codec merge, stream extract. Cuts land on the nearest keyframe. If `-c copy` errors, re-encode.
76
+ - Re-encode only to change codec, apply a filter (`scale`/`subtitles`/`setpts`/gif), or cut frame-accurately.
77
+ - Pick the codec for the target. `libx264` (H.264, `-crf 20 -preset medium`, crf 0–51) is the most compatible default when the resolved ffmpeg has it (typical PATH builds). `libsvtav1` (AV1, `-crf 30 -preset 6`, crf 0–63) trades player support for smaller files. `-crf` lower = better/bigger. Audio: `aac`, `libmp3lame`, `libopus`.
78
+ - Bundled ffmpeg is the GPL-free build — no `libx264`/`libx265`. There use `libsvtav1`/`libaom-av1` (AV1), `libopenh264` (H.264, `-b:v` bitrate, no `-crf`), `libkvazaar` (H.265), or `libvpx-vp9` (VP9). AV1 in `.mp4` needs a modern player.
79
+ - Even dimensions required — use `-2` in scale filters.
80
+
81
+ ## Duration (for size math)
82
+
83
+ ```usage
84
+ ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 "in.mp4"
85
+ ```
86
+
87
+ ## Trim / cut
88
+
89
+ ```usage
90
+ ffmpeg -ss 00:01:30 -to 00:02:15 -i "in.mp4" -c copy "out.mp4" # keyframe-aligned
91
+ ffmpeg -i "in.mp4" -ss 00:01:30 -to 00:02:15 -c:v libsvtav1 -crf 23 -preset 6 -c:a aac "out.mp4" # frame-accurate
92
+ ```
93
+ `-to` = absolute end time; use `-t <duration>` instead when the user gives start + length.
94
+
95
+ ## Convert / remux
96
+
97
+ ```usage
98
+ ffmpeg -i "in.mov" -c copy "out.mp4" # copy-through if codecs fit the container
99
+ ffmpeg -i "in.mkv" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac -b:a 192k "out.mp4" # re-encode if not
100
+ ```
101
+
102
+ ## Compress to target size
103
+
104
+ 1. Get duration (above). If no target size was given, ask the user for one.
105
+ 2. `video_kbps = target_MB * 8192 / dur − audio_kbps` (audio ≈ 128). Leave ~2% container overhead. If `video_kbps` lands very low for the resolution (e.g. < ~500 at 1080p → heavy artifacts), downscale or drop fps first rather than starving bitrate.
106
+ 3. Single-pass VBR at that bitrate, one launch:
107
+ ```usage
108
+ ffmpeg -nostdin -y -i "in.mp4" -c:v libsvtav1 -b:v {video_kbps}k -preset 6 -c:a aac -b:a 128k "out.mp4"
109
+ ```
110
+ With a full PATH ffmpeg use `-c:v libx264 -b:v {video_kbps}k -preset medium` instead (wider playback support).
111
+ 4. Check output size. Over target → drop bitrate or resolution and repeat. Single-pass VBR misses the target more than fixed-quality, so expect an adjust pass.
112
+ 5. If exact size isn't required, single-pass CRF is simplest: `-crf 30` (libsvtav1) / `-crf 23 -preset medium` (libx264). Quality-targeted, no size guarantee.
113
+ 6. ≥ 60s source → run via the subagent runbook (one launch), not a blocking call.
114
+
115
+ ## Extract audio
116
+
117
+ ```usage
118
+ ffmpeg -i "in.mp4" -vn -c:a copy "out.m4a" # copy if the container accepts the codec
119
+ ffmpeg -i "in.mp4" -vn -q:a 2 "out.mp3" # re-encode
120
+ ```
121
+
122
+ ## Extract frames
123
+
124
+ ```usage
125
+ ffmpeg -ss 00:00:42 -i "in.mp4" -frames:v 1 -q:v 2 "frame.png" # at timestamp
126
+ ffmpeg -i "in.mp4" -vf "fps=1/5" -q:v 2 "frame_%04d.png" # every 5s
127
+ ffmpeg -i "in.mp4" -vf "select='gt(scene,0.3)'" -vsync vfr -q:v 2 "scene_%04d.png" # on scene change
128
+ ```
129
+ Omit the filter and it dumps every frame — avoid.
130
+
131
+ ## Thumbnails / contact sheet
132
+
133
+ ```usage
134
+ ffmpeg -i "in.mp4" -vf "thumbnail" -frames:v 1 "thumb.png"
135
+ ffmpeg -i "in.mp4" -vf "fps=1/10,scale=320:-1,tile=4x4" -frames:v 1 "sheet.png" # 4x4 grid
136
+ ```
137
+ Contact sheets are for choosing between frames, not reading them. Read each chosen frame on its own at full size; crop at source resolution for small text.
138
+
139
+ ## GIF
140
+
141
+ ```usage
142
+ ffmpeg -ss 5 -t 4 -i "in.mp4" -vf "fps=12,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" -loop 0 "out.gif"
143
+ ```
144
+
145
+ ## Merge / concatenate
146
+
147
+ Same codec/resolution — concat demuxer, `list.txt` of `file 'a.mp4'` lines:
148
+ ```usage
149
+ ffmpeg -f concat -safe 0 -i "list.txt" -c copy "out.mp4"
150
+ ```
151
+ Mixed codecs/sizes — concat filter. Raw `[0:v][0:a][1:v]…concat` fails on differing dimensions/SAR/pixel-format; normalize each input first:
152
+ ```usage
153
+ ffmpeg -i "a.mp4" -i "b.mp4" -filter_complex "[0:v]scale=1280:-2,setsar=1[v0];[1:v]scale=1280:-2,setsar=1[v1];[0:a]aresample=async=1[a0];[1:a]aresample=async=1[a1];[v0][a0][v1][a1]concat=n=2:v=1:a=1[v][a]" -map "[v]" -map "[a]" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4"
154
+ ```
155
+ If any input has no audio, probe first (below) and drop the `[N:a]`/`aN` streams + set `a=0` — else the missing `[N:a]` errors.
156
+
157
+ ## Change speed
158
+
159
+ setpts factor = 1/speed. `atempo` valid 0.5–2.0 (chain for more: `atempo=2.0,atempo=2.0` = 4x).
160
+ ```usage
161
+ ffmpeg -i "in.mp4" -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4" # 2x, with audio
162
+ ffmpeg -i "in.mp4" -vf "setpts=0.5*PTS" -an -c:v libsvtav1 -crf 30 -preset 6 "out.mp4" # 2x, no audio
163
+ ```
164
+ No-audio input: the `[0:a]` variant errors — probe streams first (below) and use the `-an` form.
165
+
166
+ ## Resize / scale
167
+
168
+ ```usage
169
+ ffmpeg -i "in.mp4" -vf "scale=1280:-2" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # to width, keep aspect
170
+ ffmpeg -i "in.mp4" -vf "scale='trunc(min(1920,iw)/2)*2':-2" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # downscale only if larger (trunc keeps width even)
171
+ ```
172
+
173
+ ## Burn in subtitles
174
+
175
+ The `subtitles`/`ass` filters need a real `.srt`/`.ass` file. If captions aren't supplied, `transcribe-media` produces Markdown chunks (`[mm:ss] text` lines, start-only timestamps) — not subtitle files. Convert first: write a `.srt` where each cue runs from its `[mm:ss]` to the next line's timestamp (last cue +~3s), with sequential numbering and `HH:MM:SS,mmm` times. Then burn in:
176
+ ```usage
177
+ ffmpeg -i "in.mp4" -vf "subtitles=subs.srt" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4"
178
+ ffmpeg -i "in.mp4" -vf "ass=subs.ass" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # styled
179
+ ```
180
+ Windows: the `subtitles` filter reparses its arg, so colons/backslashes break. `cd` into the subtitle's folder and pass the bare filename, or escape: `subtitles='C\:/path/subs.srt'`.
181
+
182
+ ## Troubleshooting
183
+
184
+ Match your symptom, apply the fix. First table applies everywhere; check the Windows table only on win32.
185
+
186
+ ### All platforms
187
+
188
+ | Symptom | Cause | Fix |
189
+ |---------|-------|-----|
190
+ | `Unknown encoder 'libx264'` | bundled (GPL-free) build has no x264/x265 | Re-encode with `libsvtav1`; `libopenh264` for H.264 |
191
+ | Hangs immediately, no progress | ffmpeg blocked on inherited stdin | Add `-nostdin` before `-i` |
192
+ | Long encode killed at 600s / no feedback | encoded in the main loop over the shell cap | Delegate via `Agent` (`agent_type: general`) (Long re-encodes) |
193
+ | `-c copy` fails | codec/container mismatch | Re-encode with `libsvtav1` |
194
+ | Output not written / permission denied | target dir not writable | Write to a user dir (macOS `$TMPDIR`, Windows `$env:TEMP`), then move |
195
+
196
+ ### Windows only
197
+
198
+ | Symptom | Cause | Fix |
199
+ |---------|-------|-----|
200
+ | Call hangs → exit -1 | bare `& $FFMPEG` under `ExecutePowershellCommand` | Invoke via `Invoke-FF` |
201
+ | Hangs only on long encodes | sequential `ReadToEnd()` deadlocks when ffmpeg fills the stderr pipe buffer | Use `Invoke-FF` — drains stdout+stderr concurrently via `ReadToEndAsync()` |
202
+ | Detached launch hangs / "fails to start" | child inherited the shell's stdout pipe, blocking the runner's read-to-EOF | Launch via `scripts/windows/ff-launch.ps1` (redirects all 3 std streams) |
203
+ | `.ps1` script won't run | PowerShell ExecutionPolicy | `Set-ExecutionPolicy Bypass -Scope Process -Force`, then re-invoke |
204
+ | Subtitle filter errors | `:`/`\` in path reparsed | `cd` to the subs folder, pass the bare filename |
@@ -0,0 +1,24 @@
1
+ # Encode runbook (subagent)
2
+
3
+ Followed by the `Agent` (`agent_type: general`) that owns one long re-encode. The parent passed you: `$FFMPEG`/`$FFPROBE`, this `<skill-path>`, absolute input/output paths, the recipe args (everything after `ffmpeg`), and the source duration in seconds. Run launch → poll → verify, reporting progress, then return one line.
4
+
5
+ Tools this runbook needs: `Wait` (poll delays) and the platform shell tool — `ExecuteBashCommand` on macOS, `ExecutePowershellCommand` on Windows. The general agent inherits these from the parent by default; `ReadFile` is auto-provided. If a launch/poll call fails because a tool isn't available, return one line reporting it — don't poll without `Wait` (no shell `sleep`).
6
+
7
+ `<skill-path>/scripts/macos/` (`.sh`) and `<skill-path>/scripts/windows/` (`.ps1`) hold the launch + poll scripts — use your platform's folder. `ff-launch` mints a fresh unique scratch dir per job (so concurrent encodes never collide on the fixed filenames `ffprog.txt`/`fferr.txt`/`ffpid.txt`) and prints it as `TMP=<dir>` on its first line. Capture that `<tmp>` — poll needs it, and each later command takes it literally. The launcher also adds `-nostdin -progress -stats_period` and redirects all three std streams under `<tmp>` (a detached child that inherits the shell's stdout/stderr pipe holds it open and hangs the call).
8
+
9
+ 1. Launch detached (`auto` = mint the scratch dir), then read the printed `TMP=<dir>` into `<tmp>`:
10
+ - macOS: `bash "<skill-path>/scripts/macos/ff-launch.sh" auto "$FFMPEG" -y -i "in.mp4" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4"`
11
+ - Windows (omit `-Tmp` to mint; build the arg array — array elements avoid the `-flag` param-collision):
12
+ ```powershell
13
+ $ffArgs = @('-y','-i','in.mp4','-c:v','libsvtav1','-crf','30','-preset','6','-c:a','aac','out.mp4')
14
+ & "<skill-path>\scripts\windows\ff-launch.ps1" -Ffmpeg $FFMPEG -FfArgs $ffArgs
15
+ ```
16
+ 2. Loop: wait → poll → report. Don't tight-loop, and don't `sleep` in the shell — pause with the `Wait` tool, choosing `duration` (ms) yourself. Size it from the last poll: remaining ≈ (100 − pct) / pct × elapsed-so-far; wait ~half of that, clamped 5–300s. First wait ~5–10s so ffmpeg writes initial progress. Then poll once (`<tmp>` = the captured dir):
17
+ - macOS: `bash "<skill-path>/scripts/macos/ff-poll.sh" "<tmp>" <duration_s>`
18
+ - Windows: `& "<skill-path>\scripts\windows\ff-poll.ps1" -Tmp "<tmp>" -DurationSeconds <duration_s>`
19
+ After each poll, explicitly write the encoding progress as your message (`Encoding… 42%`). Subagent messages stream to the user live and your last message is forwarded to the parent, so stating the percent is what surfaces progress — the poll call is silent. Repeat until done.
20
+ 3. `Starting...` = progress file still empty (first seconds) — `Wait` ~5s, re-poll. Stop when status is `end`; make your final message state completion.
21
+ 4. Done = poll status `end` (or output stops growing) AND ffprobe reads the output (size > 0; for trims/concat, duration ≈ expected). Return `Done → <path> (<size>)`.
22
+ 5. On failure (no `end`, non-empty `<tmp>/fferr.txt`) read `fferr.txt` and return the ffmpeg error. If a process lingers, kill the PID in `<tmp>/ffpid.txt`.
23
+
24
+ Windows: if PowerShell blocks the `.ps1` by ExecutionPolicy, run `Set-ExecutionPolicy Bypass -Scope Process -Force` once, then re-invoke.
@@ -0,0 +1,88 @@
1
+ # Resolve ffmpeg / ffprobe
2
+
3
+ Set `$FFMPEG` + `$FFPROBE` (Windows) or `FFMPEG` + `FFPROBE` (macOS) once, then reuse. Try strategies in order; first hit wins. `<skill-path>` = this skill's folder, from the enclosing `<skills_folder path>`.
4
+
5
+ Order: **bundle → PATH → machine → install**. Stop at the first that resolves. Install modifies the machine — last resort, needs user consent.
6
+
7
+ Verify any candidate before using it: `"$FFMPEG" -version` (exit 0). A bundle or PATH hit counts only with ffprobe beside it or found separately; otherwise try the next strategy. Derive ffprobe next to ffmpeg if not separately found.
8
+
9
+ ## 1. Bundle (Delegate interop)
10
+
11
+ Delegate ships an ffmpeg build with its interop layer near this skill, or uses Robot's, named by `$env:UIPATH_FFMPEG_DIR`. On Windows try that folder, then the installed path `<skill-path>\..\..\interop\ffmpeg.exe`: a restricted shell may run them but not list folders. Otherwise search recursively three levels above the skill folder, which stays inside the Delegate install.
12
+
13
+ ```powershell
14
+ $S = "<skill-path>"
15
+ $FFMPEG = @($env:UIPATH_FFMPEG_DIR, (Join-Path $S "..\..\interop")) | Where-Object { $_ } |
16
+ ForEach-Object { Join-Path $_ "ffmpeg.exe" } | Where-Object { Test-Path -LiteralPath $_ -PathType Leaf } |
17
+ Select-Object -First 1
18
+ if (-not $FFMPEG) {
19
+ $FFMPEG = Get-ChildItem -Path (Join-Path $S "..\..\..") -Recurse -File -Filter ffmpeg.exe -ErrorAction SilentlyContinue |
20
+ Select-Object -First 1 -ExpandProperty FullName
21
+ }
22
+ ```
23
+ ```bash
24
+ S="<skill-path>"
25
+ FFMPEG="$(find "$S/../../.." -type f -name ffmpeg -perm -u+x 2>/dev/null | head -n1)"
26
+ ```
27
+
28
+ ## 2. PATH
29
+
30
+ ffmpeg on PATH: the bundle, which Delegate shells put first, or a user install.
31
+
32
+ ```powershell
33
+ $FFMPEG = (Get-Command ffmpeg.exe -ErrorAction SilentlyContinue).Source
34
+ $FFPROBE = (Get-Command ffprobe.exe -ErrorAction SilentlyContinue).Source
35
+ ```
36
+ ```bash
37
+ FFMPEG="$(command -v ffmpeg)"
38
+ FFPROBE="$(command -v ffprobe)"
39
+ ```
40
+
41
+ ## 3. Resolve on machine
42
+
43
+ ffmpeg installed but not on PATH (common with winget/scoop/manual unzip). Search common install roots.
44
+
45
+ ```powershell
46
+ $roots = @(
47
+ "$env:LOCALAPPDATA\Microsoft\WinGet\Packages", # winget
48
+ "$env:USERPROFILE\scoop\apps\ffmpeg", # scoop
49
+ "C:\ProgramData\chocolatey\lib\ffmpeg", # choco
50
+ "C:\ffmpeg", $env:ProgramFiles, ${env:ProgramFiles(x86)}
51
+ ) | Where-Object { $_ -and (Test-Path $_) }
52
+ $FFMPEG = $roots | ForEach-Object {
53
+ Get-ChildItem -Path $_ -Recurse -File -Filter ffmpeg.exe -ErrorAction SilentlyContinue
54
+ } | Select-Object -First 1 -ExpandProperty FullName
55
+ ```
56
+ ```bash
57
+ for c in /opt/homebrew/bin/ffmpeg /usr/local/bin/ffmpeg /usr/bin/ffmpeg; do
58
+ [ -x "$c" ] && FFMPEG="$c" && break
59
+ done
60
+ ```
61
+
62
+ ## 4. Install (last resort, needs consent)
63
+
64
+ Adds ffmpeg to the machine. Confirm with the user first. Needs network; may need admin; slow — set a long timeout or run detached. After install, re-run strategy 1 or 3 (the current shell session may not see the new PATH).
65
+
66
+ ```powershell
67
+ winget install --id Gyan.FFmpeg -e --accept-source-agreements --accept-package-agreements # or: choco install ffmpeg -y / scoop install ffmpeg
68
+ ```
69
+ ```bash
70
+ brew install ffmpeg # macOS
71
+ ```
72
+
73
+ ## Finalize
74
+
75
+ After a hit, normalize and derive ffprobe:
76
+
77
+ ```powershell
78
+ if (-not $FFMPEG) { throw "ffmpeg not resolved (bundle/PATH/machine/install all failed)" }
79
+ $FFMPEG = (Resolve-Path $FFMPEG).Path
80
+ if (-not $FFPROBE) { $FFPROBE = $FFMPEG -replace 'ffmpeg\.exe$', 'ffprobe.exe' }
81
+ ```
82
+ ```bash
83
+ [ -n "$FFMPEG" ] || { echo "ffmpeg not resolved (bundle/PATH/machine/install all failed)" >&2; exit 1; }
84
+ FFMPEG="$(cd "$(dirname "$FFMPEG")" && pwd)/$(basename "$FFMPEG")"
85
+ [ -n "$FFPROBE" ] || FFPROBE="$(dirname "$FFMPEG")/ffprobe"
86
+ ```
87
+
88
+ No working ffmpeg + ffprobe (all strategies failed, or install declined) → tell the user in one plain line that ffmpeg isn't available. Don't retry shell calls.
@@ -0,0 +1,22 @@
1
+ #!/usr/bin/env bash
2
+ # Launch one ffmpeg encode detached with progress tracking (macOS/Linux).
3
+ # Usage: bash ff-launch.sh <tmpdir|auto> <ffmpeg> <ffmpeg-args...>
4
+ # arg1 = auto (or empty) -> mint a fresh unique scratch dir (new job).
5
+ # an existing dir -> use that caller-provided scratch dir.
6
+ # Prints "TMP=<dir>" first (capture it: poll needs it), then "launched pid N".
7
+ # Minting is atomic (mktemp -d), so concurrent encodes never collide on the fixed
8
+ # filenames ffprog.txt/fferr.txt/ffpid.txt. Poll with ff-poll.sh.
9
+ # All three std streams are redirected so the detached child holds no pipe open;
10
+ # an inherited pipe hangs the launching shell to its timeout. Stdin EOF (</dev/null)
11
+ # lets ffmpeg exit after the last frame instead of lingering.
12
+ set -u
13
+ tmp="$1"; ff="$2"; shift 2
14
+ if [ -z "$tmp" ] || [ "$tmp" = "auto" ]; then
15
+ tmp="$(mktemp -d "${TMPDIR:-/tmp}/media-XXXXXX")"
16
+ else
17
+ mkdir -p "$tmp"
18
+ fi
19
+ "$ff" -nostdin -progress "$tmp/ffprog.txt" -stats_period 5 "$@" </dev/null >/dev/null 2>"$tmp/fferr.txt" &
20
+ echo $! > "$tmp/ffpid.txt"
21
+ echo "TMP=$tmp"
22
+ echo "launched pid $(cat "$tmp/ffpid.txt")"
@@ -0,0 +1,10 @@
1
+ #!/usr/bin/env bash
2
+ # Print encode progress as "NN% (status)" or "Starting..." (macOS/Linux).
3
+ # Usage: bash ff-poll.sh <tmpdir> <duration_seconds>
4
+ # Done when status is "end" (or the output file stops growing).
5
+ set -u
6
+ tmp="$1"; dur="$2"; prog="$tmp/ffprog.txt"
7
+ [ -f "$prog" ] || { echo "Starting..."; exit 0; }
8
+ # out_time_us on modern builds; fall back to out_time_ms (also microseconds on
9
+ # older builds despite the name) so progress isn't stuck at "Starting...".
10
+ awk -F= -v DUR="$dur" '/out_time_us=/{us=$2} /out_time_ms=/{ms=$2} /^progress/{st=$2} END{t=(us!=""&&us!="N/A")?us:ms; if(t!=""&&t!="N/A"&&DUR>0){printf "%.0f%% (%s)\n", t/1e6/DUR*100, st}else{print "Starting..."}}' "$prog"
@@ -0,0 +1,34 @@
1
+ # Launch one ffmpeg encode detached with progress tracking (Windows).
2
+ # Usage: & ff-launch.ps1 [-Tmp <dir>] -Ffmpeg <path> -FfArgs <string[]>
3
+ # -Tmp omitted -> mint a fresh unique scratch dir (new job).
4
+ # -Tmp <dir> -> use that caller-provided scratch dir.
5
+ # Prints "TMP=<dir>" first (capture it: poll needs it), then "launched pid N".
6
+ # A unique dir per job keeps concurrent encodes from colliding on the fixed
7
+ # filenames ffprog.txt/fferr.txt/ffpid.txt. Poll with ff-poll.ps1.
8
+ # Redirects all three std streams to files: a detached child that inherits the
9
+ # launching shell's stdout/stderr pipe holds it open and hangs the call to its timeout.
10
+ param([string]$Tmp, [string]$Ffmpeg, [string[]]$FfArgs)
11
+ if (-not $Ffmpeg -or -not $FfArgs) {
12
+ throw "usage: ff-launch.ps1 [-Tmp <dir>] -Ffmpeg <path> -FfArgs <string[]>"
13
+ }
14
+ if (-not $Tmp) {
15
+ $Tmp = Join-Path $env:TEMP ("media-" + [guid]::NewGuid().ToString('N').Substring(0, 8))
16
+ }
17
+ New-Item -ItemType Directory -Force $Tmp | Out-Null
18
+ $full = @('-nostdin', '-progress', "$Tmp\ffprog.txt", '-stats_period', '5') + $FfArgs
19
+ # .ArgumentList is unavailable in PowerShell 5.1; quote spaces/quotes manually.
20
+ $q = $full | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }
21
+ New-Item -ItemType File "$Tmp\ffin.txt" -Force | Out-Null
22
+ $sp = @{
23
+ FilePath = $Ffmpeg
24
+ ArgumentList = ($q -join ' ')
25
+ NoNewWindow = $true
26
+ PassThru = $true
27
+ RedirectStandardInput = "$Tmp\ffin.txt"
28
+ RedirectStandardOutput = "$Tmp\ffout.txt"
29
+ RedirectStandardError = "$Tmp\fferr.txt"
30
+ }
31
+ $p = Start-Process @sp
32
+ $p.Id | Set-Content "$Tmp\ffpid.txt"
33
+ "TMP=$Tmp"
34
+ "launched pid $($p.Id)"
@@ -0,0 +1,20 @@
1
+ # Print encode progress as "NN% (status)" or "Starting..." (Windows).
2
+ # Usage: & ff-poll.ps1 -Tmp <dir> -DurationSeconds <n>
3
+ # Done when status is "end" (or the output file stops growing).
4
+ param([string]$Tmp, [double]$DurationSeconds)
5
+ if (-not $Tmp -or $DurationSeconds -le 0) {
6
+ throw "usage: ff-poll.ps1 -Tmp <dir> -DurationSeconds <n>"
7
+ }
8
+ $prog = "$Tmp\ffprog.txt"
9
+ if (-not (Test-Path $prog)) { 'Starting...'; return }
10
+ $t = Get-Content $prog -Tail 20
11
+ # out_time_us on modern builds; fall back to out_time_ms (also microseconds on
12
+ # older builds despite the name) so progress isn't stuck at "Starting...".
13
+ $m = ($t | Select-String 'out_time_us=(\d+)' | Select-Object -Last 1)
14
+ if (-not $m) { $m = ($t | Select-String 'out_time_ms=(\d+)' | Select-Object -Last 1) }
15
+ # File exists but no out_time line yet (empty / partially written): not started.
16
+ if (-not $m) { 'Starting...'; return }
17
+ $us = [double]$m.Matches.Groups[1].Value
18
+ $sm = ($t | Select-String 'progress=(\w+)' | Select-Object -Last 1)
19
+ $st = if ($sm) { $sm.Matches.Groups[1].Value } else { 'continue' }
20
+ if ($us -and $DurationSeconds -gt 0) { '{0:N0}% ({1})' -f (100 * $us / 1e6 / $DurationSeconds), $st } else { 'Starting...' }
@@ -0,0 +1,161 @@
1
+ ---
2
+ name: office-download
3
+ friendly_name: Office Download
4
+ version: 1.0.0
5
+ description: "Download Office documents (Excel, PowerPoint, Word) from URLs. Use instead of shell commands or DownloadFile."
6
+ icon: FaFileDownload
7
+ color: D83B01
8
+ ---
9
+
10
+ # Office Download
11
+
12
+ Download and open Office documents via **ExecuteSkillApi** endpoint on the local interop service.
13
+
14
+ **Platform:** Windows only. Requires Microsoft Office installed.
15
+
16
+ ---
17
+
18
+ ## Quick Reference
19
+
20
+ | Task | Endpoint | Method | Platform |
21
+ |------|----------|--------|----------|
22
+ | Download Office document | `/office/download` | POST | Windows only |
23
+
24
+ ---
25
+
26
+ ## Endpoint
27
+
28
+ ### Download Office Document — `/office/download`
29
+
30
+ Downloads an Office document from a URL, saves it locally, and optionally opens it in the corresponding Office application.
31
+
32
+ **Parameters:**
33
+
34
+ | Parameter | Type | Default | Description |
35
+ |-----------|------|---------|-------------|
36
+ | `url` | string | **required** | URL of the Office document (Google Drive, Dropbox, or direct link) |
37
+ | `localPath` | string | user's Downloads folder | Directory where the file should be saved |
38
+ | `filename` | string | extracted from URL | Custom filename (must include correct extension) |
39
+ | `openAfterDownload` | boolean | true | Whether to open the document after download |
40
+ | `fileType` | string | `"auto"` | File type hint: `auto`, `excel`, `powerpoint`, `word` |
41
+ | `visible` | boolean | false | Show the opened document to the user. Leave false when downloading in order to read a document; set true only when the user asked to see it. Honoured for PowerPoint and Excel, which open without a window by default. Word still opens visibly on this path regardless |
42
+
43
+ **Supported file types:**
44
+ - Excel: `.xlsx`, `.xls`
45
+ - PowerPoint: `.pptx`, `.ppt`
46
+ - Word: `.docx`, `.doc`
47
+
48
+ **Supported URL sources:**
49
+ - Google Drive links (`drive.google.com/file/d/...`)
50
+ - Dropbox links (`dropbox.com/...` — auto-converted to download format)
51
+ - Direct download links (`https://example.com/file.xlsx`)
52
+
53
+ **NOT supported by `/office/download`:**
54
+ - OneDrive/SharePoint sharing links — `/office/download` is plain HTTP and cannot authenticate, so SharePoint returns the HTML auth page instead of the file.
55
+
56
+ For SharePoint/OneDrive URLs, use `ms-{powerpoint|word|excel}:ofe|u|<original_url>` with the desktop app instead — desktop Office is signed into the user's Microsoft account and resolves sharing tokens through Microsoft's sharing service. See the SharePoint section in the relevant Office architect skill (`powerpoint-architect`, `word-architect`, `excel-architect`).
57
+
58
+ **Response fields:**
59
+
60
+ | Field | Type | Description |
61
+ |-------|------|-------------|
62
+ | `success` | boolean | Whether download succeeded |
63
+ | `error` | string | Error message if failed |
64
+ | `downloadedPath` | string | Local path where file was saved |
65
+ | `fileSize` | number | File size in bytes |
66
+ | `mimeType` | string | Detected MIME type |
67
+ | `fileType` | string | Detected type: `excel`, `powerpoint`, `word` |
68
+ | `isOpen` | boolean | Whether document was opened |
69
+ | `workbookId` | string | Excel: workbook ID |
70
+ | `sheets` | string[] | Excel: list of sheet names |
71
+ | `totalSlides` | number | PowerPoint: slide count |
72
+ | `documentId` | string | Word: document ID |
73
+ | `pageCount` | number | Word: page count |
74
+ | `wordCount` | number | Word: word count |
75
+ | `characterCount` | number | Word: character count |
76
+
77
+ ---
78
+
79
+ ## Examples
80
+
81
+ Download an Excel file to read it — opens without a window:
82
+ ```json
83
+ {
84
+ "endpoint": "/office/download",
85
+ "body": {
86
+ "url": "https://example.com/report.xlsx",
87
+ "openAfterDownload": true
88
+ },
89
+ "toolName": "Download Excel",
90
+ "description": "Downloading Excel workbook from URL"
91
+ }
92
+ ```
93
+
94
+ Download an Excel file the user asked to *see* — add `visible`, or it opens hidden:
95
+ ```json
96
+ {
97
+ "endpoint": "/office/download",
98
+ "body": {
99
+ "url": "https://example.com/report.xlsx",
100
+ "openAfterDownload": true,
101
+ "visible": true
102
+ },
103
+ "toolName": "Download Excel",
104
+ "description": "Downloading Excel workbook and showing it to the user"
105
+ }
106
+ ```
107
+
108
+ Download a PowerPoint to a specific folder:
109
+ ```json
110
+ {
111
+ "endpoint": "/office/download",
112
+ "body": {
113
+ "url": "https://drive.google.com/file/d/abc123/view",
114
+ "localPath": "C:\\Users\\user\\Documents",
115
+ "fileType": "powerpoint",
116
+ "openAfterDownload": true
117
+ },
118
+ "toolName": "Download Presentation",
119
+ "description": "Downloading PowerPoint from Google Drive"
120
+ }
121
+ ```
122
+
123
+ Download a Word document without opening:
124
+ ```json
125
+ {
126
+ "endpoint": "/office/download",
127
+ "body": {
128
+ "url": "https://www.dropbox.com/s/xyz/contract.docx?dl=0",
129
+ "openAfterDownload": false
130
+ },
131
+ "toolName": "Download Document",
132
+ "description": "Downloading Word document from Dropbox"
133
+ }
134
+ ```
135
+
136
+ Download with custom filename:
137
+ ```json
138
+ {
139
+ "endpoint": "/office/download",
140
+ "body": {
141
+ "url": "https://example.com/download?id=123",
142
+ "filename": "Q4_Report.xlsx",
143
+ "fileType": "excel"
144
+ },
145
+ "toolName": "Download Report",
146
+ "description": "Downloading and renaming Excel report"
147
+ }
148
+ ```
149
+
150
+ ---
151
+
152
+ ## Workflow
153
+
154
+ ### Download and Edit Office Document
155
+ ```
156
+ 1. /office/download → download and open the file
157
+ 2. Use returned workbookId/documentId with Excel/Word/PowerPoint tools
158
+ 3. For Excel: use ExcelReadRange, ExcelWriteRange, etc.
159
+ 4. For PowerPoint: use PptInsertSlide, PptAddText, etc.
160
+ 5. For Word: use WordSelect, WordAppendText, etc.
161
+ ```