langgraph-agent-toolkit 0.10.0__tar.gz → 0.10.2__tar.gz

langgraph_agent_toolkit-0.10.2/.dockerignore

@@ -0,0 +1,28 @@
+# Only dependency manifests and application source enter the build context.
+# Docker sends the selected Dockerfile and this ignore file separately.
+**
+!pyproject.toml
+!uv.lock
+!langgraph_agent_toolkit/
+!langgraph_agent_toolkit/**
+
+# Keep local secrets and generated files out of the application source copy.
+**/.env
+**/.env.*
+**/*.env
+**/*.env.*
+**/.git
+**/.venv
+**/__pycache__
+**/*.py[cod]
+**/.pytest_cache
+**/.ruff_cache
+**/.mypy_cache
+**/.DS_Store
+**/*.log
+**/*.db
+**/*.sqlite
+**/*.sqlite3
+**/*-journal
+**/*-wal
+**/*-shm

{langgraph_agent_toolkit-0.10.0 → langgraph_agent_toolkit-0.10.2}/.env.example

@@ -9,9 +9,11 @@ SKIP_REDIRECTION_LOGGING=true
 ENV_MODE=development
 
 # Use one shared secret for one client deployment.
-# The trusted client application supplies user_id for its own users.
+# 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.
@@ -33,12 +35,26 @@ OBSERVABILITY_SHUTDOWN_TIMEOUT=10
 # Optional current SDK URL alias. It takes precedence over LANGFUSE_HOST.
 # LANGFUSE_BASE_URL=http://langfuse-web:3000
 
+# Compose server image selection. Existing v3 volumes need the migration guide.
+LANGFUSE_SERVER_VERSION=4.71.0
+# API image SDK generation. Use 4 or 3 with an existing Langfuse v3 server.
+LANGFUSE_SDK_MAJOR=5
+
 # LangSmith configuration
 # LANGSMITH_TRACING=true
 # LANGSMITH_API_KEY=
 # LANGSMITH_PROJECT=default
 # LANGSMITH_ENDPOINT=https://api.smith.langchain.com
 
+# Phoenix configuration. Install the `phoenix` extra and select `phoenix` above.
+# Use the base HTTP API URL. The adapter adds `/v1/traces` for OTLP export.
+# PHOENIX_ENDPOINT=http://localhost:6006
+# PHOENIX_PROJECT_NAME=langgraph-agent-toolkit
+# PHOENIX_API_KEY=
+# PHOENIX_TIMEOUT=5
+# Native OpenTelemetry export interval in milliseconds. Phoenix defaults to 1 second.
+# OTEL_BSP_SCHEDULE_DELAY=1000
+
 # Select a memory backend.
 # `postgres` requires the PostgreSQL variables.
 # `sqlite` accepts an optional `SQLITE_DB_PATH` value.
@@ -55,8 +71,8 @@ POSTGRES_PORT=
 POSTGRES_DB=agents
 # Configure the PostgreSQL connection pool.
 # Set `POSTGRES_POOL_SIZE` below the available PostgreSQL connection count.
-# With `max_connections=181`, reserve about 30 connections for administration and monitoring.
-# Total upper bound = workers * (checkpoint pool + lock pool), plus stores/admin.
+# 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
@@ -78,13 +94,17 @@ POSTGRES_MAX_LIFETIME=300.0
 # Set the number of pool-maintenance workers.
 # POSTGRES_NUM_WORKERS=3
 # Set PostgreSQL query timeouts in milliseconds.
-# Set this value above the expected model latency and retry time.
+# This limits each SQL statement, not model generation time.
 POSTGRES_STATEMENT_TIMEOUT=120000
-# Set the maximum lock wait. Concurrent requests for the same `thread_id` wait.
+# Bound SQL lock waits. THREAD_QUEUE_TIMEOUT controls conversation-lock waiting.
 POSTGRES_LOCK_TIMEOUT=45000
-# Set the maximum idle transaction time. Set this value above the expected model latency.
+# 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
@@ -119,13 +139,16 @@ OPENAI_MODEL_NAME=
 # 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
-LLM_HTTP_MAX_CONNECTIONS=100
-LLM_HTTP_MAX_KEEPALIVE_CONNECTIONS=20
-LLM_HTTP_KEEPALIVE_EXPIRY=30.0
-LLM_HTTP_CONNECT_TIMEOUT=10.0
-LLM_HTTP_READ_TIMEOUT=120.0
-LLM_HTTP_WRITE_TIMEOUT=30.0
-LLM_HTTP_POOL_TIMEOUT=10.0
+# 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
@@ -185,6 +208,13 @@ MCP_SERVERS={}
 MCP_AGENT_SERVERS={}
 # Bound total tool discovery time during worker startup, in seconds.
 MCP_DISCOVERY_TIMEOUT=30
+
+# Optional native and Deep Agents tool selection. Keep disabled for small catalogs.
+TOOL_SELECTION={"mode":"off"}
+# TOOL_SELECTION={"mode":"llm","max_tools":8,"model_config_key":"selector"}
+# Configure `selector` in MODEL_CONFIGS. Omit the key to use the main model.
+# Provider search needs a compatible model and API route. See docs/tool_selection.rst.
+# TOOL_SELECTION={"mode":"provider","always_include":["add"]}
 # 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"]}

{langgraph_agent_toolkit-0.10.0 → langgraph_agent_toolkit-0.10.2}/.github/dependabot.yml

@@ -4,7 +4,11 @@ updates:
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "weekly"
+      interval: "monthly"
+      time: "09:00"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
     groups:
       actions-minor-and-patch:
         patterns:
@@ -12,7 +16,7 @@ updates:
         update-types:
           - "minor"
           - "patch"
-    open-pull-requests-limit: 10
+    open-pull-requests-limit: 2
     labels:
       - "dependencies"
       - "github-actions"
@@ -22,8 +26,23 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+      day: "tuesday"
+      time: "09:00"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
+      exclude:
+        - "certifi"
     groups:
-      # Review major upgrades separately. Security updates remain separate.
+      # 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*"
@@ -41,6 +60,8 @@ updates:
         patterns:
           - "langfuse"
           - "langsmith"
+          - "arize-phoenix*"
+          - "openinference*"
           - "opentelemetry*"
         update-types:
           - "minor"
@@ -61,7 +82,7 @@ updates:
         update-types:
           - "minor"
           - "patch"
-    open-pull-requests-limit: 10
+    open-pull-requests-limit: 5
     labels:
       - "dependencies"
       - "python"
@@ -72,6 +93,11 @@ updates:
       - "/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:
@@ -80,21 +106,24 @@ updates:
         update-types:
           - "minor"
           - "patch"
-    open-pull-requests-limit: 5
+    open-pull-requests-limit: 1
     labels:
       - "dependencies"
 
   - package-ecosystem: "pre-commit"
     directory: "/"
     schedule:
-      interval: "weekly"
+      interval: "monthly"
+      time: "09:30"
+      timezone: "Europe/Kyiv"
+    cooldown:
+      default-days: 7
     groups:
-      hooks-minor-and-patch:
+      # Group hook revisions without a semantic-version filter.
+      # Review major tool changes in this PR. CI runs the configured hooks.
+      hooks:
         patterns:
           - "*"
-        update-types:
-          - "minor"
-          - "patch"
-    open-pull-requests-limit: 5
+    open-pull-requests-limit: 1
     labels:
       - "dependencies"

langgraph_agent_toolkit-0.10.2/.github/workflows/langfuse-disposable.yml

@@ -0,0 +1,87 @@
+name: Langfuse disposable E2E
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: langfuse-disposable-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  test-server:
+    name: Server ${{ matrix.server }} with SDK ${{ matrix.sdk }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      max-parallel: 2
+      matrix:
+        include:
+          - server: "4.71.0"
+            sdk: "5.0.4"
+            extra: langfuse-v5
+          - server: "4.71.0"
+            sdk: "4.18.0"
+            extra: langfuse-v4
+          - server: "3.225.15"
+            sdk: "4.18.0"
+            extra: langfuse-v4
+          - server: "3.225.15"
+            sdk: "3.15.0"
+            extra: langfuse-v3
+          - server: "3.225.15"
+            sdk: "2.60.10"
+            extra: langfuse-v2
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          version: "0.13.6"
+      - name: Install the locked SDK and service dependencies
+        run: >-
+          uv sync --frozen --no-install-project --no-default-groups --extra all
+          --extra '${{ matrix.extra }}' --group tests
+      - name: Generate a disposable project
+        env:
+          EXPECTED_LANGFUSE_VERSION: ${{ matrix.sdk }}
+        run: |
+          uv run --no-sync python - <<'PY'
+          import os
+          from importlib.metadata import version
+          assert version("langfuse") == os.environ["EXPECTED_LANGFUSE_VERSION"]
+          PY
+          uv run --no-sync python scripts/ci/langfuse_stack.py prepare \
+            --directory=data/langfuse-ci --server_version='${{ matrix.server }}'
+      - name: Start the isolated server and wait for health checks
+        run: >-
+          uv run --no-sync python scripts/ci/langfuse_stack.py start
+          --directory=data/langfuse-ci
+      - name: Verify stored SDK and API process records
+        run: |
+          set -a
+          source data/langfuse-ci/server.env
+          set +a
+          uv run --no-sync pytest tests/integration/test_langfuse_live.py \
+            tests/e2e/test_langfuse_api.py --run-e2e --run-langfuse \
+            --junitxml=data/langfuse-ci/results.xml -q
+      - name: Collect logs and remove only this test stack
+        if: always()
+        run: >-
+          uv run --no-sync python scripts/ci/langfuse_stack.py stop
+          --directory=data/langfuse-ci
+      - name: Save the test report
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: langfuse-${{ matrix.server }}-sdk-${{ matrix.sdk }}
+          path: data/langfuse-ci/results.xml
+          if-no-files-found: warn
+          retention-days: 14

{langgraph_agent_toolkit-0.10.0 → langgraph_agent_toolkit-0.10.2}/.github/workflows/langfuse-live.yml

@@ -30,11 +30,14 @@ jobs:
             sdk: "3.15.0"
             extra: langfuse-v3
           - server: 3
-            sdk: "4.15.2"
+            sdk: "4.18.0"
             extra: langfuse-v4
           - server: 4
-            sdk: "4.15.2"
+            sdk: "4.18.0"
             extra: langfuse-v4
+          - server: 4
+            sdk: "5.0.4"
+            extra: langfuse-v5
     steps:
       - uses: actions/checkout@v7
         with:
@@ -44,7 +47,7 @@ jobs:
           python-version: "3.12"
       - uses: astral-sh/setup-uv@v10.1.0
         with:
-          version: "0.12.1"
+          version: "0.13.6"
       - name: Install the selected SDK and test dependencies
         run: |
           uv venv .venv-live
@@ -63,3 +66,15 @@ jobs:
           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"
+
+      - name: Verify API worker shutdown and restart
+        if: matrix.server != 2
+        run: >-
+          uv run --no-project --python .venv-live/bin/python python -m pytest
+          tests/e2e/test_langfuse_api.py --run-e2e --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"

langgraph_agent_toolkit-0.10.2/.github/workflows/phoenix-e2e.yml

@@ -0,0 +1,86 @@
+name: Phoenix E2E
+
+on:
+  pull_request:
+    paths:
+      - "langgraph_agent_toolkit/core/observability/**"
+      - "langgraph_agent_toolkit/core/_base_settings.py"
+      - "langgraph_agent_toolkit/agents/agent_executor.py"
+      - "langgraph_agent_toolkit/service/**"
+      - "tests/conftest.py"
+      - "tests/e2e/*phoenix*"
+      - "tests/e2e/api_process.py"
+      - "tests/integration/*phoenix*"
+      - "scripts/ci/phoenix_stack.py"
+      - "pyproject.toml"
+      - "uv.lock"
+      - ".github/workflows/phoenix-e2e.yml"
+  push:
+    branches: ["main"]
+    paths:
+      - "langgraph_agent_toolkit/core/observability/**"
+      - "tests/e2e/*phoenix*"
+      - "tests/integration/*phoenix*"
+      - "scripts/ci/phoenix_stack.py"
+      - "pyproject.toml"
+      - "uv.lock"
+      - ".github/workflows/phoenix-e2e.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: phoenix-e2e-${{ github.event_name }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  test-server:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.13"
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          version: "0.13.6"
+      - name: Install the locked service and Phoenix dependencies
+        run: >-
+          uv sync --frozen --no-install-project --no-default-groups --extra all
+          --group tests
+      - name: Generate and start a disposable Phoenix server
+        run: |
+          uv run --no-sync python scripts/ci/phoenix_stack.py prepare \
+            --directory=data/phoenix-ci --server_version=20.26.1
+          uv run --no-sync python scripts/ci/phoenix_stack.py start \
+            --directory=data/phoenix-ci
+      - name: Verify stored traces, prompts, feedback, and restarts
+        run: |
+          set -a
+          source data/phoenix-ci/server.env
+          set +a
+          uv run --no-sync pytest tests/integration/test_phoenix_live.py \
+            tests/e2e/test_phoenix_api.py --run-e2e --run-phoenix \
+            --no-cov --basetemp=data/phoenix-ci/process-tests \
+            --junitxml=data/phoenix-ci/results.xml -q
+      - name: Collect logs and remove only this test stack
+        if: always()
+        run: >-
+          uv run --no-sync python scripts/ci/phoenix_stack.py stop
+          --directory=data/phoenix-ci
+      - name: Save the test report
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: phoenix-server-20.26.1
+          path: |
+            data/phoenix-ci/results.xml
+            data/phoenix-ci/process-tests/**/api.log
+            data/phoenix-ci/process-tests/**/phoenix-records.json
+            data/phoenix-ci/services.log
+          if-no-files-found: warn
+          retention-days: 14

{langgraph_agent_toolkit-0.10.0 → langgraph_agent_toolkit-0.10.2}/.github/workflows/release.yml

@@ -27,7 +27,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v10.1.0
         with:
-          version: "0.12.1"
+          version: "0.13.6"
           enable-cache: false
 
       - name: Set up Python

{langgraph_agent_toolkit-0.10.0 → langgraph_agent_toolkit-0.10.2}/.github/workflows/sphinx.yml

@@ -39,7 +39,7 @@ jobs:
           python-version: "3.11"
       - uses: astral-sh/setup-uv@v10.1.0
         with:
-          version: "0.12.1"
+          version: "0.13.6"
       - name: Install locked documentation and runtime dependencies
         run:
           uv sync --frozen --no-install-project --no-default-groups --extra all