Skip to content

Redesign snapshot restoration for agents - #3819

Open
vigoo wants to merge 13 commits into
mainfrom
gol-487-snapshot-load-save-redesign
Open

Redesign snapshot restoration for agents#3819
vigoo wants to merge 13 commits into
mainfrom
gol-487-snapshot-load-save-redesign

Conversation

@vigoo

@vigoo vigoo commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Execute load-snapshot as a specially supported read-only lifecycle operation using the existing read_only_method: Some("load-snapshot") path, with no oplog writes and with mutating host operations plus outgoing HTTP/RPC rejected before they take effect.
  • Replace mutation-based snapshot loaders with restoration factories across the Rust, TypeScript, Scala, and MoonBit SDKs. Restoration skips normal initialization, receives identity/principal/config context as supported by each SDK, and installs only a complete successfully restored state or instance.
  • Generate automatic loading only where a JSON-deserialization contract exists, including requiring an explicit TypeScript state schema, while preserving the existing snapshot envelope, MIME, and WIT contracts.
  • Make failed automatic loads discard partial state and recreate/replay without trying older automatic snapshots; preserve the previous component for failed manual updates.
  • Migrate in-tree consumers and templates, add executor and SDK regression coverage, and update source and generated documentation.

Validation

  • cargo fmt -p golem-worker-executor -- --check
  • cargo clippy -p golem-worker-executor --all-targets --no-deps -- -D warnings
  • cargo check -p golem-worker-executor --all-targets
  • Targeted worker-executor snapshot/update acceptance tests: 4 passed
  • Rust SDK tests: 132 passed, 4 ignored
  • TypeScript SDK tests: 17 passed
  • Scala formatting and model JVM/JS, macro, and core tests: 1,346 passed
  • MoonBit SDK tests: 259 passed; SDK tools tests: 304 passed
  • Migrated snapshot fixtures built successfully
  • Docs lint, formatting, typecheck, links, version checks, and cargo make check-docs-skills

Resolves GOL-487

@vigoo
vigoo requested a review from a team September 3, 2026 08:54
@netlify

netlify Bot commented Sep 3, 2026

Copy link
Copy Markdown

Deploy Preview for golemcloud canceled.

Name Link
🔨 Latest commit 0f6f650
🔍 Latest deploy log https://app.netlify.com/projects/golemcloud/deploys/6a9c2b157825d00008e0891e

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

📖 Docs preview: https://docs-qngiaf7dm-golem-cloud.vercel.app

Built from commit 0f6f650612c2d18994ed74f19ba349e529cf7815 by docs.yaml.

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