Add shared cloud snapshot contracts

[toksdotdev]

What changed

• moved the canonical snapshot manifest schema into microsandbox-types
• added cloud snapshot create, resource, operation, location, and restore-reference wire types
• added CloudSandboxSpec.from_snapshot with exactly-one origin validation
• generated and exported the snapshot TypeScript contract
• updated first-party snapshot consumers to import the manifest schema directly from microsandbox-types
• removed the obsolete microsandbox-image manifest re-export shim

Why

msb-cloud needs one shared, dependency-safe snapshot contract for API types, SDKs, OpenAPI, and generated TypeScript. The manifest cannot remain owned by microsandbox-image because the shared types package must not depend upward on the image implementation.

Public behavior

Snapshot operation status exposes the stable public states queued, in_progress, succeeded, and failed. Sandbox creation requires exactly one of image or from_snapshot, and snapshot restores reject an explicit disk-size override.

This PR establishes contracts only; cloud snapshot HTTP operations and backend dispatch land in follow-up work.

Validation

• cargo test -p microsandbox-types --features ts,utoipa — 61 passed
• snapshot-focused Rust SDK and image tests — 20 passed
• workspace pre-commit hooks passed, including Clippy, rustdoc, and the msb build
• TypeScript typecheck passed
• generated-binding drift test passed

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
microsandbox-staging	🟢 Ready	View Preview	Aug 21, 2026, 10:05 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[greptile-apps]

_{Reviews (2): Last reviewed commit: "feat(snapshot): add backend-neutral clou..." | Re-trigger Greptile}

[greptile-apps]

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Types["microsandbox-types<br/>canonical snapshot contracts"]
  Image["microsandbox-image"]
  RustSDK["Rust SDK"]
  OtherSDKs["Go / Python / Node SDKs"]
  TS["Generated TypeScript contracts"]
  Cloud["Cloud snapshot API contract"]

  Types --> Image
  Types --> RustSDK
  Types --> TS
  RustSDK --> OtherSDKs
  Types --> Cloud

Loading

_{Reviews (3): Last reviewed commit: "fix(snapshot): restore fallible artifact..." | Re-trigger Greptile}

[greptile-apps]

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Types[microsandbox-types]
  Manifest[Shared snapshot manifest]
  Cloud[Cloud snapshot wire contracts]
  Rust[Rust SDK and cloud backend]
  Bindings[Go, Node, and Python bindings]
  TS[Generated TypeScript contracts]
  Image[microsandbox-image consumers]

  Types --> Manifest
  Types --> Cloud
  Manifest --> Rust
  Manifest --> Image
  Cloud --> Rust
  Cloud --> Bindings
  Cloud --> TS

Loading

_{Reviews (4): Last reviewed commit: "fix(snapshot): restore fallible artifact..." | Re-trigger Greptile}

[greptile-apps]

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    Types[microsandbox-types snapshot contracts]
    RustSDK[Rust SDK]
    Cloud[Cloud snapshot API]
    Local[Local snapshot artifacts]
    Bindings[Python / Node / Go bindings]
    Apps[SDK and CLI callers]

    Types --> RustSDK
    RustSDK --> Cloud
    RustSDK --> Local
    RustSDK --> Bindings
    Bindings --> Apps
    RustSDK --> Apps

Loading

_{Reviews (5): Last reviewed commit: "fix(snapshot): restore fallible artifact..." | Re-trigger Greptile}

[greptile-apps]

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Types[microsandbox-types snapshot contracts]
  Rust[Rust SDK]
  Cloud[Cloud snapshot API]
  Bindings[Python, Node, and Go bindings]
  TS[Generated TypeScript contracts]
  Image[Image and local snapshot consumers]
  Types --> Rust
  Types --> TS
  Types --> Image
  Rust --> Cloud
  Rust --> Bindings

Loading

_{Reviews (6): Last reviewed commit: "feat(snapshot): distinguish cloud snapsh..." | Re-trigger Greptile}

[greptile-apps]

_{Reviews (7): Last reviewed commit: "fix(snapshot): align backend-neutral con..." | Re-trigger Greptile}

[greptile-apps]

_{Reviews (8): Last reviewed commit: "refactor(snapshot): defer cloud checkpoi..." | Re-trigger Greptile}

[greptile-apps]

_{Reviews (9): Last reviewed commit: "refactor(snapshot): simplify sandbox ide..." | Re-trigger Greptile}

[greptile-apps]

_{Reviews (10): Last reviewed commit: "refactor(snapshot): simplify sandbox ide..." | Re-trigger Greptile}