Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
211 commits
Select commit Hold shift + click to select a range
9271aac
fix(vmm): best-effort guest clock sync after snapshot restore (Option B)
jrimmer Aug 12, 2026
e178c29
fix: clippy doc_lazy_continuation in sync_guest_clocks doc comment
jrimmer Aug 12, 2026
0d3bda3
test(vmm): add integration test for guest clock sync + fix exec args
jrimmer Aug 12, 2026
4f67121
fix(vmm): per-child timestamp, opt-in clock sync, reject n>1 shared-IP
jrimmer Aug 13, 2026
3f2c965
fix(vmm): expose per-child clock sync outcomes for fail-closed callers
jrimmer Aug 13, 2026
adc1c70
fix(vmm): clippy unused-enumerate-index + behavioral clock sync tests
jrimmer Aug 13, 2026
be339d4
fix(vmm): deterministic delayed-agent-readiness test for clock sync
jrimmer Aug 17, 2026
16f8414
fix(vmm): address ce-code-review on clock sync refactor
jrimmer Aug 17, 2026
20d7add
style: cargo fmt on clock sync refactor
jrimmer Aug 17, 2026
77d3f5d
Merge pull request #300 from jrimmer/fix/guest-clock-sync-on-restore
WaylandYang Aug 20, 2026
6ede9e1
fix(controller): run Registry::reconcile under a single lock
AmirF194 Aug 22, 2026
d2d238a
Merge pull request #312 from AmirF194/fix/registry-reconcile-single-l…
WaylandYang Aug 22, 2026
98deeed
fix(vmm): restore-path resilience for issue #301 (squashed)
jrimmer Aug 17, 2026
692d0ed
style: cargo fmt on rebase resolution
jrimmer Aug 21, 2026
f1e0afa
fix(vmm): preserve original child slot in clock-sync outcomes
jrimmer Aug 22, 2026
5cdbbe6
style: fix clippy doc-lazy-continuation in sync docs
jrimmer Aug 22, 2026
e2fd1a6
Merge pull request #302 from jrimmer/fix/restore-path-resilience
WaylandYang Aug 22, 2026
abab9cf
fix(controller): kill orphaned Firecracker processes on startup
jrimmer Aug 12, 2026
0baa539
fix(controller): address ce review findings for orphan recovery
jrimmer Aug 12, 2026
fc1b759
fix(controller): abort startup on kill_failed, document PID-reuse limit
jrimmer Aug 13, 2026
5a96cdd
fix(controller): extract check_orphan_kill_result for testable abort …
jrimmer Aug 13, 2026
1c30784
fix(controller): remove orphaned last_err assignment after rebase
jrimmer Aug 13, 2026
19ea6e2
fix(controller): durable process identity for orphan recovery
jrimmer Aug 17, 2026
22e760b
fix(controller): close pidfd TOCTOU + ce-code-review r6 follow-ups
jrimmer Aug 17, 2026
7ef16c4
fix(controller): add SIGKILL success-path regression + correct mislea…
jrimmer Aug 21, 2026
3894138
style: cargo fmt on new firecracker-named kill test
jrimmer Aug 21, 2026
9e1e072
fix(controller): persist boot id + fail closed on pid-less entries
jrimmer Aug 22, 2026
e93caea
fix(controller): resolve use-after-move in busy-retry warn (E0382)
jrimmer Aug 22, 2026
455d608
test(controller): make orphan-kill SIGKILL regression robust to CI or…
jrimmer Aug 22, 2026
bd490a9
fix(controller): distinct legacy-row diagnostics + off-Linux gate ski…
jrimmer Aug 29, 2026
ee12c87
fix(controller): fail spawn loudly when boot id is unreadable at regi…
jrimmer Aug 29, 2026
e034f7d
fix(controller): type alias for orphan row to satisfy clippy type_com…
jrimmer Aug 29, 2026
838eeae
fix(vmm): immutable baseline rootfs — reflink clone before boot (clos…
jrimmer Aug 14, 2026
3bc1fd9
fix(snapshot): cache versioning, atomic staging, portable rootfs tran…
jrimmer Aug 17, 2026
08a77b8
style: cargo fmt + fix stray brace in run_cmd cache validation
jrimmer Aug 21, 2026
fdc0ce8
fix(cli): qualify sha256_file calls with hub:: prefix
jrimmer Aug 21, 2026
b692500
fix(cli): clippy redundant closure in destination fallback
jrimmer Aug 21, 2026
39fe9db
fix(snapshot): 4 blockers from review #295 (2026-08-22)
jrimmer Aug 22, 2026
2fcf579
fix(snapshot): re-bake rollback + validated absolute rootfs placement…
jrimmer Aug 30, 2026
56e15e2
fix(snapshot): clippy needless-question-mark + restore opts rebuild i…
jrimmer Aug 30, 2026
323412f
test(snapshot): rollback restores content at the published path, not …
jrimmer Aug 30, 2026
8a36fe8
test(snapshot): surface per-child restore failures instead of swallow…
jrimmer Aug 30, 2026
7a73fa3
fix(snapshot): repoint staged snapshot.json at final paths on publish
jrimmer Aug 30, 2026
041c904
Merge pull request #299 from jrimmer/fix/controller-restart-recovery
WaylandYang Sep 2, 2026
f672708
Merge branch 'dev' into fix/resnapshot-e2fsck
WaylandYang Sep 2, 2026
07a1ffb
Merge pull request #295 from jrimmer/fix/resnapshot-e2fsck
WaylandYang Sep 2, 2026
bf380db
fix(cli): sweep every rootfs .prev backup on re-bake
jrimmer Sep 11, 2026
28c3725
fix(vmm): reap the Firecracker child on every failed boot
jrimmer Sep 11, 2026
bde979a
fix(cli): gate bakes on free space, and always clean up the staging dir
jrimmer Sep 11, 2026
8120ff1
test(cli): tolerate free-space drift between the two statvfs probes
WaylandYang Sep 14, 2026
e416661
fix(cli): restore the .prev backup unless the tag was republished
WaylandYang Sep 14, 2026
c878a00
fix(vmm): use the real FICLONE ioctl number
WaylandYang Sep 14, 2026
5b16b73
Merge pull request #315 from jrimmer/fix/vm-boot-orphan-firecracker
WaylandYang Sep 14, 2026
e00fed3
Merge remote-tracking branch 'origin/dev' into pr-316
WaylandYang Sep 14, 2026
9bb863d
Merge remote-tracking branch 'origin/dev' into pr-314
WaylandYang Sep 14, 2026
a218294
Merge commit 'e00fed3' into pr-314
WaylandYang Sep 14, 2026
36a9a07
style: rustfmt the FICLONE derivation test
WaylandYang Sep 14, 2026
64a4522
style(cli): name the backup tuple for clippy::type_complexity
WaylandYang Sep 14, 2026
81c74c9
test(vmm): compare FICLONE without a cast
WaylandYang Sep 14, 2026
28fffb0
Merge pull request #316 from jrimmer/fix/bake-space-and-staging
WaylandYang Sep 14, 2026
13d476f
Merge remote-tracking branch 'origin/dev' into pr-314
WaylandYang Sep 14, 2026
c7883d6
Merge pull request #314 from jrimmer/fix/prev-rootfs-backup-recovery
WaylandYang Sep 14, 2026
c94f39c
Merge remote-tracking branch 'origin/dev' into fix/ficlone-ioctl-number
WaylandYang Sep 14, 2026
bbf23a9
Merge pull request #322 from deeplethe/fix/ficlone-ioctl-number
WaylandYang Sep 14, 2026
451d474
docs: add v0.6 architecture RFC
WaylandYang Oct 22, 2026
7d5a151
fix(cli): drop the single-element loop in check_firecracker_binary
WaylandYang Oct 22, 2026
658651f
ci(mcp): hold pydantic below 2.14 on the mcp==1.2.0 leg
WaylandYang Oct 22, 2026
f8ea327
docs(rfc): adopt PR #321's rootfs re-point mechanism in section 7
WaylandYang Oct 22, 2026
de715f8
feat(core): add master/node skeleton with sqlite state and four tiers
WaylandYang Oct 23, 2026
0ed94e4
fix(core): clear node connectivity on master startup
WaylandYang Oct 23, 2026
4279bac
feat(core): hold the node connection open instead of polling
WaylandYang Oct 23, 2026
4d1fee8
feat(node): build real OCI bundles and run a real sandbox
WaylandYang Oct 23, 2026
5d7894c
fix(node): observe state from the filesystem, never from runsc list
WaylandYang Oct 23, 2026
f781000
refactor(node): unmount the overlay before archiving on detach
WaylandYang Oct 23, 2026
af58e79
fix(master): do not recreate a detached sandbox
WaylandYang Oct 23, 2026
be405be
feat(master): allocate sandbox ports per node
WaylandYang Oct 23, 2026
afea9ea
feat(master): refuse placement on a node under memory pressure
WaylandYang Oct 23, 2026
29179ee
docs: record v0.6 single-node density measurements
WaylandYang Oct 23, 2026
2aca816
feat(core): add exec, wire-compatible with the v0.5 controller
WaylandYang Oct 24, 2026
7d7085e
fix(node): stop handing sandboxes the host's /etc
WaylandYang Oct 24, 2026
426663a
fix(master): require a bearer token on the control plane
WaylandYang Oct 24, 2026
5799a98
feat(node): give every sandbox its own network namespace
WaylandYang Oct 24, 2026
5235e1c
feat(core): branch a sandbox into a tag, and fork a tag into N children
WaylandYang Oct 24, 2026
c87239c
feat(core)!: add eval and ping, and remove forkd-controller
WaylandYang Oct 24, 2026
b92bffa
fix(master): accept per_child_netns either way
WaylandYang Oct 24, 2026
00e7455
chore(master): mark per_child_netns as deliberately unread
WaylandYang Oct 24, 2026
0e313cf
docs: re-measure the tier latencies under per-sandbox namespaces
WaylandYang Oct 24, 2026
1b6b923
feat(master): honour the caller's memory_limit_mib
WaylandYang Oct 24, 2026
d809a61
docs: re-measure the fill curve under per-sandbox namespaces
WaylandYang Oct 24, 2026
4a026a3
docs: land the fill curve and correct two tier numbers
WaylandYang Oct 24, 2026
2a11e59
docs: correct my own correction; the ~1 s never existed
WaylandYang Oct 24, 2026
1c0a3c1
node: refuse connections to a sandbox that is not hot (#327)
WaylandYang Oct 24, 2026
a06e9c5
feat(core): serve the control plane over mTLS, both directions
WaylandYang Oct 24, 2026
972985c
style: cargo fmt the poll status check
WaylandYang Oct 24, 2026
e3937bc
docs(security): say which isolation boundary you actually get
WaylandYang Oct 24, 2026
cfabc8f
deps(sdk)!: require Node 20 and clear every dependency alert
WaylandYang Oct 24, 2026
6d4471a
feat(core)!: require a sandbox's own token, and make a pool mean some…
WaylandYang Oct 24, 2026
24e2dbe
test(multinode): verify the pool boundary across three machines
WaylandYang Oct 24, 2026
02a8c31
test(multinode): run the three-machine check over raw TCP
WaylandYang Oct 24, 2026
41ca056
docs(contributing): say which backend an issue is about
WaylandYang Oct 24, 2026
e76183b
Revert "docs(contributing): say which backend an issue is about"
WaylandYang Oct 24, 2026
d879361
docs(contributing): say which backend an issue is about
WaylandYang Oct 24, 2026
4d88265
feat(node): expose a sandbox through a gateway that checks its token
WaylandYang Oct 24, 2026
5aaee70
fix(gateway): rotate a token without rebinding the socket
WaylandYang Oct 24, 2026
630cf60
feat(master): a web panel, and a join command that is not a 404
WaylandYang Oct 24, 2026
07bf94c
fix(master): give each sandbox its own gateway port, and fix the pane…
WaylandYang Oct 24, 2026
71e25d2
feat(master): rebuild the panel as a dashboard
WaylandYang Oct 24, 2026
2d86e56
feat(master): panel is light only
WaylandYang Oct 24, 2026
32fe651
panel: make the nav pills actually switch view
WaylandYang Oct 25, 2026
07c8607
fix(master): enforce max_sandboxes, and stop listing rows to count them
WaylandYang Oct 25, 2026
d273036
feat(master): GET /metrics, so a load test has something to read
WaylandYang Oct 25, 2026
c51025f
test(cli): stop the rootfs sweep tests asking the host about pid 1000
WaylandYang Oct 25, 2026
3975d51
feat(sdk-python): let the client verify a master's own CA
WaylandYang Oct 25, 2026
b611d1e
bench(fleet): a load test that drives the whole fleet, not one host
WaylandYang Oct 25, 2026
7fa0555
feat(fleet): one script to stand a fleet up, and three unit fixes it …
WaylandYang Oct 25, 2026
306c7c4
fix(packaging): the node unit could not run a sandbox; six reasons
WaylandYang Oct 25, 2026
4415309
fix(node): let a node refuse work it has no memory for
WaylandYang Oct 25, 2026
4990db0
fix(fleet): the deploy could not address a real fleet
WaylandYang Oct 25, 2026
b21ddd1
fix(master): time the ten store locks #340 missed
WaylandYang Oct 25, 2026
4316bb6
feat: let the master connect to a node, instead of the node dialing in
WaylandYang Oct 25, 2026
2450edd
feat(fleet): install and add listening nodes, and let them bind :80
WaylandYang Oct 25, 2026
a21d18c
feat(node): wake a cold sandbox when a request reaches its gateway
WaylandYang Oct 26, 2026
2a3fd5c
feat(node): reclaim frozen sandboxes and compress snapshots, each whe…
WaylandYang Oct 26, 2026
66ea287
feat(node): hot reclaim, warm templates, snapshot prefetch, compresse…
WaylandYang Oct 26, 2026
caedc05
docs(density): measured hot reclaim, warm templates, prefetch, compre…
WaylandYang Oct 26, 2026
5d04970
feat(node): the Snapshot tier gives back its network namespace
WaylandYang Oct 26, 2026
d963fc1
fix(node): raise the open-file limit; a node stopped near 1,000 sandb…
WaylandYang Oct 27, 2026
233cb2b
docs: a short README for v0.6, with three rounds of fleet measurement…
WaylandYang Oct 27, 2026
27c6e0c
feat(master): a console with its own history, at /console (#353)
WaylandYang Oct 27, 2026
a2671c8
feat: fork a tag on any node that can restore it (#354)
WaylandYang Oct 27, 2026
15653a1
chore: rename forkd to Sandstorm (#355)
WaylandYang Oct 27, 2026
48400bd
docs: a Sandstorm logo (#356)
WaylandYang Oct 27, 2026
561685b
docs: give the logo its own background (#357)
WaylandYang Oct 27, 2026
3326ee0
fix: a node under traffic makes room, keeps its permits and swap, and…
WaylandYang Oct 28, 2026
872682b
fix: spare sandboxes that are answering, evict by demand, and refuse …
WaylandYang Oct 28, 2026
7b39861
docs: the README on the 2026-10-28 round, with other runtimes compare…
WaylandYang Oct 28, 2026
4dbc96f
refactor(node): runsc behind a Backend trait (#368)
WaylandYang Oct 29, 2026
02dec92
docs: the logo in graphite, and on the panel, console and favicon (#371)
WaylandYang Oct 29, 2026
5f05568
feat(node): a Firecracker backend, behind --backend firecracker (#370)
WaylandYang Oct 29, 2026
2bc2345
bench(fleet): mixed can retry a 503 the way its retry-after asks (#363)
WaylandYang Oct 29, 2026
76245d2
feat(node): the gateway streams, and one host port reaches every port…
WaylandYang Oct 29, 2026
2e3e532
chore: drop the Firecracker-era (v0.5) code from the tree (#362)
WaylandYang Oct 29, 2026
b60260a
docs: record the v0.6 design as ADRs and drop the DESIGN documents (#…
WaylandYang Oct 29, 2026
5ac9b53
feat: the official E2B SDKs work against Sandstorm (#366)
WaylandYang Oct 29, 2026
3532e13
fix: preserve sandbox data when detach archiving fails (#369)
Floating-Y Oct 29, 2026
751c668
fix: publish checkpoints only after successful validation (#367)
Floating-Y Oct 29, 2026
546efeb
feat(console): one console at /, with Add a node and the Sandstorm ma…
WaylandYang Oct 29, 2026
ca51616
fix(node): count a wake as waiting only when it has to queue (#374)
WaylandYang Oct 29, 2026
d8cb511
docs: the lead figure as four panels, the console beneath it, and kep…
WaylandYang Oct 29, 2026
e6403b6
fix: make sandbox batch creation atomic (#373)
Floating-Y Oct 29, 2026
160b68e
feat(console): the tier flow as four rows, with each rate on its line…
WaylandYang Oct 29, 2026
86806ba
perf(node): netns pool, faster warm starts and in-place branch (#376)
WaylandYang Oct 29, 2026
0b56e28
Host groups: what their hosts are, following upgrades, placement acro…
WaylandYang Oct 29, 2026
9b9017e
feat(console): build a snapshot in a dialog with a terminal, and name…
WaylandYang Oct 29, 2026
13a7ed6
feat(console): rewrite the console in TypeScript and React (#382)
WaylandYang Oct 29, 2026
9d0d056
fix(release): stage only sandstormd (#383)
WaylandYang Oct 29, 2026
a43b883
fix: what a bare-metal comparison turned up (gateway waits, Firecrack…
WaylandYang Oct 30, 2026
b58f1d4
bench(baremetal): Sandstorm against Kata, microsandbox, CubeSandbox, …
WaylandYang Oct 30, 2026
62555cb
fix(gateway): wake a sandbox on disk again (#385)
WaylandYang Oct 30, 2026
85ef162
feat(console): choose a node's backend, and switch an empty one (#386)
WaylandYang Oct 30, 2026
aea6d5c
fix(node): count a sandbox still filling its memory against the floor…
WaylandYang Oct 30, 2026
a0d96f0
docs: a shorter README, this round's numbers, and the fleet's 2026-10…
WaylandYang Oct 30, 2026
6648136
fix(node): protect active sandboxes from demotion and reclaim (#381)
Floating-Y Oct 30, 2026
711e1ea
fix: enforce whole-batch capacity for pool scheduling (#377)
Floating-Y Oct 30, 2026
160e2bb
docs(readme): 中文首段 (#389)
WaylandYang Oct 30, 2026
c40260a
docs(readme): one paragraph to open with, in both languages (#390)
WaylandYang Oct 30, 2026
77e394f
perf(firecracker): no serial console on a PVM host (#397)
WaylandYang Oct 30, 2026
c23d9f1
docs(readme): one figure first, with cold starts and PVM (#395)
WaylandYang Oct 30, 2026
45ae732
docs(readme): link the projects named under the figure (#398)
WaylandYang Oct 30, 2026
44f5a2d
fix: include installer script in Docker build context (#396)
Floating-Y Oct 30, 2026
ec72976
fix(sdk): forward sandbox tokens in TypeScript helpers (#391)
Floating-Y Oct 30, 2026
c4f6296
fix(mcp): pass per-call sandbox tokens to guest tools (#392)
Floating-Y Oct 30, 2026
90740be
fix(node): preserve parent checkpoint after failed branch restore (#394)
Floating-Y Oct 30, 2026
fd0c04b
fix: preserve CA identity across master restarts (#393)
Floating-Y Oct 30, 2026
f097552
fix: send replies without waiting on Nagle (#400)
WaylandYang Oct 30, 2026
375bef5
docs(readme): a neutral license badge (#399)
WaylandYang Oct 30, 2026
d5601a4
fix: a wake of a sandbox already hot makes no room (#401)
WaylandYang Oct 30, 2026
6732022
docs(readme): order the badges (#402)
WaylandYang Oct 30, 2026
57c373b
docs(readme): split How it works into tiers and key features (#403)
WaylandYang Oct 30, 2026
d58ab87
docs(readme): retitle the lifecycle section and reword the Chinese (#…
WaylandYang Oct 30, 2026
6e3ba97
fix: the current E2B SDKs, and creates that follow a kill (#405)
WaylandYang Oct 30, 2026
9ae352f
docs(readme): key features that end their lines (#406)
WaylandYang Oct 30, 2026
1c334f2
docs: correct security policy for current runtime (#407)
Floating-Y Oct 30, 2026
c48ccac
chore: remove what the v0.5 CLI left behind, and rewrite the API docs…
WaylandYang Oct 30, 2026
bd615f8
feat(sdk-python)!: drive Sandbox through the master's API (#410)
WaylandYang Oct 30, 2026
68acf84
fix(node): remove a gVisor container that failed to start (#411)
WaylandYang Oct 30, 2026
d694bb1
docs(sdk-python): a program that fails to load now raises (#412)
WaylandYang Oct 30, 2026
9ab6005
docs: a tidier tiers table, and what was done for each backend (#413)
WaylandYang Oct 30, 2026
fd0dae5
fix(firecracker): let a restored guest through before setting its clo…
WaylandYang Oct 30, 2026
505dc52
bench: latency under gVisor, KVM and PVM on one build (#409)
WaylandYang Oct 30, 2026
612b5c8
docs: Firecracker has run on KVM now (#415)
WaylandYang Oct 31, 2026
4e856ef
fix(sdk-python): reach a master at its default address, ahead of v0.6…
WaylandYang Oct 31, 2026
cbb060f
feat(node): start a batch's creates side by side (#416)
WaylandYang Oct 31, 2026
5e099d5
fix(node): a warm image does not outlive the host files under it (#417)
WaylandYang Oct 31, 2026
80d119a
fix(node): a sandbox that dies on waking keeps its snapshot (#418)
WaylandYang Oct 31, 2026
f2300a0
fix(node): a sandbox waiting to retry costs no polls (#422)
WaylandYang Oct 31, 2026
ef7f84d
test(node): write the fake runsc from a child, so its exec cannot fai…
WaylandYang Oct 31, 2026
f56a3c9
fix(node): bind a port that was only just let go (#426)
WaylandYang Oct 31, 2026
6c9cae9
feat(egress): let a sandbox out, and say how far (#419)
WaylandYang Oct 31, 2026
5d26f72
feat(templates): make a template from a container image (#424)
WaylandYang Oct 31, 2026
3fb5b98
docs(readme): reword the note under the latency table (#427)
WaylandYang Oct 31, 2026
9e96dbd
fix(sdk)!: make every client work with a v0.6 master, and let them ve…
WaylandYang Oct 31, 2026
856dba5
docs(contributing): name feature branches feature/<short-name> (#428)
WaylandYang Oct 31, 2026
f7209cf
ci: scan Rust with CodeQL only when a PR touches it (#423)
WaylandYang Oct 31, 2026
1339d58
test(node): give a wake test the room it asks for (#429)
WaylandYang Oct 31, 2026
6121176
fix(proto): do not size an egress list from the request (#430)
WaylandYang Oct 31, 2026
3c3b245
fix(agent): listen on the guest's address, not every interface (#431)
WaylandYang Oct 31, 2026
ce5beff
docs(readme): a shorter quick start that reaches a sandbox, and a tru…
WaylandYang Oct 31, 2026
3714ea2
chore(release): prepare v0.6.0 (#433)
WaylandYang Nov 1, 2026
25b9485
fix(firecracker): carry on through an interrupted API read (#435)
WaylandYang Nov 1, 2026
d27ab7c
docs(changelog): date v0.6.0 (#436)
WaylandYang Nov 1, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
5 changes: 5 additions & 0 deletions .dockerignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Keep the build context small and never send host builds into the image.
target/
**/node_modules/
web/console/dist/
.git/
54 changes: 54 additions & 0 deletions .github/workflows/ci-release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
name: ci-release

# What release.yml builds, tried on a pull request. Those steps otherwise run
# only on a tag, so a Dockerfile that no longer builds or a binary that needs a
# newer glibc is found with the release half published.
on:
pull_request:
branches: [main, dev]
paths:
- 'Dockerfile'
- '.dockerignore'
- 'Cargo.toml'
- 'Cargo.lock'
- 'rust-toolchain.toml'
- 'crates/**'
- 'rootfs-init/**'
- 'packaging/install.sh'
- 'web/console/**'
- '.github/workflows/ci-release.yml'
- '.github/workflows/release.yml'

permissions:
contents: read

jobs:
docker:
name: build the Docker image
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
with:
context: .
file: Dockerfile
push: false
cache-from: type=gha

glibc:
name: keep the binary's glibc floor
# The runner release.yml builds on.
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v7
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- run: cargo build --release --locked -p sandstorm-core
# A weak version is one the binary runs without; only the others bind.
- name: Needs no glibc past 2.35
run: |
floor=$(readelf -V target/release/sandstormd \
| awk '/Name: GLIBC_/ && /Flags: none/ {print $3}' | sort -V | tail -1)
echo "needs $floor"
[ "$(printf '%s\nGLIBC_2.35\n' "$floor" | sort -V | tail -1)" = GLIBC_2.35 ]
19 changes: 18 additions & 1 deletion .github/workflows/ci-typescript.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,25 @@ on:
- 'sdk/typescript/**'
- '.github/workflows/ci-typescript.yml'

# Least privilege: both jobs only check out and test, so the default token
# -- which can carry write scope -- is more than they need. CodeQL's
# actions/missing-workflow-permissions flagged every job here.
permissions:
contents: read

jobs:
test:
name: build + test on Node ${{ matrix.node }}
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
node: ['18', '20', '22']
# 20 is the floor: vitest 4 declares `^20 || ^22 || >=24`, and npm 11
# -- which is needed to install it at all, see below -- itself wants
# node >= 20.17. Node 18 went end-of-life in April 2025, and the SDK
# publishes no runtime dependencies, so dropping it costs test
# coverage on an unmaintained runtime, not anything a consumer gets.
node: ['20', '22']
defaults:
run:
working-directory: sdk/typescript
Expand All @@ -30,6 +41,12 @@ jobs:
node-version: ${{ matrix.node }}
cache: 'npm'
cache-dependency-path: sdk/typescript/package-lock.json
# npm 10 cannot install vitest 4.1.x at all: Arborist crashes with
# `Cannot read properties of null (reading 'edgesOut')`, reproducible
# in an empty directory with no lockfile. Every 4.1.z fails, 4.0.0 and
# 3.2.7 succeed, and npm 11 handles 4.1.12 fine -- so this is a bug in
# npm, not in the lockfile, and the pinned major is the fix.
- run: npm install -g npm@11
- run: npm ci || npm install
- run: npm run lint
- run: npm run build
Expand Down
75 changes: 43 additions & 32 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ on:
pull_request:
branches: [main, dev]

# Least privilege: both jobs only check out and test, so the default token
# -- which can carry write scope -- is more than they need. CodeQL's
# actions/missing-workflow-permissions flagged every job here.
permissions:
contents: read

jobs:
rust:
runs-on: ubuntu-latest
Expand All @@ -15,6 +21,22 @@ jobs:
with:
components: rustfmt, clippy
- uses: Swatinem/rust-cache@v2
# The console is a TypeScript + React app (web/console) that build.rs
# embeds into sandstormd. Built first, so every binary below carries it;
# this also type-checks it.
- uses: actions/setup-node@v7
with:
node-version: 22
cache: 'npm'
cache-dependency-path: web/console/package-lock.json
- name: build the console
working-directory: web/console
run: npm ci && npm run build
- name: test the console
working-directory: web/console
run: npm test
- name: test the installer's backend choice
run: sh packaging/tests/install_backend.sh
- name: cargo fmt
run: cargo fmt --all -- --check
- name: cargo clippy
Expand All @@ -24,31 +46,11 @@ jobs:
- name: cargo test
run: cargo test --all

bench-python:
# Pure-stdlib Python tests for bench/pause-window/. No firecracker
# or daemon needed — the analyzer runs on synthetic event lists.
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-python@v7
with:
python-version: '3.12'
- name: analyze.py unit tests
working-directory: bench/pause-window
run: python -m unittest test_analyze.py -v
- name: agent / echo_server syntax
working-directory: bench/pause-window
run: |
python -m py_compile agent.py
python -m py_compile echo_server.py
- name: run.sh shellcheck-style parse
run: bash -n bench/pause-window/run.sh

agent-python:
# forkd-agent.py unit + stream tests. forkd-agent runs as PID 1 inside
# sandstorm-agent.py unit + stream tests. sandstorm-agent runs as PID 1 inside
# guest VMs; these exercise the pure-Python protocol logic (container-env
# PATH handling, BufferedLineReader coalesced-frame handling, stream
# lifecycle + process-group descendant cleanup) with no VM/firecracker.
# lifecycle + process-group descendant cleanup) with no sandbox runtime.
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
Expand All @@ -62,8 +64,8 @@ jobs:
python tests/test_agent_stream.py

sdk-python:
# SDK unit tests that need no firecracker/daemon — target parsing
# and the _send wire protocol against an in-process socket server.
# SDK unit tests that need no sandbox runtime/daemon — Sandbox and
# Controller against an in-process stand-in for the master.
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
Expand Down Expand Up @@ -91,11 +93,20 @@ jobs:
# setup-uv stopped publishing floating major tags after v7, so this
# one is pinned to an exact release while the rest track majors.
- uses: astral-sh/setup-uv@v9.0.0
- name: stdio handshake
run: >-
uv run --isolated --no-project
--with-editable ./sdk/mcp
--with anyio
--with pytest
--with '${{ matrix.mcp }}'
pytest -q sdk/mcp/tests/test_stdio.py
- name: stdio handshake and unit tests
env:
MCP: ${{ matrix.mcp }}
run: |
pins=()
# mcp 1.2.0 imports pydantic._internal._typing_extra.eval_type_backport,
# which pydantic 2.14.0 (2026-10-08) removed. Hold pydantic back on the
# floor leg only, so the tracking leg still surfaces real breakage.
if [[ "$MCP" == "mcp==1.2.0" ]]; then
pins+=(--with 'pydantic<2.14')
fi
uv run --isolated --no-project \
--with-editable ./sdk/mcp \
--with anyio \
--with pytest \
--with "$MCP" "${pins[@]}" \
pytest -q sdk/mcp/tests
44 changes: 44 additions & 0 deletions .github/workflows/codeql-rust.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: codeql-rust

# Apart from codeql.yml because Rust takes five minutes where the others take
# under one, and about two PRs in five do not touch it. Every push to a branch
# below and the weekly run still scan it all. A PR that skips this is not held
# up: only `rust` in ci.yml is a required check.
on:
push:
branches: [main, dev]
pull_request:
branches: [main, dev]
paths:
- 'crates/**'
- 'Cargo.toml'
- 'Cargo.lock'
- '.github/workflows/codeql-rust.yml'
schedule:
- cron: '17 3 * * 1'

# A new push to a PR makes the scan of the last one worthless.
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}

permissions:
contents: read

jobs:
analyze:
name: Analyze (rust)
runs-on: ubuntu-latest
permissions:
contents: read
security-events: write
steps:
- uses: actions/checkout@v7
- uses: github/codeql-action/init@v4
with:
languages: rust
build-mode: none
- uses: github/codeql-action/analyze@v4
with:
# The category default setup used, so alerts carry over.
category: /language:rust
43 changes: 43 additions & 0 deletions .github/workflows/codeql.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: codeql

# Rust is in codeql-rust.yml, which says why.
on:
push:
branches: [main, dev]
pull_request:
branches: [main, dev]
paths-ignore:
- '**/*.md'
- 'docs/**'
schedule:
- cron: '17 3 * * 1'

# A new push to a PR makes the scan of the last one worthless.
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}

permissions:
contents: read

jobs:
analyze:
name: Analyze (${{ matrix.language }})
runs-on: ubuntu-latest
permissions:
contents: read
security-events: write
strategy:
fail-fast: false
matrix:
language: [actions, javascript-typescript, python]
steps:
- uses: actions/checkout@v7
- uses: github/codeql-action/init@v4
with:
languages: ${{ matrix.language }}
build-mode: none
- uses: github/codeql-action/analyze@v4
with:
# The category default setup used, so alerts carry over.
category: /language:${{ matrix.language }}
6 changes: 4 additions & 2 deletions .github/workflows/publish-npm.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ on:

jobs:
publish:
name: build + upload @deeplethe/forkd to npm
name: build + upload @deeplethe/sandstorm to npm
runs-on: ubuntu-latest
environment: npm
permissions:
Expand All @@ -32,10 +32,12 @@ jobs:
ref="${GITHUB_REF#refs/tags/ts-v}"
pkg_ver=$(jq -r '.version' package.json)
if [[ "$pkg_ver" != "$ref" ]]; then
echo "::error::@deeplethe/forkd version ${pkg_ver} != release tag ${ref}"
echo "::error::@deeplethe/sandstorm version ${pkg_ver} != release tag ${ref}"
exit 1
fi

# Same reason as ci-typescript: npm 10 cannot install vitest 4.1.x.
- run: npm install -g npm@11
- run: npm ci || npm install
- run: npm run build
- run: npm test
Expand Down
10 changes: 5 additions & 5 deletions .github/workflows/publish-pypi-mcp.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
name: publish-pypi-mcp

# Publish the forkd-mcp package to PyPI. Parallels publish-pypi.yml
# Publish the sandstorm-mcp package to PyPI. Parallels publish-pypi.yml
# but for the sdk/mcp/ subdirectory and a separate package name, so
# forkd and forkd-mcp can release independently.
# sandstorm and sandstorm-mcp can release independently.
#
# Trigger:
# - push tag matching `mcp-v*` (e.g. mcp-v0.1.0)
Expand All @@ -12,7 +12,7 @@ name: publish-pypi-mcp
# project maintainer must register a pending publisher on PyPI at
# https://pypi.org/manage/account/publishing/ with:
# Owner: deeplethe
# Repository: forkd
# Repository: sandstorm
# Workflow: publish-pypi-mcp.yml
# Environment: pypi-mcp
# That bootstraps the project and lets this workflow upload without a
Expand All @@ -26,7 +26,7 @@ on:

jobs:
publish:
name: build + upload forkd-mcp to PyPI
name: build + upload sandstorm-mcp to PyPI
runs-on: ubuntu-latest
environment: pypi-mcp
permissions:
Expand All @@ -47,7 +47,7 @@ jobs:
if [ "${GITHUB_EVENT_NAME}" != "workflow_dispatch" ]; then
pkg_ver=$(grep -E '^version = ' sdk/mcp/pyproject.toml | head -1 | cut -d'"' -f2)
if [ "${pkg_ver}" != "${ref}" ]; then
echo "::error::forkd-mcp version ${pkg_ver} != release tag ${ref}"
echo "::error::sandstorm-mcp version ${pkg_ver} != release tag ${ref}"
exit 1
fi
fi
Expand Down
10 changes: 5 additions & 5 deletions .github/workflows/publish-pypi.yml
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
name: publish-pypi

# Publish the forkd Python SDK to PyPI when a GitHub Release is
# Publish the sandstorm Python SDK to PyPI when a GitHub Release is
# published. Uses PyPI's Trusted Publishers (OIDC) — no API token,
# no repository secret. The trust relationship is configured on PyPI:
# Owner=deeplethe, Repository=forkd, Workflow=publish-pypi.yml,
# Owner=deeplethe, Repository=sandstorm, Workflow=publish-pypi.yml,
# Environment=pypi.
#
# Trigger chain:
# push tag v* → release.yml builds binaries + creates GitHub Release
# → this workflow fires on the "release published" event
# → sdist + wheel uploaded to https://pypi.org/p/forkd
# → sdist + wheel uploaded to https://pypi.org/p/sandstorm-sdk
on:
release:
types: [published]
Expand All @@ -21,8 +21,8 @@ jobs:
runs-on: ubuntu-latest
# The `release: published` event fires on every release in the
# repo, including sibling packages with different tag prefixes
# (e.g. `mcp-v*` for `forkd-mcp`). Skip those — only forkd's own
# `v*` releases should publish the forkd SDK.
# (e.g. `mcp-v*` for `sandstorm-mcp`). Skip those — only sandstorm's own
# `v*` releases should publish the sandstorm SDK.
if: github.event_name == 'workflow_dispatch' || startsWith(github.event.release.tag_name, 'v')
environment: pypi # must match the GitHub environment + PyPI Trusted Publisher config
permissions:
Expand Down
Loading
Loading