aif-normative-agent 0.3.6

Norm-Native Agent SDK — Harness + Host loop over EDA / Normbase / Schemo HTTP APIs

aif-normative-agent

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

Thin HTTP client + Host 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

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.6-py3-none-any.whl
python verify_wheel_imports.py dist/aif_normative_agent-0.3.6-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

Variable	Purpose
AIF_AGENT_API_KEY	Agent API key for NormativeAgent.from_api_key
AIF_PLATFORM_URL	When set, SDK routes EDA/Normbase/Schemo via Platform integrator (recommended for external apps)
EDA_BASE_URL	EDA HTTP API when not using Platform mode (default http://localhost:8002)
NORMBASE_BASE_URL	Normbase HTTP API when not using Platform mode (default http://localhost:8001)
SCHEMO_QUERY_BASE_URL	Schemo read API when not using Platform mode
AIF_INTERNAL_SERVICE_TOKEN	Optional internal Bearer for mixed deployments

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.harness.projection_format.

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

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

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

Package scope

Bundled:

• normative_agent (Harness + Host)
• ontology.schemo.client / contracts
• security.auth

Not bundled:

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

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