Metadata-Version: 2.4
Name: metatotai
Version: 0.0.1
Summary: metatotai — placeholder. Active-inference-driven meta tree-of-thought planning engine. Real implementation lands in 0.1.0.
Author-email: Mani Saint-Victor <drmani215@gmail.com>
Maintainer-email: Mani Saint-Victor <drmani215@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/bionicbutterfly13/metatotai
Keywords: active-inference,tree-of-thought,meta-tot,free-energy,planning,agent
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# metatotai

> **Status: name reserved. Real implementation arrives in 0.1.0.**

`metatotai` will be an active-inference-driven meta tree-of-thought planning engine — a deterministic, replay-safe decision layer that consumes [`elume`](https://pypi.org/project/elume/)'s cognitive substrate and [`linoss-dynamics`](https://pypi.org/project/linoss-dynamics/) physics primitives.

## What this will be

- **Active-inference engine** — variational free energy + expected free energy computation, belief updates, policy scoring.
- **Meta tree-of-thought planner** — search and expansion over reasoning trajectories, scored by free-energy minimization rather than LLM-graded floats.
- **Theory of mind** — `PartnerModel` for inferring other agents' beliefs from observed behavior, built on `elume.MentalModel`.
- **Provider-injected** — `LLMProvider`, `MemoryProvider`, `WorldModelProvider`, `TraceSink` protocols. Bring your own backend.

## What this is not

- **Not** a fork of [`kyegomez/Meta-Tree-Of-Thoughts`](https://github.com/kyegomez/Meta-Tree-Of-Thoughts). That is a LangChain-based prompt-rewriting meta-agent over LLM scoring; this is a different system. Zero shared code. Distinct name to avoid confusion.
- **Not** the original Tree of Thoughts (Yao et al. 2023). Different mechanism.

## Layering

```
linoss-dynamics  ← physics primitive (NumPy)
       ↑
   elume         ← cognitive substrate (mental models, basins, evolution)
       ↑
   metatotai     ← active-inference + meta-ToT planning
```

## Install (when 0.1.0 ships)

```bash
pip install metatotai
```

## License

MIT.
