alran 0.0.0-stage → 1.0.1

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 (505) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +75 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +284 -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 +64 -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-GW7N3MYC.js +2 -0
  363. package/chunks/anthropic-63VE6MAE.js +2 -0
  364. package/chunks/application-WPPTE6LU.js +2 -0
  365. package/chunks/auth-command-36RMNQZW.js +2 -0
  366. package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
  367. package/chunks/chunk-2AYWJZ72.js +2 -0
  368. package/chunks/chunk-2K5H5GA7.js +2 -0
  369. package/chunks/chunk-2TF6JAQM.js +2 -0
  370. package/chunks/chunk-3AODGLMF.js +2 -0
  371. package/chunks/chunk-3GGKARES.js +2 -0
  372. package/chunks/chunk-4CN3IJFH.js +2 -0
  373. package/chunks/chunk-4XP5XUIZ.js +2 -0
  374. package/chunks/chunk-5DQTVSQV.js +131 -0
  375. package/chunks/chunk-5RIMHTEU.js +207 -0
  376. package/chunks/chunk-5Y76VFHY.js +2 -0
  377. package/chunks/chunk-6DOVXX7W.js +2 -0
  378. package/chunks/chunk-6P4UKHGR.js +2 -0
  379. package/chunks/chunk-6PFI65C6.js +5 -0
  380. package/chunks/chunk-6UXSIWCB.js +2 -0
  381. package/chunks/chunk-7XYOYZX2.js +2 -0
  382. package/chunks/chunk-AGUSPIUP.js +2 -0
  383. package/chunks/chunk-BQ3CF3KE.js +2 -0
  384. package/chunks/chunk-C6LAAFG2.js +30 -0
  385. package/chunks/chunk-CUG7F2FN.js +2 -0
  386. package/chunks/chunk-D66ZSHXR.js +2 -0
  387. package/chunks/chunk-D7MGU75P.js +2 -0
  388. package/chunks/chunk-DFMYLGVU.js +249 -0
  389. package/chunks/chunk-EJN3SE5B.js +16 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-G5MOGPZ3.js +6711 -0
  392. package/chunks/chunk-GP52JZMY.js +2 -0
  393. package/chunks/chunk-HNWBFJNO.js +2 -0
  394. package/chunks/chunk-IC6A323Q.js +2 -0
  395. package/chunks/chunk-IN2Z5SSJ.js +164 -0
  396. package/chunks/chunk-JSTSFMGK.js +70 -0
  397. package/chunks/chunk-K5DTFR6D.js +29 -0
  398. package/chunks/chunk-LCC45PCZ.js +29 -0
  399. package/chunks/chunk-LU4RPLJ3.js +2 -0
  400. package/chunks/chunk-LZJYNT32.js +2 -0
  401. package/chunks/chunk-MACBL5HF.js +2 -0
  402. package/chunks/chunk-MPQ6G7LH.js +1085 -0
  403. package/chunks/chunk-MUXNNOSQ.js +3 -0
  404. package/chunks/chunk-N5NTXCJI.js +2 -0
  405. package/chunks/chunk-N6W7ZL26.js +2 -0
  406. package/chunks/chunk-NBONSNQZ.js +38 -0
  407. package/chunks/chunk-NMKRNU5O.js +2 -0
  408. package/chunks/chunk-NVPGGFT3.js +2 -0
  409. package/chunks/chunk-NZXJAHTO.js +9 -0
  410. package/chunks/chunk-OTDNOWXG.js +16 -0
  411. package/chunks/chunk-PCL2CVVE.js +2 -0
  412. package/chunks/chunk-PXH4SBCS.js +3 -0
  413. package/chunks/chunk-QKBN5CGI.js +2 -0
  414. package/chunks/chunk-QPGTKSIQ.js +2 -0
  415. package/chunks/chunk-R44C5DM6.js +2 -0
  416. package/chunks/chunk-RLJVY75P.js +28 -0
  417. package/chunks/chunk-RLND4AYL.js +4 -0
  418. package/chunks/chunk-SIOLUFGG.js +2 -0
  419. package/chunks/chunk-TJC4LPRQ.js +2 -0
  420. package/chunks/chunk-U3RMPDXU.js +2 -0
  421. package/chunks/chunk-U4PFHJ7Z.js +27 -0
  422. package/chunks/chunk-UJCAE7SG.js +3 -0
  423. package/chunks/chunk-V2SB4U4D.js +2 -0
  424. package/chunks/chunk-VGKKKM2W.js +6 -0
  425. package/chunks/chunk-VLXX22YO.js +2 -0
  426. package/chunks/chunk-VUISZDXX.js +24 -0
  427. package/chunks/chunk-W5ZOLW7T.js +2 -0
  428. package/chunks/chunk-WHD2XVT2.js +2 -0
  429. package/chunks/chunk-XLVABFJC.js +9 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-XSEU4WQD.js +7 -0
  432. package/chunks/chunk-XVGPB7TW.js +21 -0
  433. package/chunks/chunk-Z5HOCNTZ.js +2 -0
  434. package/chunks/chunk-ZDI22NOK.js +7 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  437. package/chunks/data-dir-OEPRRIOO.js +2 -0
  438. package/chunks/dist-VKYZJYR6.js +11 -0
  439. package/chunks/dist-WGTMUM3E.js +5 -0
  440. package/chunks/emscripten-module-3WGSFZYF.js +2 -0
  441. package/chunks/emscripten-module-74WUXTHL.js +2 -0
  442. package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
  443. package/chunks/emscripten-module-NEAT5LGD.js +2 -0
  444. package/chunks/ffi-EFLUAAVX.js +2 -0
  445. package/chunks/ffi-JIGPPPF7.js +2 -0
  446. package/chunks/ffi-QKKA5HYI.js +2 -0
  447. package/chunks/ffi-RLX77WFG.js +2 -0
  448. package/chunks/google-RCR46TTQ.js +2 -0
  449. package/chunks/google-vertex-Y26T7YYR.js +2 -0
  450. package/chunks/install-source-63OVVBMK.js +2 -0
  451. package/chunks/launcher-2UG3JPYF.js +63 -0
  452. package/chunks/lifecycle-5IPJRP2V.js +2 -0
  453. package/chunks/main-7SGOQBHZ.js +13 -0
  454. package/chunks/mistral-NEBDKUEI.js +3 -0
  455. package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
  456. package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
  457. package/chunks/multipart-parser-JVSLI2CL.js +2 -0
  458. package/chunks/network-proxy-AJO7ZW3O.js +2 -0
  459. package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
  460. package/chunks/openai-completions-C4PHW6MD.js +2 -0
  461. package/chunks/openai-responses-5NVFOW4Y.js +2 -0
  462. package/chunks/openrouter-BKUGQT7Z.js +2 -0
  463. package/chunks/otel-DRJM2PIX.js +2 -0
  464. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  465. package/chunks/pdfjs-2UOWBGC2.js +107 -0
  466. package/chunks/photon_rs-MVWYTYTO.js +3 -0
  467. package/chunks/plugin-command-CIDTOPNB.js +2 -0
  468. package/chunks/provider-command-UZ7KQFAC.js +2 -0
  469. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  470. package/chunks/run-acp-command-AKDLHKMR.js +59 -0
  471. package/chunks/run-exec-command-UXTPS7LC.js +15 -0
  472. package/chunks/skills-command-57TF53NO.js +2 -0
  473. package/chunks/src-5PSNGHHD.js +2 -0
  474. package/chunks/src-YZ26EVSY.js +2 -0
  475. package/chunks/telemetry-3NXMCOVD.js +2 -0
  476. package/chunks/telemetry-command-CMDERYNN.js +5 -0
  477. package/chunks/tools-CRJR35HS.js +2 -0
  478. package/chunks/undici-O4OQVZ6I.js +2 -0
  479. package/chunks/update-ACFAGV6F.js +14 -0
  480. package/chunks/update-hint-ED7O67WU.js +3 -0
  481. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  482. package/cli.js +4 -0
  483. package/configs/data-minimal.yaml +50 -0
  484. package/embedded/alran-tools/cli.mjs +4957 -0
  485. package/embedded/alran-tools/manifest.json +25 -0
  486. package/emscripten-module.wasm +0 -0
  487. package/image-preview-worker.js +2 -0
  488. package/internal-bin/alran-tools +9 -0
  489. package/internal-bin/alran-tools.cmd +8 -0
  490. package/matrix-mcp-stdio.js +4 -0
  491. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  492. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  493. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  494. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  495. package/package.json +38 -4
  496. package/photon_rs_bg.wasm +0 -0
  497. package/quickjs-worker.js +152 -0
  498. package/vendor/java-proxy-agent/build.ts +97 -0
  499. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  500. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  501. package/vendor/seccomp/build.ts +74 -0
  502. package/vendor/seccomp/x64/apply-seccomp +0 -0
  503. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  504. package/vendor/srt-win/build.ts +40 -0
  505. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,473 @@
1
+ #!/usr/bin/env python3
2
+ """read_pdf_vision.py — image-vision PDF read via native Matrix tools.
3
+
4
+ Renders selected pages with pdf2image (poppler), stitches them vertically into
5
+ ≤ --max-bytes images (3 MB default; page-count uncapped), then sends each
6
+ chunk to the Matrix `images_understand` tool via the local runtime's HTTP API
7
+ (POST /alran/api/matrix/tool/call). Internal chunking is hidden from the caller —
8
+ just pick pages.
9
+
10
+ This is the only wrapped read script in pdf: vision needs page
11
+ rendering, byte-budget chunking, and HTTP plumbing that don't fit in a
12
+ cookbook recipe. Other read scenarios (text / tables / coordinates /
13
+ raster / decrypt / metadata) live as inline recipes in docs/read-guide.md.
14
+
15
+ Usage (run from the pdf skill root):
16
+ python3 -m scripts.read_pdf_vision --input file.pdf [--pages 1-20]
17
+ [--dpi 150] [--max-bytes 3000000]
18
+ [--prompt "..."] [--keep-tmp DIR]
19
+ [--json] [--max-stdout-bytes N]
20
+
21
+ Dependencies (all `pip3 install --user`):
22
+ - pdf2image (also needs `brew install poppler` for the pdftoppm backend)
23
+ - Pillow
24
+
25
+ Local runtime must be running with authenticated native Matrix tools; the script
26
+ reads __ALRAN_RUNTIME_PORT first, then the active Alran Code data directory's daemon.port file
27
+ name (fallback 5321).
28
+ """
29
+
30
+ from __future__ import annotations
31
+
32
+ import argparse
33
+ import base64
34
+ import io
35
+ import json
36
+ import os
37
+ import re
38
+ import shutil
39
+ import subprocess
40
+ import sys
41
+ import tempfile
42
+ import urllib.error
43
+ import urllib.request
44
+ from pathlib import Path
45
+
46
+ from scripts._pdf_read_lib import (
47
+ add_common_args,
48
+ cache_dir,
49
+ die,
50
+ emit,
51
+ format_pages,
52
+ info,
53
+ resolve_input_or_exit,
54
+ resolve_pages_or_exit,
55
+ to_ranges,
56
+ warn,
57
+ )
58
+
59
+ try:
60
+ from pdf2image import convert_from_path # type: ignore
61
+ except ImportError:
62
+ die("pdf2image not installed. Install: pip3 install --user pdf2image (and brew install poppler)")
63
+
64
+ try:
65
+ from PIL import Image # type: ignore
66
+ except ImportError:
67
+ die("Pillow not installed. Install: pip3 install --user pillow")
68
+
69
+ DEFAULT_DPI = 150
70
+ FALLBACK_DPI = 100
71
+ DEFAULT_MAX_BYTES = 3_000_000
72
+ DEFAULT_PROMPT = (
73
+ "请把这张图里的全部文字按阅读顺序输出,保留段落、列表、表格等结构。"
74
+ "如有图表请简要描述。"
75
+ )
76
+ VISION_TOOL = "images_understand"
77
+ CALL_TIMEOUT_SEC = 1500
78
+
79
+
80
+ def _safe_tmp_root() -> Path:
81
+ env_tmp = os.environ.get("TMPDIR", "")
82
+ if env_tmp and not env_tmp.startswith("/tmp"):
83
+ return Path(env_tmp)
84
+ return cache_dir().parent # ~/.cache/alran/
85
+
86
+
87
+ def _runtime_port() -> int:
88
+ if env := os.environ.get("__ALRAN_RUNTIME_PORT"):
89
+ try:
90
+ return int(env)
91
+ except ValueError:
92
+ pass
93
+ data_dir = Path(
94
+ os.environ.get("__ALRAN_RUNTIME_DATA_DIR")
95
+ or os.environ.get("__ALRAN_PARENT_DATA_DIR")
96
+ or os.environ.get("ALRAN_DATA_DIR")
97
+ or str(Path.home() / ".alran")
98
+ )
99
+ port_file = data_dir / "daemon.port"
100
+ if port_file.is_file():
101
+ try:
102
+ return int(port_file.read_text(encoding="utf-8").strip())
103
+ except ValueError:
104
+ pass
105
+ return 5321
106
+
107
+
108
+ def _runtime_call_matrix_tool(tool: str, args: dict) -> dict:
109
+ url = f"http://127.0.0.1:{_runtime_port()}/alran/api/matrix/tool/call"
110
+ body = json.dumps(
111
+ {
112
+ "tool": tool,
113
+ "arguments": args,
114
+ }
115
+ ).encode("utf-8")
116
+ req = urllib.request.Request(
117
+ url,
118
+ data=body,
119
+ headers={"Content-Type": "application/json"},
120
+ method="POST",
121
+ )
122
+ try:
123
+ with urllib.request.urlopen(req, timeout=CALL_TIMEOUT_SEC) as resp:
124
+ return json.loads(resp.read().decode("utf-8"))
125
+ except urllib.error.HTTPError as e:
126
+ try:
127
+ payload = e.read().decode("utf-8", errors="ignore")
128
+ except Exception:
129
+ payload = ""
130
+ die(f"Local runtime error (HTTP {e.code}): {payload[:500]}")
131
+ except urllib.error.URLError as e:
132
+ die(
133
+ f"Cannot connect to local runtime at port {_runtime_port()}: {e.reason}. "
134
+ f"Restart the Alran Code app, or set __ALRAN_RUNTIME_PORT to the runtime port."
135
+ )
136
+
137
+
138
+ def _extract_envelope_text(tool_result: dict) -> tuple[str, bool]:
139
+ """matrix biz-gateway wraps the LLM output as a JSON envelope inside the
140
+ single text content item:
141
+ { code: 0, message: "ok", results: [{ description, success, error }, ...] }
142
+ Unwrap to per-image descriptions; fall back to raw text otherwise."""
143
+ if tool_result.get("success") is False:
144
+ return f"[error] {tool_result.get('error', 'local Matrix route failed')}", True
145
+
146
+ result = tool_result.get("result") if isinstance(tool_result.get("result"), dict) else tool_result
147
+ is_error = bool(result.get("isError"))
148
+ details = result.get("details") if isinstance(result.get("details"), dict) else {}
149
+ if details.get("ok") is False:
150
+ is_error = True
151
+
152
+ pieces: list[str] = []
153
+ for item in result.get("content") or []:
154
+ if item.get("type") != "text" or not isinstance(item.get("text"), str):
155
+ continue
156
+ raw = item["text"]
157
+ try:
158
+ env = json.loads(raw)
159
+ except (ValueError, TypeError):
160
+ pieces.append(raw)
161
+ continue
162
+ if not isinstance(env, dict) or not isinstance(env.get("results"), list):
163
+ pieces.append(raw)
164
+ continue
165
+ if env.get("code", 0) != 0:
166
+ pieces.append(f"[envelope code={env.get('code')} {env.get('message','')}] {raw}")
167
+ continue
168
+ for r in env["results"]:
169
+ if r.get("success") is False or (r.get("error") or ""):
170
+ pieces.append(f"[error] {r.get('error','unknown')}")
171
+ elif isinstance(r.get("description"), str):
172
+ pieces.append(r["description"])
173
+ if is_error and not pieces:
174
+ fallback = result.get("text") if isinstance(result.get("text"), str) else ""
175
+ pieces.append(f"[error] {fallback or 'Matrix vision tool failed'}")
176
+ return "\n\n".join(pieces), is_error
177
+
178
+
179
+ def _render(pdf: Path, pages: list[int], dpi: int, tmp_root: Path) -> list[tuple[int, Image.Image, int]]:
180
+ """Render selected pages → list of (page_num, PIL Image, png_bytes)."""
181
+ rendered: list[tuple[int, Image.Image, int]] = []
182
+ for lo, hi in to_ranges(pages):
183
+ # pdf2image numbers from `first_page`; results length == hi - lo + 1
184
+ imgs = convert_from_path(
185
+ str(pdf),
186
+ dpi=dpi,
187
+ first_page=lo,
188
+ last_page=hi,
189
+ fmt="png",
190
+ output_folder=str(tmp_root),
191
+ paths_only=False,
192
+ )
193
+ for i, img in enumerate(imgs):
194
+ page_num = lo + i
195
+ buf = io.BytesIO()
196
+ img.save(buf, format="PNG", optimize=False)
197
+ rendered.append((page_num, img, len(buf.getvalue())))
198
+ return rendered
199
+
200
+
201
+ def _stitch(images: list[Image.Image]) -> tuple[Image.Image, bytes, int]:
202
+ """Vertically stitch a list of PIL images. Returns (stitched_image, png_bytes, byte_size)."""
203
+ if len(images) == 1:
204
+ only = images[0]
205
+ buf = io.BytesIO()
206
+ only.save(buf, format="PNG", optimize=True)
207
+ data = buf.getvalue()
208
+ return only, data, len(data)
209
+ target_w = max(img.width for img in images)
210
+ total_h = sum(img.height for img in images)
211
+ stitched = Image.new("RGB", (target_w, total_h), color=(255, 255, 255))
212
+ y = 0
213
+ for img in images:
214
+ # Paste left-aligned (anchor x=0).
215
+ stitched.paste(img.convert("RGB"), (0, y))
216
+ y += img.height
217
+ buf = io.BytesIO()
218
+ stitched.save(buf, format="PNG", optimize=True)
219
+ data = buf.getvalue()
220
+ return stitched, data, len(data)
221
+
222
+
223
+ def _stitch_and_grow(
224
+ rendered: list[tuple[int, Image.Image, int]],
225
+ max_bytes: int,
226
+ ) -> tuple[list[dict], list[int]]:
227
+ """Pack pages into byte-bounded chunks via measure-then-grow.
228
+
229
+ Returns:
230
+ chunks: [{pages, buffer (bytes), width, height, bytes}, ...]
231
+ oversize_indices: chunk indices whose stitched PNG still > max_bytes
232
+ """
233
+ chunks: list[dict] = []
234
+ oversize_indices: list[int] = []
235
+ i = 0
236
+ n = len(rendered)
237
+ while i < n:
238
+ count = 1
239
+ imgs = [rendered[i][1]]
240
+ stitched_img, data, sz = _stitch(imgs)
241
+ if sz > max_bytes:
242
+ # Single page over budget — accept alone and warn.
243
+ chunks.append(
244
+ {
245
+ "pages": [rendered[i][0]],
246
+ "buffer": data,
247
+ "width": stitched_img.width,
248
+ "height": stitched_img.height,
249
+ "bytes": sz,
250
+ }
251
+ )
252
+ oversize_indices.append(len(chunks) - 1)
253
+ i += 1
254
+ continue
255
+ # Greedy grow.
256
+ while i + count < n:
257
+ trial_imgs = imgs + [rendered[i + count][1]]
258
+ trial_img, trial_data, trial_sz = _stitch(trial_imgs)
259
+ if trial_sz > max_bytes:
260
+ break
261
+ imgs = trial_imgs
262
+ stitched_img = trial_img
263
+ data = trial_data
264
+ sz = trial_sz
265
+ count += 1
266
+ chunks.append(
267
+ {
268
+ "pages": [rendered[i + k][0] for k in range(count)],
269
+ "buffer": data,
270
+ "width": stitched_img.width,
271
+ "height": stitched_img.height,
272
+ "bytes": sz,
273
+ }
274
+ )
275
+ i += count
276
+ return chunks, oversize_indices
277
+
278
+
279
+ def _downscale_oversize(
280
+ pdf: Path,
281
+ rendered: list[tuple[int, Image.Image, int]],
282
+ max_bytes: int,
283
+ tmp_root: Path,
284
+ ) -> list[tuple[int, Image.Image, int]]:
285
+ """Re-render any single page that exceeds max_bytes at FALLBACK_DPI."""
286
+ out: list[tuple[int, Image.Image, int]] = []
287
+ for n, img, sz in rendered:
288
+ if sz <= max_bytes:
289
+ out.append((n, img, sz))
290
+ continue
291
+ warn(f"page {n} {sz} bytes > {max_bytes}; re-rendering at {FALLBACK_DPI} DPI")
292
+ re_imgs = convert_from_path(
293
+ str(pdf),
294
+ dpi=FALLBACK_DPI,
295
+ first_page=n,
296
+ last_page=n,
297
+ fmt="png",
298
+ output_folder=str(tmp_root),
299
+ paths_only=False,
300
+ )
301
+ if not re_imgs:
302
+ die(f"failed to re-render page {n}")
303
+ re_img = re_imgs[0]
304
+ buf = io.BytesIO()
305
+ re_img.save(buf, format="PNG", optimize=False)
306
+ out.append((n, re_img, len(buf.getvalue())))
307
+ return out
308
+
309
+
310
+ def _dump_keep_tmp(
311
+ keep_dir: Path,
312
+ rendered: list[tuple[int, Image.Image, int]],
313
+ chunks: list[dict],
314
+ ) -> None:
315
+ keep_dir.mkdir(parents=True, exist_ok=True)
316
+ for n, img, _ in rendered:
317
+ img.save(keep_dir / f"page_{n:04d}.png", format="PNG")
318
+ for i, c in enumerate(chunks, 1):
319
+ first, last = c["pages"][0], c["pages"][-1]
320
+ (keep_dir / f"chunk_{i:02d}_p{first:04d}-p{last:04d}.png").write_bytes(c["buffer"])
321
+
322
+
323
+ def main() -> None:
324
+ p = argparse.ArgumentParser(
325
+ description="Image-vision PDF read via native Matrix tools (calls local-runtime HTTP).",
326
+ )
327
+ add_common_args(p)
328
+ p.add_argument(
329
+ "--dpi", type=int, default=DEFAULT_DPI, help=f"Render DPI (default {DEFAULT_DPI})."
330
+ )
331
+ p.add_argument(
332
+ "--max-bytes",
333
+ type=int,
334
+ default=DEFAULT_MAX_BYTES,
335
+ help=f"Per-chunk byte budget (default {DEFAULT_MAX_BYTES}).",
336
+ )
337
+ p.add_argument(
338
+ "--prompt",
339
+ default=DEFAULT_PROMPT,
340
+ help="Prompt sent to the native Matrix vision per chunk.",
341
+ )
342
+ p.add_argument(
343
+ "--keep-tmp",
344
+ default=None,
345
+ help="Persist intermediate page/chunk PNGs to this directory (debug).",
346
+ )
347
+ args = p.parse_args()
348
+
349
+ if shutil.which("pdftoppm") is None:
350
+ die("'pdftoppm' (poppler) not found. Install: brew install poppler")
351
+
352
+ pdf_path = resolve_input_or_exit(args.input)
353
+
354
+ # Probe the PDF with pdfinfo *before* anything heavy — this is the
355
+ # double-safety net: page count, encryption status, and a corrupt-PDF
356
+ # detector that runs in milliseconds. Downstream code (page clamping,
357
+ # render budgeting) depends on `total_pages` being trustworthy.
358
+ if shutil.which("pdfinfo") is None:
359
+ die("'pdfinfo' (poppler) not found. Install: brew install poppler")
360
+ try:
361
+ out = subprocess.check_output(
362
+ ["pdfinfo", str(pdf_path)], stderr=subprocess.STDOUT
363
+ ).decode("utf-8", errors="ignore")
364
+ except subprocess.CalledProcessError as e:
365
+ err_tail = (e.output or b"").decode("utf-8", errors="ignore").strip()[-300:]
366
+ die(
367
+ f"pdfinfo failed on {pdf_path} (exit {e.returncode}). "
368
+ f"PDF may be corrupt or password-protected. pdfinfo said: {err_tail}"
369
+ )
370
+ except FileNotFoundError:
371
+ die("'pdfinfo' (poppler) not found. Install: brew install poppler")
372
+
373
+ total_pages = next(
374
+ (int(line.split(":", 1)[1].strip()) for line in out.splitlines() if line.startswith("Pages:")),
375
+ 0,
376
+ )
377
+ if total_pages == 0:
378
+ die(f"Could not determine page count for {pdf_path} (pdfinfo output had no 'Pages:' line)")
379
+ info(f"PDF probe: {total_pages} page(s) total")
380
+
381
+ selected = resolve_pages_or_exit(args.pages, total_pages)
382
+
383
+ tmp_root = _safe_tmp_root()
384
+ tmp_root.mkdir(parents=True, exist_ok=True)
385
+ with tempfile.TemporaryDirectory(prefix="pdf-vis-", dir=tmp_root) as tmp:
386
+ info(f"Rendering {len(selected)} page(s) at {args.dpi} DPI…")
387
+ rendered = _render(pdf_path, selected, args.dpi, Path(tmp))
388
+ rendered = _downscale_oversize(pdf_path, rendered, args.max_bytes, Path(tmp))
389
+
390
+ info("Stitching pages into chunks…")
391
+ chunks, oversize_idx = _stitch_and_grow(rendered, args.max_bytes)
392
+ info(f"Built {len(chunks)} chunk(s)")
393
+ if oversize_idx:
394
+ warn(
395
+ f"{len(oversize_idx)} chunk(s) still exceed {args.max_bytes} bytes; "
396
+ f"Matrix vision may reject them."
397
+ )
398
+
399
+ if args.keep_tmp:
400
+ _dump_keep_tmp(Path(args.keep_tmp), rendered, chunks)
401
+
402
+ chunk_results: list[dict] = []
403
+ for i, c in enumerate(chunks, 1):
404
+ span = format_pages(c["pages"])
405
+ info(f"Vision chunk {i}/{len(chunks)} (pages {span}, {c['bytes']} bytes)…")
406
+ tool_args = {
407
+ "image_info": [
408
+ {
409
+ "data": base64.b64encode(c["buffer"]).decode("ascii"),
410
+ "mime_type": "image/png",
411
+ "prompt": args.prompt,
412
+ }
413
+ ]
414
+ }
415
+ tool_result = _runtime_call_matrix_tool(VISION_TOOL, tool_args)
416
+ text, is_err = _extract_envelope_text(tool_result)
417
+ chunk_results.append(
418
+ {
419
+ "pages": c["pages"],
420
+ "sizeBytes": c["bytes"],
421
+ "width": c["width"],
422
+ "height": c["height"],
423
+ "text": text,
424
+ "isError": is_err,
425
+ }
426
+ )
427
+ info(f"chunk {i}/{len(chunks)} done{' (isError)' if is_err else ''}")
428
+ if is_err and re.search(r"\b(502|413)\b|Bad Gateway|payload too large", text, re.I):
429
+ warn(
430
+ f"chunk {i} got an upstream gateway error. "
431
+ f"This usually means the stitched image is too large for Matrix vision. "
432
+ f"Retry with smaller chunks: --max-bytes 2000000 (or 1500000), "
433
+ f"or narrow --pages, or lower --dpi (current {args.dpi})."
434
+ )
435
+
436
+ result = {
437
+ "mode": "vision",
438
+ "file": str(pdf_path),
439
+ "pageCount": total_pages,
440
+ "selectedPages": selected,
441
+ "dpi": args.dpi,
442
+ "chunks": chunk_results,
443
+ }
444
+
445
+ if args.json:
446
+ emit(
447
+ json.dumps(result, ensure_ascii=False, indent=2) + "\n",
448
+ "json",
449
+ args.max_stdout_bytes,
450
+ )
451
+ return
452
+
453
+ sel_spec = format_pages(selected)
454
+ out_lines: list[str] = [
455
+ f"# {pdf_path.name}",
456
+ "",
457
+ f"> {total_pages} pages • selected {sel_spec} • {len(chunk_results)} vision chunk(s) @ {args.dpi} DPI",
458
+ "",
459
+ ]
460
+ for i, c in enumerate(chunk_results, 1):
461
+ out_lines.append(f"## Chunk {i}/{len(chunk_results)} — pages {format_pages(c['pages'])}")
462
+ out_lines.append("")
463
+ if c["isError"]:
464
+ out_lines.append("> ⚠️ vision returned isError=true; output may be incomplete.")
465
+ out_lines.append(c["text"] or "_(empty response)_")
466
+ out_lines.append("")
467
+ out_lines.append("---")
468
+ out_lines.append("")
469
+ emit("\n".join(out_lines), "md", args.max_stdout_bytes)
470
+
471
+
472
+ if __name__ == "__main__":
473
+ main()
@@ -0,0 +1,181 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ reformat_parse.py — Parse a markdown / text / PDF / HTML source into a
4
+ self-contained .html file ready for `render_html.cjs`.
5
+
6
+ Input formats (auto-detected by extension):
7
+ .md / .markdown — Markdown (markdown-it-py with GFM table + strikethrough)
8
+ .txt — Plain text (treated as a sequence of paragraphs)
9
+ .pdf — pdftotext -layout (requires poppler) → markdown-ish
10
+ .html / .htm — Pass-through body extraction (<body>…</body>)
11
+
12
+ Output: a single HTML file (templates/<template>/skeleton.html with
13
+ placeholders filled). Hand it to `node scripts/render_html.cjs`.
14
+
15
+ Usage:
16
+ python3 reformat_parse.py --input doc.md --out page.html
17
+ python3 reformat_parse.py --input doc.md --out page.html \
18
+ --title "Q3 Review" --subtitle "FY26" --author "Jane" --date 2026-04-22 \
19
+ --accent "#0066cc" --template default
20
+
21
+ Exit codes: 0 success, 1 bad args, 2 dep missing, 3 parse error
22
+ """
23
+
24
+ import argparse
25
+ import importlib
26
+ import importlib.util
27
+ import re
28
+ import shutil
29
+ import subprocess
30
+ import sys
31
+ from datetime import date as _date
32
+ from pathlib import Path
33
+
34
+ SCRIPTS_DIR = Path(__file__).resolve().parent
35
+ SKILL_ROOT = SCRIPTS_DIR.parent
36
+ TEMPLATES_DIR = SKILL_ROOT / "templates"
37
+
38
+
39
+ # ── Dependency bootstrap ──────────────────────────────────────────────────────
40
+ def ensure_deps() -> None:
41
+ missing = []
42
+ if importlib.util.find_spec("markdown_it") is None:
43
+ missing.append("markdown-it-py")
44
+ if not missing:
45
+ return
46
+ print(f" Installing missing Python packages: {missing}", file=sys.stderr)
47
+ subprocess.check_call(
48
+ [sys.executable, "-m", "pip", "install", "--break-system-packages", "-q", *missing]
49
+ )
50
+
51
+
52
+ ensure_deps()
53
+ from markdown_it import MarkdownIt # noqa: E402
54
+
55
+
56
+ # ── Source readers ────────────────────────────────────────────────────────────
57
+ def read_source(path: Path) -> str:
58
+ """Return markdown-ish text content for any supported input format."""
59
+ suffix = path.suffix.lower()
60
+ if suffix in (".md", ".markdown", ".txt"):
61
+ return path.read_text(encoding="utf-8")
62
+ if suffix == ".pdf":
63
+ if shutil.which("pdftotext") is None:
64
+ sys.exit(
65
+ "error: pdftotext not found — install poppler "
66
+ "(brew install poppler / apt install poppler-utils) "
67
+ "or convert the PDF to .md upstream."
68
+ )
69
+ out = subprocess.run(
70
+ ["pdftotext", "-layout", str(path), "-"],
71
+ check=True,
72
+ capture_output=True,
73
+ text=True,
74
+ )
75
+ return out.stdout
76
+ if suffix in (".html", ".htm"):
77
+ # Pass-through: extract <body> if present, otherwise use the whole file.
78
+ text = path.read_text(encoding="utf-8")
79
+ m = re.search(r"<body[^>]*>(.*?)</body>", text, flags=re.S | re.I)
80
+ return m.group(1) if m else text
81
+ sys.exit(f"error: unsupported input format: {suffix}")
82
+
83
+
84
+ def is_html_source(path: Path) -> bool:
85
+ return path.suffix.lower() in (".html", ".htm")
86
+
87
+
88
+ # ── Markdown → HTML ───────────────────────────────────────────────────────────
89
+ def md_to_html(text: str) -> str:
90
+ md = (
91
+ MarkdownIt("commonmark", {"breaks": False, "html": False, "linkify": True})
92
+ .enable("table")
93
+ .enable("strikethrough")
94
+ )
95
+ return md.render(text)
96
+
97
+
98
+ def infer_title_and_body(html: str, fallback_title: str) -> tuple[str, str]:
99
+ """If the first element is <h1>, lift it as the document title."""
100
+ m = re.match(r"\s*<h1[^>]*>(.*?)</h1>\s*", html, flags=re.S | re.I)
101
+ if m:
102
+ title = re.sub(r"<[^>]+>", "", m.group(1)).strip()
103
+ body = html[m.end():]
104
+ return title, body
105
+ return fallback_title, html
106
+
107
+
108
+ # ── Template loading + placeholder fill ───────────────────────────────────────
109
+ def load_template(template_name: str) -> str:
110
+ path = TEMPLATES_DIR / f"reformat-{template_name}" / "skeleton.html"
111
+ if not path.exists():
112
+ # Allow bare directory name as well.
113
+ path = TEMPLATES_DIR / template_name / "skeleton.html"
114
+ if not path.exists():
115
+ sys.exit(
116
+ f"error: reformat template not found: {template_name} "
117
+ f"(tried {TEMPLATES_DIR}/reformat-{template_name}/skeleton.html)"
118
+ )
119
+ return path.read_text(encoding="utf-8")
120
+
121
+
122
+ def fill(template: str, **values: str) -> str:
123
+ out = template
124
+ for key, val in values.items():
125
+ token = f"<!-- {key.upper()} -->"
126
+ out = out.replace(token, val if val is not None else "")
127
+ return out
128
+
129
+
130
+ # ── Main ──────────────────────────────────────────────────────────────────────
131
+ def main() -> int:
132
+ ap = argparse.ArgumentParser(description="Parse markdown/text/pdf → HTML")
133
+ ap.add_argument("--input", required=True, help="Source file (.md / .txt / .pdf / .html)")
134
+ ap.add_argument("--out", required=True, help="Output HTML path")
135
+ ap.add_argument("--title", default="", help="Document title (default: first H1 or filename)")
136
+ ap.add_argument("--subtitle", default="", help="Subtitle (cover line 2)")
137
+ ap.add_argument("--author", default="", help="Author")
138
+ ap.add_argument("--date", default="", help="Date (default: today)")
139
+ ap.add_argument("--accent", default="#1d4ed8", help="Accent color (CSS hex)")
140
+ ap.add_argument("--template", default="default", help="reformat-* template slug")
141
+ args = ap.parse_args()
142
+
143
+ src = Path(args.input)
144
+ if not src.exists():
145
+ sys.exit(f"error: input not found: {src}")
146
+
147
+ raw = read_source(src)
148
+
149
+ # If source is HTML, treat it as already-rendered body; otherwise render
150
+ # markdown.
151
+ body_html = raw if is_html_source(src) else md_to_html(raw)
152
+
153
+ fallback_title = src.stem.replace("_", " ").replace("-", " ").strip().title()
154
+ title, body_html = infer_title_and_body(body_html, args.title or fallback_title)
155
+
156
+ template = load_template(args.template)
157
+ page = fill(
158
+ template,
159
+ title=title,
160
+ subtitle=args.subtitle,
161
+ author=args.author,
162
+ date=args.date or _date.today().isoformat(),
163
+ accent=args.accent,
164
+ body_html=body_html,
165
+ )
166
+
167
+ out = Path(args.out)
168
+ out.parent.mkdir(parents=True, exist_ok=True)
169
+ out.write_text(page, encoding="utf-8")
170
+ print(f" OK Parsed → {out} (title: {title!r}, {len(body_html):,} chars body)")
171
+ return 0
172
+
173
+
174
+ if __name__ == "__main__":
175
+ try:
176
+ sys.exit(main())
177
+ except SystemExit:
178
+ raise
179
+ except Exception as exc: # noqa: BLE001
180
+ print(f"error: {exc}", file=sys.stderr)
181
+ sys.exit(3)
File without changes