feat: Expose audit logs in public SDK

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 122
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-d9b82fc5346c9be1bf9c2b18792fdcdec6a80a86153ca765c9e93e597b46fa24.yml
-openapi_spec_hash: 9cbaab975acfa421b795d11aa635c57e
-config_hash: 99b2b2a25e8067ad9c9214e38e01d64c
+configured_endpoints: 123
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-784ee80ab17dd58e4b44292a4732d1669263d9928df5685e2683c59398e7a043.yml
+openapi_spec_hash: d34b07cf9549aef3469c82379f526f95
+config_hash: d52b040438a187c46050e0e8395b2f47

api.md

@@ -441,6 +441,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:

src/kernel/_client.py

@@ -54,6 +54,7 @@
         browsers,
         profiles,
         projects,
+        audit_logs,
         extensions,
         credentials,
         deployments,
@@ -67,6 +68,7 @@
     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 @@ def organization(self) -> OrganizationResource:
 
         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 @@ def organization(self) -> AsyncOrganizationResource:
 
         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 @@ def organization(self) -> organization.OrganizationResourceWithRawResponse:
 
         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 @@ def organization(self) -> organization.AsyncOrganizationResourceWithRawResponse:
 
         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 @@ def organization(self) -> organization.OrganizationResourceWithStreamingResponse
 
         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 @@ def organization(self) -> organization.AsyncOrganizationResourceWithStreamingRes
 
         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."""

src/kernel/pagination.py

@@ -9,13 +9,93 @@
 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

src/kernel/resources/__init__.py

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