refs(py): updates (#1350)

* Better Middleware TOC & fix entries
* Fix deepagents cards (js)
* Fix fields for middleware & x-ref to model string info
* LangGraph pass
* Fix GenAI multimodal example
* Fix titles
*

Author: mdrxy

pipeline/preprocessors/link_map.py

@@ -104,7 +104,6 @@ class LinkMap(TypedDict):
             "system_prompt": "langchain/agents/#langchain.agents.create_agent(system_prompt)",
             "AgentState": "langchain/agents/#langchain.agents.AgentState",
             "ModelRequest": "langchain/middleware/#langchain.agents.middleware.ModelRequest",
-            "ModelRequest(response_format)": "langchain/middleware/#langchain.agents.middleware.ModelRequest(response_format)",
             "@dynamic_prompt": "langchain/middleware/#langchain.agents.middleware.dynamic_prompt",
             "@before_model": "langchain/middleware/#langchain.agents.middleware.before_model",
             "@after_model": "langchain/middleware/#langchain.agents.middleware.after_model",
@@ -161,7 +160,7 @@ class LinkMap(TypedDict):
             "AnthropicLLM": "integrations/langchain_anthropic/AnthropicLLM/",
             # Models
             "init_chat_model": "langchain/models/#langchain.chat_models.init_chat_model",
-            "init_chat_model(model_provider)": "langchain/models/#langchain.chat_models.init_chat_model(model_provider)",
+            "init_chat_model(model)": "langchain/models/#langchain.chat_models.init_chat_model(model)",
             "BaseChatModel": "langchain_core/language_models/#langchain_core.language_models.chat_models.BaseChatModel",
             "BaseChatModel.invoke": "langchain_core/language_models/#langchain_core.language_models.chat_models.BaseChatModel.invoke",
             "BaseChatModel.stream": "langchain_core/language_models/#langchain_core.language_models.chat_models.BaseChatModel.stream",

reference/python/docs/langchain/agents.md

@@ -1,3 +1,7 @@
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for Agents. See [the docs](https://docs.langchain.com/oss/python/langchain/agents) for conceptual guides, tutorials, and examples on using Agents.
+
 <!-- Intentionally want to highlight `create_agent` on this page first -->
 <!-- (`group_by_category orders `AgentState` (a class) before functions) -->
 ::: langchain.agents

reference/python/docs/langchain/embeddings.md

@@ -1,3 +1,7 @@
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for Embeddings. See [the docs](https://docs.langchain.com/oss/python/langchain/retrieval#embedding-models) for conceptual guides, tutorials, and examples on using Embeddings.
+
 <!-- Intentionally want to highlight `init_embedding` on this page first -->
 <!-- (`group_by_category orders `Embeddings` (a class) before functions) -->
 ::: langchain.embeddings

reference/python/docs/langchain/messages.md

@@ -1,3 +1,7 @@
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for Messages. See [the docs](https://docs.langchain.com/oss/python/langchain/messages) for conceptual guides, tutorials, and examples on using Messages.
+
 ::: langchain.messages
     options:
       summary: true

reference/python/docs/langchain/middleware.md

@@ -1,9 +1,44 @@
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for Middleware. See [the docs](https://docs.langchain.com/oss/python/langchain/middleware) for conceptual guides, tutorials, and examples on using Middleware.
+
+## Middleware classes
+
+| CLASS | DESCRIPTION |
+| -------------- | ----------- |
+| [`ContextEditingMiddleware`](./#langchain.agents.middleware.ContextEditingMiddleware) | Edit context in agent workflows |
+| [`HumanInTheLoopMiddleware`](./#langchain.agents.middleware.HumanInTheLoopMiddleware) | Enable human intervention in agent processes |
+| [`LLMToolSelectorMiddleware`](./#langchain.agents.middleware.LLMToolSelectorMiddleware) | Select tools using LLM-based logic |
+| [`LLMToolEmulator`](./#langchain.agents.middleware.LLMToolEmulator) | Emulate tool execution using LLM |
+| [`ModelCallLimitMiddleware`](./#langchain.agents.middleware.ModelCallLimitMiddleware) | Limit the number of model calls |
+| [`ModelFallbackMiddleware`](./#langchain.agents.middleware.ModelFallbackMiddleware) | Provide fallback model options |
+| [`PIIMiddleware`](./#langchain.agents.middleware.PIIMiddleware) | Handle personally identifiable information |
+| [`SummarizationMiddleware`](./#langchain.agents.middleware.SummarizationMiddleware) | Summarize content in agent workflows |
+| [`TodoListMiddleware`](./#langchain.agents.middleware.TodoListMiddleware) | Manage TODO lists in agent processes |
+| [`ToolCallLimitMiddleware`](./#langchain.agents.middleware.ToolCallLimitMiddleware) | Limit the number of tool calls |
+| [`AgentMiddleware`](./#langchain.agents.middleware.AgentMiddleware) | Base middleware class for agent operations |
+
+## Components and utilities
+
+The following classes and functions provide the foundation for building and managing agent middleware:
+
+| COMPONENT | DESCRIPTION |
+| -------------- | ----------- |
+| [`AgentState`](./#langchain.agents.middleware.AgentState) | Represent the state of an agent |
+| [`ClearToolUsesEdit`](./#langchain.agents.middleware.ClearToolUsesEdit) | Function to clear tool usage edits |
+| [`InterruptOnConfig`](./#langchain.agents.middleware.InterruptOnConfig) | Configuration class for interruption handling |
+| [`ModelRequest`](./#langchain.agents.middleware.ModelRequest) | Represent a request to a model |
+| [`ModelResponse`](./#langchain.agents.middleware.ModelResponse) | Represent a response from a model |
+| [`before_model`](./#langchain.agents.middleware.before_model) | Function executed before model calls |
+| [`after_model`](./#langchain.agents.middleware.after_model) | Function executed after model calls |
+| [`wrap_model_call`](./#langchain.agents.middleware.wrap_model_call) | Function wrapper for model calls |
+| [`wrap_tool_call`](./#langchain.agents.middleware.wrap_tool_call) | Function wrapper for tool calls |
+
 <!-- `group_by_category false to allow custom ordering -->
+<!-- `summary false since overriding above -->
 ::: langchain.agents.middleware
     options:
-      summary:
-        # <https://mkdocstrings.github.io/python/usage/configuration/members/#summary>
-        classes: true
+      summary: false
       group_by_category: false
       members:
         - ContextEditingMiddleware
@@ -15,7 +50,7 @@
         - PIIMiddleware
         - PIIDetectionError
         - SummarizationMiddleware
-        - TodoListMiddleWare
+        - TodoListMiddleware
         - ToolCallLimitMiddleware
         - AgentMiddleware
         - AgentState
@@ -27,5 +62,4 @@
         - after_model
         - wrap_model_call
         - wrap_tool_call
-        - dynamic-prompt
         - ModelRequest

reference/python/docs/langchain/models.md

@@ -1,5 +1,9 @@
 # Chat models
 
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for chat models. See [the docs](https://docs.langchain.com/oss/python/langchain/models) for conceptual guides, tutorials, and examples on using chat models.
+
 ::: langchain.chat_models
     options:
       parameter_headings: true

reference/python/docs/langchain/tools.md

@@ -1,3 +1,7 @@
+!!! warning "Reference docs"
+
+    This page contains **reference documentation** for Tools. See [the docs](https://docs.langchain.com/oss/python/langchain/tools) for conceptual guides, tutorials, and examples on using Tools.
+
 ::: langchain.tools.tool
 ::: langchain.tools.BaseTool
     options: