Repository navigation
v0.11.0: Merge pull request #183 from pandemicsyn/changeset-release/main
Beachside v0.11.0
@beachside/adapter
Minor Changes
-
#187
ae8c05aThanks @pandemicsyn! - Snapshots can carry labels.snapshot({ labels })sets them at capture where the adapter keeps them, andsnapshots.list({ labels })keeps only matching snapshots.- Adapters: an adapter opts in with
snapshotCapture.labels: true, and listedSnapshotInforeportslabels. Elsewhere a labelled capture is rejected before anything is captured. - Capability:
capabilities().snapshots.capture.value.labelssays whether labels are kept. - Runloop: labels are stored as snapshot metadata, next to the adapter's own
beachside_keys, which stay reserved. - Setup:
box.runSetup()takesenvfor every step, kept out of the digest, andrunStartup: false, which records startup steps without running them so a snapshot can be taken in between.
Setup.parallel([...steps])runs setup steps at the same time as one step; its steps' events and output carrystep.group. - Adapters: an adapter opts in with
beachside
Minor Changes
-
#187
ae8c05aThanks @pandemicsyn! - Sandboxes can now be set up as they start.sandboxes.create(),sandboxes.with()andsnapshot.restore()takesetup(steps that run once per sandbox: shell lines, argv arrays, inline scripts orSetup.file()scripts) andstartup(steps that run whenever the sandbox comes up without its processes, including after a freshresume()).Setup.define()makes named setups that compose. Beachside runs the steps overexecon every provider, streams their output throughonSetupOutput, records progress in the sandbox so a restored snapshot skips setup it already holds, and throwsSetupFailedErrornaming the failed step. A sandbox whose setup fails is destroyed unlessonSetupFailure: "keep".box.runSetup()runs setup on an existing sandbox. -
#187
ae8c05aThanks @pandemicsyn! - Snapshots can carry labels.snapshot({ labels })sets them at capture where the adapter keeps them, andsnapshots.list({ labels })keeps only matching snapshots.- Adapters: an adapter opts in with
snapshotCapture.labels: true, and listedSnapshotInforeportslabels. Elsewhere a labelled capture is rejected before anything is captured. - Capability:
capabilities().snapshots.capture.value.labelssays whether labels are kept. - Runloop: labels are stored as snapshot metadata, next to the adapter's own
beachside_keys, which stay reserved. - Setup:
box.runSetup()takesenvfor every step, kept out of the digest, andrunStartup: false, which records startup steps without running them so a snapshot can be taken in between.
Setup.parallel([...steps])runs setup steps at the same time as one step; its steps' events and output carrystep.group. - Adapters: an adapter opts in with
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/daytona
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/e2b
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/boxd
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/boat
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/runloop
Minor Changes
-
#187
ae8c05aThanks @pandemicsyn! - Snapshots can carry labels.snapshot({ labels })sets them at capture where the adapter keeps them, andsnapshots.list({ labels })keeps only matching snapshots.- Adapters: an adapter opts in with
snapshotCapture.labels: true, and listedSnapshotInforeportslabels. Elsewhere a labelled capture is rejected before anything is captured. - Capability:
capabilities().snapshots.capture.value.labelssays whether labels are kept. - Runloop: labels are stored as snapshot metadata, next to the adapter's own
beachside_keys, which stay reserved. - Setup:
box.runSetup()takesenvfor every step, kept out of the digest, andrunStartup: false, which records startup steps without running them so a snapshot can be taken in between.
Setup.parallel([...steps])runs setup steps at the same time as one step; its steps' events and output carrystep.group. - Adapters: an adapter opts in with
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/freestyle
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/modal
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/vercel
Patch Changes
- Updated dependencies [
ae8c05a]:- @beachside/adapter@0.11.0
@beachside/cli
Minor Changes
-
#187
ae8c05aThanks @pandemicsyn! - Setup scripts:createandruntake--setup <name|path>,--setup-cmd '<shell>',--startup <path>and--startup-cmd '<shell>', which run in the new sandbox once it starts.- Named setups:
setupsinbeachside.jsondefines reusable setups withextends,networkandenv, and a profile'ssetuplist applies by default (--no-default-setupskips it).beachside setup lslists them. - Startup: startup steps run at create and again after every
create --snapshotrestore. - Failures: a failed step exits 9 with
SETUP_FAILED.createkeeps the sandbox, or removes it with--rm-on-failure; the record shows each step's outcome. - Rerun:
beachside setup <sandbox>reruns only the missing steps, and--forcereruns everything. - Add-ons:
--withinstalls its servers through the same setup engine.
Setup caches: a setup with
"cache": true(orcreate --cache) is snapshotted after setup and before startup. The next create with the same setup restores it and runs onlycache: falsesteps and startup.- The key covers the provider, scope, profile, image, every step and the files in
cache.files. - Freshness: caches go stale after
maxAge(7 days by default) and are rebuilt on the next create. - Secrets: a setup whose env holds secrets is refused unless it sets
secrets: "allow". - Commands:
beachside setup cache ls|rm|prunemanages caches, andgcprunes stale ones.--no-cacheand--refresh-cachecontrol one create.
Setups can also come from a repository: with
"projectSetups": trueorBEACHSIDE_PROJECT_SETUPS=1, the CLI reads.beachside/setup.json(setupsplusdefault) from the checkout. A step can be{ "parallel": [...] }to run several steps at once as one setup step. - Named setups:
-
#184
05f225dThanks @pandemicsyn! -beachside create --with rex|herdrinstalls a server in the new sandbox and puts it on your Tailscale tailnet, with the auth key fromTAILSCALE_AUTH_KEYsent only over stdin.- Rex: runs on Rex's own Tailscale, and
createwaits for its HTTPS address. - herdr: gets a Tailscale SSH device to attach to with
herdr --remote. - Connection details:
createandinspectprint how to connect, the sandbox record keeps the add-ons, andrmlogs each device out of the tailnet. - Network:
--withimplies--network internet.
A create the provider rejects with no image set now keeps the provider's own message, rather than always saying an image is needed. Previously an E2B lifetime over its cap read as "needs an image".
- Rex: runs on Rex's own Tailscale, and
Patch Changes
- #182
1577530Thanks @pandemicsyn! - The bundledbeachside-cliskill now shows agents Rex's exact split-pane commands:rex run --split=right -s "$REX_SESSION" --keep-open --json, thenrex waitandrex captureby the saved pane id. It also explains how to start a Rex server inside a sandbox, following the Rex guide. - Updated dependencies [
ae8c05a,ae8c05a]:- beachside@0.11.0
- @beachside/adapter@0.11.0