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

pip install agentforge-core

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

License

Apache 2.0.

Metadata

Release files for agentforge-core 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentforge-core 0.4.0
File	Size	Uploaded
agentforge_core-0.4.0.tar.gz	124.0 kB	Jun 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for agentforge-core 0.4.0
File	Interpreter	ABI	Platform	Reset
agentforge_core-0.4.0-py3-none-any.whl 109.8 kB Jun 24, 2026	Python 3	none	any	Details

Total release size: 233.8 kB

Release files / agentforge_core-0.4.0.tar.gz

Download URL	agentforge_core-0.4.0.tar.gz
Size	124.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`f78a53070077b0e894145690542b119d3dab5294fa0fa579c2f2a15a8212cb40`
BLAKE2b-256 checksum How to use checksums	`2b94223cfa47c23873ac0df32fc5f08d637490da8e45878ac5edb26e6f6f103e`
Upload date	Jun 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Scaffoldic/agentforge-py
Publishing commit: github.com/Scaffoldic/agentforge-py/tree/be9bf8607d24c7e0916e4c6d8d2eb8ce88c3633f

Workflow

Publishing configuration: github.com/Scaffoldic/agentforge-py/blob/be9bf8607d24c7e0916e4c6d8d2eb8ce88c3633f/.github/workflows/release.yml
Publishing logs: github.com/Scaffoldic/agentforge-py/actions/runs/28097295575/attempts/3

Artifact

Subject: agentforge_core-0.4.0.tar.gz
SHA-256 checksum: f78a53070077b0e894145690542b119d3dab5294fa0fa579c2f2a15a8212cb40 Verifying attestations

Release files / agentforge_core-0.4.0-py3-none-any.whl

Download URL	agentforge_core-0.4.0-py3-none-any.whl
Size	109.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ee91c6216175740e0a8d5fa40aa2f20e9c8c9cf457ad92978d6878c9c412a4c7`
BLAKE2b-256 checksum How to use checksums	`e09bb56476948cf6f90e3bf6a4243a143726e1ed39221bc328ab0f1be465f619`
Upload date	Jun 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Scaffoldic/agentforge-py
Publishing commit: github.com/Scaffoldic/agentforge-py/tree/be9bf8607d24c7e0916e4c6d8d2eb8ce88c3633f

Workflow

Publishing configuration: github.com/Scaffoldic/agentforge-py/blob/be9bf8607d24c7e0916e4c6d8d2eb8ce88c3633f/.github/workflows/release.yml
Publishing logs: github.com/Scaffoldic/agentforge-py/actions/runs/28097295575/attempts/1

Artifact

Subject: agentforge_core-0.4.0-py3-none-any.whl
SHA-256 checksum: ee91c6216175740e0a8d5fa40aa2f20e9c8c9cf457ad92978d6878c9c412a4c7 Verifying attestations