langgraph-agent-toolkit 0.9.2__tar.gz → 0.10.1__tar.gz

langgraph_agent_toolkit-0.10.1/.coveragerc

@@ -0,0 +1,16 @@
+[run]
+branch = True
+parallel = True
+relative_files = True
+source_pkgs = langgraph_agent_toolkit
+patch = subprocess
+sigterm = True
+omit =
+    examples/*
+    scripts/*
+    tests/*
+
+[report]
+precision = 1
+show_missing = True
+fail_under = 77

{langgraph_agent_toolkit-0.9.2 → langgraph_agent_toolkit-0.10.1}/.dockerignore

@@ -34,8 +34,7 @@ share/python-wheels/
 MANIFEST
 
 # PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+# PyInstaller writes these files from a template before it builds an executable.
 *.manifest
 *.spec
 
@@ -91,17 +90,12 @@ target/
 profile_default/
 ipython_config.py
 
-# pdm
-#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#pdm.lock
-#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
-#   in version control.
-#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+# PDM
 .pdm.toml
 .pdm-python
 .pdm-build/
 
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+# PEP 582
 __pypackages__/
 
 # Celery stuff
@@ -149,10 +143,7 @@ dmypy.json
 cython_debug/
 
 # PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# See https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore for the JetBrains template.
 .idea
 
 # other
@@ -165,8 +156,8 @@ venv
 # langgraph
 .langgraph_api
 
-# Build context trimming — the images only COPY pyproject.toml, uv.lock and
-# langgraph_agent_toolkit/, so exclude everything else from the build context.
+# Docker images copy only `pyproject.toml`, `uv.lock`, and `langgraph_agent_toolkit/`.
+# Exclude all other paths from the build context.
 tests/
 docs/
 scripts/

langgraph_agent_toolkit-0.10.1/.env.example

@@ -0,0 +1,220 @@
+# Set the web server address and port.
+HOST=0.0.0.0
+PORT=8080
+
+# Do not log redirection responses.
+SKIP_REDIRECTION_LOGGING=true
+
+# Set the application mode. `dev` enables Uvicorn reload.
+ENV_MODE=development
+
+# Use one shared secret for one client deployment.
+# user_id is optional. The trusted client can supply it for its own users.
+# The code defaults to trusted mode when AUTH_MODE is unset, as shown below.
+AUTH_MODE=trusted
+AUTH_SECRET=
+# Use this identity when a shared-token request omits user_id.
+AUTH_SERVICE_USER_ID=service
+# Optional: use AUTH_MODE=token when untrusted users connect directly to this API.
+# Then each AUTH_USERS token identifies one user; a supplied user_id must match.
+# AUTH_USERS={"user-1":"replace-with-user-token"}
+# Set a separate server-only secret to enable feedback from token users.
+# Use at least 32 random characters. Do not use a client bearer token.
+# Keep the same value across workers, replicas, and restarts.
+# FEEDBACK_SIGNING_SECRET=
+
+# Select an observability backend.
+# OBSERVABILITY_BACKEND=langfuse
+# Limit how long graceful shutdown waits for a telemetry flush.
+OBSERVABILITY_SHUTDOWN_TIMEOUT=10
+
+# Langfuse configuration
+# LANGFUSE_SECRET_KEY=
+# LANGFUSE_PUBLIC_KEY=
+# LANGFUSE_HOST=http://langfuse-web:3000
+# Optional current SDK URL alias. It takes precedence over LANGFUSE_HOST.
+# LANGFUSE_BASE_URL=http://langfuse-web:3000
+
+# LangSmith configuration
+# LANGSMITH_TRACING=true
+# LANGSMITH_API_KEY=
+# LANGSMITH_PROJECT=default
+# LANGSMITH_ENDPOINT=https://api.smith.langchain.com
+
+# Select a memory backend.
+# `postgres` requires the PostgreSQL variables.
+# `sqlite` accepts an optional `SQLITE_DB_PATH` value.
+MEMORY_BACKEND=postgres
+
+# Set this value when `MEMORY_BACKEND=sqlite`.
+SQLITE_DB_PATH=
+
+# Set these values when `MEMORY_BACKEND=postgres`.
+POSTGRES_USER=
+POSTGRES_PASSWORD=
+POSTGRES_HOST=
+POSTGRES_PORT=
+POSTGRES_DB=agents
+# Configure the PostgreSQL connection pool.
+# Set `POSTGRES_POOL_SIZE` below the available PostgreSQL connection count.
+# Count every worker in every replica. Reserve connections for other services and administration.
+# Total upper bound = total workers * (checkpoint pool + lock pool), plus separately opened stores.
+POSTGRES_POOL_SIZE=20
+POSTGRES_LOCK_POOL_SIZE=10
+POSTGRES_POOL_MAX_WAITING=100
+POSTGRES_MIN_SIZE=2
+POSTGRES_MAX_IDLE=120
+POSTGRES_POOL_TIMEOUT=45.0
+POSTGRES_RECONNECT_TIMEOUT=60.0
+# Bound connection establishment and each health probe in seconds.
+POSTGRES_CONNECT_TIMEOUT=10
+POSTGRES_HEALTH_CHECK_TIMEOUT=5.0
+# TCP liveness settings. Support depends on the operating system.
+POSTGRES_KEEPALIVES_IDLE=30
+POSTGRES_KEEPALIVES_INTERVAL=10
+POSTGRES_KEEPALIVES_COUNT=3
+# Milliseconds; ignored on systems without TCP_USER_TIMEOUT.
+POSTGRES_TCP_USER_TIMEOUT=60000
+# Set the maximum connection lifetime in seconds. The pool replaces older connections.
+POSTGRES_MAX_LIFETIME=300.0
+# Set the number of pool-maintenance workers.
+# POSTGRES_NUM_WORKERS=3
+# Set PostgreSQL query timeouts in milliseconds.
+# This limits each SQL statement, not model generation time.
+POSTGRES_STATEMENT_TIMEOUT=120000
+# Bound SQL lock waits. THREAD_QUEUE_TIMEOUT controls conversation-lock waiting.
+POSTGRES_LOCK_TIMEOUT=45000
+# Bound time spent idle inside a transaction. Normal model calls do not hold a transaction open.
+POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT=120000
+
+# Finish each checkpoint before the next graph step. Database I/O still uses async methods.
+# Use async to overlap saves and graph steps when the larger crash window is acceptable.
+CHECKPOINT_DURABILITY=sync
+
+# Bound conversation waiting, run duration, and request body size.
+THREAD_QUEUE_MAX_WAITERS=32
+THREAD_QUEUE_TIMEOUT=60
+THREAD_LOCK_HEARTBEAT=5
+THREAD_LOCK_HEARTBEAT_TIMEOUT=5
+REQUEST_TIMEOUT=300
+# Mark health probes unhealthy if cancellation cleanup exceeds this many seconds.
+REQUEST_CLEANUP_TIMEOUT=10.0
+# Per worker: reject excess work with HTTP 503 before reading its body.
+REQUEST_MAX_CONCURRENT=8
+REQUEST_QUEUE_MAX_WAITERS=0
+REQUEST_QUEUE_TIMEOUT=1.0
+# Bound each response send, including streaming writes, in seconds.
+RESPONSE_SEND_TIMEOUT=30.0
+REQUEST_MAX_BYTES=20971520
+HISTORY_MAX_PAGE_SIZE=1000
+
+# Set the Streamlit agent URL. The default is `http://{HOST}:{PORT}`.
+# AGENT_URL=http://0.0.0.0:8080
+
+# Use a fake model for tests.
+USE_FAKE_MODEL=false
+
+# OpenAI settings
+OPENAI_API_KEY=
+OPENAI_API_BASE_URL=
+OPENAI_API_VERSION=
+OPENAI_MODEL_NAME=
+
+# Managed OpenAI/Azure connections, per worker and endpoint/credential configuration.
+# The API Docker image installs and selects aiohttp. Python installs default to httpx.
+# Leave the selection unset to use that environment's default.
+# Other installs need the openai-aiohttp extra before selecting aiohttp.
+# LLM_HTTP_ASYNC_TRANSPORT=aiohttp
+# Connection limits, phase timeouts, and retries match OpenAI SDK 3.13.0.
+# REQUEST_TIMEOUT sets the total API run deadline.
+# The aiohttp adapter does not enforce the idle connection count or write timeout.
+LLM_HTTP_MAX_CONNECTIONS=1000
+LLM_HTTP_MAX_KEEPALIVE_CONNECTIONS=100
+LLM_HTTP_KEEPALIVE_EXPIRY=5.0
+LLM_HTTP_CONNECT_TIMEOUT=5.0
+LLM_HTTP_READ_TIMEOUT=600.0
+LLM_HTTP_WRITE_TIMEOUT=600.0
+LLM_HTTP_POOL_TIMEOUT=600.0
+LLM_HTTP_MAX_RETRIES=2
+LLM_HTTP_SHUTDOWN_TIMEOUT=10.0
+LLM_HTTP_MAX_POOLS=32
+
+# Azure OpenAI settings
+AZURE_OPENAI_API_KEY=
+AZURE_OPENAI_ENDPOINT=
+AZURE_OPENAI_API_VERSION=
+AZURE_OPENAI_MODEL_NAME=
+AZURE_OPENAI_DEPLOYMENT_NAME=
+
+# Anthropic settings
+ANTHROPIC_API_KEY=
+ANTHROPIC_MODEL_NAME=
+
+# Google Vertex AI settings
+GOOGLE_VERTEXAI_MODEL_NAME=
+GOOGLE_VERTEXAI_API_KEY=
+
+# Google GenAI settings
+GOOGLE_GENAI_MODEL_NAME=
+GOOGLE_GENAI_API_KEY=
+
+# Bedrock settings
+AWS_BEDROCK_MODEL_NAME=
+
+# DeepSeek settings
+DEEPSEEK_MODEL_NAME=
+DEEPSEEK_API_KEY=
+
+# Ollama settings
+OLLAMA_MODEL_NAME=
+OLLAMA_BASE_URL=
+
+# OpenRouter settings
+OPENROUTER_API_KEY=
+
+# Define model configurations. Use line continuation to improve readability.
+# Use this value to select different models for agents or providers.
+MODEL_CONFIGS={"router":{"provider":"azure_openai","model_name":"gpt-4o","openai_api_key":"your-azure-key-here","azure_endpoint":"https://your-resource.openai.azure.com/","openai_api_version":"2024-12-01-preview","deployment_name":"gpt-4o-deployment"},"assistant":{"provider":"azure_openai","model_name":"gpt-4o-mini","openai_api_key":"your-azure-key-here","azure_endpoint":"https://your-resource.openai.azure.com/","openai_api_version":"2024-12-01-preview","deployment_name":"gpt-4o-mini-deployment"},"analyzer":{"provider":"google_genai","model_name":"gemini-pro","api_key":"your-google-key-here","temperature":0.7}}
+MODEL_CONFIGS_BASE64=
+MODEL_CONFIGS_PATH=
+# Optional Deep Agents blueprint: put its startup model under MODEL_CONFIGS.deep_agent.
+# Example: {"deep_agent":{"provider":"openai","name":"your-model-name"}}
+# Install the deepagents extra and select its AGENT_PATHS entry. See docs/deepagents.rst.
+
+# Set the Amazon Bedrock Knowledge Base ID.
+AWS_KB_ID=
+
+# Detect and resume human-in-the-loop interruptions. The default is `true`.
+# Set this value to `false` if no agent calls `interrupt()`.
+CHECK_INTERRUPTS=
+
+# Install the mcp extra to connect agents to MCP tools. See docs/mcp.rst.
+MCP_SERVERS={}
+# Empty selects all configured servers for the default agent.
+MCP_AGENT_SERVERS={}
+# Bound total tool discovery time during worker startup, in seconds.
+MCP_DISCOVERY_TIMEOUT=30
+# Example: read the full Authorization header from DOCUMENTS_MCP_AUTH.
+# MCP_SERVERS={"docs":{"url":"https://mcp.example.com/mcp","headers_env":{"Authorization":"DOCUMENTS_MCP_AUTH"},"timeout":30,"tool_allowlist":["search"]}}
+# MCP_AGENT_SERVERS={"create-agent":["docs"],"react-agent":["docs"]}
+# DOCUMENTS_MCP_AUTH=
+# For stdio, set transport, command, and args explicitly.
+# MCP_SERVERS={"local":{"transport":"stdio","command":"python","args":["/app/mcp_server.py"]}}
+
+# Set the maximum number of non-text attachments per message. Leave this value empty for no toolkit limit.
+# The model provider still enforces its own model-specific limits.
+MULTIMODAL_MAX_ATTACHMENTS=
+
+# Set defaults for `ClearIntermediateToolCallsMiddleware`.
+# Use `name_args` to collapse identical calls. Use `name` to collapse all calls to a tool.
+# Set the number of recent results to keep for each key in earlier turns.
+CLEAR_INTERMEDIATE_TOOL_CALLS=
+CLEAR_INTERMEDIATE_TOOL_CALLS_BY=
+CLEAR_INTERMEDIATE_TOOL_CALLS_KEEP_LAST_N=
+
+# Opt-in real OpenAI tests. Export these values in the test environment.
+# Tests do not load these values from .env. See docs/live_llm_testing.rst.
+# LAT_TEST_OPENAI_API_KEY=
+# LAT_TEST_OPENAI_MODEL=gpt-5.4
+# LAT_TEST_OPENAI_MODEL_KWARGS={"reasoning_effort":"none"}
+# LAT_TEST_LLM_CHILD is an internal gate set only by the test harness.

langgraph_agent_toolkit-0.10.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Create a report that helps us improve
+title: ""
+labels: "kind/bug, priority/p2"
+assignees: ""
+---
+
+## Describe the issue
+
+Describe the bug. State what happened.
+
+### Expected behavior
+
+State what you expected to happen.
+
+### Reproduction steps
+
+Give the steps that reproduce the issue.
+
+- Step 1
+- Step 2
+
+### Reproducible example
+
+Provide a minimal reproducible example.
+
+```python
+# Add your code.
+```
+
+### Specifications
+
+- Platform:
+- Python Version:
+- Package Version:
+  - `package1_name==x.y.z`
+  - `package2_name==x.y.z`
+
+**Dockerfile (optional):**
+
+```dockerfile
+# Add your Dockerfile.
+```
+
+## Possible solution (optional)
+
+Describe a solution that you considered.

langgraph_agent_toolkit-0.10.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,44 @@
+# PR Description
+
+## Summary
+
+<!-- Explain why the changes are necessary. Keep the summary concise.
+Add relevant links to Jira tickets, Slack discussions, or design documents. -->
+
+## Changes Made
+
+<!-- Describe the changes in this pull request. Explain how the changes solve
+the problem. Add important implementation details. -->
+
+## Checklist
+
+- [ ] I added comments to code that is difficult to understand
+- [ ] I made the related documentation changes
+- [ ] My changes generate no new warnings
+- [ ] I added tests that show that my fix or feature works
+- [ ] Maintainers merged and published all dependent changes in downstream
+      modules
+
+<!-- Optional Sections -->
+<details>
+<summary><strong>Expand for optional sections</strong></summary>
+
+## Screenshots
+
+<!-- If the changes are visual, add screenshots or GIFs. These images help
+reviewers understand the changes. -->
+
+## Related issues
+
+<!-- Add links to related issues or bugs that this pull request addresses. -->
+
+## Testing instructions
+
+<!-- Explain how reviewers can test the changes. -->
+
+## Special notes for your reviewer
+
+<!-- Add specific instructions or important information for the reviewer. -->
+
+</details>
+<!-- End of Optional Sections -->

langgraph_agent_toolkit-0.10.1/.github/RELEASE_TEMPLATE/release-template.md

@@ -0,0 +1,35 @@
+# Release notes template
+
+Review the GitHub diff from the previous release. Use commit titles to create
+the initial outline.
+
+### Upgrade Steps
+
+- List each action that users must take after they update the dependency.
+- Use pseudocode to show required code changes.
+- Tell users to update when older releases have known problems.
+- Leave this section empty when no actions are required.
+
+### Breaking Changes
+
+- List all breaking changes. Leave this section empty when there are none.
+
+### New Features
+
+- Describe the feature and when to use it.
+- Add images when they help the reader.
+- State all limitations, warnings, and beta status.
+
+### Bug Fixes
+
+- List existing features that now work as intended.
+
+### Improvements
+
+- List improvements to workflows, performance, logging, error messages, or user
+  experience.
+
+### Other Changes
+
+- List changes that do not fit the other categories.
+- Leave this section empty when possible.

langgraph_agent_toolkit-0.10.1/.github/codecov.yml

@@ -0,0 +1,25 @@
+codecov:
+  require_ci_to_pass: true
+  notify:
+    # CI uploads one complete report from Python 3.13.
+    after_n_builds: 1
+    wait_for_ci: true
+    notify_error: true
+
+coverage:
+  precision: 1
+  status:
+    # Fail if total coverage falls by more than 2 percentage points.
+    project:
+      default:
+        target: auto
+        threshold: 2%
+        if_not_found: failure
+    # Report patch coverage without enforcing it.
+    patch:
+      default:
+        informational: true
+comment:
+  require_changes: true
+  after_n_builds: 1
+  hide_project_coverage: false

langgraph_agent_toolkit-0.10.1/.github/dependabot.yml

@@ -0,0 +1,125 @@
+version: 2
+
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      time: "09:00"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
+    groups:
+      actions-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+    open-pull-requests-limit: 2
+    labels:
+      - "dependencies"
+      - "github-actions"
+
+  # Use the uv updater to keep pyproject.toml and uv.lock consistent.
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "tuesday"
+      time: "09:00"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
+    groups:
+      # Keep security fixes separate from routine updates.
+      python-security:
+        applies-to: "security-updates"
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+      # Review major upgrades separately.
+      agent-framework:
+        patterns:
+          - "langchain*"
+          - "langgraph*"
+          - "deepagents"
+          - "fastmcp"
+          - "mcp"
+          - "openai"
+          - "anthropic"
+          - "google-genai"
+        update-types:
+          - "minor"
+          - "patch"
+      observability:
+        patterns:
+          - "langfuse"
+          - "langsmith"
+          - "opentelemetry*"
+        update-types:
+          - "minor"
+          - "patch"
+      development-tools:
+        patterns:
+          - "pytest*"
+          - "coverage"
+          - "pre-commit"
+          - "ruff"
+          - "sphinx*"
+        update-types:
+          - "minor"
+          - "patch"
+      python-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python"
+
+  - package-ecosystem: "docker"
+    directories:
+      - "/docker/api"
+      - "/docker/app"
+    schedule:
+      interval: "weekly"
+      day: "tuesday"
+      time: "09:30"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
+    groups:
+      # Keep both application images on the same base image versions.
+      application-images:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+    open-pull-requests-limit: 1
+    labels:
+      - "dependencies"
+
+  - package-ecosystem: "pre-commit"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      time: "09:30"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
+    groups:
+      # Group hook revisions without a semantic-version filter.
+      # Review major tool changes in this PR. CI runs the configured hooks.
+      hooks:
+        patterns:
+          - "*"
+    open-pull-requests-limit: 1
+    labels:
+      - "dependencies"

langgraph_agent_toolkit-0.10.1/.github/scripts/verify_release_tag.py

@@ -0,0 +1,22 @@
+"""Verify that the release tag matches the package version."""
+
+import os
+import tomllib
+from pathlib import Path
+
+
+PYPROJECT_PATH = Path(__file__).resolve().parents[2] / "pyproject.toml"
+
+
+def main() -> None:
+    """Compare RELEASE_TAG with the project version."""
+    with PYPROJECT_PATH.open("rb") as pyproject_file:
+        project_version = tomllib.load(pyproject_file)["project"]["version"]
+
+    release_tag = os.environ["RELEASE_TAG"]
+    if release_tag.removeprefix("v") != project_version:
+        raise SystemExit("The release tag does not match the package version.")
+
+
+if __name__ == "__main__":
+    main()

langgraph_agent_toolkit-0.10.1/.github/workflows/langfuse-live.yml

@@ -0,0 +1,65 @@
+name: Langfuse live server compatibility
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: langfuse-live-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  test-server:
+    name: Server ${{ matrix.server }} with SDK ${{ matrix.sdk }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: langfuse-v${{ matrix.server }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - server: 2
+            sdk: "2.60.10"
+            extra: langfuse-v2
+          - server: 3
+            sdk: "2.60.10"
+            extra: langfuse-v2
+          - server: 3
+            sdk: "3.15.0"
+            extra: langfuse-v3
+          - server: 3
+            sdk: "4.15.2"
+            extra: langfuse-v4
+          - server: 4
+            sdk: "4.15.2"
+            extra: langfuse-v4
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          version: "0.12.1"
+      - name: Install the selected SDK and test dependencies
+        run: |
+          uv venv .venv-live
+          uv pip install --python .venv-live/bin/python \
+            '.[${{ matrix.extra }},openai,deepagents]' 'langfuse==${{ matrix.sdk }}' \
+            pytest pytest-asyncio pytest-env
+          uv pip check --python .venv-live/bin/python
+      - name:
+          Verify prompts, native and Deep Agents traces, subagents, and feedback
+        run: >-
+          uv run --no-project --python .venv-live/bin/python python -m pytest
+          tests/integration/test_langfuse_live.py --run-langfuse -q
+        env:
+          LAT_TEST_LANGFUSE_BASE_URL: ${{ vars.LANGFUSE_TEST_URL }}
+          LAT_TEST_LANGFUSE_SERVER_VERSION: ${{ vars.LANGFUSE_TEST_VERSION }}
+          LAT_TEST_LANGFUSE_PUBLIC_KEY: ${{ secrets.LANGFUSE_TEST_PUBLIC_KEY }}
+          LAT_TEST_LANGFUSE_SECRET_KEY: ${{ secrets.LANGFUSE_TEST_SECRET_KEY }}
+          LAT_TEST_LANGFUSE_TIMEOUT: "180"