Skip to content

Allow ListActors to hide temporary golden snapshot actors - #3813

Draft
Arunkumar Eli (arun-elr) wants to merge 1 commit into
agent-substrate:mainfrom
arun-elr:feat/list-actors-exclude-golden
Draft

Arunkumar Eli (arun-elr) wants to merge 1 commit into
agent-substrate:mainfrom
arun-elr:feat/list-actors-exclude-golden

Conversation

@arun-elr

@arun-elr Arunkumar Eli (arun-elr) commented Nov 12, 2026 •

Copy link
Copy Markdown

Addresses #3788.

Add ListActorsRequest.exclude_golden_actors, defaulting to false. The template reconciler marks its new actors with status.golden_snapshot_actor; public CreateActor and UpdateActor cannot set or clear that marker. Filtering keeps the pagination cursor, including on empty pages.

The API shape is proposed for discussion. Older unmarked golden actors remain visible; this avoids classifying user actors by their names and requires no database migration. Both runtimes use the same control-plane path.

New PostgreSQL-backed tests pass with -race -count=3 -shuffle=on, covering scoped/global pagination, the default listing, ordinary UUID names, and attempts to forge or clear the marker. Disabling the implementation makes the regressions fail. The complete control API, functional, and API validation suites also pass with -race; code generation verification passes. A repository-wide race run hit a router port collision and terminal-color failures, both reproduced on unchanged main. The color tests pass with NO_COLOR unset. All repository verifiers pass (the two lint checks were rerun with serialized execution after a shared-lock conflict). Deployed gVisor/microVM E2E has not been run.

AI use: Codex assisted with implementation, tests, and independent review.

  • New tests pass
  • API comments and style guide updated

Mark actors created by the template reconciler and add an opt-in list filter. Preserve pagination cursors and keep unmarked actors visible, including actors created before the marker existed.

Signed-off-by: Arunkumar Eli <elrarun@gmail.com>

This branch has not been deployed

No deployments
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.

1 participant