kernel 0.70.0__tar.gz → 0.71.0__tar.gz

kernel-0.71.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.71.0"
+}

{kernel-0.70.0 → kernel-0.71.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.71.0 (2026-06-26)
+
+Full Changelog: [v0.70.0...v0.71.0](https://github.com/kernel/kernel-python-sdk/compare/v0.70.0...v0.71.0)
+
+### Features
+
+* Add auth connection event timeline endpoint ([871432f](https://github.com/kernel/kernel-python-sdk/commit/871432f827c95b11d132f60b3547c9986e266f6b))
+* Expose audit logs in public SDK ([9c8e9ac](https://github.com/kernel/kernel-python-sdk/commit/9c8e9ace1cdddc6ce727b38fec62beaba6c6fa20))
+
 ## 0.70.0 (2026-06-24)
 
 Full Changelog: [v0.69.0...v0.70.0](https://github.com/kernel/kernel-python-sdk/compare/v0.69.0...v0.70.0)

{kernel-0.70.0 → kernel-0.71.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.70.0
+Version: 0.71.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk

{kernel-0.70.0 → kernel-0.71.0}/api.md

@@ -300,6 +300,7 @@ from kernel.types.auth import (
     LoginResponse,
     ManagedAuth,
     ManagedAuthCreateRequest,
+    ManagedAuthTimelineEvent,
     ManagedAuthUpdateRequest,
     SubmitFieldsRequest,
     SubmitFieldsResponse,
@@ -317,6 +318,7 @@ Methods:
 - <code title="get /auth/connections/{id}/events">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">follow</a>(id) -> <a href="./src/kernel/types/auth/connection_follow_response.py">ConnectionFollowResponse</a></code>
 - <code title="post /auth/connections/{id}/login">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">login</a>(id, \*\*<a href="src/kernel/types/auth/connection_login_params.py">params</a>) -> <a href="./src/kernel/types/auth/login_response.py">LoginResponse</a></code>
 - <code title="post /auth/connections/{id}/submit">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">submit</a>(id, \*\*<a href="src/kernel/types/auth/connection_submit_params.py">params</a>) -> <a href="./src/kernel/types/auth/submit_fields_response.py">SubmitFieldsResponse</a></code>
+- <code title="get /auth/connections/{id}/timeline">client.auth.connections.<a href="./src/kernel/resources/auth/connections.py">timeline</a>(id, \*\*<a href="src/kernel/types/auth/connection_timeline_params.py">params</a>) -> <a href="./src/kernel/types/auth/managed_auth_timeline_event.py">SyncOffsetPagination[ManagedAuthTimelineEvent]</a></code>
 
 # Proxies
 
@@ -441,6 +443,18 @@ Methods:
 - <code title="get /org/limits">client.organization.limits.<a href="./src/kernel/resources/organization/limits.py">retrieve</a>() -> <a href="./src/kernel/types/organization/org_limits.py">OrgLimits</a></code>
 - <code title="patch /org/limits">client.organization.limits.<a href="./src/kernel/resources/organization/limits.py">update</a>(\*\*<a href="src/kernel/types/organization/limit_update_params.py">params</a>) -> <a href="./src/kernel/types/organization/org_limits.py">OrgLimits</a></code>
 
+# AuditLogs
+
+Types:
+
+```python
+from kernel.types import AuditLogEntry
+```
+
+Methods:
+
+- <code title="get /audit-logs">client.audit_logs.<a href="./src/kernel/resources/audit_logs.py">list</a>(\*\*<a href="src/kernel/types/audit_log_list_params.py">params</a>) -> <a href="./src/kernel/types/audit_log_entry.py">SyncPageTokenPagination[AuditLogEntry]</a></code>
+
 # APIKeys
 
 Types:

{kernel-0.70.0 → kernel-0.71.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.70.0"
+version = "0.71.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{kernel-0.70.0 → kernel-0.71.0}/src/kernel/_client.py

@@ -54,6 +54,7 @@ if TYPE_CHECKING:
         browsers,
         profiles,
         projects,
+        audit_logs,
         extensions,
         credentials,
         deployments,
@@ -67,6 +68,7 @@ if TYPE_CHECKING:
     from .resources.api_keys import APIKeysResource, AsyncAPIKeysResource
     from .resources.profiles import ProfilesResource, AsyncProfilesResource
     from .resources.auth.auth import AuthResource, AsyncAuthResource
+    from .resources.audit_logs import AuditLogsResource, AsyncAuditLogsResource
     from .resources.extensions import ExtensionsResource, AsyncExtensionsResource
     from .resources.credentials import CredentialsResource, AsyncCredentialsResource
     from .resources.deployments import DeploymentsResource, AsyncDeploymentsResource
@@ -275,6 +277,13 @@ class Kernel(SyncAPIClient):
 
         return OrganizationResource(self)
 
+    @cached_property
+    def audit_logs(self) -> AuditLogsResource:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AuditLogsResource
+
+        return AuditLogsResource(self)
+
     @cached_property
     def api_keys(self) -> APIKeysResource:
         """Create and manage API keys for organization and project-scoped access."""
@@ -620,6 +629,13 @@ class AsyncKernel(AsyncAPIClient):
 
         return AsyncOrganizationResource(self)
 
+    @cached_property
+    def audit_logs(self) -> AsyncAuditLogsResource:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AsyncAuditLogsResource
+
+        return AsyncAuditLogsResource(self)
+
     @cached_property
     def api_keys(self) -> AsyncAPIKeysResource:
         """Create and manage API keys for organization and project-scoped access."""
@@ -873,6 +889,13 @@ class KernelWithRawResponse:
 
         return OrganizationResourceWithRawResponse(self._client.organization)
 
+    @cached_property
+    def audit_logs(self) -> audit_logs.AuditLogsResourceWithRawResponse:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AuditLogsResourceWithRawResponse
+
+        return AuditLogsResourceWithRawResponse(self._client.audit_logs)
+
     @cached_property
     def api_keys(self) -> api_keys.APIKeysResourceWithRawResponse:
         """Create and manage API keys for organization and project-scoped access."""
@@ -976,6 +999,13 @@ class AsyncKernelWithRawResponse:
 
         return AsyncOrganizationResourceWithRawResponse(self._client.organization)
 
+    @cached_property
+    def audit_logs(self) -> audit_logs.AsyncAuditLogsResourceWithRawResponse:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AsyncAuditLogsResourceWithRawResponse
+
+        return AsyncAuditLogsResourceWithRawResponse(self._client.audit_logs)
+
     @cached_property
     def api_keys(self) -> api_keys.AsyncAPIKeysResourceWithRawResponse:
         """Create and manage API keys for organization and project-scoped access."""
@@ -1079,6 +1109,13 @@ class KernelWithStreamedResponse:
 
         return OrganizationResourceWithStreamingResponse(self._client.organization)
 
+    @cached_property
+    def audit_logs(self) -> audit_logs.AuditLogsResourceWithStreamingResponse:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AuditLogsResourceWithStreamingResponse
+
+        return AuditLogsResourceWithStreamingResponse(self._client.audit_logs)
+
     @cached_property
     def api_keys(self) -> api_keys.APIKeysResourceWithStreamingResponse:
         """Create and manage API keys for organization and project-scoped access."""
@@ -1182,6 +1219,13 @@ class AsyncKernelWithStreamedResponse:
 
         return AsyncOrganizationResourceWithStreamingResponse(self._client.organization)
 
+    @cached_property
+    def audit_logs(self) -> audit_logs.AsyncAuditLogsResourceWithStreamingResponse:
+        """Read audit log records for the authenticated organization."""
+        from .resources.audit_logs import AsyncAuditLogsResourceWithStreamingResponse
+
+        return AsyncAuditLogsResourceWithStreamingResponse(self._client.audit_logs)
+
     @cached_property
     def api_keys(self) -> api_keys.AsyncAPIKeysResourceWithStreamingResponse:
         """Create and manage API keys for organization and project-scoped access."""

{kernel-0.70.0 → kernel-0.71.0}/src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.70.0"  # x-release-please-version
+__version__ = "0.71.0"  # x-release-please-version

{kernel-0.70.0 → kernel-0.71.0}/src/kernel/pagination.py

@@ -9,13 +9,93 @@ from ._utils import is_mapping, maybe_coerce_boolean, maybe_coerce_integer
 from ._models import BaseModel
 from ._base_client import BasePage, PageInfo, BaseSyncPage, BaseAsyncPage
 
-__all__ = ["SyncOffsetPagination", "AsyncOffsetPagination"]
+__all__ = ["SyncPageTokenPagination", "AsyncPageTokenPagination", "SyncOffsetPagination", "AsyncOffsetPagination"]
 
 _BaseModelT = TypeVar("_BaseModelT", bound=BaseModel)
 
 _T = TypeVar("_T")
 
 
+class SyncPageTokenPagination(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    items: List[_T]
+    next_page_token: Optional[str] = None
+    has_more: Optional[bool] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        items = self.items
+        if not items:
+            return []
+        return items
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page_token = self.next_page_token
+        if not next_page_token:
+            return None
+
+        return PageInfo(params={"page_token": next_page_token})
+
+    @classmethod
+    def build(cls: Type[_BaseModelT], *, response: Response, data: object) -> _BaseModelT:  # noqa: ARG003
+        return cls.construct(
+            None,
+            **{
+                **(cast(Mapping[str, Any], data) if is_mapping(data) else {"items": data}),
+                "next_page_token": response.headers.get("X-Next-Page-Token"),
+                "has_more": maybe_coerce_boolean(response.headers.get("X-Has-More")),
+            },
+        )
+
+
+class AsyncPageTokenPagination(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    items: List[_T]
+    next_page_token: Optional[str] = None
+    has_more: Optional[bool] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        items = self.items
+        if not items:
+            return []
+        return items
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page_token = self.next_page_token
+        if not next_page_token:
+            return None
+
+        return PageInfo(params={"page_token": next_page_token})
+
+    @classmethod
+    def build(cls: Type[_BaseModelT], *, response: Response, data: object) -> _BaseModelT:  # noqa: ARG003
+        return cls.construct(
+            None,
+            **{
+                **(cast(Mapping[str, Any], data) if is_mapping(data) else {"items": data}),
+                "next_page_token": response.headers.get("X-Next-Page-Token"),
+                "has_more": maybe_coerce_boolean(response.headers.get("X-Has-More")),
+            },
+        )
+
+
 class SyncOffsetPagination(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
     items: List[_T]
     has_more: Optional[bool] = None

{kernel-0.70.0 → kernel-0.71.0}/src/kernel/resources/__init__.py

@@ -56,6 +56,14 @@ from .projects import (
     ProjectsResourceWithStreamingResponse,
     AsyncProjectsResourceWithStreamingResponse,
 )
+from .audit_logs import (
+    AuditLogsResource,
+    AsyncAuditLogsResource,
+    AuditLogsResourceWithRawResponse,
+    AsyncAuditLogsResourceWithRawResponse,
+    AuditLogsResourceWithStreamingResponse,
+    AsyncAuditLogsResourceWithStreamingResponse,
+)
 from .extensions import (
     ExtensionsResource,
     AsyncExtensionsResource,
@@ -186,6 +194,12 @@ __all__ = [
     "AsyncOrganizationResourceWithRawResponse",
     "OrganizationResourceWithStreamingResponse",
     "AsyncOrganizationResourceWithStreamingResponse",
+    "AuditLogsResource",
+    "AsyncAuditLogsResource",
+    "AuditLogsResourceWithRawResponse",
+    "AsyncAuditLogsResourceWithRawResponse",
+    "AuditLogsResourceWithStreamingResponse",
+    "AsyncAuditLogsResourceWithStreamingResponse",
     "APIKeysResource",
     "AsyncAPIKeysResource",
     "APIKeysResourceWithRawResponse",

kernel-0.71.0/src/kernel/resources/audit_logs.py

@@ -0,0 +1,269 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from datetime import datetime
+
+import httpx
+
+from ..types import audit_log_list_params
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from .._utils import maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..pagination import SyncPageTokenPagination, AsyncPageTokenPagination
+from .._base_client import AsyncPaginator, make_request_options
+from ..types.audit_log_entry import AuditLogEntry
+
+__all__ = ["AuditLogsResource", "AsyncAuditLogsResource"]
+
+
+class AuditLogsResource(SyncAPIResource):
+    """Read audit log records for the authenticated organization."""
+
+    @cached_property
+    def with_raw_response(self) -> AuditLogsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AuditLogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AuditLogsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return AuditLogsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        end: Union[str, datetime],
+        start: Union[str, datetime],
+        auth_strategy: str | Omit = omit,
+        exclude_method: str | Omit = omit,
+        limit: int | Omit = omit,
+        method: str | Omit = omit,
+        page_token: str | Omit = omit,
+        search: str | Omit = omit,
+        search_user_id: SequenceNotStr[str] | Omit = omit,
+        service: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SyncPageTokenPagination[AuditLogEntry]:
+        """API for searching audit logs.
+
+        Limited to at most 30 day search, returns up to
+        100 records per page. Not recommended for bulk export.
+
+        Args:
+          end: Upper bound (exclusive) for the audit record timestamp.
+
+          start: Lower bound (inclusive) for the audit record timestamp.
+
+          auth_strategy: Filter by authentication strategy.
+
+          exclude_method: Filter out results by HTTP method.
+
+          limit: Maximum number of results to return.
+
+          method: Filter by HTTP method.
+
+          page_token: Opaque page token from X-Next-Page-Token for the next page of older records.
+
+          search: Free-text search over path, user ID, email, client IP, and status.
+
+          search_user_id: Additional user IDs to OR into free-text search.
+
+          service: Filter by service name.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/audit-logs",
+            page=SyncPageTokenPagination[AuditLogEntry],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "end": end,
+                        "start": start,
+                        "auth_strategy": auth_strategy,
+                        "exclude_method": exclude_method,
+                        "limit": limit,
+                        "method": method,
+                        "page_token": page_token,
+                        "search": search,
+                        "search_user_id": search_user_id,
+                        "service": service,
+                    },
+                    audit_log_list_params.AuditLogListParams,
+                ),
+            ),
+            model=AuditLogEntry,
+        )
+
+
+class AsyncAuditLogsResource(AsyncAPIResource):
+    """Read audit log records for the authenticated organization."""
+
+    @cached_property
+    def with_raw_response(self) -> AsyncAuditLogsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncAuditLogsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAuditLogsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return AsyncAuditLogsResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        *,
+        end: Union[str, datetime],
+        start: Union[str, datetime],
+        auth_strategy: str | Omit = omit,
+        exclude_method: str | Omit = omit,
+        limit: int | Omit = omit,
+        method: str | Omit = omit,
+        page_token: str | Omit = omit,
+        search: str | Omit = omit,
+        search_user_id: SequenceNotStr[str] | Omit = omit,
+        service: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncPaginator[AuditLogEntry, AsyncPageTokenPagination[AuditLogEntry]]:
+        """API for searching audit logs.
+
+        Limited to at most 30 day search, returns up to
+        100 records per page. Not recommended for bulk export.
+
+        Args:
+          end: Upper bound (exclusive) for the audit record timestamp.
+
+          start: Lower bound (inclusive) for the audit record timestamp.
+
+          auth_strategy: Filter by authentication strategy.
+
+          exclude_method: Filter out results by HTTP method.
+
+          limit: Maximum number of results to return.
+
+          method: Filter by HTTP method.
+
+          page_token: Opaque page token from X-Next-Page-Token for the next page of older records.
+
+          search: Free-text search over path, user ID, email, client IP, and status.
+
+          search_user_id: Additional user IDs to OR into free-text search.
+
+          service: Filter by service name.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get_api_list(
+            "/audit-logs",
+            page=AsyncPageTokenPagination[AuditLogEntry],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "end": end,
+                        "start": start,
+                        "auth_strategy": auth_strategy,
+                        "exclude_method": exclude_method,
+                        "limit": limit,
+                        "method": method,
+                        "page_token": page_token,
+                        "search": search,
+                        "search_user_id": search_user_id,
+                        "service": service,
+                    },
+                    audit_log_list_params.AuditLogListParams,
+                ),
+            ),
+            model=AuditLogEntry,
+        )
+
+
+class AuditLogsResourceWithRawResponse:
+    def __init__(self, audit_logs: AuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = to_raw_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AsyncAuditLogsResourceWithRawResponse:
+    def __init__(self, audit_logs: AsyncAuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = async_to_raw_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AuditLogsResourceWithStreamingResponse:
+    def __init__(self, audit_logs: AuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = to_streamed_response_wrapper(
+            audit_logs.list,
+        )
+
+
+class AsyncAuditLogsResourceWithStreamingResponse:
+    def __init__(self, audit_logs: AsyncAuditLogsResource) -> None:
+        self._audit_logs = audit_logs
+
+        self.list = async_to_streamed_response_wrapper(
+            audit_logs.list,
+        )