Skip to content

Adopt kernel-go-sdk v0.72.0; add extensions get + telemetry events; drop pool save_changes#192

Merged
IlyaasK merged 5 commits into
mainfrom
sdk-v0.70.0-adoption
Jun 27, 2026
Merged

Adopt kernel-go-sdk v0.72.0; add extensions get + telemetry events; drop pool save_changes#192
IlyaasK merged 5 commits into
mainfrom
sdk-v0.70.0-adoption

Conversation

@IlyaasK

@IlyaasK IlyaasK commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

What

Adopt kernel-go-sdk v0.72.0 and consume the new surface; also drop save_changes from the browser-pool path now that v0.72.0 ships it.

Changes

  • Bump kernel-go-sdk → v0.72.0. Adapts APIKeyService.Get (now takes APIKeyGetParams).
  • projects get resolves id-or-name server-side (kernel/kernel#2455); drops the client-side list-and-match.
  • New extensions get <id-or-name> — metadata, table + --output json.
  • New browsers telemetry events <id> — paged historical read (--limit/--offset/--since/--until), surfaces the X-Next-Offset cursor.
  • New --replay on browsers telemetry stream (--replay=all, mutually exclusive with --seq).
  • Drop --save-changes from browser-pools create/update. v0.72.0 gives browser pools their own profile type (BrowserPoolProfile, id/name only, no save_changes; kernel/kernel#2484). Replaced buildProfileParam with resolvePoolProfile (same id/name validation, no save_changes), and dropped the save-changes line from the pool profile display. Single-session browsers create keeps --save-changes.

Tests

go build / go vet / go test ./... all pass. Existing pool tests stay green (none referenced pool save_changes).

🤖 Generated with Claude Code


Note

Low Risk
Mostly additive CLI features and SDK signature updates; pool profile change removes a flag users may have relied on for pools only.

Overview
Bumps kernel-go-sdk to v0.72.0 and wires up new SDK APIs plus a few CLI behavior fixes.

New commands: extensions get <id-or-name> (metadata table / JSON) and browsers telemetry events <id> for paged historical telemetry (--limit, --offset, --since, --until), including next_offset from X-Next-Offset in JSON mode. browsers telemetry stream gains --replay=all (replay buffered events from the oldest; exclusive with --seq).

Browser pools: Removes --save-changes on create/update now that pools use id/name-only profiles; resolvePoolProfile replaces buildProfileParam, and pool profile display no longer mentions save changes. Single-session browsers create still supports --save-changes.

SDK alignment: api-keys get passes APIKeyGetParams{}; projects get sends the identifier straight to the API (id or name) instead of client-side list resolution.

README documents the new flags/commands and trims pool profile flag docs.

Reviewed by Cursor Bugbot for commit 89dfaff. Bugbot is set up for automated code reviews on this repo. Configure here.

@socket-security

socket-security Bot commented Jun 26, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updatedgolang/​github.com/​kernel/​kernel-go-sdk@​v0.66.0 ⏵ v0.72.072 +1100100100100

View full report

…rop pool save_changes

- Bump kernel-go-sdk to v0.72.0. Adapts APIKeyService.Get (now takes
  APIKeyGetParams) and the browser-pool profile change in kernel/kernel#2484.
- New `extensions get <id-or-name>`; new `browsers telemetry events <id>`
  (paged historical read with X-Next-Offset); new `--replay` on
  `browsers telemetry stream` (mutually exclusive with --seq).
- Browser pools now have their own profile type (BrowserPoolProfile, id/name
  only, no save_changes; kernel/kernel#2484): drop `--save-changes` from
  `browser-pools create`/`update`, replace buildProfileParam with
  resolvePoolProfile (id/name selection, same validation), and drop the
  save-changes line from the pool profile display. Single-session
  `browsers create` keeps `--save-changes` (unchanged).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@IlyaasK IlyaasK force-pushed the sdk-v0.70.0-adoption branch from f327c67 to d187a2d Compare June 26, 2026 20:11
@IlyaasK IlyaasK changed the title Adopt kernel-go-sdk v0.70.0; add extensions get + telemetry events Adopt kernel-go-sdk v0.72.0; add extensions get + telemetry events; drop pool save_changes Jun 26, 2026

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 3 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit d187a2d. Configure here.

Comment thread cmd/browsers.go Outdated
Comment thread cmd/browsers_telemetry.go
Comment thread cmd/browsers_telemetry.go
@IlyaasK IlyaasK requested review from Sayan- and tnsardesai June 26, 2026 20:16
IlyaasK and others added 4 commits June 26, 2026 16:27
- Use the shared addJSONOutputFlag for `browsers telemetry events` instead of a
  hand-rolled --output flag (consistency with extensions get). [Bugbot]
- Don't send --since/--until when --offset is set: offset is an opaque
  X-Next-Offset cursor that already encodes the query window, so the window
  flags are ignored when paging. Aligns behavior with the flag help and updates
  --until's help to match --since. Added a test. [Bugbot]
- Surface the pagination cursor in JSON mode: `--output json` now emits
  {"events": [...], "next_offset": "..."} so scripted callers can paginate
  (table mode already printed the hint). Updated the empty-JSON test. [Bugbot]
- README: document `extensions get`, `browsers telemetry events`, and the
  `--replay` flag on `telemetry stream`. [review]

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…is ignored)

The SDK/API contract is: when offset is set, since is ignored but until still
bounds the page. The previous commit over-dropped both — restore --until on the
offset path and revert the --until help note. Test asserts since omitted /
until kept under --offset.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…e is ignored)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Per the SDK contract (Events: 'pass X-Next-Offset and repeat while X-Has-More is
true'), gate the next-page cursor on X-Has-More rather than inferring it from a
non-zero X-Next-Offset, which the server may still emit on the terminal page.
Applies to both the JSON next_offset envelope and the table hint.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@Sayan- Sayan- left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lightweight correctness review — build/vet/test green, traced each change against the v0.72.0 SDK types. no correctness bugs.

verified:

  • pool profile rewiring (resolvePoolProfile): Profile is omitzero value struct, ID/Name are param.Opt[string]; unset → omitted, matches old nil guard. no regression on create/update.
  • save_changes removal scoped correctly — dropped only on pool path (new BrowserPoolProfile has no such field); single-session browsers create/update keeps --save-changes.
  • telemetry events: Ts is unix micros → time.UnixMicro correct; union Category/Type/Ts fields valid; zero LastUsedAt → FormatLocal returns -.
  • api-keys get param threading + --replay/--seq mutual exclusion correct.

behavior changes (intentional, acknowledged):

  • --save-changes removed from browser-pools create/update is a breaking CLI flag change — worth a release note.
  • projects get now relies on server-side name resolution (kernel/kernel#2455); confirm that's live in prod to avoid a 404 on version skew.
  • minor: telemetry events --output json doesn't surface the X-Next-Offset cursor (table-only), so scripted consumers can't page — not a regression.

yeet :shipit:

@IlyaasK IlyaasK merged commit b5b726e into main Jun 27, 2026
7 checks passed
@IlyaasK IlyaasK deleted the sdk-v0.70.0-adoption branch June 27, 2026 03:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants