Heta Framework v0.1.1

Heta Framework v0.1.1

This release introduces Heta Wiki construction and agentic retrieval while preserving compatibility with existing v0.1.0
knowledge bases and recipes.

Highlights

• Added ToolCallingLanguageModelProtocol and the LiteLLM-backed ToolCallingLanguageModel.
• Added BuildWikiPages, SplitWikiPages, and HetaWikiProcedure.
• Added Wiki presets for chunk embedding, vector indexing, and full-text indexing.
• Added reusable Wiki query tools:
  • read_wiki_index
  • search_wiki
  • read_wiki_page
  • read_raw_object
• Added AgenticQueryEngine and the wiki_agent_search query mode.
• Added evidence-backed QueryInsight output.
• Preserved Markdown-oriented parser content through optional original_content.
• Propagated Wiki page and original-document provenance through search results, citations, and retrieval evaluation.

Heta Wiki Pipeline

ParseDocuments
→ BuildWikiPages
→ SplitWikiPages
→ EmbedChunks(preset="wiki")
→ IndexVectors(preset="wiki")
→ IndexFullText(preset="wiki")

The resulting knowledge base supports:

- wiki_vector_search
- wiki_full_text_search
- wiki_agent_search

### Compatibility

- Existing v0.1.0 parsed documents and chunks remain readable.
- Existing knowledge bases do not require data migration.
- Existing positional configuration constructors retain their v0.1.0 field order.
- Existing recipes and default query modes remain unchanged.
- Wiki construction and agentic retrieval are opt-in.
- QueryResponse.insights is appended without changing existing field positions.

### Behavior Change

The default EmbedChunks batch size is reduced from 64 to 10, improving compatibility with embedding providers that enforce
smaller batch limits. Users may explicitly increase it when supported by their provider.

### Validation

- 274 tests passed, 11 skipped
- Ruff passed for all files changed since v0.1.0
- MkDocs strict build passed
- Wheel and source distribution built successfully
- twine check passed
- Isolated wheel installation and public API smoke tests passed
- Real PDF and BEIR SciFact Wiki pipelines were validated

### Installation

pip install --upgrade heta-framework==0.1.1

Optional integrations:

pip install "heta-framework[milvus,s3,text-index,postgres]==0.1.1"

### Known Limitations

- Adding documents to an already successful Wiki knowledge base remains an explicit update lifecycle.
- Resuming a build requires a recipe equivalent to the one used for the original run.

Full Changelog: https://github.com/KnowledgeXLab/Heta_Framework/compare/v0.1.0...v0.1.1