Ephemeral Machine Proposal

Aperta
  • Qualcosa non va?
#634 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
18/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
postgresql, rust
Ambito
backend, databases

Direzione di ricerca

The proposal is named as core/docs/proposals/ephemeral-machine.md, but the payload does not include its contents or implementation entry points. Start by reading that proposal and the linked follow-up #547 to identify the scoped work and relevant files. The issue describes lease, idempotency, reconciliation, and a Cloud Store adapter, but does not specify acceptance criteria for completion.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Spec

Committed on branch ephemeral-machine:

This is a 3.0 proposal, not a 2.0 implementation. The 2.0 control-plane contract is mirrored separately in Ephemeral-AI-Lab/layerfs-project#23.

Definition

An Ephemeral Machine is:

ephemeral execution lease
+ durable Cloud Store

It is not a durable machine, and phase 1 does not use a long-lived worker.

Visual mood

Galactic Cherry Blossom

Poetic, vast, calm: a bloom that opens and disperses against a durable field — the permanent Cloud Store, the ephemeral machine-run.

Image: Galactic Cherry Blossom (NGC 1156) — ESA/Hubble, NASA · CC BY 4.0 · source

Cherry Blossoms in the Sky

Emotional, airy: sky and drifting petals — drift, not decay; each petal a passing tool call.

Image: Cherry Blossoms in the Sky — Chrissy Downunder · CC BY-NC 2.0 (non-commercial) · source

Reference diagrams

2.0 local machine — architecture

2.0 local machine architecture

2.0 local machine — interaction sequence

2.0 local machine interaction sequence

3.0 ephemeral machine — architecture

3.0 ephemeral machine architecture

3.0 ephemeral machine — interaction sequence

3.0 ephemeral machine interaction sequence

Worker distinction

2.0 local machine 3.0 ephemeral machine
worker long-lived process, one per machine none
worker_server TCP accept loop inside worker none
endpoint machine-local loopback + secret none; control uses the E2B command API
execution unit worker handles many calls machine-run handles one tool call
Store authority worker holds Store lease/cache Cloud Store only; sandbox cache is replaceable
pause not a correctness mechanism optional runtime extension; never correctness

Phase 1

control -> E2B API (create, commands.run, kill)
  -> machine-run (one-shot)
     mount branch
     exec tool call
     workspace.commit
     unmount
  -> kill

No inbound raw TCP, no WSS worker endpoint, no long-lived worker.

Durability rules

PostgreSQL / Store gateway only
no remote SQLite
commit after every tool call
timeout after commit safe
timeout before commit = Unknown
retry the tool call, never replay the commit
pause/setTimeout optional for runtime extension

Follow-up boundary

  • 2.0 control-plane liveness/recovery: #66 (mirror of upstream layerfs-project#23/#24/#25/#29)
  • Upstream open implementation follow-up: Ephemeral-AI-Lab/layerfs#547
  • 3.0 ephemeral machine owns lease/idempotency/reconciler/Cloud Store adapter
Lingua principale
Rust
Stelle
2.1k
Fork
110
Merge medio
23h 52m
PR unite (30g)
138

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di Ephemeral-AI-Lab/layerfs

Tutte le issue di Ephemeral-AI-Lab/layerfs

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.