Skip to main content

Packages

Four independently versioned packages live under packages/. Each ships its own wheel and CHANGELOG; consumers pick the subset they need.

foundry-agent-core​

DI container, protocol definitions, type primitives, exception hierarchy, agent lifecycle, masking/redaction helpers. No runtime dependencies on other packages in this repo.

foundry-agent-config​

YAML configuration loader with environment-variable overrides (double-underscore nesting), bounded input controls, and Pydantic-based schema validation. No runtime dependencies on other packages in this repo.

foundry-agent-fastapi​

CORS / error / logging middleware, request/response models, mappers between domain types and HTTP DTOs, a health router. Depends on: foundry-agent-core.

foundry-strands-agent​

AWS Strands SDK adapter — StrandsAgentBackend, factory, orchestrator, tool loader, chat historian. Depends on: foundry-agent-core, foundry-agent-config.

Dependency graph​

foundry-agent-core ←── foundry-agent-fastapi
       ↑
       ├──────────────── foundry-strands-agent
       │                        ↑
foundry-agent-config ───────────┘

Every arrow is a hard runtime dependency. foundry-agent-core and foundry-agent-config are leaves; consumers that only need configuration loading can install foundry-agent-config standalone, and consumers that only need the DI container can install foundry-agent-core standalone.