@uipath/delegate-sdk 1.203.1 → 1.203.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +722 -0
- package/dist/skills/business-analysis/as-is-capture.md +440 -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 +215 -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 +81 -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,204 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: media-tools
|
|
3
|
+
friendly_name: Media Tools
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
description: "Edits local audio/video with ffmpeg/ffprobe (from PATH, else the build bundled in Delegate): trims/cuts clips, converts format or codec, compresses to a target file size, extracts audio, extracts frames, builds thumbnails or a contact sheet, makes GIFs, merges/concatenates clips, changes speed, resizes/scales, and burns in subtitles. Use when a task mentions cut, clip, trim, shorten, convert, compress, shrink, reduce size, rip audio, grab a frame or screenshot from a video, gif, stitch, join, concat, slow-mo, timelapse, rescale, or hardcode/burn captions on a media file. Input is a local file/resource path or a URL (download it first). Not for transcription (use transcribe-media) or recorded-task conversion."
|
|
6
|
+
icon: FaFilm
|
|
7
|
+
color: F97316
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Media Tools
|
|
11
|
+
|
|
12
|
+
Edits one media file with ffmpeg/ffprobe. Input: a local file/resource path, or a URL — download it first (seeking needs a local file). Not for transcription (use `transcribe-media`) or recorded-task conversion.
|
|
13
|
+
|
|
14
|
+
## Resolve the binaries
|
|
15
|
+
|
|
16
|
+
First action, before any recipe: read `references/resolve-binaries.md`, run its snippets, set `$FFMPEG`/`$FFPROBE`, and confirm `"$FFMPEG" -version` exits 0. Order, first hit wins: PATH → Delegate bundle → existing install → install (last, needs user consent).
|
|
17
|
+
|
|
18
|
+
## Run a recipe
|
|
19
|
+
|
|
20
|
+
Every recipe block below is tagged `usage`: an **argument template**, not a runnable command line. Never paste a recipe verbatim into a shell. Determine the OS first (win32 vs macOS) and run only that platform's invocation (below): take everything after `ffmpeg`/`ffprobe` in the recipe and feed it through the matching method. A bash recipe run in PowerShell (or vice-versa) hangs or errors.
|
|
21
|
+
|
|
22
|
+
Shared rules (both platforms):
|
|
23
|
+
- Prepend the resolved binary + `-nostdin` (recipes elide both): `"$FFMPEG" -nostdin <args>`. `-nostdin` goes before `-i` — without it ffmpeg inherits parent stdin and hangs to timeout. `ffprobe` skips `-nostdin`.
|
|
24
|
+
- Recipes show `libsvtav1` (bundled + most modern builds); with a full PATH ffmpeg prefer `-c:v libx264 -crf 20 -preset medium` (wider playback). Missing encoder (`Unknown encoder`) → check `ffmpeg -hide_banner -encoders`, pick an available one (codec rules below).
|
|
25
|
+
- Timeout: generous (max 600s). Re-encode of a source ≥ 60s → delegate to a subagent (Long re-encodes below), never one blocking call.
|
|
26
|
+
- Verify before reporting done: `ffprobe` reads the output, size > 0 (trims/concat: duration ≈ expected). Report output path + size.
|
|
27
|
+
|
|
28
|
+
### macOS invocation (`ExecuteBashCommand`)
|
|
29
|
+
|
|
30
|
+
Run recipe args nearly verbatim: `"$FFMPEG" -nostdin <args>` / `"$FFPROBE" <args>`. Some subagents omit the bash tool — then use `ExecuteOsaScript` (JXA): set `Application.currentApplication().includeStandardAdditions = true`, then `return Application.currentApplication().doShellScript("<pipeline>");` (single-quote the inner pipeline).
|
|
31
|
+
|
|
32
|
+
### Windows invocation (`ExecutePowershellCommand`)
|
|
33
|
+
|
|
34
|
+
Do NOT run bash recipe lines here. Never `& $FFMPEG` — bare-`&` native calls hang to timeout (exit -1). Wrap every recipe through this `Invoke-FF` helper (clean exit code, captured stderr, spaces handled):
|
|
35
|
+
|
|
36
|
+
```powershell
|
|
37
|
+
function Invoke-FF {
|
|
38
|
+
param([string]$Exe, [string[]]$FfArgs)
|
|
39
|
+
$q = $FfArgs | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"','\"') + '"' } else { $_ } }
|
|
40
|
+
$psi = New-Object System.Diagnostics.ProcessStartInfo
|
|
41
|
+
$psi.FileName = $Exe; $psi.Arguments = ($q -join ' ')
|
|
42
|
+
$psi.RedirectStandardOutput = $true; $psi.RedirectStandardError = $true; $psi.UseShellExecute = $false
|
|
43
|
+
$p = [System.Diagnostics.Process]::Start($psi)
|
|
44
|
+
# Drain BOTH streams concurrently. Sequential ReadToEnd() deadlocks: ffmpeg floods stderr with
|
|
45
|
+
# progress lines, fills the ~4KB pipe buffer, and blocks while the parent waits on stdout EOF.
|
|
46
|
+
$outTask = $p.StandardOutput.ReadToEndAsync()
|
|
47
|
+
$errTask = $p.StandardError.ReadToEndAsync()
|
|
48
|
+
$p.WaitForExit()
|
|
49
|
+
$out = $outTask.Result; $err = $errTask.Result
|
|
50
|
+
if ($p.ExitCode -ne 0) { throw "ffmpeg exit $($p.ExitCode): $err" }
|
|
51
|
+
$out.Trim()
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Pass a recipe's args (everything after `ffmpeg`/`ffprobe`) as array elements, unquoted — the helper quotes paths. `.ArgumentList` is unavailable in PowerShell 5.1; the `.Arguments` string + manual quoting is required.
|
|
56
|
+
```powershell
|
|
57
|
+
Invoke-FF $FFMPEG @("-nostdin","-i",$in,"-ss","00:01:30","-to","00:02:15","-c:v","libsvtav1","-crf","23","-preset","6","-c:a","aac",$out)
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Long re-encodes — delegate to a subagent
|
|
61
|
+
|
|
62
|
+
Trigger: any re-encode (anything not pure `-c copy`) of a source ≥ 60s (ffprobe) — compress, format/codec convert, gif, filtered concat, speed change, resize, subtitle burn-in. These outlast the 600s shell cap and give no feedback. Stream-copy ops (`-c copy` trim/convert/merge) stay fast: one blocking `Invoke-FF` call in the main loop, no subagent.
|
|
63
|
+
|
|
64
|
+
Don't encode in the main loop. Spawn an `Agent` (`agent_type: "general"`, `automation_mode: none`, `description: "Encode <op>"`) that owns the whole launch → poll → verify cycle and returns one line. Keeps polling off the main turn loop for every long re-encode — unconditional, no permission ask, no mode question.
|
|
65
|
+
|
|
66
|
+
Parent's job:
|
|
67
|
+
1. Get duration (ffprobe, below). Write a start line to the user: op + rough ETA (e.g. `Compressing ~10 min clip → ~100 MB…`). The subagent's per-poll percent streams to the user live from there.
|
|
68
|
+
2. Delegate via `Agent` (`agent_type: "general"`). The general agent inherits the parent's tools — including `Wait` (poll delays) and the shell tool (`ExecuteBashCommand` macOS / `ExecutePowershellCommand` Windows) — so no tool list is passed. Put in `prompt`, verbatim: the resolved `$FFMPEG`/`$FFPROBE` paths (so the subagent skips re-resolving); this skill's absolute `<skill-path>`; absolute input/output paths; the exact recipe args (everything after `ffmpeg`); the source duration in seconds; and the instruction to read and follow `<skill-path>/references/encode-runbook.md` (mint tmp → launch → poll → report → verify). The launch script mints its own unique scratch dir per job; concurrent jobs must target distinct output paths.
|
|
69
|
+
3. On return, relay the subagent's final line to the user (`Done → <path> (<size>)` or the ffmpeg error). Never just stop.
|
|
70
|
+
|
|
71
|
+
## Rules
|
|
72
|
+
|
|
73
|
+
- Quote every path. Never overwrite the source — write a new output; `-y` overwrites the output only.
|
|
74
|
+
- `in.mp4`/`out.mp4` in recipes are placeholders — substitute the actual input path and an output container that fits the user's request and the chosen codec. Don't default to `.mp4`: H.264/AV1 → `.mp4`/`.mkv`, VP9/Opus → `.webm`, audio-only → `.m4a`/`.mp3`. Input can be any container ffmpeg reads (`.mov`, `.mkv`, `.webm`, `.avi`, …).
|
|
75
|
+
- Prefer `-c copy` (stream-copy, no quality loss): container convert, keyframe-aligned trim, same-codec merge, stream extract. Cuts land on the nearest keyframe. If `-c copy` errors, re-encode.
|
|
76
|
+
- Re-encode only to change codec, apply a filter (`scale`/`subtitles`/`setpts`/gif), or cut frame-accurately.
|
|
77
|
+
- Pick the codec for the target. `libx264` (H.264, `-crf 20 -preset medium`, crf 0–51) is the most compatible default when the resolved ffmpeg has it (typical PATH builds). `libsvtav1` (AV1, `-crf 30 -preset 6`, crf 0–63) trades player support for smaller files. `-crf` lower = better/bigger. Audio: `aac`, `libmp3lame`, `libopus`.
|
|
78
|
+
- Bundled ffmpeg is the GPL-free build — no `libx264`/`libx265`. There use `libsvtav1`/`libaom-av1` (AV1), `libopenh264` (H.264, `-b:v` bitrate, no `-crf`), `libkvazaar` (H.265), or `libvpx-vp9` (VP9). AV1 in `.mp4` needs a modern player.
|
|
79
|
+
- Even dimensions required — use `-2` in scale filters.
|
|
80
|
+
|
|
81
|
+
## Duration (for size math)
|
|
82
|
+
|
|
83
|
+
```usage
|
|
84
|
+
ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 "in.mp4"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Trim / cut
|
|
88
|
+
|
|
89
|
+
```usage
|
|
90
|
+
ffmpeg -ss 00:01:30 -to 00:02:15 -i "in.mp4" -c copy "out.mp4" # keyframe-aligned
|
|
91
|
+
ffmpeg -i "in.mp4" -ss 00:01:30 -to 00:02:15 -c:v libsvtav1 -crf 23 -preset 6 -c:a aac "out.mp4" # frame-accurate
|
|
92
|
+
```
|
|
93
|
+
`-to` = absolute end time; use `-t <duration>` instead when the user gives start + length.
|
|
94
|
+
|
|
95
|
+
## Convert / remux
|
|
96
|
+
|
|
97
|
+
```usage
|
|
98
|
+
ffmpeg -i "in.mov" -c copy "out.mp4" # copy-through if codecs fit the container
|
|
99
|
+
ffmpeg -i "in.mkv" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac -b:a 192k "out.mp4" # re-encode if not
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## Compress to target size
|
|
103
|
+
|
|
104
|
+
1. Get duration (above). If no target size was given, ask the user for one.
|
|
105
|
+
2. `video_kbps = target_MB * 8192 / dur − audio_kbps` (audio ≈ 128). Leave ~2% container overhead. If `video_kbps` lands very low for the resolution (e.g. < ~500 at 1080p → heavy artifacts), downscale or drop fps first rather than starving bitrate.
|
|
106
|
+
3. Single-pass VBR at that bitrate, one launch:
|
|
107
|
+
```usage
|
|
108
|
+
ffmpeg -nostdin -y -i "in.mp4" -c:v libsvtav1 -b:v {video_kbps}k -preset 6 -c:a aac -b:a 128k "out.mp4"
|
|
109
|
+
```
|
|
110
|
+
With a full PATH ffmpeg use `-c:v libx264 -b:v {video_kbps}k -preset medium` instead (wider playback support).
|
|
111
|
+
4. Check output size. Over target → drop bitrate or resolution and repeat. Single-pass VBR misses the target more than fixed-quality, so expect an adjust pass.
|
|
112
|
+
5. If exact size isn't required, single-pass CRF is simplest: `-crf 30` (libsvtav1) / `-crf 23 -preset medium` (libx264). Quality-targeted, no size guarantee.
|
|
113
|
+
6. ≥ 60s source → run via the subagent runbook (one launch), not a blocking call.
|
|
114
|
+
|
|
115
|
+
## Extract audio
|
|
116
|
+
|
|
117
|
+
```usage
|
|
118
|
+
ffmpeg -i "in.mp4" -vn -c:a copy "out.m4a" # copy if the container accepts the codec
|
|
119
|
+
ffmpeg -i "in.mp4" -vn -q:a 2 "out.mp3" # re-encode
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Extract frames
|
|
123
|
+
|
|
124
|
+
```usage
|
|
125
|
+
ffmpeg -ss 00:00:42 -i "in.mp4" -frames:v 1 -q:v 2 "frame.png" # at timestamp
|
|
126
|
+
ffmpeg -i "in.mp4" -vf "fps=1/5" -q:v 2 "frame_%04d.png" # every 5s
|
|
127
|
+
ffmpeg -i "in.mp4" -vf "select='gt(scene,0.3)'" -vsync vfr -q:v 2 "scene_%04d.png" # on scene change
|
|
128
|
+
```
|
|
129
|
+
Omit the filter and it dumps every frame — avoid.
|
|
130
|
+
|
|
131
|
+
## Thumbnails / contact sheet
|
|
132
|
+
|
|
133
|
+
```usage
|
|
134
|
+
ffmpeg -i "in.mp4" -vf "thumbnail" -frames:v 1 "thumb.png"
|
|
135
|
+
ffmpeg -i "in.mp4" -vf "fps=1/10,scale=320:-1,tile=4x4" -frames:v 1 "sheet.png" # 4x4 grid
|
|
136
|
+
```
|
|
137
|
+
Contact sheets are for choosing between frames, not reading them. Read each chosen frame on its own at full size; crop at source resolution for small text.
|
|
138
|
+
|
|
139
|
+
## GIF
|
|
140
|
+
|
|
141
|
+
```usage
|
|
142
|
+
ffmpeg -ss 5 -t 4 -i "in.mp4" -vf "fps=12,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" -loop 0 "out.gif"
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
## Merge / concatenate
|
|
146
|
+
|
|
147
|
+
Same codec/resolution — concat demuxer, `list.txt` of `file 'a.mp4'` lines:
|
|
148
|
+
```usage
|
|
149
|
+
ffmpeg -f concat -safe 0 -i "list.txt" -c copy "out.mp4"
|
|
150
|
+
```
|
|
151
|
+
Mixed codecs/sizes — concat filter. Raw `[0:v][0:a][1:v]…concat` fails on differing dimensions/SAR/pixel-format; normalize each input first:
|
|
152
|
+
```usage
|
|
153
|
+
ffmpeg -i "a.mp4" -i "b.mp4" -filter_complex "[0:v]scale=1280:-2,setsar=1[v0];[1:v]scale=1280:-2,setsar=1[v1];[0:a]aresample=async=1[a0];[1:a]aresample=async=1[a1];[v0][a0][v1][a1]concat=n=2:v=1:a=1[v][a]" -map "[v]" -map "[a]" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4"
|
|
154
|
+
```
|
|
155
|
+
If any input has no audio, probe first (below) and drop the `[N:a]`/`aN` streams + set `a=0` — else the missing `[N:a]` errors.
|
|
156
|
+
|
|
157
|
+
## Change speed
|
|
158
|
+
|
|
159
|
+
setpts factor = 1/speed. `atempo` valid 0.5–2.0 (chain for more: `atempo=2.0,atempo=2.0` = 4x).
|
|
160
|
+
```usage
|
|
161
|
+
ffmpeg -i "in.mp4" -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4" # 2x, with audio
|
|
162
|
+
ffmpeg -i "in.mp4" -vf "setpts=0.5*PTS" -an -c:v libsvtav1 -crf 30 -preset 6 "out.mp4" # 2x, no audio
|
|
163
|
+
```
|
|
164
|
+
No-audio input: the `[0:a]` variant errors — probe streams first (below) and use the `-an` form.
|
|
165
|
+
|
|
166
|
+
## Resize / scale
|
|
167
|
+
|
|
168
|
+
```usage
|
|
169
|
+
ffmpeg -i "in.mp4" -vf "scale=1280:-2" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # to width, keep aspect
|
|
170
|
+
ffmpeg -i "in.mp4" -vf "scale='trunc(min(1920,iw)/2)*2':-2" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # downscale only if larger (trunc keeps width even)
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
## Burn in subtitles
|
|
174
|
+
|
|
175
|
+
The `subtitles`/`ass` filters need a real `.srt`/`.ass` file. If captions aren't supplied, `transcribe-media` produces Markdown chunks (`[mm:ss] text` lines, start-only timestamps) — not subtitle files. Convert first: write a `.srt` where each cue runs from its `[mm:ss]` to the next line's timestamp (last cue +~3s), with sequential numbering and `HH:MM:SS,mmm` times. Then burn in:
|
|
176
|
+
```usage
|
|
177
|
+
ffmpeg -i "in.mp4" -vf "subtitles=subs.srt" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4"
|
|
178
|
+
ffmpeg -i "in.mp4" -vf "ass=subs.ass" -c:v libsvtav1 -crf 30 -preset 6 -c:a copy "out.mp4" # styled
|
|
179
|
+
```
|
|
180
|
+
Windows: the `subtitles` filter reparses its arg, so colons/backslashes break. `cd` into the subtitle's folder and pass the bare filename, or escape: `subtitles='C\:/path/subs.srt'`.
|
|
181
|
+
|
|
182
|
+
## Troubleshooting
|
|
183
|
+
|
|
184
|
+
Match your symptom, apply the fix. First table applies everywhere; check the Windows table only on win32.
|
|
185
|
+
|
|
186
|
+
### All platforms
|
|
187
|
+
|
|
188
|
+
| Symptom | Cause | Fix |
|
|
189
|
+
|---------|-------|-----|
|
|
190
|
+
| `Unknown encoder 'libx264'` | bundled (GPL-free) build has no x264/x265 | Re-encode with `libsvtav1`; `libopenh264` for H.264 |
|
|
191
|
+
| Hangs immediately, no progress | ffmpeg blocked on inherited stdin | Add `-nostdin` before `-i` |
|
|
192
|
+
| Long encode killed at 600s / no feedback | encoded in the main loop over the shell cap | Delegate via `Agent` (`agent_type: general`) (Long re-encodes) |
|
|
193
|
+
| `-c copy` fails | codec/container mismatch | Re-encode with `libsvtav1` |
|
|
194
|
+
| Output not written / permission denied | target dir not writable | Write to a user dir (macOS `$TMPDIR`, Windows `$env:TEMP`), then move |
|
|
195
|
+
|
|
196
|
+
### Windows only
|
|
197
|
+
|
|
198
|
+
| Symptom | Cause | Fix |
|
|
199
|
+
|---------|-------|-----|
|
|
200
|
+
| Call hangs → exit -1 | bare `& $FFMPEG` under `ExecutePowershellCommand` | Invoke via `Invoke-FF` |
|
|
201
|
+
| Hangs only on long encodes | sequential `ReadToEnd()` deadlocks when ffmpeg fills the stderr pipe buffer | Use `Invoke-FF` — drains stdout+stderr concurrently via `ReadToEndAsync()` |
|
|
202
|
+
| Detached launch hangs / "fails to start" | child inherited the shell's stdout pipe, blocking the runner's read-to-EOF | Launch via `scripts/windows/ff-launch.ps1` (redirects all 3 std streams) |
|
|
203
|
+
| `.ps1` script won't run | PowerShell ExecutionPolicy | `Set-ExecutionPolicy Bypass -Scope Process -Force`, then re-invoke |
|
|
204
|
+
| Subtitle filter errors | `:`/`\` in path reparsed | `cd` to the subs folder, pass the bare filename |
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Encode runbook (subagent)
|
|
2
|
+
|
|
3
|
+
Followed by the `Agent` (`agent_type: general`) that owns one long re-encode. The parent passed you: `$FFMPEG`/`$FFPROBE`, this `<skill-path>`, absolute input/output paths, the recipe args (everything after `ffmpeg`), and the source duration in seconds. Run launch → poll → verify, reporting progress, then return one line.
|
|
4
|
+
|
|
5
|
+
Tools this runbook needs: `Wait` (poll delays) and the platform shell tool — `ExecuteBashCommand` on macOS, `ExecutePowershellCommand` on Windows. The general agent inherits these from the parent by default; `ReadFile` is auto-provided. If a launch/poll call fails because a tool isn't available, return one line reporting it — don't poll without `Wait` (no shell `sleep`).
|
|
6
|
+
|
|
7
|
+
`<skill-path>/scripts/macos/` (`.sh`) and `<skill-path>/scripts/windows/` (`.ps1`) hold the launch + poll scripts — use your platform's folder. `ff-launch` mints a fresh unique scratch dir per job (so concurrent encodes never collide on the fixed filenames `ffprog.txt`/`fferr.txt`/`ffpid.txt`) and prints it as `TMP=<dir>` on its first line. Capture that `<tmp>` — poll needs it, and each later command takes it literally. The launcher also adds `-nostdin -progress -stats_period` and redirects all three std streams under `<tmp>` (a detached child that inherits the shell's stdout/stderr pipe holds it open and hangs the call).
|
|
8
|
+
|
|
9
|
+
1. Launch detached (`auto` = mint the scratch dir), then read the printed `TMP=<dir>` into `<tmp>`:
|
|
10
|
+
- macOS: `bash "<skill-path>/scripts/macos/ff-launch.sh" auto "$FFMPEG" -y -i "in.mp4" -c:v libsvtav1 -crf 30 -preset 6 -c:a aac "out.mp4"`
|
|
11
|
+
- Windows (omit `-Tmp` to mint; build the arg array — array elements avoid the `-flag` param-collision):
|
|
12
|
+
```powershell
|
|
13
|
+
$ffArgs = @('-y','-i','in.mp4','-c:v','libsvtav1','-crf','30','-preset','6','-c:a','aac','out.mp4')
|
|
14
|
+
& "<skill-path>\scripts\windows\ff-launch.ps1" -Ffmpeg $FFMPEG -FfArgs $ffArgs
|
|
15
|
+
```
|
|
16
|
+
2. Loop: wait → poll → report. Don't tight-loop, and don't `sleep` in the shell — pause with the `Wait` tool, choosing `duration` (ms) yourself. Size it from the last poll: remaining ≈ (100 − pct) / pct × elapsed-so-far; wait ~half of that, clamped 5–300s. First wait ~5–10s so ffmpeg writes initial progress. Then poll once (`<tmp>` = the captured dir):
|
|
17
|
+
- macOS: `bash "<skill-path>/scripts/macos/ff-poll.sh" "<tmp>" <duration_s>`
|
|
18
|
+
- Windows: `& "<skill-path>\scripts\windows\ff-poll.ps1" -Tmp "<tmp>" -DurationSeconds <duration_s>`
|
|
19
|
+
After each poll, explicitly write the encoding progress as your message (`Encoding… 42%`). Subagent messages stream to the user live and your last message is forwarded to the parent, so stating the percent is what surfaces progress — the poll call is silent. Repeat until done.
|
|
20
|
+
3. `Starting...` = progress file still empty (first seconds) — `Wait` ~5s, re-poll. Stop when status is `end`; make your final message state completion.
|
|
21
|
+
4. Done = poll status `end` (or output stops growing) AND ffprobe reads the output (size > 0; for trims/concat, duration ≈ expected). Return `Done → <path> (<size>)`.
|
|
22
|
+
5. On failure (no `end`, non-empty `<tmp>/fferr.txt`) read `fferr.txt` and return the ffmpeg error. If a process lingers, kill the PID in `<tmp>/ffpid.txt`.
|
|
23
|
+
|
|
24
|
+
Windows: if PowerShell blocks the `.ps1` by ExecutionPolicy, run `Set-ExecutionPolicy Bypass -Scope Process -Force` once, then re-invoke.
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Resolve ffmpeg / ffprobe
|
|
2
|
+
|
|
3
|
+
Set `$FFMPEG` + `$FFPROBE` (Windows) or `FFMPEG` + `FFPROBE` (macOS) once, then reuse. Try strategies in order; first hit wins. `<skill-path>` = this skill's folder, from the enclosing `<skills_folder path>`.
|
|
4
|
+
|
|
5
|
+
Order: **PATH → bundle → machine → install**. Stop at the first that resolves. Install modifies the machine — last resort, needs user consent.
|
|
6
|
+
|
|
7
|
+
Verify any candidate before using it: `"$FFMPEG" -version` (exit 0). Derive ffprobe next to ffmpeg if not separately found.
|
|
8
|
+
|
|
9
|
+
## 1. PATH
|
|
10
|
+
|
|
11
|
+
Fastest. ffmpeg installed and on PATH.
|
|
12
|
+
|
|
13
|
+
```powershell
|
|
14
|
+
$FFMPEG = (Get-Command ffmpeg.exe -ErrorAction SilentlyContinue).Source
|
|
15
|
+
$FFPROBE = (Get-Command ffprobe.exe -ErrorAction SilentlyContinue).Source
|
|
16
|
+
```
|
|
17
|
+
```bash
|
|
18
|
+
FFMPEG="$(command -v ffmpeg)"
|
|
19
|
+
FFPROBE="$(command -v ffprobe)"
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## 2. Bundle (Delegate interop)
|
|
23
|
+
|
|
24
|
+
Delegate ships an ffmpeg build with its interop layer near this skill. Subpath varies — don't assume one; search recursively under an ancestor of the skill folder.
|
|
25
|
+
|
|
26
|
+
```powershell
|
|
27
|
+
$S = "<skill-path>"
|
|
28
|
+
$FFMPEG = Get-ChildItem -Path (Join-Path $S "..\..\..\..") -Recurse -File -Filter ffmpeg.exe -ErrorAction SilentlyContinue |
|
|
29
|
+
Select-Object -First 1 -ExpandProperty FullName
|
|
30
|
+
```
|
|
31
|
+
```bash
|
|
32
|
+
S="<skill-path>"
|
|
33
|
+
FFMPEG="$(find "$S/../../../.." -type f -name ffmpeg -perm -u+x 2>/dev/null | head -n1)"
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## 3. Resolve on machine
|
|
37
|
+
|
|
38
|
+
ffmpeg installed but not on PATH (common with winget/scoop/manual unzip). Search common install roots.
|
|
39
|
+
|
|
40
|
+
```powershell
|
|
41
|
+
$roots = @(
|
|
42
|
+
"$env:LOCALAPPDATA\Microsoft\WinGet\Packages", # winget
|
|
43
|
+
"$env:USERPROFILE\scoop\apps\ffmpeg", # scoop
|
|
44
|
+
"C:\ProgramData\chocolatey\lib\ffmpeg", # choco
|
|
45
|
+
"C:\ffmpeg", $env:ProgramFiles, ${env:ProgramFiles(x86)}
|
|
46
|
+
) | Where-Object { $_ -and (Test-Path $_) }
|
|
47
|
+
$FFMPEG = $roots | ForEach-Object {
|
|
48
|
+
Get-ChildItem -Path $_ -Recurse -File -Filter ffmpeg.exe -ErrorAction SilentlyContinue
|
|
49
|
+
} | Select-Object -First 1 -ExpandProperty FullName
|
|
50
|
+
```
|
|
51
|
+
```bash
|
|
52
|
+
for c in /opt/homebrew/bin/ffmpeg /usr/local/bin/ffmpeg /usr/bin/ffmpeg; do
|
|
53
|
+
[ -x "$c" ] && FFMPEG="$c" && break
|
|
54
|
+
done
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## 4. Install (last resort, needs consent)
|
|
58
|
+
|
|
59
|
+
Adds ffmpeg to the machine. Confirm with the user first. Needs network; may need admin; slow — set a long timeout or run detached. After install, re-run strategy 1 or 3 (the current shell session may not see the new PATH).
|
|
60
|
+
|
|
61
|
+
```powershell
|
|
62
|
+
winget install --id Gyan.FFmpeg -e --accept-source-agreements --accept-package-agreements # or: choco install ffmpeg -y / scoop install ffmpeg
|
|
63
|
+
```
|
|
64
|
+
```bash
|
|
65
|
+
brew install ffmpeg # macOS
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Finalize
|
|
69
|
+
|
|
70
|
+
After a hit, normalize and derive ffprobe:
|
|
71
|
+
|
|
72
|
+
```powershell
|
|
73
|
+
if (-not $FFMPEG) { throw "ffmpeg not resolved (PATH/bundle/machine/install all failed)" }
|
|
74
|
+
$FFMPEG = (Resolve-Path $FFMPEG).Path
|
|
75
|
+
if (-not $FFPROBE) { $FFPROBE = $FFMPEG -replace 'ffmpeg\.exe$', 'ffprobe.exe' }
|
|
76
|
+
```
|
|
77
|
+
```bash
|
|
78
|
+
[ -n "$FFMPEG" ] || { echo "ffmpeg not resolved (PATH/bundle/machine/install all failed)" >&2; exit 1; }
|
|
79
|
+
FFMPEG="$(cd "$(dirname "$FFMPEG")" && pwd)/$(basename "$FFMPEG")"
|
|
80
|
+
[ -n "$FFPROBE" ] || FFPROBE="$(dirname "$FFMPEG")/ffprobe"
|
|
81
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Launch one ffmpeg encode detached with progress tracking (macOS/Linux).
|
|
3
|
+
# Usage: bash ff-launch.sh <tmpdir|auto> <ffmpeg> <ffmpeg-args...>
|
|
4
|
+
# arg1 = auto (or empty) -> mint a fresh unique scratch dir (new job).
|
|
5
|
+
# an existing dir -> use that caller-provided scratch dir.
|
|
6
|
+
# Prints "TMP=<dir>" first (capture it: poll needs it), then "launched pid N".
|
|
7
|
+
# Minting is atomic (mktemp -d), so concurrent encodes never collide on the fixed
|
|
8
|
+
# filenames ffprog.txt/fferr.txt/ffpid.txt. Poll with ff-poll.sh.
|
|
9
|
+
# All three std streams are redirected so the detached child holds no pipe open;
|
|
10
|
+
# an inherited pipe hangs the launching shell to its timeout. Stdin EOF (</dev/null)
|
|
11
|
+
# lets ffmpeg exit after the last frame instead of lingering.
|
|
12
|
+
set -u
|
|
13
|
+
tmp="$1"; ff="$2"; shift 2
|
|
14
|
+
if [ -z "$tmp" ] || [ "$tmp" = "auto" ]; then
|
|
15
|
+
tmp="$(mktemp -d "${TMPDIR:-/tmp}/media-XXXXXX")"
|
|
16
|
+
else
|
|
17
|
+
mkdir -p "$tmp"
|
|
18
|
+
fi
|
|
19
|
+
"$ff" -nostdin -progress "$tmp/ffprog.txt" -stats_period 5 "$@" </dev/null >/dev/null 2>"$tmp/fferr.txt" &
|
|
20
|
+
echo $! > "$tmp/ffpid.txt"
|
|
21
|
+
echo "TMP=$tmp"
|
|
22
|
+
echo "launched pid $(cat "$tmp/ffpid.txt")"
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Print encode progress as "NN% (status)" or "Starting..." (macOS/Linux).
|
|
3
|
+
# Usage: bash ff-poll.sh <tmpdir> <duration_seconds>
|
|
4
|
+
# Done when status is "end" (or the output file stops growing).
|
|
5
|
+
set -u
|
|
6
|
+
tmp="$1"; dur="$2"; prog="$tmp/ffprog.txt"
|
|
7
|
+
[ -f "$prog" ] || { echo "Starting..."; exit 0; }
|
|
8
|
+
# out_time_us on modern builds; fall back to out_time_ms (also microseconds on
|
|
9
|
+
# older builds despite the name) so progress isn't stuck at "Starting...".
|
|
10
|
+
awk -F= -v DUR="$dur" '/out_time_us=/{us=$2} /out_time_ms=/{ms=$2} /^progress/{st=$2} END{t=(us!=""&&us!="N/A")?us:ms; if(t!=""&&t!="N/A"&&DUR>0){printf "%.0f%% (%s)\n", t/1e6/DUR*100, st}else{print "Starting..."}}' "$prog"
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Launch one ffmpeg encode detached with progress tracking (Windows).
|
|
2
|
+
# Usage: & ff-launch.ps1 [-Tmp <dir>] -Ffmpeg <path> -FfArgs <string[]>
|
|
3
|
+
# -Tmp omitted -> mint a fresh unique scratch dir (new job).
|
|
4
|
+
# -Tmp <dir> -> use that caller-provided scratch dir.
|
|
5
|
+
# Prints "TMP=<dir>" first (capture it: poll needs it), then "launched pid N".
|
|
6
|
+
# A unique dir per job keeps concurrent encodes from colliding on the fixed
|
|
7
|
+
# filenames ffprog.txt/fferr.txt/ffpid.txt. Poll with ff-poll.ps1.
|
|
8
|
+
# Redirects all three std streams to files: a detached child that inherits the
|
|
9
|
+
# launching shell's stdout/stderr pipe holds it open and hangs the call to its timeout.
|
|
10
|
+
param([string]$Tmp, [string]$Ffmpeg, [string[]]$FfArgs)
|
|
11
|
+
if (-not $Ffmpeg -or -not $FfArgs) {
|
|
12
|
+
throw "usage: ff-launch.ps1 [-Tmp <dir>] -Ffmpeg <path> -FfArgs <string[]>"
|
|
13
|
+
}
|
|
14
|
+
if (-not $Tmp) {
|
|
15
|
+
$Tmp = Join-Path $env:TEMP ("media-" + [guid]::NewGuid().ToString('N').Substring(0, 8))
|
|
16
|
+
}
|
|
17
|
+
New-Item -ItemType Directory -Force $Tmp | Out-Null
|
|
18
|
+
$full = @('-nostdin', '-progress', "$Tmp\ffprog.txt", '-stats_period', '5') + $FfArgs
|
|
19
|
+
# .ArgumentList is unavailable in PowerShell 5.1; quote spaces/quotes manually.
|
|
20
|
+
$q = $full | ForEach-Object { if ($_ -match '[\s"]') { '"' + ($_ -replace '"', '\"') + '"' } else { $_ } }
|
|
21
|
+
New-Item -ItemType File "$Tmp\ffin.txt" -Force | Out-Null
|
|
22
|
+
$sp = @{
|
|
23
|
+
FilePath = $Ffmpeg
|
|
24
|
+
ArgumentList = ($q -join ' ')
|
|
25
|
+
NoNewWindow = $true
|
|
26
|
+
PassThru = $true
|
|
27
|
+
RedirectStandardInput = "$Tmp\ffin.txt"
|
|
28
|
+
RedirectStandardOutput = "$Tmp\ffout.txt"
|
|
29
|
+
RedirectStandardError = "$Tmp\fferr.txt"
|
|
30
|
+
}
|
|
31
|
+
$p = Start-Process @sp
|
|
32
|
+
$p.Id | Set-Content "$Tmp\ffpid.txt"
|
|
33
|
+
"TMP=$Tmp"
|
|
34
|
+
"launched pid $($p.Id)"
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Print encode progress as "NN% (status)" or "Starting..." (Windows).
|
|
2
|
+
# Usage: & ff-poll.ps1 -Tmp <dir> -DurationSeconds <n>
|
|
3
|
+
# Done when status is "end" (or the output file stops growing).
|
|
4
|
+
param([string]$Tmp, [double]$DurationSeconds)
|
|
5
|
+
if (-not $Tmp -or $DurationSeconds -le 0) {
|
|
6
|
+
throw "usage: ff-poll.ps1 -Tmp <dir> -DurationSeconds <n>"
|
|
7
|
+
}
|
|
8
|
+
$prog = "$Tmp\ffprog.txt"
|
|
9
|
+
if (-not (Test-Path $prog)) { 'Starting...'; return }
|
|
10
|
+
$t = Get-Content $prog -Tail 20
|
|
11
|
+
# out_time_us on modern builds; fall back to out_time_ms (also microseconds on
|
|
12
|
+
# older builds despite the name) so progress isn't stuck at "Starting...".
|
|
13
|
+
$m = ($t | Select-String 'out_time_us=(\d+)' | Select-Object -Last 1)
|
|
14
|
+
if (-not $m) { $m = ($t | Select-String 'out_time_ms=(\d+)' | Select-Object -Last 1) }
|
|
15
|
+
# File exists but no out_time line yet (empty / partially written): not started.
|
|
16
|
+
if (-not $m) { 'Starting...'; return }
|
|
17
|
+
$us = [double]$m.Matches.Groups[1].Value
|
|
18
|
+
$sm = ($t | Select-String 'progress=(\w+)' | Select-Object -Last 1)
|
|
19
|
+
$st = if ($sm) { $sm.Matches.Groups[1].Value } else { 'continue' }
|
|
20
|
+
if ($us -and $DurationSeconds -gt 0) { '{0:N0}% ({1})' -f (100 * $us / 1e6 / $DurationSeconds), $st } else { 'Starting...' }
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: office-download
|
|
3
|
+
friendly_name: Office Download
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
description: "Download Office documents (Excel, PowerPoint, Word) from URLs. Use instead of shell commands or DownloadFile."
|
|
6
|
+
icon: FaFileDownload
|
|
7
|
+
color: D83B01
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Office Download
|
|
11
|
+
|
|
12
|
+
Download and open Office documents via **ExecuteSkillApi** endpoint on the local interop service.
|
|
13
|
+
|
|
14
|
+
**Platform:** Windows only. Requires Microsoft Office installed.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Quick Reference
|
|
19
|
+
|
|
20
|
+
| Task | Endpoint | Method | Platform |
|
|
21
|
+
|------|----------|--------|----------|
|
|
22
|
+
| Download Office document | `/office/download` | POST | Windows only |
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Endpoint
|
|
27
|
+
|
|
28
|
+
### Download Office Document — `/office/download`
|
|
29
|
+
|
|
30
|
+
Downloads an Office document from a URL, saves it locally, and optionally opens it in the corresponding Office application.
|
|
31
|
+
|
|
32
|
+
**Parameters:**
|
|
33
|
+
|
|
34
|
+
| Parameter | Type | Default | Description |
|
|
35
|
+
|-----------|------|---------|-------------|
|
|
36
|
+
| `url` | string | **required** | URL of the Office document (Google Drive, Dropbox, or direct link) |
|
|
37
|
+
| `localPath` | string | user's Downloads folder | Directory where the file should be saved |
|
|
38
|
+
| `filename` | string | extracted from URL | Custom filename (must include correct extension) |
|
|
39
|
+
| `openAfterDownload` | boolean | true | Whether to open the document after download |
|
|
40
|
+
| `fileType` | string | `"auto"` | File type hint: `auto`, `excel`, `powerpoint`, `word` |
|
|
41
|
+
| `visible` | boolean | false | Show the opened document to the user. Leave false when downloading in order to read a document; set true only when the user asked to see it. Honoured for PowerPoint and Excel, which open without a window by default. Word still opens visibly on this path regardless |
|
|
42
|
+
|
|
43
|
+
**Supported file types:**
|
|
44
|
+
- Excel: `.xlsx`, `.xls`
|
|
45
|
+
- PowerPoint: `.pptx`, `.ppt`
|
|
46
|
+
- Word: `.docx`, `.doc`
|
|
47
|
+
|
|
48
|
+
**Supported URL sources:**
|
|
49
|
+
- Google Drive links (`drive.google.com/file/d/...`)
|
|
50
|
+
- Dropbox links (`dropbox.com/...` — auto-converted to download format)
|
|
51
|
+
- Direct download links (`https://example.com/file.xlsx`)
|
|
52
|
+
|
|
53
|
+
**NOT supported by `/office/download`:**
|
|
54
|
+
- OneDrive/SharePoint sharing links — `/office/download` is plain HTTP and cannot authenticate, so SharePoint returns the HTML auth page instead of the file.
|
|
55
|
+
|
|
56
|
+
For SharePoint/OneDrive URLs, use `ms-{powerpoint|word|excel}:ofe|u|<original_url>` with the desktop app instead — desktop Office is signed into the user's Microsoft account and resolves sharing tokens through Microsoft's sharing service. See the SharePoint section in the relevant Office architect skill (`powerpoint-architect`, `word-architect`, `excel-architect`).
|
|
57
|
+
|
|
58
|
+
**Response fields:**
|
|
59
|
+
|
|
60
|
+
| Field | Type | Description |
|
|
61
|
+
|-------|------|-------------|
|
|
62
|
+
| `success` | boolean | Whether download succeeded |
|
|
63
|
+
| `error` | string | Error message if failed |
|
|
64
|
+
| `downloadedPath` | string | Local path where file was saved |
|
|
65
|
+
| `fileSize` | number | File size in bytes |
|
|
66
|
+
| `mimeType` | string | Detected MIME type |
|
|
67
|
+
| `fileType` | string | Detected type: `excel`, `powerpoint`, `word` |
|
|
68
|
+
| `isOpen` | boolean | Whether document was opened |
|
|
69
|
+
| `workbookId` | string | Excel: workbook ID |
|
|
70
|
+
| `sheets` | string[] | Excel: list of sheet names |
|
|
71
|
+
| `totalSlides` | number | PowerPoint: slide count |
|
|
72
|
+
| `documentId` | string | Word: document ID |
|
|
73
|
+
| `pageCount` | number | Word: page count |
|
|
74
|
+
| `wordCount` | number | Word: word count |
|
|
75
|
+
| `characterCount` | number | Word: character count |
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Examples
|
|
80
|
+
|
|
81
|
+
Download an Excel file to read it — opens without a window:
|
|
82
|
+
```json
|
|
83
|
+
{
|
|
84
|
+
"endpoint": "/office/download",
|
|
85
|
+
"body": {
|
|
86
|
+
"url": "https://example.com/report.xlsx",
|
|
87
|
+
"openAfterDownload": true
|
|
88
|
+
},
|
|
89
|
+
"toolName": "Download Excel",
|
|
90
|
+
"description": "Downloading Excel workbook from URL"
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Download an Excel file the user asked to *see* — add `visible`, or it opens hidden:
|
|
95
|
+
```json
|
|
96
|
+
{
|
|
97
|
+
"endpoint": "/office/download",
|
|
98
|
+
"body": {
|
|
99
|
+
"url": "https://example.com/report.xlsx",
|
|
100
|
+
"openAfterDownload": true,
|
|
101
|
+
"visible": true
|
|
102
|
+
},
|
|
103
|
+
"toolName": "Download Excel",
|
|
104
|
+
"description": "Downloading Excel workbook and showing it to the user"
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Download a PowerPoint to a specific folder:
|
|
109
|
+
```json
|
|
110
|
+
{
|
|
111
|
+
"endpoint": "/office/download",
|
|
112
|
+
"body": {
|
|
113
|
+
"url": "https://drive.google.com/file/d/abc123/view",
|
|
114
|
+
"localPath": "C:\\Users\\user\\Documents",
|
|
115
|
+
"fileType": "powerpoint",
|
|
116
|
+
"openAfterDownload": true
|
|
117
|
+
},
|
|
118
|
+
"toolName": "Download Presentation",
|
|
119
|
+
"description": "Downloading PowerPoint from Google Drive"
|
|
120
|
+
}
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Download a Word document without opening:
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"endpoint": "/office/download",
|
|
127
|
+
"body": {
|
|
128
|
+
"url": "https://www.dropbox.com/s/xyz/contract.docx?dl=0",
|
|
129
|
+
"openAfterDownload": false
|
|
130
|
+
},
|
|
131
|
+
"toolName": "Download Document",
|
|
132
|
+
"description": "Downloading Word document from Dropbox"
|
|
133
|
+
}
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Download with custom filename:
|
|
137
|
+
```json
|
|
138
|
+
{
|
|
139
|
+
"endpoint": "/office/download",
|
|
140
|
+
"body": {
|
|
141
|
+
"url": "https://example.com/download?id=123",
|
|
142
|
+
"filename": "Q4_Report.xlsx",
|
|
143
|
+
"fileType": "excel"
|
|
144
|
+
},
|
|
145
|
+
"toolName": "Download Report",
|
|
146
|
+
"description": "Downloading and renaming Excel report"
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Workflow
|
|
153
|
+
|
|
154
|
+
### Download and Edit Office Document
|
|
155
|
+
```
|
|
156
|
+
1. /office/download → download and open the file
|
|
157
|
+
2. Use returned workbookId/documentId with Excel/Word/PowerPoint tools
|
|
158
|
+
3. For Excel: use ExcelReadRange, ExcelWriteRange, etc.
|
|
159
|
+
4. For PowerPoint: use PptInsertSlide, PptAddText, etc.
|
|
160
|
+
5. For Word: use WordSelect, WordAppendText, etc.
|
|
161
|
+
```
|