Metadata-Version: 2.4
Name: agentforge-core
Version: 0.2.3
Summary: AgentForge core — stable contracts (ABCs, value types) for the agentic framework
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,contracts,framework,llm
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: opentelemetry-api>=1.27
Requires-Dist: pydantic>=2.10
Requires-Dist: python-ulid>=3.0
Description-Content-Type: text/markdown

# agentforge-core

The stable contract layer for AgentForge. ABCs, Protocols, and value
types that every module implements.

## What's in here

(Once feat-001 lands.)

- `LLMClient`, `EmbeddingClient` — provider abstractions
- `ReasoningStrategy` — agent loop shape
- `Tool` — pluggable capabilities
- `MemoryStore`, `GraphStore` — persistence
- `Evaluator` — post-run scoring
- `InputValidator`, `OutputValidator`, `ToolCallGate` — real-time safety
- `Finding` — output Protocol with shipped variants
- `BudgetPolicy`, `RunContext`, `RunIdFilter` — production rails
- Value types: `Claim`, `Step`, `RunResult`, etc.

This package is a **locked contract** — adding a method to an ABC is a
major version bump. See ADR-0007.

## What's NOT in here

- Reference implementations (`ReActLoop`, `InMemoryStore`, etc.) — those
  live in `agentforge`
- Provider clients — those live in `agentforge-anthropic`, etc.
- Anything that does I/O

## Install

```bash
pip install agentforge-core
```

Most users install `agentforge` directly, which depends on this package.

## License

Apache 2.0.
