lionagi 0.15.14__py3-none-any.whl → 0.16.0__py3-none-any.whl

lionagi/operations/flow.py

@@ -12,7 +12,8 @@ using Events for synchronization and CapacityLimiter for concurrency control.
 import os
 from typing import Any
 
-from lionagi.ln import AlcallParams, CapacityLimiter, ConcurrencyEvent
+from lionagi.ln._async_call import AlcallParams
+from lionagi.ln.concurrency import CapacityLimiter, ConcurrencyEvent
 from lionagi.operations.node import Operation
 from lionagi.protocols.types import EventStatus, Graph
 from lionagi.session.branch import Branch

lionagi/operations/operate/operate.py

@@ -23,6 +23,29 @@ if TYPE_CHECKING:
     from lionagi.session.branch import Branch
 
 
+def _handle_response_format_kwargs(
+    operative_model: type[BaseModel] = None,
+    request_model: type[BaseModel] = None,
+    response_format: type[BaseModel] = None,
+):
+    if operative_model:
+        logging.warning(
+            "`operative_model` is deprecated. Use `response_format` instead."
+        )
+    if (
+        (operative_model and response_format)
+        or (operative_model and request_model)
+        or (response_format and request_model)
+    ):
+        raise ValueError(
+            "Cannot specify both `operative_model` and `response_format` (or `request_model`) "
+            "as they are aliases of each other."
+        )
+
+    # Use the final chosen format
+    return response_format or operative_model or request_model
+
+
 async def operate(
     branch: "Branch",
     *,
@@ -66,22 +89,9 @@ async def operate(
     include_token_usage_to_model: bool = False,
     **kwargs,
 ) -> list | BaseModel | None | dict | str:
-    if operative_model:
-        logging.warning(
-            "`operative_model` is deprecated. Use `response_format` instead."
-        )
-    if (
-        (operative_model and response_format)
-        or (operative_model and request_model)
-        or (response_format and request_model)
-    ):
-        raise ValueError(
-            "Cannot specify both `operative_model` and `response_format` (or `request_model`) "
-            "as they are aliases of each other."
-        )
-
-    # Use the final chosen format
-    response_format = response_format or operative_model or request_model
+    response_format = _handle_response_format_kwargs(
+        operative_model, request_model, response_format
+    )
 
     # Decide which chat model to use
     chat_model = chat_model or imodel or branch.chat_model

lionagi/protocols/contracts.py

@@ -0,0 +1,46 @@
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+"""V1 Observable Protocol for gradual evolution.
+
+This module provides the runtime-checkable ObservableProto for V1 components
+while maintaining compatibility with V0's nominal Observable ABC.
+"""
+
+from __future__ import annotations
+
+from typing import Protocol, runtime_checkable
+
+__all__ = (
+    "ObservableProto",
+    "Observable",
+    "LegacyObservable",
+)
+
+
+@runtime_checkable
+class ObservableProto(Protocol):
+    """Structural Observable Protocol for V1 components.
+
+    This protocol defines the minimal contract for observable objects:
+    they must have an 'id' property. The return type is permissive (Any)
+    to maintain compatibility with V0's IDType wrapper while enabling
+    V1 evolution.
+
+    All V0 Element subclasses automatically satisfy this protocol without
+    any code changes, enabling zero-risk gradual migration.
+    """
+
+    @property
+    def id(self) -> object:
+        """Unique identifier. Accepts IDType, UUID, or string."""
+        ...
+
+
+# Convenience alias for V1 consumers (keeps import names short)
+Observable = ObservableProto
+
+# Keep legacy nominal ABC for places that need issubclass checks (e.g., Pile)
+# Do NOT remove – Pile and others rely on issubclass(..., Observable) nominal checks.
+from ._concepts import Observable as LegacyObservable

lionagi/protocols/generic/event.py

@@ -5,13 +5,13 @@
 from __future__ import annotations
 
 import contextlib
-from enum import Enum
+from enum import Enum as _Enum
 from typing import Any
 
 from pydantic import Field, field_serializer
 
 from lionagi import ln
-from lionagi.utils import to_dict
+from lionagi.utils import Unset, to_dict
 
 from .element import Element
 
@@ -22,10 +22,10 @@ __all__ = (
 )
 
 
-_SIMPLE_TYPE = (str, bytes, bytearray, int, float, type(None), Enum)
+_SIMPLE_TYPE = (str, bytes, bytearray, int, float, type(None), _Enum)
 
 
-class EventStatus(str, ln.Enum):
+class EventStatus(str, ln.types.Enum):
     """Status states for tracking action execution progress.
 
     Attributes:
@@ -96,7 +96,7 @@ class Execution:
         Returns:
             dict: A dictionary representation of the execution state.
         """
-        res_ = ln.Unset
+        res_ = Unset
         json_serializable = True
 
         if not isinstance(self.response, _SIMPLE_TYPE):
@@ -119,7 +119,7 @@ class Execution:
                     res_ = d_
                     json_serializable = True
 
-        if res_ is ln.Unset and not json_serializable:
+        if res_ is Unset and not json_serializable:
             res_ = "<unserializable>"
 
         return {

lionagi/protocols/generic/processor.py

@@ -5,7 +5,11 @@
 import asyncio
 from typing import Any, ClassVar
 
-from lionagi.ln import ConcurrencyEvent, Semaphore, create_task_group
+from lionagi.ln.concurrency import (
+    ConcurrencyEvent,
+    Semaphore,
+    create_task_group,
+)
 
 from .._concepts import Observer
 from .element import ID
@@ -166,9 +170,9 @@ class Processor(Observer):
                                 async with self._concurrency_sem:
                                     await consume_stream(event)
 
-                            await tg.start_soon(stream_with_sem, next_event)
+                            tg.start_soon(stream_with_sem, next_event)
                         else:
-                            await tg.start_soon(consume_stream, next_event)
+                            tg.start_soon(consume_stream, next_event)
                     else:
                         # For non-streaming, just invoke
                         if self._concurrency_sem:
@@ -177,9 +181,9 @@ class Processor(Observer):
                                 async with self._concurrency_sem:
                                     await event.invoke()
 
-                            await tg.start_soon(invoke_with_sem, next_event)
+                            tg.start_soon(invoke_with_sem, next_event)
                         else:
-                            await tg.start_soon(next_event.invoke)
+                            tg.start_soon(next_event.invoke)
                     events_processed += 1
 
                 prev_event = next_event

lionagi/protocols/ids.py

@@ -0,0 +1,82 @@
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+"""ID bridge utilities for V0/V1 compatibility.
+
+This module provides utilities to convert between V0's IDType and V1's
+canonical UUID representation, enabling seamless interoperability during
+the gradual evolution process.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+from uuid import UUID
+
+from .generic.element import Element, IDType
+
+__all__ = (
+    "to_uuid",
+    "canonical_id",
+)
+
+
+def to_uuid(value: Any) -> UUID:
+    """Convert ID-like values (IDType | UUID | str | Element) to UUID (v4).
+
+    Optimized version that avoids string conversion when possible by directly
+    accessing IDType's internal UUID. Falls back to V0's IDType.validate()
+    for validation semantics only when necessary.
+
+    Args:
+        value: An ID-like value to convert (IDType, UUID, str, or Element)
+
+    Returns:
+        UUID: A validated UUIDv4
+
+    Raises:
+        IDError: If the value cannot be converted to a valid UUIDv4
+
+    Examples:
+        >>> element = Element()
+        >>> uuid_val = to_uuid(element)
+        >>> isinstance(uuid_val, UUID)
+        True
+        >>> to_uuid("550e8400-e29b-41d4-a716-446655440000")
+        UUID('550e8400-e29b-41d4-a716-446655440000')
+    """
+    if isinstance(value, Element):
+        return value.id._id
+    if isinstance(value, UUID):
+        return value
+    if hasattr(value, "_id") and isinstance(value._id, UUID):
+        return value._id
+    # Fallback: Validate then access ._id directly (no string conversion)
+    validated_id = IDType.validate(value)
+    return validated_id._id
+
+
+def canonical_id(obj: Any) -> UUID:
+    """Accept an Observable-like object or raw ID and return canonical UUID.
+
+    Safe to use across V0/V1 without changing class definitions. Prefers
+    attribute access (.id) but falls back to treating the object as a raw ID.
+
+    Args:
+        obj: An Observable object with .id attribute, or a raw ID value
+
+    Returns:
+        UUID: The canonical UUID representation
+
+    Examples:
+        >>> element = Element()
+        >>> uuid_val = canonical_id(element)
+        >>> isinstance(uuid_val, UUID)
+        True
+        >>> canonical_id("550e8400-e29b-41d4-a716-446655440000")
+        UUID('550e8400-e29b-41d4-a716-446655440000')
+    """
+    # Prefer attribute access; fall back to treating obj as a raw id
+    id_like = getattr(obj, "id", obj)
+    return to_uuid(id_like)

lionagi/protocols/types.py

@@ -2,18 +2,11 @@
 #
 # SPDX-License-Identifier: Apache-2.0
 
-from ._concepts import (
-    Collective,
-    Communicatable,
-    Condition,
-    Manager,
-    Observable,
-    Observer,
-    Ordering,
-    Relational,
-    Sendable,
-)
+from ._concepts import Collective, Communicatable, Condition, Manager
+from ._concepts import Observable as LegacyObservable
+from ._concepts import Observer, Ordering, Relational, Sendable
 from .action.manager import ActionManager, FunctionCalling, Tool, ToolRef
+from .contracts import Observable, ObservableProto
 from .forms.flow import FlowDefinition, FlowStep
 from .forms.report import BaseForm, Form, Report
 from .generic.element import ID, Element, IDError, IDType, validate_order
@@ -30,6 +23,7 @@ from .generic.processor import Executor, Processor
 from .generic.progression import Progression, prog
 from .graph.edge import EdgeCondition
 from .graph.graph import Edge, Graph, Node
+from .ids import canonical_id, to_uuid
 from .mail.exchange import Exchange, Mail, Mailbox, Package, PackageCategory
 from .mail.manager import MailManager
 from .messages.base import (
@@ -56,11 +50,15 @@ __all__ = (
     "Communicatable",
     "Condition",
     "Manager",
-    "Observable",
+    "Observable",  # V1 Protocol (preferred)
+    "ObservableProto",  # Explicit V1 Protocol name
+    "LegacyObservable",  # V0 ABC (deprecated)
     "Observer",
     "Ordering",
     "Relational",
     "Sendable",
+    "canonical_id",  # V0/V1 bridge utility
+    "to_uuid",  # ID conversion utility
     "ID",
     "Element",
     "IDError",

lionagi/utils.py

@@ -5,7 +5,6 @@
 import contextlib
 import copy as _copy
 import dataclasses
-import importlib.util
 import json
 import logging
 import types
@@ -37,11 +36,29 @@ from pydantic_core import PydanticUndefinedType
 from typing_extensions import deprecated
 
 from .libs.validate.xml_parser import xml_to_dict
-from .ln import DataClass, Enum, KeysDict, Params, Undefined, UndefinedType
-from .ln import extract_json as to_json
-from .ln import fuzzy_json as fuzzy_parse_json
-from .ln import hash_dict, to_list
-from .ln.concurrency import is_coro_func
+from .ln import (
+    extract_json,
+    fuzzy_json,
+    get_bins,
+    hash_dict,
+    import_module,
+    is_coro_func,
+    is_import_installed,
+    to_list,
+)
+from .ln.types import (
+    DataClass,
+    Enum,
+    KeysDict,
+    MaybeSentinel,
+    MaybeUndefined,
+    MaybeUnset,
+    Params,
+    Undefined,
+    UndefinedType,
+    Unset,
+    UnsetType,
+)
 from .settings import Settings
 
 R = TypeVar("R")
@@ -52,6 +69,9 @@ logger = logging.getLogger(__name__)
 
 UNDEFINED = Undefined
 
+to_json = extract_json
+fuzzy_parse_json = fuzzy_json
+
 __all__ = (
     "UndefinedType",
     "KeysDict",
@@ -76,7 +96,6 @@ __all__ = (
     "get_bins",
     "EventStatus",
     "logger",
-    "throttle",
     "max_concurrent",
     "force_async",
     "breakdown_pydantic_annotation",
@@ -87,6 +106,14 @@ __all__ = (
     "is_union_type",
     "union_members",
     "to_json",
+    "Unset",
+    "UnsetType",
+    "Undefined",
+    "MaybeSentinel",
+    "MaybeUndefined",
+    "MaybeUnset",
+    "is_import_installed",
+    "import_module",
 )
 
 
@@ -888,60 +915,3 @@ def _is_pydantic_model(x: Any) -> bool:
         return isclass(x) and issubclass(x, BaseModel)
     except TypeError:
         return False
-
-
-def import_module(
-    package_name: str,
-    module_name: str = None,
-    import_name: str | list = None,
-) -> Any:
-    """
-    Import a module by its path.
-
-    Args:
-        module_path: The path of the module to import.
-
-    Returns:
-        The imported module.
-
-    Raises:
-        ImportError: If the module cannot be imported.
-    """
-    try:
-        full_import_path = (
-            f"{package_name}.{module_name}" if module_name else package_name
-        )
-
-        if import_name:
-            import_name = (
-                [import_name]
-                if not isinstance(import_name, list)
-                else import_name
-            )
-            a = __import__(
-                full_import_path,
-                fromlist=import_name,
-            )
-            if len(import_name) == 1:
-                return getattr(a, import_name[0])
-            return [getattr(a, name) for name in import_name]
-        else:
-            return __import__(full_import_path)
-
-    except ImportError as e:
-        raise ImportError(
-            f"Failed to import module {full_import_path}: {e}"
-        ) from e
-
-
-def is_import_installed(package_name: str) -> bool:
-    """
-    Check if a package is installed.
-
-    Args:
-        package_name: The name of the package to check.
-
-    Returns:
-        bool: True if the package is installed, False otherwise.
-    """
-    return importlib.util.find_spec(package_name) is not None

lionagi/version.py

@@ -1 +1 @@
-__version__ = "0.15.14"
+__version__ = "0.16.0"

{lionagi-0.15.14.dist-info → lionagi-0.16.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.15.14
+Version: 0.16.0
 Summary: An Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>
 License:            Apache License
@@ -223,12 +223,14 @@ Requires-Dist: aiocache>=0.12.0
 Requires-Dist: aiohttp>=3.11.0
 Requires-Dist: anyio>=4.7.0
 Requires-Dist: backoff>=2.0.0
+Requires-Dist: exceptiongroup>=1.3.0
 Requires-Dist: jinja2>=3.0.0
 Requires-Dist: json-repair>=0.40.0
+Requires-Dist: msgspec>=0.18.0
 Requires-Dist: pillow>=10.0.0
 Requires-Dist: psutil>=6.0.0
 Requires-Dist: pydantic-settings>=2.8.0
-Requires-Dist: pydapter[pandas]>=1.0.4
+Requires-Dist: pydapter[pandas]>=1.0.5
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: tiktoken>=0.9.0
 Requires-Dist: toml>=0.8.0

{lionagi-0.15.14.dist-info → lionagi-0.16.0.dist-info}/RECORD

@@ -5,8 +5,8 @@ lionagi/_types.py,sha256=j8XwSGeGrYwfmSJ8o-80bsfoalLWJgQH41ZkVevc4wk,75
 lionagi/config.py,sha256=D13nnjpgJKz_LlQrzaKKVefm4hqesz_dP9ROjWmGuLE,3811
 lionagi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/settings.py,sha256=HDuKCEJCpc4HudKodBnhoQUGuTGhRHdlIFhbtf3VBtY,1633
-lionagi/utils.py,sha256=7Hlt60LiShRdNPXv4y2e_xq7W2N0PM5cGRJnc8qXAVw,28660
-lionagi/version.py,sha256=twn0Vrxaz4hLyeNEgJYUkN06H8sXuoxF6BpefwWSUTU,24
+lionagi/utils.py,sha256=cFUhOL2clDwsRnBjNdysnK-_0Z9SmejPIkg6_i2jLXE,27512
+lionagi/version.py,sha256=3Msc5baw88UJubVj5AVFB8tExkT2OFIsNWe2leaoHhc,23
 lionagi/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lionagi/adapters/_utils.py,sha256=n4DS27CZfC-0O_UFaYtlUdjiMx9IeYsGpP7MVaFO5ZA,885
 lionagi/adapters/async_postgres_adapter.py,sha256=OEJd9ie8prxRQK2_-W9qmdI3Sl6Q7xxRs7Vey16G3pQ,3172
@@ -75,31 +75,36 @@ lionagi/libs/unstructured/pdf_to_image.py,sha256=lJ2CVxOYh61-3-55nusHXMOGqtEyLXs
 lionagi/libs/unstructured/read_image_to_base64.py,sha256=EJXWBJxCTa9vHBIFPRqQj0jeFXyDv1cs2oPBrWt-waQ,897
 lionagi/libs/validate/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/libs/validate/common_field_validators.py,sha256=1BHznXnJYcLQrHqvHKUnP6aqCptuQ0qN7KJRCExcJBU,4778
-lionagi/libs/validate/fuzzy_match_keys.py,sha256=M4EfpeWKE1eACLxeC4K-VDmHZXMRHeGUkDFbfny80AM,6255
+lionagi/libs/validate/fuzzy_match_keys.py,sha256=Nec5W1CVdmUgzcyDHcHiaELY6tFsicjbVsMI5dsIilk,190
 lionagi/libs/validate/fuzzy_validate_mapping.py,sha256=MZpRop3whCQQtgYwJgg66nbN0KxNuKXqulaAgA0Y1_g,4935
-lionagi/libs/validate/string_similarity.py,sha256=axgLjDgDfBT-soxZFU2iH2bZYmGePSzc9Mxl3WlOxAA,8718
+lionagi/libs/validate/string_similarity.py,sha256=kuOQFNnI773bV8KKj_PUYxx8vLRdWay8PhuvkOWsU9E,186
 lionagi/libs/validate/to_num.py,sha256=ZRHDjpTCykPfDIZZa4rZKNaR_8ZHbPDFlw9rc02DrII,11610
 lionagi/libs/validate/validate_boolean.py,sha256=bjiX_WZ3Bg8XcqoWLzE1G9BpO0AisrlZUxrpye_mlGk,3614
 lionagi/libs/validate/xml_parser.py,sha256=PHBYAre4hhthPpDP9Yrp3UYSWdANPx60F1qhxe0m4uw,7004
-lionagi/ln/__init__.py,sha256=aunFi1qRkEuTzdcrkN9pv499aynmQdjlNbJJBRPwRvc,1754
-lionagi/ln/_async_call.py,sha256=pRwJqUELQ22YMiLVv4zS-NSuTGHftqBvxSnt5P_ReZk,9390
-lionagi/ln/_extract_json.py,sha256=K82UBoVQbb6hib9bIqnYgFFYefvw7hIx11D6NKMZfws,1843
-lionagi/ln/_fuzzy_json.py,sha256=zJGyyBoEidLFSIF9i8sactTrQOhyAecQhtvhls9w4mU,3541
-lionagi/ln/_hash.py,sha256=g20yJfuVhAsfsBOWlkO889DHte6cbUCl6vV5QMT8nUo,3499
+lionagi/ln/__init__.py,sha256=w38jHMfmmdUJc6_ZVo5x7Ieh2ugmbcTxkb4yLlmmAHI,1487
+lionagi/ln/_async_call.py,sha256=mnqq5l-hNIBWrWh7X7CtmwPafg1kT-lnWWm3nJnbPoI,9384
+lionagi/ln/_hash.py,sha256=WLwKsbJISE7KtOrpiE30AFtfwyOCSBjb1GslBlvj5ac,4529
 lionagi/ln/_json_dump.py,sha256=M4ceccjkU7AN6wd5fUWKFmHytE-EVe8wqoQEFP0OkoA,2026
-lionagi/ln/_list_call.py,sha256=oDCyTzz7F7KVAMjekKftJp7qgIZ9Yo8BUNMHasKoJhU,3935
-lionagi/ln/_models.py,sha256=Txhdtp2YNq6ZsK9kLza40hRpWu27DzaVNMthCG7-zJM,4786
-lionagi/ln/_to_list.py,sha256=DKjZAah6pm6frHls773yTMVK1I3OY7qxwLemOjRPr5A,5600
-lionagi/ln/_types.py,sha256=usVaL2tGnYVQ2W12eUhJYiXY-m55b_5e0tUOFcuDtkc,3607
-lionagi/ln/concurrency/__init__.py,sha256=Sv1LEvwN1hRESLtuYM5UltyJqx6DRsHvGmr8aof16cA,1286
-lionagi/ln/concurrency/cancel.py,sha256=TYLxQ1D7mqhs8J4qJ_yTqP0j01zBe-Qed8-YnJlgKi0,4018
-lionagi/ln/concurrency/errors.py,sha256=FhLgXGFSbKZYPNfXjdnkV-0ShPF_S34RBLyTO_Pk5C8,938
-lionagi/ln/concurrency/patterns.py,sha256=dlC7nhIYE-D5VySNAPsd6PYYlORRAqNX50oKJRR1PO8,7796
-lionagi/ln/concurrency/primitives.py,sha256=fgml37nggaEGuvAJHQY6-rpSuAuei56YVSjTlIieM2o,8996
-lionagi/ln/concurrency/resource_tracker.py,sha256=52Rq7yMWK7DlebBW90imSjYeEAp8Gp9nL0dG2PD8Ivs,5464
-lionagi/ln/concurrency/task.py,sha256=nVts_yPylkZVSk3l3I4MkUdC7rhoN2qQeFfrsvekVgE,3146
-lionagi/ln/concurrency/throttle.py,sha256=Ho5zh_3beSXi9cMDDj70xz447BLzBJVopnUlQ18k9Lc,2198
-lionagi/ln/concurrency/utils.py,sha256=4TvDnPKhtbesb6YWZ9QlhskiOb07ai_eJ-PrmqY14IE,346
+lionagi/ln/_list_call.py,sha256=zvISmCeNAH7yjBcusQI1s17n556tILgePhRMdAM2plA,2831
+lionagi/ln/_to_list.py,sha256=YOlrMplSpQhXDSTK4fkMF7Mhuw1wS0jGip5mS88Otro,6610
+lionagi/ln/_utils.py,sha256=5Z_AsDxdtH5wNB-P4IiihhH0dYUcZMT-hTxFQBQPwL0,4303
+lionagi/ln/types.py,sha256=MfLUa5iZnOdAJI4owNXA-w41l1ZL7Fs8DVE4OGXQPF8,8517
+lionagi/ln/concurrency/__init__.py,sha256=xt_GLZ1Zb-nC-RnrNt8jOBWb_uf1md__B1R5cplMShg,1190
+lionagi/ln/concurrency/_compat.py,sha256=itxdRzl95PLEBQvNY0zTriF39kymaNRpKncT8QsOomA,2065
+lionagi/ln/concurrency/cancel.py,sha256=8JlWy_EVto4Fls1yQLBteCbpn4zP6ydnqIa_EL5kxZc,3313
+lionagi/ln/concurrency/errors.py,sha256=Tg76ods-CG_9rz7TksTiRGqpTzWHi-Wm9JPotGB9iEM,869
+lionagi/ln/concurrency/patterns.py,sha256=08eebVxbBxkcMFgJqZB-cXS7lRZduH1Y-zorb8fTTZs,9447
+lionagi/ln/concurrency/primitives.py,sha256=-mXU-mUThbr9YUH2viw8mY5iOuKn5E5CoiTlG41NO3k,9543
+lionagi/ln/concurrency/resource_tracker.py,sha256=ffLr0FkHyaHsUa4UDyWwse-8wGLaLMnAyfyeTDyzrDA,1512
+lionagi/ln/concurrency/task.py,sha256=VS5keFI3Ct0fqCKbFl4kEWT5I2CgjIYizPU-S2YjGKo,2675
+lionagi/ln/concurrency/throttle.py,sha256=yUAM4hnone6VzlFEos0fWERkZU9YC4J6TncZL-MqkG4,2319
+lionagi/ln/concurrency/utils.py,sha256=MUWupnFtWxR15hWnligLZrS4Z1SAQ7j3cuCG08cK3GQ,431
+lionagi/ln/fuzzy/__init__.py,sha256=_OE6Scyw99uU7gcCmYS4mB29LrpPayUJXeYlGhZTjlg,445
+lionagi/ln/fuzzy/_extract_json.py,sha256=rYHaK36yzRpie8qO-T7mZKOue2yqCLx3ixiuKhsaKvg,2224
+lionagi/ln/fuzzy/_fuzzy_json.py,sha256=S0lCkNvprn7XZHoYdRfzXueexSbjxTeLPkpyJ9IAO3A,3860
+lionagi/ln/fuzzy/_fuzzy_match.py,sha256=MBL2qB180MsGkIvhiHQpVObfikBFjcLcFWG9T6vLZQ0,5915
+lionagi/ln/fuzzy/_fuzzy_validate.py,sha256=ISC6EulV9VhIfR5Hh8JIq6WMcZOqt3AJPLUY6ZqpM1Y,1458
+lionagi/ln/fuzzy/_string_similarity.py,sha256=axgLjDgDfBT-soxZFU2iH2bZYmGePSzc9Mxl3WlOxAA,8718
 lionagi/models/__init__.py,sha256=R7DEGWuhH-izP7eN6SOw24-I4Mr2IVPXF4gNysmF2zQ,457
 lionagi/models/field_model.py,sha256=JdmCp2pmwoy5HuduF21ivqyvMaJ04CTXu6Un-AeSwLU,23652
 lionagi/models/hashable_model.py,sha256=oOqR3OJCU9cJfWHiG0WaEw0GMqfE2WTt4cy7WsAsiRg,829
@@ -109,7 +114,7 @@ lionagi/models/operable_model.py,sha256=Zm_Hxdauqyh0za3_TJLCZ3g6nR4F45Rrnc0ZM3d5
 lionagi/models/schema_model.py,sha256=ghRIM8aBNaToAknwNlhQKpuKXcwzyCw5pDE31bVKxs0,667
 lionagi/operations/__init__.py,sha256=a1EqxC5jRgVM1z_srZsxXtTC2Q6iA79ofpcd7cyT3B8,632
 lionagi/operations/builder.py,sha256=tMl3zZkp-dQAdR27chrAmjmYVaJGshP7tf6AyNJyCUw,23177
-lionagi/operations/flow.py,sha256=JB0SnVZbqLJc9cRGHy_p7QKvTBcB63H9n1iDyhWJDRo,22202
+lionagi/operations/flow.py,sha256=ZfCN_xlPuI2ZJAPL4opYNkTvNMaVQxTq-HKRZ4Lybjk,22248
 lionagi/operations/manager.py,sha256=YZr3VjPAZVVFd_bIjF1aoQqzzKZHNA1kcqefNi5QFFM,683
 lionagi/operations/node.py,sha256=qmjhv-8UzQMO5ocBlNWuv9nqQiLh5CV7AW_tno8jIUM,3183
 lionagi/operations/types.py,sha256=fM8HphnbBifMzhoKKvdl3JxGCBHlEGPJEYkLWj9b7vE,704
@@ -131,7 +136,7 @@ lionagi/operations/instruct/instruct.py,sha256=7pxhyP5jxwpgqjmQNb1rnGF4QAVlbMENp
 lionagi/operations/interpret/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/operations/interpret/interpret.py,sha256=yl1NSp2iOm3dbycVLEcnV3absnqKoubfH15v6lQgySU,1500
 lionagi/operations/operate/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
-lionagi/operations/operate/operate.py,sha256=G-VGjvhKxxgQLyoxigOYcYHMOazyM1ESQMfbrM33SPM,7233
+lionagi/operations/operate/operate.py,sha256=SHk-BqjUWnN5aT7Xrm3lzR6yDppq_i2sbN8Iny8PelE,7512
 lionagi/operations/parse/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/operations/parse/parse.py,sha256=xS9uIxBzHLGD-1VpBVgGUhxF-tQDkF2KLmIpErM47RQ,6661
 lionagi/operations/plan/__init__.py,sha256=yGBPll6lOqVjadbTvDLGrTlMx3FfBW-e00z7AMvg7Uo,156
@@ -144,7 +149,9 @@ lionagi/operations/translate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 lionagi/operations/translate/translate.py,sha256=6eBVoQRarGEJ8Tfcl6Z__PLHQTTIbM5MaPVYNeKHRIs,1397
 lionagi/protocols/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/protocols/_concepts.py,sha256=ZBN5OYpLMWLrl9uZqSg9GD4uwf60V4VHcxRnBTRWIRc,1555
-lionagi/protocols/types.py,sha256=rc1RZSxNEHSrOw72IIlWXI8vzgEmCGkZI98GIYG6sTU,2505
+lionagi/protocols/contracts.py,sha256=ii7luaPJsEKOb3J-rcaNysPDGU3nEzpgy_8g1z5_CCA,1398
+lionagi/protocols/ids.py,sha256=RM40pP_4waMJcfCGmEK_PfS8-k_DuDbC1fG-2Peuf6s,2472
+lionagi/protocols/types.py,sha256=EEmgYcaMCbgLU2rk7lTyKyRh_B15BeMccciv097j3Eg,2828
 lionagi/protocols/action/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/protocols/action/function_calling.py,sha256=rfuzIowjJpyqO5Ynfs5fGnxsDIU5aKinTj1NI6bGlEU,5106
 lionagi/protocols/action/manager.py,sha256=XmdQIaVgSpmFBFW9kbW_rdwdQmlBteP4VRanxh_f918,8549
@@ -156,10 +163,10 @@ lionagi/protocols/forms/form.py,sha256=B4903km_Ljz-OxYkb1ZT_cpHZSaAYYJpZMsffWloo
 lionagi/protocols/forms/report.py,sha256=SvJJjOSCTfVuqK7AKaY8ldQIGJeSK2zoyPWUV41ge2c,1609
 lionagi/protocols/generic/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/protocols/generic/element.py,sha256=5R9cLodaPzSPbellgFEudRxZIOMJDiCV8emyQKuEbPI,18621
-lionagi/protocols/generic/event.py,sha256=Rwke4sNLddQlJ8PTu-dTPZYBy1qmwaLAERbOLd_udpg,6512
+lionagi/protocols/generic/event.py,sha256=n5EraAJ5bPiwegTdkxsILs7-vFJwmnXhB2om4xMQnK0,6529
 lionagi/protocols/generic/log.py,sha256=Y06zAQewkNlaIWjut_c6c45KY_LJfLHwzUaDGLULaas,8212
 lionagi/protocols/generic/pile.py,sha256=mc10zh9RdqfozPEBOgRdkrTgIWUHBz8enAcQ-8pFhRQ,37046
-lionagi/protocols/generic/processor.py,sha256=GvHblXvOaZJ485L3bWcV3S4w9x0GYxWH-LkPXv00zMI,11700
+lionagi/protocols/generic/processor.py,sha256=uiNIldAYPEujuboLFyrIJADMlhRghy3H86hYintj5D4,11705
 lionagi/protocols/generic/progression.py,sha256=HCV_EnQCFvjg6D7eF4ygGrZNQPEOtu75zvW1sJbAVrM,15190
 lionagi/protocols/graph/__init__.py,sha256=UPu3OmUpjSgX2aBuBJUdG2fppGlfqAH96hU0qIMBMp0,253
 lionagi/protocols/graph/_utils.py,sha256=mts4M2wcGKdY9hC-1917lxIJT5oycW9VnRgfRx8ydbI,605
@@ -236,7 +243,7 @@ lionagi/tools/types.py,sha256=XtJLY0m-Yi_ZLWhm0KycayvqMCZd--HxfQ0x9vFUYDE,230
 lionagi/tools/file/__init__.py,sha256=5y5joOZzfFWERl75auAcNcKC3lImVJ5ZZGvvHZUFCJM,112
 lionagi/tools/file/reader.py,sha256=2YKgU3VKo76zfL_buDAUQJoPLC56f6WJ4_mdJjlMDIM,9509
 lionagi/tools/memory/tools.py,sha256=earYkKxSOz_iXkqVZYTEDfE3dwZYIWPXZrqQ1DYGz4I,15941
-lionagi-0.15.14.dist-info/METADATA,sha256=B9IMnGWdUDI43F5aDYmhldz7LynHcJ8mjRp_2xubKgk,23052
-lionagi-0.15.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lionagi-0.15.14.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
-lionagi-0.15.14.dist-info/RECORD,,
+lionagi-0.16.0.dist-info/METADATA,sha256=GGDAE5nFDfUE01hTZxmw1FWJ8XwSnPSsxNoNuHHQR1g,23119
+lionagi-0.16.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lionagi-0.16.0.dist-info/licenses/LICENSE,sha256=VXFWsdoN5AAknBCgFqQNgPWYx7OPp-PFEP961zGdOjc,11288
+lionagi-0.16.0.dist-info/RECORD,,