Merge branch 'main' into codex/posthog-typing-return-annotations

Author: marandaneto

.github/actions/setup-python-dev/action.yml

@@ -0,0 +1,26 @@
+name: Setup Python dev environment
+description: Set up Python, uv, and dev dependencies for CI checks.
+
+inputs:
+    python-version:
+        description: Python version to install.
+        required: false
+        default: 3.11.11
+
+runs:
+    using: composite
+    steps:
+        - name: Set up Python ${{ inputs.python-version }}
+          uses: actions/setup-python@8d9ed9ac5c53483de85588cdf95a591a75ab9f55
+          with:
+              python-version: ${{ inputs.python-version }}
+
+        - name: Install uv
+          uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+          with:
+              enable-cache: true
+
+        - name: Install dev dependencies
+          shell: bash
+          run: |
+              UV_PROJECT_ENVIRONMENT=$pythonLocation uv sync --extra dev

.github/workflows/call-flags-project-board.yml

@@ -9,7 +9,7 @@ on:
 
 jobs:
     call-flags-project:
-        uses: PostHog/.github/.github/workflows/flags-project-board.yml@d8b55d05dc5150f05c24542a6397ff3ecfbfb56d
+        uses: PostHog/.github/.github/workflows/flags-project-board.yml@69336b569d22687f8982eea6ff7d450a885cda05
         with:
             pr_number: ${{ github.event.pull_request.number }}
             pr_node_id: ${{ github.event.pull_request.node_id }}

.github/workflows/ci.yml

@@ -9,43 +9,83 @@ on:
 permissions:
     contents: read
 
+concurrency:
+    group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+    cancel-in-progress: true
+
 jobs:
-    code-quality:
-        name: Code quality checks
+    ruff-format:
+        name: Ruff format
         runs-on: ubuntu-latest
 
         steps:
             - uses: actions/checkout@85e6279cec87321a52edac9c87bce653a07cf6c2
               with:
                   fetch-depth: 1
 
-            - name: Set up Python 3.11
-              uses: actions/setup-python@8d9ed9ac5c53483de85588cdf95a591a75ab9f55
-              with:
-                  python-version: 3.11.11
-
-            - name: Install uv
-              uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
-              with:
-                  enable-cache: true
-
-            - name: Install dev dependencies
-              shell: bash
-              run: |
-                  UV_PROJECT_ENVIRONMENT=$pythonLocation uv sync --extra dev
+            - name: Set up Python dev environment
+              uses: ./.github/actions/setup-python-dev
 
             - name: Check formatting with ruff
               run: |
                   ruff format --check .
 
+    ruff-lint:
+        name: Ruff lint
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@85e6279cec87321a52edac9c87bce653a07cf6c2
+              with:
+                  fetch-depth: 1
+
+            - name: Set up Python dev environment
+              uses: ./.github/actions/setup-python-dev
+
             - name: Lint with ruff
               run: |
                   ruff check .
 
+    mypy:
+        name: Mypy
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@85e6279cec87321a52edac9c87bce653a07cf6c2
+              with:
+                  fetch-depth: 1
+
+            - name: Set up Python dev environment
+              uses: ./.github/actions/setup-python-dev
+
             - name: Check types with mypy
               run: |
                   mypy --no-site-packages --config-file mypy.ini  . | mypy-baseline filter
 
+    package-build:
+        name: Package build
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@85e6279cec87321a52edac9c87bce653a07cf6c2
+              with:
+                  fetch-depth: 1
+
+            - name: Set up Python 3.11
+              uses: actions/setup-python@8d9ed9ac5c53483de85588cdf95a591a75ab9f55
+              with:
+                  python-version: 3.11.11
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57 # v8.0.0
+              with:
+                  enable-cache: true
+
+            - name: Build and verify distributions
+              run: |
+                  uv build
+                  uv run --with twine twine check dist/*
+
     tests:
         name: Python ${{ matrix.python-version }} tests
         runs-on: ubuntu-latest

CHANGELOG.md

@@ -1,5 +1,53 @@
 # posthog
 
+## 7.19.0 — 2026-06-15
+
+### Minor changes
+
+- [b9f3208](https://github.com/posthog/posthog-python/commit/b9f320808f44832fc3b4cdd6bcf0e0aad194b76d) Add opt-in client-side rate limiting for exception autocapture, using the same token bucket algorithm as the posthog-js and posthog-node SDKs: a bucket per exception type allows a burst of captures, then refills over time. Rate-limited exceptions are skipped before they reach the ingestion queue. Disabled by default; enable with the new `enable_exception_autocapture_rate_limiting` client option and tune via `exception_autocapture_bucket_size` (default 50), `exception_autocapture_refill_rate` (default 10), and `exception_autocapture_refill_interval_seconds` (default 10). — Thanks @hpouillot!
+
+## 7.18.3 — 2026-06-12
+
+### Patch changes
+
+- [ee6a3c8](https://github.com/posthog/posthog-python/commit/ee6a3c8c030cfaacc065765d95991a448d59ad08) Warn when an AI wrapper's `base_url` points at the PostHog AI Gateway. The gateway emits its own `$ai_generation`, so each call would be captured (and billed) twice. The wrapper only warns and never drops the event. Detection covers the wrapper funnels (OpenAI, Anthropic, LangChain) and the OTel span path. — Thanks @richardsolomou!
+
+## 7.18.2 — 2026-06-12
+
+### Patch changes
+
+- [fe76fc9](https://github.com/posthog/posthog-python/commit/fe76fc9a874a3f2f8538ee0d1c4f8a6c66f11c03) Improve mypy coverage for core SDK modules without changing runtime behavior. — Thanks @Kshitijmishradev for your first contribution 🎉!
+
+## 7.18.1 — 2026-06-10
+
+### Patch changes
+
+- [00b2091](https://github.com/posthog/posthog-python/commit/00b2091ea661d3b4e87ccf11f4752f73a1e0d162) Add internal-only routing of `$ai_*` events to a dedicated capture endpoint in their own batch, gated behind the unstable `_dedicated_ai_endpoint` client option (off by default, not for general use). — Thanks @carlos-marchal-ph!
+
+## 7.18.0 — 2026-06-05
+
+### Minor changes
+
+- [a2ce51e](https://github.com/posthog/posthog-python/commit/a2ce51e8a4aad82bb91f152ee8b4236ba5898472) feat(feature-flags): support the `early_exit` condition option in local evaluation. When a flag enables early exit, evaluation now stops and returns `False` as soon as a condition group's property filters match but the rollout percentage excludes the user, instead of falling through to later groups — matching the server-side evaluation behavior. — Thanks @gustavohstrassburger!
+
+## 7.17.0 — 2026-06-03
+
+### Minor changes
+
+- [3aed638](https://github.com/posthog/posthog-python/commit/3aed638ce1a256545f86cf05aa6338a1f2b62a89) Add a configurable `$is_server` event property (default `true`) so PostHog can identify server-side events. Set `is_server=False` when using posthog-python as a client/CLI so the device OS is attributed normally. — Thanks @turnipdabeets for your first contribution 🎉!
+
+## 7.16.4 — 2026-06-03
+
+### Patch changes
+
+- [44e6b14](https://github.com/posthog/posthog-python/commit/44e6b14affd235f523d5a719690cddcb98f0fdde) Fix async streaming responses from the AI wrappers (OpenAI, Anthropic, Gemini) so they support `async with` as well as `async for`. Previously, consuming a stream via `async with` (e.g. with pydantic-ai) raised `TypeError: 'async_generator' object does not support the asynchronous context manager protocol`. — Thanks @turnipdabeets for your first contribution 🎉!
+
+## 7.16.3 — 2026-06-01
+
+### Patch changes
+
+- [643a810](https://github.com/posthog/posthog-python/commit/643a810851719cfdbbdee7d76d1fb87e6ade45aa) Return empty flag defaults from Client flag helpers when the flags API fails. — Thanks @marandaneto!
+
 ## 7.16.2 — 2026-05-28
 
 ### Patch changes

LICENSE

@@ -22,19 +22,19 @@ SOFTWARE.
 
 ---
 
-Some files in this codebase contain code from getsentry/sentry-javascript by Software, Inc. dba Sentry.
+Some files in this codebase contain code from getsentry/sentry-python.
 In such cases it is explicitly stated in the file header. This license only applies to the relevant code in such cases.
 
 MIT License
 
-Copyright (c) 2012 Functional Software, Inc. dba Sentry
+Copyright (c) 2018 Functional Software, Inc. dba Sentry
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
@@ -45,4 +45,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

examples/example-ai-openai-agents/uv.lock

@@ -1,21 +0,0 @@
-posthog/request.py:0: error: Library stubs not installed for "requests"  [import-untyped]
-posthog/request.py:0: note: Hint: "python3 -m pip install types-requests"
-posthog/request.py:0: note: (or run "mypy --install-types" to install all missing stub packages)
-posthog/request.py:0: note: See https://mypy.readthedocs.io/en/stable/running_mypy.html#missing-imports
-posthog/request.py:0: error: Incompatible types in assignment (expression has type "bytes", variable has type "str")  [assignment]
-posthog/consumer.py:0: error: Name "Empty" already defined (possibly by an import)  [no-redef]
-posthog/consumer.py:0: error: Need type annotation for "items" (hint: "items: list[<type>] = ...")  [var-annotated]
-posthog/consumer.py:0: error: Unsupported operand types for <= ("int" and "str")  [operator]
-posthog/consumer.py:0: note: Right operand is of type "int | str"
-posthog/consumer.py:0: error: Unsupported operand types for < ("str" and "int")  [operator]
-posthog/consumer.py:0: note: Left operand is of type "int | str"
-posthog/feature_flags.py:0: error: Unused "type: ignore" comment  [unused-ignore]
-posthog/client.py:0: error: Name "queue" already defined (by an import)  [no-redef]
-posthog/client.py:0: error: Need type annotation for "queue"  [var-annotated]
-posthog/client.py:0: error: Incompatible types in assignment (expression has type "Any | list[Any]", variable has type "None")  [assignment]
-posthog/client.py:0: error: Incompatible types in assignment (expression has type "dict[Any, Any]", variable has type "None")  [assignment]
-posthog/client.py:0: error: "None" has no attribute "__iter__" (not iterable)  [attr-defined]
-posthog/client.py:0: error: Statement is unreachable  [unreachable]
-posthog/client.py:0: error: Statement is unreachable  [unreachable]
-posthog/client.py:0: error: Name "parse_qs" already defined (possibly by an import)  [no-redef]
-posthog/client.py:0: error: Name "urlparse" already defined (possibly by an import)  [no-redef]

examples/example-ai-pydantic-ai/uv.lock

@@ -2,6 +2,7 @@
 python_version = 3.11
 plugins =
     pydantic.mypy
+mypy_path = typings
 strict_optional = True
 no_implicit_optional = True
 warn_unused_ignores = True