mirascope 2.0.0a3__py3-none-any.whl → 2.0.0a5__py3-none-any.whl

mirascope/llm/responses/response.py

@@ -21,6 +21,7 @@ from ..tools import (
 from ..types import Jsonable
 from .base_response import BaseResponse
 from .finish_reason import FinishReason
+from .usage import Usage
 
 if TYPE_CHECKING:
     from ..providers import ModelId, Params, ProviderId
@@ -42,6 +43,7 @@ class Response(BaseResponse[Toolkit, FormattableT]):
         input_messages: Sequence[Message],
         assistant_message: AssistantMessage,
         finish_reason: FinishReason | None,
+        usage: Usage | None,
     ) -> None:
         """Initialize a `Response`."""
         toolkit = tools if isinstance(tools, Toolkit) else Toolkit(tools=tools)
@@ -56,6 +58,7 @@ class Response(BaseResponse[Toolkit, FormattableT]):
             input_messages=input_messages,
             assistant_message=assistant_message,
             finish_reason=finish_reason,
+            usage=usage,
         )
 
     def execute_tools(self) -> Sequence[ToolOutput[Jsonable]]:
@@ -113,6 +116,7 @@ class AsyncResponse(BaseResponse[AsyncToolkit, FormattableT]):
         input_messages: Sequence[Message],
         assistant_message: AssistantMessage,
         finish_reason: FinishReason | None,
+        usage: Usage | None,
     ) -> None:
         """Initialize an `AsyncResponse`."""
         toolkit = (
@@ -129,6 +133,7 @@ class AsyncResponse(BaseResponse[AsyncToolkit, FormattableT]):
             input_messages=input_messages,
             assistant_message=assistant_message,
             finish_reason=finish_reason,
+            usage=usage,
         )
 
     async def execute_tools(self) -> Sequence[ToolOutput[Jsonable]]:
@@ -195,6 +200,7 @@ class ContextResponse(
         input_messages: Sequence[Message],
         assistant_message: AssistantMessage,
         finish_reason: FinishReason | None,
+        usage: Usage | None,
     ) -> None:
         """Initialize a `ContextResponse`."""
         toolkit = (
@@ -211,6 +217,7 @@ class ContextResponse(
             input_messages=input_messages,
             assistant_message=assistant_message,
             finish_reason=finish_reason,
+            usage=usage,
         )
 
     def execute_tools(self, ctx: Context[DepsT]) -> Sequence[ToolOutput[Jsonable]]:
@@ -283,6 +290,7 @@ class AsyncContextResponse(
         input_messages: Sequence[Message],
         assistant_message: AssistantMessage,
         finish_reason: FinishReason | None,
+        usage: Usage | None,
     ) -> None:
         """Initialize an `AsyncContextResponse`."""
         toolkit = (
@@ -301,6 +309,7 @@ class AsyncContextResponse(
             input_messages=input_messages,
             assistant_message=assistant_message,
             finish_reason=finish_reason,
+            usage=usage,
         )
 
     async def execute_tools(

mirascope/llm/responses/root_response.py

@@ -11,6 +11,7 @@ from ..messages import Message
 from ..tools import ToolkitT
 from . import _utils
 from .finish_reason import FinishReason
+from .usage import Usage
 
 if TYPE_CHECKING:
     from ..models import Model
@@ -55,12 +56,15 @@ class RootResponse(Generic[ToolkitT, FormattableT], ABC):
     """
     finish_reason: FinishReason | None
     """The reason why the LLM finished generating a response, if set.
-    
+
     `finish_reason` is only set if the response did not finish generating normally,
     e.g. `FinishReason.MAX_TOKENS` if the model ran out of tokens before completing.
     When the response generates normally, `response.finish_reason` will be `None`.
     """
 
+    usage: Usage | None
+    """Token usage statistics for this response, if available."""
+
     format: Format[FormattableT] | None
     """The `Format` describing the structured response format, if available."""
 

mirascope/llm/responses/usage.py

@@ -0,0 +1,95 @@
+"""Provider-agnostic usage statistics for LLM API calls."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Literal
+
+
+@dataclass(kw_only=True)
+class UsageDeltaChunk:
+    """A chunk containing incremental token usage information from a streaming response.
+
+    This represents a delta/increment in usage statistics as they arrive during streaming.
+    Multiple UsageDeltaChunks are accumulated to produce the final Usage object.
+    """
+
+    type: Literal["usage_delta_chunk"] = "usage_delta_chunk"
+
+    input_tokens: int = 0
+    """Delta in input tokens."""
+
+    output_tokens: int = 0
+    """Delta in output tokens."""
+
+    cache_read_tokens: int = 0
+    """Delta in cache read tokens."""
+
+    cache_write_tokens: int = 0
+    """Delta in cache write tokens."""
+
+    reasoning_tokens: int = 0
+    """Delta in reasoning/thinking tokens."""
+
+
+@dataclass(kw_only=True)
+class Usage:
+    """Token usage statistics from an LLM API call.
+
+    This abstraction captures common usage metrics across providers while preserving
+    access to the raw provider-specific usage data.
+    """
+
+    input_tokens: int = 0
+    """The number of input tokens used.
+
+    This includes ALL input tokens, including cache read and write tokens.
+
+    Will be 0 if not reported by the provider.
+    """
+
+    output_tokens: int = 0
+    """The number of output tokens used.
+
+    This includes ALL output tokens, including `reasoning_tokens` that may not be
+    in the user's visible output, or other "hidden" tokens.
+
+    Will be 0 if not reported by the provider.
+    """
+
+    cache_read_tokens: int = 0
+    """The number of tokens read from cache (prompt caching).
+
+    These are input tokens that were read from cache. Cache read tokens are generally
+    much less expensive than regular input tokens.
+
+    Will be 0 if not reported by the provider or if caching was not used.
+    """
+
+    cache_write_tokens: int = 0
+    """The number of tokens written to cache (cache creation).
+
+    These are input tokens that were written to cache, for future reuse and retrieval.
+    Cache write tokens are generally more expensive than uncached input tokens,
+    but may lead to cost savings down the line when they are re-read as cache_read_tokens.
+
+    Will be 0 if not reported by the provider or if caching was not used.
+    """
+
+    reasoning_tokens: int = 0
+    """The number of tokens used for reasoning/thinking.
+
+    Reasoning tokens are a subset of output_tokens that were generated as part of the model's
+    interior reasoning process. They are billed as output tokens, though they are generally
+    not shown to the user.
+
+    Will be 0 if not reported by the provider or if the model does not support reasoning.
+    """
+
+    raw: Any = None
+    """The raw usage object from the provider."""
+
+    @property
+    def total_tokens(self) -> int:
+        """The total number of tokens used (input + output)."""
+        return self.input_tokens + self.output_tokens

mirascope/ops/_internal/closure.py

@@ -50,6 +50,55 @@ def _is_third_party(module: ModuleType, site_packages: set[str]) -> bool:
     )
 
 
+class _RemoveVersionDecoratorTransformer(cst.CSTTransformer):
+    """CST transformer to remove @ops.version and @version decorators."""
+
+    @classmethod
+    def _is_version_decorator(cls, decorator: cst.Decorator) -> bool:
+        """Returns True if the decorator is @version or @ops.version."""
+        decorator_node = decorator.decorator
+
+        if isinstance(decorator_node, cst.Name) and decorator_node.value == "version":
+            return True
+        if (
+            isinstance(decorator_node, cst.Call)
+            and isinstance(decorator_node.func, cst.Name)
+            and decorator_node.func.value == "version"
+        ):
+            return True
+
+        if (
+            isinstance(decorator_node, cst.Attribute)
+            and isinstance(decorator_node.value, cst.Name)
+            and decorator_node.value.value == "ops"
+            and decorator_node.attr.value == "version"
+        ):
+            return True
+        if isinstance(decorator_node, cst.Call) and isinstance(
+            decorator_node.func, cst.Attribute
+        ):
+            func_attribute = decorator_node.func
+            if (
+                isinstance(func_attribute.value, cst.Name)
+                and func_attribute.value.value == "ops"
+                and func_attribute.attr.value == "version"
+            ):
+                return True
+
+        return False
+
+    def leave_FunctionDef(
+        self, original_node: cst.FunctionDef, updated_node: cst.FunctionDef
+    ) -> cst.FunctionDef:
+        """Returns function definition with @version/@ops.version decorators removed."""
+        new_decorators = [
+            decorator
+            for decorator in updated_node.decorators
+            if not self._is_version_decorator(decorator)
+        ]
+        return updated_node.with_changes(decorators=new_decorators)
+
+
 class _RemoveDocstringTransformer(cst.CSTTransformer):
     """CST transformer to remove docstrings from functions and classes."""
 
@@ -125,14 +174,9 @@ def _clean_source_code(
     if docstr_flag in ("1", "true", "yes"):
         return source.rstrip()
     module = cst.parse_module(source)
-
-    transformer = _RemoveDocstringTransformer(exclude_fn_body=exclude_fn_body)
-    new_module = module.visit(transformer)
-
-    code = new_module.code
-    code = code.rstrip()
-
-    return code
+    module = module.visit(_RemoveVersionDecoratorTransformer())
+    module = module.visit(_RemoveDocstringTransformer(exclude_fn_body=exclude_fn_body))
+    return module.code.rstrip()
 
 
 @dataclass(frozen=True)
@@ -596,9 +640,9 @@ def _clean_source_from_string(source: str, exclude_fn_body: bool = False) -> str
     """Returns cleaned source code string with optional docstring removal."""
     source = dedent(source)
     module = cst.parse_module(source)
-    transformer = _RemoveDocstringTransformer(exclude_fn_body=exclude_fn_body)
-    new_module = module.visit(transformer)
-    return new_module.code.rstrip()
+    module = module.visit(_RemoveVersionDecoratorTransformer())
+    module = module.visit(_RemoveDocstringTransformer(exclude_fn_body=exclude_fn_body))
+    return module.code.rstrip()
 
 
 def _get_class_source_from_method(method: Callable[..., Any]) -> str:
@@ -694,6 +738,13 @@ class _DependencyCollector:
             # For Python 3.13+
             return definition.func  # pyright: ignore[reportFunctionMemberAccess] # pragma: no cover
 
+        if (
+            (wrapped_function := getattr(definition, "fn", None)) is not None
+            and not hasattr(definition, "__qualname__")
+            and callable(wrapped_function)
+        ):
+            return wrapped_function
+
         return definition
 
     def _get_source_code(self, definition: Callable[..., Any] | type) -> str | None:

{mirascope-2.0.0a3.dist-info → mirascope-2.0.0a5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mirascope
-Version: 2.0.0a3
+Version: 2.0.0a5
 Summary: LLM abstractions that aren't obstructions
 Project-URL: Homepage, https://mirascope.com
 Project-URL: Documentation, https://mirascope.com/docs/mirascope/v2
@@ -51,7 +51,7 @@ Requires-Dist: httpx>=0.27.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: typing-extensions>=4.10.0
 Provides-Extra: all
-Requires-Dist: anthropic<1.0,>=0.72.0; extra == 'all'
+Requires-Dist: anthropic<1.0,>=0.75.0; extra == 'all'
 Requires-Dist: google-genai<2,>=1.48.0; extra == 'all'
 Requires-Dist: libcst>=1.8.6; extra == 'all'
 Requires-Dist: mcp<2,>=1.0.0; extra == 'all'
@@ -70,7 +70,7 @@ Requires-Dist: pillow<11,>=10.4.0; extra == 'all'
 Requires-Dist: proto-plus>=1.24.0; extra == 'all'
 Requires-Dist: pydantic-settings>=2.12.0; extra == 'all'
 Provides-Extra: anthropic
-Requires-Dist: anthropic<1.0,>=0.72.0; extra == 'anthropic'
+Requires-Dist: anthropic<1.0,>=0.75.0; extra == 'anthropic'
 Provides-Extra: api
 Requires-Dist: pydantic-settings>=2.12.0; extra == 'api'
 Provides-Extra: google

{mirascope-2.0.0a3.dist-info → mirascope-2.0.0a5.dist-info}/RECORD

@@ -3,10 +3,17 @@ mirascope/api/__init__.py,sha256=9EOn04v3kFagbL1_RTpT_uOwUf_lZeFXVb69g4uaNfs,201
 mirascope/api/client.py,sha256=3JrrC2zNlEttAUXHGN1kbDpGczyI9zCNiSZ3dEyqtAI,8253
 mirascope/api/settings.py,sha256=NeROu5F0xFDUs0jIPFhD_FzBgVjI2mgGkMHeVquoDIM,2125
 mirascope/api/_generated/README.md,sha256=7-B_qhXCHaXKX9FPG-G112hKmXM64uM6eNqmSdpaL_8,6079
-mirascope/api/_generated/__init__.py,sha256=dAqrMCODDQl2tnoV3R4_D3SG2zUnD_G5bZxJCDfJ1Xc,4273
-mirascope/api/_generated/client.py,sha256=975mpu-ifjCwjiXip1HQ3EnXFkT7wY2LqijxXNohFPs,5782
+mirascope/api/_generated/__init__.py,sha256=Gkxd073vC9Oku7nED0lguldqOU9LCUmmZ95mXIS8pJE,6308
+mirascope/api/_generated/client.py,sha256=Mm_6SKncKaeEsjG7mAELrglMeCwzaluKoUtWnixjraY,6751
 mirascope/api/_generated/environment.py,sha256=zrGdNnUZkaUyUtaamv2nKGfT9KZA5aCeWdSSN2dNphA,265
-mirascope/api/_generated/reference.md,sha256=nw3G6SxWmHg3_SO92s8LmYKARC_MEoeTR-Kdb4EytO0,2448
+mirascope/api/_generated/reference.md,sha256=dY3ZAXazhXcWGEElDsmmWUEGh3Dpqwrrp6J1GqhdZnE,16788
+mirascope/api/_generated/api_keys/__init__.py,sha256=SEqsc8eFGslfkVscvHABTONAy9ElPqgASfqwhwlAAzc,257
+mirascope/api/_generated/api_keys/client.py,sha256=4lskg3QWcyrm1i8OOgAR6tP4vy8myLFFByDqSstMIsY,11209
+mirascope/api/_generated/api_keys/raw_client.py,sha256=FBiXrm7_FTyEguj-T--Vz3rHCKbU0akP1UnnIBU3-30,30994
+mirascope/api/_generated/api_keys/types/__init__.py,sha256=sycSAknyK7WLoSQ9upf-g16-jExxkBXKMFLJKrg6esk,350
+mirascope/api/_generated/api_keys/types/api_keys_create_response.py,sha256=zxCa4hPxhokIxekq8sTGcrIhrDGFVnlqkBtTQ87yt2Q,1161
+mirascope/api/_generated/api_keys/types/api_keys_get_response.py,sha256=CJ0ULTnhUl2McMlFMu9utH69U-x62xd2RCAL6eI-mK8,1145
+mirascope/api/_generated/api_keys/types/api_keys_list_response_item.py,sha256=-hCwR2b2IoU3FO6xaz1fwprFzz-etUMwQnrGjUSuDYQ,1150
 mirascope/api/_generated/core/__init__.py,sha256=lTcqUPXcx4112yLDd70RAPeqq6tu3eFMe1pKOqkW9JQ,1562
 mirascope/api/_generated/core/api_error.py,sha256=44vPoTyWN59gonCIZMdzw7M1uspygiLnr3GNFOoVL2Q,614
 mirascope/api/_generated/core/client_wrapper.py,sha256=IDwIwiGeWsn5PvxRr8Cd_mZtNLrKYMbypyz0pfHloIA,1609
@@ -24,14 +31,46 @@ mirascope/api/_generated/core/serialization.py,sha256=UO5lcAerNrG-RfFLXPVU5MNV4x
 mirascope/api/_generated/docs/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 mirascope/api/_generated/docs/client.py,sha256=xeGkT4Oa2iiZruR3Xi7v4rDAx8blIkp6mIqy0RFpzBw,2507
 mirascope/api/_generated/docs/raw_client.py,sha256=GpvLeVDBrti9DqCjb3IHwEucR-vE899HEiDRthVtEDc,4815
-mirascope/api/_generated/errors/__init__.py,sha256=231FpxMihJ3fLHCNdI7nHyV1j0osaRyZsGC862F0O8I,163
+mirascope/api/_generated/environments/__init__.py,sha256=x9Fz9SsnkYoHC5xg_wEN5IF6hYdRSxjv3YRSfPG2C6c,385
+mirascope/api/_generated/environments/client.py,sha256=ILvVvUopS7zVO57giQwUHVVjoSe_4VXC5r22lqjQakQ,13391
+mirascope/api/_generated/environments/raw_client.py,sha256=SMGOQqcMKbYE6_TpXugO8ghkToazEJRrYV-I24nJ4zY,39591
+mirascope/api/_generated/environments/types/__init__.py,sha256=mMud06Aewplszo1rUPu16IHO3ZdYFZ_MRvZFEiLMTIk,510
+mirascope/api/_generated/environments/types/environments_create_response.py,sha256=GxOWifa4dNdTv401nfLsTopHp65rtIKEyQszz0nQACg,738
+mirascope/api/_generated/environments/types/environments_get_response.py,sha256=ckAAsdrAmpFFNhd1XPLK21veVzLZ08pdeEc_Y4c7JZE,735
+mirascope/api/_generated/environments/types/environments_list_response_item.py,sha256=cBo_J6ZBKngKNaKKlEvRL1Mt9CvuRwlt_3nzaolGF08,740
+mirascope/api/_generated/environments/types/environments_update_response.py,sha256=XyP27SXQ77aTzxImi3xX5D5CoSsajAY0YWDlHjYTZC0,738
+mirascope/api/_generated/errors/__init__.py,sha256=0pdSJizeQJozAkZFZcM3pXN6t6BIcqqZE9AAhHJIDPk,445
 mirascope/api/_generated/errors/bad_request_error.py,sha256=RAVSjgWr8jM993BLo-gO4c7H1ICDBI8a4MJ0UEen45Q,421
+mirascope/api/_generated/errors/conflict_error.py,sha256=U4FRUqIi0oKLxDMCtK1WD-cPcdoJA-OlVQ6wtPm-QnM,418
+mirascope/api/_generated/errors/forbidden_error.py,sha256=jej2hsAPAgWhNhsa8SJcNSNMmY4cqXDmVKdJc007hUE,428
+mirascope/api/_generated/errors/internal_server_error.py,sha256=bBWSdhuiUZFBZNm5qS29zIyOsC2GdKErQNKqYog-t34,408
+mirascope/api/_generated/errors/not_found_error.py,sha256=NFhOrCV76REeRC-XL-cklnw6jQceSKYGYsM9z8ULg_0,416
 mirascope/api/_generated/health/__init__.py,sha256=UN1u0qzFG8zDGf3CABrpMNNEP467lQZKLQfTOpkwm2E,215
 mirascope/api/_generated/health/client.py,sha256=SvPGUe72VyNoA7feW9iE4RDTzGIQ_pkXiR-d2Bg-cqU,2548
 mirascope/api/_generated/health/raw_client.py,sha256=XRhraAPYg3ur0m9zMtQV86izy-_xdjpF3mDimytfFow,4523
 mirascope/api/_generated/health/types/__init__.py,sha256=dYIZPgww1FuKOKJTeUWMDad1XYTzQaxp8jbwsfI_THI,272
 mirascope/api/_generated/health/types/health_check_response.py,sha256=CcwGy-ROHpWfgKcRxw537fsnO66bxKtT5eo4sealVgo,681
 mirascope/api/_generated/health/types/health_check_response_status.py,sha256=eCSX3a4cA5zETaIbLvtYkSeS3585DuJa9VnM1fw3VxE,155
+mirascope/api/_generated/organizations/__init__.py,sha256=AKFDrQ1SedKfX5Zsv8Kx8ynS8GYInaAm-jNvz1zFQiQ,695
+mirascope/api/_generated/organizations/client.py,sha256=qHBuvDaAS4MQG3JUGC4jUwgPo-PMG4twuQcXbk2hT_Q,10303
+mirascope/api/_generated/organizations/raw_client.py,sha256=5W5qnQNgDcEq63AaNaiKD8rUNYn1BU-IG6N9xrLCCYU,32779
+mirascope/api/_generated/organizations/types/__init__.py,sha256=wr6VfMIdBcNlA3qelxtxJZp3fvXwtr-DwsQ-PKlPaCs,996
+mirascope/api/_generated/organizations/types/organizations_create_response.py,sha256=J7Sp5j4EEZtpm4CK_dboRk9iJYR42K5GG2AYiyeu0PY,705
+mirascope/api/_generated/organizations/types/organizations_create_response_role.py,sha256=OsgWOdAazUDPZBwhQ8piqB5dPYPFGRGXUvzZxY_cwT0,189
+mirascope/api/_generated/organizations/types/organizations_get_response.py,sha256=KlxQNWGKLSPwgVyU-qmclUQE4yzIoRkOhidO8Qy067I,693
+mirascope/api/_generated/organizations/types/organizations_get_response_role.py,sha256=zYLPJtdYFk8Mz6e1yxpirva6Co2aaqKQksFOM4lCjME,186
+mirascope/api/_generated/organizations/types/organizations_list_response_item.py,sha256=sg-aiwhOU6JLtAbNGACMJMLoMPvTFo3IP-9Pfgp6XZ8,714
+mirascope/api/_generated/organizations/types/organizations_list_response_item_role.py,sha256=H2a1FebiZ9nAIZ92TnHyO4w3oRr0L4EAc58vaJXTW5U,191
+mirascope/api/_generated/organizations/types/organizations_update_response.py,sha256=V7o68hWmAnQpuPQ9gYekO5A-PD0Z6pjgzKPX55N1FUs,705
+mirascope/api/_generated/organizations/types/organizations_update_response_role.py,sha256=9Ya26-vC-PGq5hEmDlfB1ov6G2HjHYezblbnFjLj5Pk,189
+mirascope/api/_generated/projects/__init__.py,sha256=WuwOMLclS5a2OFxwBtCiBjI9De3OfD67DcZ-iI6IrAY,353
+mirascope/api/_generated/projects/client.py,sha256=kRz2jOIQ_b4RPPYVAUyL0eh4kuaovrDiOCAphplvErU,11963
+mirascope/api/_generated/projects/raw_client.py,sha256=Xv1I4SM4p7ltXFNlxDNF0JzAopCJPovNc2uqAjuEyVE,38401
+mirascope/api/_generated/projects/types/__init__.py,sha256=s4-7DLBngfy8scBC2sd149ACK2f7T6WoFkPIDWCi89Q,462
+mirascope/api/_generated/projects/types/projects_create_response.py,sha256=o8KUH8AkZnuJNLd-fXK_IEdN7KRWNwNKeJ8TcTEMZ9Q,869
+mirascope/api/_generated/projects/types/projects_get_response.py,sha256=l4DvJzX9UHGUeS3NXUk9A8bIbNfwEAi6w-4bEMqXaMY,866
+mirascope/api/_generated/projects/types/projects_list_response_item.py,sha256=7LubNKwdPDtxCHvTXokIgDneh1diJ2N4YBdX8W9cWms,871
+mirascope/api/_generated/projects/types/projects_update_response.py,sha256=Xy-q2SW-tjBpqh2bFIcAZmmR4WwWpZllCXYO8u1Hd_0,869
 mirascope/api/_generated/traces/__init__.py,sha256=SJinJhQCXCPrUYr9OfVMMBkS4qFW2ij9fm7Bc-tDF3o,3543
 mirascope/api/_generated/traces/client.py,sha256=FXZu6X_T-8oWEaN51KG2sTX8zDu2TJkRN3NWfElPKJQ,5374
 mirascope/api/_generated/traces/raw_client.py,sha256=r-QSTNCxvr3SxJe05z_XRvYgWjv9RZvA46EMZSRq1vQ,5982
@@ -59,16 +98,24 @@ mirascope/api/_generated/traces/types/traces_create_request_resource_spans_item_
 mirascope/api/_generated/traces/types/traces_create_request_resource_spans_item_scope_spans_item_spans_item_status.py,sha256=V5HwPpOY0WCScTE6OJe55hEYkKoTbLM4B6qCFicsUUg,668
 mirascope/api/_generated/traces/types/traces_create_response.py,sha256=LMCVtItwbrnqx9C4v9gkUxYgk4Ut6fJHziyQ_3W8kwE,867
 mirascope/api/_generated/traces/types/traces_create_response_partial_success.py,sha256=9pTxUVArKBy0W3demKDBmfANGRYvhoDN6dt6ZhjjQpU,881
-mirascope/api/_generated/types/__init__.py,sha256=RYBNlOlI5XVJHOoBD6XIw9lrJLNNJFStsxSp0fgM-c4,557
-mirascope/api/_generated/types/http_api_decode_error.py,sha256=ovodKRp3NOb3unLl1CO55-3HGfUN-Z7Cqe63e4Jzb1Q,895
+mirascope/api/_generated/types/__init__.py,sha256=A8hRek8If7ZF2TKEkBvPAbofmYp8MwxK4gS2wHcdaEw,1198
+mirascope/api/_generated/types/already_exists_error.py,sha256=DgG3dF2aCAoO8LAd4AMRY4ysxsjJC2qdhrq9Xylhpt4,683
+mirascope/api/_generated/types/already_exists_error_tag.py,sha256=Gkkp8M2D68eeecqivCeLZdEQ9s_E4-Wian0_SVrRMGU,167
+mirascope/api/_generated/types/database_error.py,sha256=F76RewoU6y1WAFHKWBsAj8M5VLtczL8abzM6uJwTDug,683
+mirascope/api/_generated/types/database_error_tag.py,sha256=f7yylB3n3uxnf99qE3w3jLz5F5lCx-thc7px9SvvK9E,157
+mirascope/api/_generated/types/http_api_decode_error.py,sha256=hAqR-MUDmNtEuK_AhNgsgWuD0NZm-jb4uZL9WJz4fIw,765
 mirascope/api/_generated/types/http_api_decode_error_tag.py,sha256=4brH10CC1DEuSmruTFmEuy9rVgpucv9Wsde-4g6oYQM,167
-mirascope/api/_generated/types/issue.py,sha256=hIVWBDlk95UqwXjr_kT_h1Nr2AHPX8-XwB7AwoJmAfI,1157
+mirascope/api/_generated/types/issue.py,sha256=iQeOA7wIh2uFEW4hI-fMxT6jSG7z6T3kwOFOKK-207A,1011
 mirascope/api/_generated/types/issue_tag.py,sha256=C4AQ5_ewX0CacDGg9pHKh6DW4yEDVS4QmckOH3W_TsI,316
-mirascope/api/_generated/types/property_key.py,sha256=KVmanwCdYxRPJOLIcmCoAGrSWH8t5hMjn8O9e0lD-tQ,181
-mirascope/api/_generated/types/property_key_tag.py,sha256=r5sa9IHwLeTm_qCnyeqYtdITkvSnagzDznQy416QsIw,826
-mirascope/api/_generated/types/property_key_tag_tag.py,sha256=yUdDrbnhJ_p_2wyfSq7cvagJrjTKtQG8k_pegrOYSjw,151
-mirascope/llm/__init__.py,sha256=1WFziSHxiu2WlXPxbYdAXQX_4iV0uQf9qTgM0FZiiKk,5075
-mirascope/llm/exceptions.py,sha256=81b5-3jUe68TWmzGDH7OP3jrDli5RoT2yfyBC7ukvoM,3586
+mirascope/api/_generated/types/not_found_error_body.py,sha256=BgfmnSIh6XPWq78_5U1UWcOywihwO2tsBF8KNgA0gbw,667
+mirascope/api/_generated/types/not_found_error_tag.py,sha256=dQtLl0Mr8uW56l-DVlHqaHxxUaUu4s5p8Dk2nRcx4yk,157
+mirascope/api/_generated/types/permission_denied_error.py,sha256=J1KZQ3hs_In0DnzVSH5Xq_6sBw7TYuWXxMilePiI8MA,695
+mirascope/api/_generated/types/permission_denied_error_tag.py,sha256=4bockT3ftu1Fda3mXzXb5-2xMzQsklnduXIJXGJ08SY,179
+mirascope/api/_generated/types/property_key.py,sha256=G_qu_0R1rdi2eY-rhTC3NO-IrbdHR0AcgdjSdwIOkBE,181
+mirascope/api/_generated/types/property_key_key.py,sha256=cEKRj67H_IP7Gl-cRqQkLIoFL0TFz4zbhwvBeLV8r7Y,696
+mirascope/api/_generated/types/property_key_key_tag.py,sha256=aNrMYf3B6V098Z9-tqlkNH1XvbkX9t2se3x-qbVe0CQ,151
+mirascope/llm/__init__.py,sha256=2xRvSo1yIUrT6GuU0X6btDLsBjGtTeXw2HUxXvnYtxA,5163
+mirascope/llm/exceptions.py,sha256=rxkADeNzENu898sp2YFa9yhsUlYFczX7mh0Su7cmw0I,4831
 mirascope/llm/calls/__init__.py,sha256=rnQ29w8x_EAEecZhP2i6N6u_qE-TO3sBZGAztF3o2QQ,273
 mirascope/llm/calls/calls.py,sha256=tb0GTfH4dxna5RvRjcrS969QPDgWT45t6J3khHzkQ9s,11783
 mirascope/llm/calls/decorator.py,sha256=F2KN-Ur25NyYZ8ir5yDozKP5X_bZTjQGMKTerEDrFnc,8766
@@ -100,63 +147,75 @@ mirascope/llm/prompts/_utils.py,sha256=kwSUdP4etxapheLoQPtB2UFXJs13o2IACWNdEVb_d
 mirascope/llm/prompts/decorator.py,sha256=IcQv2lktag5gioEYp5aPtaIe66ZR-i1gaYpj7jk2qVs,6985
 mirascope/llm/prompts/prompts.py,sha256=VcuGDbqT4Z3mBgJIaa0RsTSGkck1MyaxdufkgKHMVcU,14041
 mirascope/llm/prompts/protocols.py,sha256=auopJnLAfOognCFVVnXrvb4zFj3102Ofi2iVHfublM0,2242
-mirascope/llm/providers/__init__.py,sha256=5DSRSHQ5fppt0MR7HefsJWtUP6tcfg-kQPgwj3kk9dk,902
+mirascope/llm/providers/__init__.py,sha256=JEsCpCwzG55LVLfP3ckGKnBFMcEnM9KRuYrtn-h626c,1114
 mirascope/llm/providers/_missing_import_stubs.py,sha256=CO9FZgM0r1jWoTPOzc6G_fJ8pLUPK1K_c8Pg9OWfoDc,1581
-mirascope/llm/providers/load_provider.py,sha256=Ui4ZRZbIFnsnu092YOe0BENtE93D8l2SHy412qL8Ugc,1837
 mirascope/llm/providers/model_id.py,sha256=qr7RKkP_3Blgxjzw_HvQVJLM1aTzsP-jVFsycz0itI8,292
-mirascope/llm/providers/provider_id.py,sha256=oxi6XRLETdamgzuMcgOyxIsUq6m0n2qBZMZGIS-O6EE,453
-mirascope/llm/providers/provider_registry.py,sha256=bn_a3bPqCCN4bq1BGjRIo0gqKKWdbb-pyGpuUgppLQ4,5554
-mirascope/llm/providers/anthropic/__init__.py,sha256=P98Qc1ktZGa8WqenunmgMV43Fp-fIkwidXOAjDRNOeY,640
-mirascope/llm/providers/anthropic/model_id.py,sha256=aMpVde8oeEvNRCS9A9p73qF5deL4jXNQ_87zDoNRN94,1311
-mirascope/llm/providers/anthropic/provider.py,sha256=BiEnhLz82Wy66t7nUG0NP3pfAmiIfBWX334j920IyQE,15217
-mirascope/llm/providers/anthropic/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
-mirascope/llm/providers/anthropic/_utils/decode.py,sha256=3nQOt8Rh5LEESni2EZLIuFYK5wLCldf5CUI0lBHTUP8,9134
-mirascope/llm/providers/anthropic/_utils/encode.py,sha256=JKF353LVdM5_0dtV5hs27fU5C79f2n1TeclzIZ6BjLU,9509
-mirascope/llm/providers/base/__init__.py,sha256=TdIwuefY-hZmKJWYyMBLOF6iR6dlsJeK7LnOVOn25YE,291
-mirascope/llm/providers/base/_utils.py,sha256=kZHvuDsJoHyySqyEBxSNe9X616-wce2Cvk4H0siXqwo,7015
-mirascope/llm/providers/base/base_provider.py,sha256=y4Vuy9Nezq1IIZXBpLSpSjbJyU1CFFCiVOu8LMqnQUI,46506
+mirascope/llm/providers/provider_id.py,sha256=ueIYpQaUgNWeiAA2fuqldPWKxsd9rTlOu8k6jmpmesY,970
+mirascope/llm/providers/provider_registry.py,sha256=uNpDeNMmvMYk5xrhHLAsyY0fhHo6aX7KZkq9JPLLyRY,7733
+mirascope/llm/providers/anthropic/__init__.py,sha256=7G_udubLtuCSD9rtBD1t9vYd_FrqXM2UGdN6rE02VTE,854
+mirascope/llm/providers/anthropic/beta_provider.py,sha256=pz6_XM0hWyWcj_ZiiyodYgsxuXTE20y7Va_NER1adbs,11655
+mirascope/llm/providers/anthropic/model_id.py,sha256=3Wf4cZG8NUO3i7dHmw3At46JMfTuRWpS8pKYX2s-8B8,715
+mirascope/llm/providers/anthropic/model_info.py,sha256=YuklafFMIpkyLBJSBB0XlB6MK9Bz6hp9Z6APxJ9G1j4,2965
+mirascope/llm/providers/anthropic/provider.py,sha256=s2FXex5MmUjEwlWL2djrI7_Vm32yQs1vALPtBSF5Dkk,14966
+mirascope/llm/providers/anthropic/_utils/__init__.py,sha256=e3jb2NSsWYYgEQ-9r6qOmsnhliEKiZicQ6hI7jRSs4g,586
+mirascope/llm/providers/anthropic/_utils/beta_decode.py,sha256=NyEVPZ7_504-u_AnxnBB0A7S-fDlnrCC3Y3Rpvmzqxs,10032
+mirascope/llm/providers/anthropic/_utils/beta_encode.py,sha256=E5cXJog63xfekJ-SX2-K0TJl2CE22zQWmq-hMv-iCFI,7280
+mirascope/llm/providers/anthropic/_utils/decode.py,sha256=tMcEEEM9WbTxR7kiw0xEY3ILkNndkfwd7azYBOZpIAA,10268
+mirascope/llm/providers/anthropic/_utils/encode.py,sha256=HjJvBijtGI-aWbncCKHY02fdXyApC-OlH6An05pQgOc,13036
+mirascope/llm/providers/anthropic/_utils/errors.py,sha256=aYwYwePZj6P7dGKgb50YXisPppXKQDGfyCBnwyb64OY,1714
+mirascope/llm/providers/base/__init__.py,sha256=RkSlx0iVrPIDaJeiaTBm2t8Xu72fCTHJDYX_9H8gS4Q,333
+mirascope/llm/providers/base/_utils.py,sha256=_7BJsYQ80EFPwooh0RbmSOV-P86S_52Fs0HnaLFw7fU,7615
+mirascope/llm/providers/base/base_provider.py,sha256=Ze-KIbt279VZWeiaT0OXsGaRScO1c5sJEAIlnClw734,51826
 mirascope/llm/providers/base/kwargs.py,sha256=pjaHVqtlmScUBqG8ZAllVaLoepdKE-KYl2eTqzOBXm0,406
 mirascope/llm/providers/base/params.py,sha256=x2WLz0s5rMZ3u3GBGQmRlYGjecePtsLglHSJBLh35YE,3670
 mirascope/llm/providers/google/__init__.py,sha256=FgBiQApWbD0pnZuJlYVvoi_LN-5WRg6rsOtfILJRwlk,596
 mirascope/llm/providers/google/message.py,sha256=ryNsMKPSyBSVXl_H0MQEaSiWC3FFybjxIUuORNSiKTk,179
-mirascope/llm/providers/google/model_id.py,sha256=N17Z4QCI5MiV4fTp9q3LC-d3BL60Cbr37xpEK48fdnU,724
-mirascope/llm/providers/google/provider.py,sha256=TBJUl5N5GusjSlcxeVS0FAR31bgcwWOd2Z4BwbJpF-A,15196
-mirascope/llm/providers/google/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
-mirascope/llm/providers/google/_utils/decode.py,sha256=eBgV38gZg95tnaC11pFTzjfVsNodO2nwaiMZyO_BVLY,9104
-mirascope/llm/providers/google/_utils/encode.py,sha256=us2M48CyIpCe1LFcCDhd031NFT6_0cUrodoevkOVzl0,10888
+mirascope/llm/providers/google/model_id.py,sha256=vZJeKT-_J7oiFT5AkudintCFE4DhFJ-VZOFOcLP1rn0,603
+mirascope/llm/providers/google/model_info.py,sha256=EwR2YwdFoDxF0cWF2ZMRwNuhxrPKYZIEdjHHAZ10j7I,1982
+mirascope/llm/providers/google/provider.py,sha256=icrrXhelmM5BxOdJDx1PuhXrA96GsX_nWtFWuhbtcQ4,15523
+mirascope/llm/providers/google/_utils/__init__.py,sha256=MXG48jLez-S8hyMV4QVg83OLi20mayqbk-o0gYZ39mQ,293
+mirascope/llm/providers/google/_utils/decode.py,sha256=vxtDbCb6UlAFN0b5rrirfQ9xRhMSQD0Ai3SEq5rFz24,11205
+mirascope/llm/providers/google/_utils/encode.py,sha256=i0if8XnD662qJaeYW77b_oqlDrg9Qwi3hgZy1CoNACI,11345
+mirascope/llm/providers/google/_utils/errors.py,sha256=ci410dXx6NuKAkzWJFZjrefhGRnxLUXX3r0W4Uz7Xkg,1381
 mirascope/llm/providers/mlx/__init__.py,sha256=zUYFUn36AVxHaN0hgi-RTwVeO2eydz9B-8OkAsB9aOY,574
-mirascope/llm/providers/mlx/_utils.py,sha256=TPVNIhvqdSD9duhbZw73FgKtfYgs7hs0bS8LvnpBoU8,3321
+mirascope/llm/providers/mlx/_utils.py,sha256=2mMac0wUxbwsdlTI8MwO7aJ_bTJrvAE0LQusSluZMFw,4142
 mirascope/llm/providers/mlx/mlx.py,sha256=SfNpbKkRpJMW984-wVDyhzgMXfUL5Huo3tQfH3OvbPo,8116
 mirascope/llm/providers/mlx/model_id.py,sha256=oHj-ptT4vTPcatHtjDSw7Z7-xs8ACMfYeRoEsKkM6yE,618
-mirascope/llm/providers/mlx/provider.py,sha256=31uHiA-ar4JGU26FnLKhpHz1h_LN2k87VGZto-MqTyo,13879
+mirascope/llm/providers/mlx/provider.py,sha256=3J1oX9G1xXvnXGIAf9SMDKWxi1SEuztF2SfLwmwO9Xg,14330
 mirascope/llm/providers/mlx/encoding/__init__.py,sha256=qdI7HELeha1wj1OoOn1jH0Xta6yNkI_SDlYbqoWUd0c,163
 mirascope/llm/providers/mlx/encoding/base.py,sha256=5cQX_8RBEgrfiHiUD7waPAmi3Sy_0gkBsFpRvf7VIdE,2228
-mirascope/llm/providers/mlx/encoding/transformers.py,sha256=EosK5v52Bvk233H-G9yW-yCiGUH-5y4OGPHZUMRnZI0,4541
-mirascope/llm/providers/openai/__init__.py,sha256=oxNOUSsX9G7xt9yLImEcOp6E5PFDITOGzXphxFxuWDY,157
+mirascope/llm/providers/mlx/encoding/transformers.py,sha256=8tAK9kJfcVRn8ORX6eOeOWSQFd32sJYqPMoRhwlZoYM,5011
+mirascope/llm/providers/ollama/__init__.py,sha256=PTHoML03Z5aJLl0B4iQTuBq35o_NV_w7I3gKQEypXu8,438
+mirascope/llm/providers/ollama/provider.py,sha256=9c0pKDtc--H0SLiyqrjBKzt-Ya8gE9qZ-jpZvKEG90Y,2311
+mirascope/llm/providers/openai/__init__.py,sha256=D1b01XExoHIDdPdoWEBtnEZLZdEL54ASqOrPnt3YfAE,454
 mirascope/llm/providers/openai/model_id.py,sha256=XDQxd2BgG_YIGwzyTRNaySRXoU80-q0AR-xOdtvpB8I,1009
-mirascope/llm/providers/openai/model_info.py,sha256=capCjAHglWgK8ge8YBdDfJnf8FuEnGBROhL0iB6-v1M,7903
-mirascope/llm/providers/openai/provider.py,sha256=Cz-bU71n6E4jU2hQ9lMqPJ-WYkr6ZRabgLGrPOYk-Do,14303
-mirascope/llm/providers/openai/completions/__init__.py,sha256=mr61sdQdbwyy1IKY4LISv3gi8jTfDsx8dXOcCVIsyh4,515
-mirascope/llm/providers/openai/completions/provider.py,sha256=J-Ts_bY7p6EzgbLhBbYCsVEl-gRP0pfPvDdYV1jZjV8,16008
+mirascope/llm/providers/openai/model_info.py,sha256=DN-y-qzq2UahK11hJUe12SB1upRD6BWZkTLhEX092sY,9563
+mirascope/llm/providers/openai/provider.py,sha256=ius7GUMcrEyaEDltZAsp1JFaYJRhlV2EbKkbybxi7Fw,15223
+mirascope/llm/providers/openai/_utils/__init__.py,sha256=jzAtRZEqvbHnJw8iEillZU4tWXedmtTWuE_PqyYUVvM,101
+mirascope/llm/providers/openai/_utils/errors.py,sha256=28O7FW6qH203gShYOh5b1_7GimuESCzIdT32AF86nuQ,1624
+mirascope/llm/providers/openai/completions/__init__.py,sha256=5X2lzkbta0JNh9KQR3Sb1C4VnQ0LcmMxOeH_pYtsB-o,766
+mirascope/llm/providers/openai/completions/base_provider.py,sha256=w10W-lK1XAWktlOs0GM8tqeTOUuE4wXomcH3uTn1OX8,18014
+mirascope/llm/providers/openai/completions/provider.py,sha256=jEH-9rMmNLEBDWVaOZj0rMuRtjwQxdK917tODk-C6pE,719
 mirascope/llm/providers/openai/completions/_utils/__init__.py,sha256=j6brTqACyRS71pkZIcL-LxneE5ALhaHkCtUnBUS0448,266
-mirascope/llm/providers/openai/completions/_utils/decode.py,sha256=8SSgLOFIXuCd_8G3QLIl50nM1hKYb8n13cnvgkAW54I,6646
-mirascope/llm/providers/openai/completions/_utils/encode.py,sha256=97J-8sWSsd3g45Zyiyb0b_lnKX3t9cgw9dRPLAJrf8o,13685
+mirascope/llm/providers/openai/completions/_utils/decode.py,sha256=4yoS_wNK57RAxfjOL7kimSD5mYh_2IK5XDpAwspsoOg,8250
+mirascope/llm/providers/openai/completions/_utils/encode.py,sha256=ZESiZJliHK-DA4DCH-oLtQij288QcR_LkdRs37Lsyrg,13680
 mirascope/llm/providers/openai/responses/__init__.py,sha256=Mo45QmWX111jc0Ws24LrJg3w2gVoFgVGDcby0_iSOLk,506
-mirascope/llm/providers/openai/responses/provider.py,sha256=5bSlMLb4glLwGJtVWlPRe3DLtcpy6vHX-SEl13VNyvs,16344
+mirascope/llm/providers/openai/responses/provider.py,sha256=vjwJ7weexDmeYbiQCql2yNmLnLejGJoGODd-WDSNkBo,16630
 mirascope/llm/providers/openai/responses/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
-mirascope/llm/providers/openai/responses/_utils/decode.py,sha256=yTVh8Bqhd1kdn9DK-YDf1Z3pszrAeIuPmPCTHvUgguI,7692
-mirascope/llm/providers/openai/responses/_utils/encode.py,sha256=WI1tlcehyEM5aYwD7-hLTc4DQ-mn_b5rpSitSu5-QNs,12814
-mirascope/llm/providers/openai/shared/__init__.py,sha256=x4koHwL1YsrZ-vzJ-RZks9xEVUUwGuMmthxRXlmQUqc,104
-mirascope/llm/providers/openai/shared/_utils.py,sha256=RbDDbzwgMcTzib1TjhWOcBGUxzQlLxCQiQ-ZozmLTFY,1781
-mirascope/llm/responses/__init__.py,sha256=bWEY1_AkJxBTtq3ML3cJM2arU1XOoDFCv2QvukFz73c,1308
+mirascope/llm/providers/openai/responses/_utils/decode.py,sha256=Ua3ZVwqRiLxwDhycjnq6BLsPkIjNxmzTeZmMT2Z6MKc,9368
+mirascope/llm/providers/openai/responses/_utils/encode.py,sha256=RLxP9rFXuXqoFnbwt6jG1AgqJyYbLdrcxa1RzTXsteI,12797
+mirascope/llm/providers/together/__init__.py,sha256=mtWAGrQUPHNhmkGKCiLirst6PsCUCS5oK2bZsEf9s3Q,453
+mirascope/llm/providers/together/provider.py,sha256=LauQR6kdxFNkO8CqaJIbiyn2TxI6mO3z5GhnZbHxQa0,1295
+mirascope/llm/responses/__init__.py,sha256=sYr6Sm9G0pxbZoev-RVgz3o3FKHeAU3wa_G5NXjmdnw,1386
 mirascope/llm/responses/_utils.py,sha256=JkKXzG6-WqAbbmWLKOmbe7gDpp9xwg7xNHXryFbt6ME,1662
-mirascope/llm/responses/base_response.py,sha256=rzhkhhl4T4wDJnqPupvXd_b5hkvETFpgPe2dlel5wXY,4029
-mirascope/llm/responses/base_stream_response.py,sha256=qJ-5KRF5tvNeXSzOK3CElPP8m62q4vh27Fg0qSb1QB4,28110
-mirascope/llm/responses/finish_reason.py,sha256=1iSVaTZP8zlTwc9Pr4r10AzGkMz0iy0om8vKsHJ0OUY,742
-mirascope/llm/responses/response.py,sha256=mHAwk13Au6PXUY3ZbwYyp-YfvAM62qGJkLlnMMyyAKA,12253
-mirascope/llm/responses/root_response.py,sha256=8lldXCaMU2-Xq8s6k8e3w-AobzcDYRdQR8I-7l-Uv3o,6173
+mirascope/llm/responses/base_response.py,sha256=5yjVtn3SH09hdp--B3ioT2gkmB3LpqgkBEAKuopOKBc,4170
+mirascope/llm/responses/base_stream_response.py,sha256=xM0O94dE3h1ll_CYdwszf4gS-clMwX6k9jHEP1MEnqQ,29257
+mirascope/llm/responses/finish_reason.py,sha256=Az5OY6pfZoOPEpzVnl07AqZPz5ZC-w4YKwpUPbFJGdM,798
+mirascope/llm/responses/response.py,sha256=zbMWIOwYQq7Z0JgdfRpm4Qzy5Yb7Suty_vmf1kZuenE,12494
+mirascope/llm/responses/root_response.py,sha256=lgfSwlhy5S-X4FDX70vt-uT6BOLfaTTaGIFbLkdWE94,6285
 mirascope/llm/responses/stream_response.py,sha256=ut85tOLGbGI3abheHKf55qEndLsRmddo1sEMQk7PtNo,24142
 mirascope/llm/responses/streams.py,sha256=TmEFvLVEWHfVYplik61yUWisxe8JGbaZdh7yC7e-axI,10789
+mirascope/llm/responses/usage.py,sha256=mm4f9EDBzR57bqPTG2B0iqYnwbyog7csHqo0zjnwWVM,2984
 mirascope/llm/tools/__init__.py,sha256=P9NX6pP5fKScTAuR9K3fODdW17wQ-6fcArVx2klGies,961
 mirascope/llm/tools/_utils.py,sha256=mUi6vUEwYuwu8W9FCQcQ_9h_VE_U-Y3Y2UQ2YptPZL4,1171
 mirascope/llm/tools/decorator.py,sha256=1K-67dJkjCOS1rHAM91lOT8XfShTw54QA-TMEok5eH0,5326
@@ -171,7 +230,7 @@ mirascope/llm/types/type_vars.py,sha256=OsAcQAZh5T_X8ZTLlP4GC1x3qgVY9rfYSnME8aMT
 mirascope/ops/__init__.py,sha256=ryfU8Zn_PRELldrExsjz89eN_Qmk9FoDipaDsgf5CaY,5545
 mirascope/ops/exceptions.py,sha256=N5AES285tTxFJ1THIeJht-_ZEQ7-7_FWoes4EBAu3B8,641
 mirascope/ops/_internal/__init__.py,sha256=yCf8bnHiQFWYsBkwBPyMqknI5apmOwlmyf105mH9EAE,173
-mirascope/ops/_internal/closure.py,sha256=MM2RSGYTV8YH9SUt8itqDCnxpUUeL0Pq3BLDr08Zrbw,40392
+mirascope/ops/_internal/closure.py,sha256=lPkZLfL33OZ3yxdZhT3RXqhD0ychKWH0zevU4V-VHCY,42465
 mirascope/ops/_internal/configuration.py,sha256=G_DnUfrAtuPb0-fQQpPts0yFCLdeYW-RqS2Td61pqjg,3616
 mirascope/ops/_internal/context.py,sha256=G0Jiv6XfWjeDyRrh5-Wg6I0UlqiDj17SNMhtQ6Rw3lM,2522
 mirascope/ops/_internal/propagation.py,sha256=2in7uttv2b5MBoe3Ol1mgn6N20TqhH0sErGak7hMUDY,7032
@@ -200,7 +259,7 @@ mirascope/ops/_internal/instrumentation/llm/gen_ai_types/gen_ai_input_messages.p
 mirascope/ops/_internal/instrumentation/llm/gen_ai_types/gen_ai_output_messages.py,sha256=qxLxSmwd_2EdymR4a5cDXc9DTSFGQXMhqSHGgS219Y4,957
 mirascope/ops/_internal/instrumentation/llm/gen_ai_types/gen_ai_system_instructions.py,sha256=ZkWNOh6-tG6LtFP_0Hjfdf_8BqAsIFyP3tNybeo1FnY,388
 mirascope/ops/_internal/instrumentation/llm/gen_ai_types/shared.py,sha256=JpmcF1i25EHc8KMv6nkpBwyIU46B_T8v1L71C16n080,3004
-mirascope-2.0.0a3.dist-info/METADATA,sha256=zmSqj2dnZv3sQRC130xwlFvNvYA-i28_ogisQbzT9Q0,8932
-mirascope-2.0.0a3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mirascope-2.0.0a3.dist-info/licenses/LICENSE,sha256=LAs5Q8mdawTsVdONpDGukwsoc4KEUBmmonDEL39b23Y,1072
-mirascope-2.0.0a3.dist-info/RECORD,,
+mirascope-2.0.0a5.dist-info/METADATA,sha256=gJnq3JtQUzxjBKEYf1pOdZ2MQW29xMhqmqBVIMgEQEs,8932
+mirascope-2.0.0a5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mirascope-2.0.0a5.dist-info/licenses/LICENSE,sha256=LAs5Q8mdawTsVdONpDGukwsoc4KEUBmmonDEL39b23Y,1072
+mirascope-2.0.0a5.dist-info/RECORD,,

mirascope/llm/providers/load_provider.py

@@ -1,48 +0,0 @@
-from functools import lru_cache
-
-from .anthropic import AnthropicProvider
-from .base import Provider
-from .google import GoogleProvider
-from .mlx import MLXProvider
-from .openai import OpenAIProvider
-from .openai.completions.provider import OpenAICompletionsProvider
-from .openai.responses.provider import OpenAIResponsesProvider
-from .provider_id import ProviderId
-
-
-@lru_cache(maxsize=256)
-def load_provider(
-    provider_id: ProviderId, *, api_key: str | None = None, base_url: str | None = None
-) -> Provider:
-    """Create a cached provider instance for the specified provider id.
-
-    Args:
-        provider_id: The provider name ("openai", "anthropic", or "google").
-        api_key: API key for authentication. If None, uses provider-specific env var.
-        base_url: Base URL for the API. If None, uses provider-specific env var.
-
-    Returns:
-        A cached provider instance for the specified provider with the given parameters.
-
-    Raises:
-        ValueError: If the provider_id is not supported.
-    """
-    match provider_id:
-        case "anthropic":
-            return AnthropicProvider(api_key=api_key, base_url=base_url)
-        case "google":
-            return GoogleProvider(api_key=api_key, base_url=base_url)
-        case "openai":
-            return OpenAIProvider(api_key=api_key, base_url=base_url)
-        case "openai:completions":
-            return OpenAICompletionsProvider(api_key=api_key, base_url=base_url)
-        case "openai:responses":
-            return OpenAIResponsesProvider(api_key=api_key, base_url=base_url)
-        case "mlx":  # pragma: no cover (MLX is only available on macOS)
-            return MLXProvider()
-        case _:  # pragma: no cover
-            raise ValueError(f"Unknown provider: '{provider_id}'")
-
-
-load = load_provider
-"""Convenient alias as `llm.providers.load`"""

mirascope/llm/providers/openai/shared/__init__.py

@@ -1,7 +0,0 @@
-"""Shared types and utils for all OpenAI clients."""
-
-from . import _utils
-
-__all__ = [
-    "_utils",
-]