pyproject.toml

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

[project]
name = "agent-assembly"
version = "0.0.1rc3"
description = "Python SDK for AI Agent Assembly - A governance-native runtime for AI agents"
authors = [{ name = "Agent Assembly Team", email = "team@agent-assembly.dev" }]
requires-python = ">=3.12,<4.0"
readme = "README.md"
license = { file = "LICENSE" }
keywords = ["ai-agent", "governance", "mcp", "assembly", "runtime", "policy"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
]
dependencies = [
    "pydantic>=2.0.0,<3.0.0",
    "httpx>=0.27.0,<1.0.0",
    "typing-extensions>=4.0.0",
    # AAASM-1654 (PR-E): OpControlSubscriber consumes PolicyService.OpControlStream
    # via gRPC. Held to grpcio's modern stable line.
    "grpcio>=1.66,<2",
    "protobuf>=5,<8",
]

[project.optional-dependencies]
# Triggers the platform wheel that bundles the aasm sidecar binary at
# agent_assembly/bin/aasm. Empty list — selection is purely by the
# platform-tagged wheel that maturin produces, not by extra deps.
runtime = []
# Catch-all alias for users who want the full SDK + runtime install.
all = ["agent-assembly[runtime]"]

[project.scripts]
aasm = "agent_assembly.cli.main:main"

[project.urls]
Homepage = "https://github.com/AI-agent-assembly/python-sdk"
Repository = "https://github.com/AI-agent-assembly/python-sdk"

[dependency-groups]
dev = [
    "coverage~=7.10",
    "python-dotenv>=1.0.1,<2",
    # AAASM-1654 (PR-E): grpcio-tools provides protoc + Python plugin used by
    # scripts/gen_proto.py to regenerate agent_assembly/proto/*_pb2*.py from
    # the sibling agent-assembly/proto/ checkout.
    "grpcio-tools>=1.66,<2",
    { include-group = "lint" },
    { include-group = "test" },
]
lint = [
    "ruff>=0.1.0",
    "mypy>=1.11,<3",
]
test = [
    "pytest>=8.1.1,<10",
    "pytest-cov>=5.0.0,<8",
    "pytest-rerunfailures>=14.0,<17",
    "pytest-asyncio>=0.23.0,<2",
    "pytest-benchmark>=4.0.0,<6",
    # AAASM-2943: dev/test-only (NOT a runtime dependency). Installing the
    # framework lets the `importorskip`-guarded Pydantic AI integration tests
    # run in CI (the `dev` group includes `test`, and the integration-test job
    # installs `dev`), so the function-tool governance regression is actually
    # exercised instead of skipped.
    "pydantic-ai>=0.3.0",
    # AAASM-3528: dev/test-only (NOT a runtime dependency). The shipped OpenAI
    # Agents framework is the top-level `agents` package (NOT `openai.agents`),
    # and a tool runs via its per-instance `on_invoke_tool` coroutine (NOT a
    # `FunctionTool.__call__`). Installing it lets the `importorskip`-guarded
    # integration test drive a real tool call, so a regression to the old
    # fail-open no-op patch is actually caught instead of silently skipped.
    "openai-agents>=0.1.0",
    # AAASM-3539: dev/test-only (NOT a runtime dependency). smolagents routes
    # every tool execution through `smolagents.tools.Tool.__call__` (which calls
    # `self.forward`); installing it lets the `importorskip`-guarded adapter
    # tests drive a real `Tool` subclass, so a regression to a fail-open no-op
    # patch is caught (deny must block `forward`) instead of silently skipped.
    "smolagents>=1.0.0,<2.0.0",
    # AAASM-3537: dev/test-only (NOT a runtime dependency). Agno (formerly
    # Phidata) runs every function-tool body through
    # `agno.tools.function.FunctionCall.execute` / `aexecute`. Installing it lets
    # the `importorskip`-guarded integration test drive a real `FunctionCall`, so
    # the negative-control deny test fails if the patch ever regresses to a no-op
    # instead of being silently skipped.
    "agno>=2.0.0",
    # AAASM-3536: dev/test-only (NOT a runtime dependency). LlamaIndex routes
    # tool execution through the concrete `FunctionTool.call` / `acall` methods;
    # installing it lets the `importorskip`-guarded governance tests drive a
    # real `FunctionTool` so a regression to a fail-open no-op patch is caught
    # rather than silently skipped.
    "llama-index-core>=0.10.0",
]
pre-commit-ci = [
    "pre-commit>=3.5.0,<5",
    "pylint>=3.1.0,<5",
    { include-group = "lint" },
]
# AAASM-4034: dev/test-only (NOT a runtime dependency) and DELIBERATELY excluded
# from `default-groups`. The default suite must stay langchain-free so the
# existing callback-delegation tests keep exercising the empty
# `_FallbackBaseCallbackHandler` fallback. Installing `langchain-core` swaps the
# real `langchain_core.callbacks.BaseCallbackHandler` in as the base of
# `AssemblyCallbackHandler`, which lets the `importorskip`-guarded contract test
# prove the AAASM-4014 `__getattr__` never shadows or synthesizes a real
# LangChain callback-contract member. Run it with:
#   uv sync --group langchain-test
#   .venv/bin/python -m pytest test/unit/adapters/langchain/test_getattr_contract_with_langchain.py
langchain-test = [
    { include-group = "test" },
    "langchain-core>=0.3.0,<1.5.0",
]
docs = [
    "mkdocs>=1.6.0,<2",
    "mkdocs-material>=9.5.0,<10",
    "mkdocstrings>=0.24.0,<2",
    "mkdocstrings-python>=1.10.0,<3",
    "mike>=2.1.0,<3",
    "mkdocs-autorefs>=1.0.0,<2",
    "mkdocs-git-revision-date-localized-plugin>=1.2.0,<2",
    "mkdocs-git-authors-plugin>=0.9.0,<1",
]

[tool.uv]
default-groups = [
    "dev",
    "pre-commit-ci",
]

[tool.maturin]
manifest-path = "native/aa-ffi-python/Cargo.toml"
module-name = "agent_assembly._core"
python-source = "."
bindings = "pyo3"
features = ["pyo3/extension-module"]
# aasm sidecar binary is placed at agent_assembly/bin/aasm by the release
# workflow before `maturin build`; runtime.py's find_aasm_binary() resolves
# WHEEL_BUNDLED_BIN to that same path at import time.
include = [
    { path = "agent_assembly/bin/aasm", format = "wheel" },
    { path = "agent_assembly/bin/aasm.exe", format = "wheel" },
]

[tool.hatch.build.targets.sdist]
include = ["agent_assembly/"]
packages = ["agent_assembly"]
#artifacts = ["agent_assembly/py.typed"]

[tool.hatch.build.targets.wheel]
include = ["agent_assembly/"]
packages = ["agent_assembly"]
#artifacts = ["agent_assembly/py.typed"]