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,458 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Multi-protocol LLM caller.
4
+
5
+ Reads provider config from the active Alran Code data directory and calls LLM APIs using the
6
+ correct protocol (Messages, OpenAI Chat Completions, or Gemini
7
+ generateContent) based on the provider's `npm` field.
8
+
9
+ Dependencies: httpx, pyyaml
10
+ pip install httpx pyyaml
11
+ """
12
+
13
+ from __future__ import annotations
14
+
15
+ import argparse
16
+ import json
17
+ import os
18
+ import sys
19
+ from abc import ABC, abstractmethod
20
+ from pathlib import Path
21
+ from typing import Any
22
+
23
+ import httpx
24
+ import yaml
25
+
26
+ # ---------------------------------------------------------------------------
27
+ # Config loading
28
+ # ---------------------------------------------------------------------------
29
+
30
+ def _default_data_dir() -> Path:
31
+ return Path(
32
+ os.environ.get('__ALRAN_PARENT_DATA_DIR')
33
+ or os.environ.get('ALRAN_DATA_DIR')
34
+ or str(Path.home() / ".alran")
35
+ )
36
+
37
+ DEFAULT_CONFIG_PATH = _default_data_dir() / "config.yaml"
38
+
39
+
40
+ def load_config(config_path: str | Path | None = None) -> dict[str, Any]:
41
+ path = Path(config_path) if config_path else DEFAULT_CONFIG_PATH
42
+ if not path.exists():
43
+ print(f"Error: config file not found at {path}", file=sys.stderr)
44
+ sys.exit(1)
45
+ with open(path) as f:
46
+ return yaml.safe_load(f)
47
+
48
+
49
+ # ---------------------------------------------------------------------------
50
+ # Protocol implementations
51
+ # ---------------------------------------------------------------------------
52
+
53
+ NPM_TO_PROTOCOL: dict[str, str] = {
54
+ "@ai-sdk/anthropic": "anthropic",
55
+ "@ai-sdk/openai": "chat-completions",
56
+ "@ai-sdk/google": "gemini",
57
+ }
58
+
59
+
60
+ class Protocol(ABC):
61
+ """Base class for LLM API protocols."""
62
+
63
+ @abstractmethod
64
+ def build_request(
65
+ self,
66
+ base_url: str,
67
+ model_id: str,
68
+ messages: list[dict[str, str]],
69
+ *,
70
+ max_tokens: int = 4096,
71
+ temperature: float | None = None,
72
+ stream: bool = False,
73
+ extra_headers: dict[str, str] | None = None,
74
+ model_options: dict[str, Any] | None = None,
75
+ ) -> tuple[str, dict[str, str], dict[str, Any]]:
76
+ """Return (url, headers, body)."""
77
+
78
+ @abstractmethod
79
+ def extract_text(self, data: dict[str, Any]) -> str:
80
+ """Extract the assistant's text from a non-streaming response."""
81
+
82
+ @abstractmethod
83
+ def extract_stream_delta(self, data: dict[str, Any]) -> str | None:
84
+ """Extract incremental text from a streaming SSE data chunk."""
85
+
86
+
87
+ class MessagesProtocol(Protocol):
88
+ def build_request(self, base_url, model_id, messages, *, max_tokens=4096,
89
+ temperature=None, stream=False, extra_headers=None,
90
+ model_options=None):
91
+ url = f"{base_url.rstrip('/')}/messages"
92
+ headers = {
93
+ "Content-Type": "application/json",
94
+ }
95
+ if extra_headers:
96
+ headers.update(extra_headers)
97
+
98
+ # Messages API requires system as a top-level parameter,
99
+ # not as a message with role "system".
100
+ system_parts: list[str] = []
101
+ filtered_messages: list[dict[str, str]] = []
102
+ for msg in messages:
103
+ if msg["role"] == "system":
104
+ system_parts.append(msg["content"])
105
+ else:
106
+ filtered_messages.append(msg)
107
+
108
+ body: dict[str, Any] = {
109
+ "model": model_id,
110
+ "max_tokens": max_tokens,
111
+ "messages": filtered_messages,
112
+ }
113
+ if system_parts:
114
+ body["system"] = "\n\n".join(system_parts)
115
+ if temperature is not None:
116
+ body["temperature"] = temperature
117
+ if stream:
118
+ body["stream"] = True
119
+
120
+ return url, headers, body
121
+
122
+ def extract_text(self, data):
123
+ for block in data.get("content", []):
124
+ if block.get("type") == "text":
125
+ return block["text"]
126
+ return ""
127
+
128
+ def extract_stream_delta(self, data):
129
+ evt_type = data.get("type", "")
130
+ if evt_type == "content_block_delta":
131
+ delta = data.get("delta", {})
132
+ if delta.get("type") == "text_delta":
133
+ return delta.get("text", "")
134
+ return None
135
+
136
+
137
+ class ChatCompletionsProtocol(Protocol):
138
+ def build_request(self, base_url, model_id, messages, *, max_tokens=4096,
139
+ temperature=None, stream=False, extra_headers=None,
140
+ model_options=None):
141
+ url = f"{base_url.rstrip('/')}/chat/completions"
142
+ headers = {"Content-Type": "application/json"}
143
+ if extra_headers:
144
+ headers.update(extra_headers)
145
+
146
+ body: dict[str, Any] = {
147
+ "model": model_id,
148
+ "max_tokens": max_tokens,
149
+ "messages": messages,
150
+ }
151
+ if temperature is not None:
152
+ body["temperature"] = temperature
153
+ if stream:
154
+ body["stream"] = True
155
+
156
+ # Forward model-level options (e.g. reasoning_effort, store)
157
+ if model_options:
158
+ for key in ("store", "effort", "reasoningSummary"):
159
+ if key in model_options:
160
+ body[key] = model_options[key]
161
+
162
+ return url, headers, body
163
+
164
+ def extract_text(self, data):
165
+ choices = data.get("choices", [])
166
+ if choices:
167
+ return choices[0].get("message", {}).get("content", "")
168
+ return ""
169
+
170
+ def extract_stream_delta(self, data):
171
+ choices = data.get("choices", [])
172
+ if choices:
173
+ delta = choices[0].get("delta", {})
174
+ return delta.get("content")
175
+ return None
176
+
177
+
178
+ class GeminiProtocol(Protocol):
179
+ def build_request(self, base_url, model_id, messages, *, max_tokens=4096,
180
+ temperature=None, stream=False, extra_headers=None,
181
+ model_options=None):
182
+ action = "streamGenerateContent" if stream else "generateContent"
183
+ url = f"{base_url.rstrip('/')}/models/{model_id}:{action}"
184
+ if stream:
185
+ url += "?alt=sse"
186
+ headers = {"Content-Type": "application/json"}
187
+ if extra_headers:
188
+ headers.update(extra_headers)
189
+
190
+ # Convert chat messages to Gemini format
191
+ contents: list[dict[str, Any]] = []
192
+ system_instruction = None
193
+ for msg in messages:
194
+ role = msg["role"]
195
+ text = msg["content"]
196
+ if role == "system":
197
+ system_instruction = {"parts": [{"text": text}]}
198
+ else:
199
+ gemini_role = "model" if role == "assistant" else "user"
200
+ contents.append({"role": gemini_role, "parts": [{"text": text}]})
201
+
202
+ body: dict[str, Any] = {"contents": contents}
203
+ if system_instruction:
204
+ body["systemInstruction"] = system_instruction
205
+ body["generationConfig"] = {"maxOutputTokens": max_tokens}
206
+ if temperature is not None:
207
+ body["generationConfig"]["temperature"] = temperature
208
+
209
+ return url, headers, body
210
+
211
+ def extract_text(self, data):
212
+ candidates = data.get("candidates", [])
213
+ if candidates:
214
+ parts = candidates[0].get("content", {}).get("parts", [])
215
+ return "".join(p.get("text", "") for p in parts)
216
+ return ""
217
+
218
+ def extract_stream_delta(self, data):
219
+ candidates = data.get("candidates", [])
220
+ if candidates:
221
+ parts = candidates[0].get("content", {}).get("parts", [])
222
+ if parts:
223
+ return parts[0].get("text")
224
+ return None
225
+
226
+
227
+ PROTOCOLS: dict[str, Protocol] = {
228
+ "anthropic": MessagesProtocol(),
229
+ "chat-completions": ChatCompletionsProtocol(),
230
+ "gemini": GeminiProtocol(),
231
+ }
232
+
233
+
234
+ # ---------------------------------------------------------------------------
235
+ # LLMCaller
236
+ # ---------------------------------------------------------------------------
237
+
238
+ class LLMCaller:
239
+ """High-level interface for calling LLMs from config.yaml."""
240
+
241
+ def __init__(self, config_path: str | Path | None = None):
242
+ self.config = load_config(config_path)
243
+ self.providers: dict[str, Any] = self.config.get("provider", {})
244
+ self.default_model: str | None = self.config.get("defaultModel")
245
+
246
+ def list_models(self) -> list[dict[str, str]]:
247
+ """Return a flat list of available models with their provider/model ref."""
248
+ result = []
249
+ for provider_id, pconf in self.providers.items():
250
+ models = pconf.get("models", {})
251
+ for model_id, mconf in models.items():
252
+ ref = f"{provider_id}/{model_id}"
253
+ name = mconf.get("name", model_id) if isinstance(mconf, dict) else model_id
254
+ is_default = ref == self.default_model
255
+ result.append({"ref": ref, "name": name, "default": is_default})
256
+ return result
257
+
258
+ def resolve(self, model_ref: str) -> tuple[str, dict[str, Any], dict[str, Any], str]:
259
+ """Resolve 'provider/model' to (protocol_name, provider_config, model_config, model_id)."""
260
+ parts = model_ref.split("/", 1)
261
+ if len(parts) != 2:
262
+ print(f"Error: model must be in 'provider/model' format, got '{model_ref}'",
263
+ file=sys.stderr)
264
+ sys.exit(1)
265
+
266
+ provider_id, model_id = parts
267
+ pconf = self.providers.get(provider_id)
268
+ if not pconf:
269
+ print(f"Error: provider '{provider_id}' not found in config.yaml", file=sys.stderr)
270
+ sys.exit(1)
271
+
272
+ mconf = pconf.get("models", {}).get(model_id, {})
273
+ npm = pconf.get("npm", "")
274
+ protocol_name = NPM_TO_PROTOCOL.get(npm, "chat-completions")
275
+ return protocol_name, pconf, mconf, model_id
276
+
277
+ def call(
278
+ self,
279
+ model_ref: str,
280
+ messages: list[dict[str, str]],
281
+ *,
282
+ max_tokens: int = 4096,
283
+ temperature: float | None = None,
284
+ stream: bool = False,
285
+ timeout: float = 120.0,
286
+ ) -> str:
287
+ """Call the specified model and return the response text."""
288
+ protocol_name, pconf, mconf, model_id = self.resolve(model_ref)
289
+ protocol = PROTOCOLS[protocol_name]
290
+ options = pconf.get("options", {})
291
+ base_url = options.get("baseURL", "")
292
+ api_key = options.get("apiKey", "")
293
+
294
+ # Merge headers: provider-level + model-level
295
+ extra_headers: dict[str, str] = {}
296
+ if options.get("headers"):
297
+ extra_headers.update(options["headers"])
298
+ if isinstance(mconf, dict) and mconf.get("headers"):
299
+ extra_headers.update(mconf["headers"])
300
+
301
+ # Auth header
302
+ if api_key:
303
+ if protocol_name == "anthropic":
304
+ extra_headers["x-api-key"] = api_key
305
+ else:
306
+ extra_headers["Authorization"] = f"Bearer {api_key}"
307
+
308
+ model_options = mconf.get("options", {}) if isinstance(mconf, dict) else {}
309
+
310
+ url, headers, body = protocol.build_request(
311
+ base_url, model_id, messages,
312
+ max_tokens=max_tokens,
313
+ temperature=temperature,
314
+ stream=stream,
315
+ extra_headers=extra_headers,
316
+ model_options=model_options,
317
+ )
318
+
319
+ if stream:
320
+ return self._stream_call(url, headers, body, protocol, timeout)
321
+ else:
322
+ return self._sync_call(url, headers, body, protocol, timeout)
323
+
324
+ def _sync_call(self, url, headers, body, protocol: Protocol, timeout: float) -> str:
325
+ with httpx.Client(timeout=timeout) as client:
326
+ resp = client.post(url, headers=headers, json=body)
327
+ if resp.status_code != 200:
328
+ print(f"Error {resp.status_code}: {resp.text}", file=sys.stderr)
329
+ sys.exit(1)
330
+ return protocol.extract_text(resp.json())
331
+
332
+ def _stream_call(self, url, headers, body, protocol: Protocol, timeout: float) -> str:
333
+ collected: list[str] = []
334
+ with httpx.Client(timeout=timeout) as client:
335
+ with client.stream("POST", url, headers=headers, json=body) as resp:
336
+ if resp.status_code != 200:
337
+ resp.read()
338
+ print(f"Error {resp.status_code}: {resp.text}", file=sys.stderr)
339
+ sys.exit(1)
340
+ buffer = ""
341
+ for chunk in resp.iter_text():
342
+ buffer += chunk
343
+ while "\n" in buffer:
344
+ line, buffer = buffer.split("\n", 1)
345
+ line = line.strip()
346
+ if not line or line.startswith(":"):
347
+ continue
348
+ if line.startswith("data: "):
349
+ data_str = line[6:]
350
+ if data_str.strip() == "[DONE]":
351
+ break
352
+ try:
353
+ data = json.loads(data_str)
354
+ delta = protocol.extract_stream_delta(data)
355
+ if delta:
356
+ print(delta, end="", flush=True)
357
+ collected.append(delta)
358
+ except json.JSONDecodeError:
359
+ continue
360
+ print() # newline after stream
361
+ return "".join(collected)
362
+
363
+
364
+ # ---------------------------------------------------------------------------
365
+ # CLI entrypoint
366
+ # ---------------------------------------------------------------------------
367
+
368
+ def main():
369
+ parser = argparse.ArgumentParser(
370
+ description="Call LLM APIs using config from the active Alran Code data directory",
371
+ formatter_class=argparse.RawDescriptionHelpFormatter,
372
+ epilog="""
373
+ Examples:
374
+ %(prog)s --model azure/gpt-5.4 --system "Be brief" --prompt "What is AI?"
375
+ echo "Summarize" | %(prog)s --model gemini/gemini-2.5-pro
376
+ %(prog)s --list # list available models
377
+ %(prog)s --prompt "Hello" # uses defaultModel from config
378
+ """,
379
+ )
380
+ parser.add_argument("--config", type=str, default=None,
381
+ help="Path to config.yaml (default: active dataDir/config.yaml, normally ~/.alran/config.yaml)")
382
+ parser.add_argument("--model", "-m", type=str, default=None,
383
+ help="Model in provider/model format")
384
+ parser.add_argument("--prompt", "-p", type=str, default=None,
385
+ help="User prompt text")
386
+ parser.add_argument("--system", "-s", type=str, default=None,
387
+ help="System prompt")
388
+ parser.add_argument("--max-tokens", type=int, default=4096,
389
+ help="Max output tokens (default: 4096)")
390
+ parser.add_argument("--temperature", "-t", type=float, default=None,
391
+ help="Sampling temperature")
392
+ parser.add_argument("--timeout", type=float, default=120.0,
393
+ help="HTTP request timeout in seconds (default: 120)")
394
+ parser.add_argument("--stream", action="store_true",
395
+ help="Stream the response")
396
+ parser.add_argument("--list", "-l", action="store_true",
397
+ help="List available models and exit")
398
+ parser.add_argument("--json", action="store_true",
399
+ help="Output as JSON (non-streaming only)")
400
+
401
+ args = parser.parse_args()
402
+ caller = LLMCaller(config_path=args.config)
403
+
404
+ # --list: just show models
405
+ if args.list:
406
+ models = caller.list_models()
407
+ if args.json:
408
+ print(json.dumps(models, indent=2, ensure_ascii=False))
409
+ else:
410
+ for m in models:
411
+ marker = " (default)" if m["default"] else ""
412
+ print(f" {m['ref']} — {m['name']}{marker}")
413
+ return
414
+
415
+ # Get prompt from arg or stdin
416
+ prompt = args.prompt
417
+ if not prompt and not sys.stdin.isatty():
418
+ prompt = sys.stdin.read().strip()
419
+ if not prompt:
420
+ print("Error: --prompt is required (or pipe via stdin)", file=sys.stderr)
421
+ sys.exit(1)
422
+
423
+ # Model selection: explicit --model or fall back to defaultModel from config
424
+ model_ref = args.model
425
+ if not model_ref:
426
+ if caller.default_model:
427
+ model_ref = caller.default_model
428
+ print(f"Using default model: {model_ref}", file=sys.stderr)
429
+ else:
430
+ print("Error: --model is required (no defaultModel configured in config.yaml)",
431
+ file=sys.stderr)
432
+ sys.exit(1)
433
+
434
+ # Build messages
435
+ messages: list[dict[str, str]] = []
436
+ if args.system:
437
+ messages.append({"role": "system", "content": args.system})
438
+ messages.append({"role": "user", "content": prompt})
439
+
440
+ # Call
441
+ result = caller.call(
442
+ model_ref, messages,
443
+ max_tokens=args.max_tokens,
444
+ temperature=args.temperature,
445
+ stream=args.stream,
446
+ timeout=args.timeout,
447
+ )
448
+
449
+ if not args.stream:
450
+ if args.json:
451
+ print(json.dumps({"model": model_ref, "response": result}, indent=2,
452
+ ensure_ascii=False))
453
+ else:
454
+ print(result)
455
+
456
+
457
+ if __name__ == "__main__":
458
+ main()