release: 0.102.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.101.0"
+  ".": "0.102.0"
 }

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.102.0](https://github.com/kernel/kernel-go-sdk/compare/v0.101.0...v0.102.0) (2026-09-13)
+
+
+### Features
+
+* Add guarded vault card fill operations ([b4278bb](https://github.com/kernel/kernel-go-sdk/commit/b4278bbc29928b8ef3ba3eadd0927438faeba5e9))
+* Allow replacing AgentCard cards after unknown creates ([410bbab](https://github.com/kernel/kernel-go-sdk/commit/410bbabd91ea07f7df07a72ffacbb872b0d6d2f1))
+* Document punctuation key sequences ([86e3d38](https://github.com/kernel/kernel-go-sdk/commit/86e3d38ceac4ef799e5a77ede267ab4a70baf073))
+* Reapply vendor guidance recommendations ([b22a63c](https://github.com/kernel/kernel-go-sdk/commit/b22a63c49fc35a1e3c25b209ac0a39394227536b))
+* Report proxy-restricted targets from config registry lookup ([dc39717](https://github.com/kernel/kernel-go-sdk/commit/dc397177716f3af909acc707f5940daefcaa9415))
+
 ## [0.101.0](https://github.com/kernel/kernel-go-sdk/compare/v0.100.0...v0.101.0) (2026-09-11)
 
 

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.101.0'
+go get -u 'github.com/kernel/kernel-go-sdk@v0.102.0'
 ```
 
 <!-- x-release-please-end -->

api.md

@@ -493,16 +493,21 @@ 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#CardVaultItemSpecUnionParam">CardVaultItemSpecUnionParam</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#FillVaultItemOperationRequestParam">FillVaultItemOperationRequestParam</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#VaultCardFillFieldUnionParam">VaultCardFillFieldUnionParam</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#AgentcardCheckoutAuthorization">AgentcardCheckoutAuthorization</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#CardVaultItemSpecUnion">CardVaultItemSpecUnion</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#CardVaultItemStateUnion">CardVaultItemStateUnion</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#FillVaultItemOperationResult">FillVaultItemOperationResult</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#VaultCardAliases">VaultCardAliases</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#VaultFillFieldResult">VaultFillFieldResult</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#VaultItemUnion">VaultItemUnion</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#VaultItemActionUnion">VaultItemActionUnion</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#VaultItemEvent">VaultItemEvent</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#VaultItemOperationResponseUnion">VaultItemOperationResponseUnion</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#VaultPaymentMethod">VaultPaymentMethod</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#WalletVaultItemSpecUnion">WalletVaultItemSpecUnion</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#WalletVaultItemStateUnion">WalletVaultItemStateUnion</a>
@@ -514,7 +519,7 @@ Methods:
 - <code title="get /vaults/{id_or_name}/items">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.List">List</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#VaultItemUnion">VaultItemUnion</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="delete /vaults/{id_or_name}/items/{key}">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, key <a href="https://pkg.go.dev/builtin#string">string</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#VaultItemDeleteParams">VaultItemDeleteParams</a>) <a href="https://pkg.go.dev/builtin#error">error</a></code>
 - <code title="get /vaults/{id_or_name}/items/{key}/events">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.Events">Events</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, key <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#VaultItemEventsParams">VaultItemEventsParams</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#VaultItemEvent">VaultItemEvent</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
-- <code title="post /vaults/{id_or_name}/items/{key}/operations">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.PerformOperation">PerformOperation</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, key <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#VaultItemPerformOperationParams">VaultItemPerformOperationParams</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#VaultItemUnion">VaultItemUnion</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="post /vaults/{id_or_name}/items/{key}/operations">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.PerformOperation">PerformOperation</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, key <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#VaultItemPerformOperationParams">VaultItemPerformOperationParams</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#VaultItemOperationResponseUnion">VaultItemOperationResponseUnion</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="put /vaults/{id_or_name}/items/{key}">client.Vaults.Items.<a href="https://pkg.go.dev/github.com/kernel/kernel-go-sdk#VaultItemService.Upsert">Upsert</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, key <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#VaultItemUpsertParams">VaultItemUpsertParams</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#VaultItemUnion">VaultItemUnion</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
 # Credentials

browsercomputer.go

@@ -406,7 +406,9 @@ type BrowserComputerBatchParamsActionPressKey struct {
 	// List of key symbols to press. Each item should be a key symbol supported by
 	// xdotool (see X11 keysym definitions). Examples include "Return", "Shift",
 	// "Ctrl", "Alt", "F5". Items in this list could also be combinations, e.g.
-	// "Ctrl+t" or "Ctrl+Shift+Tab".
+	// "Ctrl+t" or "Ctrl+Shift+Tab". Use X11 names for punctuation in combinations,
+	// such as "Ctrl+minus" or "Ctrl+plus". A literal hyphen is also accepted as an
+	// alias, so "Ctrl+-" is normalized to "Ctrl+minus".
 	Keys []string `json:"keys,omitzero" api:"required"`
 	// Duration to hold the keys down in milliseconds. If omitted or 0, keys are
 	// tapped.
@@ -650,7 +652,9 @@ type BrowserComputerPressKeyParams struct {
 	// List of key symbols to press. Each item should be a key symbol supported by
 	// xdotool (see X11 keysym definitions). Examples include "Return", "Shift",
 	// "Ctrl", "Alt", "F5". Items in this list could also be combinations, e.g.
-	// "Ctrl+t" or "Ctrl+Shift+Tab".
+	// "Ctrl+t" or "Ctrl+Shift+Tab". Use X11 names for punctuation in combinations,
+	// such as "Ctrl+minus" or "Ctrl+plus". A literal hyphen is also accepted as an
+	// alias, so "Ctrl+-" is normalized to "Ctrl+minus".
 	Keys []string `json:"keys,omitzero" api:"required"`
 	// Duration to hold the keys down in milliseconds. If omitted or 0, keys are
 	// tapped.

configregistry.go

@@ -196,11 +196,17 @@ type ConfigRegistryResponse struct {
 	// A recommendation or a structured no-recommendation result.
 	Recommendation RecommendationResultUnion `json:"recommendation" api:"required"`
 	Target         Target                    `json:"target" api:"required"`
+	// Short advisory markdown to facilitate navigating this target. Returned even when
+	// no configuration reached the target, since knowing what prevented success is
+	// useful without a configuration. Not verified against this target. Null when
+	// nothing applicable was observed or no notes exist.
+	Guidance string `json:"guidance" api:"nullable"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
 		Analysis       respjson.Field
 		Recommendation respjson.Field
 		Target         respjson.Field
+		Guidance       respjson.Field
 		ExtraFields    map[string]respjson.Field
 		raw            string
 	} `json:"-"`
@@ -268,12 +274,19 @@ func (r *LookupRequestParam) UnmarshalJSON(data []byte) error {
 }
 
 type LookupResponse struct {
-	Recommendation Recommendation `json:"recommendation" api:"required"`
-	Target         Target         `json:"target" api:"required"`
+	// A recommendation or a structured no-recommendation result.
+	Recommendation RecommendationResultUnion `json:"recommendation" api:"required"`
+	Target         Target                    `json:"target" api:"required"`
+	// Short advisory markdown to facilitate navigating this target. Returned even when
+	// no configuration reached the target, since knowing what prevented success is
+	// useful without a configuration. Not verified against this target. Null when
+	// nothing applicable was observed or no notes exist.
+	Guidance string `json:"guidance" api:"nullable"`
 	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
 	JSON struct {
 		Recommendation respjson.Field
 		Target         respjson.Field
+		Guidance       respjson.Field
 		ExtraFields    map[string]respjson.Field
 		raw            string
 	} `json:"-"`

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "0.101.0" // x-release-please-version
+const PackageVersion = "0.102.0" // x-release-please-version

shared/constant/constants.go

@@ -21,6 +21,7 @@ func ValueOf[T Constant[T]]() T {
 type Agentcard string                       // Always "agentcard"
 type APICall string                         // Always "api_call"
 type AppVersionSummary string               // Always "app_version_summary"
+type Authorize string                       // Always "authorize"
 type AutofillTrigger string                 // Always "Autofill.trigger"
 type AwsUsEast1a string                     // Always "aws.us-east-1a"
 type BrowserCancelDownload string           // Always "Browser.cancelDownload"
@@ -132,6 +133,7 @@ type Wallet string                          // Always "wallet"
 func (c Agentcard) Default() Agentcard                           { return "agentcard" }
 func (c APICall) Default() APICall                               { return "api_call" }
 func (c AppVersionSummary) Default() AppVersionSummary           { return "app_version_summary" }
+func (c Authorize) Default() Authorize                           { return "authorize" }
 func (c AutofillTrigger) Default() AutofillTrigger               { return "Autofill.trigger" }
 func (c AwsUsEast1a) Default() AwsUsEast1a                       { return "aws.us-east-1a" }
 func (c BrowserCancelDownload) Default() BrowserCancelDownload   { return "Browser.cancelDownload" }
@@ -265,6 +267,7 @@ func (c Wallet) Default() Wallet                         { return "wallet" }
 func (c Agentcard) MarshalJSON() ([]byte, error)                       { return marshalString(c) }
 func (c APICall) MarshalJSON() ([]byte, error)                         { return marshalString(c) }
 func (c AppVersionSummary) MarshalJSON() ([]byte, error)               { return marshalString(c) }
+func (c Authorize) MarshalJSON() ([]byte, error)                       { return marshalString(c) }
 func (c AutofillTrigger) MarshalJSON() ([]byte, error)                 { return marshalString(c) }
 func (c AwsUsEast1a) MarshalJSON() ([]byte, error)                     { return marshalString(c) }
 func (c BrowserCancelDownload) MarshalJSON() ([]byte, error)           { return marshalString(c) }