lionagi 0.10.1__tar.gz → 0.10.3__tar.gz

{lionagi-0.10.1 → lionagi-0.10.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.10.1
+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.1 → lionagi-0.10.3}/lionagi/_types.py

@@ -1 +1,2 @@
+from .fields import *
 from .protocols.types import *

{lionagi-0.10.1 → lionagi-0.10.3}/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-0.10.3/lionagi/fields/__init__.py

@@ -0,0 +1,29 @@
+from .action import ActionRequestModel, ActionResponseModel
+from .base import (
+    CodeSnippet,
+    Outline,
+    OutlineItem,
+    Section,
+    Source,
+    TextSnippet,
+)
+from .file import CodeFile, Documentation, File
+from .instruct import Instruct, InstructResponse
+from .reason import Reason
+
+__all__ = (
+    "ActionRequestModel",
+    "ActionResponseModel",
+    "Source",
+    "TextSnippet",
+    "CodeSnippet",
+    "Section",
+    "OutlineItem",
+    "Outline",
+    "File",
+    "CodeFile",
+    "Documentation",
+    "Instruct",
+    "InstructResponse",
+    "Reason",
+)

{lionagi-0.10.1/lionagi/libs → lionagi-0.10.3/lionagi}/fields/action.py

@@ -16,9 +16,7 @@ from lionagi.utils import to_dict, to_json, to_list
 
 __all__ = (
     "ActionRequestModel",
-    "ACTION_REQUESTS_FIELD",
     "ActionResponseModel",
-    "ACTION_RESPONSES_FIELD",
 )
 
 

lionagi-0.10.3/lionagi/fields/base.py

@@ -0,0 +1,151 @@
+from enum import Enum
+
+from pydantic import Field, HttpUrl
+
+from lionagi.models import HashableModel
+
+__all__ = (
+    "Source",
+    "TextSnippet",
+    "CodeSnippet",
+    "Section",
+    "OutlineItem",
+    "Outline",
+)
+
+
+class Source(HashableModel):
+    """
+    Represents a citation or external source, such as:
+     - a website,
+     - documentation link,
+     - research paper,
+     - or any external resource.
+    """
+
+    title: str = Field(
+        ...,
+        description="Short label or title for the reference (e.g. 'Pydantic Docs', 'RFC 3986').",
+    )
+
+    url: str | HttpUrl | None = Field(
+        None,
+        description="Full URL or local path pointing to the resource. Must conform to standard URL format.",
+    )
+
+    note: str | None = Field(
+        default=None,
+        description=(
+            "Optional additional note explaining why this reference is relevant or what it contains."
+        ),
+    )
+
+
+class SnippetType(str, Enum):
+    TEXT = "text"
+    CODE = "code"
+
+
+class TextSnippet(HashableModel):
+    """
+    Specialized snippet for textual/prose content.
+    """
+
+    type: SnippetType = Field(
+        SnippetType.TEXT,
+        description=(
+            "Must be 'text' for textual snippets. Ensures explicit type distinction."
+        ),
+    )
+    content: str = Field(
+        ...,
+        description=(
+            "The actual text. Can be a paragraph, bullet list, or any narrative content."
+        ),
+    )
+
+
+class CodeSnippet(HashableModel):
+    """
+    Specialized snippet for source code or command-line examples.
+    """
+
+    type: SnippetType = Field(
+        SnippetType.CODE,
+        description=(
+            "Must be 'code' for code snippets. Allows separate handling or formatting."
+        ),
+    )
+    content: str = Field(
+        ...,
+        description=(
+            "The actual code or command sequence. Should be well-formatted so it can be rendered properly."
+        ),
+    )
+
+
+class Section(HashableModel):
+    """
+    A single section of a document or article. Each section has:
+     - A title
+     - A sequential list of content snippets (text or code),
+       which appear in the intended reading order.
+     - Optional sources specifically cited in this section.
+    """
+
+    title: str = Field(
+        ...,
+        description=(
+            "The section heading or label, e.g., 'Introduction', 'Implementation Steps'."
+        ),
+    )
+    snippets: list[TextSnippet | CodeSnippet] = Field(
+        default_factory=list,
+        description=(
+            "Ordered list of content snippets. Could be multiple text blocks, code examples, etc."
+        ),
+    )
+
+    sources: list[Source] = Field(
+        default_factory=list,
+        description=(
+            "References specifically cited in this section. "
+            "If sources are stored at the doc-level, this can be omitted."
+        ),
+    )
+
+
+class OutlineItem(HashableModel):
+    """
+    Represents a single outline item, which could become a full section later.
+    """
+
+    heading: str = Field(
+        ...,
+        description="Short name or label for this item, e.g., 'Chapter 1: Basics'.",
+    )
+    summary: str | None = Field(
+        default=None,
+        description=(
+            "A brief description of what this section will cover, if known."
+        ),
+    )
+
+
+class Outline(HashableModel):
+    """
+    A top-level outline for a document or article.
+    Usually used in early planning stages.
+    """
+
+    topic: str = Field(
+        ..., description="Working title or overarching topic of the document."
+    )
+    items: list[OutlineItem] = Field(
+        default_factory=list,
+        description="List of major outline points or sections planned.",
+    )
+    notes: str | None = Field(
+        default=None,
+        description="Any additional remarks, questions, or brainstorming notes for the outline.",
+    )

{lionagi-0.10.1/lionagi/libs → lionagi-0.10.3/lionagi}/fields/file.py

@@ -1,26 +1,29 @@
 from pathlib import Path
 
-from pydantic import BaseModel, Field, field_validator
+from pydantic import Field, field_validator
 
-from lionagi.models import FieldModel
+from .base import HashableModel, Source
 
-
-class Source(BaseModel):
-    title: str | None = None
-    url: str | None = None
+__all__ = (
+    "File",
+    "CodeFile",
+    "Documentation",
+)
 
 
-class File(BaseModel):
+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",
@@ -32,8 +35,8 @@ class File(BaseModel):
         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\"; }'"
         ),
@@ -41,8 +44,9 @@ class File(BaseModel):
     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.",
@@ -56,6 +60,38 @@ class File(BaseModel):
             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):
     """
@@ -83,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!")',
@@ -112,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,
@@ -125,23 +157,22 @@ class Documentation(File):
         ),
     )
 
-
-FILE_FIELD = FieldModel(
-    name="file",
-    annotation=File | None,
-    default=None,
-)
-
-CODE_FILE_FIELD = FieldModel(
-    name="code_file",
-    annotation=CodeFile | None,
-    default=None,
-)
-
-DOCUMENTATION_FIELD = FieldModel(
-    name="documentation",
-    annotation=Documentation | None,
-    default=None,
-)
-
-# File: lionagi/libs/fields/file.py
+    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-0.10.1/lionagi/libs → lionagi-0.10.3/lionagi}/fields/instruct.py

@@ -16,8 +16,6 @@ from lionagi.utils import to_num
 __all__ = (
     "Instruct",
     "InstructResponse",
-    "INSTRUCT_FIELD",
-    "LIST_INSTRUCT_FIELD",
 )
 
 
@@ -150,4 +148,4 @@ LIST_INSTRUCT_FIELD_MODEL = FieldModel(
     default=None,
 )
 
-# File: lionagi/libs/fields/instruct.py
+# File: lionagi/fields/instruct.py

{lionagi-0.10.1/lionagi/libs → lionagi-0.10.3/lionagi}/fields/reason.py

@@ -7,12 +7,7 @@ from pydantic import BaseModel, Field, field_validator
 from lionagi.models import FieldModel
 from lionagi.utils import to_num
 
-__all__ = (
-    "Reason",
-    "REASON_FIELD",
-    "CONFIDENCE_SCORE_FIELD",
-    "validate_confidence_score",
-)
+__all__ = ("Reason",)
 
 
 class Reason(BaseModel):
@@ -27,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")
@@ -51,15 +45,6 @@ def validate_confidence_score(cls, v):
         return -1
 
 
-CONFIDENCE_SCORE_FIELD = FieldModel(
-    name="confidence_score",
-    annotation=float | None,
-    default=None,
-    validator=validate_confidence_score,
-    validator_kwargs={"mode": "before"},
-)
-
-
 REASON_FIELD = FieldModel(
     name="reason",
     annotation=Reason | None,
@@ -67,4 +52,4 @@ REASON_FIELD = FieldModel(
     description="**Provide a concise reason for the decision made.**",
 )
 
-# File: lionagi/libs/fields/reason.py
+# File: lionagi/fields/reason.py

lionagi-0.10.3/lionagi/libs/package/imports.py

@@ -0,0 +1,21 @@
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from lionagi.utils import (
+    check_import,
+    import_module,
+    install_import,
+    is_import_installed,
+    run_package_manager_command,
+)
+
+# backward compatibility
+
+__all__ = (
+    "run_package_manager_command",
+    "check_import",
+    "import_module",
+    "install_import",
+    "is_import_installed",
+)

{lionagi-0.10.1 → lionagi-0.10.3}/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-0.10.1 → lionagi-0.10.3}/lionagi/libs/token_transform/synthlang_/resources/frameworks/framework_options.json

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

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/libs/token_transform/synthlang_/resources/mapping/lion_emoji_mapping.toml

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

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/libs/token_transform/synthlang_/resources/mapping/python_math_mapping.toml

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

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/libs/token_transform/synthlang_/resources/mapping/rust_chinese_mapping.toml

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

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/ReAct/ReAct.py

@@ -8,7 +8,7 @@ from typing import TYPE_CHECKING, Any, Literal
 
 from pydantic import BaseModel
 
-from lionagi.libs.fields.instruct import Instruct
+from lionagi.fields.instruct import Instruct
 from lionagi.libs.schema.as_readable import as_readable
 from lionagi.libs.validate.common_field_validators import (
     validate_model_to_type,

{lionagi-0.10.1 → lionagi-0.10.3}/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-0.10.1 → lionagi-0.10.3}/lionagi/operations/_act/act.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING
 
 from pydantic import BaseModel
 
-from lionagi.libs.fields.action import ActionResponseModel
+from lionagi.fields.action import ActionResponseModel
 from lionagi.protocols.types import ActionRequest, Log
 
 if TYPE_CHECKING:

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/brainstorm/brainstorm.py

@@ -7,7 +7,7 @@ from typing import Any, Literal
 
 from pydantic import BaseModel
 
-from lionagi.libs.fields.instruct import (
+from lionagi.fields.instruct import (
     LIST_INSTRUCT_FIELD_MODEL,
     Instruct,
     InstructResponse,

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/instruct/instruct.py

@@ -4,7 +4,7 @@
 
 from typing import TYPE_CHECKING, Any
 
-from lionagi.libs.fields.instruct import Instruct
+from lionagi.fields.instruct import Instruct
 
 if TYPE_CHECKING:
     from lionagi.session.branch import Branch

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/operate/operate.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Literal
 
 from pydantic import BaseModel, JsonValue
 
-from lionagi.libs.fields.instruct import Instruct
+from lionagi.fields.instruct import Instruct
 from lionagi.models import FieldModel, ModelParams
 from lionagi.protocols.types import (
     Instruction,

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/plan/plan.py

@@ -6,7 +6,7 @@ from typing import Any, Literal
 
 from pydantic import BaseModel
 
-from lionagi.libs.fields.instruct import (
+from lionagi.fields.instruct import (
     LIST_INSTRUCT_FIELD_MODEL,
     Instruct,
     InstructResponse,

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/select/select.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Any
 
 from pydantic import BaseModel
 
-from lionagi.libs.fields.instruct import Instruct
+from lionagi.fields.instruct import Instruct
 
 from .utils import SelectionModel
 

{lionagi-0.10.1 → lionagi-0.10.3}/lionagi/operations/utils.py

@@ -2,7 +2,7 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-from lionagi.libs.fields.instruct import Instruct
+from lionagi.fields.instruct import Instruct
 from lionagi.session.session import Branch, Session