---
url: 'https://adk.nht.io/api/batteries/orchestration/cells/lua/interfaces/LuaCell.md'
description: >-
  The type of the cell returned by [`createLuaCell`](https://adk.nht.io/api/batteries/orchestration/cells/lua/functions/createLuaCell). It is a {@link
  PredicateEvaluator} with one extra field, `status()`, for inspecting the
  enforcement guarantee.
---

# Interface: LuaCell

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

The type of the cell returned by [createLuaCell](../functions/createLuaCell.md). It is a [PredicateEvaluator](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md) with
one extra field, `status()`, for inspecting the enforcement guarantee.

## Extends

* [`PredicateEvaluator`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md)

## Properties

| Property                      | Modifier   | Type     | Description                                                                                    | Inherited from                                                                                                                                                                                                                | Defined in                                                                                                                                  |
| ----------------------------- | ---------- | -------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|  `id` | `readonly` | `string` | How a node names this cell in `evaluator`. Cells merge by this id across construction and run. | [`PredicateEvaluator`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md).[`id`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md#property-id) | [src/batteries/orchestration/types.ts:1072](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/types.ts#L1072) |

## Methods

### evaluate()

```ts
evaluate(node: PlanNode, ctx: PredicateContext): Promise<PredicateVerdict>;
```

Defined in: [src/batteries/orchestration/types.ts:1081](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/types.ts#L1081)

Decide the node's outcome. Called once per frame reaching the node.

#### Parameters

| Parameter | Type                                                                                                         |
| --------- | ------------------------------------------------------------------------------------------------------------ |
| `node`    | [`PlanNode`](../../../../../@nhtio/adk/batteries/orchestration/types/type-aliases/PlanNode.md)               |
| `ctx`     | [`PredicateContext`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateContext.md) |

#### Returns

`Promise`<[`PredicateVerdict`](../../../../../@nhtio/adk/batteries/orchestration/types/type-aliases/PredicateVerdict.md)>

#### Inherited from

[`PredicateEvaluator`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md).[`evaluate`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md#evaluate)

***

### load()

```ts
load(): Promise<void>;
```

Defined in: [src/batteries/orchestration/types.ts:1077](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/types.ts#L1077)

Acquire whatever the cell needs — typically an optional peer. Awaited at construction, so a
missing peer fails at boot with a named error rather than part-way through a freeze.

#### Returns

`Promise`<`void`>

#### Inherited from

[`PredicateEvaluator`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md).[`load`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md#load)

***

### status()

```ts
status(): LuaCellStatus;
```

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

Returns the enforcement guarantee this instance is delivering. See [LuaCellGuarantee](../type-aliases/LuaCellGuarantee.md).
A cell that could not install a count hook or whose allocator cap probe failed reports
`watchdog-only` here rather than claiming a `full` guarantee.

#### Returns

[`LuaCellStatus`](LuaCellStatus.md)

***

### validate()

```ts
validate(node: PlanNode): Promise<void>;
```

Defined in: [src/batteries/orchestration/types.ts:1079](https://github.com/NHTIO/ADK/blob/v1.20260906.0/src/src/batteries/orchestration/types.ts#L1079)

Reject a predicate shape this cell cannot use. Called at freeze, so refusal precedes approval.

#### Parameters

| Parameter | Type                                                                                           |
| --------- | ---------------------------------------------------------------------------------------------- |
| `node`    | [`PlanNode`](../../../../../@nhtio/adk/batteries/orchestration/types/type-aliases/PlanNode.md) |

#### Returns

`Promise`<`void`>

#### Inherited from

[`PredicateEvaluator`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md).[`validate`](../../../../../@nhtio/adk/batteries/orchestration/types/interfaces/PredicateEvaluator.md#validate)