@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,239 @@
|
|
|
1
|
+
# Level 2: C# Scripting (Last Resort Only)
|
|
2
|
+
|
|
3
|
+
**Use ONLY when API endpoints are insufficient!**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## When to Use Scripts
|
|
8
|
+
|
|
9
|
+
**Use for:**
|
|
10
|
+
- Complex conditional logic based on shape content
|
|
11
|
+
- Bulk operations across many shapes
|
|
12
|
+
- Advanced chart customization beyond API
|
|
13
|
+
- Custom animations or transitions
|
|
14
|
+
- Operations with no API equivalent
|
|
15
|
+
|
|
16
|
+
**Don't use for (prefer endpoints):**
|
|
17
|
+
- Adding text to slides -> `/ppt/add-text-to-slide`
|
|
18
|
+
- Inserting charts -> `/ppt/insert-chart`
|
|
19
|
+
- Inserting tables -> `/ppt/insert-table`
|
|
20
|
+
- Extracting data -> `/ppt/extract-slide-data`
|
|
21
|
+
- Formatting -> `/ppt/format-slide-content`
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Basic Usage
|
|
26
|
+
|
|
27
|
+
```json
|
|
28
|
+
endpoint: "/ppt/execute-script"
|
|
29
|
+
body: {
|
|
30
|
+
"filePath": "C:\\path\\to\\presentation.pptx",
|
|
31
|
+
"slideNumber": 1,
|
|
32
|
+
"script": "// C# code here"
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Pre-defined Variables (NEVER reassign!):**
|
|
37
|
+
- `presentation` - Active presentation
|
|
38
|
+
- `slide` - Target slide (if slideNumber provided)
|
|
39
|
+
- `app` - PowerPoint application
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Critical Rules
|
|
44
|
+
|
|
45
|
+
### Never Reassign Global Variables
|
|
46
|
+
|
|
47
|
+
```csharp
|
|
48
|
+
// WRONG: Reassigning globals causes null reference!
|
|
49
|
+
dynamic pres = presentation;
|
|
50
|
+
dynamic s = slide;
|
|
51
|
+
|
|
52
|
+
// CORRECT: Use globals directly
|
|
53
|
+
foreach (dynamic shape in slide.Shapes) { ... }
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Dynamic COM Limitations
|
|
57
|
+
|
|
58
|
+
```csharp
|
|
59
|
+
// WRONG: LINQ doesn't work on COM collections
|
|
60
|
+
slide.Shapes.Cast<Shape>().Where(s => s.HasTextFrame)
|
|
61
|
+
|
|
62
|
+
// CORRECT: Use foreach loops
|
|
63
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
64
|
+
if (shape.HasTextFrame == MsoTriState.msoTrue) {
|
|
65
|
+
// process shape
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Common Operations
|
|
73
|
+
|
|
74
|
+
### Iterate All Shapes on Slide
|
|
75
|
+
|
|
76
|
+
```csharp
|
|
77
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
78
|
+
if (shape.HasTextFrame == MsoTriState.msoTrue) {
|
|
79
|
+
string text = shape.TextFrame.TextRange.Text;
|
|
80
|
+
// Process text
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return "Processed " + slide.Shapes.Count + " shapes";
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Modify Chart Data
|
|
87
|
+
|
|
88
|
+
```csharp
|
|
89
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
90
|
+
if (shape.HasChart == MsoTriState.msoTrue) {
|
|
91
|
+
dynamic wb = shape.Chart.ChartData.Workbook;
|
|
92
|
+
dynamic ws = wb.Worksheets[1];
|
|
93
|
+
|
|
94
|
+
// Update values (row 2 = first data row)
|
|
95
|
+
ws.Cells[2, 2].Value = 150; // Column B
|
|
96
|
+
ws.Cells[2, 3].Value = 200; // Column C
|
|
97
|
+
|
|
98
|
+
shape.Chart.Refresh();
|
|
99
|
+
break;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
return "Chart data updated";
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Format All Titles
|
|
106
|
+
|
|
107
|
+
```csharp
|
|
108
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
109
|
+
if (shape.HasTextFrame == MsoTriState.msoTrue) {
|
|
110
|
+
if (shape.Name.Contains("Title")) {
|
|
111
|
+
shape.TextFrame.TextRange.Font.Bold = MsoTriState.msoTrue;
|
|
112
|
+
shape.TextFrame.TextRange.Font.Size = 44;
|
|
113
|
+
shape.TextFrame.TextRange.Font.Color.RGB = 0x003366; // BGR format!
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
return "Titles formatted";
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Change Shape Position
|
|
121
|
+
|
|
122
|
+
```csharp
|
|
123
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
124
|
+
if (shape.Name == "Content Placeholder 2") {
|
|
125
|
+
shape.Left = 50; // Points from left
|
|
126
|
+
shape.Top = 100; // Points from top
|
|
127
|
+
shape.Width = 600; // Width in points
|
|
128
|
+
shape.Height = 400; // Height in points
|
|
129
|
+
break;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return "Shape repositioned";
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
### Apply Transition
|
|
136
|
+
|
|
137
|
+
```csharp
|
|
138
|
+
slide.SlideShowTransition.EntryEffect = PpEntryEffect.ppEffectFade;
|
|
139
|
+
slide.SlideShowTransition.Duration = 1.0f;
|
|
140
|
+
return "Transition applied";
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### Copy Shape to Another Slide
|
|
144
|
+
|
|
145
|
+
```csharp
|
|
146
|
+
dynamic sourceShape = null;
|
|
147
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
148
|
+
if (shape.Name == "Logo") {
|
|
149
|
+
sourceShape = shape;
|
|
150
|
+
break;
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
if (sourceShape != null) {
|
|
155
|
+
sourceShape.Copy();
|
|
156
|
+
dynamic targetSlide = presentation.Slides[2];
|
|
157
|
+
targetSlide.Shapes.Paste();
|
|
158
|
+
}
|
|
159
|
+
return "Shape copied";
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Color Handling
|
|
165
|
+
|
|
166
|
+
**PowerPoint uses BGR format, not RGB!**
|
|
167
|
+
|
|
168
|
+
```csharp
|
|
169
|
+
// Convert RGB to PowerPoint color
|
|
170
|
+
int red = 0x00;
|
|
171
|
+
int green = 0x33;
|
|
172
|
+
int blue = 0x66;
|
|
173
|
+
int bgrColor = blue << 16 | green << 8 | red; // 0x663300
|
|
174
|
+
|
|
175
|
+
shape.TextFrame.TextRange.Font.Color.RGB = bgrColor;
|
|
176
|
+
|
|
177
|
+
// Common colors in BGR:
|
|
178
|
+
// White: 0xFFFFFF
|
|
179
|
+
// Black: 0x000000
|
|
180
|
+
// Red: 0x0000FF (blue=0, green=0, red=255)
|
|
181
|
+
// Blue: 0xFF0000 (blue=255, green=0, red=0)
|
|
182
|
+
// Navy: 0x663300 (the 0x003366 you expect becomes 0x663300)
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
## Null/Error Handling
|
|
188
|
+
|
|
189
|
+
```csharp
|
|
190
|
+
foreach (dynamic shape in slide.Shapes) {
|
|
191
|
+
try {
|
|
192
|
+
if (shape.HasTextFrame == MsoTriState.msoTrue) {
|
|
193
|
+
var textRange = shape.TextFrame.TextRange;
|
|
194
|
+
if (textRange != null && !string.IsNullOrEmpty(textRange.Text)) {
|
|
195
|
+
// Process
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
} catch {
|
|
199
|
+
// Skip shapes that cause errors
|
|
200
|
+
continue;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
---
|
|
206
|
+
|
|
207
|
+
## Common Errors & Fixes
|
|
208
|
+
|
|
209
|
+
| Error | Cause | Fix |
|
|
210
|
+
|-------|-------|-----|
|
|
211
|
+
| Null reference | Reassigned global variable | Use `slide` or `presentation` directly |
|
|
212
|
+
| LINQ compilation | LINQ on COM collections | Use `foreach` loops instead |
|
|
213
|
+
| Color appears wrong | RGB vs BGR confusion | Swap red and blue bytes |
|
|
214
|
+
| Shape not found | Wrong shape name | Use exact name from analyze |
|
|
215
|
+
| Cast exception | Dynamic COM typing | Use `dynamic` type throughout |
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## Script Size Limits
|
|
220
|
+
|
|
221
|
+
- **MAX 150 lines** per script
|
|
222
|
+
- Keep scripts focused on single operations
|
|
223
|
+
- Split complex tasks into multiple script calls
|
|
224
|
+
- Prefer API endpoints when possible
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## MANDATORY: Health Check After Scripts
|
|
229
|
+
|
|
230
|
+
```json
|
|
231
|
+
// ALWAYS run health check after any script execution
|
|
232
|
+
endpoint: "/ppt/review-slides"
|
|
233
|
+
body: {
|
|
234
|
+
"filePath": "...",
|
|
235
|
+
"slideNumbers": [1] // Slides affected by script
|
|
236
|
+
}
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
Scripts can introduce issues that only the health check detects. Never skip this step!
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# create-with-theme.ps1
|
|
2
|
+
# Creates a new PowerPoint presentation with a custom theme applied
|
|
3
|
+
# This ensures all slide layouts from the theme are available
|
|
4
|
+
#
|
|
5
|
+
# The presentation is created WITHOUT a document window, so nothing appears on screen.
|
|
6
|
+
# PowerPoint rejects Application.Visible = msoFalse, so windowlessness has to come from
|
|
7
|
+
# Presentations.Add(WithWindow:=msoFalse) instead.
|
|
8
|
+
|
|
9
|
+
param(
|
|
10
|
+
[Parameter(Mandatory=$true)]
|
|
11
|
+
[string]$FilePath,
|
|
12
|
+
|
|
13
|
+
[Parameter(Mandatory=$true)]
|
|
14
|
+
[string]$ThemePath
|
|
15
|
+
)
|
|
16
|
+
|
|
17
|
+
$msoFalse = 0
|
|
18
|
+
$ppSaveAsOpenXMLPresentation = 24
|
|
19
|
+
$ppAlertsNone = 1
|
|
20
|
+
|
|
21
|
+
$ppt = $null
|
|
22
|
+
$presentation = $null
|
|
23
|
+
$priorDisplayAlerts = $null
|
|
24
|
+
|
|
25
|
+
try {
|
|
26
|
+
# Validate theme file exists
|
|
27
|
+
if (-not (Test-Path $ThemePath)) {
|
|
28
|
+
Write-Output ('{"success": false, "error": "Theme file not found: ' + $ThemePath.Replace('\', '\\') + '"}')
|
|
29
|
+
exit 1
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
# Start PowerPoint. Attaching to a running instance keeps us from spawning a second one.
|
|
33
|
+
try {
|
|
34
|
+
$ppt = [Runtime.InteropServices.Marshal]::GetActiveObject('PowerPoint.Application')
|
|
35
|
+
} catch {
|
|
36
|
+
$ppt = New-Object -ComObject PowerPoint.Application
|
|
37
|
+
}
|
|
38
|
+
# Suppress alerts for this script only. The instance may be the user's, so the previous value is
|
|
39
|
+
# captured and restored in finally rather than left switched off for their later interactive work.
|
|
40
|
+
try {
|
|
41
|
+
$priorDisplayAlerts = $ppt.DisplayAlerts
|
|
42
|
+
$ppt.DisplayAlerts = $ppAlertsNone
|
|
43
|
+
} catch { }
|
|
44
|
+
|
|
45
|
+
# Windowless: nothing is shown to the user.
|
|
46
|
+
$presentation = $ppt.Presentations.Add($msoFalse)
|
|
47
|
+
|
|
48
|
+
# Apply the theme - this brings all the slide layouts
|
|
49
|
+
$presentation.ApplyTheme($ThemePath)
|
|
50
|
+
|
|
51
|
+
# Get the directory and ensure it exists
|
|
52
|
+
$directory = [System.IO.Path]::GetDirectoryName($FilePath)
|
|
53
|
+
if (-not (Test-Path $directory)) {
|
|
54
|
+
New-Item -ItemType Directory -Path $directory -Force | Out-Null
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
# Save the presentation
|
|
58
|
+
$presentation.SaveAs($FilePath, $ppSaveAsOpenXMLPresentation)
|
|
59
|
+
|
|
60
|
+
# Get slide layout count to verify theme was applied
|
|
61
|
+
# Use Designs collection (not SlideMasters) to properly count layouts
|
|
62
|
+
$layoutCount = 0
|
|
63
|
+
foreach ($design in $presentation.Designs) {
|
|
64
|
+
$layoutCount += $design.SlideMaster.CustomLayouts.Count
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
Write-Output ('{"success": true, "filePath": "' + $FilePath.Replace('\', '\\') + '", "layoutCount": ' + $layoutCount + '}')
|
|
68
|
+
|
|
69
|
+
} catch {
|
|
70
|
+
Write-Output ('{"success": false, "error": "' + $_.Exception.Message.Replace('"', '\"').Replace('\', '\\') + '"}')
|
|
71
|
+
exit 1
|
|
72
|
+
} finally {
|
|
73
|
+
# Release the deck so it does not linger in the shared PowerPoint instance. Application.Quit
|
|
74
|
+
# is deliberately not called: the instance may belong to the user or to the interop service.
|
|
75
|
+
if ($null -ne $presentation) {
|
|
76
|
+
try { $presentation.Close() } catch { }
|
|
77
|
+
}
|
|
78
|
+
if ($null -ne $ppt -and $null -ne $priorDisplayAlerts) {
|
|
79
|
+
try { $ppt.DisplayAlerts = $priorDisplayAlerts } catch { }
|
|
80
|
+
}
|
|
81
|
+
}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: project-task-list
|
|
3
|
+
description: "Inspect and update an owner's Markdown-backed task-list.md using TaskListPath, domain-supplied row semantics, the per-turn TaskList rollup (each stage's current and next row by id), and targeted file edits. Use when a session needs task list rows, answers, provenance, statuses, or readiness updates."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Project Task List
|
|
7
|
+
|
|
8
|
+
Use this skill when the session provides `TaskListPath` (project-bound or standalone) and task list content needs to be inspected, updated, or populated with domain rows.
|
|
9
|
+
|
|
10
|
+
## When To Use
|
|
11
|
+
|
|
12
|
+
Open a task list for multi-step work: 3 or more distinct steps, or work that spans turns. Each row is one task; its `stage` field names its stage by id. Write the rows before executing, then keep each row current — `in progress` when you start it, `confirmed` only when its outcome is verified. Single-step or question-only requests need no task list.
|
|
13
|
+
|
|
14
|
+
Stages are independent workstreams and may progress in parallel — delegated tasks complete on their own time. Task order inside a stage is presentation order, with one exception: a plan-seeded stage's tasks follow the plan's execution order. Never open a parallel stage for work an existing stage already tracks — work the existing tasks.
|
|
15
|
+
|
|
16
|
+
An approved plan seeds rows into the conversation list by default, or into the project list when the plan was approved at project level. It seeds one stage when the plan's work is one dependent line of steps, and several — one per plan stage, in the plan's order — when the plan declared parts that can proceed without waiting on each other. Those stages arrive already described; treat them as the plan's own split and do not merge or re-cut them.
|
|
17
|
+
|
|
18
|
+
## Source Of Truth
|
|
19
|
+
|
|
20
|
+
Up to two lists exist. `TaskListPath` / `TaskList` is the owner's list: the project's, or the session's when there is no project. `ConversationTaskListPath` / `ConversationTaskList` is this conversation's own list, present when one exists (a session in a project that also has conversation-scoped work). When a skill owns the project's list, `ConversationTaskListPath` is always present, and it is where every work row you open goes; the owning skill decides what enters the project's list.
|
|
21
|
+
|
|
22
|
+
Treat `TaskListPath`, and `ConversationTaskListPath` when present, as authoritative for their own list. Never copy rows between them — where the app offers it, the user promotes a stage from the conversation list to the project list; the model does not.
|
|
23
|
+
|
|
24
|
+
`TaskList` / `ConversationTaskList` are compact rollup context, refreshed every turn:
|
|
25
|
+
|
|
26
|
+
- `level` (`project` or `conversation`), `rollupLabel`, `readiness`, `itemCount`, `statusPresets` (labels to reuse), `statusCounts`.
|
|
27
|
+
- `stages`: one entry per stage with rows — `stage` (title), `stageId` (what a row's `stage` field holds), `progress` (`confirmed/total`), `current` (the row in progress: `id`, `title`), `next` (the first row with no status yet), `waitingOn` (unfinished stages it depends on), `updated` (who last changed the stage or one of its rows, and when). A row that depends on unconfirmed rows carries `waitsFor`. Rows outside any stage form an entry with no `stage`.
|
|
28
|
+
|
|
29
|
+
`stages` is your position: `current` is the row in hand, `next` the one after, and their ids are the ones you edit. Row bodies — description, answer, userNote, provenance — are not in the rollup. `next` ignores nothing you need for a status change, but it is orientation, not a work order: a row it names may still wait on `waitsFor`.
|
|
30
|
+
|
|
31
|
+
`TaskListRepair` is agent-only parser feedback. When it is present, read `TaskListPath` and repair the malformed rows silently with one `EditFile` before other task list work. Do not mention routine repairs to the user.
|
|
32
|
+
|
|
33
|
+
Everything below applies identically to whichever list the row belongs to: substitute `ConversationTaskListPath` / `ConversationTaskList` / `ConversationTaskListRepair` / `ConversationTaskListFile` for `TaskListPath` / `TaskList` / `TaskListRepair` / `TaskListFile` when the work is in the conversation list.
|
|
34
|
+
|
|
35
|
+
Never create `ba-task-list.md`.
|
|
36
|
+
|
|
37
|
+
## Read Discipline
|
|
38
|
+
|
|
39
|
+
The rollup already says where you are and which id to edit; do not read the file to find out.
|
|
40
|
+
|
|
41
|
+
When edits need exact text — a row's line, or its `task-record` for a description, answer, userNote or provenance edit — read the whole list with one `ReadFile` of `TaskListPath` before the first edit (`offset` and `limit` on a large one), however many rows the step changes. Never `Grep` the task list. One read per step: none between the edits, none after them.
|
|
42
|
+
|
|
43
|
+
- A task with a file keeps its details there: read that file too.
|
|
44
|
+
- If `TaskList` is missing, stale, or insufficient, use `TaskListPath` and file reads rather than guessing.
|
|
45
|
+
- `TaskListFile: does not exist yet` → no list has been written. Do not read `TaskListPath`; the Row-Building Workflow's `WriteFile` creates it.
|
|
46
|
+
|
|
47
|
+
## Markdown Format
|
|
48
|
+
|
|
49
|
+
Use top-level Markdown task rows. Do not create nested task rows.
|
|
50
|
+
|
|
51
|
+
Rows sit together, one line each. A task's details live in its `task-record` block under `## Task records`, fenced with the task's id; a task with nothing to record has none.
|
|
52
|
+
|
|
53
|
+
````md
|
|
54
|
+
- [ ] Walk me through the typical case. [id:: chk_123] [stage:: process_steps] [status:: sourced]
|
|
55
|
+
- [ ] Map the exceptions. [id:: chk_124] [stage:: process_steps] [status:: waiting on legal] [statusColor:: warning]
|
|
56
|
+
|
|
57
|
+
## Task records
|
|
58
|
+
|
|
59
|
+
```task-record chk_123
|
|
60
|
+
description: |
|
|
61
|
+
What this task covers, in one or two sentences.
|
|
62
|
+
answer: |
|
|
63
|
+
Intake -> validation -> approval.
|
|
64
|
+
userNote: |
|
|
65
|
+
The approval step is skipped for renewals.
|
|
66
|
+
provenance: |
|
|
67
|
+
wiki/as-is/overview.md
|
|
68
|
+
updatedBy: Delegate
|
|
69
|
+
updatedAt: 2026-09-25T14:03:00+03:00
|
|
70
|
+
```
|
|
71
|
+
````
|
|
72
|
+
|
|
73
|
+
Stages live in the frontmatter `stages:` list, in order. Each has an `id` — its title's words in lowercase, joined by `_`, fixed once written; rows name the stage by it — a `title` in sentence case (the panel prints it as written), an optional `description`, and, when it has to wait for other stages, a `dependsOn` list of their ids. For a stage you create, write one general sentence, ≤ 100 characters, no specifics, unless the domain skill supplies a different description policy.
|
|
74
|
+
|
|
75
|
+
The domain skill's description policy applies to both rows and stages during creation, rebuilds, and synchronization. Leave descriptions absent where that policy uses localized panel copy. Preserve existing row and stage descriptions, including in older projects; never add, rewrite, or remove them during status, answer, or provenance updates. A stored description takes precedence over localized panel copy.
|
|
76
|
+
|
|
77
|
+
```md
|
|
78
|
+
stages:
|
|
79
|
+
- id: process_steps
|
|
80
|
+
title: Process steps
|
|
81
|
+
description: The as-is flow, one task per step the business walks through.
|
|
82
|
+
updatedBy: Iulia Orvas
|
|
83
|
+
updatedAt: 2026-09-25T13:40:00+03:00
|
|
84
|
+
- id: gap_analysis
|
|
85
|
+
title: Gap analysis
|
|
86
|
+
description: Where the as-is flow breaks down.
|
|
87
|
+
dependsOn: process_steps
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
`dependsOn` says what must finish first, nothing more. A stage without it waits for nothing and can be started now; a stage with it stays blocked until every stage it names is done. Stages that do not name each other are independent — work them in any order, or in parallel.
|
|
91
|
+
|
|
92
|
+
Task row fields:
|
|
93
|
+
|
|
94
|
+
- `id`: stable row id. Create ids as `chk_<short_lowercase_slug>_<6-char-hex>` when adding rows (`chk_map_exceptions_3f9a1c`). `_` is the only separator in an id you create, task or stage — never `-`. Keep existing ids exactly as written, `-` included: a changed id cuts the row off from its `task-record`.
|
|
95
|
+
- `stage`: the id of the task's stage (optional grouping).
|
|
96
|
+
- `description`: one general sentence, ≤ 100 characters — what the task covers, in words a colleague scans. No paths, dates, ids, counts. Write it when you create the task; never rewrite it to change a status or answer (`answer` is the outcome). For a domain skill's seeded rows, follow its description policy. Detail lives in the plan or the wiki, never on the row.
|
|
97
|
+
- `status`: use existing vocabulary when possible; `pending` means no status.
|
|
98
|
+
- `statusColor`: one of `accent`, `warning`, `danger`, `success`, or `neutral` — only for a one-off status. `pending`, `in progress`, `confirmed` and every status preset bring their own color; a row with one of them names none.
|
|
99
|
+
- `sourceType`, `sourcePath`, `sourceSystem`, `sourceId`: where the task's details live when not in its `task-record` — see Task Files And External Records.
|
|
100
|
+
- `dependsOn`: optional, comma-separated `id`s of the tasks this one cannot start before. Omit it for a task that simply follows the one above — the row order already says that. Never point it at a task in a stage that this task's stage does not `dependsOn`.
|
|
101
|
+
- `answer`: one sentence, ≤ 160 characters — the outcome and where it is (a path or name). Longer content goes in a file that `provenance` names. Yours to write: the panel shows it read-only as your result; the user cannot edit it.
|
|
102
|
+
- `userNote`: what the user themselves said about this task, appended by the panel every time they send you input about it. Read it; never rewrite or delete it. It is their words, not yours, and it is the only record of them on the row.
|
|
103
|
+
- `provenance`: file path, source note, or pointer for where the answer is backed.
|
|
104
|
+
- `updatedBy` / `updatedAt`: who last changed the task, and when — the last two keys of its `task-record`. The app writes both, never you: a task your edit changed gets your product name once the edit lands, a change the user makes gets their name. A stage's `stages:` entry carries the same two keys; the panel shows a stage as last touched by whoever changed it or one of its rows most recently. A stamp that is not yours means the user touched the task since you last saw it.
|
|
105
|
+
|
|
106
|
+
A valid row has a non-empty title, exactly one non-empty `id`, no duplicate id elsewhere in the file, and only supported `statusColor` values. Its task has at most one closed `task-record`: keys at the left margin, a multiline value indented two spaces, each of `description`, `answer`, `userNote` and `provenance` at most once, then the app's stamps, and no other keys. Preserve well-formed unknown inline fields, but treat unknown keys inside a `task-record` as malformed.
|
|
107
|
+
|
|
108
|
+
## Task Files And External Records
|
|
109
|
+
|
|
110
|
+
A task's details live in its `task-record` unless its row says otherwise:
|
|
111
|
+
|
|
112
|
+
- `[sourceType:: path] [sourcePath:: tasks/<task id>.yaml]` — a file of its own in the `tasks/` folder beside `task-list.md`, for details that outgrow a few lines. The file holds the `task-record` keys (`description`, `answer`, `userNote`, `provenance`) at the left margin, multiline values indented two spaces, with no fence and no stamps: the stamps stay in the task's `task-record`. Write the file, then add the two fields to the row; details still in the `task-record` move into the file on the app's next write. From then on edit the file, never a copy in `task-list.md` — the app reads it every turn and stamps your edits to it. `sourcePath` names a file directly in `tasks/`, ending `.yaml`; the app refuses any other.
|
|
113
|
+
- `[sourceType:: external] [sourceSystem:: <system URL>] [sourceId:: <record id>]` — a record in another system, such as a Jira issue. Nothing reads or writes that system yet: add the link only when the user gives you one, and keep the details in the `task-record` as the local copy.
|
|
114
|
+
|
|
115
|
+
## Edit Discipline
|
|
116
|
+
|
|
117
|
+
Use `EditFile` for updates to an existing task list. Use `WriteFile` only for the row-building workflow below or when replacing a non-empty file with no recognized rows after reading it.
|
|
118
|
+
|
|
119
|
+
- A status change (pending → in progress → confirmed) edits the row's line: `old_content` runs from `[id:: …]` to `[status:: …]`, or to `[statusColor:: …]` when the row has one — unique in the file — and `new_content` is that span with the new status. The app sets the `[ ]` / `[x]` box from the status.
|
|
120
|
+
- A detail change (`description`, `answer`, `provenance`; `userNote` is the user's) edits the task's `task-record`: `old_content` is the key and its value (`answer: |` and the lines under it), never the stamps closing the block. A task without a record gets one: a new block right under `## Task records` (anchor on the heading line; no heading yet → add it after the last row).
|
|
121
|
+
- Several rows change in one step — the row you finished and the row you start, or every row a domain skill syncs after its writes — → one `EditFile` per run of neighbouring rows, plus one per changed record, all in one response, with no reads in between. Never rewrite the whole file to change a few rows.
|
|
122
|
+
- Stamps (`updatedBy` / `updatedAt` closing a `task-record`, and on a stage's `stages:` entry) are the app's: never write, change or remove one. The app stamps what you changed once the edit lands, which is why a detail edit stops before them.
|
|
123
|
+
- Adding rows to an existing list: one `EditFile` whose `old_content` is the row line the new rows follow and whose `new_content` is that line followed by the new rows, plus one adding their records under `## Task records`. A new stage is one `EditFile` on the frontmatter `stages:` list.
|
|
124
|
+
- A successful `EditFile` result is the verification — no verifying re-read. `TaskListRepair` catches drift on the next turn. If `EditFile` reports that `old_content` was not found or the file changed, `ReadFile` the list again and retry that one edit once; do not fall back to a whole-file rewrite.
|
|
125
|
+
|
|
126
|
+
Preserve unrelated content:
|
|
127
|
+
|
|
128
|
+
- existing `id`, `stage`, `description`, `status`, `statusColor`, `dependsOn`, `answer`, `userNote`, and `provenance` fields unless the change is intentional;
|
|
129
|
+
- status preset metadata and the `stages:` list in frontmatter (the list fixes stage existence and order; a stage without tasks lives only there);
|
|
130
|
+
- comments, unknown Markdown, unknown inline fields, and unrelated fenced blocks;
|
|
131
|
+
- task order and stage labels unless the user or caller asks to reorganize them.
|
|
132
|
+
|
|
133
|
+
## Row-Building Workflow
|
|
134
|
+
|
|
135
|
+
When the active domain does not declare a project-file template, or when a non-empty file has no recognized rows:
|
|
136
|
+
|
|
137
|
+
1. Build the task list rows from the active domain skill or user request.
|
|
138
|
+
2. Write one `task-list.md` with frontmatter listing each stage with its id and title, then the top-level task rows. Include one-sentence row and stage descriptions unless the domain skill's description policy leaves them absent. Add `## Task records` and a `task-record` only for tasks with a description, answer, or provenance to record.
|
|
139
|
+
3. Include stable ids on written rows.
|
|
140
|
+
4. Do not duplicate domain policy here; this skill owns only the generic file protocol.
|
|
141
|
+
|
|
142
|
+
## Working With The User On The Same List
|
|
143
|
+
|
|
144
|
+
The user works this list with you, and everything they do to it reaches you as a
|
|
145
|
+
message that names the row: they tick a box (plain lists) or confirm an answer
|
|
146
|
+
(answer-flow lists), and they send you input about a specific task or stage. They
|
|
147
|
+
cannot edit `answer` or write anything else on a row — what they have to say arrives
|
|
148
|
+
in the conversation, and the panel keeps a copy in the row's `userNote`.
|
|
149
|
+
|
|
150
|
+
- A task the user marked done is work **you did not do**. You know it happened; you
|
|
151
|
+
do not know what it produced. Ask them, with the question tool, before anything
|
|
152
|
+
downstream consumes it — "what did you find", "where did you put it", "which of
|
|
153
|
+
these did you pick". One question, about the thing you actually need.
|
|
154
|
+
- Do not re-run a task the user marked done, and do not treat it as unverified. They
|
|
155
|
+
did it; your part is to find out what came of it.
|
|
156
|
+
- An answer the user confirmed is your answer accepted as written. There is nothing
|
|
157
|
+
to ask about it; carry on. A row they reopened sends no message — you see it in the
|
|
158
|
+
rollup on your next turn.
|
|
159
|
+
- Input about a task you ran is a review, not a new instruction. Fix what they point
|
|
160
|
+
at, in that task, and say what changed. Do not restart the stage around it.
|
|
161
|
+
- Record the outcome of that exchange in the row's `answer`, and leave their
|
|
162
|
+
`userNote` untouched. If their input means the task is not done after all, move its
|
|
163
|
+
status back and say so.
|
|
164
|
+
- Their message interrupts a step in progress, so the transcript may stop mid-tool.
|
|
165
|
+
Pick up from what the list says, not from what you were about to do.
|
|
166
|
+
|
|
167
|
+
## Update Workflow
|
|
168
|
+
|
|
169
|
+
Every task list update runs these steps, including a domain skill's sync after its own writes: the domain skill says when to sync and what the rows say; this skill says how.
|
|
170
|
+
|
|
171
|
+
1. Finish the related project-file or wiki writes and collect every task list change they require.
|
|
172
|
+
2. Get every affected row's exact text before the first edit (Read Discipline): one `ReadFile` of the whole list.
|
|
173
|
+
3. Compute each affected row's final line and `task-record`. Set answer and provenance together when content was just captured into project files; leave `description` as written. Use status labels consistently with `TaskList.statusPresets` or frontmatter presets.
|
|
174
|
+
4. Apply one targeted `EditFile` per row, all in one response. The results are the verification; do not re-read.
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: slack-operation
|
|
3
|
+
friendly_name: Slack
|
|
4
|
+
icon: slack
|
|
5
|
+
color: "#E01E5A"
|
|
6
|
+
description: Slack automation using API (when connected) or desktop UI (when not connected).
|
|
7
|
+
type: skill
|
|
8
|
+
assets:
|
|
9
|
+
integration_services:
|
|
10
|
+
key: uipath-salesforce-slack
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Slack Operations
|
|
14
|
+
|
|
15
|
+
**API available** (Connection Details has `Connection ID` + `Element Instance ID`): Use `ExecuteSkillApi` with endpoints below. Pass `element_instance_id` and `connection_id` in `metadata` (not `body`).
|
|
16
|
+
|
|
17
|
+
**API not available** (NO Slack connection in Connection Details at all): Fallback to `AppAct`/`AppFind` desktop automation. See `ui/desktop-automation/GUIDE.md`. A ⚠️ limited connection is NOT "API not available" — the API is connected, only some scopes are missing; see the Limited connections rule and never use desktop automation as a scope workaround.
|
|
18
|
+
|
|
19
|
+
{ConnectionDetails}
|
|
20
|
+
|
|
21
|
+
## Endpoints
|
|
22
|
+
|
|
23
|
+
All use `ExecuteSkillApi`. Always pass `element_instance_id` + `connection_id` in `metadata`.
|
|
24
|
+
|
|
25
|
+
| Endpoint | Description | Body |
|
|
26
|
+
|----------|-------------|------|
|
|
27
|
+
| `/slack/send/message-to-channel` | Send message by channel name (resolves IDs) | `{"channel_name": "general", "text": "Hello!"}` |
|
|
28
|
+
| `/slack/upload/file-to-channel` | Upload file(s) by channel name (resolves IDs) | `{"channel_name": "general", "file_paths": ["/path/to/file.pdf"], "initial_comment": "Here's the file"}` |
|
|
29
|
+
| `/slack/send/direct-message` | Send text DM by user name (resolves IDs, text only — no files) | `{"user_name": "John Doe", "text": "Hi!"}` |
|
|
30
|
+
| `/slack/send/dm-by-email` | Send text DM by email (resolves IDs, text only — no files) | `{"email": "john@example.com", "text": "Hi!"}` |
|
|
31
|
+
| `/slack/upload/file-to-dm` | Upload file(s) to DM by user name (resolves IDs) | `{"user_name": "John Doe", "file_paths": ["/path/to/file.pdf"], "initial_comment": "Here's the file"}` |
|
|
32
|
+
| `/slack/react/to-message-in-channel` | Add reaction by channel name (resolves IDs) | `{"channel_name": "general", "timestamp": "1234567890.123456", "reaction": "thumbsup"}` |
|
|
33
|
+
| `/slack/read/channel-messages` | Read channel history by name (resolves IDs) | `{"channel_name": "general", "limit": 50}` |
|
|
34
|
+
| `/slack/list/channels` | List channels (cached, use `force_reload` for fresh) | `{"userChannelsOnly": true, "limit": 20}` |
|
|
35
|
+
| `/slack/search/channels` | Search by ID or name | `{"name": ["general", "random"], "maxResults": 5}` |
|
|
36
|
+
| `/slack/create/channel` | Create channel | `{"name": "my-channel", "is_private": false}` |
|
|
37
|
+
| `/slack/post/message` | Post message | `{"channel_id": "C123", "text": "Hello!"}` |
|
|
38
|
+
| `/slack/reply/thread` | Reply to thread | `{"channel_id": "C123", "thread_ts": "1234567890.123456", "text": "Reply"}` |
|
|
39
|
+
| `/slack/add/reaction` | Add emoji reaction | `{"channel_id": "C123", "timestamp": "1234567890.123456", "reaction": "thumbsup"}` |
|
|
40
|
+
| `/slack/get/messages` | Read channel history | `{"channel_id": "C123", "limit": 50}` |
|
|
41
|
+
| `/slack/search/messages` | Search messages | `{"query": "from:@john after:2024-01-01", "count": 20}` |
|
|
42
|
+
| `/slack/list/users` | List workspace users (cached, use `force_reload` for fresh) | `{"limit": 100}` |
|
|
43
|
+
| `/slack/search/users` | Search by ID, name, email | `{"name": ["John Doe"], "maxResults": 5}` |
|
|
44
|
+
| `/slack/get/user-profile` | Get user profile(s) | `{"user_ids": ["U123", "U456"]}` |
|
|
45
|
+
| `/slack/lookup/email` | Find user by email | `{"email": "john@example.com"}` |
|
|
46
|
+
| `/slack/open/dm` | Open DM or group DM | `{"user_ids": ["U123", "U456"]}` |
|
|
47
|
+
| `/slack/upload/file` | Upload and share files | `{"file_paths": ["/path/to/file.pdf"], "channels": ["C123"], "initial_comment": "Here's the file"}` |
|
|
48
|
+
| `/slack/list/files` | List (Read) files (by channel, user, type, date) | `{"channel": "C123", "types": "pdfs,images", "count": 20}` |
|
|
49
|
+
| `/slack/list/channel-files` | List (Read) files by channel name (resolves IDs) | `{"channel_name": "general", "types": "pdfs", "count": 20}` |
|
|
50
|
+
| `/slack/get/file-info` | Get file metadata and content (text files) | `{"file": "F0AKQS87MAN"}` |
|
|
51
|
+
| `/slack/get/file-content` | View file without saving: text inline, images as viewable image | `{"file": "F0AKQS87MAN"}` |
|
|
52
|
+
| `/slack/download/file` | Download file and save locally | `{"file": "F0AKQS87MAN", "save_path": "C:\\Users\\user\\Downloads\\report.pdf"}` |
|
|
53
|
+
|
|
54
|
+
## Call Format
|
|
55
|
+
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"endpoint": "/slack/post/message",
|
|
59
|
+
"body": {"channel_id": "C123", "text": "Hello"},
|
|
60
|
+
"metadata": {"element_instance_id": "<from table>", "connection_id": "<from table>"},
|
|
61
|
+
"toolName": "Send Slack Message",
|
|
62
|
+
"description": "Sending message to #general"
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Batch form — several operations in ONE call. `metadata` is a TOP-LEVEL sibling of `operations`, applied to all of them. (Consistent metadata nested inside items is auto-hoisted for compatibility; conflicting nested values are rejected. Top-level is the documented form.)
|
|
67
|
+
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"toolName": "Read Slack Channel",
|
|
71
|
+
"description": "Read messages and files from #general",
|
|
72
|
+
"metadata": {"element_instance_id": "<from table>", "connection_id": "<from table>"},
|
|
73
|
+
"operations": [
|
|
74
|
+
{"endpoint": "/slack/read/channel-messages", "body": {"channel_name": "general", "limit": 20}},
|
|
75
|
+
{"endpoint": "/slack/list/channel-files", "body": {"channel_name": "general", "count": 20}}
|
|
76
|
+
]
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Rules
|
|
81
|
+
|
|
82
|
+
- **Strip prefixes**: `#general` → `general`, `@john` → `john`. API uses plain names, not Slack-formatted names.
|
|
83
|
+
- **IDs required**: Most endpoints need IDs. Use `send/message-to-channel`, `upload/file-to-channel`, `read/channel-messages`, `send/direct-message`, `send/dm-by-email`, or `react/to-message-in-channel` to skip lookups.
|
|
84
|
+
- **Search arrays**: `"name": ["general"]`, `"email": ["john@co.com"]`.
|
|
85
|
+
- **Reading a file**: prefer `/slack/get/file-content` (inline, no disk). Use `/slack/download/file` only when the user wants a saved local copy.
|
|
86
|
+
- **Org-wide installs**: workspace `team_id` (`T...`) is auto-resolved (granted workspaces + user email match) and injected for workspace-scoped calls (list/search users + channels, search messages, list files, create channel). A `/slack/search/messages` query with a single `in:#channel` filter searches that channel's own workspace automatically once the channel cache has loaded (if such a search unexpectedly returns nothing, pass `team_id`). The Connection Details table's Workspace column shows each connection's default workspace. Optional `team_id` in body targets another granted workspace and skips auto-resolution; list granted workspaces via advanced-api `/auth.teams.list`.
|
|
87
|
+
- **Workspace stickiness**: once a workspace is chosen (user picked one, or you passed `team_id`), pass that same `team_id` on every workspace-scoped call for the rest of the task. Omitting it falls back to auto-resolution, which may target a different workspace and silently change result scope mid-task.
|
|
88
|
+
- **Limited connections (⚠️)**: a connection flagged ⚠️ in Connection Details is missing core read scopes — it was created outside Delegate against a Slack app without them. Prefer an unflagged connection automatically if one exists. Otherwise STOP before any operation that needs the missing scopes and ask the user to choose: (a) fix it — create a NEW Slack connection from Delegate (Add-ons & Integrations → Connections), then remove the limited one (re-authenticating does NOT upgrade scopes; the app binding is fixed at creation), or (b) continue with only the operations this token supports. NEVER fall back to desktop UI automation because a connection is limited — the API is connected; missing scopes are a consent problem, not an availability problem.
|
|
89
|
+
- **Ambiguous match (users or channels)**: If `/slack/search/users` or `/slack/search/channels` returns more than one result, STOP. Never auto-pick `[0]` or infer from conversational context (team, topic, title, "sales", "account", etc.) — names collide. Present the full candidate list with disambiguating fields (users: name, title, email; channels: name, id, purpose, is_private, member_count) and ask the user to pick. For users, prefer asking for an email and using `/slack/lookup/email`.
|
|
90
|
+
|
|
91
|
+
## Guides
|
|
92
|
+
|
|
93
|
+
- `api/send-message/GUIDE.md` — Post messages, reply to threads, add reactions
|
|
94
|
+
- `api/search-and-read/GUIDE.md` — Search messages, find channels/users, read history
|
|
95
|
+
- `api/share-files/GUIDE.md` — Upload documents, images, and reports
|
|
96
|
+
- `api/advanced-api/GUIDE.md` — Raw Slack API via `SendUiPathRequest` (for endpoints not listed above)
|
|
97
|
+
- `ui/desktop-automation/GUIDE.md` — Desktop UI fallback
|