langchain-dev-utils 1.2.9__py3-none-any.whl → 1.2.11__py3-none-any.whl

langchain_dev_utils/chat_models/base.py

@@ -1,4 +1,4 @@
-from typing import Any, NotRequired, Optional, TypedDict, cast
+from typing import Any, Optional, cast
 
 from langchain.chat_models.base import _SUPPORTED_PROVIDERS, _init_chat_model_helper
 from langchain_core.language_models.chat_models import BaseChatModel
@@ -9,17 +9,10 @@ from langchain_dev_utils._utils import (
     _get_base_url_field_name,
 )
 
-from .types import ChatModelType, CompatibilityOptions
-
-_MODEL_PROVIDERS_DICT = {}
+from .types import ChatModelProvider, ChatModelType, CompatibilityOptions
 
 
-class ChatModelProvider(TypedDict):
-    provider_name: str
-    chat_model: ChatModelType
-    base_url: NotRequired[str]
-    model_profiles: NotRequired[dict[str, dict[str, Any]]]
-    compatibility_options: NotRequired[CompatibilityOptions]
+_MODEL_PROVIDERS_DICT = {}
 
 
 def _parse_model(model: str, model_provider: Optional[str]) -> tuple[str, str]:

langchain_dev_utils/chat_models/types.py

@@ -1,4 +1,4 @@
-from typing import Literal, NotRequired, TypedDict, Union
+from typing import Any, Literal, NotRequired, TypedDict, Union
 
 from langchain_core.language_models.chat_models import BaseChatModel
 
@@ -17,3 +17,11 @@ class CompatibilityOptions(TypedDict):
     supported_response_format: NotRequired[ResponseFormatType]
     reasoning_keep_policy: NotRequired[ReasoningKeepPolicy]
     include_usage: NotRequired[bool]
+
+
+class ChatModelProvider(TypedDict):
+    provider_name: str
+    chat_model: ChatModelType
+    base_url: NotRequired[str]
+    model_profiles: NotRequired[dict[str, dict[str, Any]]]
+    compatibility_options: NotRequired[CompatibilityOptions]

{langchain_dev_utils-1.2.9.dist-info → langchain_dev_utils-1.2.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-dev-utils
-Version: 1.2.9
+Version: 1.2.11
 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
@@ -22,26 +22,26 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  📚 <a href="https://tbice123123.github.io/langchain-dev-utils-docs/en/">English</a> • 
-  <a href="https://tbice123123.github.io/langchain-dev-utils-docs/zh/">中文</a>
+  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
+  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
 </p>
 
 [![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
 [![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
-[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils-docs/en/)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils/)
 
-> This is the English version. For the Chinese version, please visit [Chinese Documentation](https://github.com/TBice123123/langchain-dev-utils/blob/master/README_cn.md)
+> This is the English version. For the Chinese version, please visit [中文文档](https://github.com/TBice123123/langchain-dev-utils/blob/master/README_cn.md)
 
-**langchain-dev-utils** is a utility library focused on enhancing the development experience with LangChain and LangGraph. It provides a series of out-of-the-box utility functions that can both reduce repetitive code writing and improve code consistency and readability. By simplifying development workflows, this library helps you prototype faster, iterate more smoothly, and create clearer, more reliable LLM-based AI applications.
+**langchain-dev-utils** is a utility library focused on enhancing the development experience of LangChain and LangGraph. It provides a series of ready-to-use utility functions that can reduce repetitive code writing and improve code consistency and readability. By simplifying the development workflow, this library can help you build prototypes faster, iterate more smoothly, and create clearer and more reliable AI applications based on large language models.
 
 ## 🚀 Installation
 
 ```bash
 pip install -U langchain-dev-utils
 
-# Install the full-featured version:
+# Install full-featured version:
 pip install -U langchain-dev-utils[standard]
 ```
 
@@ -49,16 +49,16 @@ pip install -U langchain-dev-utils[standard]
 
 ### 1. **Model Management**
 
-In `langchain`, the `init_chat_model`/`init_embeddings` functions can be used to initialize chat model instances/embedding model instances, but the model providers they support are relatively limited. This module provides a registration function (`register_model_provider`/`register_embeddings_provider`) to register any model provider for subsequent model loading using `load_chat_model` / `load_embeddings`.
+In `langchain`, the `init_chat_model`/`init_embeddings` functions can be used to initialize chat model instances/embedding model instances, but they support a limited number of model providers. This module provides registration functions (`register_model_provider`/`register_embeddings_provider`) to easily register any model provider for later use with `load_chat_model` / `load_embeddings` for model loading.
 
 #### 1.1 Chat Model Management
 
-Mainly consists of the following two functions:
+There are two main functions:
 
 - `register_model_provider`: Register a chat model provider
 - `load_chat_model`: Load a chat model
 
-Example for integrating a qwen3-4b model deployed using `vllm`:
+Assuming you want to use the qwen3-4b model deployed with `vllm`, the reference code is as follows:
 
 ```python
 from langchain_dev_utils.chat_models import (
@@ -80,12 +80,12 @@ print(model.invoke("Hello"))
 
 #### 1.2 Embedding Model Management
 
-Mainly consists of the following two functions:
+There are two main functions:
 
 - `register_embeddings_provider`: Register an embedding model provider
 - `load_embeddings`: Load an embedding model
 
-Example for integrating a qwen3-embedding-4b model deployed using `vllm`:
+Assuming you want to use the qwen3-embedding-4b model deployed with `vllm`, the reference code is as follows:
 
 ```python
 from langchain_dev_utils.embeddings import register_embeddings_provider, load_embeddings
@@ -103,23 +103,21 @@ emb = embeddings.embed_query("Hello")
 print(emb)
 ```
 
-**For more information about model management, please refer to**: [Chat Model Management](https://tbice123123.github.io/langchain-dev-utils-docs/en/model-management/chat.html), [Embedding Model Management](https://tbice123123.github.io/langchain-dev-utils-docs/en/model-management/embedding.html)
 
 ### 2. **Message Conversion**
 
 Includes the following features:
 
-- Merge reasoning content into the final response
+- Merge chain-of-thought content into final responses
 - Stream content merging
 - Content formatting tools
 
 #### 2.1 Stream Content Merging
 
-For stream responses obtained using `stream()` and `astream()`, you can use `merge_ai_message_chunk` to merge them into a final AIMessage.
+For streaming responses obtained using `stream()` and `astream()`, you can use `merge_ai_message_chunk` to merge them into a final AIMessage.
 
 ```python
 from langchain_dev_utils.message_convert import merge_ai_message_chunk
-
 chunks = list(model.stream("Hello"))
 merged = merge_ai_message_chunk(chunks)
 ```
@@ -137,7 +135,6 @@ text = format_sequence([
 ], separator="\n", with_num=True)
 ```
 
-**For more information about message conversion, please refer to**: [Message Process](https://tbice123123.github.io/langchain-dev-utils-docs/en/message-conversion/message.html), [Formatting List Content](https://tbice123123.github.io/langchain-dev-utils-docs/en/message-conversion/format.html)
 
 ### 3. **Tool Calling**
 
@@ -157,10 +154,10 @@ from langchain_dev_utils.tool_calling import has_tool_calling, parse_tool_callin
 
 @tool
 def get_current_time() -> str:
-    """Get the current timestamp"""
+    """Get current timestamp"""
     return str(datetime.datetime.now().timestamp())
 
-response = model.bind_tools([get_current_time]).invoke("What time is it?")
+response = model.bind_tools([get_current_time]).invoke("What time is it now?")
 
 if has_tool_calling(response):
     name, args = parse_tool_calling(
@@ -184,40 +181,43 @@ import datetime
 @human_in_the_loop
 @tool
 def get_current_time() -> str:
-    """Get the current timestamp"""
+    """Get current timestamp"""
     return str(datetime.datetime.now().timestamp())
 ```
 
-**For more information about tool calling, please refer to**: [Add Human-in-the-Loop Support](https://tbice123123.github.io/langchain-dev-utils-docs/en/tool-calling/human-in-the-loop.html), [Tool Call Handling](https://tbice123123.github.io/langchain-dev-utils-docs/en/tool-calling/tool.html)
 
 ### 4. **Agent Development**
 
-Includes the following capabilities:
+Includes the following features:
 
-- Multi-agent construction  
-- Commonly used middleware components  
+- Multi-agent construction
+- Common middleware components
 
 #### 4.1 Multi-Agent Construction
 
-Wrapping an agent as a tool is a common implementation pattern in multi-agent systems, as elaborated in the official LangChain documentation. To support this pattern, this library provides a pre-built utility function `wrap_agent_as_tool`, which encapsulates an agent instance into a tool that can be invoked by other agents.
+Wrapping agents as tools is a common implementation pattern in multi-agent systems, which is detailed in the official LangChain documentation. To this end, this library provides a pre-built function `wrap_agent_as_tool` to implement this pattern, which can wrap an agent instance into a tool that can be called by other agents.
 
-**Usage Example**:
+Usage example:
 
 ```python
 import datetime
 from langchain_dev_utils.agents import create_agent, wrap_agent_as_tool
 from langchain.agents import AgentState
 
-
 @tool
 def get_current_time() -> str:
-    """Get the current time."""
+    """Get current time"""
     return datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
+time_agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
+call_time_agent_tool = wrap_agent_as_tool(time_agent)  
 
-agent = create_agent("vllm:qwen3-4b", tools=[get_current_time], name="time-agent")
-call_time_agent_tool = wrap_agent_as_tool(agent)
-response = call_time_agent_tool.invoke(
+agent = create_agent(
+    "vllm:qwen3-4b",
+    name="agent",
+    tools=[call_time_agent_tool],
+)
+response = agent.invoke(
     {"messages": [{"role": "user", "content": "What time is it now?"}]}
 )
 print(response)
@@ -225,10 +225,11 @@ print(response)
 
 #### 4.2 Middleware
 
-Provides several commonly used middleware components. Below are examples using `ToolCallRepairMiddleware` and `PlanMiddleware`.
+Provides some common middleware components. Below are examples using `ToolCallRepairMiddleware` and `PlanMiddleware`.
 
-- `ToolCallRepairMiddleware` automatically repairs malformed tool calls found in the model's `invalid_tool_calls` output.
-- `PlanMiddleware` enables task planning capabilities for agents.
+`ToolCallRepairMiddleware` is used to fix `invaild_tool_calls` content from large models.
+
+`PlanMiddleware` is used for agent planning.
 
 ```python
 from langchain_dev_utils.agents.middleware import (
@@ -236,33 +237,28 @@ from langchain_dev_utils.agents.middleware import (
     PlanMiddleware,
 )
 
-agent = create_agent(
+agent=create_agent(
     "vllm:qwen3-4b",
     name="plan-agent",
-    middleware=[
-        ToolCallRepairMiddleware(),
-        PlanMiddleware(use_read_plan_tool=False)
-    ]
+    middleware=[ToolCallRepairMiddleware(), PlanMiddleware(
+        use_read_plan_tool=False
+    )]
 )
-response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan for visiting New York."}]})
+response = agent.invoke({"messages": [{"role": "user", "content": "Give me a travel plan to New York"}]}))
 print(response)
 ```
 
-**For more details on agent development and a complete list of built-in middleware, please refer to**:  
-[Multi-Agent Construction](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/multi-agent.html),  
-[Middleware](https://tbice123123.github.io/langchain-dev-utils-docs/en/agent-development/middleware.html)
-
 
 ### 5. **State Graph Orchestration**
 
-Includes the following capabilities:
+Includes the following features:
 
 - Sequential graph orchestration
 - Parallel graph orchestration
 
 #### 5.1 Sequential Graph Orchestration
 
-Use `create_sequential_pipeline` to orchestrate multiple subgraphs in sequential order:
+Using `create_sequential_pipeline`, you can orchestrate multiple subgraphs in sequence:
 
 ```python
 from langchain.agents import AgentState
@@ -277,25 +273,25 @@ register_model_provider(
     base_url="http://localhost:8000/v1",
 )
 
-# Build a sequential pipeline (all subgraphs executed in order)
+# Build sequential pipeline (all subgraphs execute in sequence)
 graph = create_sequential_pipeline(
     sub_graphs=[
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_time],
-            system_prompt="You are a time-query assistant. You can only answer questions about the current time. If the question is unrelated to time, respond with 'I cannot answer that.'",
+            system_prompt="You are a time query assistant, you can only answer the current time. If this question is not related to time, please directly answer that you cannot answer",
             name="time_agent",
         ),
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_weather],
-            system_prompt="You are a weather-query assistant. You can only answer questions about the current weather. If the question is unrelated to weather, respond with 'I cannot answer that.'",
+            system_prompt="You are a weather query assistant, you can only answer the current weather. If this question is not related to weather, please directly answer that you cannot answer",
             name="weather_agent",
         ),
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_user],
-            system_prompt="You are a user-query assistant. You can only answer questions about the current user. If the question is unrelated to the user, respond with 'I cannot answer that.'",
+            system_prompt="You are a user query assistant, you can only answer the current user. If this question is not related to users, please directly answer that you cannot answer",
             name="user_agent",
         ),
     ],
@@ -308,44 +304,42 @@ print(response)
 
 #### 5.2 Parallel Graph Orchestration
 
-Use `create_parallel_pipeline` to orchestrate multiple subgraphs in parallel:
+Using `create_parallel_pipeline`, you can orchestrate multiple subgraphs in parallel:
 
 ```python
 from langchain_dev_utils.pipeline import create_parallel_pipeline
 
-# Build a parallel pipeline (all subgraphs executed concurrently)
+# Build parallel pipeline (all subgraphs execute in parallel)
 graph = create_parallel_pipeline(
     sub_graphs=[
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_time],
-            system_prompt="You are a time-query assistant. You can only answer questions about the current time. If the question is unrelated to time, respond with 'I cannot answer that.'",
+            system_prompt="You are a time query assistant, you can only answer the current time. If this question is not related to time, please directly answer that you cannot answer",
             name="time_agent",
         ),
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_weather],
-            system_prompt="You are a weather-query assistant. You can only answer questions about the current weather. If the question is unrelated to weather, respond with 'I cannot answer that.'",
+            system_prompt="You are a weather query assistant, you can only answer the current weather. If this question is not related to weather, please directly answer that you cannot answer",
             name="weather_agent",
         ),
         create_agent(
             model="vllm:qwen3-4b",
             tools=[get_current_user],
-            system_prompt="You are a user-query assistant. You can only answer questions about the current user. If the question is unrelated to the user, respond with 'I cannot answer that.'",
+            system_prompt="You are a user query assistant, you can only answer the current user. If this question is not related to users, please directly answer that you cannot answer",
             name="user_agent",
         ),
     ],
     state_schema=AgentState,
 )
-
 response = graph.invoke({"messages": [HumanMessage("Hello")]})
 print(response)
 ```
 
-**For more information about state graph orchestration, please refer to**: [State Graph Orchestration](https://tbice123123.github.io/langchain-dev-utils-docs/en/graph-orchestration/pipeline.html)
 
 ## 💬 Join the Community
 
 - [GitHub Repository](https://github.com/TBice123123/langchain-dev-utils) — Browse source code, submit Pull Requests
 - [Issue Tracker](https://github.com/TBice123123/langchain-dev-utils/issues) — Report bugs or suggest improvements
-- We welcome contributions in all forms — whether code, documentation, or usage examples. Let's build a more powerful and practical LangChain development ecosystem together!
+- We welcome all forms of contributions — whether code, documentation, or usage examples. Let's build a more powerful and practical LangChain development ecosystem together

{langchain_dev_utils-1.2.9.dist-info → langchain_dev_utils-1.2.11.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langchain_dev_utils/__init__.py,sha256=Oh3Y6CIypkhAjW-aquBTyP3_cA-gKgKTwq9EpcWpjps,22
+langchain_dev_utils/__init__.py,sha256=aBWZsCYiXXcSUsUJr3tOTQWsH7ZDqJzyMYdQbOd5Qtc,23
 langchain_dev_utils/_utils.py,sha256=MFEzR1BjXMj6HEVwt2x2omttFuDJ_rYAEbNqe99r9pM,1338
 langchain_dev_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langchain_dev_utils/agents/__init__.py,sha256=PJ-lSDZv_AXMYA3H4fx-HzJa14tPbkGmq1HX8LNfaPo,125
@@ -15,10 +15,10 @@ 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=CVMfgqMRnIKv8z4babusa2c4RKVuiWTL39mPD8cHAf4,11880
-langchain_dev_utils/chat_models/types.py,sha256=kVLbT-IbvNtWPVmyVmh58le5r8XCqrEwuFB9-TWCBJk,672
+langchain_dev_utils/chat_models/base.py,sha256=t-tjNMX4BSyNxvBCLX-BKfJzJcnzhUzJY4NTHhVhnPA,11627
+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=YgC8ups0owOVmY-Fwi7oxiktsC9LG6UZka8XNTCBW9g,21457
+langchain_dev_utils/chat_models/adapters/openai_compatible.py,sha256=v9ewQFn75Fl6urtVo4fZgg2RRrzRXGluKf-egYAI5A0,22658
 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
@@ -31,7 +31,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.2.9.dist-info/METADATA,sha256=zzBTgY8EUmuz08ofh1t1letaKywRXuqQgfPdqWBVw2Q,13279
-langchain_dev_utils-1.2.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-langchain_dev_utils-1.2.9.dist-info/licenses/LICENSE,sha256=AWAOzNEcsvCEzHOF0qby5OKxviVH_eT9Yce1sgJTico,1084
-langchain_dev_utils-1.2.9.dist-info/RECORD,,
+langchain_dev_utils-1.2.11.dist-info/METADATA,sha256=4IGI_v0rIC8_SW13_j3h2JyPS_-rKPvdK6m6lTW2ymE,11853
+langchain_dev_utils-1.2.11.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+langchain_dev_utils-1.2.11.dist-info/licenses/LICENSE,sha256=AWAOzNEcsvCEzHOF0qby5OKxviVH_eT9Yce1sgJTico,1084
+langchain_dev_utils-1.2.11.dist-info/RECORD,,