@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.
- package/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +729 -0
- package/dist/skills/business-analysis/as-is-capture.md +444 -0
- package/dist/skills/business-analysis/assets/progress.yaml +19 -0
- package/dist/skills/business-analysis/assets/task-list.md +34 -0
- package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
- package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
- package/dist/skills/business-analysis/case-to-be-design.md +223 -0
- package/dist/skills/business-analysis/diagram-authoring.md +224 -0
- package/dist/skills/business-analysis/industry-gaps.md +134 -0
- package/dist/skills/business-analysis/interview-spine.md +297 -0
- package/dist/skills/business-analysis/locales/de.json +54 -0
- package/dist/skills/business-analysis/locales/en.json +54 -0
- package/dist/skills/business-analysis/locales/es-MX.json +54 -0
- package/dist/skills/business-analysis/locales/es.json +54 -0
- package/dist/skills/business-analysis/locales/fr.json +54 -0
- package/dist/skills/business-analysis/locales/ja.json +54 -0
- package/dist/skills/business-analysis/locales/ko.json +54 -0
- package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
- package/dist/skills/business-analysis/locales/pt.json +54 -0
- package/dist/skills/business-analysis/locales/ro.json +54 -0
- package/dist/skills/business-analysis/locales/tr.json +54 -0
- package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
- package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
- package/dist/skills/business-analysis/pdd-generation.md +204 -0
- package/dist/skills/business-analysis/pdd-template.md +562 -0
- package/dist/skills/business-analysis/progress-presentation.json +13 -0
- package/dist/skills/business-analysis/recording-first.md +19 -0
- package/dist/skills/business-analysis/recording-processing.md +152 -0
- package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
- package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
- package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
- package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
- package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
- package/dist/skills/business-analysis/research-offer.md +104 -0
- package/dist/skills/business-analysis/research-pass.md +149 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
- package/dist/skills/business-analysis/to-be-design.md +199 -0
- package/dist/skills/confluence/SKILL.md +386 -0
- package/dist/skills/doc-coauthoring/SKILL.md +295 -0
- package/dist/skills/excel-architect/SKILL.macos.md +161 -0
- package/dist/skills/excel-architect/SKILL.md +180 -0
- package/dist/skills/excel-architect/SKILL.windows.md +61 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
- package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
- package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
- package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
- package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
- package/dist/skills/excel-architect/building.md +279 -0
- package/dist/skills/excel-architect/create.md +64 -0
- package/dist/skills/excel-architect/data-and-formulas.md +186 -0
- package/dist/skills/excel-architect/generator.md +272 -0
- package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
- package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
- package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
- package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
- package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
- package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
- package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
- package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
- package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
- package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
- package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
- package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
- package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
- package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
- package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
- package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
- package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
- package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
- package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
- package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
- package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
- package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
- package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
- package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
- package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
- package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
- package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
- package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
- package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
- package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
- package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
- package/dist/skills/excel-architect/reference/api/basic.md +747 -0
- package/dist/skills/excel-architect/reference/guides.md +348 -0
- package/dist/skills/excel-architect/reference/repair.md +174 -0
- package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
- package/dist/skills/excel-architect/scripting.md +266 -0
- package/dist/skills/excel-architect/styling-and-features.md +433 -0
- package/dist/skills/excel-architect/windows/api/composites.md +337 -0
- package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
- package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
- package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
- package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
- package/dist/skills/github/SKILL.md +446 -0
- package/dist/skills/github/recipes/add-comment.md +85 -0
- package/dist/skills/github/recipes/check-pr-status.md +122 -0
- package/dist/skills/github/recipes/compare-branches.md +79 -0
- package/dist/skills/github/recipes/create-issue.md +103 -0
- package/dist/skills/github/recipes/create-pr.md +97 -0
- package/dist/skills/github/recipes/get-file-contents.md +76 -0
- package/dist/skills/github/recipes/get-last-commit.md +128 -0
- package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
- package/dist/skills/github/recipes/list-recent-commits.md +84 -0
- package/dist/skills/github/recipes/search-issues.md +115 -0
- package/dist/skills/google-workspace/SKILL.md +217 -0
- package/dist/skills/google-workspace/services/calendar.md +311 -0
- package/dist/skills/google-workspace/services/docs.md +426 -0
- package/dist/skills/google-workspace/services/drive.md +504 -0
- package/dist/skills/google-workspace/services/gmail.md +466 -0
- package/dist/skills/google-workspace/services/sheets.md +370 -0
- package/dist/skills/internal-comms/SKILL.md +35 -0
- package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
- package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
- package/dist/skills/internal-comms/examples/general-comms.md +15 -0
- package/dist/skills/jira/SKILL.md +397 -0
- package/dist/skills/jira/recipes/add-comment.md +123 -0
- package/dist/skills/jira/recipes/assign-issue.md +157 -0
- package/dist/skills/jira/recipes/create-issue.md +274 -0
- package/dist/skills/jira/recipes/get-issue-details.md +154 -0
- package/dist/skills/jira/recipes/list-projects.md +151 -0
- package/dist/skills/jira/recipes/my-issues.md +180 -0
- package/dist/skills/jira/recipes/search-issues.md +215 -0
- package/dist/skills/jira/recipes/transition-issue.md +154 -0
- package/dist/skills/jira/recipes/troubleshooting.md +387 -0
- package/dist/skills/knowledge-base/SKILL.md +289 -0
- package/dist/skills/media-tools/SKILL.md +204 -0
- package/dist/skills/media-tools/references/encode-runbook.md +24 -0
- package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
# PowerPoint Architect - macOS Reference
|
|
2
|
+
|
|
3
|
+
macOS PowerPoint automation uses its `/ppt/*` endpoint set via `ExecuteSkillApi`. AppleScript handlers implement these endpoints.
|
|
4
|
+
|
|
5
|
+
## Execution Priority (macOS)
|
|
6
|
+
|
|
7
|
+
| Priority | Approach | Tool | Best For |
|
|
8
|
+
|----------|----------|------|----------|
|
|
9
|
+
| **1st** | Generator | `/ppt-gen/generate` via ExecuteSkillApi | Creating new presentations |
|
|
10
|
+
| **2nd** | ExecuteSkillApi | `/ppt/*` endpoints | All operations in the macOS endpoint set |
|
|
11
|
+
| **3rd** | UI automation | AppAct | UI fallback when API fails 2+ times |
|
|
12
|
+
|
|
13
|
+
**Use ExecuteSkillApi with the macOS `/ppt/*` endpoints for ALL operations.** This includes `/ppt/select-slide` for navigating between slides.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Creation (New Presentation)
|
|
18
|
+
| Task | Endpoint | Key Parameters |
|
|
19
|
+
|------|----------|----------------|
|
|
20
|
+
| Generate new presentation | `/ppt-gen/generate` | options (title, theme/themePath, outputPath), slides |
|
|
21
|
+
| List generator themes | `/ppt-gen/list-themes` | - |
|
|
22
|
+
| Render Mermaid diagram to PNG | `/diagram/render-mermaid` | code, outputPath |
|
|
23
|
+
|
|
24
|
+
**Note:** `/ppt-gen/*` creates presentations from scratch (no PowerPoint needed — pure TS/pptxgenjs). `/ppt/*` drives an already-open PowerPoint window for editing. Do NOT use `/ppt/generate` or `/ppt/create-presentation` — those endpoints do not exist. See `generator-reference.md` for the `/ppt-gen/generate` JSON format.
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## Endpoint Reference (macOS)
|
|
29
|
+
|
|
30
|
+
Call every operation through ExecuteSkillApi `/ppt/*` endpoints — same call shape as Windows. The AppleScript files under `macos/scripts/` are the internal implementation the executor runs on your behalf; they are not a separate API. Do NOT invoke them directly with raw `osascript` — that bypasses argument validation, presentation activation, and the tool execution policy layer.
|
|
31
|
+
|
|
32
|
+
### Slide Operations
|
|
33
|
+
| Endpoint | Key Parameters | Script (implementation) |
|
|
34
|
+
|----------|-----------------|--------------------------|
|
|
35
|
+
| `/ppt/insert-slide` | position, slideLayout | `add-slide.applescript` |
|
|
36
|
+
| `/ppt/delete-slide`, `/ppt/delete-slides` | slideNumber or slideNumbers (array), or a range string (`"3-7"`, `"2,4-6"`) | `delete-slides.applescript` |
|
|
37
|
+
| `/ppt/duplicate-slide`, `/ppt/duplicate-slides` | startSlideNumber, or slideNumbers/sourceSlides (array, any order — sorted and de-duplicated for you), plus targetPosition. Without targetPosition each copy lands directly after its source; with it, all copies form one contiguous block starting at targetPosition in ascending source order. Returns `newSlideNumbers[]` + `totalSlides` | `copy-slides.applescript` |
|
|
38
|
+
| `/ppt/copy-slides` | Same parameters and placement rules as duplicate-slides. Returns `message` only — call `/ppt/get-presentation-info` if you need the new positions | `copy-slides.applescript` |
|
|
39
|
+
| `/ppt/reorder-slide`, `/ppt/reorder-slides` | slideNumber, newPosition | `reorder-slides.applescript` |
|
|
40
|
+
| `/ppt/select-slide`, `/ppt/navigate-to-slide` | slideNumber | `navigate-to-slide.applescript` |
|
|
41
|
+
| `/ppt/apply-slide-layout` | slideNumber, layoutName | `apply-slide-layout.applescript` |
|
|
42
|
+
|
|
43
|
+
### Content Operations
|
|
44
|
+
| Endpoint | Key Parameters | Script (implementation) |
|
|
45
|
+
|----------|-----------------|--------------------------|
|
|
46
|
+
| `/ppt/add-text-to-slide` | slideNumber, targetShapeName, text | `add-text.applescript` |
|
|
47
|
+
| `/ppt/insert-text-box`, `/ppt/add-textbox`, `/ppt/add-text-box` | slideNumber, text, left/top/width/height, fontColor | `insert-text-box.applescript` |
|
|
48
|
+
| `/ppt/replace-text` | oldText, newText, matchCase, replaceAll | `replace-text.applescript` |
|
|
49
|
+
| `/ppt/insert-image`, `/ppt/replace-image` | slideNumber, imagePath, left/top/width/height (insert); shapeName, newImagePath (replace) | `manage-image.applescript` |
|
|
50
|
+
| `/ppt/insert-shape` | slideNumber, shapeType, left/top/width/height | `insert-shape.applescript` |
|
|
51
|
+
| `/ppt/insert-table` | slideNumber, rows, columns, table (2D array; `data`/`tableData` also accepted; rows/columns inferred from `table` when omitted) | `insert-table.applescript` |
|
|
52
|
+
| `/ppt/add-speaker-notes` | slideNumber, notes | `add-speaker-notes.applescript` |
|
|
53
|
+
| `/ppt/insert-chart` | slideNumber, chartType, categories + series (or data string) | `create-chart-with-data.applescript` |
|
|
54
|
+
| `/ppt/add-html-to-slide` | slideNumber, targetShapeName, html, fontFamily, fontSize | `add-html-to-slide.applescript` — **preferred** for formatted text (bold, italic, lists, headings) |
|
|
55
|
+
| `/ppt/extract-slide-data` | slideNumber or slideNumbers (array); omit both for all slides | `extract-slide-data.applescript` |
|
|
56
|
+
|
|
57
|
+
### Layout & Formatting
|
|
58
|
+
| Endpoint | Key Parameters | Script (implementation) |
|
|
59
|
+
|----------|-----------------|--------------------------|
|
|
60
|
+
| `/ppt/apply-theme` | themeName or themeFilePath (e.g. Gallery, Ion), or randomTheme: true | `apply-theme.applescript` |
|
|
61
|
+
| `/ppt/format-shape` | slideNumber, shapeName, left/top/width/height/deltaX/deltaY/rotation/visible | `format-shape.applescript` |
|
|
62
|
+
| `/ppt/format-slide-content` | slideNumber or slideNumbers, shapeName, fontSize/fontName/bold/italic/underline/color/align, textMatch. `textMatch` scopes the font changes to the **first** occurrence of that substring (case-insensitive) instead of the whole shape — Windows formats every occurrence. It only narrows the scope, so at least one real formatting option must accompany it. `align` is paragraph-level and always applies to the whole shape | `format-slide-content.applescript` |
|
|
63
|
+
| `/ppt/autofit-placeholders`, `/ppt/optimize-slide`, `/ppt/optimize-slides` | filePath, slideNumber (or all: true). `deleteEmpty` is **not supported on macOS**: the autofit still runs, a `warning` reports that no shapes were removed. Hide an empty placeholder with `/ppt/format-shape` `visible: false` | `autofit-placeholders.applescript` |
|
|
64
|
+
| `/ppt/set-transition` | slideNumber, transitionType, duration | `set-transition.applescript` |
|
|
65
|
+
| `/ppt/set-animation` | slideNumber, shapeName, animationType, effect, duration, trigger | `set-animation.applescript` |
|
|
66
|
+
|
|
67
|
+
### Info & Export
|
|
68
|
+
| Endpoint | Key Parameters | Script (implementation) |
|
|
69
|
+
|----------|-----------------|--------------------------|
|
|
70
|
+
| `/ppt/get-presentation-info` | filePath | `get-presentation-info.applescript` |
|
|
71
|
+
| `/ppt/analyze-slide-content` | filePath, slideNumbers (array); omit slideNumbers for a whole-presentation summary | `get-presentation-info.applescript` / `get-slide-info.applescript` |
|
|
72
|
+
| `/ppt/get-slide-info` | filePath, slideNumber (optional) | `get-slide-info.applescript` |
|
|
73
|
+
| `/ppt/get-layout-elements` | filePath, layoutName (optional) | `get-layout-elements.applescript` |
|
|
74
|
+
| `/ppt/get-slide-count` | filePath | `get-slide-count.applescript` |
|
|
75
|
+
| `/ppt/get-current-slide-number` | filePath | `get-current-slide-number.applescript` |
|
|
76
|
+
| `/ppt/get-layouts` | filePath | `get-layouts.applescript` |
|
|
77
|
+
| `/ppt/get-file-path`, `/ppt/get-presentation-path` | filePath | `get-file-path.applescript` |
|
|
78
|
+
| `/ppt/get-opened-files` | - | `get-opened-files.applescript` |
|
|
79
|
+
| `/ppt/get-recent-files` | maxCount (default 10) | `get-recent-files.applescript` |
|
|
80
|
+
| `/ppt/save-as-pdf`, `/ppt/export-presentation` | filePath, pdfFilePath or exportPath, format (default `pdf`) | `export-presentation.applescript` |
|
|
81
|
+
| `/ppt/review-slides`, `/ppt/validate-live` | filePath, slideNumbers (optional) — `validate-live` is an alias of `review-slides` | `health-check.applescript` |
|
|
82
|
+
|
|
83
|
+
### Presentation Control
|
|
84
|
+
| Endpoint | Key Parameters | Script (implementation) |
|
|
85
|
+
|----------|-----------------|--------------------------|
|
|
86
|
+
| `/ppt/open-attach` | filePath, createNew, themePath/theme/themeName | `open-presentation.applescript` / `create-with-theme.applescript` |
|
|
87
|
+
| `/ppt/close`, `/ppt/close-presentation` | filePath (saves first, then closes) | `close-presentation.applescript` |
|
|
88
|
+
| `/ppt/save-presentation` | `filePath` identifies the deck (required). Omit `saveAsPath` to save in place; pass `saveAsPath` (absolute POSIX path — relative paths are rejected) to Save As to that path. **After a Save As the newly-saved file becomes the open document, so every later call must use the NEW path** — reusing the old one fails with `DELEGATE_OFFICE_TARGET_NOT_OPEN` | `save-presentation.applescript` |
|
|
89
|
+
| `/ppt/maximize-window` | - | `maximize-window.applescript` |
|
|
90
|
+
|
|
91
|
+
Mutating endpoints (insert/add/replace/format/delete/duplicate/copy/reorder/transition/animation/theme/layout/autofit) save the presentation automatically on success. A save failure after a successful edit is reported as a `warning` field, not an error.
|
|
92
|
+
|
|
93
|
+
**A presentation the user has never saved cannot be used at all.** Every `/ppt/*` call except `get-opened-files`, `get-recent-files`, and `maximize-window` needs a real `filePath` and is refused with `DELEGATE_OFFICE_TARGET_NOT_OPEN` when no open document matches it, and a pathless deck can never match. You cannot save it on the user's behalf either — a destination-less save lands in PowerPoint's sandbox container where they will not find it. Ask the user to save it (File > Save As), then `/ppt/open-attach` that path.
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## SharePoint / OneDrive Files
|
|
98
|
+
|
|
99
|
+
To open a file from SharePoint or OneDrive — **never download via HTTP** (auth will fail) or click through browser UI.
|
|
100
|
+
|
|
101
|
+
**⚠️ Do NOT use the shell `open` command** with `ms-powerpoint:ofe|u|` — it corrupts the URL (strips a `/` from `https://`), causing "PowerPoint can't read" errors. Also do NOT use `tell application "Microsoft PowerPoint" to open "<url>"` — PowerPoint cannot authenticate to SharePoint without the protocol handler.
|
|
102
|
+
|
|
103
|
+
**Use AppleScript `open location` instead:**
|
|
104
|
+
```bash
|
|
105
|
+
osascript -e 'open location "ms-powerpoint:ofe|u|<direct_file_url>"'
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**⚠️ URL encoding and spaces:** macOS `open location` can sometimes double-encode `%20` → `%2520`, causing "PowerPoint can't open this file" errors. If the URL contains `%20` and opening fails, retry with `%20` decoded to literal spaces:
|
|
109
|
+
```bash
|
|
110
|
+
# Try 1: URL as-is
|
|
111
|
+
osascript -e 'open location "ms-powerpoint:ofe|u|https://company.sharepoint.com/sites/team/Shared%20Documents/My%20File.pptx"'
|
|
112
|
+
|
|
113
|
+
# If "can't open" error → Try 2: decode %20 to spaces
|
|
114
|
+
osascript -e 'open location "ms-powerpoint:ofe|u|https://company.sharepoint.com/sites/team/Shared Documents/My File.pptx"'
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### URL Format — CRITICAL
|
|
118
|
+
|
|
119
|
+
The URL **must** be the **direct document URL** ending in `.pptx`, for example:
|
|
120
|
+
```
|
|
121
|
+
✅ https://company-my.sharepoint.com/personal/user_name/Documents/MyFile.pptx
|
|
122
|
+
✅ https://company.sharepoint.com/sites/team/Shared Documents/Deck.pptx
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
**NEVER** use browser page URLs — PowerPoint will fail with "PowerPoint can't open this type of file":
|
|
126
|
+
```
|
|
127
|
+
❌ https://company.sharepoint.com/:p:/r/personal/user_name/_layouts/15/Doc.aspx?sourcedoc=%7B...%7D&action=edit
|
|
128
|
+
❌ https://company.sharepoint.com/:p:/r/personal/user_name/Documents/File.pptx (has :p:/r/ prefix)
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
**How to convert a browser URL to a direct URL:**
|
|
132
|
+
|
|
133
|
+
1. **Strip the routing prefix** `/:p:/r/` or `/:p:/g/` — these are SharePoint sharing/routing prefixes
|
|
134
|
+
2. **Strip query parameters** (`?sourcedoc=...&action=edit`)
|
|
135
|
+
3. **Strip `_layouts/15/Doc.aspx`** paths entirely — reconstruct from the document library path
|
|
136
|
+
4. **Fix the domain** for personal OneDrive files: `company.sharepoint.com` → `company-my.sharepoint.com`
|
|
137
|
+
- Personal files (path contains `/personal/`) use the `-my` subdomain
|
|
138
|
+
- Team/site files (path contains `/sites/`) use the base domain
|
|
139
|
+
|
|
140
|
+
**Conversion examples:**
|
|
141
|
+
```
|
|
142
|
+
Browser: https://uipath.sharepoint.com/:p:/r/personal/john_doe_uipath_com/Documents/Deck.pptx
|
|
143
|
+
Direct: https://uipath-my.sharepoint.com/personal/john_doe_uipath_com/Documents/Deck.pptx
|
|
144
|
+
^^^^^^^^^ add -my ^^^^^^^^^ strip :p:/r/
|
|
145
|
+
|
|
146
|
+
Browser: https://company.sharepoint.com/:p:/r/sites/team/_layouts/15/Doc.aspx?sourcedoc=%7B...%7D
|
|
147
|
+
Direct: Ask the user for the filename — cannot be reconstructed from _layouts URL
|
|
148
|
+
|
|
149
|
+
Browser: https://company.sharepoint.com/:p:/r/sites/team/Shared%20Documents/Report.pptx?d=w...
|
|
150
|
+
Direct: https://company.sharepoint.com/sites/team/Shared%20Documents/Report.pptx
|
|
151
|
+
(no -my for /sites/) ^^^^^^^^^ strip :p:/r/ ^^^^^^^^^ strip ?d=...
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Then call `/ppt/get-opened-files` to confirm it loaded and get the file path.
|
|
155
|
+
|
|
156
|
+
### Workflow
|
|
157
|
+
|
|
158
|
+
1. Open the SharePoint file via AppleScript `open location`:
|
|
159
|
+
```bash
|
|
160
|
+
osascript -e 'open location "ms-powerpoint:ofe|u|<url>"'
|
|
161
|
+
```
|
|
162
|
+
2. Wait a few seconds for PowerPoint to load the file
|
|
163
|
+
3. Call `/ppt/get-opened-files` — the returned path may be a local temp path (macOS downloads SharePoint files to a local cache, unlike Windows which keeps the URL)
|
|
164
|
+
4. Use the returned `path` as `filePath` in all subsequent `/ppt/*` endpoints
|
|
165
|
+
|
|
166
|
+
### Copy slides from a SharePoint source
|
|
167
|
+
|
|
168
|
+
Unlike Windows, macOS does **not** support cross-file `/ppt/copy-slides` with a `sourceFilePath`. Instead:
|
|
169
|
+
|
|
170
|
+
1. Open the SharePoint source via `open location` (as above)
|
|
171
|
+
2. Use `/ppt/get-opened-files` to get the local cached path
|
|
172
|
+
3. Use the **Generator** with `themePath` pointing to the cached source path to create a new presentation with the same theme
|
|
173
|
+
4. Or call `/ppt/copy-slides` (no `sourceFilePath`) within the open source presentation to duplicate slides there, then edit content in place
|
|
174
|
+
|
|
175
|
+
### If the file is already open
|
|
176
|
+
|
|
177
|
+
If the user already opened the file in desktop PowerPoint (e.g., from browser "Open in Desktop App"), just call `/ppt/get-opened-files` to get the file path and proceed.
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## Layout Names
|
|
182
|
+
|
|
183
|
+
For `/ppt/insert-slide` (`slideLayout`) and `/ppt/apply-slide-layout` (`layoutName`):
|
|
184
|
+
|
|
185
|
+
| Layout Name | Description |
|
|
186
|
+
|-------------|-------------|
|
|
187
|
+
| `title` | Title slide (centered) |
|
|
188
|
+
| `content` | Title + content placeholder |
|
|
189
|
+
| `two-column` | Title + two columns |
|
|
190
|
+
| `title-only` | Title only |
|
|
191
|
+
| `blank` | Empty slide |
|
|
192
|
+
| `chart` | Chart layout |
|
|
193
|
+
| `table` | Table layout |
|
|
194
|
+
| `section` | Section header |
|
|
195
|
+
| `comparison` | Two-column comparison |
|
|
196
|
+
| `picture-caption` | Picture with caption |
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## Common Workflows
|
|
201
|
+
|
|
202
|
+
### Create Presentation with Custom Theme
|
|
203
|
+
1. `/ppt-gen/generate` with `options.themePath` — creates the COMPLETE presentation (all slides) in one call.
|
|
204
|
+
2. `/ppt/open-attach` with `filePath` — open the created file (skip if the generator already opened it).
|
|
205
|
+
3. Edit further with `/ppt/*` endpoints as needed.
|
|
206
|
+
|
|
207
|
+
### Edit Existing Presentation
|
|
208
|
+
1. `/ppt/get-presentation-info` (or `/ppt/analyze-slide-content`) — get presentation info
|
|
209
|
+
2. `/ppt/select-slide` with `slideNumber: 3` — navigate to target slide
|
|
210
|
+
3. `/ppt/get-slide-info` with `slideNumber: 3` (or `/ppt/analyze-slide-content` with `slideNumbers: [3]`) — get shapes/placeholders
|
|
211
|
+
4. `/ppt/insert-text-box` with `slideNumber: 3, text: "New content here"` — add content
|
|
212
|
+
5. `/ppt/review-slides` — verify
|
|
213
|
+
|
|
214
|
+
### Insert Formatted HTML Content
|
|
215
|
+
- `/ppt/add-html-to-slide` with `slideNumber: 1, targetShapeName: "Content Placeholder 2", html: "<ul><li><b>Bold item</b></li><li><i>Italic item</i></li></ul>"`
|
|
216
|
+
- With a specific font: `/ppt/add-html-to-slide` with `slideNumber: 2, targetShapeName: "Content Placeholder 2", html: "<p>Formatted text</p>", fontFamily: "Calibri"`
|
|
217
|
+
|
|
218
|
+
### Export to PDF
|
|
219
|
+
`/ppt/save-as-pdf` with `pdfFilePath: "/path/to/output.pdf", format: "pdf"`
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Emoji / Unicode Limitations (macOS)
|
|
224
|
+
|
|
225
|
+
**NEVER use emoji characters (✅, ⚠️, ❌, etc.) in table cell data on macOS.** They render as "A" or "Aa" due to AppleScript/PowerPoint encoding issues.
|
|
226
|
+
|
|
227
|
+
Use text alternatives: `YES`/`NO`/`PARTIAL`, or `[+]`/`[-]`/`[~]`.
|
|
228
|
+
|
|
229
|
+
This does NOT affect regular text shapes (titles, content placeholders) — only table cells.
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## Limitations vs Windows
|
|
234
|
+
|
|
235
|
+
| Feature | Windows | macOS |
|
|
236
|
+
|---------|---------|-------|
|
|
237
|
+
| Create presentations | ✅ Generator | ✅ Generator |
|
|
238
|
+
| Add/edit slides | ✅ API | ✅ AppleScript |
|
|
239
|
+
| Insert images | ✅ API | ✅ AppleScript |
|
|
240
|
+
| Charts/tables | ✅ API | ✅ AppleScript |
|
|
241
|
+
| Health check | ✅ `/ppt/review-slides` | ✅ `health-check.applescript` |
|
|
242
|
+
| Emoji in tables | ✅ Supported | ❌ Use text alternatives |
|
|
243
|
+
| HTML content insertion | ❌ Use add-text + format | ✅ `add-html-to-slide.applescript` |
|
|
244
|
+
| SharePoint open | ✅ PowerShell protocol | ✅ `open location` + `ms-powerpoint:` protocol |
|
|
245
|
+
| SharePoint cross-file copy | ✅ `/ppt/copy-slides` with URL | ❌ Open source first, use local cached path |
|
|
246
|
+
| Speed | Fast (API) | Medium (AppleScript) |
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
## Fallback to AppAct
|
|
251
|
+
|
|
252
|
+
If AppleScript fails for complex operations, use AppAct:
|
|
253
|
+
1. Take screenshot to see UI state
|
|
254
|
+
2. Use AppFind to locate elements
|
|
255
|
+
3. Use AppAct to click/text_type
|
|
256
|
+
4. Screenshot to verify
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## Theme Detection
|
|
261
|
+
|
|
262
|
+
`get-presentation-info.applescript` reports the theme/design name and flags default themes. When `themeWarning` is present in the response, use the duplicate-slide + replace content pattern instead of insert-slide. See the "Theme Detection & Slide Insertion Strategy" section in the common `SKILL.md` for full details.
|
|
263
|
+
|
|
264
|
+
---
|
|
265
|
+
|
|
266
|
+
## Documentation
|
|
267
|
+
|
|
268
|
+
| File | Content | When to Load |
|
|
269
|
+
|------|---------|--------------|
|
|
270
|
+
| Common `SKILL.md` | Generator usage, styling, theme detection | Creating presentations |
|
|
271
|
+
| `custom_themes.md` | Custom theme workflow | Using .thmx files |
|