mirascope 2.0.0a5__py3-none-any.whl → 2.0.1__py3-none-any.whl

mirascope/api/_generated/traces/types/traces_search_response_spans_item.py

@@ -0,0 +1,50 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ...core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ...core.serialization import FieldMetadata
+
+
+class TracesSearchResponseSpansItem(UniversalBaseModel):
+    trace_id: typing_extensions.Annotated[str, FieldMetadata(alias="traceId")]
+    span_id: typing_extensions.Annotated[str, FieldMetadata(alias="spanId")]
+    name: str
+    start_time: typing_extensions.Annotated[str, FieldMetadata(alias="startTime")]
+    duration_ms: typing_extensions.Annotated[
+        typing.Optional[float], FieldMetadata(alias="durationMs")
+    ] = None
+    model: typing.Optional[str] = None
+    provider: typing.Optional[str] = None
+    input_tokens: typing_extensions.Annotated[
+        typing.Optional[float], FieldMetadata(alias="inputTokens")
+    ] = None
+    output_tokens: typing_extensions.Annotated[
+        typing.Optional[float], FieldMetadata(alias="outputTokens")
+    ] = None
+    total_tokens: typing_extensions.Annotated[
+        typing.Optional[float], FieldMetadata(alias="totalTokens")
+    ] = None
+    cost_usd: typing_extensions.Annotated[
+        typing.Optional[float], FieldMetadata(alias="costUsd")
+    ] = None
+    function_id: typing_extensions.Annotated[
+        typing.Optional[str], FieldMetadata(alias="functionId")
+    ] = None
+    function_name: typing_extensions.Annotated[
+        typing.Optional[str], FieldMetadata(alias="functionName")
+    ] = None
+    has_children: typing_extensions.Annotated[bool, FieldMetadata(alias="hasChildren")]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/__init__.py

@@ -4,34 +4,82 @@
 
 from .already_exists_error import AlreadyExistsError
 from .already_exists_error_tag import AlreadyExistsErrorTag
+from .bad_request_error_body import (
+    BadRequestErrorBody,
+    BadRequestErrorBody_HttpApiDecodeError,
+    BadRequestErrorBody_ImmutableResourceError,
+)
+from .click_house_error import ClickHouseError
 from .database_error import DatabaseError
 from .database_error_tag import DatabaseErrorTag
+from .date import Date
 from .http_api_decode_error import HttpApiDecodeError
 from .http_api_decode_error_tag import HttpApiDecodeErrorTag
+from .immutable_resource_error import ImmutableResourceError
+from .internal_server_error_body import (
+    InternalServerErrorBody,
+    InternalServerErrorBody_ClickHouseError,
+    InternalServerErrorBody_DatabaseError,
+)
 from .issue import Issue
 from .issue_tag import IssueTag
 from .not_found_error_body import NotFoundErrorBody
 from .not_found_error_tag import NotFoundErrorTag
+from .number_from_string import NumberFromString
 from .permission_denied_error import PermissionDeniedError
 from .permission_denied_error_tag import PermissionDeniedErrorTag
+from .plan_limit_exceeded_error import PlanLimitExceededError
+from .plan_limit_exceeded_error_tag import PlanLimitExceededErrorTag
+from .pricing_unavailable_error import PricingUnavailableError
 from .property_key import PropertyKey
 from .property_key_key import PropertyKeyKey
 from .property_key_key_tag import PropertyKeyKeyTag
+from .rate_limit_error import RateLimitError
+from .rate_limit_error_tag import RateLimitErrorTag
+from .service_unavailable_error_body import ServiceUnavailableErrorBody
+from .service_unavailable_error_tag import ServiceUnavailableErrorTag
+from .stripe_error import StripeError
+from .subscription_past_due_error import SubscriptionPastDueError
+from .subscription_past_due_error_tag import SubscriptionPastDueErrorTag
+from .unauthorized_error_body import UnauthorizedErrorBody
+from .unauthorized_error_tag import UnauthorizedErrorTag
 
 __all__ = [
     "AlreadyExistsError",
     "AlreadyExistsErrorTag",
+    "BadRequestErrorBody",
+    "BadRequestErrorBody_HttpApiDecodeError",
+    "BadRequestErrorBody_ImmutableResourceError",
+    "ClickHouseError",
     "DatabaseError",
     "DatabaseErrorTag",
+    "Date",
     "HttpApiDecodeError",
     "HttpApiDecodeErrorTag",
+    "ImmutableResourceError",
+    "InternalServerErrorBody",
+    "InternalServerErrorBody_ClickHouseError",
+    "InternalServerErrorBody_DatabaseError",
     "Issue",
     "IssueTag",
     "NotFoundErrorBody",
     "NotFoundErrorTag",
+    "NumberFromString",
     "PermissionDeniedError",
     "PermissionDeniedErrorTag",
+    "PlanLimitExceededError",
+    "PlanLimitExceededErrorTag",
+    "PricingUnavailableError",
     "PropertyKey",
     "PropertyKeyKey",
     "PropertyKeyKeyTag",
+    "RateLimitError",
+    "RateLimitErrorTag",
+    "ServiceUnavailableErrorBody",
+    "ServiceUnavailableErrorTag",
+    "StripeError",
+    "SubscriptionPastDueError",
+    "SubscriptionPastDueErrorTag",
+    "UnauthorizedErrorBody",
+    "UnauthorizedErrorTag",
 ]

mirascope/api/_generated/types/already_exists_error.py

@@ -13,9 +13,7 @@ class AlreadyExistsError(UniversalBaseModel):
     tag: AlreadyExistsErrorTag
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/bad_request_error_body.py

@@ -0,0 +1,50 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .http_api_decode_error_tag import HttpApiDecodeErrorTag
+from .issue import Issue
+
+
+class BadRequestErrorBody_HttpApiDecodeError(UniversalBaseModel):
+    tag: typing.Literal["HttpApiDecodeError"] = "HttpApiDecodeError"
+    issues: typing.List[Issue]
+    message: str
+    tag: HttpApiDecodeErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow
+
+
+class BadRequestErrorBody_ImmutableResourceError(UniversalBaseModel):
+    tag: typing.Literal["ImmutableResourceError"] = "ImmutableResourceError"
+    message: str
+    resource: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow
+
+
+BadRequestErrorBody = typing.Union[
+    BadRequestErrorBody_HttpApiDecodeError, BadRequestErrorBody_ImmutableResourceError
+]

mirascope/api/_generated/types/click_house_error.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class ClickHouseError(UniversalBaseModel):
+    message: str
+    cause: typing.Optional[typing.Optional[typing.Any]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/database_error.py

@@ -13,9 +13,7 @@ class DatabaseError(UniversalBaseModel):
     tag: DatabaseErrorTag
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/date.py

@@ -0,0 +1,3 @@
+# This file was auto-generated by Fern from our API Definition.
+
+Date = str

mirascope/api/_generated/types/http_api_decode_error.py

@@ -18,9 +18,7 @@ class HttpApiDecodeError(UniversalBaseModel):
     tag: HttpApiDecodeErrorTag
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/immutable_resource_error.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class ImmutableResourceError(UniversalBaseModel):
+    message: str
+    resource: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/internal_server_error_body.py

@@ -0,0 +1,49 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .database_error_tag import DatabaseErrorTag
+
+
+class InternalServerErrorBody_ClickHouseError(UniversalBaseModel):
+    tag: typing.Literal["ClickHouseError"] = "ClickHouseError"
+    message: str
+    cause: typing.Optional[typing.Optional[typing.Any]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow
+
+
+class InternalServerErrorBody_DatabaseError(UniversalBaseModel):
+    tag: typing.Literal["DatabaseError"] = "DatabaseError"
+    message: str
+    cause: typing.Optional[typing.Optional[typing.Any]] = None
+    tag: DatabaseErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow
+
+
+InternalServerErrorBody = typing.Union[
+    InternalServerErrorBody_ClickHouseError, InternalServerErrorBody_DatabaseError
+]

mirascope/api/_generated/types/issue.py

@@ -29,9 +29,7 @@ class Issue(UniversalBaseModel):
     """
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/issue_tag.py

@@ -4,14 +4,7 @@ import typing
 
 IssueTag = typing.Union[
     typing.Literal[
-        "Pointer",
-        "Unexpected",
-        "Missing",
-        "Composite",
-        "Refinement",
-        "Transformation",
-        "Type",
-        "Forbidden",
+        "Pointer", "Unexpected", "Missing", "Composite", "Refinement", "Transformation", "Type", "Forbidden"
     ],
     typing.Any,
 ]

mirascope/api/_generated/types/not_found_error_body.py

@@ -13,9 +13,7 @@ class NotFoundErrorBody(UniversalBaseModel):
     tag: NotFoundErrorTag
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/number_from_string.py

@@ -0,0 +1,3 @@
+# This file was auto-generated by Fern from our API Definition.
+
+NumberFromString = str

mirascope/api/_generated/types/permission_denied_error.py

@@ -13,9 +13,7 @@ class PermissionDeniedError(UniversalBaseModel):
     tag: PermissionDeniedErrorTag
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/permission_denied_error_tag.py

@@ -2,6 +2,4 @@
 
 import typing
 
-PermissionDeniedErrorTag = typing.Union[
-    typing.Literal["PermissionDeniedError"], typing.Any
-]
+PermissionDeniedErrorTag = typing.Union[typing.Literal["PermissionDeniedError"], typing.Any]

mirascope/api/_generated/types/plan_limit_exceeded_error.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+from .plan_limit_exceeded_error_tag import PlanLimitExceededErrorTag
+
+
+class PlanLimitExceededError(UniversalBaseModel):
+    message: str
+    resource: str
+    limit_type: typing_extensions.Annotated[str, FieldMetadata(alias="limitType")]
+    current_usage: typing_extensions.Annotated[
+        float, FieldMetadata(alias="currentUsage")
+    ]
+    limit: float
+    plan_tier: typing_extensions.Annotated[str, FieldMetadata(alias="planTier")]
+    tag: PlanLimitExceededErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/plan_limit_exceeded_error_tag.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+PlanLimitExceededErrorTag = typing.Union[
+    typing.Literal["PlanLimitExceededError"], typing.Any
+]

mirascope/api/_generated/types/pricing_unavailable_error.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class PricingUnavailableError(UniversalBaseModel):
+    message: str
+    provider: typing.Optional[str] = None
+    model: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/property_key_key.py

@@ -16,9 +16,7 @@ class PropertyKeyKey(UniversalBaseModel):
     key: str
 
     if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
-            extra="allow", frozen=True
-        )  # type: ignore # Pydantic v2
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:
 
         class Config:

mirascope/api/_generated/types/rate_limit_error.py

@@ -0,0 +1,31 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+from .rate_limit_error_tag import RateLimitErrorTag
+
+
+class RateLimitError(UniversalBaseModel):
+    message: str
+    organization_id: typing_extensions.Annotated[
+        str, FieldMetadata(alias="organizationId")
+    ]
+    limit: float
+    retry_after: typing_extensions.Annotated[float, FieldMetadata(alias="retryAfter")]
+    plan_tier: typing_extensions.Annotated[str, FieldMetadata(alias="planTier")]
+    tag: RateLimitErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/rate_limit_error_tag.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+RateLimitErrorTag = typing.Union[typing.Literal["RateLimitError"], typing.Any]

mirascope/api/_generated/types/service_unavailable_error_body.py

@@ -0,0 +1,24 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .service_unavailable_error_tag import ServiceUnavailableErrorTag
+
+
+class ServiceUnavailableErrorBody(UniversalBaseModel):
+    message: str
+    service: typing.Optional[str] = None
+    tag: ServiceUnavailableErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/service_unavailable_error_tag.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ServiceUnavailableErrorTag = typing.Union[
+    typing.Literal["ServiceUnavailableError"], typing.Any
+]

mirascope/api/_generated/types/stripe_error.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class StripeError(UniversalBaseModel):
+    message: str
+    cause: typing.Optional[typing.Optional[typing.Any]] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/subscription_past_due_error.py

@@ -0,0 +1,31 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from ..core.serialization import FieldMetadata
+from .subscription_past_due_error_tag import SubscriptionPastDueErrorTag
+
+
+class SubscriptionPastDueError(UniversalBaseModel):
+    message: str
+    stripe_customer_id: typing_extensions.Annotated[
+        str, FieldMetadata(alias="stripeCustomerId")
+    ]
+    past_due_subscription_ids: typing_extensions.Annotated[
+        typing.List[str], FieldMetadata(alias="pastDueSubscriptionIds")
+    ]
+    tag: SubscriptionPastDueErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/subscription_past_due_error_tag.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+SubscriptionPastDueErrorTag = typing.Union[
+    typing.Literal["SubscriptionPastDueError"], typing.Any
+]

mirascope/api/_generated/types/unauthorized_error_body.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .unauthorized_error_tag import UnauthorizedErrorTag
+
+
+class UnauthorizedErrorBody(UniversalBaseModel):
+    message: str
+    tag: UnauthorizedErrorTag
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

mirascope/api/_generated/types/unauthorized_error_tag.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+UnauthorizedErrorTag = typing.Union[typing.Literal["UnauthorizedError"], typing.Any]

mirascope/api/settings.py

@@ -15,7 +15,7 @@ from pydantic_settings import BaseSettings, SettingsConfigDict
 class Settings(BaseSettings):
     """Global settings for Mirascope SDK."""
 
-    base_url: str = Field(default="https://v2.mirascope.com")
+    base_url: str = Field(default="https://mirascope.com/api/v2")
     api_key: str | None = None
 
     def update(self, **kwargs: Any) -> None:  # noqa: ANN401
@@ -46,6 +46,24 @@ def get_settings() -> Settings:
     return settings
 
 
+def update_settings(
+    *,
+    api_key: str | None = None,
+    base_url: str | None = None,
+) -> None:
+    """Update the current settings with provided values.
+
+    This allows programmatic configuration of settings (e.g., from ops.configure)
+    that will be used by get_sync_client() and get_async_client().
+
+    Args:
+        api_key: API key to set (if provided)
+        base_url: Base URL to set (if provided)
+    """
+    current = get_settings()
+    current.update(api_key=api_key, base_url=base_url)
+
+
 @contextmanager
 def settings(
     base_url: str | None = None,