getzep · mehulp93 · Jul 29, 2026 · Jul 29, 2026 · Jul 29, 2026 · Jul 29, 2026
diff --git a/.github/actions/test-python/action.yml b/.github/actions/test-python/action.yml
@@ -42,7 +42,7 @@ runs:
       working-directory: ${{ steps.paths.outputs.dir }}
       run: |
         uv run ruff check .
-        uv run ruff format --check .
+        uv run ruff format --check --extend-exclude '*.md' .
 
     - name: Run type checking
       shell: bash

diff --git a/integrations/CLAUDE.md b/integrations/CLAUDE.md
@@ -45,6 +45,7 @@ the key, so a new Python package only needs a `paths-filter` entry.
 integrations/<framework>/python/
 ├── src/zep_<framework>/
 │   ├── __init__.py        # package entry point + __version__
+│   ├── py.typed            # PEP 561 marker; required and included in wheel/sdist
 │   ├── <core>.py          # core integration (memory/context/tools)
 │   └── exceptions.py
 ├── tests/                 # mock-client tests (+ optional live tests gated on ZEP_API_KEY)
@@ -168,7 +169,8 @@ go vet ./... && go test ./... && golangci-lint run
 
 Every integration must: pass ruff + mypy (Python) / tsc + lint (TS) / vet + lint (Go);
 ship mock-based tests; include a runnable example; handle errors gracefully (never crash
-the host agent); target the latest Zep SDK; and document all public APIs.
+the host agent); target the latest Zep SDK; and document all public APIs. Published Python
+packages must ship an empty `py.typed` marker in both the wheel and source distribution.
 
 ## Testing pattern (Python, mock client)
 ```python

diff --git a/integrations/adk/python/CHANGELOG.md b/integrations/adk/python/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Added the `py.typed` marker so installed `zep-adk` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## 0.3.0 (2026-07-06)
 
 ### Added

diff --git a/integrations/adk/python/src/zep_adk/py.typed b/integrations/adk/python/src/zep_adk/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/ag2/python/CHANGELOG.md b/integrations/ag2/python/CHANGELOG.md
@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added the `py.typed` marker so installed `zep-ag2` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
+### Fixed
+
+- Restricted AG2 to versions below 1.0, which retain the `autogen` import namespace used by this integration.
+
 ## [0.2.0]
 
 AG2 has no native memory interface -- `ConversableAgent.register_hook` is its only per-turn

diff --git a/integrations/ag2/python/pyproject.toml b/integrations/ag2/python/pyproject.toml
@@ -22,7 +22,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-    "ag2>=0.9.0",
+    "ag2>=0.9.0,<1",
     "zep-cloud>=3.23.0",
 ]
 

diff --git a/integrations/ag2/python/src/zep_ag2/py.typed b/integrations/ag2/python/src/zep_ag2/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/autogen/python/CHANGELOG.md b/integrations/autogen/python/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added the `py.typed` marker so installed `zep-autogen` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## [1.2.0]
 
 ### Added
@@ -86,4 +90,4 @@ memory = ZepUserMemory(client=zep_client, user_id="user-1", thread_id="thread-1"
 - Compatible with AutoGen 0.6.1+
 
 [Unreleased]: https://github.com/getzep/zep/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/getzep/zep/releases/tag/v0.1.0
+[0.1.0]: https://github.com/getzep/zep/releases/tag/v0.1.0
diff --git a/integrations/autogen/python/src/zep_autogen/py.typed b/integrations/autogen/python/src/zep_autogen/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/crewai/python/CHANGELOG.md b/integrations/crewai/python/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added the `py.typed` marker so installed `zep-crewai` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## [1.2.0]
 
 CrewAI 1.x removed its memory extension points (`crewai.memory.storage.interface.Storage`

diff --git a/integrations/crewai/python/src/zep_crewai/py.typed b/integrations/crewai/python/src/zep_crewai/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/langgraph/python/CHANGELOG.md b/integrations/langgraph/python/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Added the `py.typed` marker so installed `zep-langgraph` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## 0.2.0 (2026-07-07)
 
 ### Added

diff --git a/integrations/langgraph/python/src/zep_langgraph/py.typed b/integrations/langgraph/python/src/zep_langgraph/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/livekit/python/CHANGELOG.md b/integrations/livekit/python/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added the `py.typed` marker so installed `zep-livekit` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## [0.2.0] - 2026-07-07
 
 ### Added
@@ -112,4 +116,4 @@ If you depend on the exact old wording (e.g. in a prompt-matching test), pass it
 
 [Unreleased]: https://github.com/getzep/zep/compare/zep-livekit-python-v0.2.0...HEAD
 [0.2.0]: https://github.com/getzep/zep/compare/zep-livekit-python-v0.1.1...zep-livekit-python-v0.2.0
-[0.1.0]: https://github.com/getzep/zep/releases/tag/zep-livekit-v0.1.0
+[0.1.0]: https://github.com/getzep/zep/releases/tag/zep-livekit-v0.1.0
diff --git a/integrations/livekit/python/src/zep_livekit/py.typed b/integrations/livekit/python/src/zep_livekit/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/ms-agent-framework/python/CHANGELOG.md b/integrations/ms-agent-framework/python/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Added the `py.typed` marker so installed `zep-ms-agent-framework` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## 0.2.0 (2026-07-07)
 
 ### Added

diff --git a/integrations/ms-agent-framework/python/src/zep_ms_agent_framework/py.typed b/integrations/ms-agent-framework/python/src/zep_ms_agent_framework/py.typed
@@ -0,0 +1 @@
+
diff --git a/integrations/pydantic-ai/python/CHANGELOG.md b/integrations/pydantic-ai/python/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Added the `py.typed` marker so installed `zep-pydantic-ai` packages expose their inline type annotations to PEP 561-compatible type checkers.
+
 ## 0.2.0 (2026-07-07)
 
 ### Added

diff --git a/integrations/pydantic-ai/python/src/zep_pydantic_ai/py.typed b/integrations/pydantic-ai/python/src/zep_pydantic_ai/py.typed
@@ -0,0 +1 @@
+