UnixImageImpl

Defined in: packages/core/src/image.ts:35

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)

Implements

• UnixImage

Constructors

Constructor

new UnixImageImpl(init): UnixImageImpl

Defined in: packages/core/src/image.ts:42

Parameters

init

ImageInit

Returns

UnixImageImpl

Properties

buildCache

readonly buildCache: BuildCache

Defined in: packages/core/src/image.ts:40

---

layerStore

readonly layerStore: LayerStore

Defined in: packages/core/src/image.ts:38

Content-addressable store of all layers in this image.

Implementation of

UnixImage.layerStore

---

topLayerId

readonly topLayerId: string | undefined

Defined in: packages/core/src/image.ts:39

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

Implementation of

UnixImage.topLayerId

Methods

createBootContext()

createBootContext(): BootContext

Defined in: packages/core/src/image.ts:50

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

Returns

BootContext

Implementation of

UnixImage.createBootContext

---

extend()

extend(): UnixBuilder

Defined in: packages/core/src/image.ts:62

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

Returns

UnixBuilder

Implementation of

UnixImage.extend