Jido.Agent.State (Jido v2.3.0)

Internal helper module for agent state management.

This module is internal to the Agent implementation. Its API may change without notice.

Handles deep merging and validation of agent state.

Summary

Builds initial state from schema defaults.

Merges new attributes into existing state using deep merge semantics.

Validates state against a schema (NimbleOptions or Zoi). Returns validated state as a map.

@spec defaults_from_schema(term()) :: map()

Builds initial state from schema defaults.

@spec merge(map(), map() | keyword()) :: map()

Merges new attributes into existing state using deep merge semantics.

@spec validate(map(), term(), keyword()) :: {:ok, map()} | {:error, term()}

Validates state against a schema (NimbleOptions or Zoi). Returns validated state as a map.

By default (non-strict mode), extra fields not in the schema are preserved. In strict mode, only schema-defined fields are kept.