pyproject.toml

[build-system]
requires = ["setuptools>=68"]
build-backend = "setuptools.build_meta"

[project]
name = "python-agent-harness"
version = "1.2.0"
description = "Python agent execution harness: agent loop, tools, plan/build modes, sessions"
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    "rich>=13.0",
    "httpx>=0.27",
    "prompt_toolkit>=3.0",
]

[project.optional-dependencies]
# MCP (Model Context Protocol) client support: exposes MCP server tools to
# the agent as namespaced mcp__<server>__<tool> tools.  Install with:
#   pip install -e ".[mcp]"
# The SDK is NOT a core dependency: the harness works without it, and the
# mcp/ modules degrade gracefully (MCPUnavailableError) when it is absent.
mcp = [
    "mcp>=2.0,<3",
]

# Tooling used by CI (lint + type check + wheel build + coverage + audit).
# Install with:  pip install -e ".[dev]"
# The mcp extra is included so CI's type-check/lint jobs can resolve the
# optional SDK imports in python_agent_harness/mcp/.
dev = [
    "ruff>=0.6",
    "pyright>=1.1.380",
    "build>=1.2",
    "coverage[toml]>=7.0",
    "pip-audit>=2.7",
    "mcp>=2.0,<3",
]

[project.scripts]
python-agent-harness = "python_agent_harness.cli:main"

[tool.setuptools.packages.find]
include = ["python_agent_harness*"]

[tool.setuptools.package-data]
python_agent_harness = ["prompts/*.md", "prompts/commands/*.md"]

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

[tool.ruff.lint]
# Core pyflakes (F) + pycodestyle error (E), plus import sorting (I),
# bugbears (B), pyupgrade (UP) and simplify (SIM).  The tree is clean
# under this set (CI blocks on it).
select = ["E", "F", "I", "B", "UP", "SIM"]
# E501 (line-too-long) is left to the formatter.
ignore = ["E501"]

[tool.pyright]
include = ["python_agent_harness"]
pythonVersion = "3.11"
# "basic" surfaces the real Optional-access issues without the full strict
# firehose. The tree is clean under this mode and the CI type-check job
# blocks on it.
typeCheckingMode = "basic"

[tool.coverage.run]
source = ["python_agent_harness"]
branch = true
# The console/TUI entry points aren't exercised by unittest; omit the ones
# that would otherwise drag the number down without adding signal.
omit = ["python_agent_harness/__main__.py"]

[tool.coverage.report]
show_missing = true
# Current line + branch coverage is ~98%. Gate at 90 to leave headroom for
# small changes while still catching real regressions. Raise as coverage grows.
fail_under = 90