Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.93.0"
".": "0.94.0"
}
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Changelog

## [0.94.0](https://github.com/kernel/kernel-go-sdk/compare/v0.93.0...v0.94.0) (2026-08-21)


### Features

* Mirror the control/platform telemetry split into the public API ([57f9583](https://github.com/kernel/kernel-go-sdk/commit/57f9583e4d57a63513f400599936e891d66e1880))

## [0.93.0](https://github.com/kernel/kernel-go-sdk/compare/v0.92.0...v0.93.0) (2026-08-19)


Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.93.0'
go get -u 'github.com/kernel/kernel-go-sdk@v0.94.0'
```

<!-- x-release-please-end -->
Expand Down
9 changes: 9 additions & 0 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,14 +106,19 @@ Methods:

Params 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#BrowserCdpCommandMethod">BrowserCdpCommandMethod</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#BrowserTelemetryCategoriesConfigParam">BrowserTelemetryCategoriesConfigParam</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#BrowserTelemetryCategoryConfigParam">BrowserTelemetryCategoryConfigParam</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#BrowserTelemetryCdpControlConfigParam">BrowserTelemetryCdpControlConfigParam</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#BrowserTelemetryControlConfigParam">BrowserTelemetryControlConfigParam</a>

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#BrowserAPICallEvent">BrowserAPICallEvent</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#BrowserCallStack">BrowserCallStack</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#BrowserCaptchaSolveResultEvent">BrowserCaptchaSolveResultEvent</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#BrowserCdpCommandEvent">BrowserCdpCommandEvent</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#BrowserCdpCommandMethod">BrowserCdpCommandMethod</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#BrowserCdpConnectEvent">BrowserCdpConnectEvent</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#BrowserCdpDisconnectEvent">BrowserCdpDisconnectEvent</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#BrowserConsoleErrorEvent">BrowserConsoleErrorEvent</a>
Expand All @@ -135,6 +140,7 @@ 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#BrowserNetworkLoadingFailedEvent">BrowserNetworkLoadingFailedEvent</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#BrowserNetworkRequestEvent">BrowserNetworkRequestEvent</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#BrowserNetworkResponseEvent">BrowserNetworkResponseEvent</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#BrowserPageCrashedEvent">BrowserPageCrashedEvent</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#BrowserPageDomContentLoadedEvent">BrowserPageDomContentLoadedEvent</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#BrowserPageLayoutSettledEvent">BrowserPageLayoutSettledEvent</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#BrowserPageLayoutShiftEvent">BrowserPageLayoutShiftEvent</a>
Expand All @@ -143,12 +149,15 @@ 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#BrowserPageNavigationEvent">BrowserPageNavigationEvent</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#BrowserPageNavigationSettledEvent">BrowserPageNavigationSettledEvent</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#BrowserPageTabOpenedEvent">BrowserPageTabOpenedEvent</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#BrowserPlatformAPICallEvent">BrowserPlatformAPICallEvent</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#BrowserProxyErrorEvent">BrowserProxyErrorEvent</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#BrowserServiceCrashedEvent">BrowserServiceCrashedEvent</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#BrowserSystemOomKillEvent">BrowserSystemOomKillEvent</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#BrowserTelemetryCategoriesConfig">BrowserTelemetryCategoriesConfig</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#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#BrowserTelemetryCdpControlConfig">BrowserTelemetryCdpControlConfig</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#BrowserTelemetryControlConfig">BrowserTelemetryControlConfig</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#BrowserTelemetryExportConfig">BrowserTelemetryExportConfig</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#BrowserTelemetryOtlpExportConfig">BrowserTelemetryOtlpExportConfig</a>
Expand Down
122 changes: 61 additions & 61 deletions authconnection.go
Original file line number Diff line number Diff line change
Expand Up @@ -308,34 +308,34 @@ type ManagedAuth struct {
// Machine-readable reason for the current value of `can_reauth`. Affirmative
// values (re-auth is possible):
//
// - `external_credential` — an external credential provider is attached
// - `cua_has_credential` — CUA flow with a stored credential
// - `has_credential` — Kernel credential is attached (optimistic; plan viability
// not checked)
// - `viable_plans_found` — at least one stored login plan can be replayed
// - `no_requirements_recorded` — no recorded credential requirements to fail
// against
// - `requirements_satisfiable` — recorded requirements can be met by the attached
// credential
// - `external_credential` — an external credential provider is attached
// - `cua_has_credential` — CUA flow with a stored credential
// - `has_credential` — Kernel credential is attached (optimistic; plan viability
// not checked)
// - `viable_plans_found` — at least one stored login plan can be replayed
// - `no_requirements_recorded` — no recorded credential requirements to fail
// against
// - `requirements_satisfiable` — recorded requirements can be met by the attached
// credential
//
// Negative values (a human must complete the login flow):
//
// - `no_prior_successful_login` — connection has never completed a successful
// login
// - `no_credential` — no Kernel or external credential attached
// - `no_viable_plans` — credential attached but no replayable login plan exists
// yet
// - `viable_plans_require_external_action` — stored plans need an external step
// (email link, push, etc.)
// - `requires_external_action` — recorded requirements include an external step
// - `requires_totp_without_secret` — flow needs a TOTP code but no TOTP secret is
// stored
// - `requires_sms_code` — flow needs an SMS code that cannot be received
// automatically
// - `requires_email_code` — flow needs an email code that cannot be received
// automatically
// - `requires_customer_input` — flow needs another field or choice that is
// unavailable during unattended re-authentication
// - `no_prior_successful_login` — connection has never completed a successful
// login
// - `no_credential` — no Kernel or external credential attached
// - `no_viable_plans` — credential attached but no replayable login plan exists
// yet
// - `viable_plans_require_external_action` — stored plans need an external step
// (email link, push, etc.)
// - `requires_external_action` — recorded requirements include an external step
// - `requires_totp_without_secret` — flow needs a TOTP code but no TOTP secret is
// stored
// - `requires_sms_code` — flow needs an SMS code that cannot be received
// automatically
// - `requires_email_code` — flow needs an email code that cannot be received
// automatically
// - `requires_customer_input` — flow needs another field or choice that is
// unavailable during unattended re-authentication
//
// Any of "external_credential", "cua_has_credential", "has_credential",
// "viable_plans_found", "no_requirements_recorded", "requirements_satisfiable",
Expand Down Expand Up @@ -508,12 +508,12 @@ type ManagedAuthBrowserTelemetry struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfig `json:"browser"`
// Request shortcut for browser telemetry capture. True enables capture; with no
// browser category settings it captures the default set (control, connection,
Expand Down Expand Up @@ -981,12 +981,12 @@ type ManagedAuthBrowserConfigTelemetry struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfig `json:"browser"`
// Request shortcut for browser telemetry capture. True enables capture; with no
// browser category settings it captures the default set (control, connection,
Expand Down Expand Up @@ -1119,12 +1119,12 @@ type ManagedAuthBrowserConfigTelemetryParam struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfigParam `json:"browser,omitzero"`
// Where to export this session's captured telemetry. Omit to capture without
// exporting.
Expand Down Expand Up @@ -1296,12 +1296,12 @@ type ManagedAuthCreateRequestBrowserTelemetryParam struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfigParam `json:"browser,omitzero"`
// Where to export this session's captured telemetry. Omit to capture without
// exporting.
Expand Down Expand Up @@ -1606,12 +1606,12 @@ type ManagedAuthUpdateRequestBrowserTelemetryParam struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfigParam `json:"browser,omitzero"`
// Where to export this session's captured telemetry. Omit to capture without
// exporting.
Expand Down Expand Up @@ -2303,12 +2303,12 @@ type AuthConnectionLoginParamsBrowserTelemetry struct {
// Per-category capture flags. The operational categories (control, connection,
// system, captcha) are captured whenever telemetry is enabled; set one to
// enabled=false to opt out. The CDP categories (console, network, page,
// interaction) and screenshot are off by default; set enabled=true to opt in. On
// create, provided categories layer onto the default set. On update, provided
// categories merge onto the session's current config; when no telemetry is active
// this falls back to the default set (matching create). If browser is omitted or
// empty, the default set is used. A browser config that disables every category
// stops capture on update and starts no capture on create.
// interaction), screenshot and platform are off by default; set enabled=true to
// opt in. On create, provided categories layer onto the default set. On update,
// provided categories merge onto the session's current config; when no telemetry
// is active this falls back to the default set (matching create). If browser is
// omitted or empty, the default set is used. A browser config that disables every
// category stops capture on update and starts no capture on create.
Browser BrowserTelemetryCategoriesConfigParam `json:"browser,omitzero"`
// Where to export this session's captured telemetry. Omit to capture without
// exporting.
Expand Down
Loading
Loading