Deterministic, dependency-free embedder for tests. Splits each input on whitespace, hashes each token to a bucket index, and accumulates a co

Tri-axis hormonal model with exponential decay to homeostasis. Reads + writes the singleton row in the `hormonal_state` table on every mutati

Pure decision-making agent. Stateless across games is the goal, but a small ring buffer of recent frames + last actions is kept in-memory for

Per-game hypothesis store backed by the `hypotheses` table.

Entity + relation store backed by SQLite. Holds a borrowed reference to a `MemoryStore`; does not own the connection lifecycle. Caller is res

Read + upsert API on top of the knowledge graph for arc_rule entities.

Logs ARC state transitions and scores novelty for prospective `(state, action)` pairs from the agent's per-turn loop.

BM25 + vector retrieval over the entity table, merged via RRF. The retriever caches a BM25 index across calls but invalidates it when the ent

Single-turn chat-completion client for a local vLLM server. Configurable via constructor or `VLLM_*` env vars: VLLM_BASE_URL default ht

All-in-one biological memory bundle for the Kaggle ARC agent.

An action extracted from LLM output. `kind` is 0 for RESET, 1..7 for ACTION1..7. `x`/`y` are set only for ACTION6 clicks. `rule_observed` and

Trace of one decision turn — useful for logs and replay.

Convenience view over an `arc_rule` entity.

`BAAI/bge-small-en-v1.5`-style embedder via `transformers`. Lazily loads the model on first `encode()` call to keep import-time cost zero. Lo

An ARC-AGI-3 observation, normalized for memory + prompts. Fields are explicit so the agent doesn't depend on the `arcengine` types directly

Immutable view of the hormonal state at a moment in time.

Owned handle to an opened bitterbot-memory SQLite database. Holds the raw `sqlite3.Connection`. Submodules accept this and run queries agains