langgraph-agent-toolkit 0.1.0__tar.gz

langgraph_agent_toolkit-0.1.0/.coveragerc

@@ -0,0 +1,5 @@
+[run]
+omit =
+    examples/*
+    tests/*
+    langgraph_agent_toolkit/agents/blueprints/*

langgraph_agent_toolkit-0.1.0/.dockerignore

@@ -0,0 +1,166 @@
+# VSCode
+.vscode
+.DS_Store
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+*.pyo
+*.pyd
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+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.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/build/
+docs/source/generated
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+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.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.python-version
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+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.
+.idea
+
+# other
+.git
+.gitignore
+env
+venv
+*.db
+
+# langgraph
+.langgraph_api

langgraph_agent_toolkit-0.1.0/.env.example

@@ -0,0 +1,57 @@
+# Web server configuration
+HOST=0.0.0.0
+PORT=8080
+
+# Application mode. If the value is "dev", it will enable uvicorn reload
+ENV_MODE=development
+
+# Authentication secret, HTTP bearer token header is required if set
+AUTH_SECRET=
+
+# Observability backend
+# OBSERVABILITY_BACKEND=langfuse
+
+# Langfuse configuration
+# LANGFUSE_SECRET_KEY=
+# LANGFUSE_PUBLIC_KEY=
+# LANGFUSE_HOST=http://langfuse-web:3000
+
+# Langsmith configuration
+# LANGSMITH_TRACING=true
+# LANGSMITH_API_KEY=
+# LANGSMITH_PROJECT=default
+# LANGSMITH_ENDPOINT=https://api.smith.langchain.com
+
+# Database type.
+# If the value is "postgres", then it will require Postgresql related environment variables.
+# If the value is "sqlite", then you can configure optional file path via SQLITE_DB_PATH
+MEMORY_BACKEND=postgres
+
+# If DATABASE_TYPE=sqlite (Optional)
+SQLITE_DB_PATH=
+
+# If DATABASE_TYPE=postgres
+POSTGRES_USER=
+POSTGRES_PASSWORD=
+POSTGRES_HOST=
+POSTGRES_PORT=
+POSTGRES_DB=agents
+# Connection pool settings (optional)
+POSTGRES_POOL_SIZE=10
+POSTGRES_MIN_SIZE=3
+POSTGRES_MAX_IDLE=5
+
+# Agent URL: used in Streamlit app - if not set, defaults to http://{HOST}:{PORT}
+# AGENT_URL=http://0.0.0.0:8080
+
+# Use a fake model for testing
+USE_FAKE_MODEL=false
+
+# Set a default model
+DEFAULT_MODEL="openai-compatible"
+
+# If MODEL is set to "openai-compatible", set the following
+# This is just a flexible solution. If you need multiple model options, you still need to add it to models.py
+COMPATIBLE_MODEL=
+COMPATIBLE_API_KEY=
+COMPATIBLE_BASE_URL=http://litellm:4000/v1

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

@@ -0,0 +1,48 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ""
+labels: "kind/bug, priority/p2"
+assignees: ""
+---
+
+## Issue Description
+
+A clear and concise description of what the bug is.
+
+### Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+### Steps to reproduce
+
+Steps to reproduce the behavior:
+
+- Step 1
+- Step 2
+
+### Reproducible Example
+
+Provide a reproducible example.
+
+```python
+# Your code here
+```
+
+### Specifications
+
+- Platform:
+- Python Version:
+- Package Version:
+  - `package1_name==x.y.z`
+  - `package2_name==x.y.z`
+
+**Dockerfile (Optional):**
+
+```dockerfile
+# Your Dockerfile here
+```
+
+## Possible Solution (Optional)
+
+A clear and concise description of the solution you've considered.

langgraph_agent_toolkit-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ""
+labels: "kind/feature"
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.** A clear and
+concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like** A clear and concise description of what you
+want to happen.
+
+**Describe alternatives you've considered** A clear and concise description of
+any alternative solutions or features you've considered.
+
+**Additional context** Add any other context or screenshots about the feature
+request here.

langgraph_agent_toolkit-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,47 @@
+## Summary
+
+<!-- Provide a concise summary "Why are the changes needed"?
+Include any relevant links, such as Jira tickets, Slack discussions,
+or design documents. -->
+
+## Changes Made
+
+<!-- Describe the specific changes that have been made in this pull
+request. Provide details on the approach taken to address the problem
+and any notable implementation details. -->
+
+## Checklist
+
+- [ ] I have added comments to code in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] Any dependent changes have been merged and published in downstream modules
+
+<!-- Optional Sections -->
+<details>
+<summary><strong>Expand for optional sections</strong></summary>
+
+## Screenshots
+
+<!-- If the changes are visual, including screenshots or GIFs can
+help reviewers understand them more easily. -->
+
+## Related issues
+
+<!-- A link to any related issues or bugs that the pull request
+addresses, connecting the code's context with the problem it
+solves. -->
+
+## Testing instructions
+
+<!-- Instructions on how to test the changes made in the pull
+request, helping reviewers validate the code. -->
+
+## Special notes for your reviewer
+
+<!-- If there are any specific instructions or considerations you
+want to highlight for the reviewer, include them in this section. -->
+
+</details>
+<!-- End of Optional Sections -->

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

@@ -0,0 +1,38 @@
+# Release Notes Template
+
+Look through the github diff between the previous release to see what's changed.
+The commit titles should give an outline of what's happened.
+
+### Upgrade Steps
+
+- List out, as concretely as possible, any steps users have to take when they
+  upgrade beyond just dumping the dependency.
+- Write pseudocode that highlights what code should change and how.
+- Call out if users are recommended to upgrade because of known problems with
+  older releases.
+- Preferably, there's nothing here.
+
+### Breaking Changes
+
+- A complete list of breaking changes (preferably there are none, unless this is
+  a major version).
+
+### New Features
+
+- Describe the new feature and when/why to use it. Add some pictures! Call out
+  any caveats/warnings? Is it a beta feature?
+
+### Bug Fixes
+
+- Call out any existing feature/functionality that now works as intended or
+  expected.
+
+### Improvements
+
+- Improvements/enhancements to a workflow, performance, logging, error
+  messaging, or user experience
+
+### Other Changes
+
+- Other miscellaneous changes that don't fit into any of the above categories.
+  Try to leave this empty - ideally, all changes fit into the categories above

langgraph_agent_toolkit-0.1.0/.github/codecov.yml

@@ -0,0 +1,13 @@
+coverage:
+  status:
+    # Fail PRs that reduce total coverage by more than 2%
+    project:
+      default:
+        target: auto
+        threshold: 2%
+    # Treat patch coverage as informational only
+    patch:
+      default:
+        informational: true
+comment:
+  hide_project_coverage: false

langgraph_agent_toolkit-0.1.0/.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "github-actions"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-packages:
+        patterns:
+          - "*"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "python"

langgraph_agent_toolkit-0.1.0/.github/release/tag_from_pyproject.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -e
+
+VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+TAG="v$VERSION"
+
+echo "Tagging current commit with: $TAG"
+git tag $TAG
+git push origin $TAG

langgraph_agent_toolkit-0.1.0/.github/workflows/deploy.yml

@@ -0,0 +1,56 @@
+name: Deploy to Azure
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  test:
+    # Don't try to run deployment in forks and repo copies
+    if: github.repository == 'JoshuaC215/agent-service-toolkit'
+    uses: ./.github/workflows/test.yml
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to container registry
+        uses: docker/login-action@v3
+        with:
+          registry: https://index.docker.io/v1/
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_TOKEN }}
+
+      - name: Build and push agent-service container image to registry
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags:
+            index.docker.io/${{ secrets.DOCKER_USERNAME
+            }}/agent-service-toolkit.service:${{ github.sha }}
+          file: docker/service/Dockerfile
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to Azure Web App
+        id: deploy-to-webapp
+        uses: azure/webapps-deploy@v3
+        with:
+          app-name: "agent-service"
+          slot-name: "production"
+          publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
+          images:
+            "index.docker.io/${{ secrets.DOCKER_USERNAME
+            }}/agent-service-toolkit.service:${{ github.sha }}"

langgraph_agent_toolkit-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Release
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.12"
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Install build dependencies
+        run: |
+          uv sync --all-extras --dev
+          uv pip install build twine
+
+      - name: Build and publish
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          uv run python -m build
+          uv run twine check dist/*
+          uv run twine upload dist/*

langgraph_agent_toolkit-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,147 @@
+name: Build and test
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  test-python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.12"
+      - name: Install dependencies with uv
+        run: |
+          uv sync --all-extras --frozen
+        env:
+          UV_SYSTEM_PYTHON: 1
+      - name: Lint and format with ruff
+        run: |
+          uv run ruff --config pyproject.toml format --check
+          uv run ruff --config pyproject.toml check --output-format github
+
+      - name: Test with pytest
+        run: |
+          uv run pytest --cov=langgraph_agent_toolkit/ --cov-report=xml
+        env:
+          COMPATIBLE_MODEL: ${{ secrets.COMPATIBLE_MODEL }}
+          COMPATIBLE_API_KEY: ${{ secrets.COMPATIBLE_API_KEY }}
+          COMPATIBLE_BASE_URL: ${{ secrets.COMPATIBLE_BASE_URL }}
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+  test-docker:
+    runs-on: ubuntu-latest
+
+    services:
+      dind:
+        image: docker:dind
+        ports:
+          - 2375:2375
+        options: >-
+          --privileged --health-cmd "docker info" --health-interval 10s
+          --health-timeout 5s --health-retries 5
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          driver-opts: network=host
+
+      - name: Build service image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          load: true
+          tags: agent-service-toolkit.service:${{ github.sha }}
+          file: docker/service/Dockerfile
+
+      - name: Build app image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          load: true
+          tags: agent-service-toolkit.app:${{ github.sha }}
+          file: docker/app/Dockerfile
+
+      - name: Start service container
+        run:
+          docker run -d --name service-container --network host -e
+          USE_FAKE_MODEL=true -e PORT=80 agent-service-toolkit.service:${{
+          github.sha }}
+
+      - name: Confirm service starts correctly
+        run: |
+          timeout 30 bash -c '
+            while ! curl -s http://0.0.0.0/health; do
+              echo "Waiting for service to be ready..."
+              docker logs service-container
+              sleep 2
+            done
+          '
+
+      - name: Run app container
+        run:
+          docker run -d --name app-container --network host -e
+          AGENT_URL=http://0.0.0.0 agent-service-toolkit.app:${{ github.sha }}
+
+      - name: Confirm app starts correctly
+        run: |
+          timeout 30 bash -c '
+            while ! curl -s http://localhost:8501/healthz; do
+              echo "Waiting for app to be ready..."
+              docker logs app-container
+              sleep 2
+            done
+          '
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.12"
+      - name: Install ONLY CLIENT dependencies with uv
+        run: |
+          uv sync --frozen --only-group client --only-group dev
+        env:
+          UV_SYSTEM_PYTHON: 1
+      - name: Run integration tests
+        run: |
+          uv run pytest tests/integration -v --run-docker
+        env:
+          AGENT_URL: http://0.0.0.0
+          USE_FAKE_MODEL: true
+
+      - name: Clean up containers
+        if: always()
+        run: |
+          docker stop service-container app-container || true
+          docker rm service-container app-container || true