Skip to content

CLI: Update Go SDK to 08023260493e4584c4d87638849ab4491b34ec49 - #231

Open
kernel-internal[bot] wants to merge 8 commits into
mainfrom
cli-coverage-update
Open

CLI: Update Go SDK to 08023260493e4584c4d87638849ab4491b34ec49#231
kernel-internal[bot] wants to merge 8 commits into
mainfrom
cli-coverage-update

Conversation

@kernel-internal

@kernel-internal kernel-internal Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

This PR updates the Go SDK dependency to the latest version.

SDK Update

  • Updated kernel-go-sdk to 08023260493e4584c4d87638849ab4491b34ec49 (v0.93.0)

The v0.93.0 release only changed version/changelog metadata relative to the SDK revision this branch was already pinned to (467fea7). api.md and every generated Go source file are byte-identical between the two revisions, so there are no new methods, params, or fields to expose.

Coverage Analysis

A full enumeration of SDK methods and CLI commands was performed. No coverage gaps were found.

  • All 140 SDK methods listed in api.md were enumerated and matched against the CLI command tree (153 leaf commands).
  • Every param struct field was checked against the flags of its corresponding command. Apparent mismatches were verified individually and all resolve to positional args or renamed flags — e.g. BrowserComputerPressKeyParams.Keys--key, BrowserFUploadZipParams.DestPath/ZipFile--dest-dir/--zip, BrowserPoolAcquireParams.AcquireTimeoutSeconds--timeout, BrowserNewParams.Network.PrivateHosts--private-host, AuditLogListParams.SearchUserID--user-id.
  • x-cli-skip: true endpoints in openapi.yaml (/site-configs*, /auth/connections/{id}/exchange) are not present in the SDK and are correctly absent from the CLI.
  • BrowserCurlParams.ResponseEncoding has no flag by design: kernel browsers curl streams raw bytes through the browser HTTP client rather than calling the JSON curl endpoint.

Testing

  • go build ./..., go vet ./..., go test ./... — all pass.
  • Live API smoke tests: browsers list, browsers create --telemetry=all -t 60, browsers get, browsers telemetry events, browsers delete (created and cleaned up), plus auth connections list, profiles list, telemetry destinations list.

Triggered by: kernel/kernel-go-sdk@0802326
Reviewer: @stainless-app[bot]

Bump github.com/kernel/kernel-go-sdk to
v0.91.1-0.20260817203807-0a287359dcc5 (0a28735).

Coverage gap found by enumerating all 140 methods in the SDK's api.md
against the CLI command tree: the new Organization.Entitlements resource
had no CLI surface. Everything else was already covered.

New command:
- `kernel org entitlements get` for client.Organization.Entitlements.Get
  (GET /org/entitlements). Renders Plan, Features, and Limits sections;
  supports --output json.

Null constraint values mean unlimited in this API, and the SDK models
them as non-pointer int64, so rendering keys off respjson field validity
rather than the zero value.

Tested against the real API:
- kernel org entitlements get (table output, ENTERPRISE plan)
- kernel org entitlements get --output json
- kernel org entitlements get --output yaml (rejected as expected)
- go build ./... and go test ./... pass, including 5 new unit tests
  covering populated constraints, null-as-unlimited, null plan fields,
  invalid --output, and API errors.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@socket-security

socket-security Bot commented Aug 17, 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.92.0 ⏵ v0.93.072 +1100100100100

View full report

Updates github.com/kernel/kernel-go-sdk from
v0.91.1-0.20260817203807-0a287359dcc5 to v0.92.0.

## Coverage Analysis

Diffing the two module sources shows the SDK API surface is byte-identical
between these versions -- the only changes are release metadata
(.release-please-manifest.json, CHANGELOG.md, README.md, internal/version.go).

A full enumeration was still performed:
- All 140 SDK methods in api.md have corresponding CLI commands.
- The 4 x-cli-skip endpoints (/site-configs/lookup, /site-configs/resolve,
  /site-configs/analyses/{id}, /auth/connections/{id}/exchange) are absent
  from the SDK surface, so nothing to skip.
- All params struct fields are covered by CLI flags except three, each
  intentional:
  - AuthConnectionLoginParams.BrowserTelemetry -- deprecated in favor of
    browser.telemetry, which the CLI already uses via ManagedAuthBrowserConfigParam.
  - AuditLogListParams.PageToken -- opaque cursor handled internally by
    ListAutoPaging; CLI exposes --limit instead.
  - BrowserCurlParams.TimeoutMs / ResponseEncoding -- `browsers curl` is
    implemented against browsers.HTTPClient rather than the SDK curl endpoint;
    --max-time covers the timeout and raw bytes are streamed, so response
    encoding is not applicable.

No coverage gaps found; no new commands or flags added.

## Tested
- go build ./... and go vet ./... clean
- go test ./... all packages pass
- Smoke tested rebuilt binary against the live API: `kernel browsers list`

Triggered by: kernel/kernel-go-sdk@a156820

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@kernel-internal kernel-internal Bot changed the title CLI: Update SDK to 0a28735 and add new commands/flags CLI: Update Go SDK to a1568205c576686eeafc634fff0ea72b75c28c0e Aug 17, 2026
kernel-internal Bot and others added 2 commits August 18, 2026 21:08
Bumps kernel-go-sdk to 6e62bf5b91e5d315b90b6c9c7296e09e312fb338.

That SDK release reshapes the canonical managed-auth input field: the
boolean `replace_existing` is gone and a `reason` enum ("missing" |
"rejected") takes its place, so `auth connections get` and the
`auth connections follow` event stream now render `reason=<why>` instead
of the `replace-existing` marker. A rejected credential is still visible,
now alongside the missing-value case it could not previously express.

A full enumeration of api.md against the CLI's service interfaces and
flags found no other coverage gaps: all 136 non-x-cli-skip SDK methods
have commands, and every params field maps to an existing flag.

Tested: auth connections list, auth connections get <id> (table + json),
browsers create -t 60, browsers get <id>, browsers delete <id> against
the live API; go build ./... and go test ./cmd/... pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@kernel-internal kernel-internal Bot changed the title CLI: Update Go SDK to a1568205c576686eeafc634fff0ea72b75c28c0e CLI: Update Go SDK to 6e62bf5b91e5d315b90b6c9c7296e09e312fb338 Aug 18, 2026
kernel-internal Bot and others added 2 commits August 19, 2026 18:53
Bumps kernel-go-sdk to 796d4245c87a39acbb0d408b05f0de830c500772.

That SDK release adds `interaction_id` to managed auth state and to the
submit request. The API requires it for canonical submissions
(field_values / selected_choice_id) and rejects it when paired with a
legacy submit mode, so before this change every canonical `auth
connections submit` failed with "interaction_id is required for
canonical submissions".

`auth connections submit` gains --interaction-id. Left off, the CLI reads
the connection's current interaction ID, since the ID changes on every
actionable pause and the freshly read one is the only sane default;
passing it pins the submission so the API can reject it as stale. Legacy
submit modes never send one, and --interaction-id with a legacy mode is
rejected locally with the same rule the API enforces. `auth connections
get` and `follow` now show the interaction ID next to the canonical
fields and choices it scopes.

Also resolves the stale merge of main into this branch, which had left
two competing org entitlements implementations in cmd/org.go (the branch
built `org entitlements get`; main shipped `org entitlements` in #232) so
the package no longer compiled. Main's reviewed version wins.

A full enumeration of api.md against the CLI found no other gaps: all
136 non-x-cli-skip SDK methods have commands, and the only new params
field in this release is SubmitFieldsRequest.interaction_id.

Tested against the live API: created a managed auth connection, started
a login flow, and confirmed `get` (table + JSON) and `follow` render the
interaction ID at AWAITING_INPUT; canonical submit with and without
--interaction-id now clears the API's interaction validation (it stops
at this org's submit-v2 feature gate, while the same request sent
without interaction_id still returns "interaction_id is required");
legacy `--field` submit still accepted; `--interaction-id` with `--field`
rejected locally; org entitlements, browsers create/get/delete pass.
go build ./..., go vet ./... and go test ./... pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@kernel-internal kernel-internal Bot changed the title CLI: Update Go SDK to 6e62bf5b91e5d315b90b6c9c7296e09e312fb338 CLI: Update SDK to 796d4245c87a39acbb0d408b05f0de830c500772 and add new commands/flags Aug 19, 2026
Bumps kernel-go-sdk to v0.92.1-0.20260819203102-467fea72ee93, which adds
the proxy_error browser telemetry event (BrowserProxyErrorEvent) to the
telemetry event union.

No CLI coverage gaps: a full enumeration of all 137 SDK methods in api.md
found a corresponding CLI command for each, and the new event type needs
no code change because the telemetry commands render category/type
generically and accept --types values without a fixed allowlist.

Tested: go build ./..., go vet ./..., go test ./... (all pass);
browsers create --telemetry all, browsers curl, browsers telemetry events
(table, --output json, --categories network --all, --types proxy_error),
browsers telemetry stream --categories network --types proxy_error,
browsers delete — all against the live API.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@kernel-internal kernel-internal Bot changed the title CLI: Update SDK to 796d4245c87a39acbb0d408b05f0de830c500772 and add new commands/flags CLI: Update Go SDK to 467fea72ee93a0d8e4a520169cf5e14e5d4076ee Aug 19, 2026
Bumps github.com/kernel/kernel-go-sdk to
08023260493e4584c4d87638849ab4491b34ec49 (v0.93.0).

The 0.93.0 release only changed version/changelog metadata relative to
the SDK revision the CLI was already pinned to (467fea7); api.md and all
generated Go sources are byte-identical, so there are no new methods,
params, or fields to expose.

Coverage analysis: full enumeration of all 140 SDK methods in api.md
against the CLI command tree found no gaps. Every method has a command,
and every param struct field is reachable via a flag, a positional arg,
or a derived value.

Tested: go build ./..., go vet ./..., go test ./... (all pass), plus live
API smoke tests for browsers list/create/get/delete, browsers telemetry
events, auth connections list, profiles list, telemetry destinations list.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@kernel-internal kernel-internal Bot changed the title CLI: Update Go SDK to 467fea72ee93a0d8e4a520169cf5e14e5d4076ee CLI: Update Go SDK to 08023260493e4584c4d87638849ab4491b34ec49 Aug 20, 2026
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.

0 participants