lionagi 0.3.6__py3-none-any.whl → 0.3.7__py3-none-any.whl

lionagi/core/collections/abc/component.py

@@ -1,11 +1,11 @@
 """Component class, base building block in LionAGI."""
 
 import contextlib
-from abc import ABC
-from collections.abc import Sequence
 from functools import singledispatchmethod
-from typing import Any, Type, TypeAlias, TypeVar, Union
+from typing import Any, TypeAlias, TypeVar, Union
 
+import lionfuncs as ln
+from lionabc import Observable
 from pandas import DataFrame, Series
 from pydantic import AliasChoices, BaseModel, Field, ValidationError
 
@@ -22,7 +22,13 @@ T = TypeVar("T")
 _init_class = {}
 
 
-class Element(BaseModel, ABC):
+def change_dict_key(dict_: dict, old_key: str, new_key: str) -> None:
+    """Change a key in a dictionary."""
+    if old_key in dict_:
+        dict_[new_key] = dict_.pop(old_key)
+
+
+class Element(BaseModel, Observable):
     """Base class for elements within the LionAGI system.
 
     Attributes:
@@ -31,15 +37,14 @@ class Element(BaseModel, ABC):
     """
 
     ln_id: str = Field(
-        default_factory=SysUtil.create_id,
+        default_factory=SysUtil.id,
         title="ID",
-        description="A 32-char unique hash identifier.",
         frozen=True,
         validation_alias=AliasChoices("node_id", "ID", "id"),
     )
 
     timestamp: str = Field(
-        default_factory=lambda: SysUtil.get_timestamp(sep=None)[:-6],
+        default_factory=lambda: ln.time(type_="iso"),
         title="Creation Timestamp",
         description="The UTC timestamp of creation",
         frozen=True,
@@ -57,7 +62,7 @@ class Element(BaseModel, ABC):
         return True
 
 
-class Component(Element, ABC):
+class Component(Element):
     """
     Represents a distinguishable, temporal entity in LionAGI.
 
@@ -195,17 +200,15 @@ class Component(Element, ABC):
         """Create a Component instance from a LlamaIndex object."""
         dict_ = obj.to_dict()
 
-        SysUtil.change_dict_key(dict_, "text", "content")
+        change_dict_key(dict_, "text", "content")
         metadata = dict_.pop("metadata", {})
 
         for field in llama_meta_fields:
             metadata[field] = dict_.pop(field, None)
 
-        SysUtil.change_dict_key(metadata, "class_name", "llama_index_class")
-        SysUtil.change_dict_key(metadata, "id_", "llama_index_id")
-        SysUtil.change_dict_key(
-            metadata, "relationships", "llama_index_relationships"
-        )
+        change_dict_key(metadata, "class_name", "llama_index_class")
+        change_dict_key(metadata, "id_", "llama_index_id")
+        change_dict_key(metadata, "relationships", "llama_index_relationships")
 
         dict_["metadata"] = metadata
         return cls.from_obj(dict_)
@@ -244,7 +247,7 @@ class Component(Element, ABC):
     @classmethod
     def _process_langchain_dict(cls, dict_: dict) -> dict:
         """Process a dictionary containing Langchain-specific data."""
-        SysUtil.change_dict_key(dict_, "page_content", "content")
+        change_dict_key(dict_, "page_content", "content")
 
         metadata = dict_.pop("metadata", {})
         metadata.update(dict_.pop("kwargs", {}))
@@ -264,9 +267,9 @@ class Component(Element, ABC):
             if field in dict_:
                 metadata[field] = dict_.pop(field)
 
-        SysUtil.change_dict_key(metadata, "lc", "langchain")
-        SysUtil.change_dict_key(metadata, "type", "lc_type")
-        SysUtil.change_dict_key(metadata, "id", "lc_id")
+        change_dict_key(metadata, "lc", "langchain")
+        change_dict_key(metadata, "type", "lc_type")
+        change_dict_key(metadata, "id", "lc_id")
 
         extra_fields = {
             k: v for k, v in metadata.items() if k not in lc_meta_fields
@@ -298,9 +301,9 @@ class Component(Element, ABC):
         dict_["metadata"] = meta_
 
         if "ln_id" not in dict_:
-            dict_["ln_id"] = meta_.pop("ln_id", SysUtil.create_id())
+            dict_["ln_id"] = meta_.pop("ln_id", SysUtil.id())
         if "timestamp" not in dict_:
-            dict_["timestamp"] = SysUtil.get_timestamp(sep=None)[:-6]
+            dict_["timestamp"] = ln.time(type_="iso")
         if "metadata" not in dict_:
             dict_["metadata"] = {}
         if "extra_fields" not in dict_:
@@ -453,13 +456,13 @@ class Component(Element, ABC):
             ninsert(
                 self.metadata,
                 ["last_updated", name],
-                SysUtil.get_timestamp(sep=None)[:-6],
+                ln.time(type_="iso")[:-6],
             )
         elif isinstance(a, tuple) and isinstance(a[0], int):
             nset(
                 self.metadata,
                 ["last_updated", name],
-                SysUtil.get_timestamp(sep=None)[:-6],
+                ln.time(type_="iso")[:-6],
             )
 
     def _meta_pop(self, indices, default=...):
@@ -614,10 +617,4 @@ LionIDable: TypeAlias = Union[str, Element]
 
 def get_lion_id(item: LionIDable) -> str:
     """Get the Lion ID of an item."""
-    if isinstance(item, Sequence) and len(item) == 1:
-        item = item[0]
-    if isinstance(item, str) and len(item) == 32:
-        return item
-    if getattr(item, "ln_id", None) is not None:
-        return item.ln_id
-    raise LionTypeError("Item must be a single LionIDable object.")
+    return SysUtil.get_id(item)

lionagi/core/collections/abc/concepts.py

@@ -227,12 +227,6 @@ class Sendable(BaseModel, ABC):
             return value
 
         a = get_lion_id(value)
-        if not isinstance(a, str) or len(a) != 32:
-            raise LionTypeError(
-                "Invalid sender or recipient value. "
-                "Expected a valid node id or one of "
-                "'system' or 'user'."
-            )
         return a
 
 

lionagi/core/collections/flow.py

@@ -1,7 +1,6 @@
 import contextlib
 from collections import deque
 from collections.abc import Mapping
-from typing import Tuple
 
 from pydantic import Field
 

lionagi/core/collections/model.py

@@ -1,6 +1,7 @@
 import asyncio
 import os
 
+import lionfuncs as ln
 import numpy as np
 from dotenv import load_dotenv
 
@@ -91,8 +92,8 @@ class iModel:
             service (BaseService, optional): An instance of BaseService.
             **kwargs: Additional parameters for the model.
         """
-        self.ln_id: str = SysUtil.create_id()
-        self.timestamp: str = SysUtil.get_timestamp(sep=None)[:-6]
+        self.ln_id: str = SysUtil.id()
+        self.timestamp: str = ln.time(type_="iso")
         self.endpoint = endpoint
         self.allowed_parameters = allowed_parameters
         if isinstance(provider, type):

lionagi/core/collections/pile.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import asyncio
 from collections.abc import AsyncIterator, Callable, Iterable
 from functools import wraps
-from typing import Any, Generic, Type, TypeVar
+from typing import Any, Generic, TypeVar
 
 from pydantic import Field, field_validator
 

lionagi/core/collections/progression.py

@@ -1,9 +1,8 @@
 import contextlib
 
+import lionfuncs as ln
 from pydantic import Field, field_validator
 
-from lionagi.libs import SysUtil
-
 from .abc import Element, ItemNotFoundError, LionIDable, Ordering, get_lion_id
 from .util import _validate_order
 
@@ -90,7 +89,7 @@ class Progression(Element, Ordering):
         """Remove the next occurrence of an item from the progression."""
         if item in self:
             item = self._validate_order(item)
-            l_ = SysUtil.create_copy(self.order)
+            l_ = ln.copy(self.order)
 
             with contextlib.suppress(Exception):
                 for i in item:
@@ -143,7 +142,7 @@ class Progression(Element, Ordering):
     def __radd__(self, other):
         if not isinstance(other, Progression):
             _copy = self.copy()
-            l_ = SysUtil.create_copy(_copy.order)
+            l_ = ln.copy(_copy.order)
             l_.insert(0, get_lion_id(other))
             _copy.order = l_
             return _copy
@@ -190,7 +189,7 @@ class Progression(Element, Ordering):
 
     def __list__(self):
         """Return a list representation of the progression."""
-        return SysUtil.create_copy(self.order)
+        return ln.copy(self.order)
 
     def __reversed__(self):
         """Return a reversed progression."""

lionagi/core/unit/unit_mixin.py

@@ -2,9 +2,9 @@ import asyncio
 import contextlib
 import re
 from abc import ABC
-from typing import Any, Optional
+from typing import Any
 
-from lionfuncs import extract_json_block, to_dict, validate_mapping
+from lionfuncs import extract_block, to_dict, validate_mapping
 
 from lionagi.core.collections.abc import ActionError
 from lionagi.core.message import ActionRequest, ActionResponse, Instruction
@@ -1156,7 +1156,7 @@ class DirectiveMixin(ABC):
                 return to_dict(out_, fuzzy_parse=True)
 
             with contextlib.suppress(Exception):
-                return extract_json_block(out_)
+                return extract_block(out_)
 
             with contextlib.suppress(Exception):
                 match = re.search(r"```json\n({.*?})\n```", out_, re.DOTALL)

lionagi/libs/sys_util.py

@@ -7,11 +7,17 @@ import re
 import subprocess
 import sys
 import time
+from collections.abc import Sequence
 from datetime import datetime, timezone
 from hashlib import sha256
 from pathlib import Path
 from typing import Any
 
+from lion_core.setting import DEFAULT_LION_ID_CONFIG, LionIDConfig
+from lion_core.sys_utils import SysUtil as _u
+from lionabc import Observable
+from typing_extensions import deprecated
+
 _timestamp_syms = ["-", ":", "."]
 
 PATH_TYPE = str | Path
@@ -20,24 +26,74 @@ PATH_TYPE = str | Path
 class SysUtil:
 
     @staticmethod
+    def id(
+        config: LionIDConfig = DEFAULT_LION_ID_CONFIG,
+        n: int = None,
+        prefix: str = None,
+        postfix: str = None,
+        random_hyphen: bool = None,
+        num_hyphens: int = None,
+        hyphen_start_index: int = None,
+        hyphen_end_index: int = None,
+    ) -> str:
+        return _u.id(
+            config=config,
+            n=n,
+            prefix=prefix,
+            postfix=postfix,
+            random_hyphen=random_hyphen,
+            num_hyphens=num_hyphens,
+            hyphen_start_index=hyphen_start_index,
+            hyphen_end_index=hyphen_end_index,
+        )
+
+    @staticmethod
+    def get_id(
+        item: Sequence[Observable] | Observable | str,
+        config: LionIDConfig = DEFAULT_LION_ID_CONFIG,
+        /,
+    ) -> str:
+        return _u.get_id(item, config)
+
+    @staticmethod
+    def is_id(
+        item: Sequence[Observable] | Observable | str,
+        config: LionIDConfig = DEFAULT_LION_ID_CONFIG,
+        /,
+    ) -> bool:
+        return _u.is_id(item, config)
+
+    # legacy methods, kept for backward compatibility
+
+    @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use time.sleep instead.",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def sleep(delay: float) -> None:
         """
         Pauses execution for a specified duration.
 
         Args:
-                delay (float): The amount of time, in seconds, to pause execution.
+            delay (float): The amount of time, in seconds, to pause execution.
         """
         time.sleep(delay)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.time instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def get_now(datetime_: bool = False, tz=None) -> float | datetime:
         """Returns the current time either as a Unix timestamp or a datetime object.
 
         Args:
-                datetime_ (bool): If True, returns a datetime object; otherwise, returns a Unix timestamp.
+            datetime_ (bool): If True, returns a datetime object; otherwise, returns a Unix timestamp.
 
         Returns:
-                Union[float, datetime.datetime]: The current time as a Unix timestamp or a datetime object.
+            Union[float, datetime.datetime]: The current time as a Unix timestamp or a datetime object.
         """
 
         if not datetime_:
@@ -48,6 +104,11 @@ class SysUtil:
         return datetime.now(**config_)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use d_[k2] = d_.pop(k1) instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def change_dict_key(
         dict_: dict[Any, Any], old_key: str, new_key: str
     ) -> None:
@@ -65,15 +126,20 @@ class SysUtil:
             dict_[new_key] = dict_.pop(old_key)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.time instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def get_timestamp(tz: timezone = timezone.utc, sep: str = "_") -> str:
         """Returns a timestamp string with optional custom separators and timezone.
 
         Args:
-                tz (timezone): The timezone for the timestamp.
-                sep (str): The separator to use in the timestamp string, replacing '-', ':', and '.'.
+            tz (timezone): The timezone for the timestamp.
+            sep (str): The separator to use in the timestamp string, replacing '-', ':', and '.'.
 
         Returns:
-                str: A string representation of the current timestamp.
+            str: A string representation of the current timestamp.
         """
         str_ = datetime.now(tz=tz).isoformat()
         if sep is not None:
@@ -82,6 +148,11 @@ class SysUtil:
         return str_
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Deprecated without replacement",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def is_schema(dict_: dict[Any, Any], schema: dict[Any, type]) -> bool:
         """Validates if the given dictionary matches the expected schema types."""
         return all(
@@ -90,6 +161,11 @@ class SysUtil:
         )
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.copy instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def create_copy(input_: Any, num: int = 1) -> Any | list[Any]:
         """Creates deep copies of the input, either as a single copy or a list of copies.
 
@@ -109,6 +185,11 @@ class SysUtil:
         )
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use SysUtil.id instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def create_id(n: int = 32) -> str:
         """
         Generates a unique identifier based on the current time and random bytes.
@@ -124,17 +205,22 @@ class SysUtil:
         return sha256(current_time + random_bytes).hexdigest()[:n]
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.get_bins instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def get_bins(
         input_: list[str], upper: int | None = 2000
     ) -> list[list[int]]:
         """Organizes indices of strings into bins based on a cumulative upper limit.
 
         Args:
-                input_ (List[str]): The list of strings to be binned.
-                upper (int): The cumulative length upper limit for each bin.
+            input_ (List[str]): The list of strings to be binned.
+            upper (int): The cumulative length upper limit for each bin.
 
         Returns:
-                List[List[int]]: A list of bins, each bin is a list of indices from the input list.
+            List[List[int]]: A list of bins, each bin is a list of indices from the input list.
         """
         current = 0
         bins = []
@@ -152,13 +238,18 @@ class SysUtil:
         return bins
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.get_cpu_architecture instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def get_cpu_architecture() -> str:
         """Returns a string identifying the CPU architecture.
 
         This method categorizes some architectures as 'apple_silicon'.
 
         Returns:
-                str: A string identifying the CPU architecture ('apple_silicon' or 'other_cpu').
+            str: A string identifying the CPU architecture ('apple_silicon' or 'other_cpu').
         """
         arch: str = platform.machine().lower()
         return (
@@ -168,6 +259,11 @@ class SysUtil:
         )
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.install_import instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def install_import(
         package_name: str,
         module_name: str = None,
@@ -180,10 +276,10 @@ class SysUtil:
         to install the package using pip and then retries the import.
 
         Args:
-                package_name: The base name of the package to import.
-                module_name: The submodule name to import from the package, if applicable. Defaults to None.
-                import_name: The specific name to import from the module or package. Defaults to None.
-                pip_name: The pip package name if different from `package_name`. Defaults to None.
+            package_name: The base name of the package to import.
+            module_name: The submodule name to import from the package, if applicable. Defaults to None.
+            import_name: The specific name to import from the module or package. Defaults to None.
+            pip_name: The pip package name if different from `package_name`. Defaults to None.
 
         Prints a message indicating success or attempts installation if the import fails.
         """
@@ -215,23 +311,38 @@ class SysUtil:
                 __import__(full_import_path)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.import_module instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def import_module(module_path: str):
         return importlib.import_module(module_path)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.is_package_installed instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def is_package_installed(package_name: str) -> bool:
         """Checks if a package is currently installed.
 
         Args:
-                package_name: The name of the package to check.
+            package_name: The name of the package to check.
 
         Returns:
-                A boolean indicating whether the package is installed.
+            A boolean indicating whether the package is installed.
         """
         package_spec = importlib.util.find_spec(package_name)
         return package_spec is not None
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.check_import instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def check_import(
         package_name: str,
         module_name: str | None = None,
@@ -246,12 +357,12 @@ class SysUtil:
         it attempts to install the package using `install_import` and then retries the import.
 
         Args:
-                package_name: The name of the package to check and potentially install.
-                module_name: The submodule name to import from the package, if applicable. Defaults to None.
-                import_name: The specific name to import from the module or package. Defaults to None.
-                pip_name: The pip package name if different from `package_name`. Defaults to None.
-                attempt_install: If attempt to install the package if uninstalled. Defaults to True.
-                error_message: Error message when the package is not installed and not attempt to install.
+            package_name: The name of the package to check and potentially install.
+            module_name: The submodule name to import from the package, if applicable. Defaults to None.
+            import_name: The specific name to import from the module or package. Defaults to None.
+            pip_name: The pip package name if different from `package_name`. Defaults to None.
+            attempt_install: If attempt to install the package if uninstalled. Defaults to True.
+            error_message: Error message when the package is not installed and not attempt to install.
         """
         try:
             if not SysUtil.is_package_installed(package_name):
@@ -277,6 +388,11 @@ class SysUtil:
             ) from e
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.list_installed_packages instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def list_installed_packages() -> list:
         """list all installed packages using importlib.metadata."""
         return [
@@ -285,6 +401,11 @@ class SysUtil:
         ]
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.uninstall_package instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def uninstall_package(package_name: str) -> None:
         """Uninstall a specified package."""
         try:
@@ -296,6 +417,11 @@ class SysUtil:
             print(f"Failed to uninstall {package_name}. Error: {e}")
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.update_package instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def update_package(package_name: str) -> None:
         """Update a specified package."""
         try:
@@ -314,6 +440,11 @@ class SysUtil:
             print(f"Failed to update {package_name}. Error: {e}")
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.clear_path instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def clear_dir(
         dir_path: Path | str,
         recursive: bool = False,
@@ -324,12 +455,12 @@ class SysUtil:
         excluding files that match any pattern in the exclude list.
 
         Args:
-                dir_path (Union[Path, str]): The path to the directory to clear.
-                recursive (bool): If True, clears directories recursively. Defaults to False.
-                exclude (List[str]): A list of string patterns to exclude from deletion. Defaults to None.
+            dir_path (Union[Path, str]): The path to the directory to clear.
+            recursive (bool): If True, clears directories recursively. Defaults to False.
+            exclude (List[str]): A list of string patterns to exclude from deletion. Defaults to None.
 
         Raises:
-                FileNotFoundError: If the specified directory does not exist.
+            FileNotFoundError: If the specified directory does not exist.
         """
         dir_path = Path(dir_path)
         if not dir_path.exists():
@@ -356,6 +487,11 @@ class SysUtil:
                     raise
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.split_path instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def split_path(path: Path | str) -> tuple[Path, str]:
         """
         Splits a path into its directory and filename components.
@@ -370,6 +506,11 @@ class SysUtil:
         return path.parent, path.name
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.create_path instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def create_path(
         directory: Path | str,
         filename: str,
@@ -383,12 +524,12 @@ class SysUtil:
         Creates a path with an optional timestamp in the specified directory.
 
         Args:
-                directory (Union[Path, str]): The directory where the file will be located.
-                filename (str): The filename. Must include a valid extension.
-                timestamp (bool): If True, adds a timestamp to the filename. Defaults to True.
-                dir_exist_ok (bool): If True, does not raise an error if the directory exists. Defaults to True.
-                time_prefix (bool): If True, adds the timestamp as a prefix; otherwise, as a suffix. Defaults to False.
-                custom_timestamp_format (str): A custom format for the timestamp. Defaults to "%Y%m%d%H%M%S".
+            directory (Union[Path, str]): The directory where the file will be located.
+            filename (str): The filename. Must include a valid extension.
+            timestamp (bool): If True, adds a timestamp to the filename. Defaults to True.
+            dir_exist_ok (bool): If True, does not raise an error if the directory exists. Defaults to True.
+            time_prefix (bool): If True, adds the timestamp as a prefix; otherwise, as a suffix. Defaults to False.
+            custom_timestamp_format (str): A custom format for the timestamp. Defaults to "%Y%m%d%H%M%S".
 
         Returns:
                 Path: The full path to the file.
@@ -432,6 +573,11 @@ class SysUtil:
         return full_path
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.list_files instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def list_files(dir_path: Path | str, extension: str = None) -> list[Path]:
         """
         Lists all files in a specified directory with an optional filter for file extensions.
@@ -455,6 +601,11 @@ class SysUtil:
             return list(dir_path.glob("*"))
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.copy_file instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def copy_file(src: Path | str, dest: Path | str) -> None:
         """
         Copies a file from a source path to a destination path.
@@ -475,6 +626,11 @@ class SysUtil:
         copy2(src, dest)
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.get_file_size instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def get_size(path: Path | str) -> int:
         """
         Gets the size of a file or total size of files in a directory.
@@ -499,6 +655,11 @@ class SysUtil:
             raise FileNotFoundError(f"{path} does not exist.")
 
     @staticmethod
+    @deprecated(
+        "Deprecated since v0.3, will be removed in v1.0. Use lionfuncs.save_to_file instead",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
     def save_to_file(
         text,
         directory: Path | str,
@@ -544,3 +705,6 @@ class SysUtil:
             print(f"Text saved to: {file_path}")
 
         return True
+
+
+__all__ = ["SysUtil"]

lionagi/version.py

@@ -1 +1 @@
-__version__ = "0.3.6"
+__version__ = "0.3.7"

{lionagi-0.3.6.dist-info → lionagi-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lionagi
-Version: 0.3.6
+Version: 0.3.7
 Summary: Towards automated general intelligence.
 Author: HaiyangLi
 Author-email: quantocean.li@gmail.com
@@ -13,6 +13,7 @@ Requires-Dist: aiocache (>=0.12.0,<0.13.0)
 Requires-Dist: ipython (>=8.0.0,<9.0.0)
 Requires-Dist: lion-core (>=0.4.0,<0.5.0)
 Requires-Dist: lion-openai (>=0.1.5,<0.2.0)
+Requires-Dist: lionfuncs (>=1.2.1,<2.0.0)
 Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
 Description-Content-Type: text/markdown
 

{lionagi-0.3.6.dist-info → lionagi-0.3.7.dist-info}/RECORD

@@ -26,15 +26,15 @@ lionagi/core/collections/__init__.py,sha256=RgnaBHgeUlPQyPfraE2MI86wAZpHAtmfgU0h
 lionagi/core/collections/_logger.py,sha256=zAGvx5SWWkeI2_n8Jh69ToYvyn5LLlww91SRKcrxLDU,11696
 lionagi/core/collections/abc/README.md,sha256=N3s0qQglL2PkriZ0hWDTh0ytJjubqkXVyUB0x9kpi6U,5524
 lionagi/core/collections/abc/__init__.py,sha256=cCPlUaXtXXPdQamXWQAf8MHKck7sa1asu6TDLX1W6S0,984
-lionagi/core/collections/abc/component.py,sha256=4Z588KENh0yULM4sFfvpvfeEi13yApOxQ7OpCI_itUQ,21575
-lionagi/core/collections/abc/concepts.py,sha256=4IM2uQGhMjBzfa1wjNX4ZMbcxCqtjQTFXFJBye47IQg,8043
+lionagi/core/collections/abc/component.py,sha256=R3lU2I9cefeKNQ-2EmUq487MRYdBHR50g5iZ9BmudKU,21280
+lionagi/core/collections/abc/concepts.py,sha256=iYaI97A9qWrH_aPt_Fx60qgMfoGKqhzD0-efgH8lSj0,7799
 lionagi/core/collections/abc/exceptions.py,sha256=raqjWSHGYhm-tUAmn1QK_NlkM3MQfjc1cOD_kobUdyc,4065
 lionagi/core/collections/abc/util.py,sha256=CjJs-PgK0t4MAG1AJUdgrxQg7v2Ou-ixv-gWjatu7d4,779
 lionagi/core/collections/exchange.py,sha256=7h9kI7gNRyCYFZUd-686ClPZXFZLtrEn7pVHjk4ol60,4274
-lionagi/core/collections/flow.py,sha256=oo4PjNpMhRgYeKfJ6aorxp7CjKk7iIizVC9WuwYrPcQ,12751
-lionagi/core/collections/model.py,sha256=uZhTBuKFa7OzxtFwO7sVV8RPmdydgWasso1g5os0dGg,15848
-lionagi/core/collections/pile.py,sha256=X4j_Zbt2TCQTWPGYkOgfFBzIepcqFeoultFh6KnS6QU,37943
-lionagi/core/collections/progression.py,sha256=YIN-qVNZPMHN3f3UflUgH1jzdkQPwdnBZSOVvZZ7OeQ,6704
+lionagi/core/collections/flow.py,sha256=yaCdLhilcBrPdsZ46RcApgi8p-7O0D97OYnNVkEZja4,12726
+lionagi/core/collections/model.py,sha256=dU6NOmy3c2aX9XqM5Y2CMx9_wuRCDtFAJyu5njBEysM,15848
+lionagi/core/collections/pile.py,sha256=Zjzjo1eb0V7_9ONDpZgT65jLaAM04_zWK01zNS3OI_M,37937
+lionagi/core/collections/progression.py,sha256=oFXvsGe84ZcHvacGc1MDGn4bE4h5wRUq8h9wcBXr8Ok,6657
 lionagi/core/collections/util.py,sha256=AWfwuIIwbakpF0_swWUVSGTeN26XWL6UlmgW5mh4qDA,2005
 lionagi/core/director/README.md,sha256=HoIDnEmWmWXVeDfUvkyf4nXQOYqzy2jhToZcJz0zmUw,55
 lionagi/core/director/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -65,6 +65,7 @@ lionagi/core/generic/edge_condition.py,sha256=ZvQMYDl4WFXrwkvjQajVFluF5FNosw_OLe
 lionagi/core/generic/graph.py,sha256=kOq2DvZaAFmgHIZUlFlxUgSh4rzqQP6fMmQtrWhTjfM,7838
 lionagi/core/generic/hyperedge.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
 lionagi/core/generic/node.py,sha256=vf26Q8-V3wh5qr8TdFGena_SCkp_39eCO6n23TjbuMo,7156
+lionagi/core/generic/registry/component_registry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/core/generic/tree.py,sha256=YVlJT1_gN96utEUB1Uc4pmHEeFVyJrtSF6cqIBWZDJI,1541
 lionagi/core/generic/tree_node.py,sha256=vHOELePsn-Vqlpi7V4-UteGR-Vht4FddJL6UmNVbab8,2475
 lionagi/core/mail/__init__.py,sha256=_-C11e519cBCuEuYhCgsQnzph2vDpUaLEfsKNwz33AQ,202
@@ -80,6 +81,10 @@ lionagi/core/message/instruction.py,sha256=I_ZqMx3IjIwGlAx3bdlBuyVycTZ9yO1i-kEP5
 lionagi/core/message/message.py,sha256=Etl4a3mUrXLsym7i6ILqTV_Xun0xZw0UCoBMl1OtsNE,2403
 lionagi/core/message/system.py,sha256=48mvib50mno9F-8fkLa8SzPxz3G1KlRgz3GkIluMFUQ,2318
 lionagi/core/message/util.py,sha256=7CFw90QA3CdnV43aQ3PU6p1fhtaTixnlj_SBkLyQmpM,9313
+lionagi/core/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/core/operations/chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/core/operations/direct/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/core/operative/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/core/report/__init__.py,sha256=KqfJNaSx9fzRw3eyrlIlYIiueo-jVYMgjaOdfzTUAN4,80
 lionagi/core/report/base.py,sha256=_PRSd92JttwEKnW_UX7SszpV29bLg6wPwJ_Lav-Z-9k,7173
 lionagi/core/report/form.py,sha256=IPZk5D5Ai-GV6DrvrZBoEkwIFT7_vwv8h3qME8Tph-M,7040
@@ -116,7 +121,7 @@ lionagi/core/unit/template/score.py,sha256=ReUaIIr-NLjunSy4NNXQpIsH28NNceGBAUuPC
 lionagi/core/unit/template/select.py,sha256=VSpkphJl9bHSE8i0X6MMJD8LB5QwOj1UORHm8VDIRKE,3047
 lionagi/core/unit/unit.py,sha256=a3rauBXe50SBUgndv7Q9bqF4h7pJCYdsoTfPf1e8GCs,15548
 lionagi/core/unit/unit_form.py,sha256=zK_ij3Tod5FwMVdIIhdVoEFvD3br-YM9RPe7WsOIW2s,10980
-lionagi/core/unit/unit_mixin.py,sha256=c8GvHzgc65iJKQBKv71ET3afLPsIz5-Ce-4Eo6_bZiw,38823
+lionagi/core/unit/unit_mixin.py,sha256=gLyqtyiwWIyfibhNUJzMpAGfcMmLdo86xjbGZFyGILA,38803
 lionagi/core/unit/util.py,sha256=WN2Jop-LUwQNYJNubFPhOZrisQ6SQq-XMhD_KhzLkgE,2707
 lionagi/core/validator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/core/validator/validator.py,sha256=901wwmqL92XNi25ajv57bNKIKZhmu-KprNLArMUiGqg,12255
@@ -180,6 +185,8 @@ lionagi/integrations/config/mlx_configs.py,sha256=xbostqjnk3aAN-qKyC54YBprHPA38C
 lionagi/integrations/config/oai_configs.py,sha256=fgby-3o_tO24QhSiPyko-oeAMEa0cWCThh6L6ChiXoo,3625
 lionagi/integrations/config/ollama_configs.py,sha256=GUn0kagrQA3gpIiaxYyfdi2LAf_Ohz1sVrsAb20OBwo,17
 lionagi/integrations/config/openrouter_configs.py,sha256=x5LjLx-aqCLzzrqr15gVzuTTG4Y_BVS6tRrKout5vPQ,1690
+lionagi/integrations/langchain_/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/integrations/llamaindex_/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/integrations/loader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/integrations/loader/load.py,sha256=KhsbLPwqNK1wRDKSoZPd5yeyMGAPc9Xt_ISR8PK6PCk,8651
 lionagi/integrations/loader/load_util.py,sha256=65qP5kytBJFTaSg7lNCO7rfw6GpPQuvZxoqJ7s83A48,6616
@@ -214,7 +221,7 @@ lionagi/libs/ln_queue.py,sha256=kJ-81XNnu2gcHyQ9XL62kCnAzk_0tmRmvhAaj30wIjM,3498
 lionagi/libs/ln_tokenize.py,sha256=SP3mGljwaaxqH0ced54v4lFs8LXU-oIpb33mdrzRSEA,5400
 lionagi/libs/ln_validate.py,sha256=huTnLNaAITni49PK_uI2CXvnFETt87j8-4lF8e5yy0o,8469
 lionagi/libs/special_tokens.py,sha256=ViFaql64LgEGHSXzODzaVMh4GfteN8D2ogmqWYTYwiQ,2411
-lionagi/libs/sys_util.py,sha256=iwzbvt_lGCeRdD1JdPNKE3E3bsrO45JWbWQ-OEQ7fTc,19675
+lionagi/libs/sys_util.py,sha256=Xin0U3-oBUJZJUhdHRjDyyNVJS-resfGFooDUTAtH0M,24919
 lionagi/lions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/lions/coder/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/lions/coder/add_feature.py,sha256=mLMfz9V9yYbdH6DJs39FOz9IHdhdyPZajocQtQhjgcA,703
@@ -222,6 +229,7 @@ lionagi/lions/coder/base_prompts.py,sha256=SLpC442nZm2cEkB8o9j28kpkB-WzKLjH6sOTS
 lionagi/lions/coder/code_form.py,sha256=xW66cWCsrZu2qGu-wGUGSIPL1uZevGQVCE_vBRH9Kmc,384
 lionagi/lions/coder/coder.py,sha256=u-n_7PVdKCAz28SAA2bO4oy1qxGIzEl1PX6iqz7oSoI,5829
 lionagi/lions/coder/util.py,sha256=m9H18JrePpuP1VyjxVXQaLXCGBed04jZIkfNXvF7_gU,2751
+lionagi/lions/director/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/lions/judge/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/lions/judge/config.py,sha256=hJNMI-07zf5cqU2tr22fzkGvhR7RdtckkYg8UhLTKec,185
 lionagi/lions/judge/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -238,8 +246,21 @@ lionagi/lions/researcher/data_source/finhub_.py,sha256=W63daXgIwHJQ6TDMR2ALQIDk1
 lionagi/lions/researcher/data_source/google_.py,sha256=401SKHQaSpxiOUoXl7stadl4qeF7SIX72lUNK7bKesg,6797
 lionagi/lions/researcher/data_source/wiki_.py,sha256=UPoa2dk_y5sELu7_rkdme2auDpUmc_Dn0Avgjwr2X2g,3145
 lionagi/lions/researcher/data_source/yfinance_.py,sha256=snAf897J69MyAc6fcFjF0irrMjbAh81EZ3RvaFT3hxE,977
-lionagi/version.py,sha256=W_9dCm49nLvZulVAvvsafxLJjVBSKDBHz9K7szFZllo,22
-lionagi-0.3.6.dist-info/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
-lionagi-0.3.6.dist-info/METADATA,sha256=YBvJNxfI2QZFGB4DW2WcHwG-WpcVaGSFUgq54xY0-KI,3148
-lionagi-0.3.6.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-lionagi-0.3.6.dist-info/RECORD,,
+lionagi/operations/brainstorm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/brainstorm.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/chat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/plan/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/plan/base.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/query/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/rank/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/react/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/route/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/score/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/select/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/operations/strategize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lionagi/version.py,sha256=J0I0c7-a50EOnWXMryTu_E6xhXSYFBPjVpeYP_a3vRI,22
+lionagi-0.3.7.dist-info/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.3.7.dist-info/METADATA,sha256=6F2nnUX1ORQQo6giNHPHh3iuZb8AZxNs5Nw-XsqqutQ,3190
+lionagi-0.3.7.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+lionagi-0.3.7.dist-info/RECORD,,