pyproject.toml

# Project + tooling configuration for the Declarative Agent Platform.
#
# Foundation phase note: this file establishes packaging and the toolchain
# (ruff, mypy, pytest). YAML loading/validation is implemented; later product
# features (compiler, runtime, prompts, sidecar, tools, API) are built
# task-by-task (see tasks/).

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[tool.poetry]
package-mode = false

[project]
name = "agent-engine"
description = "A declarative platform for building AI agent systems (foundation phase)."
readme = "README.md"
requires-python = ">=3.11,<4.0"
license = { text = "MIT" }
authors = [{ name = "The Declarative Agent Platform contributors" }]
keywords = ["ai", "agents", "llm", "yaml", "declarative", "orchestration", "mcp"]
classifiers = [
    "Development Status :: 1 - Planning",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Topic :: Software Development :: Libraries :: Application Frameworks",
    "Typing :: Typed",
]
dynamic = ["version"]

# Runtime dependencies the platform will use as features land. Declaring them now
# keeps the environment consistent; importing them is deferred to later tasks.
dependencies = [
    "pydantic>=2.7",
    "pyyaml>=6.0",
    "jsonschema>=4.22",
    "typer>=0.12",
    "fastapi>=0.111",
    "uvicorn>=0.30",
    "httpx>=0.27",
    "jinja2>=3.1",
    "langgraph>=0.2",
    "langchain>=0.3",
    "langchain-core>=0.3",
    "mcp>=1.27,<2",
    "langchain-mcp-adapters>=0.2",
    "pyjwt>=2.9",
    "python-dotenv>=1.0",
    "pydantic-settings>=2.0",
    "click>=8.0",
    "sqlmodel>=0.0.16",
    "sqlalchemy[asyncio]>=2.0",
    "aiosqlite>=0.19",
    "alembic>=1.13",
    "langchain-anthropic>=1.4.5,<2.0.0",
    "langchain-aws>=0.2",
    "langchain-openai>=0.3",
    "langchain-google-genai>=2.0",
    "langfuse>=2.0",
    "asyncpg>=0.29",
    "langsmith>=0.8.18,<0.9",
]

[project.optional-dependencies]
dev = [
    "watchfiles>=0.21",
    "pytest>=8.0",
    "pytest-asyncio>=0.23",
    "ruff>=0.16.2,<0.17.0",
    "mypy>=1.10",
    # numpy is only a transitive dependency (via langchain-aws), but numpy >= 2.2
    # ships stubs that use PEP 695 `type` statements, which mypy rejects under
    # python_version = "3.11" and aborts the whole run (`make typecheck` fails on
    # a fresh install). Pin below 2.2 for dev environments until the mypy target
    # moves to 3.12+.
    "numpy<2.2",
]

# CLI entrypoint. `agentctl` is the working CLI name used throughout the docs
# (see docs/ARCHITECTURE.md and docs/ROADMAP.md); `agent-platform` is provided as
# an alias. The validation command is implemented; graph/run/serve commands are
# deferred to later tasks.
[project.scripts]
agentctl = "agentctl.main:cli"
agent-manager = "agent_manager.cli:main"

[project.urls]
Documentation = "https://github.com/example/agent-engine/tree/main/docs"

[tool.hatch.version]
path = "src/agent_engine/__init__.py"

[tool.hatch.build.targets.wheel]
packages = ["src/agent_engine", "src/agentctl", "src/agent_manager"]

[tool.ruff]
target-version = "py311"
line-length = 100
src = ["src", "tests"]

[tool.ruff.lint]
# A pragmatic senior-level default set: pyflakes/pycodestyle, imports, bugbear,
# pyupgrade, simplify, and a few quality rules.
select = ["E", "F", "W", "I", "B", "UP", "SIM", "C4", "RUF"]

[tool.ruff.lint.per-file-ignores]
"tests/**" = ["S101"]  # asserts are expected in tests

[tool.mypy]
# Strict-but-practical baseline: meaningful checks without making an early-stage
# package painful. Tightened toward full strictness as the codebase grows.
python_version = "3.11"
check_untyped_defs = true
warn_redundant_casts = true
warn_unused_ignores = true
warn_unused_configs = true
no_implicit_optional = true
ignore_missing_imports = true

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-q"
asyncio_mode = "auto"