UnixImage

Defined in: packages/core/src/kernel/types.ts:1055

Frozen, immutable system configuration. Multiple instances can boot from one image.

Remarks

An image is produced by UnixBuilder.build() and contains frozen filesystem layers, merged env defaults, and service declarations. Boot via a runtime (e.g., testRuntime().boot(image)) to create a live UnixInstance with a fresh writable overlay on top of the frozen base.

Example

const image = await Unix().use(stdSystem()).build()
// Boot multiple agents from the same image
const a = await testRuntime().boot(image)
const b = await testRuntime().boot(image)

Properties

layerStore

readonly layerStore: LayerStore

Defined in: packages/core/src/kernel/types.ts:1061

Content-addressable store of all layers in this image.

---

topLayerId

readonly topLayerId: string | undefined

Defined in: packages/core/src/kernel/types.ts:1063

ID of the topmost layer (most recent .run() step, or base). undefined only if image has no FS.

Methods

createBootContext()

createBootContext(): BootContext

Defined in: packages/core/src/kernel/types.ts:1057

Create the boot context consumed by a runtime’s boot procedure.

Returns

BootContext

---

extend()

extend(): UnixBuilder

Defined in: packages/core/src/kernel/types.ts:1059

Derive a new UnixBuilder pre-loaded with this image’s frozen layers.

Returns

UnixBuilder