Merge pull request #125 from kernel/release-please--branches--main--changes--next

release: 0.70.0

Author: jarugupj

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.69.0"
+  ".": "0.70.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 120
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-cde481b2f320ce48f83db84ae96226b0e7568146c9387c4fefebf286ecb0dd0a.yml
-openapi_spec_hash: 6bd86d767290fcd7e2a6aae26dff5417
-config_hash: 03c7e57f268c750e2415831662e95969
+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

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.70.0 (2026-06-24)
+
+Full Changelog: [v0.69.0...v0.70.0](https://github.com/kernel/kernel-go-sdk/compare/v0.69.0...v0.70.0)
+
+### Features
+
+* Add GET /browsers/{id}/telemetry/events (read from S2) ([2c3e61e](https://github.com/kernel/kernel-go-sdk/commit/2c3e61ed66a4b8810a0ef33a8abb09555c030a8d))
+* Align browser-pool timeout/viewport/fill-rate contract with implementation; reject save_changes on update ([a986c45](https://github.com/kernel/kernel-go-sdk/commit/a986c453ecee67ebf6b5cf39ecb8e9accbd2c1dc))
+* api: support per-acquire start_url override on browser pool acquire ([1c675a3](https://github.com/kernel/kernel-go-sdk/commit/1c675a387cb712036cea70ac75dac2026276704b))
+* **api:** add GET /extensions/{id_or_name}/metadata ([373f33b](https://github.com/kernel/kernel-go-sdk/commit/373f33b293159fad981ff78770762e07ac80b5ca))
+* **api:** resolve GET /org/projects/{id} by ID or name ([395e0a7](https://github.com/kernel/kernel-go-sdk/commit/395e0a7d43e289a1b4dc187ed2af5a347f0dfc2b))
+* Forward replay param through telemetry stream passthrough ([ae02eeb](https://github.com/kernel/kernel-go-sdk/commit/ae02eeb4d15611a0221ed06a2600f55460e78184))
+
+
+### Bug Fixes
+
+* don't misroute telemetry/events to the browser VM ([95487e0](https://github.com/kernel/kernel-go-sdk/commit/95487e0182fb969bbaa4d44425a688084020d943))
+
 ## 0.69.0 (2026-06-18)
 
 Full Changelog: [v0.68.0...v0.69.0](https://github.com/kernel/kernel-go-sdk/compare/v0.68.0...v0.69.0)

README.md

@@ -28,7 +28,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/kernel/kernel-go-sdk@v0.69.0'
+go get -u 'github.com/kernel/kernel-go-sdk@v0.70.0'
 ```
 
 <!-- x-release-please-end -->

api.md

@@ -141,11 +141,13 @@ Response Types:
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryCategoryConfig">BrowserTelemetryCategoryConfig</a>
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryConfig">BrowserTelemetryConfig</a>
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryEventUnion">BrowserTelemetryEventUnion</a>
+- <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryEventsResponse">BrowserTelemetryEventsResponse</a>
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryStreamResponse">BrowserTelemetryStreamResponse</a>
 
 Methods:
 
-- <code title="get /browsers/{id}/telemetry/stream">client.Browsers.Telemetry.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryService.Stream">Stream</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>, query <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryStreamParams">BrowserTelemetryStreamParams</a>) (\*<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryStreamResponse">BrowserTelemetryStreamResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /browsers/{id}/telemetry/events">client.Browsers.Telemetry.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryService.Events">Events</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>, query <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryEventsParams">BrowserTelemetryEventsParams</a>) (\*<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk/packages/pagination">pagination</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk/packages/pagination#OffsetPagination">OffsetPagination</a>[<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryEventsResponse">BrowserTelemetryEventsResponse</a>], <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /browsers/{id}/telemetry/stream">client.Browsers.Telemetry.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryService.Stream">Stream</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>, params <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryStreamParams">BrowserTelemetryStreamParams</a>) (\*<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#BrowserTelemetryStreamResponse">BrowserTelemetryStreamResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
 ## Replays
 
@@ -317,6 +319,7 @@ Methods:
 Response Types:
 
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionListResponse">ExtensionListResponse</a>
+- <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionGetResponse">ExtensionGetResponse</a>
 - <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionUploadResponse">ExtensionUploadResponse</a>
 
 Methods:
@@ -325,6 +328,7 @@ Methods:
 - <code title="delete /extensions/{id_or_name}">client.Extensions.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, idOrName <a href="https://pkg.go.dev/builtin#string">string</a>) <a href="https://pkg.go.dev/builtin#error">error</a></code>
 - <code title="get /extensions/{id_or_name}">client.Extensions.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionService.Download">Download</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, idOrName <a href="https://pkg.go.dev/builtin#string">string</a>) (\*http.Response, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="get /extensions/from_chrome_store">client.Extensions.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionService.DownloadFromChromeStore">DownloadFromChromeStore</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionDownloadFromChromeStoreParams">ExtensionDownloadFromChromeStoreParams</a>) (\*http.Response, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /extensions/{id_or_name}/metadata">client.Extensions.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, idOrName <a href="https://pkg.go.dev/builtin#string">string</a>) (\*<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionGetResponse">ExtensionGetResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="post /extensions">client.Extensions.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionService.Upload">Upload</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionUploadParams">ExtensionUploadParams</a>) (\*<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk">kernel</a>.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#ExtensionUploadResponse">ExtensionUploadResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
 # BrowserPools

browserpool.go

@@ -198,7 +198,9 @@ type BrowserPoolBrowserPoolConfig struct {
 	ChromePolicy map[string]any `json:"chrome_policy"`
 	// List of browser extensions to load into the session. Provide each by id or name.
 	Extensions []shared.BrowserExtension `json:"extensions"`
-	// Percentage of the pool to fill per minute. Defaults to 10%.
+	// Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+	// most organizations but can be raised per-organization, so only the lower bound
+	// is enforced here.
 	FillRatePerMinute int64 `json:"fill_rate_per_minute"`
 	// If true, launches the browser using a headless image. Defaults to false.
 	Headless bool `json:"headless"`
@@ -224,7 +226,7 @@ type BrowserPoolBrowserPoolConfig struct {
 	// mechanisms.
 	Stealth bool `json:"stealth"`
 	// Default idle timeout in seconds for browsers acquired from this pool before they
-	// are destroyed. Defaults to 600 seconds if not specified
+	// are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 	TimeoutSeconds int64 `json:"timeout_seconds"`
 	// Initial browser window size in pixels with optional refresh rate. If omitted,
 	// image defaults apply (1920x1080@25). For GPU images, the default is
@@ -370,7 +372,9 @@ type BrowserPoolNewParams struct {
 	// your organization's pooled sessions limit (the sum of all pool sizes cannot
 	// exceed your limit).
 	Size int64 `json:"size" api:"required"`
-	// Percentage of the pool to fill per minute. Defaults to 10%.
+	// Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+	// most organizations but can be raised per-organization, so only the lower bound
+	// is enforced here.
 	FillRatePerMinute param.Opt[int64] `json:"fill_rate_per_minute,omitzero"`
 	// If true, launches the browser using a headless image. Defaults to false.
 	Headless param.Opt[bool] `json:"headless,omitzero"`
@@ -392,7 +396,7 @@ type BrowserPoolNewParams struct {
 	// mechanisms.
 	Stealth param.Opt[bool] `json:"stealth,omitzero"`
 	// Default idle timeout in seconds for browsers acquired from this pool before they
-	// are destroyed. Defaults to 600 seconds if not specified
+	// are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 	TimeoutSeconds param.Opt[int64] `json:"timeout_seconds,omitzero"`
 	// Custom Chrome enterprise policy overrides applied to all browsers in this pool.
 	// Keys are Chrome enterprise policy names; values must match their expected types.
@@ -433,7 +437,9 @@ type BrowserPoolUpdateParams struct {
 	// Whether to discard all idle browsers and rebuild the pool immediately. Defaults
 	// to false.
 	DiscardAllIdle param.Opt[bool] `json:"discard_all_idle,omitzero"`
-	// Percentage of the pool to fill per minute. Defaults to 10%.
+	// Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+	// most organizations but can be raised per-organization, so only the lower bound
+	// is enforced here.
 	FillRatePerMinute param.Opt[int64] `json:"fill_rate_per_minute,omitzero"`
 	// If true, launches the browser using a headless image. Defaults to false.
 	Headless param.Opt[bool] `json:"headless,omitzero"`
@@ -459,7 +465,7 @@ type BrowserPoolUpdateParams struct {
 	// mechanisms.
 	Stealth param.Opt[bool] `json:"stealth,omitzero"`
 	// Default idle timeout in seconds for browsers acquired from this pool before they
-	// are destroyed. Defaults to 600 seconds if not specified
+	// are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 	TimeoutSeconds param.Opt[int64] `json:"timeout_seconds,omitzero"`
 	// Custom Chrome enterprise policy overrides applied to all browsers in this pool.
 	// Keys are Chrome enterprise policy names; values must match their expected types.
@@ -539,6 +545,10 @@ type BrowserPoolAcquireParams struct {
 	// project. Applies to this lease only and is cleared when the browser is released
 	// back to the pool.
 	Name param.Opt[string] `json:"name,omitzero"`
+	// Optional URL to navigate the acquired browser to. Overrides the pool's start_url
+	// for this acquire only. Best-effort: failures to navigate do not fail the
+	// acquire.
+	StartURL param.Opt[string] `json:"start_url,omitzero"`
 	// Optional user-defined key-value tags for the acquired browser session, used to
 	// find and group sessions later. Applies to this lease only and are cleared when
 	// the browser is released back to the pool. Up to 50 pairs.

browserpool_test.go

@@ -48,7 +48,7 @@ func TestBrowserPoolNewWithOptionalParams(t *testing.T) {
 		ProxyID:        kernel.String("proxy_id"),
 		StartURL:       kernel.String("https://example.com"),
 		Stealth:        kernel.Bool(true),
-		TimeoutSeconds: kernel.Int(60),
+		TimeoutSeconds: kernel.Int(10),
 		Viewport: shared.BrowserViewportParam{
 			Height:      800,
 			Width:       1280,
@@ -125,7 +125,7 @@ func TestBrowserPoolUpdateWithOptionalParams(t *testing.T) {
 			Size:           kernel.Int(10),
 			StartURL:       kernel.String("https://example.com"),
 			Stealth:        kernel.Bool(true),
-			TimeoutSeconds: kernel.Int(60),
+			TimeoutSeconds: kernel.Int(10),
 			Viewport: shared.BrowserViewportParam{
 				Height:      800,
 				Width:       1280,
@@ -217,6 +217,7 @@ func TestBrowserPoolAcquireWithOptionalParams(t *testing.T) {
 		kernel.BrowserPoolAcquireParams{
 			AcquireTimeoutSeconds: kernel.Int(0),
 			Name:                  kernel.String("checkout-flow-1"),
+			StartURL:              kernel.String("https://example.com"),
 			Tags: kernel.Tags{
 				"team": "backend",
 				"env":  "staging",