alran 0.0.0-stage → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,468 @@
1
+ #!/usr/bin/env python3
2
+ """Extract review comments (annotations) from PPTX files.
3
+
4
+ Parses the Open XML package directly using zipfile + ElementTree.
5
+ Phase 1: classic comments support.
6
+
7
+ Usage:
8
+ python extract_comments.py <path_to_pptx>
9
+ python extract_comments.py <path_to_pptx> --slides 1,3,5
10
+ python extract_comments.py <path_to_pptx> --range 2-4
11
+ python extract_comments.py <path_to_pptx> --search "keyword" [--ignore-case]
12
+ python extract_comments.py <path_to_pptx> --format json
13
+
14
+ Works with Python >= 3.7, zero external dependencies.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ import argparse
20
+ import json
21
+ import posixpath
22
+ import re
23
+ import sys
24
+ import zipfile
25
+ import xml.etree.ElementTree as ET
26
+ from dataclasses import dataclass, asdict
27
+
28
+
29
+ # ---------------------------------------------------------------------------
30
+ # Data model
31
+ # ---------------------------------------------------------------------------
32
+
33
+ @dataclass
34
+ class CommentRecord:
35
+ slide_number: int
36
+ kind: str # "classic"
37
+ author_id: str | None
38
+ author_name: str | None
39
+ author_initials: str | None
40
+ created_at: str | None
41
+ comment_id: str | None
42
+ parent_id: str | None
43
+ text: str
44
+ part_name: str
45
+
46
+
47
+ # ---------------------------------------------------------------------------
48
+ # XML helpers
49
+ # ---------------------------------------------------------------------------
50
+
51
+ def local_name(tag: str) -> str:
52
+ """Strip namespace URI, returning only the local element name."""
53
+ if tag.startswith("{"):
54
+ return tag.split("}", 1)[1]
55
+ return tag
56
+
57
+
58
+ def find_children_by_local_name(elem: ET.Element, name: str) -> list[ET.Element]:
59
+ return [child for child in elem if local_name(child.tag) == name]
60
+
61
+
62
+ def first_child_text(elem: ET.Element, name: str) -> str | None:
63
+ for child in elem:
64
+ if local_name(child.tag) == name:
65
+ return (child.text or "").strip() or None
66
+ return None
67
+
68
+
69
+ def collect_all_text(elem: ET.Element) -> str:
70
+ """Recursively collect all text content under an element."""
71
+ parts: list[str] = []
72
+ if elem.text:
73
+ parts.append(elem.text)
74
+ for child in elem:
75
+ parts.append(collect_all_text(child))
76
+ if child.tail:
77
+ parts.append(child.tail)
78
+ return "".join(parts)
79
+
80
+
81
+ # ---------------------------------------------------------------------------
82
+ # Package reader
83
+ # ---------------------------------------------------------------------------
84
+
85
+ def read_xml(zf: zipfile.ZipFile, entry: str) -> ET.Element | None:
86
+ """Read and parse an XML entry from the ZIP, returning None on failure."""
87
+ try:
88
+ with zf.open(entry) as f:
89
+ return ET.parse(f).getroot()
90
+ except (KeyError, ET.ParseError) as exc:
91
+ print(f"Warning: could not parse {entry}: {exc}", file=sys.stderr)
92
+ return None
93
+
94
+
95
+ # ---------------------------------------------------------------------------
96
+ # Author lookup
97
+ # ---------------------------------------------------------------------------
98
+
99
+ def build_classic_author_map(
100
+ zf: zipfile.ZipFile,
101
+ ) -> dict[str, tuple[str | None, str | None]]:
102
+ """Return {authorId_str: (name, initials)} from ppt/commentAuthors.xml."""
103
+ author_map: dict[str, tuple[str | None, str | None]] = {}
104
+ root = read_xml(zf, "ppt/commentAuthors.xml")
105
+ if root is None:
106
+ return author_map
107
+ for child in root:
108
+ if local_name(child.tag) == "cmAuthor":
109
+ aid = child.get("id")
110
+ if aid is not None:
111
+ author_map[aid] = (child.get("name"), child.get("initials"))
112
+ return author_map
113
+
114
+
115
+ # ---------------------------------------------------------------------------
116
+ # Relationship resolver
117
+ # ---------------------------------------------------------------------------
118
+
119
+ # Relationship types that point to classic comment parts
120
+ _CLASSIC_COMMENT_REL_TYPES = {
121
+ "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
122
+ "http://schemas.microsoft.com/office/2011/relationships/comments",
123
+ }
124
+
125
+
126
+ def resolve_comment_parts(
127
+ zf: zipfile.ZipFile, slide_entry: str
128
+ ) -> list[tuple[str, str]]:
129
+ """Return [(resolved_part_path, rel_type)] for comment-related rels of a slide."""
130
+ rels_entry = (
131
+ posixpath.dirname(slide_entry)
132
+ + "/_rels/"
133
+ + posixpath.basename(slide_entry)
134
+ + ".rels"
135
+ )
136
+ root = read_xml(zf, rels_entry)
137
+ if root is None:
138
+ return []
139
+
140
+ results: list[tuple[str, str]] = []
141
+ for rel in root:
142
+ if local_name(rel.tag) != "Relationship":
143
+ continue
144
+ rel_type = rel.get("Type", "")
145
+ target = rel.get("Target", "")
146
+ if not target:
147
+ continue
148
+
149
+ is_comment_rel = any(rt in rel_type for rt in _CLASSIC_COMMENT_REL_TYPES)
150
+ if not is_comment_rel:
151
+ continue
152
+
153
+ # resolve relative target against slide directory
154
+ if not target.startswith("/"):
155
+ resolved = posixpath.normpath(
156
+ posixpath.join(posixpath.dirname(slide_entry), target)
157
+ )
158
+ else:
159
+ resolved = target.lstrip("/")
160
+
161
+ results.append((resolved, rel_type))
162
+
163
+ return results
164
+
165
+
166
+ # ---------------------------------------------------------------------------
167
+ # Classic comment parser
168
+ # ---------------------------------------------------------------------------
169
+
170
+ def parse_classic_comments(
171
+ zf: zipfile.ZipFile,
172
+ part_name: str,
173
+ slide_number: int,
174
+ author_map: dict[str, tuple[str | None, str | None]],
175
+ ) -> list[CommentRecord]:
176
+ root = read_xml(zf, part_name)
177
+ if root is None:
178
+ return []
179
+
180
+ records: list[CommentRecord] = []
181
+ for child in root:
182
+ if local_name(child.tag) != "cm":
183
+ continue
184
+
185
+ author_id = child.get("authorId")
186
+ author_name: str | None = None
187
+ author_initials: str | None = None
188
+ if author_id is not None and author_id in author_map:
189
+ author_name, author_initials = author_map[author_id]
190
+
191
+ # comment text lives in a <p:text> child (or similar local name "text")
192
+ text = first_child_text(child, "text")
193
+ if text is None:
194
+ # fallback: try collecting all text recursively
195
+ text = collect_all_text(child).strip()
196
+
197
+ records.append(
198
+ CommentRecord(
199
+ slide_number=slide_number,
200
+ kind="classic",
201
+ author_id=author_id,
202
+ author_name=author_name,
203
+ author_initials=author_initials,
204
+ created_at=child.get("dt"),
205
+ comment_id=child.get("idx"),
206
+ parent_id=None,
207
+ text=text,
208
+ part_name=part_name,
209
+ )
210
+ )
211
+ return records
212
+
213
+
214
+ # ---------------------------------------------------------------------------
215
+ # Slide enumeration
216
+ # ---------------------------------------------------------------------------
217
+
218
+ _SLIDE_ENTRY_RE = re.compile(r"^ppt/slides/slide(\d+)\.xml$")
219
+
220
+
221
+ def enumerate_slides(zf: zipfile.ZipFile) -> list[tuple[int, str]]:
222
+ """Return sorted [(slide_number, entry_path)] for all slides in the package."""
223
+ slides: list[tuple[int, str]] = []
224
+ for entry in zf.namelist():
225
+ m = _SLIDE_ENTRY_RE.match(entry)
226
+ if m:
227
+ slides.append((int(m.group(1)), entry))
228
+ slides.sort(key=lambda x: x[0])
229
+ return slides
230
+
231
+
232
+ # ---------------------------------------------------------------------------
233
+ # Main extraction
234
+ # ---------------------------------------------------------------------------
235
+
236
+ def extract_comments(pptx_path: str) -> list[CommentRecord]:
237
+ """Extract all classic comments from a PPTX file."""
238
+ with zipfile.ZipFile(pptx_path, "r") as zf:
239
+ author_map = build_classic_author_map(zf)
240
+ slides = enumerate_slides(zf)
241
+ all_records: list[CommentRecord] = []
242
+ for slide_number, slide_entry in slides:
243
+ comment_parts = resolve_comment_parts(zf, slide_entry)
244
+ for part_path, _rel_type in comment_parts:
245
+ records = parse_classic_comments(
246
+ zf, part_path, slide_number, author_map
247
+ )
248
+ all_records.extend(records)
249
+ return all_records
250
+
251
+
252
+ # ---------------------------------------------------------------------------
253
+ # Slide filtering
254
+ # ---------------------------------------------------------------------------
255
+
256
+ def parse_slide_numbers(raw: str) -> set[int]:
257
+ nums: set[int] = set()
258
+ for chunk in raw.split(","):
259
+ v = chunk.strip()
260
+ if not v:
261
+ continue
262
+ if not v.isdigit():
263
+ raise ValueError(
264
+ f'Invalid slide number "{v}". Use comma-separated positive integers.'
265
+ )
266
+ n = int(v)
267
+ if n < 1:
268
+ raise ValueError("Slide numbers must be >= 1.")
269
+ nums.add(n)
270
+ if not nums:
271
+ raise ValueError("At least one slide number must be provided.")
272
+ return nums
273
+
274
+
275
+ def parse_slide_range(raw: str) -> tuple[int, int]:
276
+ m = re.fullmatch(r"\s*(\d+)\s*-\s*(\d+)\s*", raw)
277
+ if not m:
278
+ raise ValueError('Invalid range format. Use "start-end", for example "2-4".')
279
+ start, end = int(m.group(1)), int(m.group(2))
280
+ if start < 1 or end < 1:
281
+ raise ValueError("Slide range values must be >= 1.")
282
+ if start > end:
283
+ raise ValueError("Slide range start must be <= end.")
284
+ return start, end
285
+
286
+
287
+ def filter_records(
288
+ records: list[CommentRecord],
289
+ selected_numbers: set[int] | None,
290
+ selected_range: tuple[int, int] | None,
291
+ search: str | None,
292
+ ignore_case: bool,
293
+ ) -> list[CommentRecord]:
294
+ filtered = records
295
+
296
+ if selected_numbers is not None:
297
+ filtered = [r for r in filtered if r.slide_number in selected_numbers]
298
+ elif selected_range is not None:
299
+ start, end = selected_range
300
+ filtered = [r for r in filtered if start <= r.slide_number <= end]
301
+
302
+ if search is not None:
303
+ if ignore_case:
304
+ q = search.casefold()
305
+ filtered = [r for r in filtered if q in r.text.casefold()]
306
+ else:
307
+ filtered = [r for r in filtered if search in r.text]
308
+
309
+ return filtered
310
+
311
+
312
+ # ---------------------------------------------------------------------------
313
+ # Formatters
314
+ # ---------------------------------------------------------------------------
315
+
316
+ def group_by_slide(
317
+ records: list[CommentRecord], include_empty: bool, total_slides: int
318
+ ) -> list[tuple[int, list[CommentRecord]]]:
319
+ """Group records by slide number; optionally include empty slides."""
320
+ from collections import OrderedDict
321
+
322
+ grouped: dict[int, list[CommentRecord]] = OrderedDict()
323
+ if include_empty:
324
+ for n in range(1, total_slides + 1):
325
+ grouped[n] = []
326
+ for r in records:
327
+ grouped.setdefault(r.slide_number, []).append(r)
328
+ return list(grouped.items())
329
+
330
+
331
+ def format_text(
332
+ records: list[CommentRecord], include_empty: bool, total_slides: int
333
+ ) -> str:
334
+ groups = group_by_slide(records, include_empty, total_slides)
335
+ if not groups:
336
+ return "No comments found."
337
+
338
+ lines: list[str] = []
339
+ for slide_num, comments in groups:
340
+ lines.append(f"=== Slide {slide_num} ===")
341
+ if not comments:
342
+ lines.append("(no comments)")
343
+ lines.append("")
344
+ continue
345
+ for c in comments:
346
+ author = c.author_name or c.author_id or "Unknown"
347
+ time_str = c.created_at or "unknown time"
348
+ idx_str = f"idx={c.comment_id}" if c.comment_id else ""
349
+ meta_parts = [author, time_str, c.kind]
350
+ if idx_str:
351
+ meta_parts.append(idx_str)
352
+ meta = " | ".join(meta_parts)
353
+ lines.append(f"- [{meta}]")
354
+ lines.append(f" {c.text}")
355
+ lines.append("")
356
+ return "\n".join(lines)
357
+
358
+
359
+ def format_json(
360
+ records: list[CommentRecord], include_empty: bool, total_slides: int
361
+ ) -> str:
362
+ groups = group_by_slide(records, include_empty, total_slides)
363
+ slides_out = []
364
+ for slide_num, comments in groups:
365
+ slide_obj: dict = {"slideNumber": slide_num, "comments": []}
366
+ for c in comments:
367
+ slide_obj["comments"].append(
368
+ {
369
+ "kind": c.kind,
370
+ "authorName": c.author_name,
371
+ "authorInitials": c.author_initials,
372
+ "createdAt": c.created_at,
373
+ "commentId": c.comment_id,
374
+ "text": c.text,
375
+ }
376
+ )
377
+ slides_out.append(slide_obj)
378
+ return json.dumps({"slides": slides_out}, ensure_ascii=False, indent=2)
379
+
380
+
381
+ # ---------------------------------------------------------------------------
382
+ # CLI
383
+ # ---------------------------------------------------------------------------
384
+
385
+ def parse_args() -> argparse.Namespace:
386
+ parser = argparse.ArgumentParser(
387
+ description="Extract review comments (annotations) from PPTX files."
388
+ )
389
+ parser.add_argument("pptx_path", help="Path to the PPTX file.")
390
+ selection = parser.add_mutually_exclusive_group()
391
+ selection.add_argument(
392
+ "--slides", help='Only inspect these slide numbers, e.g. "1,3,5".'
393
+ )
394
+ selection.add_argument(
395
+ "--range", dest="slide_range", help='Continuous slide range, e.g. "2-4".'
396
+ )
397
+ parser.add_argument(
398
+ "--search", help="Only show comments whose text matches this keyword."
399
+ )
400
+ parser.add_argument(
401
+ "--ignore-case", action="store_true", help="Make search case-insensitive."
402
+ )
403
+ parser.add_argument(
404
+ "--format",
405
+ choices=["text", "json"],
406
+ default="text",
407
+ help="Output format (default: text).",
408
+ )
409
+ parser.add_argument(
410
+ "--include-empty",
411
+ action="store_true",
412
+ help="Include slides that have no comments in the output.",
413
+ )
414
+ return parser.parse_args()
415
+
416
+
417
+ def main() -> int:
418
+ args = parse_args()
419
+
420
+ pptx_path = args.pptx_path
421
+
422
+ # validate file
423
+ try:
424
+ if not zipfile.is_zipfile(pptx_path):
425
+ print("Failed to inspect PPTX comments: not a valid ZIP/PPTX file.", file=sys.stderr)
426
+ return 1
427
+ except (OSError, FileNotFoundError) as exc:
428
+ print(f"Failed to inspect PPTX comments: {exc}", file=sys.stderr)
429
+ return 1
430
+
431
+ try:
432
+ records = extract_comments(pptx_path)
433
+ except Exception as exc:
434
+ print(f"Failed to inspect PPTX comments: {exc}", file=sys.stderr)
435
+ return 1
436
+
437
+ # determine total slide count for --include-empty
438
+ try:
439
+ with zipfile.ZipFile(pptx_path, "r") as zf:
440
+ total_slides = len(enumerate_slides(zf))
441
+ except Exception:
442
+ total_slides = max((r.slide_number for r in records), default=0)
443
+
444
+ # apply filters
445
+ try:
446
+ selected_numbers = parse_slide_numbers(args.slides) if args.slides else None
447
+ selected_range = (
448
+ parse_slide_range(args.slide_range) if args.slide_range else None
449
+ )
450
+ records = filter_records(
451
+ records, selected_numbers, selected_range, args.search, args.ignore_case
452
+ )
453
+ except ValueError as exc:
454
+ print(str(exc), file=sys.stderr)
455
+ return 1
456
+
457
+ # output
458
+ if args.format == "json":
459
+ print(format_json(records, args.include_empty, total_slides))
460
+ else:
461
+ output = format_text(records, args.include_empty, total_slides)
462
+ print(output)
463
+
464
+ return 0
465
+
466
+
467
+ if __name__ == "__main__":
468
+ raise SystemExit(main())
@@ -0,0 +1,226 @@
1
+ #!/usr/bin/env python3
2
+ """Extract images from a PPTX file with slide-level attribution.
3
+
4
+ Usage:
5
+ python extract_images.py presentation.pptx
6
+ python extract_images.py presentation.pptx --output-dir ./images
7
+ python extract_images.py presentation.pptx --slides 1,3,5
8
+ python extract_images.py presentation.pptx --range 2-4
9
+ python extract_images.py presentation.pptx --list-only
10
+
11
+ Requires: python-pptx (pip install python-pptx)
12
+ Works with Python >= 3.7.
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import os
19
+ import re
20
+ import sys
21
+ from dataclasses import dataclass
22
+
23
+ from pptx import Presentation
24
+ from pptx.enum.shapes import MSO_SHAPE_TYPE
25
+
26
+
27
+ @dataclass
28
+ class ImageInfo:
29
+ slide_number: int
30
+ shape_name: str
31
+ content_type: str
32
+ extension: str
33
+ width: int | None
34
+ height: int | None
35
+ blob: bytes
36
+
37
+
38
+ def extract_images_from_slide(slide, slide_number: int) -> list[ImageInfo]:
39
+ """Extract all images from a single slide, including grouped shapes."""
40
+ images: list[ImageInfo] = []
41
+
42
+ def process_shape(shape):
43
+ if shape.shape_type == MSO_SHAPE_TYPE.GROUP:
44
+ for child in shape.shapes:
45
+ process_shape(child)
46
+ return
47
+
48
+ if shape.shape_type == MSO_SHAPE_TYPE.PICTURE:
49
+ img = shape.image
50
+ images.append(
51
+ ImageInfo(
52
+ slide_number=slide_number,
53
+ shape_name=shape.name,
54
+ content_type=img.content_type,
55
+ extension=img.ext,
56
+ width=shape.width,
57
+ height=shape.height,
58
+ blob=img.blob,
59
+ )
60
+ )
61
+
62
+ for shape in slide.shapes:
63
+ process_shape(shape)
64
+
65
+ return images
66
+
67
+
68
+ def load_images(pptx_path: str) -> list[ImageInfo]:
69
+ presentation = Presentation(pptx_path)
70
+ all_images: list[ImageInfo] = []
71
+ for index, slide in enumerate(presentation.slides, 1):
72
+ all_images.extend(extract_images_from_slide(slide, index))
73
+ return all_images
74
+
75
+
76
+ def filter_by_slides(
77
+ images: list[ImageInfo], slide_numbers: set[int]
78
+ ) -> list[ImageInfo]:
79
+ return [img for img in images if img.slide_number in slide_numbers]
80
+
81
+
82
+ def filter_by_range(images: list[ImageInfo], start: int, end: int) -> list[ImageInfo]:
83
+ return [img for img in images if start <= img.slide_number <= end]
84
+
85
+
86
+ def parse_slide_numbers(raw_value: str) -> set[int]:
87
+ numbers: set[int] = set()
88
+ for chunk in raw_value.split(","):
89
+ value = chunk.strip()
90
+ if not value:
91
+ continue
92
+ if not value.isdigit():
93
+ raise ValueError(f'Invalid slide number "{value}".')
94
+ slide_number = int(value)
95
+ if slide_number < 1:
96
+ raise ValueError("Slide numbers must be >= 1.")
97
+ numbers.add(slide_number)
98
+ if not numbers:
99
+ raise ValueError("At least one slide number must be provided.")
100
+ return numbers
101
+
102
+
103
+ def parse_slide_range(raw_value: str) -> tuple[int, int]:
104
+ match = re.fullmatch(r"\s*(\d+)\s*-\s*(\d+)\s*", raw_value)
105
+ if not match:
106
+ raise ValueError('Invalid range format. Use "start-end", e.g. "2-4".')
107
+ start, end = int(match.group(1)), int(match.group(2))
108
+ if start < 1 or end < 1:
109
+ raise ValueError("Range values must be >= 1.")
110
+ if start > end:
111
+ raise ValueError("Range start must be <= end.")
112
+ return start, end
113
+
114
+
115
+ def emu_to_inches(emu: int | None) -> str:
116
+ if emu is None:
117
+ return "?"
118
+ return f"{emu / 914400:.1f}"
119
+
120
+
121
+ def print_image_list(images: list[ImageInfo]) -> None:
122
+ if not images:
123
+ print("No images found.")
124
+ return
125
+
126
+ for img in images:
127
+ width = emu_to_inches(img.width)
128
+ height = emu_to_inches(img.height)
129
+ size_kb = len(img.blob) / 1024
130
+ print(
131
+ f"Slide {img.slide_number:>3} | {img.shape_name:<30} | "
132
+ f"{img.content_type:<20} | {width}x{height} in | {size_kb:.0f} KB"
133
+ )
134
+
135
+ print(f"\nTotal: {len(images)} image(s)")
136
+
137
+
138
+ def save_images(images: list[ImageInfo], output_dir: str) -> None:
139
+ if not images:
140
+ print("No images found.")
141
+ return
142
+
143
+ os.makedirs(output_dir, exist_ok=True)
144
+ slide_counters: dict[int, int] = {}
145
+
146
+ for img in images:
147
+ count = slide_counters.get(img.slide_number, 0) + 1
148
+ slide_counters[img.slide_number] = count
149
+
150
+ safe_name = re.sub(r"[^\w\-.]", "_", img.shape_name)
151
+ filename = (
152
+ f"slide{img.slide_number:02d}_{count:02d}_{safe_name}.{img.extension}"
153
+ )
154
+ filepath = os.path.join(output_dir, filename)
155
+
156
+ with open(filepath, "wb") as file_obj:
157
+ file_obj.write(img.blob)
158
+
159
+ width = emu_to_inches(img.width)
160
+ height = emu_to_inches(img.height)
161
+ size_kb = len(img.blob) / 1024
162
+ print(f"Saved: {filename} ({width}x{height} in, {size_kb:.0f} KB)")
163
+
164
+ print(f"\n{len(images)} image(s) saved to {output_dir}/")
165
+
166
+
167
+ def parse_args() -> argparse.Namespace:
168
+ parser = argparse.ArgumentParser(
169
+ description="Extract images from a PPTX file with slide attribution."
170
+ )
171
+ parser.add_argument("pptx_path", help="Path to the PPTX file.")
172
+ parser.add_argument(
173
+ "--output-dir",
174
+ "-o",
175
+ default="./extracted_images",
176
+ help="Directory to save extracted images (default: ./extracted_images).",
177
+ )
178
+ selection = parser.add_mutually_exclusive_group()
179
+ selection.add_argument(
180
+ "--slides",
181
+ help='Only extract from these slides, e.g. "1,3,5".',
182
+ )
183
+ selection.add_argument(
184
+ "--range",
185
+ dest="slide_range",
186
+ help='Only extract from this slide range, e.g. "2-4".',
187
+ )
188
+ parser.add_argument(
189
+ "--list-only",
190
+ "-l",
191
+ action="store_true",
192
+ help="List images with metadata instead of saving them.",
193
+ )
194
+ return parser.parse_args()
195
+
196
+
197
+ def main() -> int:
198
+ args = parse_args()
199
+
200
+ try:
201
+ images = load_images(args.pptx_path)
202
+
203
+ if args.slides:
204
+ numbers = parse_slide_numbers(args.slides)
205
+ images = filter_by_slides(images, numbers)
206
+ elif args.slide_range:
207
+ start, end = parse_slide_range(args.slide_range)
208
+ images = filter_by_range(images, start, end)
209
+
210
+ if args.list_only:
211
+ print_image_list(images)
212
+ else:
213
+ save_images(images, args.output_dir)
214
+
215
+ except ValueError as error:
216
+ print(str(error), file=sys.stderr)
217
+ return 1
218
+ except Exception as error:
219
+ print(f"Failed to extract images: {error}", file=sys.stderr)
220
+ return 1
221
+
222
+ return 0
223
+
224
+
225
+ if __name__ == "__main__":
226
+ raise SystemExit(main())