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,75 @@
|
|
|
1
|
+
# alran-tools
|
|
2
|
+
|
|
3
|
+
The `alran-tools` CLI vendored here is the upstream media-tools CLI, version
|
|
4
|
+
0.0.4, build `dc5364ace5719d605980e2dc096cab9eb0ee05f1`, rebranded for Alran
|
|
5
|
+
Code. The upstream package coordinates are recorded in the repository's
|
|
6
|
+
[third-party notices](../../THIRD_PARTY_NOTICES.md).
|
|
7
|
+
|
|
8
|
+
The rebrand is limited to identity and endpoint strings: the environment
|
|
9
|
+
variables the CLI reads, the authentication lease socket and capability file
|
|
10
|
+
names, the client id, the user-facing messages, and the platform base URLs.
|
|
11
|
+
They now point at the Ottili platform. The tool's behaviour is otherwise
|
|
12
|
+
unchanged, and the embedded bytes are pinned by hash in
|
|
13
|
+
`scripts/lib/alran-tools-artifact.mjs`.
|
|
14
|
+
|
|
15
|
+
## Local changes to the vendored CLI
|
|
16
|
+
|
|
17
|
+
One change was made to the vendored bytes after the rebrand: the
|
|
18
|
+
`TEST_SANDBOX_API_BASE_URLS` table, which pointed at two internal Kubernetes
|
|
19
|
+
service addresses of the company the CLI was originally built for, was removed
|
|
20
|
+
together with the `BUILD_ENV === "test"` branch that selected it. The vendored
|
|
21
|
+
build is `prod`, so that branch was already unreachable; the removal leaves no
|
|
22
|
+
upstream infrastructure address in the shipped artifact. The pinned hash in
|
|
23
|
+
`scripts/lib/alran-tools-artifact.mjs` and the resource hash in
|
|
24
|
+
`manifest.json` were updated to the new bytes. No other behaviour changed.
|
|
25
|
+
|
|
26
|
+
> # Third-party notices
|
|
27
|
+
>
|
|
28
|
+
> ## Pi TUI
|
|
29
|
+
>
|
|
30
|
+
> Portions of the terminal user interface are derived from Pi TUI and are distributed under the MIT
|
|
31
|
+
> License below.
|
|
32
|
+
>
|
|
33
|
+
> MIT License
|
|
34
|
+
>
|
|
35
|
+
> Copyright (c) 2025 Mario Zechner
|
|
36
|
+
>
|
|
37
|
+
> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
|
|
38
|
+
> associated documentation files (the "Software"), to deal in the Software without restriction,
|
|
39
|
+
> including without limitation the rights to use, copy, modify, merge, publish, distribute,
|
|
40
|
+
> sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
|
|
41
|
+
> furnished to do so, subject to the following conditions:
|
|
42
|
+
>
|
|
43
|
+
> The above copyright notice and this permission notice shall be included in all copies or substantial
|
|
44
|
+
> portions of the Software.
|
|
45
|
+
>
|
|
46
|
+
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
|
|
47
|
+
> NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
48
|
+
> NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
|
|
49
|
+
> OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
50
|
+
> CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
51
|
+
>
|
|
52
|
+
> ## models.dev
|
|
53
|
+
>
|
|
54
|
+
> The bundled provider and model catalog is derived from models.dev and is distributed under the MIT
|
|
55
|
+
> License below.
|
|
56
|
+
>
|
|
57
|
+
> MIT License
|
|
58
|
+
>
|
|
59
|
+
> Copyright (c) 2025 models.dev
|
|
60
|
+
>
|
|
61
|
+
> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
|
|
62
|
+
> associated documentation files (the "Software"), to deal in the Software without restriction,
|
|
63
|
+
> including without limitation the rights to use, copy, modify, merge, publish, distribute,
|
|
64
|
+
> sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
|
|
65
|
+
> furnished to do so, subject to the following conditions:
|
|
66
|
+
>
|
|
67
|
+
> The above copyright notice and this permission notice shall be included in all copies or substantial
|
|
68
|
+
> portions of the Software.
|
|
69
|
+
>
|
|
70
|
+
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
|
|
71
|
+
> NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
72
|
+
> NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
|
|
73
|
+
> OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
74
|
+
> CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
75
|
+
>
|
package/LICENSE
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Alran Code
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
This software includes code derived from MiniMax Code (https://github.com/minimax-ai/minimax-code),
|
|
26
|
+
licensed under the MIT License, Copyright (c) 2026 MiniMax Code. See THIRD_PARTY_NOTICES.md for the
|
|
27
|
+
full upstream license text, the upstream notice and the list of modifications.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# License status
|
|
2
|
+
|
|
3
|
+
The default license for first-party code is [MIT](LICENSE), including the root workspace and first-party package manifests. The root `LICENSE` and `NOTICE` use the maintainer-supplied attribution **Alran Code**. Existing third-party and file-level declarations take precedence for those materials; this change does not relicense upstream code, dependencies or assets.
|
|
4
|
+
|
|
5
|
+
## Third-party exceptions
|
|
6
|
+
|
|
7
|
+
- `third_party/sandbox-runtime` remains **Apache-2.0**, including its retained upstream copyright and modification notices. Its `LICENSE` must accompany distributions containing that component; retain any applicable upstream notices.
|
|
8
|
+
- Pi, derived terminal code, the model catalog and bundled assets retain their original declarations. See [Third-party notices](THIRD_PARTY_NOTICES.md) and the relevant file/package notices.
|
|
9
|
+
- `release/dependency-licenses.json` records dependencies' declared licenses without changing their terms. Binary or installer distributions must retain applicable license texts and notices, including those for bundled native dependencies.
|
|
10
|
+
|
|
11
|
+
The root MIT license is not a statement that every file or bundled component is MIT-licensed.
|
|
12
|
+
|
|
13
|
+
## Publication scope
|
|
14
|
+
|
|
15
|
+
The reviewed repository boundary is recorded in [Publication scope](docs/publication-authorization.md) and `release/public-source.json`. It covers the committed source tree under its existing licenses. npm packages, installers, paid services, third-party accounts, and internal Git history remain separate from this source distribution.
|
|
16
|
+
|
|
17
|
+
## Attribution history
|
|
18
|
+
|
|
19
|
+
On 2026-09-12, review found that the original root license had been copied from Sandbox Runtime and contained Anthropic's attribution. It was corrected to the standard Apache-2.0 text; the subsequently supplied first-party attribution was recorded in `NOTICE`. The first-party default is now MIT, using that same attribution. Sandbox Runtime's original Apache-2.0 license and copyright remain unchanged.
|
|
20
|
+
|
|
21
|
+
The source gate pins the reviewed MIT license hash so a vendor-specific license cannot silently replace the root license during source synchronization.
|
package/NOTICE
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
Alran Code
|
|
2
|
+
Copyright 2026 Alran Code
|
|
3
|
+
|
|
4
|
+
This first-party project attribution does not replace existing file-level or
|
|
5
|
+
package-level licenses, third-party copyright notices, or upstream attributions.
|
|
6
|
+
See LICENSE-STATUS.md and THIRD_PARTY_NOTICES.md for the applicable declarations.
|
package/README.md
CHANGED
|
@@ -1,3 +1,285 @@
|
|
|
1
|
-
|
|
1
|
+
<h1 align="center">Alran Code</h1>
|
|
2
|
+
<p align="center">Turn a prompt into something that works. Build, test, and keep iterating from your terminal—with Alran or your own model.</p>
|
|
3
|
+
<p align="center">
|
|
4
|
+
<a href="#quick-start">Get started</a> ·
|
|
5
|
+
<a href="docs/README.md">Documentation</a> ·
|
|
6
|
+
<a href="docs/examples.md">Examples</a> ·
|
|
7
|
+
<a href="CONTRIBUTING.md">Contributing</a>
|
|
8
|
+
</p>
|
|
9
|
+
Alran Code is Ottili's AI coding agent for the terminal. It reads and edits your code, runs
|
|
10
|
+
commands and tests, and keeps iterating until the task works. By default it runs on **Ottili Werk** through the Ottili AI Gateway; Claude Sonnet 5.5 and Claude Opus 5.5 are one switch away, and you can bring your own provider key.
|
|
2
11
|
|
|
3
|
-
|
|
12
|
+
## Quick start
|
|
13
|
+
|
|
14
|
+
### 1. Install
|
|
15
|
+
|
|
16
|
+
Node.js 22.19+ (22.x), 24.2+ (24.x), 25 or 26 is required.
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm install -g alran
|
|
20
|
+
alran --version
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
pnpm, yarn and bun global installs work the same way. Update later with `alran update`
|
|
24
|
+
([update pipeline](docs/UPDATE_PIPELINE.md)).
|
|
25
|
+
|
|
26
|
+
### 2. Sign in with your Ottili account
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
alran auth login # opens the Ottili sign-in in your browser
|
|
30
|
+
alran auth status # who, which company, which project
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Over SSH or without a display, `alran auth login` prints a code you confirm in any browser
|
|
34
|
+
(`--device` forces it, `--no-device` the other way). On a machine without a browser at all, create an API key at <https://ai.ottili.one/api-keys> and run
|
|
35
|
+
`alran auth login --api-key`. Switch company with `alran auth switch-company`, choose a project with
|
|
36
|
+
`alran config project`, sign out with `alran auth logout` (the session is revoked at the Platform).
|
|
37
|
+
Details: [docs/AUTH.md](docs/AUTH.md).
|
|
38
|
+
|
|
39
|
+
### 3. Pick a model and start
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
alran models # Werk, Claude Sonnet 5.5, Claude Opus 5.5 — price and whether you can use them now
|
|
43
|
+
alran # the interactive terminal UI in the current directory
|
|
44
|
+
alran exec "Add a test for the date parser and make it pass"
|
|
45
|
+
alran usage # credit left, your Anthropic key, spend this month per model
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
| Model | Input / output per 1M tokens | Billed by |
|
|
49
|
+
| --- | --- | --- |
|
|
50
|
+
| Ottili Werk 1.1 (default) | $0.50 / $1.50 | Ottili: free (welcome) or purchased credit |
|
|
51
|
+
| Claude Sonnet 5.5 | $2.00 / $10.00 (Anthropic's price) | Anthropic, on your own API key |
|
|
52
|
+
| Claude Opus 5.5 | $4.00 / $20.00 (Anthropic's price) | Anthropic, on your own API key |
|
|
53
|
+
|
|
54
|
+
The free credit you get on sign-up covers Werk. Claude runs on **your own Anthropic API key**: add it once in
|
|
55
|
+
the Ottili AI Platform under *Settings → Provider keys*, and Anthropic bills you directly — Ottili charges
|
|
56
|
+
nothing for Claude and adds no fee. Without a key a Claude request is refused with `byok_key_required`. Set
|
|
57
|
+
the default with `alran config model sonnet`. More in [docs/MODELS.md](docs/MODELS.md).
|
|
58
|
+
|
|
59
|
+
<details>
|
|
60
|
+
<summary>Use your own API key (bring your own key)</summary>
|
|
61
|
+
|
|
62
|
+
Your own provider key does not need an Ottili account, and those calls go directly to the provider:
|
|
63
|
+
Ottili does not see, meter or bill them. Set the key in your shell, then add the provider:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
export MY_PROVIDER_API_KEY=...
|
|
67
|
+
alran provider add --name my-provider --base-url https://example.com/v1 \
|
|
68
|
+
--api-format openai-completions --model my-model \
|
|
69
|
+
--api-key-env MY_PROVIDER_API_KEY --use
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Supported formats: `openai-completions`, `openai-responses`, `anthropic-messages`.
|
|
73
|
+
`alran models --third-party` explains the catalogue of known providers; see the
|
|
74
|
+
[model examples](docs/examples.md#2-choose-your-own-model).
|
|
75
|
+
|
|
76
|
+
</details>
|
|
77
|
+
|
|
78
|
+
### Plugins and skills
|
|
79
|
+
|
|
80
|
+
Bundled skills (code review, deep research, documents, spreadsheets, slides, PDFs …) work out of the box. The **Plugin Store** (`/plugin`, `alran plugin search|install`) and the **Skill Library** (`/skills library`, `alran skills search|install`) add more from stores you choose; see
|
|
81
|
+
[docs/store.md](docs/store.md). Sources and licensing: [docs/PLUGINS.md](docs/PLUGINS.md).
|
|
82
|
+
|
|
83
|
+
### Data and environment
|
|
84
|
+
|
|
85
|
+
User data lives in `~/.alran` (`ALRAN_DATA_DIR` overrides it). `ALRAN_API_BASE` (default
|
|
86
|
+
`https://ai.ottili.one/v1`) and `OTTILI_PLATFORM_URL` (default `https://platform.ottili.one`) point
|
|
87
|
+
at other Ottili deployments; `ALRAN_NO_UPDATE_CHECK=1` switches off the weekly update hint. Coming
|
|
88
|
+
from the upstream CLI or an early build: [migration guide](docs/MIGRATION_FROM_MINIMAX.md).
|
|
89
|
+
|
|
90
|
+
### 4. Try it: build the pocket pet
|
|
91
|
+
|
|
92
|
+
Clone this repository and copy the starter into a separate directory:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
git clone https://github.com/Alran-AI/code.git
|
|
96
|
+
cd alran-code
|
|
97
|
+
node examples/pocket-pet/setup.mjs ../my-pocket-pet
|
|
98
|
+
cd ../my-pocket-pet
|
|
99
|
+
node serve.mjs
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Open `http://127.0.0.1:4173`. In a second terminal, open `alran` in `my-pocket-pet` and paste [the first prompt](examples/pocket-pet/README.md#first-request), then [the follow-up](examples/pocket-pet/README.md#change-the-requirement). Refresh the browser after each change.
|
|
103
|
+
|
|
104
|
+
Prefer to try the result first? From the repository root, run `node examples/pocket-pet/serve.mjs finished` and open the same URL. Add `?demo=1` for the visibly labeled 10-second mode.
|
|
105
|
+
|
|
106
|
+
[Full walkthrough and requirements](examples/pocket-pet) · [Small code-repair example](examples/clamp) · [Models, search, and tools](docs/examples.md)
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
### Work in your own project
|
|
110
|
+
|
|
111
|
+
Open the project you want to work on:
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
cd /path/to/your/project
|
|
115
|
+
alran
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Describe your task in the TUI, or submit it directly when you launch Alran:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
alran "Find a failing test, fix the implementation, and run the relevant tests."
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Use `alran init .` to generate or update project guidance in `AGENTS.md`. Describe the expected result, allowed changes, and how to verify the task.
|
|
125
|
+
|
|
126
|
+
| Entry point | Command | Use it for |
|
|
127
|
+
| --- | --- | --- |
|
|
128
|
+
| Interactive TUI | `alran [prompt]` | Explore code, continue a conversation, and review changes or permissions. |
|
|
129
|
+
| Headless | `alran exec [prompt]` | Shell scripts, CI, batch work, and evaluations. |
|
|
130
|
+
| ACP | `alran acp` | Editors and clients supporting Agent Client Protocol. |
|
|
131
|
+
| TypeScript SDK | [`@ottili/alran-code-sdk`](packages/code-sdk/README.md) | Drive `alran exec` from Node.js code: start, stream and resume conversations. |
|
|
132
|
+
|
|
133
|
+
### Lightweight conversations
|
|
134
|
+
|
|
135
|
+
For simple conversation or general knowledge questions, start a new Session with
|
|
136
|
+
`--mode lightweight`:
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
alran --mode lightweight "Explain how DNS caching works."
|
|
140
|
+
alran exec --mode lightweight "Summarize the CAP theorem."
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Lightweight mode sends a small conversational system prompt and no tool schemas. It omits workspace
|
|
144
|
+
instructions, Skills, memory blocks, MCP schemas, and the full environment block from provider
|
|
145
|
+
context, so it cannot inspect or change local files. Start a new standard Session for coding or tool use with
|
|
146
|
+
`alran --mode standard` or `alran exec --mode standard`; omitting `--mode` is identical to standard
|
|
147
|
+
mode.
|
|
148
|
+
|
|
149
|
+
The mode is fixed when a root Session is created. `--mode lightweight` therefore cannot be combined
|
|
150
|
+
with `--session` or `--continue`. Child/sub-agent Sessions do not inherit it, `/compact` continues to
|
|
151
|
+
use the standard compaction context, and ACP and desktop Sessions remain standard. Reopening a
|
|
152
|
+
lightweight Session keeps its mode and shows `Lightweight` in the TUI status line; opening a standard
|
|
153
|
+
Session from a lightweight launch remains standard and shows no indicator.
|
|
154
|
+
|
|
155
|
+
### Continue your work
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
# Resume the latest session in the current workspace
|
|
159
|
+
alran --continue
|
|
160
|
+
|
|
161
|
+
# Open the session picker
|
|
162
|
+
alran --session
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
Inside the TUI, use `/sessions` to find previous sessions and `/help` to see all commands and shortcuts.
|
|
166
|
+
|
|
167
|
+
| Action | Shortcut |
|
|
168
|
+
| --- | --- |
|
|
169
|
+
| Send a message or steer the running task | `Enter` |
|
|
170
|
+
| Queue a follow-up while a task is running | `Alt+Enter` |
|
|
171
|
+
| Insert a newline | `Shift+Enter` |
|
|
172
|
+
| Reference a workspace file or directory | `@` |
|
|
173
|
+
| Toggle Plan Mode | `Shift+Tab` |
|
|
174
|
+
| Switch permission modes | `Alt+M` |
|
|
175
|
+
| Close a panel or interrupt a running task; interrupting before the model replies returns the message to the composer | `Esc` |
|
|
176
|
+
|
|
177
|
+
## Uninstall
|
|
178
|
+
|
|
179
|
+
Close running Alran sessions, including editor integrations, before uninstalling. First locate the command with `command -v alran` (macOS / Linux / WSL) or `Get-Command alran -All` (PowerShell), then follow the matching installation method below. The current official install scripts do **not** provide an uninstall flag.
|
|
180
|
+
|
|
181
|
+
### Installed with the script
|
|
182
|
+
|
|
183
|
+
The commands below remove the default installation directory, including both launchers, downloaded releases, and any installer-managed Node.js runtime. If you used `ALRAN_INSTALL_DIR`, substitute the actual installation directory. Inspect it first: earlier source builds used `~/.alran-code` for user data, and a custom data directory can overlap the installation. Back up any configuration or sessions you want to keep before deleting it.
|
|
184
|
+
|
|
185
|
+
**macOS / Linux / WSL**
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
rm -rf -- "$HOME/.alran-code"
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
Remove the `# Alran Code CLI` comment and its following PATH line from the shell file the installer updated: `~/.zshrc` for zsh; the first existing file among `~/.bashrc`, `~/.bash_profile`, and `~/.profile` for bash (or a newly created `~/.bashrc`); `~/.config/fish/config.fish` for fish; or `~/.profile` for other shells. The line is `export PATH="/absolute/install/path/bin:$PATH"`, or `fish_add_path -g "/absolute/install/path/bin"` for fish. Remove only the Alran entry, preserving other PATH settings. The installer skips this edit when `ALRAN_NO_MODIFY_PATH` is set or the path is already present.
|
|
192
|
+
|
|
193
|
+
**Windows (PowerShell)**
|
|
194
|
+
|
|
195
|
+
```powershell
|
|
196
|
+
Remove-Item -LiteralPath "$env:USERPROFILE\.alran-code" -Recurse -Force
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
Open **Edit environment variables for your account**, edit the user **Path**, and remove only the installation directory entry (by default `%USERPROFILE%\.alran-code`, which may appear as an expanded absolute path). The Windows installer updates the user Path, not the PowerShell profile; `ALRAN_NO_MODIFY_PATH` skips that persistent update.
|
|
200
|
+
|
|
201
|
+
### Installed with npm or from source
|
|
202
|
+
|
|
203
|
+
For a global npm installation, use the same npm installation/prefix you used to install Alran:
|
|
204
|
+
|
|
205
|
+
```bash
|
|
206
|
+
npm uninstall -g alran
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
For a source build, save any work and remove only the checkout you created; see [Update or remove](docs/installation.md#update-or-remove).
|
|
210
|
+
|
|
211
|
+
After uninstalling, reopen your terminal (fully restart the editor for integrated terminals) and run `command -v alran` or `Get-Command alran -All` again. No result means the command is no longer on PATH. If another copy appears, identify its installation method before removing it.
|
|
212
|
+
|
|
213
|
+
### Optional: delete user data
|
|
214
|
+
|
|
215
|
+
Removing the program leaves separately stored user data in place. To also delete local login state, provider configuration, caches, and sessions, first confirm the selected directory using [Accounts and data](docs/installation.md#accounts-and-data) and back up anything you need. Other Alran installations can share this directory. For the default `~/.alran` directory only:
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
# macOS / Linux / WSL — permanently deletes the default user data
|
|
219
|
+
rm -rf -- "$HOME/.alran"
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
```powershell
|
|
223
|
+
# Windows — permanently deletes the default user data
|
|
224
|
+
Remove-Item -LiteralPath "$env:USERPROFILE\.alran" -Recurse -Force
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
A profile uses `~/.alran-<profile>`; `ALRAN_DATA_DIR` or `ALRAN_DATA_DIR` can select a different location. Remove only the specific directories you intend to discard, without wildcard deletion. Remove any Alran-specific environment variable assignments you added to shell profiles or user environment settings if you no longer need them.
|
|
228
|
+
|
|
229
|
+
## What you can do
|
|
230
|
+
|
|
231
|
+
| Task | Capabilities |
|
|
232
|
+
| --- | --- |
|
|
233
|
+
| **Edit and verify code** | Read files, inspect diffs, run shell commands and tests, and control tool execution with permissions and sandboxing. |
|
|
234
|
+
| **Choose your model** | Use the Ottili AI Platform with an Ottili API key, or custom providers with OpenAI- or Anthropic-compatible API formats. |
|
|
235
|
+
| **Search and work with media** | Use built-in search, `alran-tools` media tools, MCP, and managed connectors, subject to account access and service credits. |
|
|
236
|
+
| **Keep work moving** | Resume sessions, plan tasks, use subagents, and extend the agent from the Plugin Store, local plugins, the Skill Library and built-in skills. |
|
|
237
|
+
| **Connect your workflow** | Run scripted tasks with the headless CLI, or connect compatible editors and clients through ACP. |
|
|
238
|
+
|
|
239
|
+
Account features, updates, feedback, and diagnostics are also included. Managed tools require network access and the relevant authorization. See [capabilities and service boundaries](docs/tui-capabilities.md) for details.
|
|
240
|
+
|
|
241
|
+
|
|
242
|
+
## Build from source
|
|
243
|
+
|
|
244
|
+
To develop Alran or run this source checkout, you need Git, **Node.js 22.19+ (22.x), 24.2+ (24.x), 25, or 26**, and **pnpm 9.12.0**. On Windows, keep the checkout on a local NTFS volume and outside cloud-synced folders; the preflight command below checks the volume before pnpm creates workspace links.
|
|
245
|
+
```bash
|
|
246
|
+
git clone https://github.com/Alran-AI/code.git
|
|
247
|
+
cd alran-code
|
|
248
|
+
node scripts/check-windows-source-location.mjs
|
|
249
|
+
pnpm install --frozen-lockfile
|
|
250
|
+
pnpm build
|
|
251
|
+
pnpm alran
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
The first build requires an internet connection. Dependencies and the integrity-checked `alran-tools` bundle come from public npm. See the [source installation guide](docs/installation.md) for pnpm setup, system dependencies, and updates.
|
|
255
|
+
|
|
256
|
+
From the source directory, use `pnpm alran` in place of `alran` in the examples above. To work on your own project, open its directory and launch the built CLI:
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
node /absolute/path/to/alran-code/dist/cli.js
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
This repository targets the **0.6.3 source preview**. Installing the published package and building this checkout are separate paths. Matching versions do not prove identical build provenance; see the [version and evidence baseline](docs/open-source-status.md#version-and-evidence-baseline).
|
|
263
|
+
|
|
264
|
+
## Documentation and contributing
|
|
265
|
+
|
|
266
|
+
- [Installation and updates](docs/installation.md) · [Examples](docs/examples.md) · [TUI status line](packages/tui/docs/status-line-config.md)
|
|
267
|
+
- [Contributor guide](CONTRIBUTING.md) · [Report a bug or propose an idea](https://github.com/Alran-AI/code/issues/new/choose) · [Report a security issue](SECURITY.md)
|
|
268
|
+
- [All documentation](docs/README.md): architecture, capability coverage, verification records, source synchronization, and release preparation.
|
|
269
|
+
|
|
270
|
+
For now, code and documentation pull requests are accepted only from repository collaborators. If you are not a collaborator but have an idea or proposal, please [open an issue](https://github.com/Alran-AI/code/issues/new/choose) so we can discuss it. Remove secrets, account details, and private project content from reports.
|
|
271
|
+
|
|
272
|
+
## Support
|
|
273
|
+
|
|
274
|
+
- Bugs, questions and ideas: [GitHub Issues](https://github.com/Alran-AI/code/issues/new/choose).
|
|
275
|
+
Include `alran --version`, your interface (TUI, `exec`, ACP) and a minimal reproduction; remove
|
|
276
|
+
credentials and private project content.
|
|
277
|
+
- Security issues: report privately as described in [SECURITY.md](SECURITY.md).
|
|
278
|
+
- The download page for your account: Ottili Console → Developer → Alran Code, or Ottili AI Platform
|
|
279
|
+
→ Settings → CLI.
|
|
280
|
+
|
|
281
|
+
## License
|
|
282
|
+
|
|
283
|
+
Alran Code is derived from MiniMax Code (mcode). MiniMax Code is © 2026 MiniMax Code and licensed under the MIT License. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|
|
284
|
+
|
|
285
|
+
First-party code defaults to [MIT](LICENSE). Existing file-level and package-level licenses remain in place. See [third-party notices](THIRD_PARTY_NOTICES.md) and [license status](LICENSE-STATUS.md) for dependencies, assets, and `alran-tools`.
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# Third-party notices
|
|
2
|
+
|
|
3
|
+
## 1. MiniMax Code — the upstream this project is derived from
|
|
4
|
+
|
|
5
|
+
Alran Code is a fork of **MiniMax Code**, distributed under the MIT License.
|
|
6
|
+
|
|
7
|
+
| | |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Upstream project | MiniMax Code (`minimax-code`, CLI `mcode`, internal workspace scope `@mavis`) |
|
|
10
|
+
| Source | https://github.com/minimax-ai/minimax-code |
|
|
11
|
+
| Version merged | 0.7.2, upstream commit `3c21163c85a9684030cb147bfef48c6284fa3c46` (merged into Alran Code as `c60655f`, 2026-11-08) |
|
|
12
|
+
| License | MIT |
|
|
13
|
+
| Copyright | Copyright (c) 2026 MiniMax Code |
|
|
14
|
+
|
|
15
|
+
The MIT License requires that the copyright notice and the permission notice are included in all
|
|
16
|
+
copies or substantial portions of the Software. They are reproduced here verbatim, and this file
|
|
17
|
+
ships in the npm package and in every release archive:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
MIT License
|
|
21
|
+
|
|
22
|
+
Copyright (c) 2026 MiniMax Code
|
|
23
|
+
|
|
24
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
25
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
26
|
+
in the Software without restriction, including without limitation the rights
|
|
27
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
28
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
29
|
+
furnished to do so, subject to the following conditions:
|
|
30
|
+
|
|
31
|
+
The above copyright notice and this permission notice shall be included in all
|
|
32
|
+
copies or substantial portions of the Software.
|
|
33
|
+
|
|
34
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
35
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
36
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
37
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
38
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
39
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
40
|
+
SOFTWARE.
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
The upstream repository also carried a `NOTICE` file. MIT does not require it to be kept; it is
|
|
44
|
+
reproduced here as a courtesy, verbatim:
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
MiniMax Code
|
|
48
|
+
Copyright 2026 MiniMax Code
|
|
49
|
+
|
|
50
|
+
This first-party project attribution does not replace existing file-level or
|
|
51
|
+
package-level licenses, third-party copyright notices, or upstream attributions.
|
|
52
|
+
See LICENSE-STATUS.md and THIRD_PARTY_NOTICES.md for the applicable declarations.
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
The first-party license for the Alran Code changes is in [LICENSE](LICENSE).
|
|
56
|
+
|
|
57
|
+
### Modifications made to MiniMax Code
|
|
58
|
+
|
|
59
|
+
MIT does not require a list of changes; it is kept here because it is good practice for a fork and
|
|
60
|
+
because Apache-2.0 components below (Sandbox Runtime) do require one. Main changes against upstream
|
|
61
|
+
0.7.2:
|
|
62
|
+
|
|
63
|
+
1. **Identity.** Product name, CLI binary (`mcode` → `alran`), workspace scope (`@mavis/*` →
|
|
64
|
+
`@alran/*`), environment variables (`MAVIS_*` → `ALRAN_*`, with a read-only compatibility shim
|
|
65
|
+
until 2027-Q1), data directory (`~/.mavis` → `~/.alran`, migrated once with a compatibility
|
|
66
|
+
symlink), prompts, UI strings, docs and tests.
|
|
67
|
+
2. **Accounts.** The upstream account system is replaced by the Ottili Platform: OpenID Connect
|
|
68
|
+
sign-in (`alran auth login`), Platform sessions, company and project context, session revocation.
|
|
69
|
+
3. **Models.** The upstream model catalogue is replaced by Ottili models served by the Ottili AI
|
|
70
|
+
Gateway (`werk`, `anthropic/claude-sonnet-5.5`, `anthropic/claude-opus-5.5`); third-party
|
|
71
|
+
providers remain available as bring-your-own-key.
|
|
72
|
+
4. **Telemetry.** All upstream reporting endpoints are removed; usage reporting is opt-in and sends
|
|
73
|
+
nothing unless a deployment names its own endpoint.
|
|
74
|
+
5. **Updates.** The upstream release host is removed; updates follow the npm package
|
|
75
|
+
`alran` or a self-hosted signed `latest.json`.
|
|
76
|
+
6. **Removed content.** Upstream brand material (a website brand-guide case of the PDF skill) and
|
|
77
|
+
upstream community links.
|
|
78
|
+
7. **Tooling.** Brand gate (`pnpm lint:no-minimax`), license gate (`pnpm license-check`), Ottili
|
|
79
|
+
commands (`alran auth`, `alran usage`, `alran billing`, `alran models`, `alran config`).
|
|
80
|
+
|
|
81
|
+
The complete history is the Git history of https://github.com/Alran-AI/code.
|
|
82
|
+
|
|
83
|
+
## 2. Other third-party materials
|
|
84
|
+
|
|
85
|
+
- **Pi**: `third_party/pi-mono` and derived terminal code, MIT. Full notices are in `third_party/pi-mono/LICENSE` and `packages/tui/THIRD_PARTY_NOTICES.md`. Local modifications are recorded in `third_party/pi-mono/ALRAN_CHANGES.md`.
|
|
86
|
+
- **Sandbox Runtime**: `third_party/sandbox-runtime`, Apache-2.0. See its README, LICENSE, and upstream.json for the upstream version, source revision, fork changes, and native build instructions.
|
|
87
|
+
- **models.dev**: the bundled provider / model catalog snapshot, MIT; notices are in `packages/tui/THIRD_PARTY_NOTICES.md`.
|
|
88
|
+
- **Bundled assets**: LICENSE, NOTICE, and file-level declarations in each asset directory retain their original attribution. The bundled skills (`packages/local-runtime/assets/skills`) come from MiniMax Code and are covered by its MIT license above; the `docx` skill carries its own MIT license, `Copyright (c) 2026 MiniMaxAI` (`packages/local-runtime/assets/skills/docx/LICENSE`), which `pnpm license-check` keeps unchanged.
|
|
89
|
+
- **npm dependencies**: versions and declared licenses are recorded in `release/dependency-licenses.json`; `pnpm-lock.yaml` is authoritative for dependency resolution and integrity.
|
|
90
|
+
- **alran-tools 0.0.4**: vendored under `third_party/alran-tools`. It is the upstream media-tools CLI taken from the public `@minimax-ai/code@0.3.11` npm release (MIT) and rebranded for Alran Code; the upstream identity and license notices are in `third_party/alran-tools/THIRD_PARTY_NOTICES.md`. Its distribution manifest declares MIT, and the CLI hash is pinned in `scripts/lib/alran-tools-artifact.mjs`. The tool's own manifest is retained, and its notices are copied to `dist/ALRAN_TOOLS_NOTICES.md`. The root license does not replace this artifact's existing declarations.
|
|
91
|
+
|
|
92
|
+
The root MIT license does not replace these materials' separate licenses or copyright notices.
|
|
93
|
+
|
|
94
|
+
## 3. Dependencies with licenses other than MIT, ISC, BSD and Apache-2.0
|
|
95
|
+
|
|
96
|
+
`pnpm license-check` (`scripts/check-licenses.mjs`) reads `release/dependency-licenses.json` and
|
|
97
|
+
fails on any license that is not on its allow-list. The reviewed exceptions:
|
|
98
|
+
|
|
99
|
+
| Package | Declared license | Use |
|
|
100
|
+
|---|---|---|
|
|
101
|
+
| `chownr`, `glob`, `lru-cache`, `minimatch`, `minipass`, `path-scurry`, `tar`, `yallist` | BlueOak-1.0.0 | permissive; license text kept under `licenses/` of a release archive |
|
|
102
|
+
| `argparse` | Python-2.0 | permissive (PSF); notice kept |
|
|
103
|
+
| `jszip` | MIT OR GPL-3.0-or-later | used under MIT |
|
|
104
|
+
| `node-forge` | BSD-3-Clause OR GPL-2.0 | used under BSD-3-Clause |
|
|
105
|
+
| `expand-template` | MIT OR WTFPL | used under MIT |
|
|
106
|
+
| `pako` | MIT AND Zlib | both permissive |
|
|
107
|
+
| `type-fest` | MIT OR CC0-1.0 | used under MIT |
|
|
108
|
+
| `tslib` | 0BSD | permissive |
|
|
109
|
+
|
|
110
|
+
No dependency is under a copyleft-only license (GPL, LGPL, AGPL, SSPL, EUPL). The full list with
|
|
111
|
+
versions is `release/dependency-licenses.json`; a release archive carries every bundled package's
|
|
112
|
+
own license text under `licenses/`.
|
|
113
|
+
|
package/alran-tools.js
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { createRequire as __alran_cR } from "module"; import { basename as __alran_basename, dirname as __alran_dirname, join as __alran_join } from "path"; import { fileURLToPath as __alran_fileURLToPath, pathToFileURL as __alran_pathToFileURL } from "url"; const __alran_tuiCurrentModuleDir = __alran_dirname(__alran_fileURLToPath(import.meta.url)); const __alran_tuiPackageRoot = __alran_basename(__alran_tuiCurrentModuleDir) === "chunks" ? __alran_dirname(__alran_tuiCurrentModuleDir) : __alran_tuiCurrentModuleDir; const __alran_tuiPackageEntryUrl = __alran_pathToFileURL(__alran_join(__alran_tuiPackageRoot, "cli.js")).href; const require = __alran_cR(__alran_tuiPackageEntryUrl); const __dirname = __alran_tuiPackageRoot;
|
|
3
|
+
import{b as e}from"./chunks/chunk-F46IELF5.js";import"./chunks/chunk-HNWBFJNO.js";import"./chunks/chunk-XQK7JM66.js";e();var n=new URL("./embedded/alran-tools/cli.mjs",__alran_tuiPackageEntryUrl);await import(n.href);
|