mirascope 2.0.0a0__py3-none-any.whl → 2.0.0a2__py3-none-any.whl

mirascope/llm/__init__.py

@@ -8,13 +8,14 @@ code that works with multiple LLM providers without changing your application lo
 # TODO: Across the API, audit docstrings to ensure they are compliant Google-style docstrings
 # (Write some tooling to ensure this happens consistently + in CI)
 
+from contextlib import suppress
+
 from . import (
     calls,
     clients,
     content,
     exceptions,
     formatting,
-    mcp,
     messages,
     models,
     prompts,
@@ -22,6 +23,9 @@ from . import (
     tools,
     types,
 )
+
+with suppress(ImportError):
+    from . import mcp
 from .calls import call
 from .clients import ModelId, Params, Provider, client, get_client
 from .content import (

mirascope/llm/clients/_missing_import_stubs.py

@@ -0,0 +1,47 @@
+"""Utilities for handling optional provider dependencies."""
+
+from collections.abc import Callable
+
+
+def create_import_error_stub(
+    package_name: str, client_name: str
+) -> Callable:  # pragma: no cover
+    """Create a stub that raises ImportError when called.
+
+    Args:
+        package_name: The package/extra name (e.g., "anthropic", "openai", "google")
+        client_name: The client name for the error message (e.g., "AnthropicClient")
+
+    Returns:
+        A callable that raises `ImportError` with helpful message.
+    """
+
+    def _raise_not_installed() -> None:
+        raise ImportError(
+            f"The '{package_name}' package is required to use {client_name}. "
+            f"Install it with: `uv add 'mirascope[{package_name}]'`. "
+            "Or use `uv add 'mirascope[all]'` to support all providers."
+        )
+
+    return _raise_not_installed
+
+
+def create_client_stub(package_name: str, client_name: str) -> type:  # pragma: no cover
+    """Create a stub client class that raises ImportError when instantiated.
+
+    Args:
+        package_name: The package/extra name (e.g., "anthropic", "openai", "google")
+        client_name: The client name for the error message (e.g., "AnthropicClient")
+
+    Returns:
+        A stub class that raises `ImportError` on instantiation.
+    """
+    error_fn = create_import_error_stub(package_name, client_name)
+
+    class _ClientStub:
+        """Stub client that raises `ImportError` when instantiated."""
+
+        def __init__(self) -> None:
+            error_fn()
+
+    return _ClientStub

mirascope/llm/clients/anthropic/__init__.py

@@ -1,7 +1,21 @@
 """Anthropic client implementation."""
 
-from .clients import AnthropicClient, client, get_client
-from .model_ids import AnthropicModelId
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from .clients import AnthropicClient, client, get_client
+    from .model_ids import AnthropicModelId
+else:
+    try:
+        from .clients import AnthropicClient, client, get_client
+        from .model_ids import AnthropicModelId
+    except ImportError:  # pragma: no cover
+        from .._missing_import_stubs import create_client_stub, create_import_error_stub
+
+        AnthropicClient = create_client_stub("anthropic", "AnthropicClient")
+        AnthropicModelId = str
+        client = create_import_error_stub("anthropic", "AnthropicClient")
+        get_client = create_import_error_stub("anthropic", "AnthropicClient")
 
 __all__ = [
     "AnthropicClient",

mirascope/llm/clients/google/__init__.py

@@ -1,6 +1,20 @@
 """Google client implementation."""
 
-from .clients import GoogleClient, client, get_client
-from .model_ids import GoogleModelId
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .clients import GoogleClient, client, get_client
+    from .model_ids import GoogleModelId
+else:
+    try:
+        from .clients import GoogleClient, client, get_client
+        from .model_ids import GoogleModelId
+    except ImportError:  # pragma: no cover
+        from .._missing_import_stubs import create_client_stub, create_import_error_stub
+
+        GoogleClient = create_client_stub("google", "GoogleClient")
+        GoogleModelId = str
+        client = create_import_error_stub("google", "GoogleClient")
+        get_client = create_import_error_stub("google", "GoogleClient")
 
 __all__ = ["GoogleClient", "GoogleModelId", "client", "get_client"]

mirascope/llm/clients/openai/completions/__init__.py

@@ -1,5 +1,24 @@
-from .clients import OpenAICompletionsClient, client, get_client
-from .model_ids import OpenAICompletionsModelId
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .clients import OpenAICompletionsClient, client, get_client
+    from .model_ids import OpenAICompletionsModelId
+else:
+    try:
+        from .clients import OpenAICompletionsClient, client, get_client
+        from .model_ids import OpenAICompletionsModelId
+    except ImportError:  # pragma: no cover
+        from ..._missing_import_stubs import (
+            create_client_stub,
+            create_import_error_stub,
+        )
+
+        OpenAICompletionsClient = create_client_stub(
+            "openai", "OpenAICompletionsClient"
+        )
+        OpenAICompletionsModelId = str
+        client = create_import_error_stub("openai", "OpenAICompletionsClient")
+        get_client = create_import_error_stub("openai", "OpenAICompletionsClient")
 
 __all__ = [
     "OpenAICompletionsClient",

mirascope/llm/clients/openai/responses/__init__.py

@@ -1,5 +1,22 @@
-from .clients import OpenAIResponsesClient, client, get_client
-from .model_ids import OpenAIResponsesModelId
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .clients import OpenAIResponsesClient, client, get_client
+    from .model_ids import OpenAIResponsesModelId
+else:
+    try:
+        from .clients import OpenAIResponsesClient, client, get_client
+        from .model_ids import OpenAIResponsesModelId
+    except ImportError:  # pragma: no cover
+        from ..._missing_import_stubs import (
+            create_client_stub,
+            create_import_error_stub,
+        )
+
+        OpenAIResponsesClient = create_client_stub("openai", "OpenAIResponsesClient")
+        OpenAIResponsesModelId = str
+        client = create_import_error_stub("openai", "OpenAIResponsesClient")
+        get_client = create_import_error_stub("openai", "OpenAIResponsesClient")
 
 __all__ = [
     "OpenAIResponsesClient",

mirascope/llm/tools/decorator.py

@@ -20,14 +20,14 @@ class ToolDecorator:
     @overload
     def __call__(  # pyright:ignore[reportOverlappingOverload]
         self, fn: ContextToolFn[DepsT, P, JsonableCovariantT]
-    ) -> ContextTool[DepsT, P, JsonableCovariantT]:
+    ) -> ContextTool[DepsT, JsonableCovariantT, P]:
         """Call the decorator with a context function."""
         ...
 
     @overload
     def __call__(  # pyright:ignore[reportOverlappingOverload]
         self, fn: AsyncContextToolFn[DepsT, P, JsonableCovariantT]
-    ) -> AsyncContextTool[DepsT, P, JsonableCovariantT]:
+    ) -> AsyncContextTool[DepsT, JsonableCovariantT, P]:
         """Call the decorator with an async context function."""
         ...
 
@@ -52,8 +52,8 @@ class ToolDecorator:
         | ToolFn[P, JsonableCovariantT]
         | AsyncToolFn[P, JsonableCovariantT],
     ) -> (
-        ContextTool[DepsT, P, JsonableCovariantT]
-        | AsyncContextTool[DepsT, P, JsonableCovariantT]
+        ContextTool[DepsT, JsonableCovariantT, P]
+        | AsyncContextTool[DepsT, JsonableCovariantT, P]
         | Tool[P, JsonableCovariantT]
         | AsyncTool[P, JsonableCovariantT]
     ):
@@ -62,11 +62,11 @@ class ToolDecorator:
         is_async = _tool_utils.is_async_tool_fn(fn)
 
         if is_context and is_async:
-            return AsyncContextTool[DepsT, P, JsonableCovariantT](
+            return AsyncContextTool[DepsT, JsonableCovariantT, P](
                 fn, strict=self.strict
             )
         elif is_context:
-            return ContextTool[DepsT, P, JsonableCovariantT](fn, strict=self.strict)
+            return ContextTool[DepsT, JsonableCovariantT, P](fn, strict=self.strict)
         elif is_async:
             return AsyncTool[P, JsonableCovariantT](fn, strict=self.strict)
         else:
@@ -76,7 +76,7 @@ class ToolDecorator:
 @overload
 def tool(  # pyright:ignore[reportOverlappingOverload]
     __fn: AsyncContextToolFn[DepsT, P, JsonableCovariantT],
-) -> AsyncContextTool[DepsT, P, JsonableCovariantT]:
+) -> AsyncContextTool[DepsT, JsonableCovariantT, P]:
     """Overload for async context tool functions."""
     ...
 
@@ -84,7 +84,7 @@ def tool(  # pyright:ignore[reportOverlappingOverload]
 @overload
 def tool(  # pyright:ignore[reportOverlappingOverload]
     __fn: ContextToolFn[DepsT, P, JsonableCovariantT],
-) -> ContextTool[DepsT, P, JsonableCovariantT]:
+) -> ContextTool[DepsT, JsonableCovariantT, P]:
     """Overload for context tool functions."""
     ...
 
@@ -116,8 +116,8 @@ def tool(
     *,
     strict: bool = False,
 ) -> (
-    ContextTool[DepsT, P, JsonableCovariantT]
-    | AsyncContextTool[DepsT, P, JsonableCovariantT]
+    ContextTool[DepsT, JsonableCovariantT, P]
+    | AsyncContextTool[DepsT, JsonableCovariantT, P]
     | Tool[P, JsonableCovariantT]
     | AsyncTool[P, JsonableCovariantT]
     | ToolDecorator

mirascope/llm/tools/tools.py

@@ -89,7 +89,7 @@ class AsyncTool(
 
 class ContextTool(
     ToolSchema[ContextToolFn[DepsT, AnyP, JsonableCovariantT]],
-    Generic[DepsT, AnyP, JsonableCovariantT],
+    Generic[DepsT, JsonableCovariantT, AnyP],
 ):
     """Protocol defining a tool that can be used by LLMs.
 
@@ -130,7 +130,7 @@ class ContextTool(
 
 class AsyncContextTool(
     ToolSchema[AsyncContextToolFn[DepsT, AnyP, JsonableCovariantT]],
-    Generic[DepsT, AnyP, JsonableCovariantT],
+    Generic[DepsT, JsonableCovariantT, AnyP],
 ):
     """Protocol defining an async tool that can be used by LLMs with context.
 

{mirascope-2.0.0a0.dist-info → mirascope-2.0.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mirascope
-Version: 2.0.0a0
+Version: 2.0.0a2
 Summary: LLM abstractions that aren't obstructions
 Project-URL: Homepage, https://mirascope.com
 Project-URL: Documentation, https://mirascope.com/docs/mirascope/v2
@@ -40,13 +40,23 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: File Formats :: JSON
 Classifier: Topic :: File Formats :: JSON :: JSON Schema
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.10
 Requires-Dist: docstring-parser>=0.17.0
+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: google-genai<2,>=1.48.0; extra == 'all'
+Requires-Dist: mcp<2,>=1.0.0; extra == 'all'
+Requires-Dist: openai<3,>=2.7.1; extra == 'all'
+Requires-Dist: pillow<11,>=10.4.0; extra == 'all'
+Requires-Dist: proto-plus>=1.24.0; extra == 'all'
 Provides-Extra: anthropic
 Requires-Dist: anthropic<1.0,>=0.72.0; extra == 'anthropic'
 Provides-Extra: google

{mirascope-2.0.0a0.dist-info → mirascope-2.0.0a2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 mirascope/__init__.py,sha256=wKvhFqB-FAf_Fxi1_pEenLRUK-QGMbhlsY5aPGc0lug,98
 mirascope/graphs/__init__.py,sha256=fkZHjSt6DvJAX-V3OCnDO7B1zJx5gv1Qp2G6P32wI7I,1086
 mirascope/graphs/finite_state_machine.py,sha256=9j8kwQ6Ne3o-auP0KVdoA0hzW2txfM1wH3GSSnbZOyg,23261
-mirascope/llm/__init__.py,sha256=qHerzIANTngmc1aXg_ga9S7dEY7rRj83e5Z61ObAdN4,4420
+mirascope/llm/__init__.py,sha256=rB8y7UB95NjsizaDGEAzgNstV9fFlt89HJ0SjyAGLg4,4495
 mirascope/llm/exceptions.py,sha256=30yPPCIr8Uwibqpt2Y0cDMsimVlQubAmjqbeO5kVpSA,3090
 mirascope/llm/agents/__init__.py,sha256=aG5ymnBfa4ZFLfGPZjdXybwjC3lrlkkeLjKfx2Zzr0Q,363
 mirascope/llm/agents/agent.py,sha256=obACeIZuD8FIUaZL_NF0u5GNeaxRpbyNb9PNipyYIZE,2959
@@ -12,8 +12,9 @@ mirascope/llm/calls/base_call.py,sha256=ghD8__Uw-RpL-TWI1zShThWugXmZCiEA2tLsZ-XH
 mirascope/llm/calls/calls.py,sha256=R2hEGVsOHkZlBKcp4CvfssXABoLiIj9aKu80qrx6Ta4,9867
 mirascope/llm/calls/decorator.py,sha256=77JLc1xIotl7dWxzyz5xYeKIRu8ykMxZ40yj9MNd79c,7472
 mirascope/llm/clients/__init__.py,sha256=L00p7Kfk1gu8hSLXz3dvn3y0ku0rG6vPxq2vxRoukJI,770
+mirascope/llm/clients/_missing_import_stubs.py,sha256=KKTd_CVhUOZLTm8Slt2U-C94VN5N8mm2x89rKhmzdoI,1550
 mirascope/llm/clients/providers.py,sha256=GwZldKYXGaTPbkbAbGlCYyl2-CuR1dnz4smZGblyfqc,5095
-mirascope/llm/clients/anthropic/__init__.py,sha256=wSYwKLkASUQHEsIjvuMSQHIZ6mhdyOymmzb3clL8SlU,231
+mirascope/llm/clients/anthropic/__init__.py,sha256=9V6UiDGuSXRJgkrbOHP9KW7KFHVb4Z_CMON2n8h-U6M,818
 mirascope/llm/clients/anthropic/clients.py,sha256=8Z1Ol8V-JwCxefT2mQYUrfduliES2Yvk88hyM4GCNvc,27460
 mirascope/llm/clients/anthropic/model_ids.py,sha256=0vp-nhDCYMw_3sKFD_tQO2FRlW8QzKiwXKBQ_lEv0yo,197
 mirascope/llm/clients/anthropic/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
@@ -24,7 +25,7 @@ mirascope/llm/clients/base/_utils.py,sha256=JyVXkbsHgOD_CnCNkq-aVdSmD4me0M40NPsd
 mirascope/llm/clients/base/client.py,sha256=ffgxwMJ2vmbUB-KKzPwpgumzmGT2IhIr1yGqxYt9oBk,42258
 mirascope/llm/clients/base/kwargs.py,sha256=pjaHVqtlmScUBqG8ZAllVaLoepdKE-KYl2eTqzOBXm0,406
 mirascope/llm/clients/base/params.py,sha256=x2WLz0s5rMZ3u3GBGQmRlYGjecePtsLglHSJBLh35YE,3670
-mirascope/llm/clients/google/__init__.py,sha256=nrUGqVqbUmhi1Y3MNfbmp5ItooNHEV2D3cUNhyeRH_U,197
+mirascope/llm/clients/google/__init__.py,sha256=Wsf-AfbFJ5kD-encD776uhjcINJV30NaDKhXpV_GZ-U,749
 mirascope/llm/clients/google/clients.py,sha256=rsWJV5kfwh93RSRE6x45wnBhnP122mLCCuOdy1cD2u4,28073
 mirascope/llm/clients/google/message.py,sha256=ryNsMKPSyBSVXl_H0MQEaSiWC3FFybjxIUuORNSiKTk,179
 mirascope/llm/clients/google/model_ids.py,sha256=zJe9IAX4DIO6JXeTksAx77nwtlz1k2aO0YcJHsNpRx4,338
@@ -32,14 +33,14 @@ mirascope/llm/clients/google/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp
 mirascope/llm/clients/google/_utils/decode.py,sha256=z__aZLIL130nCVV5CdAJPTiaCSw61mCrItTHVDffkQQ,9007
 mirascope/llm/clients/google/_utils/encode.py,sha256=XFaRCzMQlUW3sm949pc-rPTavDgxSIjrxOllJ8KgR3k,10482
 mirascope/llm/clients/openai/__init__.py,sha256=LkD4Kkxc-dnpR_K5f539xSfqEaXE1vioDcW7suOJhJE,600
-mirascope/llm/clients/openai/completions/__init__.py,sha256=mdDQfZ0WI0tOH4OUrbnNBIe1kyqdj3y0r4q3LIwr4Os,223
+mirascope/llm/clients/openai/completions/__init__.py,sha256=KUymq4dY6LiOdTLCMctmi2n9DiwGbfL_7K2Ha-AjnIE,912
 mirascope/llm/clients/openai/completions/clients.py,sha256=GjfNV1ewRi1ADgsP0t5cxPdQUWyN65gRSPzDJFMhApg,28086
 mirascope/llm/clients/openai/completions/model_ids.py,sha256=bno8SND8YbzoQE3Tjh9dxYo04luDILD3ndzQvgL5pAg,243
 mirascope/llm/clients/openai/completions/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
 mirascope/llm/clients/openai/completions/_utils/decode.py,sha256=yiXPQwL33YNVxIZAABohqSO3ElEtiShVSki8fPQWf0A,6539
 mirascope/llm/clients/openai/completions/_utils/encode.py,sha256=q2jP8By9TUiv66-oJpWZddn709ZRIGkXniSPTxLR2Co,13227
 mirascope/llm/clients/openai/completions/_utils/model_features.py,sha256=iIm0uxNNfYOJ4qn1wmZjNrkCXNJK5czOPmn5UVBIjz4,3397
-mirascope/llm/clients/openai/responses/__init__.py,sha256=PofDWzyxz__hD1AaHn2hQkIPs7xxyiBcgDoCl39Tlq4,215
+mirascope/llm/clients/openai/responses/__init__.py,sha256=qecYX7X20HJ_n2Elmo2SkF5SuxkuLmpJjUhe0M2ual8,868
 mirascope/llm/clients/openai/responses/clients.py,sha256=dMIdp-Ua_stFAtT99gDp89woUyLyWShO4aAz8G_2nog,27627
 mirascope/llm/clients/openai/responses/model_ids.py,sha256=30OQ8wnIVp6A3I4NsTPBLqfi-SB5dhzyB7ic5p_XXhg,239
 mirascope/llm/clients/openai/responses/_utils/__init__.py,sha256=U2VNfEJCaqorAJBZDV7p3rFEp1fyk7vSitYFv_5G5Cs,232
@@ -86,16 +87,16 @@ mirascope/llm/responses/stream_response.py,sha256=g8hGoKL94intm5w5mOpAh2QAH1eiCb
 mirascope/llm/responses/streams.py,sha256=TmEFvLVEWHfVYplik61yUWisxe8JGbaZdh7yC7e-axI,10789
 mirascope/llm/tools/__init__.py,sha256=3xIhEzpLlTkuDuvkfwVy3gLPRTTJCJH5GKkqCGjgo3A,772
 mirascope/llm/tools/_utils.py,sha256=bBVsZs8SywWspVGBGR7GGuhSmGa5-wCzeXGV6Woof9Q,872
-mirascope/llm/tools/decorator.py,sha256=kZ90qrE7jZHcW5fg3O-SOh6xiI6yjT4fz548e4AxvQc,5326
+mirascope/llm/tools/decorator.py,sha256=1K-67dJkjCOS1rHAM91lOT8XfShTw54QA-TMEok5eH0,5326
 mirascope/llm/tools/protocols.py,sha256=VubSZm-N2QEnBzFTsnj4pRtIgJOx2GQWM4IyqZjDk1Q,3054
 mirascope/llm/tools/tool_schema.py,sha256=vFGVNOa8ZrE6gnwelBcPKYK7-0ULqVtlr1oXZsbVxKY,8358
 mirascope/llm/tools/toolkit.py,sha256=pGXchFSO2H7PxFM2sPQYEMDAYHNaX9bhGEyyou_4vsg,4900
-mirascope/llm/tools/tools.py,sha256=AEgTEZoRTxictYxPDxdX18_Ho2sD8SIa-LUTngNHPiM,5972
+mirascope/llm/tools/tools.py,sha256=7RD69pdEjZVjQz8VpegOmixz09Wq2CXotcyI34hA7cQ,5972
 mirascope/llm/types/__init__.py,sha256=lqzi1FkZ-s-D9-KQzVkAHuQQ1zp6B6yM3r9UNo46teE,357
 mirascope/llm/types/dataclass.py,sha256=y4_9M3Yqw_4I-H0V4TwvgGIp6JvRdtpW11NxqufnsJk,247
 mirascope/llm/types/jsonable.py,sha256=KY6l21_RBhlHQRXQ_xy6pUqqbTVb_jVFSU4ykRy_OLU,1104
 mirascope/llm/types/type_vars.py,sha256=OsAcQAZh5T_X8ZTLlP4GC1x3qgVY9rfYSnME8aMTDxw,642
-mirascope-2.0.0a0.dist-info/METADATA,sha256=FySDVeLpjaHcLhgRrb12tjVMSLxojbv7AFcnJObI0XU,5035
-mirascope-2.0.0a0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mirascope-2.0.0a0.dist-info/licenses/LICENSE,sha256=LAs5Q8mdawTsVdONpDGukwsoc4KEUBmmonDEL39b23Y,1072
-mirascope-2.0.0a0.dist-info/RECORD,,
+mirascope-2.0.0a2.dist-info/METADATA,sha256=GKHQgnkZlGO2uYH2GvKT4e9ReNf0QuptJXe4GVJIz_o,5468
+mirascope-2.0.0a2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mirascope-2.0.0a2.dist-info/licenses/LICENSE,sha256=LAs5Q8mdawTsVdONpDGukwsoc4KEUBmmonDEL39b23Y,1072
+mirascope-2.0.0a2.dist-info/RECORD,,