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.
- package/ALRAN_TOOLS_NOTICES.md +75 -0
- package/LICENSE +27 -0
- package/LICENSE-STATUS.md +21 -0
- package/NOTICE +6 -0
- package/README.md +284 -2
- package/THIRD_PARTY_NOTICES.md +113 -0
- package/alran-tools.js +3 -0
- package/assets/agents/_default/prompt-auto_classifier.md +185 -0
- package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
- package/assets/agents/_default/prompt-base-all.md +133 -0
- package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
- package/assets/agents/_default/prompt-base-windows.md +5 -0
- package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
- package/assets/agents/_default/prompt-base-worker.md +10 -0
- package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
- package/assets/agents/_default/prompt-compact.md +76 -0
- package/assets/agents/_default/prompt-compact_continue.md +9 -0
- package/assets/agents/_default/prompt-git.md +8 -0
- package/assets/agents/_default/prompt-goal.md +13 -0
- package/assets/agents/_default/prompt-session-branch.md +3 -0
- package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
- package/assets/agents/_default/prompt-session-root.md +3 -0
- package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
- package/assets/agents/_default/prompt-title.md +11 -0
- package/assets/agents/_default/prompt-tool_agent.md +22 -0
- package/assets/agents/_migration/README.md +20 -0
- package/assets/agents/_migration/coder/PERSONA.md +11 -0
- package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
- package/assets/agents/_migration/general/PERSONA.md +11 -0
- package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
- package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
- package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
- package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
- package/assets/agents/_v2/explore.md.hbs +38 -0
- package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
- package/assets/agents/_v2/verifier.md.hbs +32 -0
- package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
- package/assets/agents/_v2/worker.md.hbs +27 -0
- package/assets/agents/alran/PERSONA.md +7 -0
- package/assets/agents/alran/features/cron.md.hbs +0 -0
- package/assets/agents/alran/features/delegation.md.hbs +56 -0
- package/assets/agents/alran/features/memory.md.hbs +61 -0
- package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
- package/assets/agents/alran/features/task-management.md.hbs +11 -0
- package/assets/agents/alran/features/web-search.md.hbs +11 -0
- package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
- package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
- package/assets/agents/alran/prompt-session-root.md +4 -0
- package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
- package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
- package/assets/agents/alran/skills/alran-code-product/references/account-models.md +64 -0
- package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
- package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
- package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
- package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
- package/assets/agents/alran/system-prompt.md.hbs +97 -0
- package/assets/agents/builtin-agents.json +1 -0
- package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
- package/assets/agents/desktop-task/checkpoint/system.md +19 -0
- package/assets/agents/desktop-task/output-revision/system.md +1 -0
- package/assets/agents/desktop-task/retry/continuation.md +4 -0
- package/assets/agents/desktop-task/session-title/system.md +41 -0
- package/assets/agents/explore/PERSONA.md +8 -0
- package/assets/agents/explore/agent.md +14 -0
- package/assets/agents/explore/system-prompt.md.hbs +35 -0
- package/assets/agents/greeting.md +61 -0
- package/assets/agents/managed-prompts.json +47 -0
- package/assets/agents/prompt-exemptions.json +36 -0
- package/assets/agents/verifier/PERSONA.md +8 -0
- package/assets/agents/verifier/agent.md +17 -0
- package/assets/agents/verifier/system-prompt.md.hbs +28 -0
- package/assets/agents/worker/PERSONA.md +8 -0
- package/assets/agents/worker/agent.md +18 -0
- package/assets/agents/worker/system-prompt.md.hbs +22 -0
- package/assets/agents/workflow/code-review/review-candidates.md +120 -0
- package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
- package/assets/agents/workflow/goal/budget-limit.md +16 -0
- package/assets/agents/workflow/goal/continuation.md +62 -0
- package/assets/agents/workflow/goal/objective-updated.md +16 -0
- package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
- package/assets/agents/workflow/goal/recovery.md +11 -0
- package/assets/agents/workflow/goal/terminal-audit.md +10 -0
- package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
- package/assets/agents/workflow/prompt-hook/system.md +0 -0
- package/assets/models-dev-catalog.json.gz +0 -0
- package/assets/prompts/code-review/review-candidates.md +120 -0
- package/assets/prompts/code-review/reviewer-system.md +75 -0
- package/assets/skills/alran-tools-master/SKILL.md +127 -0
- package/assets/skills/code-review/SKILL.md +51 -0
- package/assets/skills/cu-desktop/SKILL.md +255 -0
- package/assets/skills/deep-research/SKILL.md +30 -0
- package/assets/skills/deploy-website/SKILL.md +52 -0
- package/assets/skills/docx/LICENSE +21 -0
- package/assets/skills/docx/SKILL.md +259 -0
- package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
- package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
- package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
- package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
- package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
- package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
- package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
- package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
- package/assets/skills/docx/docs/acceptance.md +139 -0
- package/assets/skills/docx/docs/anti-patterns.md +14 -0
- package/assets/skills/docx/docs/backends.md +116 -0
- package/assets/skills/docx/docs/evidence.md +73 -0
- package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
- package/assets/skills/docx/docs/index.md +50 -0
- package/assets/skills/docx/docs/rendered-delivery.md +125 -0
- package/assets/skills/docx/docs/router.md +122 -0
- package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
- package/assets/skills/docx/docs/task-apply-template.md +141 -0
- package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
- package/assets/skills/docx/docs/task-create.md +124 -0
- package/assets/skills/docx/docs/task-edit-fill.md +69 -0
- package/assets/skills/docx/docs/task-read-content.md +148 -0
- package/assets/skills/docx/docs/task-read-rendered.md +78 -0
- package/assets/skills/docx/docs/task-read-structure.md +93 -0
- package/assets/skills/docx/docs/task-repair-layout.md +70 -0
- package/assets/skills/docx/docs/template-dsl.md +32 -0
- package/assets/skills/docx/docs/track-changes.md +15 -0
- package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
- package/assets/skills/docx/references/cjk_typography.md +357 -0
- package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
- package/assets/skills/docx/references/comments_guide.md +191 -0
- package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
- package/assets/skills/docx/references/design_principles.md +819 -0
- package/assets/skills/docx/references/openxml_element_order.md +308 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/assets/skills/docx/references/openxml_namespaces.md +82 -0
- package/assets/skills/docx/references/openxml_units.md +72 -0
- package/assets/skills/docx/references/sample-patch-plans.json +22 -0
- package/assets/skills/docx/references/sample-task-intents.json +5 -0
- package/assets/skills/docx/references/sample-template-manifests.json +21 -0
- package/assets/skills/docx/references/scenario_a_create.md +284 -0
- package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
- package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
- package/assets/skills/docx/references/track_changes_guide.md +200 -0
- package/assets/skills/docx/references/troubleshooting.md +506 -0
- package/assets/skills/docx/references/typography_guide.md +294 -0
- package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
- package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
- package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
- package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
- package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
- package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
- package/assets/skills/docx/scripts/docx_preview.sh +37 -0
- package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
- package/assets/skills/docx/scripts/env_check.ps1 +327 -0
- package/assets/skills/docx/scripts/env_check.sh +340 -0
- package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
- package/assets/skills/docx/scripts/pack_docx.py +31 -0
- package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
- package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
- package/assets/skills/docx/scripts/rendered_report.py +609 -0
- package/assets/skills/docx/scripts/setup.ps1 +542 -0
- package/assets/skills/docx/scripts/setup.sh +537 -0
- package/assets/skills/docx/scripts/unpack_docx.py +29 -0
- package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
- package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
- package/assets/skills/edit-deployed-website/SKILL.md +27 -0
- package/assets/skills/init/SKILL.md +135 -0
- package/assets/skills/llm-call/SKILL.md +48 -0
- package/assets/skills/llm-call/scripts/llm_call.py +458 -0
- package/assets/skills/pdf/SKILL.md +280 -0
- package/assets/skills/pdf/docs/advanced-reference.md +711 -0
- package/assets/skills/pdf/docs/create-guide.md +437 -0
- package/assets/skills/pdf/docs/design-guide.md +204 -0
- package/assets/skills/pdf/docs/forms-guide.md +462 -0
- package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
- package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
- package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
- package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
- package/assets/skills/pdf/docs/read-guide.md +358 -0
- package/assets/skills/pdf/docs/reformat-guide.md +238 -0
- package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
- package/assets/skills/pdf/docs/troubleshooting.md +86 -0
- package/assets/skills/pdf/docs/vision-guide.md +188 -0
- package/assets/skills/pdf/scripts/__init__.py +0 -0
- package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
- package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
- package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
- package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
- package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
- package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
- package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
- package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
- package/assets/skills/pdf/scripts/make.sh +388 -0
- package/assets/skills/pdf/scripts/merge.py +112 -0
- package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
- package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
- package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
- package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
- package/assets/skills/pdf/scripts/render/__init__.py +0 -0
- package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
- package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
- package/assets/skills/pdf/scripts/render_html.cjs +205 -0
- package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
- package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
- package/assets/skills/pdf/templates/INDEX.md +90 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
- package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
- package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
- package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
- package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
- package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
- package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
- package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
- package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
- package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
- package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
- package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
- package/assets/skills/pptx/SKILL.md +283 -0
- package/assets/skills/pptx/references/design-system.md +424 -0
- package/assets/skills/pptx/references/editing.md +162 -0
- package/assets/skills/pptx/references/element-map.md +229 -0
- package/assets/skills/pptx/references/pitfalls.md +205 -0
- package/assets/skills/pptx/references/pptxgenjs.md +420 -0
- package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
- package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
- package/assets/skills/pptx/references/slide-types.md +413 -0
- package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
- package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
- package/assets/skills/pptx/scripts/extract_comments.py +468 -0
- package/assets/skills/pptx/scripts/extract_images.py +226 -0
- package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
- package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
- package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
- package/assets/skills/resume-codex/SKILL.md +53 -0
- package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
- package/assets/skills/skill-creator/SKILL.md +188 -0
- package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
- package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
- package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
- package/assets/skills/skill-creator/references/description-rubric.md +83 -0
- package/assets/skills/skill-creator/references/skill-template.md +101 -0
- package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
- package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
- package/assets/skills/skill-refiner/SKILL.md +137 -0
- package/assets/skills/visual-page/SKILL.md +194 -0
- package/assets/skills/x-link-reader/SKILL.md +108 -0
- package/assets/skills/xlsx/SKILL.md +498 -0
- package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
- package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
- package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
- package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
- package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
- package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
- package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
- package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
- package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/assets/skills/xlsx/scripts/office/pack.py +159 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
- package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
- package/assets/skills/xlsx/scripts/office/validate.py +117 -0
- package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
- package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
- package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
- package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
- package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
- package/assets/skills/xlsx/scripts/recalc.py +450 -0
- package/chunks/account-commands-GW7N3MYC.js +2 -0
- package/chunks/anthropic-63VE6MAE.js +2 -0
- package/chunks/application-WPPTE6LU.js +2 -0
- package/chunks/auth-command-36RMNQZW.js +2 -0
- package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
- package/chunks/chunk-2AYWJZ72.js +2 -0
- package/chunks/chunk-2K5H5GA7.js +2 -0
- package/chunks/chunk-2TF6JAQM.js +2 -0
- package/chunks/chunk-3AODGLMF.js +2 -0
- package/chunks/chunk-3GGKARES.js +2 -0
- package/chunks/chunk-4CN3IJFH.js +2 -0
- package/chunks/chunk-4XP5XUIZ.js +2 -0
- package/chunks/chunk-5DQTVSQV.js +131 -0
- package/chunks/chunk-5RIMHTEU.js +207 -0
- package/chunks/chunk-5Y76VFHY.js +2 -0
- package/chunks/chunk-6DOVXX7W.js +2 -0
- package/chunks/chunk-6P4UKHGR.js +2 -0
- package/chunks/chunk-6PFI65C6.js +5 -0
- package/chunks/chunk-6UXSIWCB.js +2 -0
- package/chunks/chunk-7XYOYZX2.js +2 -0
- package/chunks/chunk-AGUSPIUP.js +2 -0
- package/chunks/chunk-BQ3CF3KE.js +2 -0
- package/chunks/chunk-C6LAAFG2.js +30 -0
- package/chunks/chunk-CUG7F2FN.js +2 -0
- package/chunks/chunk-D66ZSHXR.js +2 -0
- package/chunks/chunk-D7MGU75P.js +2 -0
- package/chunks/chunk-DFMYLGVU.js +249 -0
- package/chunks/chunk-EJN3SE5B.js +16 -0
- package/chunks/chunk-F46IELF5.js +2 -0
- package/chunks/chunk-G5MOGPZ3.js +6711 -0
- package/chunks/chunk-GP52JZMY.js +2 -0
- package/chunks/chunk-HNWBFJNO.js +2 -0
- package/chunks/chunk-IC6A323Q.js +2 -0
- package/chunks/chunk-IN2Z5SSJ.js +164 -0
- package/chunks/chunk-JSTSFMGK.js +70 -0
- package/chunks/chunk-K5DTFR6D.js +29 -0
- package/chunks/chunk-LCC45PCZ.js +29 -0
- package/chunks/chunk-LU4RPLJ3.js +2 -0
- package/chunks/chunk-LZJYNT32.js +2 -0
- package/chunks/chunk-MACBL5HF.js +2 -0
- package/chunks/chunk-MPQ6G7LH.js +1085 -0
- package/chunks/chunk-MUXNNOSQ.js +3 -0
- package/chunks/chunk-N5NTXCJI.js +2 -0
- package/chunks/chunk-N6W7ZL26.js +2 -0
- package/chunks/chunk-NBONSNQZ.js +38 -0
- package/chunks/chunk-NMKRNU5O.js +2 -0
- package/chunks/chunk-NVPGGFT3.js +2 -0
- package/chunks/chunk-NZXJAHTO.js +9 -0
- package/chunks/chunk-OTDNOWXG.js +16 -0
- package/chunks/chunk-PCL2CVVE.js +2 -0
- package/chunks/chunk-PXH4SBCS.js +3 -0
- package/chunks/chunk-QKBN5CGI.js +2 -0
- package/chunks/chunk-QPGTKSIQ.js +2 -0
- package/chunks/chunk-R44C5DM6.js +2 -0
- package/chunks/chunk-RLJVY75P.js +28 -0
- package/chunks/chunk-RLND4AYL.js +4 -0
- package/chunks/chunk-SIOLUFGG.js +2 -0
- package/chunks/chunk-TJC4LPRQ.js +2 -0
- package/chunks/chunk-U3RMPDXU.js +2 -0
- package/chunks/chunk-U4PFHJ7Z.js +27 -0
- package/chunks/chunk-UJCAE7SG.js +3 -0
- package/chunks/chunk-V2SB4U4D.js +2 -0
- package/chunks/chunk-VGKKKM2W.js +6 -0
- package/chunks/chunk-VLXX22YO.js +2 -0
- package/chunks/chunk-VUISZDXX.js +24 -0
- package/chunks/chunk-W5ZOLW7T.js +2 -0
- package/chunks/chunk-WHD2XVT2.js +2 -0
- package/chunks/chunk-XLVABFJC.js +9 -0
- package/chunks/chunk-XQK7JM66.js +2 -0
- package/chunks/chunk-XSEU4WQD.js +7 -0
- package/chunks/chunk-XVGPB7TW.js +21 -0
- package/chunks/chunk-Z5HOCNTZ.js +2 -0
- package/chunks/chunk-ZDI22NOK.js +7 -0
- package/chunks/chunk-ZQKVUPKA.js +2 -0
- package/chunks/clipboard-image-PQPC4EHR.js +2 -0
- package/chunks/data-dir-OEPRRIOO.js +2 -0
- package/chunks/dist-VKYZJYR6.js +11 -0
- package/chunks/dist-WGTMUM3E.js +5 -0
- package/chunks/emscripten-module-3WGSFZYF.js +2 -0
- package/chunks/emscripten-module-74WUXTHL.js +2 -0
- package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
- package/chunks/emscripten-module-NEAT5LGD.js +2 -0
- package/chunks/ffi-EFLUAAVX.js +2 -0
- package/chunks/ffi-JIGPPPF7.js +2 -0
- package/chunks/ffi-QKKA5HYI.js +2 -0
- package/chunks/ffi-RLX77WFG.js +2 -0
- package/chunks/google-RCR46TTQ.js +2 -0
- package/chunks/google-vertex-Y26T7YYR.js +2 -0
- package/chunks/install-source-63OVVBMK.js +2 -0
- package/chunks/launcher-2UG3JPYF.js +63 -0
- package/chunks/lifecycle-5IPJRP2V.js +2 -0
- package/chunks/main-7SGOQBHZ.js +13 -0
- package/chunks/mistral-NEBDKUEI.js +3 -0
- package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
- package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
- package/chunks/multipart-parser-JVSLI2CL.js +2 -0
- package/chunks/network-proxy-AJO7ZW3O.js +2 -0
- package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
- package/chunks/openai-completions-C4PHW6MD.js +2 -0
- package/chunks/openai-responses-5NVFOW4Y.js +2 -0
- package/chunks/openrouter-BKUGQT7Z.js +2 -0
- package/chunks/otel-DRJM2PIX.js +2 -0
- package/chunks/package-contract-GVXTMJ3N.js +2 -0
- package/chunks/pdfjs-2UOWBGC2.js +107 -0
- package/chunks/photon_rs-MVWYTYTO.js +3 -0
- package/chunks/plugin-command-CIDTOPNB.js +2 -0
- package/chunks/provider-command-UZ7KQFAC.js +2 -0
- package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
- package/chunks/run-acp-command-AKDLHKMR.js +59 -0
- package/chunks/run-exec-command-UXTPS7LC.js +15 -0
- package/chunks/skills-command-57TF53NO.js +2 -0
- package/chunks/src-5PSNGHHD.js +2 -0
- package/chunks/src-YZ26EVSY.js +2 -0
- package/chunks/telemetry-3NXMCOVD.js +2 -0
- package/chunks/telemetry-command-CMDERYNN.js +5 -0
- package/chunks/tools-CRJR35HS.js +2 -0
- package/chunks/undici-O4OQVZ6I.js +2 -0
- package/chunks/update-ACFAGV6F.js +14 -0
- package/chunks/update-hint-ED7O67WU.js +3 -0
- package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
- package/cli.js +4 -0
- package/configs/data-minimal.yaml +50 -0
- package/embedded/alran-tools/cli.mjs +4957 -0
- package/embedded/alran-tools/manifest.json +25 -0
- package/emscripten-module.wasm +0 -0
- package/image-preview-worker.js +2 -0
- package/internal-bin/alran-tools +9 -0
- package/internal-bin/alran-tools.cmd +8 -0
- package/matrix-mcp-stdio.js +4 -0
- package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
- package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
- package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
- package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
- package/package.json +38 -4
- package/photon_rs_bg.wasm +0 -0
- package/quickjs-worker.js +152 -0
- package/vendor/java-proxy-agent/build.ts +97 -0
- package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
- package/vendor/seccomp/arm64/apply-seccomp +0 -0
- package/vendor/seccomp/build.ts +74 -0
- package/vendor/seccomp/x64/apply-seccomp +0 -0
- package/vendor/srt-win/arm64/srt-win.exe +0 -0
- package/vendor/srt-win/build.ts +40 -0
- 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()
|