langchain-dev-utils 1.3.4__py3-none-any.whl → 1.3.5__py3-none-any.whl

langchain_dev_utils/__init__.py

@@ -1 +1 @@
-__version__ = "1.3.4"
+__version__ = "1.3.5"

langchain_dev_utils/_utils.py

@@ -1,5 +1,5 @@
 from importlib import util
-from typing import Literal
+from typing import Literal, Optional
 
 from pydantic import BaseModel
 
@@ -41,3 +41,86 @@ def _get_base_url_field_name(model_cls: type[BaseModel]) -> str | None:
             return "api_base"
 
     return None
+
+
+def _validate_base_url(base_url: Optional[str] = None) -> None:
+    """Validate base URL format.
+
+    Args:
+        base_url: Base URL to validate
+
+    Raises:
+        ValueError: If base URL is not a valid HTTP or HTTPS URL
+    """
+    if base_url is None:
+        return
+
+    from urllib.parse import urlparse
+
+    parsed = urlparse(base_url.strip())
+
+    if not parsed.scheme or not parsed.netloc:
+        raise ValueError(
+            f"base_url must be a valid HTTP or HTTPS URL. Received: {base_url}"
+        )
+
+    if parsed.scheme not in ("http", "https"):
+        raise ValueError(
+            f"base_url must use HTTP or HTTPS protocol. Received: {parsed.scheme}"
+        )
+
+
+def _validate_model_cls_name(model_cls_name: str) -> None:
+    """Validate model class name follows Python naming conventions.
+
+    Args:
+        model_cls_name: Class name to validate
+
+    Raises:
+        ValueError: If class name is invalid
+    """
+    if not model_cls_name:
+        raise ValueError("model_cls_name cannot be empty")
+
+    if not model_cls_name[0].isalpha():
+        raise ValueError(
+            f"model_cls_name must start with a letter. Received: {model_cls_name}"
+        )
+
+    if not all(c.isalnum() or c == "_" for c in model_cls_name):
+        raise ValueError(
+            f"model_cls_name can only contain letters, numbers, and underscores. Received: {model_cls_name}"
+        )
+
+    if model_cls_name[0].islower():
+        raise ValueError(
+            f"model_cls_name should start with an uppercase letter (PEP 8). Received: {model_cls_name}"
+        )
+
+
+def _validate_provider_name(provider_name: str) -> None:
+    """Validate provider name follows Python naming conventions.
+
+    Args:
+        provider_name: Provider name to validate
+
+    Raises:
+        ValueError: If provider name is invalid
+    """
+    if not provider_name:
+        raise ValueError("provider_name cannot be empty")
+
+    if not provider_name[0].isalnum():
+        raise ValueError(
+            f"provider_name must start with a letter. Received: {provider_name}"
+        )
+
+    if not all(c.isalnum() or c == "_" for c in provider_name):
+        raise ValueError(
+            f"provider_name can only contain letters, numbers, underscores. Received: {provider_name}"
+        )
+
+    if len(provider_name) > 20:
+        raise ValueError(
+            f"provider_name must be 20 characters or fewer. Received: {provider_name}"
+        )

langchain_dev_utils/agents/middleware/format_prompt.py

@@ -11,7 +11,7 @@ def format_prompt(request: ModelRequest) -> str:
     Variables are first resolved from the state, then from the context if not found.
 
     Example:
-        >>> from langchain_dev_utils.agents.middleware.format_prompt import format_prompt
+        >>> from langchain_dev_utils.agents.middleware import format_prompt
         >>> from langchain.agents import create_agent
         >>> from langchain_core.messages import HumanMessage
         >>> from dataclasses import dataclass

langchain_dev_utils/chat_models/adapters/openai_compatible.py

@@ -50,6 +50,11 @@ from pydantic import (
 )
 from typing_extensions import Self
 
+from ..._utils import (
+    _validate_base_url,
+    _validate_model_cls_name,
+    _validate_provider_name,
+)
 from ..types import (
     CompatibilityOptions,
     ReasoningKeepPolicy,
@@ -586,6 +591,51 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
         )
 
 
+def _validate_compatibility_options(
+    compatibility_options: Optional[CompatibilityOptions] = None,
+) -> None:
+    """Validate provider configuration against supported features.
+
+    Args:
+        compatibility_options: Optional configuration for the provider
+
+    Raises:
+        ValueError: If provider configuration is invalid
+    """
+    if compatibility_options is None:
+        compatibility_options = {}
+
+    if "supported_tool_choice" in compatibility_options:
+        _supported_tool_choice = compatibility_options["supported_tool_choice"]
+        for tool_choice in _supported_tool_choice:
+            if tool_choice not in ["auto", "none", "required", "specific"]:
+                raise ValueError(
+                    f"Unsupported tool_choice: {tool_choice}. Please choose from 'auto', 'none', 'required','specific'."
+                )
+
+    if "supported_response_format" in compatibility_options:
+        _supported_response_format = compatibility_options["supported_response_format"]
+        for response_format in _supported_response_format:
+            if response_format not in ["json_schema", "json_mode"]:
+                raise ValueError(
+                    f"Unsupported response_format: {response_format}. Please choose from 'json_schema', 'json_mode'."
+                )
+
+    if "reasoning_keep_policy" in compatibility_options:
+        _reasoning_keep_policy = compatibility_options["reasoning_keep_policy"]
+        if _reasoning_keep_policy not in ["never", "current", "all"]:
+            raise ValueError(
+                f"Unsupported reasoning_keep_policy: {_reasoning_keep_policy}. Please choose from 'never', 'current', 'all'."
+            )
+
+    if "include_usage" in compatibility_options:
+        _include_usage = compatibility_options["include_usage"]
+        if not isinstance(_include_usage, bool):
+            raise ValueError(
+                f"include_usage must be a boolean value. Received: {_include_usage}"
+            )
+
+
 def _create_openai_compatible_model(
     provider: str,
     base_url: str,
@@ -615,6 +665,14 @@ def _create_openai_compatible_model(
     if profiles is not None:
         _register_profile_with_provider(provider, profiles)
 
+    _validate_compatibility_options(compatibility_options)
+
+    _validate_provider_name(provider)
+
+    _validate_model_cls_name(chat_model_cls_name)
+
+    _validate_base_url(base_url)
+
     return create_model(
         chat_model_cls_name,
         __base__=_BaseChatOpenAICompatible,

langchain_dev_utils/chat_models/base.py

@@ -7,6 +7,7 @@ from langchain_core.utils import from_env
 from langchain_dev_utils._utils import (
     _check_pkg_install,
     _get_base_url_field_name,
+    _validate_provider_name,
 )
 
 from .types import ChatModelProvider, ChatModelType, CompatibilityOptions
@@ -126,6 +127,7 @@ def register_model_provider(
         >>> model = load_chat_model(model="vllm:qwen3-4b")
         >>> model.invoke("Hello")
     """
+    _validate_provider_name(provider_name)
     base_url = base_url or from_env(f"{provider_name.upper()}_API_BASE", default=None)()
     if isinstance(chat_model, str):
         _check_pkg_install("langchain_openai")

langchain_dev_utils/embeddings/adapters/openai_compatible.py

@@ -4,6 +4,12 @@ from langchain_core.utils import from_env, secret_from_env
 from langchain_openai.embeddings import OpenAIEmbeddings
 from pydantic import Field, SecretStr, create_model
 
+from ..._utils import (
+    _validate_base_url,
+    _validate_model_cls_name,
+    _validate_provider_name,
+)
+
 
 class _BaseEmbeddingOpenAICompatible(OpenAIEmbeddings):
     """Base class for OpenAI-Compatible embeddings.
@@ -53,6 +59,16 @@ def _create_openai_compatible_embedding(
     """
     embeddings_cls_name = embeddings_cls_name or f"{provider.title()}Embeddings"
 
+    if len(provider) >= 20:
+        raise ValueError(
+            f"provider must be less than 50 characters. Received: {provider}"
+        )
+
+    _validate_model_cls_name(embeddings_cls_name)
+    _validate_provider_name(provider)
+
+    _validate_base_url(base_url)
+
     return create_model(
         embeddings_cls_name,
         __base__=_BaseEmbeddingOpenAICompatible,

langchain_dev_utils/embeddings/base.py

@@ -6,6 +6,7 @@ from langchain_core.utils import from_env
 from langchain_dev_utils._utils import (
     _check_pkg_install,
     _get_base_url_field_name,
+    _validate_provider_name,
 )
 
 _EMBEDDINGS_PROVIDERS_DICT = {}
@@ -87,7 +88,7 @@ def register_embeddings_provider(
         >>> embeddings = load_embeddings("vllm:qwen3-embedding-4b")
         >>> embeddings.embed_query("hello world")
     """
-
+    _validate_provider_name(provider_name)
     base_url = base_url or from_env(f"{provider_name.upper()}_API_BASE", default=None)()
     if isinstance(embeddings_model, str):
         if base_url is None:

{langchain_dev_utils-1.3.4.dist-info → langchain_dev_utils-1.3.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-dev-utils
-Version: 1.3.4
+Version: 1.3.5
 Summary: A practical utility library for LangChain and LangGraph development
 Project-URL: Source Code, https://github.com/TBice123123/langchain-dev-utils
 Project-URL: repository, https://github.com/TBice123123/langchain-dev-utils

{langchain_dev_utils-1.3.4.dist-info → langchain_dev_utils-1.3.5.dist-info}/RECORD

@@ -1,5 +1,5 @@
-langchain_dev_utils/__init__.py,sha256=9qxIaE8bFi9OKpc20hJx4mYCCa26qBsDb5ixbbRmD9c,23
-langchain_dev_utils/_utils.py,sha256=MFEzR1BjXMj6HEVwt2x2omttFuDJ_rYAEbNqe99r9pM,1338
+langchain_dev_utils/__init__.py,sha256=HxBccdYuMvYSmkuVJi1a6zde7NfWgx8iuIRvVLBi-XA,23
+langchain_dev_utils/_utils.py,sha256=rYsVM6ceU-VzZsJyf7ikfMh3OD84xCt0MLQIB3bwf_A,3858
 langchain_dev_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain_dev_utils/agents/__init__.py,sha256=69_biZzyJvW9OBT1g8TX_77mp9-I_TvWo9QtlvHq83E,177
 langchain_dev_utils/agents/factory.py,sha256=8XB6y_ddf58vXlTLHBL6KCirFqkD2GjtzsuOt98sS7U,3732
@@ -7,7 +7,7 @@ langchain_dev_utils/agents/file_system.py,sha256=Yk3eetREE26WNrnTWLoiDUpOyCJ-rhj
 langchain_dev_utils/agents/plan.py,sha256=WwhoiJBmVYVI9bT8HfjCzTJ_SIp9WFil0gOeznv2omQ,6497
 langchain_dev_utils/agents/wrap.py,sha256=dJbCvljyw-ee43__2uws4H4ZhsyyX1AuavNtHrdWqN8,9485
 langchain_dev_utils/agents/middleware/__init__.py,sha256=QVQibaNHvHPyNTZ2UNFfYL153ZboaCHcoioTHK0FsiY,710
-langchain_dev_utils/agents/middleware/format_prompt.py,sha256=LzYiQXCRvkpfDhGPxhZwdepeU3j-HUWPJqcx3FWsfT4,2357
+langchain_dev_utils/agents/middleware/format_prompt.py,sha256=yIkoSVPp0FemkjezvGsOmtgOkZDyEYQ8yh4YWYYGtVc,2343
 langchain_dev_utils/agents/middleware/handoffs.py,sha256=r196Xk0Jws1Tz6JQuvy5HEc3HAAQejCxFmJpB6KrvLU,7230
 langchain_dev_utils/agents/middleware/model_fallback.py,sha256=8xiNjTJ0yiRkPLCRfAGNnqY1TLstj1Anmiqyv5w2mA8,1633
 langchain_dev_utils/agents/middleware/model_router.py,sha256=qBspvj9ZoKfmC1pHWTO0EHHfxjgCUd-TuSbqvZl0kmg,7977
@@ -17,17 +17,17 @@ langchain_dev_utils/agents/middleware/tool_call_repair.py,sha256=oZF0Oejemqs9kSn
 langchain_dev_utils/agents/middleware/tool_emulator.py,sha256=OgtPhqturaWzF4fRSJ3f_IXvIrYrrAjlpOC5zmLtrkY,2031
 langchain_dev_utils/agents/middleware/tool_selection.py,sha256=dRH5ejR6N02Djwxt6Gd63MYkg6SV5pySlzaRt53OoZk,3113
 langchain_dev_utils/chat_models/__init__.py,sha256=YSLUyHrWEEj4y4DtGFCOnDW02VIYZdfAH800m4Klgeg,224
-langchain_dev_utils/chat_models/base.py,sha256=X76uaPoJDOLRphFyyeFH_RgEIvPcMoZEZWuRtjPCpl0,11486
+langchain_dev_utils/chat_models/base.py,sha256=G_SNvd53ogho-LRgD7DCD65xj51J2JxmOkA4URNW6ZQ,11560
 langchain_dev_utils/chat_models/types.py,sha256=MD3cv_ZIe9fCdgwisNfuxAOhy-j4YSs1ZOQYyCjlNKs,927
 langchain_dev_utils/chat_models/adapters/__init__.py,sha256=4tTbhAAQdpX_gWyWeH97hqS5HnaoqQqW6QBh9Qd1SKs,106
 langchain_dev_utils/chat_models/adapters/create_utils.py,sha256=r8_XWLNF3Yc6sumlBhmgG1QcBa4Dsba7X3f_9YeMeGA,2479
-langchain_dev_utils/chat_models/adapters/openai_compatible.py,sha256=A3_NcmnsrCrHgm1-mGT-JqQVYUBsOzFH0KzSNX6edbY,24876
+langchain_dev_utils/chat_models/adapters/openai_compatible.py,sha256=Xsd6HN1zGGDl87bZ5NMfwKfxWkgdP4DpszEqlb4Z-MY,27198
 langchain_dev_utils/chat_models/adapters/register_profiles.py,sha256=YS9ItCEq2ISoB_bp6QH5NVKOVR9-7la3r7B_xQNxZxE,366
 langchain_dev_utils/embeddings/__init__.py,sha256=zbEOaV86TUi9Zrg_dH9dpdgacWg31HMJTlTQknA9EKk,244
-langchain_dev_utils/embeddings/base.py,sha256=_no5sGEiBZENaHLWzwLB45tTsDj-bha7nt1GUhWBmP4,8731
+langchain_dev_utils/embeddings/base.py,sha256=GXFKZSAExMtCFUpsd6mY4NxCWCrq7JAatBw3kS9LaKY,8803
 langchain_dev_utils/embeddings/adapters/__init__.py,sha256=yJEZZdzZ2fv1ExezLaNxo0VU9HJTHKYbS3T_XP8Ab9c,114
 langchain_dev_utils/embeddings/adapters/create_utils.py,sha256=K4JlbjG-O5xLY3wxaVt0UZ3QwI--cVb4qyxLATKVAWQ,2012
-langchain_dev_utils/embeddings/adapters/openai_compatible.py,sha256=fPX1GpJ6nwadbVu7mAMEVTIvGL2ZvtfRwkld2CJeHng,2767
+langchain_dev_utils/embeddings/adapters/openai_compatible.py,sha256=fo7-m7dcWL4xrhSqdAHHVREsiXfVOvIrlaotaYTEiyE,3159
 langchain_dev_utils/message_convert/__init__.py,sha256=nnkDa_Im0dCb5u4aa2FRB9tqB8e6H6sEGYK6Vg81u2s,472
 langchain_dev_utils/message_convert/content.py,sha256=2V1g21byg3iLv5RjUW8zv3jwYwV7IH2hNim7jGRsIes,8096
 langchain_dev_utils/message_convert/format.py,sha256=NdrYX0cJn2-G1ArLSjJ7yO788KV1d83F4Kimpyft0IM,2446
@@ -38,7 +38,7 @@ langchain_dev_utils/pipeline/types.py,sha256=T3aROKKXeWvd0jcH5XkgMDQfEkLfPaiOhhV
 langchain_dev_utils/tool_calling/__init__.py,sha256=mu_WxKMcu6RoTf4vkTPbA1WSBSNc6YIqyBtOQ6iVQj4,322
 langchain_dev_utils/tool_calling/human_in_the_loop.py,sha256=7Z_QO5OZUR6K8nLoIcafc6osnvX2IYNorOJcbx6bVso,9672
 langchain_dev_utils/tool_calling/utils.py,sha256=S4-KXQ8jWmpGTXYZitovF8rxKpaSSUkFruM8LDwvcvE,2765
-langchain_dev_utils-1.3.4.dist-info/METADATA,sha256=K8AGEzWWmv-5HYzuNmmu3tboFyikx9zZjoj7H8Pald0,4552
-langchain_dev_utils-1.3.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-langchain_dev_utils-1.3.4.dist-info/licenses/LICENSE,sha256=AWAOzNEcsvCEzHOF0qby5OKxviVH_eT9Yce1sgJTico,1084
-langchain_dev_utils-1.3.4.dist-info/RECORD,,
+langchain_dev_utils-1.3.5.dist-info/METADATA,sha256=ftpdThaRWWEeTsrAYWNlf6WJPhP9xrEVTPez-JonkTk,4552
+langchain_dev_utils-1.3.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+langchain_dev_utils-1.3.5.dist-info/licenses/LICENSE,sha256=AWAOzNEcsvCEzHOF0qby5OKxviVH_eT9Yce1sgJTico,1084
+langchain_dev_utils-1.3.5.dist-info/RECORD,,