blaxel 0.2.34__py3-none-any.whl → 0.2.35__py3-none-any.whl

blaxel/core/client/models/metadata.py

@@ -14,34 +14,40 @@ T = TypeVar("T", bound="Metadata")
 
 @_attrs_define
 class Metadata:
-    """Metadata
+    """Common metadata fields shared by all Blaxel resources including name, labels, timestamps, and ownership information
 
     Attributes:
+        name (str): Unique identifier for the resource within the workspace. Must be lowercase alphanumeric with
+            hyphens, max 49 characters. Immutable after creation. Example: my-resource.
         created_at (Union[Unset, str]): The date and time when the resource was created
         updated_at (Union[Unset, str]): The date and time when the resource was updated
         created_by (Union[Unset, str]): The user or service account who created the resource
         updated_by (Union[Unset, str]): The user or service account who updated the resource
-        display_name (Union[Unset, str]): Model display name
-        labels (Union[Unset, MetadataLabels]): Labels
-        name (Union[Unset, str]): Model name
-        plan (Union[Unset, Any]): Plan
-        url (Union[Unset, str]): URL
-        workspace (Union[Unset, str]): Workspace name
+        display_name (Union[Unset, str]): Human-readable name for display in the UI. Can contain spaces and special
+            characters, max 63 characters. Example: My Resource.
+        labels (Union[Unset, MetadataLabels]): Key-value pairs for organizing and filtering resources. Labels can be
+            used to categorize resources by environment, project, team, or any custom taxonomy.
+        plan (Union[Unset, str]): Billing plan tier applied to this resource (inherited from workspace account)
+        url (Union[Unset, str]): Auto-generated endpoint URL for accessing this resource (for agents, functions, models,
+            sandboxes)
+        workspace (Union[Unset, str]): Name of the workspace this resource belongs to (read-only, set automatically)
     """
 
+    name: str
     created_at: Union[Unset, str] = UNSET
     updated_at: Union[Unset, str] = UNSET
     created_by: Union[Unset, str] = UNSET
     updated_by: Union[Unset, str] = UNSET
     display_name: Union[Unset, str] = UNSET
     labels: Union[Unset, "MetadataLabels"] = UNSET
-    name: Union[Unset, str] = UNSET
-    plan: Union[Unset, Any] = UNSET
+    plan: Union[Unset, str] = UNSET
     url: Union[Unset, str] = UNSET
     workspace: Union[Unset, str] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
+        name = self.name
+
         created_at = self.created_at
 
         updated_at = self.updated_at
@@ -58,8 +64,6 @@ class Metadata:
         elif self.labels and isinstance(self.labels, dict):
             labels = self.labels
 
-        name = self.name
-
         plan = self.plan
 
         url = self.url
@@ -68,7 +72,11 @@ class Metadata:
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
-        field_dict.update({})
+        field_dict.update(
+            {
+                "name": name,
+            }
+        )
         if created_at is not UNSET:
             field_dict["createdAt"] = created_at
         if updated_at is not UNSET:
@@ -81,8 +89,6 @@ class Metadata:
             field_dict["displayName"] = display_name
         if labels is not UNSET:
             field_dict["labels"] = labels
-        if name is not UNSET:
-            field_dict["name"] = name
         if plan is not UNSET:
             field_dict["plan"] = plan
         if url is not UNSET:
@@ -99,6 +105,8 @@ class Metadata:
         if not src_dict:
             return None
         d = src_dict.copy()
+        name = d.pop("name")
+
         created_at = d.pop("createdAt", d.pop("created_at", UNSET))
 
         updated_at = d.pop("updatedAt", d.pop("updated_at", UNSET))
@@ -116,8 +124,6 @@ class Metadata:
         else:
             labels = MetadataLabels.from_dict(_labels)
 
-        name = d.pop("name", UNSET)
-
         plan = d.pop("plan", UNSET)
 
         url = d.pop("url", UNSET)
@@ -125,13 +131,13 @@ class Metadata:
         workspace = d.pop("workspace", UNSET)
 
         metadata = cls(
+            name=name,
             created_at=created_at,
             updated_at=updated_at,
             created_by=created_by,
             updated_by=updated_by,
             display_name=display_name,
             labels=labels,
-            name=name,
             plan=plan,
             url=url,
             workspace=workspace,

blaxel/core/client/models/metadata_labels.py

@@ -8,7 +8,10 @@ T = TypeVar("T", bound="MetadataLabels")
 
 @_attrs_define
 class MetadataLabels:
-    """Labels"""
+    """Key-value pairs for organizing and filtering resources. Labels can be used to categorize resources by environment,
+    project, team, or any custom taxonomy.
+
+    """
 
     additional_properties: dict[str, str] = _attrs_field(init=False, factory=dict)
 

blaxel/core/client/models/model.py

@@ -3,6 +3,7 @@ from typing import TYPE_CHECKING, Any, TypeVar, Union
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
+from ..models.status import Status
 from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
@@ -16,22 +17,35 @@ T = TypeVar("T", bound="Model")
 
 @_attrs_define
 class Model:
-    """Logical object representing a model
-
-    Attributes:
-        events (Union[Unset, list['CoreEvent']]): Core events
-        metadata (Union[Unset, Metadata]): Metadata
-        spec (Union[Unset, ModelSpec]): Model specification
-        status (Union[Unset, str]): Model status
+    """Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.) with unified access control, credentials
+    management, and usage tracking.
+
+        Attributes:
+            metadata (Metadata): Common metadata fields shared by all Blaxel resources including name, labels, timestamps,
+                and ownership information
+            spec (ModelSpec): Configuration for a model gateway endpoint including provider type, credentials, and access
+                policies
+            events (Union[Unset, list['CoreEvent']]): Events happening on a resource deployed on Blaxel
+            status (Union[Unset, Status]): Deployment status of a resource deployed on Blaxel
     """
 
+    metadata: "Metadata"
+    spec: "ModelSpec"
     events: Union[Unset, list["CoreEvent"]] = UNSET
-    metadata: Union[Unset, "Metadata"] = UNSET
-    spec: Union[Unset, "ModelSpec"] = UNSET
-    status: Union[Unset, str] = UNSET
+    status: Union[Unset, Status] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
+        if type(self.metadata) is dict:
+            metadata = self.metadata
+        else:
+            metadata = self.metadata.to_dict()
+
+        if type(self.spec) is dict:
+            spec = self.spec
+        else:
+            spec = self.spec.to_dict()
+
         events: Union[Unset, list[dict[str, Any]]] = UNSET
         if not isinstance(self.events, Unset):
             events = []
@@ -44,33 +58,20 @@ class Model:
                     )
                 events.append(componentsschemas_core_events_item)
 
-        metadata: Union[Unset, dict[str, Any]] = UNSET
-        if (
-            self.metadata
-            and not isinstance(self.metadata, Unset)
-            and not isinstance(self.metadata, dict)
-        ):
-            metadata = self.metadata.to_dict()
-        elif self.metadata and isinstance(self.metadata, dict):
-            metadata = self.metadata
-
-        spec: Union[Unset, dict[str, Any]] = UNSET
-        if self.spec and not isinstance(self.spec, Unset) and not isinstance(self.spec, dict):
-            spec = self.spec.to_dict()
-        elif self.spec and isinstance(self.spec, dict):
-            spec = self.spec
-
-        status = self.status
+        status: Union[Unset, str] = UNSET
+        if not isinstance(self.status, Unset):
+            status = self.status.value
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
-        field_dict.update({})
+        field_dict.update(
+            {
+                "metadata": metadata,
+                "spec": spec,
+            }
+        )
         if events is not UNSET:
             field_dict["events"] = events
-        if metadata is not UNSET:
-            field_dict["metadata"] = metadata
-        if spec is not UNSET:
-            field_dict["spec"] = spec
         if status is not UNSET:
             field_dict["status"] = status
 
@@ -85,6 +86,10 @@ class Model:
         if not src_dict:
             return None
         d = src_dict.copy()
+        metadata = Metadata.from_dict(d.pop("metadata"))
+
+        spec = ModelSpec.from_dict(d.pop("spec"))
+
         events = []
         _events = d.pop("events", UNSET)
         for componentsschemas_core_events_item_data in _events or []:
@@ -94,26 +99,17 @@ class Model:
 
             events.append(componentsschemas_core_events_item)
 
-        _metadata = d.pop("metadata", UNSET)
-        metadata: Union[Unset, Metadata]
-        if isinstance(_metadata, Unset):
-            metadata = UNSET
+        _status = d.pop("status", UNSET)
+        status: Union[Unset, Status]
+        if isinstance(_status, Unset):
+            status = UNSET
         else:
-            metadata = Metadata.from_dict(_metadata)
-
-        _spec = d.pop("spec", UNSET)
-        spec: Union[Unset, ModelSpec]
-        if isinstance(_spec, Unset):
-            spec = UNSET
-        else:
-            spec = ModelSpec.from_dict(_spec)
-
-        status = d.pop("status", UNSET)
+            status = Status(_status)
 
         model = cls(
-            events=events,
             metadata=metadata,
             spec=spec,
+            events=events,
             status=status,
         )
 

blaxel/core/client/models/model_runtime.py

@@ -0,0 +1,99 @@
+from typing import Any, TypeVar, Union
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..models.model_runtime_type import ModelRuntimeType
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="ModelRuntime")
+
+
+@_attrs_define
+class ModelRuntime:
+    """Configuration identifying which external LLM provider and model this gateway endpoint proxies to
+
+    Attributes:
+        endpoint_name (Union[Unset, str]): Provider-specific endpoint name (e.g., HuggingFace Inference Endpoints name)
+        model (Union[Unset, str]): Model identifier at the provider (e.g., gpt-4.1, claude-sonnet-4-20250514, mistral-
+            large-latest) Example: gpt-4.1.
+        organization (Union[Unset, str]): Organization or account identifier at the provider (required for some
+            providers like OpenAI) Example: org-abc123.
+        type_ (Union[Unset, ModelRuntimeType]): LLM provider type determining the API protocol and authentication method
+            Example: openai.
+    """
+
+    endpoint_name: Union[Unset, str] = UNSET
+    model: Union[Unset, str] = UNSET
+    organization: Union[Unset, str] = UNSET
+    type_: Union[Unset, ModelRuntimeType] = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        endpoint_name = self.endpoint_name
+
+        model = self.model
+
+        organization = self.organization
+
+        type_: Union[Unset, str] = UNSET
+        if not isinstance(self.type_, Unset):
+            type_ = self.type_.value
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update({})
+        if endpoint_name is not UNSET:
+            field_dict["endpointName"] = endpoint_name
+        if model is not UNSET:
+            field_dict["model"] = model
+        if organization is not UNSET:
+            field_dict["organization"] = organization
+        if type_ is not UNSET:
+            field_dict["type"] = type_
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: dict[str, Any]) -> T | None:
+        if not src_dict:
+            return None
+        d = src_dict.copy()
+        endpoint_name = d.pop("endpointName", d.pop("endpoint_name", UNSET))
+
+        model = d.pop("model", UNSET)
+
+        organization = d.pop("organization", UNSET)
+
+        _type_ = d.pop("type", d.pop("type_", UNSET))
+        type_: Union[Unset, ModelRuntimeType]
+        if isinstance(_type_, Unset):
+            type_ = UNSET
+        else:
+            type_ = ModelRuntimeType(_type_)
+
+        model_runtime = cls(
+            endpoint_name=endpoint_name,
+            model=model,
+            organization=organization,
+            type_=type_,
+        )
+
+        model_runtime.additional_properties = d
+        return model_runtime
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

blaxel/core/client/models/model_runtime_type.py

@@ -0,0 +1,34 @@
+from enum import Enum
+
+
+class ModelRuntimeType(str, Enum):
+    ANTHROPIC = "anthropic"
+    AZURE_AI_INFERENCE = "azure-ai-inference"
+    AZURE_MARKETPLACE = "azure-marketplace"
+    AZURE_OPENAI_SERVICE = "azure-openai-service"
+    CEREBRAS = "cerebras"
+    COHERE = "cohere"
+    DEEPSEEK = "deepseek"
+    GEMINI = "gemini"
+    GROQ = "groq"
+    HF_PRIVATE_ENDPOINT = "hf_private_endpoint"
+    HF_PUBLIC_ENDPOINT = "hf_public_endpoint"
+    HUGGINGFACE = "huggingface"
+    MCP = "mcp"
+    MISTRAL = "mistral"
+    OPENAI = "openai"
+    PUBLIC_MODEL = "public_model"
+    VERTEXAI = "vertexai"
+    XAI = "xai"
+
+    def __str__(self) -> str:
+        return str(self.value)
+
+    @classmethod
+    def _missing_(cls, value: object) -> "ModelRuntimeType | None":
+        if isinstance(value, str):
+            upper_value = value.upper()
+            for member in cls:
+                if member.value.upper() == upper_value:
+                    return member
+        return None

blaxel/core/client/models/model_spec.py

@@ -6,10 +6,8 @@ from attrs import field as _attrs_field
 from ..types import UNSET, Unset
 
 if TYPE_CHECKING:
-    from ..models.core_spec_configurations import CoreSpecConfigurations
     from ..models.flavor import Flavor
-    from ..models.revision_configuration import RevisionConfiguration
-    from ..models.runtime import Runtime
+    from ..models.model_runtime import ModelRuntime
 
 
 T = TypeVar("T", bound="ModelSpec")
@@ -17,40 +15,28 @@ T = TypeVar("T", bound="ModelSpec")
 
 @_attrs_define
 class ModelSpec:
-    """Model specification
+    """Configuration for a model gateway endpoint including provider type, credentials, and access policies
 
     Attributes:
-        configurations (Union[Unset, CoreSpecConfigurations]): Optional configurations for the object
-        enabled (Union[Unset, bool]): Enable or disable the resource
+        enabled (Union[Unset, bool]): When false, the model endpoint is disabled and will not accept inference requests
+            Default: True. Example: True.
         flavors (Union[Unset, list['Flavor']]): Types of hardware available for deployments
         integration_connections (Union[Unset, list[str]]):
         policies (Union[Unset, list[str]]):
-        revision (Union[Unset, RevisionConfiguration]): Revision configuration
-        runtime (Union[Unset, Runtime]): Set of configurations for a deployment
-        sandbox (Union[Unset, bool]): Sandbox mode
+        runtime (Union[Unset, ModelRuntime]): Configuration identifying which external LLM provider and model this
+            gateway endpoint proxies to
+        sandbox (Union[Unset, bool]): When true, uses sandbox/test credentials from the integration connection
     """
 
-    configurations: Union[Unset, "CoreSpecConfigurations"] = UNSET
-    enabled: Union[Unset, bool] = UNSET
+    enabled: Union[Unset, bool] = True
     flavors: Union[Unset, list["Flavor"]] = UNSET
     integration_connections: Union[Unset, list[str]] = UNSET
     policies: Union[Unset, list[str]] = UNSET
-    revision: Union[Unset, "RevisionConfiguration"] = UNSET
-    runtime: Union[Unset, "Runtime"] = UNSET
+    runtime: Union[Unset, "ModelRuntime"] = UNSET
     sandbox: Union[Unset, bool] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
-        configurations: Union[Unset, dict[str, Any]] = UNSET
-        if (
-            self.configurations
-            and not isinstance(self.configurations, Unset)
-            and not isinstance(self.configurations, dict)
-        ):
-            configurations = self.configurations.to_dict()
-        elif self.configurations and isinstance(self.configurations, dict):
-            configurations = self.configurations
-
         enabled = self.enabled
 
         flavors: Union[Unset, list[dict[str, Any]]] = UNSET
@@ -71,16 +57,6 @@ class ModelSpec:
         if not isinstance(self.policies, Unset):
             policies = self.policies
 
-        revision: Union[Unset, dict[str, Any]] = UNSET
-        if (
-            self.revision
-            and not isinstance(self.revision, Unset)
-            and not isinstance(self.revision, dict)
-        ):
-            revision = self.revision.to_dict()
-        elif self.revision and isinstance(self.revision, dict):
-            revision = self.revision
-
         runtime: Union[Unset, dict[str, Any]] = UNSET
         if (
             self.runtime
@@ -96,8 +72,6 @@ class ModelSpec:
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
         field_dict.update({})
-        if configurations is not UNSET:
-            field_dict["configurations"] = configurations
         if enabled is not UNSET:
             field_dict["enabled"] = enabled
         if flavors is not UNSET:
@@ -106,8 +80,6 @@ class ModelSpec:
             field_dict["integrationConnections"] = integration_connections
         if policies is not UNSET:
             field_dict["policies"] = policies
-        if revision is not UNSET:
-            field_dict["revision"] = revision
         if runtime is not UNSET:
             field_dict["runtime"] = runtime
         if sandbox is not UNSET:
@@ -117,21 +89,12 @@ class ModelSpec:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: dict[str, Any]) -> T | None:
-        from ..models.core_spec_configurations import CoreSpecConfigurations
         from ..models.flavor import Flavor
-        from ..models.revision_configuration import RevisionConfiguration
-        from ..models.runtime import Runtime
+        from ..models.model_runtime import ModelRuntime
 
         if not src_dict:
             return None
         d = src_dict.copy()
-        _configurations = d.pop("configurations", UNSET)
-        configurations: Union[Unset, CoreSpecConfigurations]
-        if isinstance(_configurations, Unset):
-            configurations = UNSET
-        else:
-            configurations = CoreSpecConfigurations.from_dict(_configurations)
-
         enabled = d.pop("enabled", UNSET)
 
         flavors = []
@@ -147,29 +110,20 @@ class ModelSpec:
 
         policies = cast(list[str], d.pop("policies", UNSET))
 
-        _revision = d.pop("revision", UNSET)
-        revision: Union[Unset, RevisionConfiguration]
-        if isinstance(_revision, Unset):
-            revision = UNSET
-        else:
-            revision = RevisionConfiguration.from_dict(_revision)
-
         _runtime = d.pop("runtime", UNSET)
-        runtime: Union[Unset, Runtime]
+        runtime: Union[Unset, ModelRuntime]
         if isinstance(_runtime, Unset):
             runtime = UNSET
         else:
-            runtime = Runtime.from_dict(_runtime)
+            runtime = ModelRuntime.from_dict(_runtime)
 
         sandbox = d.pop("sandbox", UNSET)
 
         model_spec = cls(
-            configurations=configurations,
             enabled=enabled,
             flavors=flavors,
             integration_connections=integration_connections,
             policies=policies,
-            revision=revision,
             runtime=runtime,
             sandbox=sandbox,
         )

blaxel/core/client/models/o_auth.py

@@ -1,10 +1,14 @@
-from typing import Any, TypeVar, Union, cast
+from typing import TYPE_CHECKING, Any, TypeVar, Union
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
 from ..types import UNSET, Unset
 
+if TYPE_CHECKING:
+    from ..models.o_auth_scope_item import OAuthScopeItem
+
+
 T = TypeVar("T", bound="OAuth")
 
 
@@ -13,18 +17,24 @@ class OAuth:
     """OAuth of the artifact
 
     Attributes:
-        scope (Union[Unset, list[Any]]): Scope of the OAuth
+        scope (Union[Unset, list['OAuthScopeItem']]): Scope of the OAuth
         type_ (Union[Unset, str]): Type of the OAuth
     """
 
-    scope: Union[Unset, list[Any]] = UNSET
+    scope: Union[Unset, list["OAuthScopeItem"]] = UNSET
     type_: Union[Unset, str] = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
-        scope: Union[Unset, list[Any]] = UNSET
+        scope: Union[Unset, list[dict[str, Any]]] = UNSET
         if not isinstance(self.scope, Unset):
-            scope = self.scope
+            scope = []
+            for scope_item_data in self.scope:
+                if type(scope_item_data) is dict:
+                    scope_item = scope_item_data
+                else:
+                    scope_item = scope_item_data.to_dict()
+                scope.append(scope_item)
 
         type_ = self.type_
 
@@ -40,10 +50,17 @@ class OAuth:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: dict[str, Any]) -> T | None:
+        from ..models.o_auth_scope_item import OAuthScopeItem
+
         if not src_dict:
             return None
         d = src_dict.copy()
-        scope = cast(list[Any], d.pop("scope", UNSET))
+        scope = []
+        _scope = d.pop("scope", UNSET)
+        for scope_item_data in _scope or []:
+            scope_item = OAuthScopeItem.from_dict(scope_item_data)
+
+            scope.append(scope_item)
 
         type_ = d.pop("type", d.pop("type_", UNSET))
 

blaxel/core/client/models/{form_oauth.py → o_auth_scope_item.py}

@@ -3,12 +3,12 @@ from typing import Any, TypeVar
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
-T = TypeVar("T", bound="FormOauth")
+T = TypeVar("T", bound="OAuthScopeItem")
 
 
 @_attrs_define
-class FormOauth:
-    """OAuth of the artifact"""
+class OAuthScopeItem:
+    """ """
 
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
@@ -23,10 +23,10 @@ class FormOauth:
         if not src_dict:
             return None
         d = src_dict.copy()
-        form_oauth = cls()
+        o_auth_scope_item = cls()
 
-        form_oauth.additional_properties = d
-        return form_oauth
+        o_auth_scope_item.additional_properties = d
+        return o_auth_scope_item
 
     @property
     def additional_keys(self) -> list[str]:

blaxel/core/client/models/pending_invitation_accept.py

@@ -18,7 +18,8 @@ class PendingInvitationAccept:
 
     Attributes:
         email (Union[Unset, str]): User email
-        workspace (Union[Unset, Workspace]): Workspace
+        workspace (Union[Unset, Workspace]): Tenant container that groups all Blaxel resources (agents, functions,
+            models, etc.) with shared team access control and billing.
     """
 
     email: Union[Unset, str] = UNSET