Merge branch 'master' into feat/trim_messages-support-approx-alias

Author: eyurtsev

.github/pr-title-labeler.yml

@@ -11,12 +11,9 @@ include-title: true
 label-for-breaking-changes: breaking
 
 label-mapping:
+  documentation: ["docs"]
   feature: ["feat"]
   fix: ["fix"]
-  documentation: ["docs"]
-  linting: ["style"]
-  refactor: ["refactor"]
-  performance: ["perf"]
   infra: ["build", "ci", "chore"]
   integration:
     [
@@ -36,5 +33,9 @@ label-mapping:
       "qdrant",
       "xai",
     ]
-  revert: ["revert"]
+  linting: ["style"]
+  performance: ["perf"]
+  refactor: ["refactor"]
   release: ["release"]
+  revert: ["revert"]
+  tests: ["test"]

docs/README.md

@@ -118,18 +118,13 @@ def example_function(param1: str, param2: int = 5) -> bool:
 
     .. warning::
         This function is experimental and may change.
-
-    .. deprecated:: 0.2.0
-        Use :func:`new_function` instead.
     """
 ```
 
 **Special Markers:**
 
 - `:private:` in docstrings excludes members from documentation
-- `.. deprecated::` creates deprecation notices
 - `.. warning::` adds warning admonitions
-- `.. beta::` (custom directive) marks beta features
 
 #### Site Styling and Assets
 

docs/api_reference/_extensions/gallery_directive.py

@@ -50,7 +50,7 @@ class GalleryGridDirective(SphinxDirective):
     individual cards + ["image", "header", "content", "title"].
 
     Danger:
-        This directive can only be used in the context of a Myst documentation page as
+        This directive can only be used in the context of a MyST documentation page as
         the templates use Markdown flavored formatting.
     """
 

docs/api_reference/conf.py

@@ -126,7 +126,7 @@ def skip_private_members(app, what, name, obj, skip, options):
     "sphinx.ext.viewcode",
     "sphinxcontrib.autodoc_pydantic",
     "IPython.sphinxext.ipython_console_highlighting",
-    "myst_parser",
+    "myst_parser",  # For generated index.md and reference.md
     "_extensions.gallery_directive",
     "sphinx_design",
     "sphinx_copybutton",
@@ -259,20 +259,8 @@ def skip_private_members(app, what, name, obj, skip, options):
 html_css_files = ["css/custom.css"]
 html_use_index = False
 
-myst_enable_extensions = [
-    "colon_fence",  # ::: directive blocks (existing prior to LangGraph support)
-    # LangGraph compatibility extensions added for consolidation
-    # TODO: check for presence of each in LangGraph and only enable if needed
-    # "deflist",  # Definition lists
-    # "tasklist",  # - [ ] checkboxes (common in examples)
-    # "attrs_inline",  # {.class} inline attributes (MkDocs style)
-    # "attrs_block",  # Block-level attributes
-    # "substitution",  # Variable substitution
-    # "linkify",  # Auto-link URLs in text
-    # Math extensions (uncomment if LangGraph uses mathematical notation)
-    # "dollarmath",     # $ math $ inline math
-    # "amsmath",        # Advanced math environments
-]
+# Only used on the generated index.md and reference.md files
+myst_enable_extensions = ["colon_fence"]
 
 # generate autosummary even if no references
 autosummary_generate = True

docs/api_reference/create_api_rst.py

@@ -214,7 +214,7 @@ def _load_package_modules(
     Traversal based on the file system makes it easy to determine which
     of the modules/packages are part of the package vs. 3rd party or built-in.
 
-    Parameters:
+    Args:
         package_directory: Path to the package directory.
         submodule: Optional name of submodule to load.
 

docs/api_reference/requirements.txt

@@ -6,7 +6,7 @@ sphinx-copybutton
 sphinxcontrib-googleanalytics
 pydata-sphinx-theme>=0.15
 myst-parser>=3
-toml>=0.10.2
 myst-nb>=1.1.1
+toml>=0.10.2
 pyyaml
 beautifulsoup4

libs/cli/langchain_cli/integration_template/integration_template/retrievers.py

@@ -46,7 +46,7 @@ class __ModuleName__Retriever(BaseRetriever):
 
             retriever.invoke(query)
 
-        .. code-block:: none
+        .. code-block::
 
             # TODO: Example output.
 
@@ -80,7 +80,7 @@ def format_docs(docs):
 
             chain.invoke("...")
 
-        .. code-block:: none
+        .. code-block::
 
              # TODO: Example output.
 

libs/cli/langchain_cli/integration_template/integration_template/toolkits.py

@@ -42,7 +42,7 @@ class __ModuleName__Toolkit(BaseToolkit):
 
             toolkit.get_tools()
 
-        .. code-block:: none
+        .. code-block::
 
             # TODO: Example output.
 
@@ -62,7 +62,7 @@ class __ModuleName__Toolkit(BaseToolkit):
             for event in events:
                 event["messages"][-1].pretty_print()
 
-        .. code-block:: none
+        .. code-block::
 
              # TODO: Example output.
 

libs/cli/pyproject.toml

@@ -8,7 +8,7 @@ license = { text = "MIT" }
 requires-python = ">=3.10.0,<4.0.0"
 dependencies = [
     "typer>=0.17.0,<1.0.0",
-    "gitpython>=3,<4.0.0",
+    "gitpython>=3.0.0,<4.0.0",
     "langserve[all]>=0.0.51,<1.0.0",
     "uvicorn>=0.23.0,<1.0.0",
     "tomlkit>=0.12.0,<1.0.0",
@@ -30,7 +30,7 @@ langchain-cli = "langchain_cli.cli:app"
 
 [dependency-groups]
 dev = ["pytest>=7.4.2,<9.0.0", "pytest-watcher>=0.3.4,<1.0.0"]
-lint = ["ruff>=0.12.2,<0.13", "mypy>=1.18.1,<1.19"]
+lint = ["ruff>=0.13.1,<0.14", "mypy>=1.18.1,<1.19"]
 test = ["langchain-core", "langchain"]
 typing = ["langchain"]
 test_integration = []
@@ -70,11 +70,14 @@ flake8-annotations.allow-star-arg-any = true
 flake8-annotations.mypy-init-return = true
 flake8-type-checking.runtime-evaluated-base-classes = ["pydantic.BaseModel","langchain_core.load.serializable.Serializable","langchain_core.runnables.base.RunnableSerializable"]
 pep8-naming.classmethod-decorators = [ "classmethod", "langchain_core.utils.pydantic.pre_init", "pydantic.field_validator", "pydantic.v1.root_validator",]
-pydocstyle.convention = "google"
 pyupgrade.keep-runtime-typing = true
 
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+ignore-var-parameters = true  # ignore missing documentation for *args and **kwargs parameters
+
 [tool.ruff.lint.per-file-ignores]
-"tests/**" = [ "D1", "DOC", "S", "SLF",]
+"tests/**" = [ "D1", "S", "SLF",]
 "scripts/**" = [ "INP", "S",]
 
 [tool.pytest.ini_options]