aif-normative-agent

PyPI distribution for the Norm-Native Agent SDK (normative_agent).

Thin HTTP client + Runtime tool loop over remote EDA, Normbase, and Schemo APIs. Does not ship Normbase, EDA server, Platform, MCP adapters, or Facilitator code.

Sibling package: aif-mcp (MCP tool surface over the same HTTP APIs).

Install

pip install aif-normative-agent
# optional DuckDuckGo fallback for built-in search_web:
pip install "aif-normative-agent[web]"

Editable install from monorepo (full-stack development):

pip install -e .
# at AIF repository root (aif-normbase)

SDK-only wheel build (this directory):

cd packaging/normative-agent
python sync_sources.py
python -m build --wheel
python verify_wheel.py dist/aif_normative_agent-0.3.8-py3-none-any.whl
python verify_wheel_imports.py dist/aif_normative_agent-0.3.8-py3-none-any.whl

Or from repo root:

pwsh ./scripts/publish/publish_normative_agent.ps1

Verify import

python -c "from normative_agent import NormativeAgent; print('ok')"

Configuration

Monorepo note

Source lives under normative_agent/, plus shared helpers ontology/schemo/client, ontology/schemo/contracts, and security/auth (same shared layer as aif-mcp).

Norm bind build logic stays in eda_agent/norm_projection.py (server). SDK formats EDA bound_norm_projections via normative_agent.situation.projection_format.

Developer guide: devkit/host-app/sdk/developer-guide.md (shipped with devkit; not in the wheel).

Host app docs: devkit/host-app/ — copy host-app/ folder to external projects.

Publish: pwsh ./scripts/publish/publish_normative_agent.ps1

Package scope

Bundled:

• normative_agent (Situation + Runtime)
• ontology.schemo.client / contracts
• security.auth

Not bundled:

• eda_agent, normbase, aif_platform, integrations, llm (docs live under devkit/host-app/sdk/)

Optional LLM semantic governance uses monorepo llm or inject your own ToolCallingModel / SemanticTriggerClassifier.