feat(cli): expose MCP task settings

2026-09-15 14:17:53 +02:00 · 2026-09-13 12:34:14 -07:00
7 changed files with 143 additions and 133 deletions
@@ -7,10 +7,6 @@ on:
    paths:
      - 'docs/**'
      - '.github/workflows/deploy-redirects.yml'
-  # llms.txt is fetched from docs.langchain.com at build time, so redeploy on a
-  # schedule to pick up docs changes that never touch this repo.
-  schedule:
-    - cron: '17 6 * * 1'
  workflow_dispatch:

 permissions:
@@ -12,26 +12,13 @@ which is SEO-friendly and treated similarly to 301 redirects by Google.
 To add new redirects, simply edit redirects.json and re-run this script.
 """

-import http.client
 import json
 import os
-import urllib.error
-import urllib.parse
-import urllib.request
 from pathlib import Path

 # Default fallback URL for any path not in the redirect map
 DEFAULT_REDIRECT = "https://docs.langchain.com/oss/python/langgraph/overview"

-# The docs site regenerates this index on every deploy, so fetching it here
-# keeps the published llms.txt from drifting. The URL is a hardcoded constant,
-# never built from input, and both it and the post-redirect URL are checked
-# against ALLOWED_LLMS_HOST before anything is read.
-CANONICAL_LLMS_URL = "https://docs.langchain.com/oss/python/langgraph/llms.txt"
-ALLOWED_LLMS_HOST = "docs.langchain.com"
-LLMS_FETCH_TIMEOUT = 30
-LLMS_MAX_BYTES = 1_000_000
-
 HTML_TEMPLATE = """<!doctype html>
 <html lang="en">
 <head>
@@ -88,64 +75,6 @@ CATCHALL_404_TEMPLATE = """<!doctype html>
 """


-def is_allowed_llms_url(url):
-    """Return True if url is HTTPS on the one host we accept content from."""
-    parsed = urllib.parse.urlsplit(url)
-    return parsed.scheme == "https" and parsed.hostname == ALLOWED_LLMS_HOST
-
-
-def fetch_canonical_llms_txt():
-    """Return the published LangGraph index, or None if it cannot be used.
-
-    Returning None leaves the caller on the committed docs/llms.txt, so a
-    docs.langchain.com outage degrades to a stale file rather than a broken
-    deploy or a published error page.
-    """
-    if not is_allowed_llms_url(CANONICAL_LLMS_URL):
-        print(f"Refusing to fetch {CANONICAL_LLMS_URL}: host not allowed")
-        return None
-
-    try:
-        with urllib.request.urlopen(  # noqa: S310 - constant, allowlisted URL
-            CANONICAL_LLMS_URL, timeout=LLMS_FETCH_TIMEOUT
-        ) as response:
-            # urlopen follows redirects, so re-check where it actually landed.
-            if not is_allowed_llms_url(response.url):
-                print(f"Refusing {CANONICAL_LLMS_URL}: redirected to {response.url}")
-                return None
-            body = response.read(LLMS_MAX_BYTES + 1)
-    # A connection dropped mid-body raises http.client.IncompleteRead, which
-    # descends from HTTPException rather than OSError, so catching only the
-    # urllib and OS errors would let it escape and fail the whole deploy.
-    except (
-        urllib.error.URLError,
-        http.client.HTTPException,
-        TimeoutError,
-        OSError,
-    ) as exc:
-        print(f"Could not fetch {CANONICAL_LLMS_URL}: {type(exc).__name__}: {exc}")
-        return None
-
-    if len(body) > LLMS_MAX_BYTES:
-        print(f"Refusing {CANONICAL_LLMS_URL}: larger than {LLMS_MAX_BYTES} bytes")
-        return None
-
-    try:
-        text = body.decode("utf-8")
-    except UnicodeDecodeError as exc:
-        print(f"Refusing {CANONICAL_LLMS_URL}: not valid UTF-8: {exc}")
-        return None
-
-    # An index opens with a markdown heading and links to the docs site. A
-    # body that does not is an error page or a truncated response, not content
-    # worth publishing.
-    if not text.startswith("# ") or f"https://{ALLOWED_LLMS_HOST}/" not in text:
-        print(f"Refusing {CANONICAL_LLMS_URL}: does not look like an llms.txt index")
-        return None
-
-    return text
-
-
 def generate_redirects():
    script_dir = Path(__file__).parent
    output_dir = script_dir / "_site"
@@ -197,19 +126,14 @@ def generate_redirects():
    catchall_404.write_text(CATCHALL_404_TEMPLATE.format(default_url=DEFAULT_REDIRECT))
    print(f"Created: {catchall_404}")

-    # llms.txt can't be redirected via HTML, so publish the docs site's own
-    # generated index. The committed copy is only a fallback.
-    llms_txt = fetch_canonical_llms_txt()
-    if llms_txt is not None:
-        (output_dir / "llms.txt").write_text(llms_txt)
-        print(f"Fetched: {output_dir / 'llms.txt'} (from {CANONICAL_LLMS_URL})")
-    else:
-        src = script_dir / "llms.txt"
+    # Copy static files (like llms.txt) that can't be redirected via HTML
+    static_files = ["llms.txt"]
+    for static_file in static_files:
+        src = script_dir / static_file
        if src.exists():
-            (output_dir / "llms.txt").write_text(src.read_text())
-            print(f"Copied: {output_dir / 'llms.txt'} (fallback, may be stale)")
-        else:
-            print("No llms.txt fetched and no committed fallback; skipping")
+            dst = output_dir / static_file
+            dst.write_text(src.read_text())
+            print(f"Copied: {dst}")

    print(f"\nGenerated {len(redirects)} redirect files in {output_dir}")

@@ -1,49 +1,35 @@
-# Docs by LangChain: LangGraph (Python)
+# LangGraph

-> Markdown index of the LangGraph (Python) documentation.
+LangGraph documentation has moved to docs.langchain.com.

-## LangGraph (Python)
+## Overview

- [Memory](https://docs.langchain.com/oss/python/langgraph/add-memory.md)
- [Build a custom RAG agent with LangGraph](https://docs.langchain.com/oss/python/langgraph/agentic-rag.md)
- [Application structure](https://docs.langchain.com/oss/python/langgraph/application-structure.md)
- [Backward compatibility](https://docs.langchain.com/oss/python/langgraph/backward-compatibility.md)
- [Case studies](https://docs.langchain.com/oss/python/langgraph/case-studies.md)
- [Changelog](https://docs.langchain.com/oss/python/langgraph/changelog-js.md)
- [Changelog](https://docs.langchain.com/oss/python/langgraph/changelog-py.md)
- [Checkpointers](https://docs.langchain.com/oss/python/langgraph/checkpointers.md)
- [Choosing between Graph and Functional APIs](https://docs.langchain.com/oss/python/langgraph/choosing-apis.md)
- [Deployment](https://docs.langchain.com/oss/python/langgraph/deploy.md)
- [GRAPH_RECURSION_LIMIT](https://docs.langchain.com/oss/python/langgraph/errors/GRAPH_RECURSION_LIMIT.md)
- [INVALID_CHAT_HISTORY](https://docs.langchain.com/oss/python/langgraph/errors/INVALID_CHAT_HISTORY.md)
- [INVALID_CONCURRENT_GRAPH_UPDATE](https://docs.langchain.com/oss/python/langgraph/errors/INVALID_CONCURRENT_GRAPH_UPDATE.md)
- [INVALID_GRAPH_NODE_RETURN_VALUE](https://docs.langchain.com/oss/python/langgraph/errors/INVALID_GRAPH_NODE_RETURN_VALUE.md)
- [MISSING_CHECKPOINTER](https://docs.langchain.com/oss/python/langgraph/errors/MISSING_CHECKPOINTER.md)
- [MULTIPLE_SUBGRAPHS](https://docs.langchain.com/oss/python/langgraph/errors/MULTIPLE_SUBGRAPHS.md)
- [Event streaming](https://docs.langchain.com/oss/python/langgraph/event-streaming.md)
- [Fault tolerance](https://docs.langchain.com/oss/python/langgraph/fault-tolerance.md)
- [Custom stream channels](https://docs.langchain.com/oss/python/langgraph/frontend/custom-stream-channels.md)
- [Graph execution](https://docs.langchain.com/oss/python/langgraph/frontend/graph-execution.md)
- [Overview](https://docs.langchain.com/oss/python/langgraph/frontend/overview.md)
- [Functional API overview](https://docs.langchain.com/oss/python/langgraph/functional-api.md)
- [Graph API overview](https://docs.langchain.com/oss/python/langgraph/graph-api.md)
- [Install LangGraph](https://docs.langchain.com/oss/python/langgraph/install.md)
- [Interrupts](https://docs.langchain.com/oss/python/langgraph/interrupts.md)
- [Run a local server](https://docs.langchain.com/oss/python/langgraph/local-server.md)
- [LangSmith Observability](https://docs.langchain.com/oss/python/langgraph/observability.md)
- [LangGraph overview](https://docs.langchain.com/oss/python/langgraph/overview.md)
- [Persistence](https://docs.langchain.com/oss/python/langgraph/persistence.md)
- [LangGraph runtime](https://docs.langchain.com/oss/python/langgraph/pregel.md)
- [Quickstart](https://docs.langchain.com/oss/python/langgraph/quickstart.md)
- [Build a custom SQL agent](https://docs.langchain.com/oss/python/langgraph/sql-agent.md)
- [Stores](https://docs.langchain.com/oss/python/langgraph/stores.md)
- [Streaming](https://docs.langchain.com/oss/python/langgraph/streaming.md)
- [LangSmith Studio](https://docs.langchain.com/oss/python/langgraph/studio.md)
- [Test](https://docs.langchain.com/oss/python/langgraph/test.md)
- [Thinking in LangGraph](https://docs.langchain.com/oss/python/langgraph/thinking-in-langgraph.md)
- [Agent Chat UI](https://docs.langchain.com/oss/python/langgraph/ui.md)
- [Use the functional API](https://docs.langchain.com/oss/python/langgraph/use-functional-api.md)
- [Use the graph API](https://docs.langchain.com/oss/python/langgraph/use-graph-api.md)
- [Subgraphs](https://docs.langchain.com/oss/python/langgraph/use-subgraphs.md)
- [Use time-travel](https://docs.langchain.com/oss/python/langgraph/use-time-travel.md)
- [Workflows and agents](https://docs.langchain.com/oss/python/langgraph/workflows-agents.md)
+- [LangGraph Overview](https://docs.langchain.com/oss/python/langgraph/overview): Introduction to LangGraph, a library for building stateful, multi-actor applications with LLMs.
+- [Why LangGraph?](https://docs.langchain.com/oss/python/langgraph/why-langgraph): Motivation for LangGraph and its key features.
+
+## Core Concepts
+
+- [Graph API](https://docs.langchain.com/oss/python/langgraph/graph-api): Learn how to define state, create nodes, and connect them with edges.
+- [Streaming](https://docs.langchain.com/oss/python/langgraph/streaming): Stream outputs from your graph for better UX.
+- [Persistence](https://docs.langchain.com/oss/python/langgraph/persistence): Add memory and checkpointing to your graphs.
+- [Add Memory](https://docs.langchain.com/oss/python/langgraph/add-memory): Implement short-term and long-term memory.
+- [Workflows & Agents](https://docs.langchain.com/oss/python/langgraph/workflows-agents): Build agents and workflows with LangGraph.
+
+## How-To Guides
+
+- [Use Subgraphs](https://docs.langchain.com/oss/python/langgraph/use-subgraphs): Compose graphs using subgraphs.
+- [Observability](https://docs.langchain.com/oss/python/langgraph/observability): Add tracing and debugging to your graphs.
+- [Common Errors](https://docs.langchain.com/oss/python/langgraph/common-errors): Troubleshoot common LangGraph errors.
+
+## Tutorials
+
+- [Agentic RAG](https://docs.langchain.com/oss/python/langgraph/agentic-rag): Build an agentic RAG system with LangGraph.
+- [SQL Agent](https://docs.langchain.com/oss/python/langgraph/sql-agent): Create a SQL agent with LangGraph.
+
+## Reference
+
+- [API Reference](https://reference.langchain.com/python/langgraph/): Complete API documentation for LangGraph.
+
+## LangGraph Platform
+
+For deploying LangGraph applications in production, see the [LangSmith documentation](https://docs.langchain.com/langsmith/agent-server).
@@ -23,6 +23,8 @@ from langgraph_cli.schemas import (
    GraphDef,
    HttpConfig,
    IndexConfig,
+    McpConfig,
+    McpTasksConfig,
    SecurityConfig,
    SerdeConfig,
    StoreConfig,
@@ -115,6 +117,8 @@ def add_descriptions_to_schema(schema, cls):
                AuthConfig,
                SecurityConfig,
                HttpConfig,
+                McpConfig,
+                McpTasksConfig,
                CorsConfig,
                CacheConfig,
                ThreadTTLConfig,
@@ -439,6 +439,24 @@ class ConfigurableHeaderConfig(TypedDict, total=False):
    """


+class McpTasksConfig(TypedDict, total=False):
+    """Settings for authenticated MCP elicitation tasks."""
+
+    poll_interval_ms: int
+    """Suggested client polling interval, in milliseconds. Default 1000; range 100–60000."""
+    ttl_minutes: int
+    """Maximum task lifetime, in minutes. Default 1440; range 1–10080."""
+    completed_grace_seconds: int
+    """Result retention after completion, in seconds. Default 300; range 1–86400."""
+    allow_insecure_urls: bool
+    """Allow HTTP elicitation URLs for development. Defaults to False; production URLs require HTTPS."""
+
+
+class McpConfig(TypedDict, total=False):
+    tasks: McpTasksConfig
+    """Polling, retention and URL settings for the MCP Tasks extension."""
+
+
 class HttpConfig(TypedDict, total=False):
    """Configuration for the built-in HTTP server that powers your deployment's routes and endpoints."""

@@ -473,6 +491,8 @@ class HttpConfig(TypedDict, total=False):

    Default is False.
    """
+    mcp: McpConfig
+    """Optional. Configure the MCP Tasks extension for elicitation over protocol 2026-07-28."""
    disable_a2a: bool
    """Optional. If `True`, /a2a routes are removed, disabling default support to expose the deployment as an agent-to-agent (A2A) server.

@@ -1065,6 +1065,10 @@
          ],
          "description": "Optional. Defines which headers are excluded from logging."
        },
+        "mcp": {
+          "$ref": "#/$defs/McpConfig",
+          "description": "Optional. Configure the MCP Tasks extension for elicitation over protocol 2026-07-28."
+        },
        "middleware_order": {
          "anyOf": [
            {
@@ -1170,6 +1174,42 @@
      },
      "required": []
    },
+    "McpConfig": {
+      "title": "McpConfig",
+      "type": "object",
+      "properties": {
+        "tasks": {
+          "$ref": "#/$defs/McpTasksConfig",
+          "description": "Polling, retention and URL settings for the MCP Tasks extension."
+        }
+      },
+      "required": [],
+      "description": "dict() -> new empty dictionary\ndict(mapping) -> new dictionary initialized from a mapping object's\n    (key, value) pairs\ndict(iterable) -> new dictionary initialized as if via:\n    d = {}\n    for k, v in iterable:\n        d[k] = v\ndict(**kwargs) -> new dictionary initialized with the name=value pairs\n    in the keyword argument list.  For example:  dict(one=1, two=2)"
+    },
+    "McpTasksConfig": {
+      "title": "McpTasksConfig",
+      "description": "Settings for authenticated MCP elicitation tasks.",
+      "type": "object",
+      "properties": {
+        "allow_insecure_urls": {
+          "type": "boolean",
+          "description": "Allow HTTP elicitation URLs for development. Defaults to False; production URLs require HTTPS."
+        },
+        "completed_grace_seconds": {
+          "type": "integer",
+          "description": "Result retention after completion, in seconds. Default 300; range 1\u201386400."
+        },
+        "poll_interval_ms": {
+          "type": "integer",
+          "description": "Suggested client polling interval, in milliseconds. Default 1000; range 100\u201360000."
+        },
+        "ttl_minutes": {
+          "type": "integer",
+          "description": "Maximum task lifetime, in minutes. Default 1440; range 1\u201310080."
+        }
+      },
+      "required": []
+    },
    "UvSource": {
      "title": "UvSource",
      "description": "Deployment source rooted at a uv project or workspace.",
@@ -1065,6 +1065,10 @@
          ],
          "description": "Optional. Defines which headers are excluded from logging."
        },
+        "mcp": {
+          "$ref": "#/$defs/McpConfig",
+          "description": "Optional. Configure the MCP Tasks extension for elicitation over protocol 2026-07-28."
+        },
        "middleware_order": {
          "anyOf": [
            {
@@ -1170,6 +1174,42 @@
      },
      "required": []
    },
+    "McpConfig": {
+      "title": "McpConfig",
+      "type": "object",
+      "properties": {
+        "tasks": {
+          "$ref": "#/$defs/McpTasksConfig",
+          "description": "Polling, retention and URL settings for the MCP Tasks extension."
+        }
+      },
+      "required": [],
+      "description": "dict() -> new empty dictionary\ndict(mapping) -> new dictionary initialized from a mapping object's\n    (key, value) pairs\ndict(iterable) -> new dictionary initialized as if via:\n    d = {}\n    for k, v in iterable:\n        d[k] = v\ndict(**kwargs) -> new dictionary initialized with the name=value pairs\n    in the keyword argument list.  For example:  dict(one=1, two=2)"
+    },
+    "McpTasksConfig": {
+      "title": "McpTasksConfig",
+      "description": "Settings for authenticated MCP elicitation tasks.",
+      "type": "object",
+      "properties": {
+        "allow_insecure_urls": {
+          "type": "boolean",
+          "description": "Allow HTTP elicitation URLs for development. Defaults to False; production URLs require HTTPS."
+        },
+        "completed_grace_seconds": {
+          "type": "integer",
+          "description": "Result retention after completion, in seconds. Default 300; range 1\u201386400."
+        },
+        "poll_interval_ms": {
+          "type": "integer",
+          "description": "Suggested client polling interval, in milliseconds. Default 1000; range 100\u201360000."
+        },
+        "ttl_minutes": {
+          "type": "integer",
+          "description": "Maximum task lifetime, in minutes. Default 1440; range 1\u201310080."
+        }
+      },
+      "required": []
+    },
    "UvSource": {
      "title": "UvSource",
      "description": "Deployment source rooted at a uv project or workspace.",