lionagi 0.10.2__py3-none-any.whl → 0.10.4__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,
@@ -10,11 +7,8 @@ from .base import (
     Source,
     TextSnippet,
 )
-from .file import CodeFile, Documentation, File
-from .instruct import (
-    Instruct,
-    InstructResponse,
-)
+from .file import Documentation, File, Module, ResearchSummary
+from .instruct import Instruct, InstructResponse
 from .reason import Reason
 
 __all__ = (
@@ -27,7 +21,8 @@ __all__ = (
     "OutlineItem",
     "Outline",
     "File",
-    "CodeFile",
+    "Module",
+    "ResearchSummary",
     "Documentation",
     "Instruct",
     "InstructResponse",

lionagi/fields/code.py

@@ -0,0 +1,236 @@
+from enum import Enum
+
+from pydantic import Field
+
+from lionagi.models import HashableModel
+
+__all__ = (
+    "ParameterKind",
+    "Parameter",
+    "Decorator",
+    "Import",
+    "Attribute",
+    "Function",
+    "Method",
+    "Class",
+    "Module",
+)
+
+
+class ParameterKind(str, Enum):
+    """
+    Distinguishes how a function/method parameter is used.
+    Primarily inspired by Python's param categories, but can be ignored by simpler languages.
+    Pay attention to the languege's own conventions for parameter handling.
+    """
+
+    POSITIONAL_ONLY = "positional_only"  # E.g. Python's '/'-based params
+    POSITIONAL_OR_KEYWORD = "positional_or_keyword"  # Default for many
+    VAR_POSITIONAL = "var_positional"  # *args-like
+    KEYWORD_ONLY = "keyword_only"  # Python's '*' marker
+    VAR_KEYWORD = "var_keyword"  # **kwargs-like
+
+
+class Parameter(HashableModel):
+    """
+    Represents one parameter in a function or method signature.
+    """
+
+    name: str = Field(
+        ...,
+        description="Exact identifier for the parameter (e.g., 'user_id', 'self', 'arg').",
+    )
+    type: str | None = Field(
+        default=None,
+        description=(
+            "Type annotation as a string (e.g., 'str', 'int', 'SomeClass'). None if untyped or not declared."
+        ),
+    )
+    default_value_repr: str | None = Field(
+        default=None,
+        description=(
+            "String representation of default value if present (e.g., 'None', '10', '\"hi\"'). "
+            "None if parameter is required with no default."
+        ),
+    )
+    kind: ParameterKind = Field(
+        default=ParameterKind.POSITIONAL_OR_KEYWORD,
+        description=(
+            "Parameter's calling convention category. 'positional_or_keyword' is typical if unspecified."
+        ),
+    )
+
+
+class Decorator(HashableModel):
+    """
+    A decorator or annotation attached to a function, class, or method.
+    Common in Python (@deco), Java (@Override), .NET ([Attribute]), etc.
+    """
+
+    name: str = Field(
+        ...,
+        description="Decorator/annotation name (e.g., '@staticmethod', '[ApiController]', '@Override').",
+    )
+    arguments_repr: list[str] | None = Field(
+        default=None,
+        description=(
+            "If this decorator/annotation is called with arguments, provide them as a list of string expressions "
+            "(e.g., `['\"/home\"', 'methods=[\"GET\"]']`). None if no arguments."
+        ),
+    )
+
+
+class Import(HashableModel):
+    """
+    Represents an import/using/include statement. Merges Python's 'import X' and 'from Y import Z' logic.
+    Other languages can interpret accordingly.
+    """
+
+    module: str | None = Field(
+        default=None,
+        description=(
+            "The module/package/namespace from which symbols are imported (e.g., 'os.path', 'java.util'). "
+            "None for a direct import statement like 'import X' if no sub-path is specified."
+        ),
+    )
+    name: str = Field(
+        ...,
+        description=(
+            "The symbol or module being imported (e.g., 'os', 'List', 'time', '*')."
+        ),
+    )
+    alias: str | None = Field(
+        default=None,
+        description="Alias name if used ('import X as Y'), else None.",
+    )
+    level: int = Field(
+        default=0,
+        description=(
+            "For Pythonic relative imports. Number of leading dots. 0 if absolute or not applicable."
+        ),
+    )
+
+
+class Attribute(HashableModel):
+    """
+    A variable/constant/field at class or module level. Possibly static/final, with an initial value.
+    """
+
+    name: str = Field(
+        ...,
+        description="Identifier for this attribute/field (e.g., 'MAX_CONNECTIONS', 'version').",
+    )
+    type: str | None = Field(
+        default=None,
+        description="String type annotation if declared. None if untyped.",
+    )
+    initial_value_repr: str | None = Field(
+        default=None,
+        description="String representation of any initial value (e.g., '100', 'true', 'None'). None if uninitialized.",
+    )
+    is_static: bool = Field(
+        default=False,
+        description="True if this is a static (class-level) attribute. Otherwise instance-level or module-level.",
+    )
+    is_final: bool = Field(
+        default=False,
+        description="True if this attribute/field is read-only/const/final after initialization.",
+    )
+    visibility: str | None = Field(
+        default=None,
+        description="Optional access modifier (e.g., 'public', 'private', 'protected'). None if default or not applicable.",
+    )
+
+
+class Function(HashableModel):
+    """
+    Represents a standalone function or procedure.
+    For methods (attached to classes), see 'Method' below.
+    """
+
+    name: str = Field(
+        ..., description="Function name identifier (e.g., 'process_data')."
+    )
+    parameters: list[Parameter] = Field(
+        default_factory=list,
+        description="Ordered list of Parameter objects for this function.",
+    )
+    return_type: str | None = Field(
+        default=None,
+        description="Return type string if declared. None if not declared or no explicit type.",
+    )
+    is_async: bool = Field(
+        default=False,
+        description="True if an 'async' function in languages that support it. Else False.",
+    )
+    docstring: str | None = Field(
+        default=None,
+        description="Documentation string or comment describing this function.",
+    )
+    decorators: list[Decorator] = Field(
+        default_factory=list,
+        description="List of decorators/annotations on this function (e.g., @staticmethod).",
+    )
+
+
+class Method(Function):
+    """
+    A function bound to a class, including potential method-specific flags (static, abstract, etc.).
+    Inherits fields from 'Function.'
+    """
+
+    is_static: bool = Field(
+        default=False,
+        description="True if method is static (no instance or 'self' needed).",
+    )
+    is_classmethod: bool = Field(
+        default=False,
+        description="True if method is recognized as a class method (receives class as first arg).",
+    )
+    is_abstract: bool = Field(
+        default=False,
+        description="True if the method is abstract (no concrete implementation).",
+    )
+    visibility: str | None = Field(
+        default=None,
+        description="Access level like 'public', 'private', etc., if relevant to the language.",
+    )
+
+
+class Class(HashableModel):
+    """
+    Represents a class, interface, or other composite type, with optional docstring, attributes, methods, etc.
+    """
+
+    name: str = Field(
+        ...,
+        description="Class/struct/interface name (e.g., 'UserRepository', 'MyDataClass').",
+    )
+    base_types: list[str] = Field(
+        default_factory=list,
+        description="List of parent classes or interfaces by name. Empty if none.",
+    )
+    is_abstract: bool = Field(
+        default=False,
+        description="True if this is an abstract class (cannot be instantiated directly).",
+    )
+    is_interface: bool = Field(
+        default=False,
+        description="True if this represents an interface definition rather than a concrete class.",
+    )
+    docstring: str | None = Field(
+        default=None,
+        description="Documentation for the class/interface, if any.",
+    )
+    decorators: list[Decorator] = Field(
+        default_factory=list,
+        description="Class-level decorators/annotations (e.g., @dataclass).",
+    )
+    attributes: list[Attribute] = Field(
+        default_factory=list,
+        description="Fields or properties declared at class level.",
+    )
+    methods: list[Method] = Field(
+        default_factory=list,
+        description="List of Method objects representing this class's methods.",
+    )

lionagi/fields/file.py

@@ -1,27 +1,33 @@
+from abc import abstractmethod
 from pathlib import Path
 
 from pydantic import Field, field_validator
 
 from .base import HashableModel, Source
+from .code import Class, Function, Import
+from .research import PotentialRisk, ResearchFinding
 
 __all__ = (
     "File",
-    "CodeFile",
     "Documentation",
+    "ResearchSummary",
+    "Module",
 )
 
 
 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",
@@ -29,21 +35,12 @@ class File(HashableModel):
             "/absolute/path/to/my_file.txt",
         ],
     )
-    content: str | None = Field(
-        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"
-            "  - '# My Title\\nSome description...'\n"
-            "  - 'function greet() { return \"Hello\"; }'"
-        ),
-    )
     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,40 +54,34 @@ class File(HashableModel):
             return str(value)
         return value
 
+    @abstractmethod
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+    ) -> str:
+        pass
 
-class CodeFile(File):
-    """
-    Represents a code file with an identifiable programming language. Inherits
-    from the generic File model but specializes for code-related content.
-    """
+    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
 
-    language: str | None = Field(
-        default=None,
-        description=(
-            "Indicate the programming language of this code file. "
-            "LLMs or humans can use this info to apply specific formatting or syntax analysis."
-        ),
-        examples=[
-            "python",
-            "json",
-            "typescript",
-            "html",
-            "css",
-            "java",
-            "cpp",
-        ],
-    )
-    content: str | None = Field(
-        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"
-        ),
-        examples=[
-            'def my_function():\\n    print("Hello, world!")',
-            'export function greet(): string { return "Hello"; }',
-        ],
-    )
+        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 Documentation(File):
@@ -113,10 +104,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 +113,119 @@ class Documentation(File):
         ),
     )
 
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+        include_source: bool = True,
+    ) -> 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 (header or "") + self.content + footer
+
+
+class ResearchSummary(Documentation):
+    """
+    Captures the final outcome of the deep research process.
+    """
+
+    scope: str | None = Field(
+        default=None,
+        description="Brief statement of what was investigated. E.g., 'Surveyed python-based ORMs.'",
+    )
+    main_takeaways: str = Field(
+        ...,
+        description="High-level summary of the most critical insights for the project.",
+    )
+    findings: list[ResearchFinding] = Field(
+        default_factory=list,
+        description="List of key facts or knowledge gained.",
+    )
+    risks: list[PotentialRisk] = Field(
+        default_factory=list,
+        description="Identified obstacles or concerns for the project.",
+    )
+
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+    ) -> str:
+        """
+        Renders the documentation content, optionally including citations for sources.
+        """
+        content = self.model_dump(exclude_unset=True, exclude_none=True)
+
+        from lionagi.libs.schema.as_readable import as_readable
+
+        text = as_readable(content, md=True, format_curly=True)
+
+        footer = footer or ""
+        if 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 (header or "") + text + footer
+
+
+class Module(File):
+    """
+    Represents a single source file: docstring, imports, top-level functions, classes, etc.
+    """
+
+    name: str = Field(
+        ...,
+        description="Logical name for this file/module (e.g., 'utils', 'main', 'data_models').",
+    )
+    path: str | None = Field(
+        default=None,
+        description="Filesystem path if known (e.g., 'src/utils.py').",
+    )
+    docstring: str | None = Field(
+        default=None, description="File-level docstring or comments if any."
+    )
+    imports: list[Import] = Field(
+        default_factory=list,
+        description="All import statements / using directives / includes in this file.",
+    )
+    classes: list[Class] = Field(
+        default_factory=list,
+        description="All class or interface definitions in this file.",
+    )
+    functions: list[Function] = Field(
+        default_factory=list,
+        description="All top-level (non-class) functions in this file.",
+    )
+    variables: list = Field(
+        default_factory=list,
+        description="All top-level variables/constants in this file.",
+    )
+    language: str = Field(
+        default_factory=str,
+        description=(
+            "Indicate the programming language of this code file. e.g., 'python', 'typescript'. "
+            "LLMs or humans can use this info to apply specific formatting or syntax analysis."
+        ),
+    )
+
+    def render_content(
+        self,
+        header: str | None = None,
+        footer: str | None = None,
+    ) -> str:
+        """
+        Renders the documentation content, optionally including citations for sources.
+        """
+        text = self.model_dump_json(exclude_none=True, exclude_unset=True)
+        return header or "" + text + footer or ""
+
 
 # File: lionagi/fields/file.py

lionagi/fields/reason.py

@@ -2,15 +2,15 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-from pydantic import BaseModel, Field, field_validator
+from pydantic import Field, field_validator
 
-from lionagi.models import FieldModel
+from lionagi.models import FieldModel, HashableModel
 from lionagi.utils import to_num
 
 __all__ = ("Reason",)
 
 
-class Reason(BaseModel):
+class Reason(HashableModel):
 
     title: str | None = None
     content: str | None = None
@@ -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/fields/research.py

@@ -0,0 +1,49 @@
+from pydantic import Field
+
+from lionagi.models import HashableModel
+
+from .base import CodeSnippet, TextSnippet
+
+__all__ = (
+    "ResearchFinding",
+    "PotentialRisk",
+    "ResearchSummary",
+)
+
+
+class ResearchFinding(HashableModel):
+    """
+    A single piece of information or insight from the research phase.
+    """
+
+    summary: str = Field(
+        ...,
+        description="Concise text describing the discovered fact, concept, or best practice.",
+    )
+    snippets: list[TextSnippet | CodeSnippet] = Field(
+        default_factory=list,
+        description="Ordered list of content snippets (text or code) that illustrate or support the finding.",
+    )
+    relevance: str | None = Field(
+        default=None,
+        description="Why this finding matters to the project. E.g., 'Helps solve concurrency issue.'",
+    )
+
+
+class PotentialRisk(HashableModel):
+    """
+    Identifies a risk or challenge discovered during research.
+    """
+
+    description: str = Field(
+        ...,
+        description="Short text describing the risk. E.g., 'Scalability concerns with chosen DB'.",
+    )
+    impact: str | None = Field(
+        default=None,
+        description="Possible consequences if not mitigated. E.g., 'System slowdown, possible downtime.'",
+    )
+    mitigation_ideas: str | None = Field(
+        default=None,
+        description="Preliminary ways to reduce or handle this risk.",
+    )

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.4"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.10.2
+Version: 0.10.4
 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.4.dist-info}/RECORD

@@ -4,23 +4,25 @@ 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=fGZMaoPHZfTX9I4TDkr07gp-kj_1U_SD-gjQC_2flQs,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=8oU7Vfk-fKiULFKqhM6VpJMqdZcVXPTM7twVfNDN_SQ,603
 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/code.py,sha256=TFym51obzaSfCmeRoHZJyBtjfDI4tvl9F-1sjFc9rMw,7713
+lionagi/fields/file.py,sha256=DhQ_HE0RvTNzkvBGQHRgbMYSokDkzE8GEu814i6jw5Q,7297
 lionagi/fields/instruct.py,sha256=sMbCxEv0HQLa31JkJDmdrWWEzIfeKbcmN2hYOehz3Q0,4773
-lionagi/fields/reason.py,sha256=TY2zQbounGU4DGDhbBqBW-jJPuJHmcoePSCKLgJxaL0,1460
+lionagi/fields/reason.py,sha256=3Ksz9_40dI-oQ9VtmpnYAmJdeDDIO-TwLDrf1ijbXGM,1438
+lionagi/fields/research.py,sha256=2x6SFDwMSwzl4uHHUBbhT8mgwa49MsEy1NaUIb84MHU,1405
 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 +60,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 +94,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 +222,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.4.dist-info/METADATA,sha256=NQTeKO05k_YvV-OvrUO3ZwOemMxHwvzqdidzxPeJJNk,18464
+lionagi-0.10.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lionagi-0.10.4.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.10.4.dist-info/RECORD,,