lionagi 0.10.2__py3-none-any.whl → 0.10.3__py3-none-any.whl

lionagi/adapters/toml_adapter.py

@@ -141,7 +141,7 @@ class TomlFileAdapter(Adapter):
         dict | list[dict]
             The loaded data from file.
         """
-        with open(obj, "r", encoding="utf-8") as f:
+        with open(obj, encoding="utf-8") as f:
             result = toml.load(f, **kwargs)
 
         # Handle array of tables in TOML for "many" case

lionagi/fields/__init__.py

@@ -1,7 +1,4 @@
-from .action import (
-    ActionRequestModel,
-    ActionResponseModel,
-)
+from .action import ActionRequestModel, ActionResponseModel
 from .base import (
     CodeSnippet,
     Outline,
@@ -11,10 +8,7 @@ from .base import (
     TextSnippet,
 )
 from .file import CodeFile, Documentation, File
-from .instruct import (
-    Instruct,
-    InstructResponse,
-)
+from .instruct import Instruct, InstructResponse
 from .reason import Reason
 
 __all__ = (

lionagi/fields/file.py

@@ -13,15 +13,17 @@ __all__ = (
 
 class File(HashableModel):
     """
-    Represents a generic file with an optional name, content, and brief description.
-    Useful for capturing and validating metadata about any kind of file within a project.
+    Represents a generic file with an optional name, content, and brief
+    description. Useful for capturing and validating metadata about any
+    kind of file within a project.
     """
 
     file_name: str | None = Field(
         default=None,
         description=(
-            "Provide the name of the file or its relative path in the project. "
-            "If an absolute path is given, it will be converted to a string. "
+            "Provide the name of the file or its relative path in the "
+            "project. If an absolute path is given, it will be converted"
+            " to a string. "
         ),
         examples=[
             "session.py",
@@ -33,8 +35,8 @@ class File(HashableModel):
         default=None,
         description=(
             "Paste or generate the full textual content of the file here. "
-            "For example, this might include plain text, Markdown, or any other text format.\n"
-            "Examples:\n"
+            "For example, this might include plain text, Markdown, or any "
+            "other text format.\nExamples:\n"
             "  - '# My Title\\nSome description...'\n"
             "  - 'function greet() { return \"Hello\"; }'"
         ),
@@ -42,8 +44,9 @@ class File(HashableModel):
     description: str | None = Field(
         default=None,
         description=(
-            "Briefly explain the file's purpose or function within the project. "
-            "This can be a short summary describing why this file exists or what it does.\n"
+            "Briefly explain the file's purpose or function within the "
+            "project. This can be a short summary describing why this "
+            "file is needed and/or what it does."
         ),
         examples=[
             "Manages user session logic for the LionAGI framework.",
@@ -57,6 +60,38 @@ class File(HashableModel):
             return str(value)
         return value
 
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+    ) -> str:
+        text = f"\n{header}\n\n" if header else ""
+        text += self.content if self.content else ""
+        if not footer:
+            return text
+        return text + f"\n\n{footer}\n"
+
+    def persist(
+        self,
+        directory: Path | str,
+        overwrite: bool = True,
+        timestamp: bool = False,
+        random_hash_digits: int = None,
+        header: str | None = None,
+        footer: str | None = None,
+    ) -> Path:
+        from lionagi.utils import create_path
+
+        fp = create_path(
+            directory=directory,
+            filename=self.file_name,
+            file_exist_ok=overwrite,
+            timestamp=timestamp,
+            random_hash_digits=random_hash_digits,
+        )
+        fp.write_text(self.render_content(header=header, footer=footer))
+        return fp
+
 
 class CodeFile(File):
     """
@@ -84,7 +119,7 @@ class CodeFile(File):
         default=None,
         description=(
             "Provide or generate the **full source code**. This should be the primary text content "
-            "of the code file, including all function/class definitions.\n"
+            "of the code file, including all function/class definitions.\nNo md codeblock, only raw code"
         ),
         examples=[
             'def my_function():\\n    print("Hello, world!")',
@@ -113,10 +148,6 @@ class Documentation(File):
             "Provide the primary Markdown (or similar) content for the documentation. "
             "This can include headings, bullet points, tables, code snippets, etc.\n"
         ),
-        examples=[
-            "# Getting Started\\nThis guide walks you through ...",
-            "# API Reference\\n## Session Class\\n...",
-        ],
     )
     sources: list[Source] | None = Field(
         default=None,
@@ -126,5 +157,22 @@ class Documentation(File):
         ),
     )
 
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+        include_source: bool = False,
+    ) -> str:
+        """
+        Renders the documentation content, optionally including citations for sources.
+        """
+        footer = footer or ""
+        if include_source and self.sources:
+            footer = "\n\n## Sources\n"
+            for source in self.sources:
+                footer += f"- [{source.title}]({source.url})\n"
+                footer += f"  - {source.note}\n" if source.note else ""
+        return super().render_content(header=header, footer=footer)
+
 
 # File: lionagi/fields/file.py

lionagi/fields/reason.py

@@ -22,10 +22,9 @@ class Reason(BaseModel):
             "how well you've met user expectations. Use this guide:\n"
             "  • 1.0: Highly confident\n"
             "  • 0.8-1.0: Reasonably sure\n"
-            "  • 0.5-0.8: Re-check or refine\n"
-            "  • 0.0-0.5: Off track"
+            "  • 0.5-0.8: Re-check, refine or backtrack\n"
+            "  • 0.0-0.5: Off track, stop"
         ),
-        examples=[0.821, 0.257, 0.923, 0.439],
     )
 
     @field_validator("confidence_score", mode="before")

lionagi/libs/token_transform/synthlang_/base.py

@@ -31,7 +31,7 @@ class SynthlangFramework(Resource):
         import json
 
         fp = here / FRAMEWORK_PATH / "framework_options.json"
-        with open(fp, "r", encoding="utf-8") as f:
+        with open(fp, encoding="utf-8") as f:
             return json.load(f)
 
     @classmethod

lionagi/libs/token_transform/synthlang_/resources/frameworks/framework_options.json

@@ -49,4 +49,4 @@
             ]
         }
     }
-}
+}

lionagi/libs/token_transform/synthlang_/resources/mapping/lion_emoji_mapping.toml

@@ -58,4 +58,4 @@ False = "⊭"
 "⧦⧦⧦" = "⧦"
 "  " = "◻︎"
 "◻︎◻︎" = "◼︎"
-"###" = "#"
+"###" = "#"

lionagi/libs/token_transform/synthlang_/resources/mapping/python_math_mapping.toml

@@ -38,4 +38,4 @@ False = "⊭"
 "⧦⧦⧦" = "⧦"
 "  " = "◻︎"
 "◻︎◻︎" = "◼︎"
-"###" = "#"
+"###" = "#"

lionagi/libs/token_transform/synthlang_/resources/mapping/rust_chinese_mapping.toml

@@ -57,4 +57,4 @@ self = "自"
 Clone = "隆"
 clone = "隆"
 derive = "衍"
-"println!" = "印"
+"println!" = "印"

lionagi/operations/ReAct/utils.py

@@ -4,34 +4,45 @@
 
 from typing import ClassVar, Literal
 
-from pydantic import BaseModel, Field
+from pydantic import Field, field_validator
 
+from lionagi.models import HashableModel
 
-class PlannedAction(BaseModel):
+
+class PlannedAction(HashableModel):
     """
-    Short descriptor for an upcoming action/tool invocation the LLM wants to perform.
-    The model can hold multiple actions in a single round if needed.
+    Short descriptor for an upcoming action/tool invocation the LLM wants to
+    perform. The model can hold multiple actions in a single round if needed.
     """
 
-    action_type: str = Field(
-        ...,
-        description="The name or type of tool/action to invoke (e.g., 'search_exa', 'reader_tool').",
+    action_type: str | None = Field(
+        default=None,
+        description=(
+            "The name or type of tool/action to invoke. "
+            "(e.g., 'search_exa', 'reader_tool')"
+        ),
     )
-    description: str = Field(
-        ...,
-        description="A short explanation of why or what is intended to achieve with this action.",
+    description: str | None = Field(
+        default=None,
+        description=(
+            "A short description of the action to perform. "
+            "This should be a concise summary of what the action entails."
+            "Also include your rationale for this action, if applicable."
+        ),
     )
 
 
-class ReActAnalysis(BaseModel):
+class ReActAnalysis(HashableModel):
     """
     Captures the ReAct chain-of-thought output each round:
     1) The LLM's 'analysis' (reasoning),
     2) A list of planned actions to perform before finalizing,
     3) Indication whether more expansions/rounds are needed,
     4) Additional tuning knobs: how to handle validation, how to execute actions, etc.
-    Remember do not repeat yourself, and aim to use the most efficient way to achieve
-    the goal to user's satisfaction.
+
+    Note:
+    - Retain from repeating yourself
+    - use the most efficient way to achieve the goal to user's satisfaction
     """
 
     # Standard ReAct strings for controlling expansions:
@@ -101,6 +112,16 @@ class ReActAnalysis(BaseModel):
     )
 
 
-class Analysis(BaseModel):
+class Analysis(HashableModel):
+
+    answer: str | None = None
 
-    answer: str
+    @field_validator("answer", mode="before")
+    def _validate_answer(cls, value):
+        if not value:
+            return None
+        if isinstance(value, str) and not value.strip():
+            return None
+        if not isinstance(value, str):
+            raise ValueError("Answer must be a non-empty string.")
+        return value.strip()

lionagi/version.py

@@ -1 +1 @@
-__version__ = "0.10.2"
+__version__ = "0.10.3"

{lionagi-0.10.2.dist-info → lionagi-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.10.2
+Version: 0.10.3
 Summary: An Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>
 License:            Apache License
@@ -221,11 +221,11 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Requires-Dist: aiocache>=0.12.0
 Requires-Dist: aiohttp>=3.11.0
-Requires-Dist: jinja2>=3.1.0
+Requires-Dist: jinja2>=3.0.0
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: pillow>=10.0.0
 Requires-Dist: pydantic>=2.0.0
-Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: tiktoken>=0.8.0
 Requires-Dist: toml>=0.9.0
 Provides-Extra: llms

{lionagi-0.10.2.dist-info → lionagi-0.10.3.dist-info}/RECORD

@@ -4,23 +4,23 @@ lionagi/_errors.py,sha256=JlBTFJnRWtVYcRxKb7fWFiJHLbykl1E19mSJ8sXYVxg,455
 lionagi/_types.py,sha256=iDdYewsP9rDrM7QY19_NDTcWUk7swp8vnGCrloHMtUM,53
 lionagi/settings.py,sha256=W52mM34E6jXF3GyqCFzVREKZrmnUqtZm_BVDsUiDI_s,1627
 lionagi/utils.py,sha256=uLTJKl7aTnFXV6ehA6zwiwEB7G2nQYKsO2pZ6mqFzUk,78908
-lionagi/version.py,sha256=A_AARqtxTOj_AQTpjpgOxNx-UOBio5wYFfZ2mrdMKfs,23
+lionagi/version.py,sha256=0C8KcY1dzs3hdkAre06v0NCQ0Uxcqv6g9a93bRcVLW0,23
 lionagi/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/adapters/adapter.py,sha256=aW7s1OKAdxHd8HBv2UcThn-r2Q08EyArssNyFobMLuA,3357
 lionagi/adapters/json_adapter.py,sha256=EJj0Jev46ZhU3ZMnlYwyzN2rLxjLCVrMDpHkEuggBvk,4561
-lionagi/adapters/toml_adapter.py,sha256=WyfMDgp49jH0u_ksZ_vLxdnm6KTrYLIlWDo7GBWaST8,5446
+lionagi/adapters/toml_adapter.py,sha256=XOx0Q41g9FoNVuGrce96ck3gxPo4G-3mwqSin5kGq9s,5441
 lionagi/adapters/types.py,sha256=CHfB39BSeyU11SDkXXkU_vzqy4v7kaR-2r0y6DYkhXc,660
 lionagi/adapters/pandas_/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/adapters/pandas_/csv_adapter.py,sha256=HWie6Jlt8nR-EVJC_zmCFilaWszLNuk7EWUp8Xvr-H8,2358
 lionagi/adapters/pandas_/excel_adapter.py,sha256=ZqRT2xF93NLKNyMp16ePNzwUN3ntNkUy1dO3nbsrfak,2287
 lionagi/adapters/pandas_/pd_dataframe_adapter.py,sha256=ULGZVhK5aaOuTrmFq4x5SiuDScYetyYYUHeL8Hh13Eg,2279
 lionagi/adapters/pandas_/pd_series_adapter.py,sha256=TX3cqFtgEip8JqVqkjdJYOu4PQGpW1yYU6POhvz8Jeg,1388
-lionagi/fields/__init__.py,sha256=kaKavoiVZ_S49DHr2uPzN3KiX5AHFsUs5JzWUJkbz4c,593
+lionagi/fields/__init__.py,sha256=BrFzn3wOb9oCF_7iXH0b28-XwfZQNmee8sMDQD0HQBk,567
 lionagi/fields/action.py,sha256=iWSApCM77jS0Oc28lb7G601Etkp-yjx5U1hfI_FQgfA,5792
 lionagi/fields/base.py,sha256=5CJc7j8kTTWzXwpYzkSAFzx4BglABfx3AElIATKB7bg,3857
-lionagi/fields/file.py,sha256=gzR2rZF2rU76AJJLjdD6TUJCj9VKXPaAH_Ow4oCsTfQ,4124
+lionagi/fields/file.py,sha256=GkOxOtCTWjb4S0vwxLei6sNyONcbV8QRIMTyXkWwV1A,5601
 lionagi/fields/instruct.py,sha256=sMbCxEv0HQLa31JkJDmdrWWEzIfeKbcmN2hYOehz3Q0,4773
-lionagi/fields/reason.py,sha256=TY2zQbounGU4DGDhbBqBW-jJPuJHmcoePSCKLgJxaL0,1460
+lionagi/fields/reason.py,sha256=iNjgcIC2yWa0m0hkEZTCwKwknTkjVbhGLS2TWp6CE8s,1430
 lionagi/libs/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/libs/parse.py,sha256=JRS3bql0InHJqATnAatl-hQv4N--XXw4P77JHhTFnrc,1011
 lionagi/libs/file/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
@@ -58,20 +58,20 @@ lionagi/libs/token_transform/perplexity.py,sha256=tcVRjPBX3nuVqsoTkowCf6RBXuybO-
 lionagi/libs/token_transform/symbolic_compress_context.py,sha256=Nr4vSJSN6sUQgaA1QxHhidWH3pUG_5RnoYeLHjMsoLA,4603
 lionagi/libs/token_transform/synthlang.py,sha256=W6e-_265UXqVosM9X0TLKW53rNHvWCKhsWbVAop49Ac,259
 lionagi/libs/token_transform/types.py,sha256=4HgAfNDlJ_Hu18kLt59GHr_76eF3xLpNCTbOXlAYVlA,491
-lionagi/libs/token_transform/synthlang_/base.py,sha256=diDFrm-1Zf3PerKjODo-uFQMEjxPeaGtbZ5N1lK59Kg,4114
+lionagi/libs/token_transform/synthlang_/base.py,sha256=GDle72c8EjFz_3hg_k-y0YmksBsn5TSRVTw5_cwfWTo,4109
 lionagi/libs/token_transform/synthlang_/translate_to_synthlang.py,sha256=lRBpeKGhyNlf8ngigjYAw56QbIAVZWLQUzRg2wpwMfQ,4956
 lionagi/libs/token_transform/synthlang_/resources/frameworks/abstract_algebra.toml,sha256=2TuOAo97g8mNhdPH96HP8vYZpnC8neiP-KlhVqbp1Us,970
 lionagi/libs/token_transform/synthlang_/resources/frameworks/category_theory.toml,sha256=Stg9W3h8o7VkQ9tdAfSZmR3LctFqcH6OhOPdaw9BlIg,1064
 lionagi/libs/token_transform/synthlang_/resources/frameworks/complex_analysis.toml,sha256=iE6FS7Cn5_uJRG5-StLuMM4XVAk95bxhbYWwlstw_tA,1044
-lionagi/libs/token_transform/synthlang_/resources/frameworks/framework_options.json,sha256=42I5bRegSUp-60LNWa7k6eXurdWf8aCemhrFqw2s7qc,1759
+lionagi/libs/token_transform/synthlang_/resources/frameworks/framework_options.json,sha256=phAkedPGrwgNGW8hgPyH6pKU47pvKEAnG7vheWFvOLc,1760
 lionagi/libs/token_transform/synthlang_/resources/frameworks/group_theory.toml,sha256=iVlcS250YMosNRv3l8bz3BT9Tx1xCmiwhfNt4CjjRYc,713
 lionagi/libs/token_transform/synthlang_/resources/frameworks/math_logic.toml,sha256=jeFOF8gjRhb4hYXpW7AxTX8uk9c6DvGulJK5Bowxhq4,1037
 lionagi/libs/token_transform/synthlang_/resources/frameworks/reflective_patterns.toml,sha256=LxBIVLHNLfvVdXjLAzqivrYaHNix514DLNYsbA-VSQ4,5730
 lionagi/libs/token_transform/synthlang_/resources/frameworks/set_theory.toml,sha256=SZpBvUySZ3_0pIrRko24a3KfbPHd55LyNwzFHyznjs4,1457
 lionagi/libs/token_transform/synthlang_/resources/frameworks/topology_fundamentals.toml,sha256=nnhfbIJQ5pTGlX7lo1XzjyOevaZOHuusvBuhwWHzbLk,1008
-lionagi/libs/token_transform/synthlang_/resources/mapping/lion_emoji_mapping.toml,sha256=CPbqoh691wfZ3Xe49iLEWGJoaIbRUyDgn2_bFlvH72E,1322
-lionagi/libs/token_transform/synthlang_/resources/mapping/python_math_mapping.toml,sha256=3ElxIfm7Kn_f8n6fHDENhC29Z3IlofUXjwNTEAjRQMQ,963
-lionagi/libs/token_transform/synthlang_/resources/mapping/rust_chinese_mapping.toml,sha256=IU5qOB-a_ZJI_wMOa0OJu3foAp6tIdvegnVt-yw5URM,1216
+lionagi/libs/token_transform/synthlang_/resources/mapping/lion_emoji_mapping.toml,sha256=THLrry9RTHMCMv-g6VCwrlaE4_9_fjXkABgyAyhokew,1323
+lionagi/libs/token_transform/synthlang_/resources/mapping/python_math_mapping.toml,sha256=Q0MqTf9t5rWuKHLsKu9WS8NSBSb9FsGAAaG5EYQiGCA,964
+lionagi/libs/token_transform/synthlang_/resources/mapping/rust_chinese_mapping.toml,sha256=o-7KACVDQYkpAGSFgsMCeIy_S93CilUP9w1ZKM0w62A,1217
 lionagi/libs/token_transform/synthlang_/resources/utility/base_synthlang_system_prompt.toml,sha256=8xhY14WdDRF6GIToqzRPM7EjM6-uO6-hQ9Muei1A2Iw,3458
 lionagi/libs/validate/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/libs/validate/common_field_validators.py,sha256=1BHznXnJYcLQrHqvHKUnP6aqCptuQ0qN7KJRCExcJBU,4778
@@ -92,7 +92,7 @@ lionagi/operations/types.py,sha256=fM8HphnbBifMzhoKKvdl3JxGCBHlEGPJEYkLWj9b7vE,7
 lionagi/operations/utils.py,sha256=Cl4HuWQ1nCGkTexwOtDx7fpEWMc2L3ZQMCqylRBDy74,1219
 lionagi/operations/ReAct/ReAct.py,sha256=uoJnFMoPP1kzzmgLDFNBwEbWdfGNfG37IT22N1AM-hE,13504
 lionagi/operations/ReAct/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
-lionagi/operations/ReAct/utils.py,sha256=84Giel5ToqfbN5F6Tm0uw8yZTTnxiM_jWuFEhnKOxM8,3800
+lionagi/operations/ReAct/utils.py,sha256=w8hf8-L1VCV5ZF8gjeFBfR81tmO9u2Ud2Wz3VlUn7AU,4437
 lionagi/operations/_act/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/operations/_act/act.py,sha256=l1-mrOoWLP0reATBD4PTqGyuSUSH41sL6YbfzzFfJMk,2811
 lionagi/operations/brainstorm/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
@@ -220,7 +220,7 @@ lionagi/tools/file/writer.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,
 lionagi/tools/file/providers/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/tools/file/providers/docling_.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/tools/query/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
-lionagi-0.10.2.dist-info/METADATA,sha256=Z0QWQpl1aCFgNhWCem5QNx5BJmYPOG_gXyDpiiLQW3E,18464
-lionagi-0.10.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lionagi-0.10.2.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
-lionagi-0.10.2.dist-info/RECORD,,
+lionagi-0.10.3.dist-info/METADATA,sha256=NX6-ma5E2CK-UUTpfp6aZXUXuWHI2OukvBSRSUHjBzc,18464
+lionagi-0.10.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lionagi-0.10.3.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.10.3.dist-info/RECORD,,