lionagi 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

lionagi/core/generic/component.py

@@ -1,532 +0,0 @@
-"""base components in lionagi"""
-
-from abc import ABC
-from functools import singledispatchmethod
-from typing import Any, TypeVar, Type
-from pydantic import AliasChoices, BaseModel, Field, ValidationError
-from pandas import DataFrame, Series
-
-from lionagi.libs import SysUtil, convert, ParseUtil, nested, func_call
-
-
-T = TypeVar("T")
-
-
-class BaseComponent(BaseModel, ABC):
-    """
-    Base class for creating component models.
-
-    Attributes:
-        id_ (str): A 32-char unique hash identifier for the node.
-        timestamp (str): The timestamp of when the node was created.
-    """
-
-    id_: str = Field(
-        title="ID",
-        default_factory=SysUtil.create_id,
-        validation_alias=AliasChoices("node_id", "ID", "id"),
-        description="A 32-char unique hash identifier for the node.",
-    )
-    timestamp: str = Field(
-        default_factory=lambda: SysUtil.get_timestamp(sep=None),
-        description="The timestamp of when the node was created.",
-    )
-
-    extra_fields: dict[str, Any] = Field(
-        default_factory=dict,
-        validation_alias=AliasChoices(
-            "extra", "additional_fields", "schema_extra", "extra_schema"
-        ),
-        description="Additional fields for the component.",
-    )
-
-    class Config:
-        """Model configuration settings."""
-
-        extra = "allow"
-        arbitrary_types_allowed = True
-        populate_by_name = True
-
-    @property
-    def class_name(self) -> str:
-        """
-        Retrieve the name of the class.
-
-        Returns:
-            str: The name of the class.
-        """
-        return self._class_name()
-
-    @classmethod
-    def _class_name(cls) -> str:
-        """
-        Retrieve the name of the class.
-
-        Returns:
-            str: The name of the class.
-        """
-        return cls.__name__
-
-    def to_json_str(self, *args, **kwargs) -> str:
-        """
-        Convert the component to a JSON string.
-
-        Returns:
-            str: The JSON string representation of the component.
-        """
-        dict_ = self.to_dict(*args, **kwargs)
-        return convert.to_str(dict_)
-
-    def to_dict(self, *args, **kwargs) -> dict[str, Any]:
-        """
-        Convert the component to a dictionary.
-
-        Returns:
-            dict[str, Any]: The dictionary representation of the component.
-        """
-        dict_ = self.model_dump(*args, by_alias=True, **kwargs)
-        for field_name in list(self.extra_fields.keys()):
-            if field_name not in dict_:
-                dict_[field_name] = getattr(self, field_name, None)
-        dict_.pop("extra_fields", None)
-        return dict_
-
-    def to_xml(self, *args, **kwargs) -> str:
-        """
-        Convert the component to an XML string.
-
-        Returns:
-            str: The XML string representation of the component.
-        """
-        import xml.etree.ElementTree as ET
-
-        root = ET.Element(self.__class__.__name__)
-
-        def convert(dict_obj: dict, parent: ET.Element) -> None:
-            for key, val in dict_obj.items():
-                if isinstance(val, dict):
-                    element = ET.SubElement(parent, key)
-                    convert(val, element)
-                else:
-                    element = ET.SubElement(parent, key)
-                    element.text = str(val)
-
-        convert(self.to_dict(*args, **kwargs), root)
-        return ET.tostring(root, encoding="unicode")
-
-    def to_pd_series(self, *args, pd_kwargs: dict | None = None, **kwargs) -> Series:
-        """
-        Convert the node to a Pandas Series.
-
-        Args:
-            pd_kwargs (dict | None): Additional keyword arguments for Pandas Series.
-
-        Returns:
-            Series: The Pandas Series representation of the node.
-        """
-        pd_kwargs = {} if pd_kwargs is None else pd_kwargs
-        dict_ = self.to_dict(*args, **kwargs)
-        return Series(dict_, **pd_kwargs)
-
-    def _add_field(
-        self,
-        field_name: str,
-        annotation: Any | Type | None = Any,
-        default: Any | None = None,
-        value: Any | None = None,
-        field: Any = None,
-        **kwargs,
-    ) -> None:
-        """
-        Add a field to the model after initialization.
-
-        Args:
-            field_name (str): The name of the field.
-            annotation (Any | Type | None): The type annotation for the field.
-            default (Any | None): The default value for the field.
-            value (Any | None): The initial value for the field.
-            field (Any): The Field object for the field.
-            **kwargs: Additional keyword arguments for the Field object.
-        """
-        field = field or Field(default=default, **kwargs)
-        self.extra_fields[field_name] = field
-        if annotation:
-            self.extra_fields[field_name].annotation = annotation
-
-        if not value and (a := self._get_field_attr(field_name, "default", None)):
-            value = a
-
-        self.__setattr__(field_name, value)
-
-    @property
-    def _all_fields(self):
-        return {**self.model_fields, **self.extra_fields}
-
-    @property
-    def _field_annotations(self) -> dict:
-        """
-        Return the annotations for each field in the model.
-
-        Returns:
-            dict: A dictionary mapping field names to their annotations.
-        """
-
-        return self._get_field_annotation(list(self._all_fields.keys()))
-
-    def _get_field_attr(self, k: str, attr: str, default: Any = False) -> Any:
-        """
-        Get the value of a field attribute.
-
-        Args:
-            k (str): The field name.
-            attr (str): The attribute name.
-            default (Any): Default value to return if the attribute is not found.
-
-        Returns:
-            Any: The value of the field attribute, or the default value if not found.
-
-        Raises:
-            ValueError: If the field does not have the specified attribute.
-        """
-        try:
-            if not self._field_has_attr(k, attr):
-                raise ValueError(f"field {k} has no attribute {attr}")
-
-            field = self._all_fields[k]
-            a = getattr(field, attr, None)
-            if not a:
-                try:
-                    a = field.json_schema_extra[attr]
-                    return a
-                except Exception:
-                    return None
-            return a
-        except Exception as e:
-            if default is not False:
-                return default
-            raise e
-
-    @singledispatchmethod
-    def _get_field_annotation(self, field_name: Any) -> Any:
-        """
-        Get the annotation for a field.
-
-        Args:
-            field_name (str): The name of the field.
-
-        Raises:
-            TypeError: If the field_name is of an unsupported type.
-        """
-        raise TypeError(f"Unsupported type {type(field_name)}")
-
-    @_get_field_annotation.register(str)
-    def _(self, field_name: str) -> dict[str, Any]:
-        """
-        Get the annotation for a field as a dictionary.
-
-        Args:
-            field_name (str): The name of the field.
-
-        Returns:
-            dict[str, Any]: A dictionary mapping the field name to its annotation.
-        """
-        dict_ = {field_name: self._all_fields[field_name].annotation}
-        for k, v in dict_.items():
-            if "|" in str(v):
-                v = str(v)
-                v = v.split("|")
-                dict_[k] = func_call.lcall(v, convert.strip_lower)
-            else:
-                dict_[k] = [v.__name__]
-        return dict_
-
-    @_get_field_annotation.register(list)
-    @_get_field_annotation.register(tuple)
-    def _(self, field_names: list | tuple) -> dict[str, Any]:
-        """
-        Get the annotations for multiple fields as a dictionary.
-
-        Args:
-            field_names (list | tuple): A list or tuple of field names.
-
-        Returns:
-            dict[str, Any]: A dictionary mapping field names to their annotations.
-        """
-        dict_ = {}
-        for field_name in field_names:
-            dict_.update(self._get_field_annotation(field_name))
-        return dict_
-
-    def _field_has_attr(self, k: str, attr: str) -> bool:
-        """
-        Check if a field has a specific attribute.
-
-        Args:
-            k (str): The field name.
-            attr (str): The attribute name.
-
-        Returns:
-            bool: True if the field has the attribute, False otherwise.
-        """
-        field = self._all_fields.get(k, None)
-        if field is None:
-            raise ValueError(f"Field {k} not found in model fields.")
-
-        a = attr in str(field)
-        if not a:
-            try:
-                a = (
-                    self._all_fields[k].json_schema_extra[attr] is not None
-                    and attr in self._all_fields[k].json_schema_extra
-                )
-                return a if isinstance(a, bool) else False
-            except Exception:
-                return False
-        return a
-
-    def __str__(self):
-        return f"{self.__class__.__name__}({self.to_json_str()})"
-
-
-class BaseNode(BaseComponent):
-    """
-    Base class for creating node models.
-
-    Attributes:
-        content (Any | None): The optional content of the node.
-        metadata (dict[str, Any]): Additional metadata for the node.
-    """
-
-    content: Any | None = Field(
-        default=None,
-        validation_alias=AliasChoices("text", "page_content", "chunk_content", "data"),
-        description="The optional content of the node.",
-    )
-
-    metadata: dict[str, Any] = Field(
-        default_factory=dict,
-        validation_alias="meta",
-        description="Additional metadata for the node.",
-    )
-
-    @singledispatchmethod
-    @classmethod
-    def from_obj(cls, obj: Any, *args, **kwargs) -> T:
-        """
-        Create a node instance from an object.
-
-        Args:
-            obj (Any): The object to create the node from.
-            *args: Additional positional arguments.
-            **kwargs: Additional keyword arguments.
-
-        Raises:
-            NotImplementedError: If the object type is not supported.
-        """
-        if not isinstance(obj, (dict, str, list, Series, DataFrame, BaseModel)):
-            type_ = str(type(obj))
-            if "llama_index" in type_:
-                return cls.from_obj(obj.to_dict())
-            elif "langchain" in type_:
-                langchain_json = obj.to_json()
-                langchain_dict = {
-                    "lc_id": langchain_json["id"],
-                    **langchain_json["kwargs"],
-                }
-                return cls.from_obj(langchain_dict)
-
-        raise NotImplementedError(f"Unsupported type: {type(obj)}")
-
-    @from_obj.register(dict)
-    @classmethod
-    def _from_dict(cls, obj: dict, *args, **kwargs) -> T:
-        """
-        Create a node instance from a dictionary.
-
-        Args:
-            obj (dict): The dictionary to create the node from.
-            *args: Additional positional arguments.
-            **kwargs: Additional keyword arguments.
-
-        Returns:
-            T: The created node instance.
-        """
-        return cls.model_validate(obj, *args, **kwargs)
-
-    @from_obj.register(str)
-    @classmethod
-    def _from_str(cls, obj: str, *args, fuzzy_parse: bool = False, **kwargs) -> T:
-        """
-        Create a node instance from a JSON string.
-
-        Args:
-            obj (str): The JSON string to create the node from.
-            *args: Additional positional arguments.
-            fuzzy_parse (bool): Whether to perform fuzzy parsing.
-            **kwargs: Additional keyword arguments.
-
-        Returns:
-            T: The created node instance.
-        """
-        obj = ParseUtil.fuzzy_parse_json(obj) if fuzzy_parse else convert.to_dict(obj)
-        try:
-            return cls.from_obj(obj, *args, **kwargs)
-        except ValidationError as e:
-            raise ValueError(f"Invalid JSON for deserialization: {e}") from e
-
-    @from_obj.register(list)
-    @classmethod
-    def _from_list(cls, obj: list, *args, **kwargs) -> list[T]:
-        """
-        Create a list of node instances from a list of objects.
-
-        Args:
-            obj (list): The list of objects to create nodes from.
-            *args: Additional positional arguments.
-            **kwargs: Additional keyword arguments.
-
-        Returns:
-            list[T]: The list of created node instances.
-        """
-        return [cls.from_obj(item, *args, **kwargs) for item in obj]
-
-    @from_obj.register(Series)
-    @classmethod
-    def _from_pd_series(
-        cls, obj: Series, *args, pd_kwargs: dict | None = None, **kwargs
-    ) -> T:
-        """
-        Create a node instance from a Pandas Series.
-
-        Args:
-            obj (Series): The Pandas Series to create the node from.
-            *args: Additional positional arguments.
-            pd_kwargs (dict | None): Additional keyword arguments for Pandas Series.
-            **kwargs: Additional keyword arguments.
-
-        Returns:
-            T: The created node instance.
-        """
-        pd_kwargs = pd_kwargs or {}
-        return cls.from_obj(obj.to_dict(**pd_kwargs), *args, **kwargs)
-
-    @from_obj.register(DataFrame)
-    @classmethod
-    def _from_pd_dataframe(
-        cls, obj: DataFrame, *args, pd_kwargs: dict | None = None, **kwargs
-    ) -> list[T]:
-        """
-        Create a list of node instances from a Pandas DataFrame.
-
-        Args:
-            obj (DataFrame): The Pandas DataFrame to create nodes from.
-            *args: Additional positional arguments.
-            pd_kwargs (dict | None): Additional keyword arguments for Pandas DataFrame.
-            **kwargs: Additional keyword arguments.
-
-        Returns:
-            list[T]: The list of created node instances.
-        """
-        if pd_kwargs is None:
-            pd_kwargs = {}
-
-        _objs = []
-        for index, row in obj.iterrows():
-            _obj = cls.from_obj(row, *args, **pd_kwargs, **kwargs)
-            _obj.metadata["df_index"] = index
-            _objs.append(_obj)
-
-        return _objs
-
-    @from_obj.register(BaseModel)
-    @classmethod
-    def _from_base_model(cls, obj, pydantic_kwargs=None, **kwargs) -> T:
-        """
-        Create a node instance from a Pydantic BaseModel.
-
-        Args:
-            obj (BaseModel): The Pydantic BaseModel to create the node from.
-
-        Returns:
-            T: The created node instance.
-        """
-        pydantic_kwargs = pydantic_kwargs or {"by_alias": True}
-        try:
-            config_ = {}
-            try:
-                config_ = obj.model_dump(**pydantic_kwargs)
-            except:
-                config_ = obj.to_dict(**pydantic_kwargs)
-            else:
-                config_ = obj.dict(**pydantic_kwargs)
-        except Exception as e:
-            raise ValueError(f"Invalid Pydantic model for deserialization: {e}") from e
-
-        return cls.from_obj(config_ | kwargs)
-
-    def meta_get(
-        self, key: str, indices: list[str | int] | None = None, default: Any = None
-    ) -> Any:
-        """
-        Get a value from the metadata dictionary.
-
-        Args:
-            key (str): The key to retrieve the value for.
-            indices (list[str | int] | None): Optional list of indices for nested retrieval.
-            default (Any): The default value to return if the key is not found.
-
-        Returns:
-            Any: The retrieved value or the default value if not found.
-        """
-        if indices:
-            return nested.nget(self.metadata, indices, default)
-        return self.metadata.get(key, default)
-
-    def meta_change_key(self, old_key: str, new_key: str) -> bool:
-        """
-        Change a key in the metadata dictionary.
-
-        Args:
-            old_key (str): The old key to be changed.
-            new_key (str): The new key to replace the old key.
-
-        Returns:
-            bool: True if the key was changed successfully, False otherwise.
-        """
-        if old_key in self.metadata:
-            SysUtil.change_dict_key(self.metadata, old_key, new_key)
-            return True
-        return False
-
-    def meta_insert(self, indices: str | list, value: Any, **kwargs) -> bool:
-        """
-        Insert a value into the metadata dictionary at the specified indices.
-
-        Args:
-            indices (str | list): The indices to insert the value at.
-            value (Any): The value to be inserted.
-            **kwargs: Additional keyword arguments for the `nested.ninsert`
-                function.
-
-        Returns:
-            bool: True if the value was inserted successfully, False otherwise.
-        """
-        return nested.ninsert(self.metadata, indices, value, **kwargs)
-
-    def meta_merge(
-        self, additional_metadata: dict[str, Any], overwrite: bool = False, **kwargs
-    ) -> None:
-        """
-        Merge additional metadata into the existing metadata dictionary.
-
-        Args:
-            additional_metadata (dict[str, Any]): The additional metadata to be
-                merged.
-            overwrite (bool): Whether to overwrite existing keys with the new
-                values.
-            **kwargs: Additional keyword arguments for the `nested.nmerge`
-                function.
-        """
-        self.metadata = nested.nmerge(
-            [self.metadata, additional_metadata], overwrite=overwrite, **kwargs
-        )

lionagi/core/generic/condition.py

@@ -1,46 +0,0 @@
-from abc import ABC, abstractmethod
-from enum import Enum
-from typing import Callable
-from pydantic import BaseModel, Field
-
-
-class ConditionSource(str, Enum):
-    """
-    Enumeration for specifying the source type of a condition.
-
-    Attributes:
-        STRUCTURE: Represents a condition based on the structure.
-        EXECUTABLE: Represents a condition that can be executed or evaluated.
-    """
-
-    STRUCTURE = "structure"
-    EXECUTABLE = "executable"
-    RULE = "rule"
-
-
-class Condition(BaseModel, ABC):
-    """
-    Abstract base class for defining conditions associated with edges.
-
-    Attributes:
-        source_type (ConditionSource): Specifies the type of source for the condition.
-
-    Methods:
-        check: Abstract method that should be implemented to evaluate the condition.
-    """
-
-    source_type: str = Field(..., description="The type of source for the condition.")
-
-    class Config:
-        """Model configuration settings."""
-
-        extra = "allow"
-
-    @abstractmethod
-    def __call__(self, executable) -> bool:
-        """Evaluates the condition based on implemented logic.
-
-        Returns:
-            bool: The boolean result of the condition evaluation.
-        """
-        pass

lionagi/core/generic/mail.py

@@ -1,90 +0,0 @@
-"""
-This module defines classes for representing mail packages and mailboxes
-in a messaging system.
-
-The module includes the following classes:
-- MailPackageCategory: An enumeration of categories for mail packages.
-- Mail: Represents a mail message sent from one component to another.
-- MailBox: Represents a mailbox that stores pending incoming and outgoing mails.
-"""
-
-from typing import Any
-from enum import Enum
-
-from pydantic import Field, field_validator
-
-from lionagi.core.generic.component import BaseComponent
-
-
-class MailPackageCategory(str, Enum):
-    """
-    Defines categories for mail packages in a messaging system.
-
-    Attributes:
-        MESSAGES: Represents general messages.
-        TOOL: Represents tools.
-        SERVICE: Represents services.
-        MODEL: Represents models.
-        NODE: Represents nodes.
-        NODE_LIST: Represents a list of nodes.
-        NODE_ID: Represents a node's ID.
-        START: Represents a start signal or value.
-        END: Represents an end signal or value.
-        CONDITION: Represents a condition.
-    """
-
-    MESSAGES = "messages"
-    TOOL = "tool"
-    SERVICE = "service"
-    MODEL = "model"
-    NODE = "node"
-    NODE_LIST = "node_list"
-    NODE_ID = "node_id"
-    START = "start"
-    END = "end"
-    CONDITION = "condition"
-
-
-class Package(BaseComponent):
-    category: MailPackageCategory = Field(
-        ..., title="Category", description="The category of the mail package."
-    )
-
-    package: Any = Field(
-        ..., title="Package", description="The package to send in the mail."
-    )
-
-
-class Mail(BaseComponent):
-    """
-    Represents a mail message sent from one component to another within
-    the system.
-
-    Attributes:
-        sender (str): The ID of the sender node.
-        recipient (str): The ID of the recipient node.
-        category (MailPackageCategory): The category of the mail package.
-        package (Any): The content of the mail package.
-    """
-
-    sender: str = Field(
-        title="Sender",
-        description="The id of the sender node.",
-    )
-
-    recipient: str = Field(
-        title="Recipient",
-        description="The id of the recipient node.",
-    )
-
-    packages: dict[str, Package] = Field(
-        title="Packages",
-        default_factory=dict,
-        description="The packages to send in the mail.",
-    )
-
-    @field_validator("sender", "recipient", mode="before")
-    def _validate_sender_recipient(cls, value):
-        if isinstance(value, BaseComponent):
-            return value.id_
-        return value

lionagi/core/generic/mailbox.py

@@ -1,36 +0,0 @@
-from collections import deque
-from pydantic import Field
-from pydantic.dataclasses import dataclass
-
-from lionagi.core.generic.mail import Mail
-
-
-@dataclass
-class MailBox:
-
-    pile: dict[str, Mail] = Field(
-        default_factory=dict, description="The pile of all mails - {mail_id: Mail}"
-    )
-
-    sequence_in: dict[str, deque] = Field(
-        default_factory=dict,
-        description="The sequence of all incoming mails - {sender_id: deque[mail_id]}",
-    )
-
-    sequence_out: deque = Field(
-        default_factory=deque,
-        description="The sequence of all outgoing mails - deque[mail_id]",
-    )
-
-    def __str__(self) -> str:
-        """
-        Returns a string representation of the MailBox instance.
-
-        Returns:
-            str: A string describing the number of pending incoming and
-                outgoing mails in the MailBox.
-        """
-        return (
-            f"MailBox with {len(self.receieving)} pending incoming mails and "
-            f"{len(self.sending)} pending outgoing mails."
-        )