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

langchain_dev_utils/__init__.py

@@ -1 +1 @@
-__version__ = "1.3.3"
+__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/agents/wrap.py

@@ -171,7 +171,7 @@ def wrap_all_agents_as_tool(
     Example:
         >>> from langchain_dev_utils.agents import wrap_all_agents_as_tool, create_agent
         >>>
-        >>> call_time_agent_tool = wrap_all_agents_as_tool(
+        >>> call_agent_tool = wrap_all_agents_as_tool(
         ...     [time_agent,weather_agent],
         ...     tool_name="call_sub_agents",
         ...     tool_description="Used to invoke the sub-agents to perform tasks"

langchain_dev_utils/chat_models/adapters/__init__.py

@@ -0,0 +1,3 @@
+from .create_utils import create_openai_compatible_model
+
+__all__ = ["create_openai_compatible_model"]

langchain_dev_utils/chat_models/adapters/create_utils.py

@@ -0,0 +1,53 @@
+from typing import Any, Optional, cast
+
+from langchain_core.utils import from_env
+
+from langchain_dev_utils._utils import _check_pkg_install
+
+from ..types import CompatibilityOptions
+
+
+def create_openai_compatible_model(
+    model_provider: str,
+    base_url: Optional[str] = None,
+    compatibility_options: Optional[CompatibilityOptions] = None,
+    model_profiles: Optional[dict[str, dict[str, Any]]] = None,
+    chat_model_cls_name: Optional[str] = None,
+):
+    """Factory function for creating provider-specific OpenAI-compatible model classes.
+
+    Dynamically generates model classes for different OpenAI-compatible providers,
+    configuring environment variable mappings and default base URLs specific to each provider.
+
+    Args:
+        model_provider (str): Identifier for the OpenAI-compatible provider (e.g. `vllm`, `moonshot`)
+        base_url (Optional[str], optional): Default API base URL for the provider. Defaults to None. If not provided, will try to use the environment variable.
+        compatibility_options (Optional[CompatibilityOptions], optional): Optional configuration for compatibility options with the provider. Defaults to None.
+        model_profiles (Optional[dict[str, dict[str, Any]]], optional): Optional model profiles for the provider. Defaults to None.
+        chat_model_cls_name (Optional[str], optional): Optional custom class name for the generated model. Defaults to None.
+    Returns:
+        Type[_BaseChatOpenAICompatible]: Configured model class ready for instantiation with provider-specific settings
+
+    Examples:
+        >>> from langchain_dev_utils.chat_models.adapters import create_openai_compatible_chat_model
+        >>> ChatVLLM = create_openai_compatible_chat_model(
+        ...     "vllm",
+        ...     base_url="http://localhost:8000",
+        ...     chat_model_cls_name="ChatVLLM",
+        ... )
+        >>> model = ChatVLLM(model="qwen3-4b")
+        >>> model.invoke("hello")
+    """
+    _check_pkg_install("langchain_openai")
+    from .openai_compatible import _create_openai_compatible_model
+
+    base_url = (
+        base_url or from_env(f"{model_provider.upper()}_API_BASE", default=None)()
+    )
+    return _create_openai_compatible_model(
+        chat_model_cls_name=chat_model_cls_name,
+        provider=model_provider,
+        base_url=cast(str, base_url),
+        compatibility_options=compatibility_options,
+        profiles=model_profiles,
+    )

langchain_dev_utils/chat_models/adapters/openai_compatible.py

@@ -12,6 +12,7 @@ from typing import (
     Type,
     TypeVar,
     Union,
+    cast,
 )
 
 import openai
@@ -19,7 +20,11 @@ from langchain_core.callbacks import (
     AsyncCallbackManagerForLLMRun,
     CallbackManagerForLLMRun,
 )
-from langchain_core.language_models import LangSmithParams, LanguageModelInput
+from langchain_core.language_models import (
+    LangSmithParams,
+    LanguageModelInput,
+    ModelProfile,
+)
 from langchain_core.messages import (
     AIMessage,
     AIMessageChunk,
@@ -45,12 +50,21 @@ 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,
     ResponseFormatType,
     ToolChoiceType,
 )
+from .register_profiles import (
+    _get_profile_by_provider_and_model,
+    _register_profile_with_provider,
+)
 
 _BM = TypeVar("_BM", bound=BaseModel)
 _DictOrPydanticClass = Union[dict[str, Any], type[_BM], type]
@@ -152,7 +166,7 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
     Note: This is a template class and should not be exported or instantiated
     directly. Instead, use it as a base class and provide the specific provider
     name through inheritance or the factory function
-    `_create_openai_compatible_model()`.
+    `create_openai_compatible_model()`.
     """
 
     model_name: str = Field(alias="model", default="openai compatible model")
@@ -283,7 +297,10 @@ class _BaseChatOpenAICompatible(BaseChatOpenAI):
     def _set_model_profile(self) -> Self:
         """Set model profile if not overridden."""
         if self.profile is None:
-            self.profile = {}
+            self.profile = cast(
+                ModelProfile,
+                _get_profile_by_provider_and_model(self._provider, self.model_name),
+            )
         return self
 
     def _create_chat_result(
@@ -574,10 +591,57 @@ 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,
     compatibility_options: Optional[CompatibilityOptions] = None,
+    profiles: Optional[dict[str, dict[str, Any]]] = None,
+    chat_model_cls_name: Optional[str] = None,
 ) -> Type[_BaseChatOpenAICompatible]:
     """Factory function for creating provider-specific OpenAI-compatible model classes.
 
@@ -588,14 +652,27 @@ def _create_openai_compatible_model(
         provider: Provider identifier (e.g.`vllm`)
         base_url: Default API base URL for the provider
         compatibility_options: Optional configuration for the provider
+        profiles: Optional profiles for the provider
+        chat_model_cls_name: Optional name for the model class
 
     Returns:
         Configured model class ready for instantiation with provider-specific settings
     """
-    chat_model_cls_name = f"Chat{provider.title()}"
+    chat_model_cls_name = chat_model_cls_name or f"Chat{provider.title()}"
     if compatibility_options is None:
         compatibility_options = {}
 
+    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/adapters/register_profiles.py

@@ -0,0 +1,15 @@
+from typing import Any
+
+_PROFILES = {}
+
+
+def _register_profile_with_provider(
+    provider_name: str, profile: dict[str, Any]
+) -> None:
+    _PROFILES.update({provider_name: profile})
+
+
+def _get_profile_by_provider_and_model(
+    provider_name: str, model_name: str
+) -> dict[str, Any]:
+    return _PROFILES.get(provider_name, {}).get(model_name, {})

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")
@@ -141,19 +143,12 @@ def register_model_provider(
                 "when chat_model is a string, the value must be 'openai-compatible'"
             )
         chat_model = _create_openai_compatible_model(
-            provider_name,
-            base_url,
+            provider=provider_name,
+            base_url=base_url,
             compatibility_options=compatibility_options,
+            profiles=model_profiles,
         )
-        _MODEL_PROVIDERS_DICT.update(
-            {
-                provider_name: {
-                    "chat_model": chat_model,
-                    "base_url": base_url,
-                    "model_profiles": model_profiles,
-                }
-            }
-        )
+        _MODEL_PROVIDERS_DICT.update({provider_name: {"chat_model": chat_model}})
     else:
         if base_url is not None:
             _MODEL_PROVIDERS_DICT.update(

langchain_dev_utils/embeddings/adapters/__init__.py

@@ -0,0 +1,3 @@
+from .create_utils import create_openai_compatible_embedding
+
+__all__ = ["create_openai_compatible_embedding"]

langchain_dev_utils/embeddings/adapters/create_utils.py

@@ -0,0 +1,45 @@
+from typing import Optional, cast
+
+from langchain_core.utils import from_env
+
+from langchain_dev_utils._utils import _check_pkg_install
+
+
+def create_openai_compatible_embedding(
+    embedding_provider: str,
+    base_url: Optional[str] = None,
+    embedding_model_cls_name: Optional[str] = None,
+):
+    """Factory function for creating provider-specific OpenAI-compatible embedding classes.
+
+    Dynamically generates embedding classes for different OpenAI-compatible providers,
+    configuring environment variable mappings and default base URLs specific to each provider.
+
+    Args:
+        embedding_provider (str): Identifier for the OpenAI-compatible provider (e.g. `vllm`, `moonshot`)
+        base_url (Optional[str], optional): Default API base URL for the provider. Defaults to None. If not provided, will try to use the environment variable.
+        embedding_model_cls_name (Optional[str], optional): Optional custom class name for the generated embedding. Defaults to None.
+    Returns:
+        Type[_BaseEmbeddingOpenAICompatible]: Configured embedding class ready for instantiation with provider-specific settings
+
+    Examples:
+        >>> from langchain_dev_utils.embeddings.adapters import create_openai_compatible_embedding
+        >>> VLLMEmbedding = create_openai_compatible_embedding(
+        ...     "vllm",
+        ...     base_url="http://localhost:8000",
+        ...     embedding_model_cls_name="VLLMEmbedding",
+        ... )
+        >>> model = VLLMEmbedding(model="qwen3-embedding-8b")
+        >>> model.embed_query("hello")
+    """
+    _check_pkg_install("langchain_openai")
+    from .openai_compatible import _create_openai_compatible_embedding
+
+    base_url = (
+        base_url or from_env(f"{embedding_provider.upper()}_API_BASE", default=None)()
+    )
+    return _create_openai_compatible_embedding(
+        provider=embedding_provider,
+        base_url=cast(str, base_url),
+        embeddings_cls_name=embedding_model_cls_name,
+    )

langchain_dev_utils/embeddings/adapters/openai_compatible.py

@@ -0,0 +1,91 @@
+from typing import Optional, Type
+
+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.
+
+    This class extends the OpenAIEmbeddings class to support
+    custom API keys and base URLs for OpenAI-Compatible models.
+
+    Note: This is a template class and should not be exported or instantiated
+    directly. Instead, use it as a base class and provide the specific provider
+    name through inheritance or the factory function
+    `create_openai_compatible_embedding()`.
+    """
+
+    openai_api_key: Optional[SecretStr] = Field(
+        default_factory=secret_from_env("OPENAI_COMPATIBLE_API_KEY", default=None),
+        alias="api_key",
+    )
+    """OpenAI Compatible API key"""
+    openai_api_base: str = Field(
+        default_factory=from_env("OPENAI_COMPATIBLE_API_BASE", default=""),
+        alias="base_url",
+    )
+    """OpenAI Compatible API base URL"""
+
+    check_embedding_ctx_length: bool = False
+    """Whether to check the token length of inputs and automatically split inputs
+        longer than embedding_ctx_length. Defaults to False. """
+
+
+def _create_openai_compatible_embedding(
+    provider: str,
+    base_url: str,
+    embeddings_cls_name: Optional[str] = None,
+) -> Type[_BaseEmbeddingOpenAICompatible]:
+    """Factory function for creating provider-specific OpenAI-compatible embeddings classes.
+
+    Dynamically generates embeddings classes for different OpenAI-compatible providers,
+    configuring environment variable mappings and default base URLs specific to each provider.
+
+    Args:
+        provider: Provider identifier (e.g.`vllm`)
+        base_url: Default API base URL for the provider
+        embeddings_cls_name: Optional custom class name for the generated embeddings. Defaults to None.
+
+    Returns:
+        Configured embeddings class ready for instantiation with provider-specific settings
+    """
+    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,
+        openai_api_base=(
+            str,
+            Field(
+                default_factory=from_env(
+                    f"{provider.upper()}_API_BASE", default=base_url
+                ),
+            ),
+        ),
+        openai_api_key=(
+            str,
+            Field(
+                default_factory=secret_from_env(
+                    f"{provider.upper()}_API_KEY", default=None
+                ),
+            ),
+        ),
+    )

langchain_dev_utils/embeddings/base.py

@@ -1,11 +1,12 @@
 from typing import Any, Literal, NotRequired, Optional, TypedDict, Union
 
 from langchain.embeddings.base import _SUPPORTED_PROVIDERS, Embeddings, init_embeddings
-from langchain_core.utils import from_env, secret_from_env
+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:
@@ -101,12 +102,16 @@ def register_embeddings_provider(
             )
 
         _check_pkg_install("langchain_openai")
+        from .adapters.openai_compatible import _create_openai_compatible_embedding
 
+        embeddings_model = _create_openai_compatible_embedding(
+            provider=provider_name,
+            base_url=base_url,
+        )
         _EMBEDDINGS_PROVIDERS_DICT.update(
             {
                 provider_name: {
                     "embeddings_model": embeddings_model,
-                    "base_url": base_url,
                 }
             }
         )
@@ -220,28 +225,10 @@ def load_embeddings(
 
     if provider in _EMBEDDINGS_PROVIDERS_DICT:
         embeddings = _EMBEDDINGS_PROVIDERS_DICT[provider]["embeddings_model"]
-        if isinstance(embeddings, str):
-            if not (api_key := kwargs.get("api_key")):
-                api_key = secret_from_env(f"{provider.upper()}_API_KEY", default=None)()
-                if not api_key:
-                    raise ValueError(
-                        f"API key for {provider} not found. Please set it in the environment."
-                    )
-                kwargs["api_key"] = api_key
-                if embeddings == "openai-compatible":
-                    kwargs["check_embedding_ctx_length"] = False
-                    embeddings = "openai"
-            return init_embeddings(
-                model=model,
-                provider=embeddings,
-                base_url=_EMBEDDINGS_PROVIDERS_DICT[provider]["base_url"],
-                **kwargs,
-            )
-        else:
-            if base_url := _EMBEDDINGS_PROVIDERS_DICT[provider].get("base_url"):
-                url_key = _get_base_url_field_name(embeddings)
-                if url_key is not None:
-                    kwargs.update({url_key: base_url})
-            return embeddings(model=model, **kwargs)
+        if base_url := _EMBEDDINGS_PROVIDERS_DICT[provider].get("base_url"):
+            url_key = _get_base_url_field_name(embeddings)
+            if url_key is not None:
+                kwargs.update({url_key: base_url})
+        return embeddings(model=model, **kwargs)
     else:
         return init_embeddings(model, provider=provider, **kwargs)

langchain_dev_utils/message_convert/__init__.py

@@ -1,15 +1,15 @@
-from .content import (
-    aconvert_reasoning_content_for_chunk_iterator,
-    convert_reasoning_content_for_ai_message,
-    convert_reasoning_content_for_chunk_iterator,
-    merge_ai_message_chunk,
-)
-from .format import format_sequence
-
-__all__ = [
-    "convert_reasoning_content_for_ai_message",
-    "convert_reasoning_content_for_chunk_iterator",
-    "aconvert_reasoning_content_for_chunk_iterator",
-    "merge_ai_message_chunk",
-    "format_sequence",
-]
+from .content import (
+    aconvert_reasoning_content_for_chunk_iterator,
+    convert_reasoning_content_for_ai_message,
+    convert_reasoning_content_for_chunk_iterator,
+    merge_ai_message_chunk,
+)
+from .format import format_sequence
+
+__all__ = [
+    "convert_reasoning_content_for_ai_message",
+    "convert_reasoning_content_for_chunk_iterator",
+    "aconvert_reasoning_content_for_chunk_iterator",
+    "merge_ai_message_chunk",
+    "format_sequence",
+]

langchain_dev_utils/message_convert/format.py

@@ -1,69 +1,69 @@
-from typing import Sequence, Union
-
-from langchain_core.documents import Document
-from langchain_core.messages import (
-    AIMessage,
-    BaseMessage,
-    HumanMessage,
-    SystemMessage,
-    ToolMessage,
-)
-
-
-def format_sequence(
-    inputs: Union[Sequence[Document], Sequence[BaseMessage], Sequence[str]],
-    separator: str = "-",
-    with_num: bool = False,
-) -> str:
-    """Convert a list of messages, documents, or strings into a formatted string.
-
-    This function extracts text content from various types (e.g., HumanMessage, Document)
-    and joins them into a single string. Optionally adds serial numbers and a custom
-    separator between items.
-
-    Args:
-        inputs: A list of inputs. Supported types:
-            - langchain_core.messages: HumanMessage, AIMessage, SystemMessage, ToolMessage
-            - langchain_core.documents.Document
-            - str
-        separator: The separator used to join the items. Defaults to "-".
-        with_num: If True, prefixes each item with a serial number (e.g., "1. Hello").
-                  Defaults to False.
-
-    Returns:
-        A formatted string composed of the input contents, joined by `separator`.
-
-    Example:
-        # Format messages with default separator:
-        >>> from langchain_dev_utils.message_convert import format_sequence
-        >>> from langchain_core.messages import HumanMessage, AIMessage
-        >>> messages = [
-        ...     HumanMessage(content="Hello, how are you?"),
-        ...     AIMessage(content="I'm doing well, thank you!")
-        ... ]
-        >>> formatted = format_sequence(messages)
-        >>> formatted
-
-        # Format with custom separator and numbering:
-        >>> formatted = format_sequence(messages, separator="---", with_num=True)
-        >>> formatted
-    """
-    if not inputs:
-        return ""
-
-    outputs = []
-
-    for input_item in inputs:
-        if isinstance(
-            input_item, (HumanMessage, AIMessage, SystemMessage, ToolMessage)
-        ):
-            outputs.append(input_item.content)
-        elif isinstance(input_item, Document):
-            outputs.append(input_item.page_content)
-        elif isinstance(input_item, str):
-            outputs.append(input_item)
-    if with_num:
-        outputs = [f"{i + 1}. {output}" for i, output in enumerate(outputs)]
-
-    str_ = "\n" + separator
-    return separator + str_.join(outputs)
+from typing import Sequence, Union
+
+from langchain_core.documents import Document
+from langchain_core.messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+    ToolMessage,
+)
+
+
+def format_sequence(
+    inputs: Union[Sequence[Document], Sequence[BaseMessage], Sequence[str]],
+    separator: str = "-",
+    with_num: bool = False,
+) -> str:
+    """Convert a list of messages, documents, or strings into a formatted string.
+
+    This function extracts text content from various types (e.g., HumanMessage, Document)
+    and joins them into a single string. Optionally adds serial numbers and a custom
+    separator between items.
+
+    Args:
+        inputs: A list of inputs. Supported types:
+            - langchain_core.messages: HumanMessage, AIMessage, SystemMessage, ToolMessage
+            - langchain_core.documents.Document
+            - str
+        separator: The separator used to join the items. Defaults to "-".
+        with_num: If True, prefixes each item with a serial number (e.g., "1. Hello").
+                  Defaults to False.
+
+    Returns:
+        A formatted string composed of the input contents, joined by `separator`.
+
+    Example:
+        # Format messages with default separator:
+        >>> from langchain_dev_utils.message_convert import format_sequence
+        >>> from langchain_core.messages import HumanMessage, AIMessage
+        >>> messages = [
+        ...     HumanMessage(content="Hello, how are you?"),
+        ...     AIMessage(content="I'm doing well, thank you!")
+        ... ]
+        >>> formatted = format_sequence(messages)
+        >>> formatted
+
+        # Format with custom separator and numbering:
+        >>> formatted = format_sequence(messages, separator="---", with_num=True)
+        >>> formatted
+    """
+    if not inputs:
+        return ""
+
+    outputs = []
+
+    for input_item in inputs:
+        if isinstance(
+            input_item, (HumanMessage, AIMessage, SystemMessage, ToolMessage)
+        ):
+            outputs.append(input_item.content)
+        elif isinstance(input_item, Document):
+            outputs.append(input_item.page_content)
+        elif isinstance(input_item, str):
+            outputs.append(input_item)
+    if with_num:
+        outputs = [f"{i + 1}. {output}" for i, output in enumerate(outputs)]
+
+    str_ = "\n" + separator
+    return separator + str_.join(outputs)

{langchain_dev_utils-1.3.3.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.3
+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.3.dist-info → langchain_dev_utils-1.3.5.dist-info}/RECORD

@@ -1,13 +1,13 @@
-langchain_dev_utils/__init__.py,sha256=Vi6om3KImlKsS_Wg5CjUgYffoi2zx7T-SRPnnGL0G7M,22
-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
 langchain_dev_utils/agents/file_system.py,sha256=Yk3eetREE26WNrnTWLoiDUpOyCJ-rhjlfFDk6foLa1E,8468
 langchain_dev_utils/agents/plan.py,sha256=WwhoiJBmVYVI9bT8HfjCzTJ_SIp9WFil0gOeznv2omQ,6497
-langchain_dev_utils/agents/wrap.py,sha256=O8LSieRhlqL4cwf_BPNIiJD3lhTyL6civBHcQPWCqSU,9490
+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,15 +17,20 @@ 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=BzaoCIv145eE8b5wNDsbZDHn4EAxe4vdlptp7qXPWKk,11625
+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=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain_dev_utils/chat_models/adapters/openai_compatible.py,sha256=ws1CTZhyl8gxoY_RCLsV3cDgc8d7yDLWUa6ZfloxuMs,24239
+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=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=BGoWY0L7nG9iRV3d4sSagXhECXrwvS1xA-A_OVltn3k,9406
-langchain_dev_utils/message_convert/__init__.py,sha256=ZGrHGXPKMrZ_p9MqfIVZ4jgbEyb7aC4Q7X-muuThIYU,457
+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=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=1TOcJ09atH7LRtn_IIuBshKDXAyqoy3Q9b0Po-S-F9g,2377
+langchain_dev_utils/message_convert/format.py,sha256=NdrYX0cJn2-G1ArLSjJ7yO788KV1d83F4Kimpyft0IM,2446
 langchain_dev_utils/pipeline/__init__.py,sha256=eE6WktaLHDkqMeXDIDaLtm-OPTwtsX_Av8iK9uYrceo,186
 langchain_dev_utils/pipeline/parallel.py,sha256=nwZWbdSNeyanC9WufoJBTceotgT--UnPOfStXjgNMOc,5271
 langchain_dev_utils/pipeline/sequential.py,sha256=sYJXQzVHDKUc-UV-HMv38JTPnse1A7sRM0vqSdpHK0k,3850
@@ -33,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.3.dist-info/METADATA,sha256=PEt8qHRYBK2l-A2djg8eJEuz6uZdxZq-fPa6U6yR8Cc,4552
-langchain_dev_utils-1.3.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-langchain_dev_utils-1.3.3.dist-info/licenses/LICENSE,sha256=AWAOzNEcsvCEzHOF0qby5OKxviVH_eT9Yce1sgJTico,1084
-langchain_dev_utils-1.3.3.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,,