@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,337 @@
1
+ # Composite Endpoints — Full Schema Reference
2
+
3
+ Complete JSON schemas, field tables, and validation rules for `build-workbook` and `build-sheet`.
4
+ Load this file when constructing composite endpoint payloads.
5
+
6
+ ---
7
+
8
+ ## /excel/build-workbook — Full Schema
9
+
10
+ ```json
11
+ {
12
+ "filePath": "C:\\Users\\user\\Documents\\Report.xlsx",
13
+ "createDirectories": true,
14
+ "deleteDefaultSheet": true,
15
+ "saveAfterBuild": true,
16
+ "sheets": [
17
+ {
18
+ "sheetName": "Data",
19
+ "data": {
20
+ "range": "A1",
21
+ "rows": [
22
+ {"values": ["Name", "Q1", "Q2", "Total"]},
23
+ {"values": ["North", 1000, 1200, "=SUM(B2:C2)"]},
24
+ {"values": ["South", 800, 950, "=SUM(B3:C3)"]}
25
+ ],
26
+ "firstRowIsHeader": true
27
+ },
28
+ "formulas": {
29
+ "startRow": 2, "rowCount": 2,
30
+ "columns": [
31
+ {"column": "E", "template": "=D{row}/B{row}*100"}
32
+ ]
33
+ },
34
+ "formatting": [
35
+ {"range": "A1:E1", "bold": true, "interiorColorHtml": "#4472C4", "fontColorHtml": "#FFFFFF"},
36
+ {"range": "B2:C3", "numberFormat": "#,##0"},
37
+ {"range": "D2:D3", "numberFormat": "#,##0", "bold": true},
38
+ {"range": "E2:E3", "numberFormat": "0.0%"}
39
+ ],
40
+ "conditionalFormatting": [
41
+ {"range": "D2:D3", "ruleType": "CellValue", "operator": "GreaterThan", "value1": "0", "interiorColorHtml": "#C6EFCE"},
42
+ {"range": "D2:D3", "ruleType": "CellValue", "operator": "LessThan", "value1": "0", "interiorColorHtml": "#FFC7CE"}
43
+ ],
44
+ "freeze": {"rows": 1},
45
+ "charts": [
46
+ {
47
+ "valueRange": "B1:C3",
48
+ "xLabelRange": "A2:A3",
49
+ "chartType": "column",
50
+ "title": "Quarterly Sales",
51
+ "position": "F2"
52
+ }
53
+ ]
54
+ }
55
+ ]
56
+ }
57
+ ```
58
+
59
+ ### Request Fields
60
+
61
+ | Field | Type | Default | Purpose |
62
+ |-------|------|---------|---------|
63
+ | `filePath` | string | — | Full path for new workbook (required for creation) |
64
+ | `workbookId` | long | — | Workbook ID for existing workbook (alternative to filePath) |
65
+ | `createDirectories` | bool | true | Create parent directories if missing |
66
+ | `deleteDefaultSheet` | bool | true | Delete "Sheet1" if not in sheets list |
67
+ | `saveAfterBuild` | bool | true | Save workbook after building all sheets |
68
+ | `sheets` | array | [] | Sheet definitions (see Sheet Fields below) |
69
+
70
+ ### Response Fields
71
+
72
+ | Field | Type | Description |
73
+ |-------|------|-------------|
74
+ | `success` | bool | Overall operation success |
75
+ | `workbookId` | long | Workbook ID for subsequent operations |
76
+ | `filePath` | string | File path of the workbook |
77
+ | `sheetsBuilt` | int | Total sheets successfully built |
78
+ | `sheetResults` | array | Per-sheet results with `rowsWritten`, `formatRangesApplied`, `chartCreated`, `warnings` |
79
+ | `formulaErrors` | array | Formula errors from health check — null if healthy. Each: `{ sheetName, cell, errorType, formula }`. Note: `sheetName` is always null (not populated by the API); use `sheetResults` order or `sheetLayouts` to identify which sheet an error belongs to. |
80
+ | `saved` | bool | Whether workbook was saved |
81
+ | `warnings` | array | Non-fatal warnings — null if none |
82
+ | `sheetLayouts` | object | Row layout maps (only when errors detected) — maps sheet → {row: "label"} to help find correct rows |
83
+
84
+ **WARNING: `success: true` does NOT mean zero errors.** `build-workbook` returns success when sheets are built, even if formulas fail silently. **Always check ALL THREE error channels:**
85
+
86
+ 1. **`formulaErrors`** — formula-level issues (`#REF!`, `#NAME?`, `#DIV/0!`). Often null even when sheets fail to build.
87
+ 2. **`sheetResults[].error`** — **structural** failures per sheet (e.g., `"Could not write data table starting with A1"` from conflicting `formulas` field + `data.rows` formulas, or label-references in data rows). This is where you find the real reason a sheet didn't build. Iterate every entry, not just the first.
88
+ 3. **`warnings`** — non-fatal anomalies (chart placement, missing legend ranges, etc.).
89
+
90
+ If ANY of the three is non-empty, fix and rebuild before proceeding.
91
+
92
+ ---
93
+
94
+ ## /excel/build-sheet
95
+
96
+ Builds a single sheet on an already-open workbook. Same schema as one `sheets[]` entry, plus `workbookId` or `filePath`.
97
+
98
+ **Use when:** Adding sheets to an existing workbook, building sheets 4+ of a large workbook (after initial `build-workbook` batch), or falling back from a failed `build-workbook`.
99
+
100
+ ---
101
+
102
+ ## Sheet Fields
103
+
104
+ | Field | Type | Default | Purpose |
105
+ |-------|------|---------|---------|
106
+ | `sheetName` | string | **required** | Sheet name (created if missing) |
107
+ | `data` | object | null | Data block (see below) |
108
+ | `formulas` | object | null | Repeating formulas (see below) |
109
+ | `formatting` | array | null | Format specs (see below) |
110
+ | `conditionalFormatting` | array | null | CF rules — same schema as `/excel/conditional-formatting` |
111
+ | `charts` | array or object | null | Chart(s) (see below) |
112
+ | `freeze` | object | null | Freeze panes: `{ "rows": 1, "columns": 0 }` |
113
+ | `autoFitColumns` | bool | true | Auto-fit after writing |
114
+
115
+ ### Data Fields
116
+
117
+ | Field | Type | Default | Purpose |
118
+ |-------|------|---------|---------|
119
+ | `range` | string | "A1" | Starting cell |
120
+ | `rows` | array | [] | Array of `{ "values": [...] }` objects |
121
+ | `firstRowIsHeader` | bool | true | The first row of `rows` holds the column names, so `formulas` can target columns by header name (`formatting` takes ranges only, not header names). It lands at `range` (default `A1`, so row 1 — but `range: "A5"` puts it on row 5) and is written either way. Applies no styling; use `formatting` for bold |
122
+ | `forceText` | bool | false | Write **every** value as literal text — numbers included. Use it only for columns that must stay literal (leading zeros, phone numbers), never for numbers you will compute over: `SUM`/`COUNT`/`MAX`/`AVERAGE` skip text cells and return **0** with no error (measured). Arithmetic operators do coerce, so `=B2*2` gives 24 while `=SUM(B2:B3)` gives 0. A `=...` value inside `rows` is also stored as text and `B[Label]` is not resolved — put formulas in the sheet-level `formulas` field, keeping the target column's header and blank cells in `rows` so `{Header}` can resolve. Mixing literal and computed columns? Write them in two calls, `forceText` on only the literal one |
123
+
124
+ #### Row Label References in Formulas (RECOMMENDED — eliminates row-counting errors)
125
+
126
+ Formulas in data rows can reference other rows **by their column A label** instead of hardcoding row numbers. The server resolves labels to row numbers automatically.
127
+
128
+ ```json
129
+ "rows": [
130
+ {"values": ["Metric", "Value"]},
131
+ {"values": ["Revenue", 500000]},
132
+ {"values": ["Expenses", 320000]},
133
+ {"values": ["Net Income", "=B[Revenue]-B[Expenses]"]}
134
+ ]
135
+ ```
136
+
137
+ `B[Revenue]` → `B2`, `B[Expenses]` → `B3`. The model never counts rows.
138
+
139
+ **Syntax:** `COLUMN[Label]` — e.g., `B[Cash Flow]`, `$C$[Total Revenue]`. Case-insensitive. Labels match column A values exactly.
140
+
141
+ **Why use this:** The #1 cause of formula bugs is wrong row numbers. The model writes `=B10/B12` when it should be `=B10/B11` because it miscounted rows in the JSON array. Label references eliminate this entirely.
142
+
143
+ **Requires `forceText` off.** `forceText` stores every value verbatim, so a `B[Label]` formula lands as text and is never resolved. The write warns you when it suppresses formulas this way.
144
+
145
+ ### Formula Fields
146
+
147
+ | Field | Type | Default | Purpose |
148
+ |-------|------|---------|---------|
149
+ | `startRow` | int | 2 | First row for formulas (after header) |
150
+ | `rowCount` | int | 1 | Number of rows to fill |
151
+ | `columns` | array | [] | Array of `{ "column": "D", "template": "=SUM(B{row}:C{row})" }` |
152
+
153
+ The `column` field accepts both **column letters** (`"D"`) and **header names** (`"Total"`) — header-name resolution is automatic when `firstRowIsHeader: true`. Case-insensitive.
154
+
155
+ ### Format Fields
156
+
157
+ Each entry in the `formatting` array:
158
+
159
+ | Field | Type | Description |
160
+ |-------|------|-------------|
161
+ | `range` | string | Range to format (e.g., "A1:D1") |
162
+ | `bold` | bool | Bold text |
163
+ | `italic` | bool | Italic text |
164
+ | `numberFormat` | string | Number format string (e.g., "#,##0", "0.0%") |
165
+ | `horizontalAlignment` | string | "left", "center", "right" |
166
+ | `applyThinBorders` | bool | Apply thin borders |
167
+ | `interiorColorHtml` | string | Background color (#RRGGBB) |
168
+ | `fontColorHtml` | string | Font color (#RRGGBB) |
169
+ | `fontSize` | int | Font size in points |
170
+ | `fontName` | string | Font name (e.g., "Aptos", "Calibri") |
171
+ | `wrapText` | bool | Wrap text |
172
+
173
+ ### Chart Fields
174
+
175
+ Each entry in the `charts` array (or a single object):
176
+
177
+ | Field | Type | Default | Description |
178
+ |-------|------|---------|-------------|
179
+ | `valueRange` | string | **required** | Data range (e.g., "B1:D10"). Supports comma-separated multi-ranges (e.g., `"C2:C15,F2:F15"`) |
180
+ | `xLabelRange` | string | null | Category labels (e.g., "A2:A10") — **always include** for meaningful axis |
181
+ | `legendRange` | string | null | Series names (e.g., "B1:D1"). Without this, shows "Series 1", "Series 2" |
182
+ | `chartType` | string | "column" | Chart type (see table below) |
183
+ | `title` | string | null | Chart title |
184
+ | `position` (or `topLeftCell`) | string | auto | Top-left cell for placement |
185
+ | `width` | int | 500 | Width in pixels |
186
+ | `height` | int | 300 | Height in pixels |
187
+
188
+ ### Conditional Formatting Rule Types
189
+
190
+ | Rule Type | Parameters | Description |
191
+ |-----------|-----------|-------------|
192
+ | `CellValue` | `operator` (GreaterThan, LessThan, Between, Equal), `value1`, `value2`, `interiorColorHtml`, `fontColorHtml` | Format based on value |
193
+ | `ColorScale` | `colorScaleType` (TwoColor, ThreeColor) | Gradient coloring |
194
+ | `DataBar` | `dataBarColor` (#RRGGBB) | Bar visualization |
195
+ | `Expression` | `value1` (formula), `backgroundColor`, `fontColor`, `bold` | Formula-based formatting |
196
+
197
+ ### Chart Types
198
+
199
+ | Short Name | Excel Constant | Description |
200
+ |-----------|---------------|-------------|
201
+ | `column` | xlColumnClustered | Vertical bars (default) |
202
+ | `line` | xlLine | Line chart |
203
+ | `pie` | xlPie | Pie chart (**single-column valueRange only**) |
204
+ | `bar` | xlBarClustered | Horizontal bars |
205
+ | `area` | xlArea | Area chart |
206
+ | `doughnut` | xlDoughnut | Ring chart (**single-column only**) |
207
+ | `xlLineMarkers` | xlLineMarkers | Line with markers |
208
+ | `xlColumnStacked` | xlColumnStacked | Stacked columns |
209
+ | `xlColumnStacked100` | xlColumnStacked100 | 100% stacked columns |
210
+ | `xlBarStacked` | xlBarStacked | Stacked horizontal bars |
211
+ | `xlPieExploded` | xlPieExploded | Exploded pie |
212
+ | `xl3DPie` | xl3DPie | 3D pie |
213
+ | `xlXYScatter` | xlXYScatter | Scatter plot |
214
+ | `xlRadar` | xlRadar | Radar chart |
215
+
216
+ **Pie/doughnut:** `valueRange` MUST be a single column (e.g., `"C2:C10"`). Multi-column creates hidden series. For pie from non-contiguous data, build a contiguous summary column first.
217
+
218
+ ### Chart Validation
219
+
220
+ The API validates chart data after creation and returns WARNINGs in the response if:
221
+ - Any series has all-zero or all-empty values (source data missing)
222
+ - A pie/doughnut chart has multiple series (only first is shown)
223
+
224
+ Always check `warnings` in the response and fix issues.
225
+
226
+ ---
227
+
228
+ ## Build Guidance (how-to)
229
+
230
+ ### Choosing build strategy
231
+
232
+ | Workbook complexity | Strategy | Why |
233
+ |---------------------|----------|-----|
234
+ | **Simple** (1-3 sheets, no cross-sheet refs) | `build-workbook` with all sheets in ONE call | Fast, everything in one shot |
235
+ | **Complex** (4+ sheets, cross-sheet formulas) | `build-workbook` with 2-3 foundation sheets → `build-sheet` one at a time for computed/dashboard | Batch independent sheets, verify before dependent ones |
236
+
237
+ **Batching rule:** Foundation sheets (no cross-sheet refs) CAN be batched in one `build-workbook` call (e.g., Settings + Budget + Debt). Computed sheets that reference other sheets → build one at a time with verification between each.
238
+
239
+ **Every call must be COMPREHENSIVE** — each sheet spec includes ALL of: `data` (headers + rows + total rows with formulas), `formulas` (every derived column), `formatting`, `conditionalFormatting`, `charts`, `freeze`. Do NOT build a bare sheet and format later. Each sheet takes 10-30s via COM.
240
+
241
+ ### Minimal example (copy this structure)
242
+
243
+ ```json
244
+ {
245
+ "filePath": "C:\\Users\\user\\Documents\\MyWorkbook.xlsx",
246
+ "sheets": [
247
+ {
248
+ "sheetName": "Sheet1",
249
+ "data": {
250
+ "rows": [
251
+ {"values": ["Name", "Jan", "Feb", "Total"]},
252
+ {"values": ["Rent", 1500, 1500, "=SUM(B2:C2)"]},
253
+ {"values": ["Total", "=SUM(B[Rent]:B[Rent])", "=SUM(C[Rent]:C[Rent])", "=SUM(D[Rent]:D[Rent])"]}
254
+ ],
255
+ "firstRowIsHeader": true
256
+ },
257
+ "formatting": [
258
+ {"range": "A1:D1", "bold": true, "interiorColorHtml": "#4472C4", "fontColorHtml": "#FFFFFF"}
259
+ ],
260
+ "freeze": {"rows": 1}
261
+ }
262
+ ]
263
+ }
264
+ ```
265
+
266
+ **Common mistakes (WRONG → RIGHT):**
267
+ - ❌ `"name"` → ✅ `"sheetName"`
268
+ - ❌ `"filename"` → ✅ `"filePath"` (full absolute path)
269
+ - ❌ `"rows": [["a","b"]]` → ✅ `"rows": [{"values": ["a","b"]}]`
270
+ - ❌ `"type": "cellValue"` → ✅ `"ruleType": "CellValue"` (PascalCase value)
271
+ - ❌ chart `"position": {"top":50,"left":350}` → ✅ `"position": "F2"` (cell ref string)
272
+ - ❌ chart without `legendRange` → ✅ always include `"legendRange"` (else "Series1, Series2")
273
+ - ❌ `"=B10/B11"` (hardcoded rows) → ✅ `"=B[Cash Flow]/B[Cash Invested]"` (row-label refs)
274
+ - ❌ AppAct to click sheet tabs → ✅ `/excel/select-sheet`
275
+
276
+ ### Do NOT waste calls — these are built into build-workbook/build-sheet
277
+
278
+ | DO NOT call separately | Use instead |
279
+ |------------------------|-------------|
280
+ | `/excel/auto-fit-columns` | default `autoFitColumns: true` |
281
+ | `/excel/save-workbook` | default `saveAfterBuild: true` |
282
+ | `/excel/get-status` | skip only immediately after `build-workbook` when you inspected `formulaErrors[]`; still call after each `build-sheet` because `build-sheet` does not return `formulaErrors[]` |
283
+ | `/excel/add-chart-from-range` | `charts` field |
284
+ | `/excel/conditional-formatting` | `conditionalFormatting` field |
285
+ | `/excel/freeze-panes` | `freeze` field |
286
+ | `/excel/format-range` | `formatting` array |
287
+
288
+ Applies INSIDE a build call only. OUTSIDE, use these APIs normally — and ALWAYS use `/excel/select-sheet` to switch sheets, never UIA.
289
+
290
+ **`/excel/close-workbook` is the exception — NOT built in, and you do need it** (see "Release the file when you're done"). Call it last, after the final `build-sheet` and its `get-status`, with the `workbookId` from `build-workbook` — `build-sheet` responses do not carry one. A confirmed close drops the id, so never close between build calls.
291
+
292
+ ### Header-name formulas (eliminates column-counting errors)
293
+
294
+ Use header names in `formulas` templates; the server resolves them to column letters.
295
+
296
+ ```json
297
+ "formulas": {
298
+ "startRow": 2, "rowCount": 2,
299
+ "columns": [
300
+ {"column": "Local Value", "template": "={Shares}*{Price}"},
301
+ {"column": "USD Value", "template": "=IF({Currency}=\"USD\",{Local Value},{Local Value}/Settings!$B$2)"}
302
+ ]
303
+ }
304
+ ```
305
+
306
+ `{Shares}` → `C{row}`. The `column` field also accepts header names. Row offsets: `{row-1}`, `{row+1}`. Case-insensitive.
307
+
308
+ **🚨 Header-name refs (`{Header}`) work in `build-workbook`/`build-sheet` `formulas` ONLY.** They do NOT work in `/excel/write-formula` or `/excel/write-formulas-batch` — those pass templates verbatim to Excel COM, which throws a misleading "Insufficient memory to continue" error (actually a parse failure). For standalone formula writes use explicit letters: `=D{row}*0.1`.
309
+
310
+ ### Formula completeness checklist
311
+
312
+ Before submitting, verify every derived column has a formula: multiplication columns, SUM/TOTAL rows, percentage columns, conditional calcs, cross-sheet summary cells. **Total-row ordering:** if a column divides by a total row (`Weight % = Value / Total`), write the total's SUM FIRST (put it in `data.rows` or before dependent columns). A header implying a calculation with `""` or a hardcoded number = bug.
313
+
314
+ ### Label-based cross-sheet references (eliminates row-counting errors)
315
+
316
+ `=@SheetName[Row Label]` or `=@SheetName[Row Label,Column]` — the server finds the row by matching column A text.
317
+
318
+ ```json
319
+ "rows": [
320
+ {"values": ["Portfolio Value", "=@Portfolio[TOTAL PORTFOLIO]"]},
321
+ {"values": ["China Stocks (USD)", "=@Portfolio[Total China Value (CNY),D]"]},
322
+ {"values": ["Net Worth", "=@Net Worth[Current Net Worth]"]}
323
+ ]
324
+ ```
325
+
326
+ `=@Portfolio[TOTAL PORTFOLIO]` → finds the column-A match, returns column B (add `,D` for another column). Sheet names with spaces auto-quoted. Case-insensitive. **Work in `build-workbook`/`build-sheet` ONLY** (in `build-sheet`, the referenced sheet must already exist). For non-composite endpoints, use explicit refs (`='Portfolio'!B24`).
327
+
328
+ ### Composite vs individual
329
+
330
+ **Composite** (`build-workbook`/`build-sheet`): new workbooks/sheets. **Individual** (`write-range`, `write-formula`, `write-formulas-batch`): editing existing data, formula columns, pivots. Prefer `write-formulas-batch` for repeated formula fills, even one column.
331
+
332
+ ### Notes
333
+
334
+ - **get-status limits:** one sheet at a time, cells A1:AE1000, 10s timeout. Verify beyond row 1000 with `read-range`.
335
+ - **Sheet names:** call `get-workbook-info` before any cross-sheet formula; use only returned names.
336
+ - **Never fabricate values:** `read-range` key cells before reporting.
337
+ - **Recovery:** for COM error recovery, `build-sheet` fallback, write verification, raw-data protection, spillover prevention, read `reference/repair.md`.
@@ -0,0 +1,139 @@
1
+ # Scripting & Health
2
+
3
+ Health checks, undo, and C# scripting (last resort).
4
+
5
+ ---
6
+
7
+ ## Health Check
8
+
9
+ ### /excel/get-status
10
+
11
+ **REQUIRED after scripts/charts!** Detects errors and overlaps.
12
+
13
+ | Parameter | Type | Required | Description |
14
+ |-----------|------|----------|-------------|
15
+ | sheetName | string | No | Check specific sheet (all if omitted) |
16
+
17
+ **Detects:**
18
+ - Formula errors: `#REF!`, `#DIV/0!`, `#VALUE!`, `#NAME?`, `#N/A`, `#####`
19
+ - Chart overlaps with data or other charts
20
+ - Broken references
21
+
22
+ **Response:**
23
+ - `hasErrors` (boolean)
24
+ - `errors[]` - Array with `cell`, `errorType`, `sheet`
25
+ - `hasOverlaps` (boolean)
26
+ - `overlaps[]` - Overlap details
27
+
28
+ **When to call:**
29
+ - After any `/excel/execute-script` (MANDATORY!)
30
+ - After adding charts
31
+ - After complex formula operations
32
+ - Before saving workbook
33
+
34
+ ---
35
+
36
+ ### /excel/rearrange-overlaps
37
+
38
+ Automatically reposition overlapping charts/shapes.
39
+
40
+ | Parameter | Type | Required | Description |
41
+ |-----------|------|----------|-------------|
42
+ | sheetName | string | No | Sheet (all sheets if omitted) |
43
+
44
+ ---
45
+
46
+ ### /excel/undo
47
+
48
+ | Parameter | Type | Required | Default | Description |
49
+ |-----------|------|----------|---------|-------------|
50
+ | steps | number | No | 1 | Steps to undo |
51
+
52
+ ⚠️ Not all operations are undoable (e.g., VBA/script changes may not undo cleanly)
53
+
54
+ ---
55
+
56
+ ## C# Scripting
57
+
58
+ ### /excel/execute-script
59
+
60
+ **LAST RESORT** - Use only when API endpoints are insufficient.
61
+
62
+ | Parameter | Type | Required | Description |
63
+ |-----------|------|----------|-------------|
64
+ | sheetName | string | Yes | Target sheet |
65
+ | script | string | Yes | C# code |
66
+
67
+ **Pre-defined Variables:**
68
+ - `workbook` - Excel.Workbook object
69
+ - `worksheet` - Excel.Worksheet object (target sheet)
70
+ - `app` - Excel.Application object
71
+
72
+ **Script Rules:**
73
+ 1. Use semicolons after statements
74
+ 2. Access cells: `worksheet.Range["A1"].Value = 123;`
75
+ 3. Access other sheets: `workbook.Worksheets["Sheet2"]`
76
+ 4. Return values: Last expression is returned
77
+
78
+ ---
79
+
80
+ ### Example - Alternating Row Colors
81
+
82
+ ```csharp
83
+ var usedRange = worksheet.UsedRange;
84
+ for (int row = 2; row <= usedRange.Rows.Count; row++)
85
+ {
86
+ var rowRange = worksheet.Range[
87
+ worksheet.Cells[row, 1],
88
+ worksheet.Cells[row, usedRange.Columns.Count]
89
+ ];
90
+ if (row % 2 == 0)
91
+ {
92
+ rowRange.Interior.Color = System.Drawing.ColorTranslator.ToOle(
93
+ System.Drawing.Color.FromArgb(240, 240, 240)
94
+ );
95
+ }
96
+ }
97
+ ```
98
+
99
+ ---
100
+
101
+ ### Example - Sum Column with Condition
102
+
103
+ ```csharp
104
+ double sum = 0;
105
+ var lastRow = worksheet.Cells[worksheet.Rows.Count, 1]
106
+ .End[Excel.XlDirection.xlUp].Row;
107
+ for (int i = 2; i <= lastRow; i++)
108
+ {
109
+ var status = worksheet.Cells[i, 5].Value?.ToString();
110
+ if (status == "Active")
111
+ {
112
+ sum += Convert.ToDouble(worksheet.Cells[i, 3].Value ?? 0);
113
+ }
114
+ }
115
+ worksheet.Cells[lastRow + 1, 3].Value = sum;
116
+ worksheet.Cells[lastRow + 1, 3].Font.Bold = true;
117
+ ```
118
+
119
+ ---
120
+
121
+ ### Common Pitfalls
122
+
123
+ | Error | Cause | Fix |
124
+ |-------|-------|-----|
125
+ | `Cannot apply '==' to DateTime and DBNull` | Direct comparison | Use `DBNull.Value.Equals(obj)` |
126
+ | `Value cannot be null (key)` | Null dictionary key | `if (string.IsNullOrEmpty(key)) continue;` |
127
+ | LINQ compilation error | LINQ on COM collections | Use manual `foreach` loops |
128
+ | Null reference | Reassigned worksheet variable | Use `worksheet` directly |
129
+
130
+ **Rules:**
131
+ - **MAX 150 lines** per script
132
+ - **NO "Excel." prefix** on enums
133
+ - **Escape quotes:** `\"` in formulas
134
+ - **Check null AND DBNull** - both can appear
135
+ - **Use foreach**, not LINQ on COM collections
136
+
137
+ ⚠️ **ALWAYS run `/excel/get-status` after scripts!**
138
+
139
+ **See `windows/examples/level-3-scripting.md` for more patterns.**