aap-ref-lib-py

Python reference implementation of the Agent Acknowledgment Protocol (AAP) — typed acknowledgment events, the §7.2 reference weighting function, and a simple reputation derivation.

Install

pip install aap-manifest

What's in the box

Usage

from aap_manifest import (
    AcknowledgmentEvent, Issuer, Subject,
    compute_weight, InMemoryAcknowledgmentStore,
)

ev = AcknowledgmentEvent(
    id="urn:uuid:5f8a3c2e-…",
    type="ENDORSEMENT",
    issuer=Issuer(did="did:tutus:0xacme", key_id="did:tutus:0xacme#k"),
    subject=Subject(did="did:web:example.com:agents:code-reviewer"),
    signature=Signature(alg="EdDSA", value="…"),
    issued_at="2026-05-20T14:32:00Z",
)

result = compute_weight(ev, issuer_trust=0.8)   # value_weight applies only when verified

store = InMemoryAcknowledgmentStore()
store.append(ev)                                 # raises on duplicate id (§9.3)
rep = store.reputation("did:web:example.com:agents:code-reviewer")

Reference weight (spec §7.2)

weight = type_weight × issuer_trust × value_weight × witness_factor × time_decay

• value_weight = 1 + log10(1 + usd_equivalent) applies only when the settlement reference is verified (§6.3); otherwise 1.
• witness_factor = 1 + 0.25 × min(independent_witnesses, 4).
• time_decay = exp(−Δt/τ), τ = 18 months; omit now for no decay.
• A WITHDRAWAL zeroes the weight (positive-only vocabulary, §9.1).

This is the informative AAP reference. The normative aggregation — issuer-diversity penalty, recursive-trust bound, mandatory settlement verification — lives in AAR §9 and ships in the aar-manifest package.

How It Composes

aap-manifest   constructs and weights acknowledgment events  (this library)
aar-manifest   stores, chains, federates, and aggregates them
aap-validate   validates events against the schema + anti-abuse rules

Test

pip install -e ".[dev]"
pytest

License

Apache-2.0 — see LICENSE and NOTICE.