Metadata-Version: 2.4
Name: yaab-core
Version: 0.1.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3.11
License-File: LICENSE
Summary: Rust performance core for the YAAB agent SDK.
Home-Page: https://github.com/sthitaprajnas/yaab
Author: YAAB contributors
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# yaab-core

The Rust performance core for [YAAB](../README.md), exposed to Python via PyO3.

It provides the hot-path primitives the Python layer calls into:

- **vector** — cosine similarity + top-k for memory retrieval
- **checkpoint** — framed (de)serialization of graph state
- **channels** — state-channel reducers (last-value / append / add)
- **scheduler** — BSP superstep planning for the orchestration engine
- **actors** — tamper-evident hash-chaining + cost aggregation for the audit log

Every function has a pure-Python fallback in `yaab._core`, so the SDK installs
and runs without this extension. Build it for the accelerated path:

```bash
maturin develop -m yaab-core/Cargo.toml --release
```

