Metadata-Version: 2.4
Name: boltzstack-engine
Version: 0.0.1
Summary: Reusable BoltzStack agent engine runtime.
Project-URL: Homepage, https://github.com/boltzstack/engine
Project-URL: Repository, https://github.com/boltzstack/engine
Project-URL: Issues, https://github.com/boltzstack/engine/issues
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic<1.0.0,>=0.40.0
Requires-Dist: genson<2.0.0,>=1.3.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: jinja2<4.0.0,>=3.1.6
Requires-Dist: openai<3.0.0,>=1.50.0
Requires-Dist: pydantic<3.0.0,>=2.7.0
Requires-Dist: pyyaml<7.0.0,>=6.0.2
Provides-Extra: jq
Requires-Dist: jq<2.0.0,>=1.11; extra == "jq"
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: ruff>=0.15.16; extra == "dev"
Requires-Dist: ty>=0.0.43; extra == "dev"
Dynamic: license-file

# BoltzStack Engine

`boltzstack-engine` is the reusable agent runtime for BoltzStack. It provides
the model loop, tool registry, context planning, hydration, artifact handles,
scoped memory, run traces, provider adapters, and sandbox runtime contracts.

## Development

Install the package in editable mode with development dependencies:

```bash
make install
```

Run the smoke tests:

```bash
make test
```

Run the full local check suite:

```bash
make check
```

## Minimal Usage

```python
from boltzstack_engine import AgentDefinition, AgentState
from boltzstack_engine.model_adapters.openai import openai_model_client_from_env

agent = AgentDefinition(
    name="support_agent",
    system_prompt="Answer with concise, evidence-backed responses.",
)
model_client = openai_model_client_from_env(system_prompt=agent.system_prompt)

if model_client is None:
    raise RuntimeError("No model provider is configured")

loop = agent.create_loop(model_client)
output = await loop.run("Summarize the latest run.", AgentState(), context={})
print(output.text)
```

Use the `boltzstack_engine` package namespace and `BoltzStack Engine`
terminology in docs and integrations.
