ascendkit 0.2.2__tar.gz → 0.2.5__tar.gz

ascendkit-0.2.5/.github/workflows/auto-release.yml

@@ -0,0 +1,13 @@
+name: Auto-release on version bump
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "Use publish.yml for versioned releases."

ascendkit-0.2.5/.github/workflows/publish.yml

@@ -0,0 +1,58 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - pyproject.toml
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish-and-release:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Read version
+        id: version
+        run: echo "value=$(python3 -c 'import pathlib, re; m = re.search(r\"^version\\s*=\\s*\\\"([^\\\"]+)\\\"\", pathlib.Path(\"pyproject.toml\").read_text(), re.M); print(m.group(1))')" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag exists
+        id: tag
+        run: |
+          if git ls-remote --tags origin "refs/tags/v${{ steps.version.outputs.value }}" | grep -q .; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - uses: actions/setup-python@v5
+        if: steps.tag.outputs.exists == 'false'
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        if: steps.tag.outputs.exists == 'false'
+        run: pip install build
+
+      - name: Build package
+        if: steps.tag.outputs.exists == 'false'
+        run: python -m build
+
+      - name: Publish to PyPI (trusted publishing)
+        if: steps.tag.outputs.exists == 'false'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create release
+        if: steps.tag.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "v${{ steps.version.outputs.value }}" \
+            --target main \
+            --title "v${{ steps.version.outputs.value }}" \
+            --generate-notes

{ascendkit-0.2.2 → ascendkit-0.2.5}/CLAUDE.md

@@ -2,24 +2,18 @@
 
 Python 3.10+ SDK. httpx (async), published to PyPI.
 
-## Commands
-```bash
-pip install -e ".[dev]"      # Install editable
-pytest                       # Tests
-ruff check . && ruff format .  # Lint + format
-mypy ascendkit/              # Type checking
-```
-
 ## Rules
 - MUST use `httpx` — not `requests`. Support both sync and async patterns.
 - Logger: drop-in for `logging` module. Keyword args for context: `logger.info("msg", port=3000)`
 - Batch logs (5s / 100 events) via `POST /api/logs/ingest` — NEVER send one-at-a-time
 - Flush on interpreter shutdown via `atexit`
-- Public API through `ascendkit/__init__.py` — internal modules prefixed `_` (e.g., `_client.py`)
-- Typed exceptions (`AscendKitError`, `AuthenticationError`) — NEVER swallow errors
 - All public functions MUST have type annotations
 - Gracefully handle network failures on flush — buffer and retry, NEVER crash host app
 - In async frameworks, use `httpx.AsyncClient` — sync client blocks the event loop
 
+## Release & Publish
+Trigger: GitHub release (`release: published`) → `python -m build` → PyPI trusted publishing (`pypa/gh-action-pypi-publish`)
+To ship: bump `pyproject.toml` version on `dev` → merge to `main` → create GitHub release tagged `vX.Y.Z`
+
 ## GUIDANCE
-You are a thin client, rely on backend api for business logic validation
+You are a thin client, rely on backend api for business logic validation

ascendkit-0.2.5/COMMANDS.md

@@ -0,0 +1,6 @@
+```bash
+pip install -e ".[dev]"            # Install editable
+pytest                             # Tests
+ruff check . && ruff format .      # Lint + format
+mypy ascendkit/                    # Type checking
+```

{ascendkit-0.2.2 → ascendkit-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ascendkit
-Version: 0.2.2
+Version: 0.2.5
 Summary: AscendKit Python SDK
 Project-URL: Homepage, https://ascendkit.dev
 Project-URL: Documentation, https://ascendkit.dev/docs

{ascendkit-0.2.2 → ascendkit-0.2.5}/ascendkit/_client.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import logging
 import os
+import uuid
 from typing import Any
 
 import httpx
@@ -60,23 +61,34 @@ class AscendKit:
     reads ``ASCENDKIT_ENV_KEY`` from the environment.
     """
 
-    def __init__(self, public_key: str | None = None, api_url: str = _DEFAULT_API_URL) -> None:
+    def __init__(
+        self,
+        public_key: str | None = None,
+        api_url: str = _DEFAULT_API_URL,
+        invocation_id: str | None = None,
+    ) -> None:
         resolved_key = public_key or os.environ.get("ASCENDKIT_ENV_KEY")
         if not resolved_key:
             raise ValueError(
                 "AscendKit: missing public key. Pass public_key or set ASCENDKIT_ENV_KEY."
             )
         self.public_key = resolved_key
+        self._invocation_id = invocation_id or str(uuid.uuid4())
         self._client = httpx.Client(
             base_url=api_url,
             headers={
                 "X-AscendKit-Public-Key": resolved_key,
+                "X-AscendKit-Invocation-Id": self._invocation_id,
                 **_VERSION_HEADER,
             },
         )
 
     def _request(self, method: str, path: str, **kwargs: Any) -> Any:
-        response = self._client.request(method, path, **kwargs)
+        per_request_headers = {"X-AscendKit-Client-Request-Id": str(uuid.uuid4())}
+        existing = kwargs.pop("headers", None)
+        if existing:
+            per_request_headers.update(existing)
+        response = self._client.request(method, path, headers=per_request_headers, **kwargs)
         _check_upgrade(response)
         _handle_error(response)
         body = response.json()
@@ -99,23 +111,34 @@ class AsyncAscendKit:
     reads ``ASCENDKIT_ENV_KEY`` from the environment.
     """
 
-    def __init__(self, public_key: str | None = None, api_url: str = _DEFAULT_API_URL) -> None:
+    def __init__(
+        self,
+        public_key: str | None = None,
+        api_url: str = _DEFAULT_API_URL,
+        invocation_id: str | None = None,
+    ) -> None:
         resolved_key = public_key or os.environ.get("ASCENDKIT_ENV_KEY")
         if not resolved_key:
             raise ValueError(
                 "AscendKit: missing public key. Pass public_key or set ASCENDKIT_ENV_KEY."
             )
         self.public_key = resolved_key
+        self._invocation_id = invocation_id or str(uuid.uuid4())
         self._client = httpx.AsyncClient(
             base_url=api_url,
             headers={
                 "X-AscendKit-Public-Key": resolved_key,
+                "X-AscendKit-Invocation-Id": self._invocation_id,
                 **_VERSION_HEADER,
             },
         )
 
     async def _request(self, method: str, path: str, **kwargs: Any) -> Any:
-        response = await self._client.request(method, path, **kwargs)
+        per_request_headers = {"X-AscendKit-Client-Request-Id": str(uuid.uuid4())}
+        existing = kwargs.pop("headers", None)
+        if existing:
+            per_request_headers.update(existing)
+        response = await self._client.request(method, path, headers=per_request_headers, **kwargs)
         _check_upgrade(response)
         _handle_error(response)
         body = response.json()

{ascendkit-0.2.2 → ascendkit-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ascendkit"
-version = "0.2.2"
+version = "0.2.5"
 description = "AscendKit Python SDK"
 license = { text = "MIT" }
 authors = [{ name = "ascendkit.dev" }]

ascendkit-0.2.2/.github/workflows/publish.yml

@@ -1,29 +0,0 @@
-name: Publish to PyPI
-
-on:
-  release:
-    types: [published]
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install build tools
-        run: pip install build
-
-      - name: Build package
-        run: python -m build
-
-      - name: Publish to PyPI (trusted publishing)
-        uses: pypa/gh-action-pypi-publish@release/v1