Add --query flag to kernel browsers list (#126)

And related test

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: adds an optional list filter flag and passes it through to
the SDK, with a small unit test verifying param wiring.
> 
> **Overview**
> Adds a new `--query` flag to `kernel browsers list` and threads it
through `BrowsersListInput` into `kernel.BrowserListParams.Query` so
list results can be searched (session/profile/proxy IDs).
> 
> Adds a unit test ensuring the query value is passed to the underlying
`BrowsersService.List` call.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
64b55db. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: dcruzeneil2

cmd/browsers.go

@@ -228,6 +228,7 @@ type BrowsersListInput struct {
 	Status         string
 	Limit          int
 	Offset         int
+	Query          string
 }
 
 func (b BrowsersCmd) List(ctx context.Context, in BrowsersListInput) error {
@@ -257,6 +258,9 @@ func (b BrowsersCmd) List(ctx context.Context, in BrowsersListInput) error {
 	if in.Offset > 0 {
 		params.Offset = kernel.Opt(int64(in.Offset))
 	}
+	if in.Query != "" {
+		params.Query = kernel.Opt(in.Query)
+	}
 
 	page, err := b.browsers.List(ctx, params)
 	if err != nil {
@@ -2139,6 +2143,7 @@ func init() {
 	browsersListCmd.Flags().String("status", "", "Filter by status: 'active' (default), 'deleted', or 'all'")
 	browsersListCmd.Flags().Int("limit", 0, "Maximum number of results to return (default 20, max 100)")
 	browsersListCmd.Flags().Int("offset", 0, "Number of results to skip (for pagination)")
+	browsersListCmd.Flags().String("query", "", "Search browsers by session ID, profile ID, or proxy ID")
 
 	// get flags
 	browsersGetCmd.Flags().StringP("output", "o", "", "Output format: json for raw API response")
@@ -2418,12 +2423,14 @@ func runBrowsersList(cmd *cobra.Command, args []string) error {
 	status, _ := cmd.Flags().GetString("status")
 	limit, _ := cmd.Flags().GetInt("limit")
 	offset, _ := cmd.Flags().GetInt("offset")
+	query, _ := cmd.Flags().GetString("query")
 	return b.List(cmd.Context(), BrowsersListInput{
 		Output:         out,
 		IncludeDeleted: includeDeleted,
 		Status:         status,
 		Limit:          limit,
 		Offset:         offset,
+		Query:          query,
 	})
 }
 

cmd/browsers_test.go

@@ -193,6 +193,26 @@ func TestBrowsersList_PrintsErrorOnFailure(t *testing.T) {
 	assert.Contains(t, err.Error(), "list failed")
 }
 
+func TestBrowsersList_WithQuery_PassesParam(t *testing.T) {
+	setupStdoutCapture(t)
+
+	var captured kernel.BrowserListParams
+	fake := &FakeBrowsersService{
+		ListFunc: func(ctx context.Context, query kernel.BrowserListParams, opts ...option.RequestOption) (*pagination.OffsetPagination[kernel.BrowserListResponse], error) {
+			captured = query
+			return &pagination.OffsetPagination[kernel.BrowserListResponse]{Items: []kernel.BrowserListResponse{
+				{SessionID: "sess-matched"},
+			}}, nil
+		},
+	}
+	b := BrowsersCmd{browsers: fake}
+	err := b.List(context.Background(), BrowsersListInput{Query: "sess-matched"})
+
+	assert.NoError(t, err)
+	assert.True(t, captured.Query.Valid())
+	assert.Equal(t, "sess-matched", captured.Query.Value)
+}
+
 func TestBrowsersCreate_PrintsResponse(t *testing.T) {
 	setupStdoutCapture(t)