Skip to content

Conversation

@mateoCuervo
Copy link
Contributor

@mateoCuervo mateoCuervo commented Nov 19, 2025

Description

Upgrades kernel-go-sdk to v0.20.0 and adds support for viewing soft-deleted browser sessions via the new --include-deleted flag, which displays a Deleted At column in the output when enabled. Also adds --limit and --offset flags to the browsers list command for pagination support, and updates all code and tests to work with the SDK's new pagination-based API that returns OffsetPagination[BrowserListResponse] instead of simple arrays.

Tested

Browsers list still works compatible with past changes

./bin/kernel browsers list
Browser ID               | Created At              | Persistent ID   | Profile | CDP WS URL                                         | Live View URL                                     
p835ki3pbs1sk9b6q1vcgibs | 2025-11-14 15:50:01 EST | my ID foo1      | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr...
ejymvj2soco5pel6av5swxc8 | 2025-11-14 15:50:16 EST | my ID bizz 1223 | -       | httof idle browser instances in the pops://apte... |  

We can paginate

./bin/kernel browsers list --limit 1 --offset 1                  
Browser ID               | Created At              | Persistent ID   | Profile | CDP WS URL                                         | Live View URL
ejymvj2soco5pel6av5swxc8 | 2025-11-14 15:50:16 EST | my ID bizz 1223 | -       | httof idle browser instances in the pops://apte... |  

We can now include deleted browsers in results

./bin/kernel browsers list --include-deleted   
Browser ID               | Created At              | Persistent ID | Profile | CDP WS URL                                         | Live View URL                                      | Deleted At             
odfy1z875hwwmazk8cneelzy | 2025-10-07 10:46:40 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 10:59:02 EDT
...
mpk6qwzh16s14hye4lownrj3 | 2025-10-07 15:30:51 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:31:54 EDT
yeu77dw14cgoqroau0uxyv4q | 2025-10-07 15:31:20 EDT | test          | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 16:15:28 EDT

We can paginate including deleted browsers:

./bin/kernel browsers list --limit 10 --offset 2 --include-deleted 
Browser ID               | Created At              | Persistent ID | Profile | CDP WS URL                                         | Live View URL                                      | Deleted At             
y9h4g7v2lqed9dyzbs5we06z | 2025-10-07 15:12:31 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:13:49 EDT
ec2od894vuu0iyvrop00zre9 | 2025-10-07 15:20:19 EDT | -             | -       | httof idle browser instances in the pops://apte... |                                                    | 2025-10-07 15:25:22 EDT
xvmidx982o0otg0snu2wddmh | 2025-10-07 15:20:32 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:21:36 EDT
kiopeonodwd97g6nnrs003e2 | 2025-10-07 15:20:40 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:21:44 EDT
ozygmi7ieaajmu3bdsh06rx8 | 2025-10-07 15:21:49 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:22:57 EDT
m8bkktjdf8p5yteewy798vyj | 2025-10-07 15:23:53 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:24:57 EDT
jcytgllgbkyr695cdlmdsznp | 2025-10-07 15:23:56 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:24:59 EDT
y3cngz01vcsfundzs2wi0pc8 | 2025-10-07 15:23:58 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:28:51 EDT
e3rmbrdi8agxsugs1ym3mx1a | 2025-10-07 15:24:01 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:25:05 EDT
ok1p7d4l1pqvyndv9ukmz3sp | 2025-10-07 15:27:22 EDT | -             | -       | httof idle browser instances in the pops://apte... | https://apterygial-multiflorous-magaly.ngrok-fr... | 2025-10-07 15:33:05 EDT

@mesa-dot-dev
Copy link

mesa-dot-dev bot commented Nov 19, 2025

Mesa Description

This PR introduces the functionality to include deleted browsers in list results, complete with pagination support. A new --include-deleted flag has been added to the relevant command, allowing users to retrieve a comprehensive list of all browsers, including those that have been soft-deleted. This is useful for auditing and administrative purposes.

Description generated by Mesa. Update settings

Copy link

@mesa-dot-dev mesa-dot-dev bot left a comment

Choose a reason for hiding this comment

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

Performed full review of c27e844...4d8d534

Analysis

  1. Missing Input Validation: CLI accepts pagination parameters (limit and offset) without validation, potentially allowing invalid values that could cause backend errors instead of being caught early on the client side.

  2. Inconsistent User Messaging: The "No running or persistent browsers found" message doesn't account for when the --include-deleted flag is active, which could confuse users looking for deleted browsers.

  3. Helper Method Limitations: Methods like resolveBrowserByIdentifier don't consider deleted browsers, which may cause confusion when users attempt to reference deleted browsers by ID in certain contexts.

Tip

Help

Slash Commands:

  • /review - Request a full code review
  • /review latest - Review only changes since the last review
  • /describe - Generate PR description. This will update the PR body or issue comment depending on your configuration
  • /help - Get help with Mesa commands and configuration options

4 files reviewed | 0 comments | Edit Agent SettingsRead Docs

Copy link

@mesa-dot-dev mesa-dot-dev bot left a comment

Choose a reason for hiding this comment

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

Performed full review of c27e844...4d8d534

Analysis

  1. Input Validation Missing: The --limit flag has a documented maximum of 100, but there's no client-side validation to enforce this constraint, potentially causing unexpected API behavior.

  2. Incomplete Pagination UX: The CLI doesn't provide information about total results or whether more pages exist, making it difficult for users to navigate through paginated results.

  3. Default Behavior Change: Users may not realize they're only seeing the first page (likely 20 items) instead of all browsers, which could be perceived as a breaking change.

  4. Limited Error Handling: While basic SDK errors are handled, pagination-specific errors (like invalid offset) lack specific error messages.

  5. Testing Gaps: No specific tests validate the pagination logic or verify the correct rendering of the "Deleted At" column.

Tip

Help

Slash Commands:

  • /review - Request a full code review
  • /review latest - Review only changes since the last review
  • /describe - Generate PR description. This will update the PR body or issue comment depending on your configuration
  • /help - Get help with Mesa commands and configuration options

4 files reviewed | 0 comments | Edit Agent SettingsRead Docs

@mateoCuervo mateoCuervo requested a review from rgarcia November 19, 2025 20:20
@mateoCuervo mateoCuervo merged commit 01dc4cd into main Nov 20, 2025
3 checks passed
@mateoCuervo mateoCuervo deleted the feat-get-deleted-browser branch November 20, 2025 15:38
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.

3 participants