From a3cae3afd8bc18e3239403b2ff619bca4d31be68 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Fri, 20 Nov 2026 00:16:59 +0000 Subject: [PATCH 1/2] feat: Expose provisional browser cost on detail Stainless-Generated-From: e609f7869b7b3a630d90e745be47feaff98d261d --- api.md | 1 + src/kernel/types/__init__.py | 1 + src/kernel/types/browser_cost.py | 30 +++++++++++++++++++ src/kernel/types/browser_create_response.py | 7 +++++ src/kernel/types/browser_list_response.py | 7 +++++ .../types/browser_pool_acquire_response.py | 7 +++++ src/kernel/types/browser_retrieve_response.py | 7 +++++ src/kernel/types/browser_update_response.py | 7 +++++ .../invocation_list_browsers_response.py | 7 +++++ 9 files changed, 74 insertions(+) create mode 100644 src/kernel/types/browser_cost.py diff --git a/api.md b/api.md index 2c11b4b2..9fa3fbfe 100644 --- a/api.md +++ b/api.md @@ -119,6 +119,7 @@ Types: from kernel.types import ( BrowserAllowlistState, BrowserCaptchaSolver, + BrowserCost, BrowserFingerprint, BrowserLocation, BrowserLocationRequest, diff --git a/src/kernel/types/__init__.py b/src/kernel/types/__init__.py index 5ad9e40f..7f52099e 100644 --- a/src/kernel/types/__init__.py +++ b/src/kernel/types/__init__.py @@ -36,6 +36,7 @@ from .credential import Credential as Credential from .tags_param import TagsParam as TagsParam from .report_type import ReportType as ReportType +from .browser_cost import BrowserCost as BrowserCost from .browser_pool import BrowserPool as BrowserPool from .browser_proxy import BrowserProxy as BrowserProxy from .browser_usage import BrowserUsage as BrowserUsage diff --git a/src/kernel/types/browser_cost.py b/src/kernel/types/browser_cost.py new file mode 100644 index 00000000..e96c0119 --- /dev/null +++ b/src/kernel/types/browser_cost.py @@ -0,0 +1,30 @@ +# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +from typing import Optional +from datetime import datetime +from typing_extensions import Literal + +from .._models import BaseModel + +__all__ = ["BrowserCost"] + + +class BrowserCost(BaseModel): + status: Literal["provisional", "pending", "unavailable"] + """ + Pending means the billing checkpoint or rate calculation is not ready; + unavailable means the session cannot currently be priced safely. + """ + + as_of: Optional[datetime] = None + """Time of the live uptime read or durable billing checkpoint. + + A running or recently deleted session may accrue additional usage. + """ + + estimated_usage_spend_usd: Optional[str] = None + """ + Gross provisional USD browser-meter cost before credits, subscriptions, tax, and + adjustments. Present only with provisional status, including zero for a + completed zero-uptime session. Not an invoice total. + """ diff --git a/src/kernel/types/browser_create_response.py b/src/kernel/types/browser_create_response.py index 8eb731d0..c123e184 100644 --- a/src/kernel/types/browser_create_response.py +++ b/src/kernel/types/browser_create_response.py @@ -7,6 +7,7 @@ from .tags import Tags from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -93,6 +94,12 @@ class BrowserCreateResponse(BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" diff --git a/src/kernel/types/browser_list_response.py b/src/kernel/types/browser_list_response.py index 9ec5de46..9412a243 100644 --- a/src/kernel/types/browser_list_response.py +++ b/src/kernel/types/browser_list_response.py @@ -7,6 +7,7 @@ from .tags import Tags from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -93,6 +94,12 @@ class BrowserListResponse(BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" diff --git a/src/kernel/types/browser_pool_acquire_response.py b/src/kernel/types/browser_pool_acquire_response.py index 4af71fbf..e55e8f2c 100644 --- a/src/kernel/types/browser_pool_acquire_response.py +++ b/src/kernel/types/browser_pool_acquire_response.py @@ -8,6 +8,7 @@ from .._types import NoContentAsNone from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -94,6 +95,12 @@ class BrowserPoolAcquireResponse(NoContentAsNone, BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" diff --git a/src/kernel/types/browser_retrieve_response.py b/src/kernel/types/browser_retrieve_response.py index 8cc17f58..bcf7c91a 100644 --- a/src/kernel/types/browser_retrieve_response.py +++ b/src/kernel/types/browser_retrieve_response.py @@ -7,6 +7,7 @@ from .tags import Tags from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -93,6 +94,12 @@ class BrowserRetrieveResponse(BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" diff --git a/src/kernel/types/browser_update_response.py b/src/kernel/types/browser_update_response.py index d7088207..e6ce6b88 100644 --- a/src/kernel/types/browser_update_response.py +++ b/src/kernel/types/browser_update_response.py @@ -7,6 +7,7 @@ from .tags import Tags from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -93,6 +94,12 @@ class BrowserUpdateResponse(BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" diff --git a/src/kernel/types/invocation_list_browsers_response.py b/src/kernel/types/invocation_list_browsers_response.py index 15204c14..81083be6 100644 --- a/src/kernel/types/invocation_list_browsers_response.py +++ b/src/kernel/types/invocation_list_browsers_response.py @@ -7,6 +7,7 @@ from .tags import Tags from .profile import Profile from .._models import BaseModel +from .browser_cost import BrowserCost from .browser_proxy import BrowserProxy from .browser_usage import BrowserUsage from .browser_memory import BrowserMemory @@ -93,6 +94,12 @@ class Browser(BaseModel): names. """ + cost: Optional[BrowserCost] = None + """Provisional browser-session usage cost on GET detail responses. + + Omitted from list and other browser responses. + """ + deleted_at: Optional[datetime] = None """When the browser session was soft-deleted. Only present for deleted sessions.""" From 996a2686fff3355fb42a53844ad80a9afa9c6d88 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Fri, 20 Nov 2026 00:21:38 +0000 Subject: [PATCH 2/2] release: 0.153.0 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 7 +++++++ pyproject.toml | 2 +- src/kernel/_version.py | 2 +- 4 files changed, 10 insertions(+), 3 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index ddf661b3..e14dc712 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "0.152.0" + ".": "0.153.0" } \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index f51b9ead..6e282dfe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.153.0](https://github.com/kernel/kernel-python-sdk/compare/v0.152.0...v0.153.0) (2026-11-20) + + +### Features + +* Expose provisional browser cost on detail ([a3cae3a](https://github.com/kernel/kernel-python-sdk/commit/a3cae3afd8bc18e3239403b2ff619bca4d31be68)) + ## [0.152.0](https://github.com/kernel/kernel-python-sdk/compare/v0.151.0...v0.152.0) (2026-11-19) diff --git a/pyproject.toml b/pyproject.toml index 0ec74fd1..84b8ffa1 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "kernel" -version = "0.152.0" +version = "0.153.0" description = "The official Python library for the kernel API" dynamic = ["readme"] license = "Apache-2.0" diff --git a/src/kernel/_version.py b/src/kernel/_version.py index 1e3a60cd..364d316f 100644 --- a/src/kernel/_version.py +++ b/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.152.0" # x-release-please-version +__version__ = "0.153.0" # x-release-please-version