---
url: >-
  https://adk.nht.io/api/batteries/orchestration/cells/lua/interfaces/CreateLuaCellOptions.md
description: >-
  The options accepted by [`createLuaCell`](https://adk.nht.io/api/batteries/orchestration/cells/lua/functions/createLuaCell). All optional; every field has a
  safe default.
---

# Interface: CreateLuaCellOptions

Defined in: [src/batteries/orchestration/cells/lua/index.ts:213](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/cells/lua/index.ts#L213)

The options accepted by [createLuaCell](../functions/createLuaCell.md). All optional; every field has a safe default.

## Properties

| Property                                                       | Modifier   | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                                                           | Defined in                                                                                                                                                    |
| -------------------------------------------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `instructionLimit?`     | `readonly` | `number` | The number of VM instructions between count-hook firings. Default 1,000,000. Lowering this tightens the instruction budget AND the secondary memory poll's latency (the poll runs inside the hook and raises the named abort before the allocator's hard failure), at the cost of more hook overhead. The hook is what stops `while true do end` from inside the VM.                                                                  | [src/batteries/orchestration/cells/lua/index.ts:220](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/cells/lua/index.ts#L220) |
|  `memoryCeilingBytes?` | `readonly` | `number` | The memory ceiling in bytes, ENFORCED by wasmoon's allocator cap (`setMemoryMax`). Default 64 MiB. The allocator refuses any growing realloc whose end size would exceed this. A secondary `getMemoryUsed` poll inside the count hook raises a clean named abort before the hard failure when it gets a firing first; an overshoot that beats the poll still hits the hard cap, and the host converts that to the same named failure. | [src/batteries/orchestration/cells/lua/index.ts:228](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/cells/lua/index.ts#L228) |
|  `timeoutMs?`                   | `readonly` | `number` | The wall-clock timeout in milliseconds before the worker-thread watchdog SIGKILLs the shared process. Default 5,000. This is the OUTER bound; the count hook is the inner one.                                                                                                                                                                                                                                                        | [src/batteries/orchestration/cells/lua/index.ts:233](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/cells/lua/index.ts#L233) |