agent-alignment-protocol 0.4.0__tar.gz → 1.3.0__tar.gz

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/.gitignore

@@ -40,6 +40,8 @@ env/
 .coverage
 .coverage.*
 htmlcov/
+coverage/
+coverage.xml
 .pytest_cache/
 .hypothesis/
 

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-alignment-protocol
-Version: 0.4.0
+Version: 1.3.0
 Summary: Agent Alignment Protocol - The missing alignment layer for the agent protocol stack
 Project-URL: Homepage, https://github.com/mnemom/aap
 Project-URL: Documentation, https://github.com/mnemom/aap#readme
@@ -46,7 +46,7 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/agent-alignment-protocol.svg)](https://pypi.org/project/agent-alignment-protocol/)
 [![npm](https://img.shields.io/npm/v/@mnemom/agent-alignment-protocol.svg)](https://www.npmjs.com/package/@mnemom/agent-alignment-protocol)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![Spec](https://img.shields.io/badge/spec-v0.4.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
+[![Spec](https://img.shields.io/badge/spec-v1.0.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
 
 **A transparency protocol for autonomous agents.**
 
@@ -115,7 +115,7 @@ A structured declaration of an agent's alignment posture:
 
 ```json
 {
-  "aap_version": "0.1.0",
+  "aap_version": "1.0.0",
   "agent_id": "did:web:my-agent.example.com",
   "principal": {
     "type": "human",

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/README.md

@@ -6,7 +6,7 @@
 [![PyPI](https://img.shields.io/pypi/v/agent-alignment-protocol.svg)](https://pypi.org/project/agent-alignment-protocol/)
 [![npm](https://img.shields.io/npm/v/@mnemom/agent-alignment-protocol.svg)](https://www.npmjs.com/package/@mnemom/agent-alignment-protocol)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![Spec](https://img.shields.io/badge/spec-v0.4.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
+[![Spec](https://img.shields.io/badge/spec-v1.0.0-green.svg)](https://docs.mnemom.ai/protocols/aap/specification)
 
 **A transparency protocol for autonomous agents.**
 
@@ -75,7 +75,7 @@ A structured declaration of an agent's alignment posture:
 
 ```json
 {
-  "aap_version": "0.1.0",
+  "aap_version": "1.0.0",
   "agent_id": "did:web:my-agent.example.com",
   "principal": {
     "type": "human",

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-alignment-protocol"
-version = "0.4.0"
+version = "1.3.0"
 description = "Agent Alignment Protocol - The missing alignment layer for the agent protocol stack"
 readme = "README.md"
 license = "Apache-2.0"
@@ -101,3 +101,10 @@ warn_unused_ignores = true
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 asyncio_mode = "auto"
+addopts = "--cov=src/aap --cov-report=xml --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src/aap"]
+
+[tool.coverage.report]
+show_missing = true

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/schemas/alignment-card.schema.json

@@ -390,10 +390,10 @@
       "type": "object"
     }
   },
-  "description": "Alignment Card \u2014 Agent alignment declaration (SPEC Section 4).\n\nA structured document declaring an agent's alignment posture. It MUST be\nmachine-readable (JSON) and SHOULD be human-readable.\n\nExample:\n    card = AlignmentCard(\n        aap_version=\"0.1.0\",\n        card_id=\"ac-12345\",\n        agent_id=\"did:web:agent.example.com\",\n        issued_at=datetime.utcnow(),\n        principal=Principal(type=PrincipalType.HUMAN, relationship=RelationshipType.DELEGATED_AUTHORITY),\n        values=Values(declared=[\"principal_benefit\", \"transparency\"]),\n        autonomy_envelope=AutonomyEnvelope(\n            bounded_actions=[\"search\", \"recommend\"],\n            escalation_triggers=[\n                EscalationTrigger(\n                    condition='action_type == \"purchase\"',\n                    action=TriggerAction.ESCALATE,\n                    reason=\"Purchases require approval\",\n                )\n            ],\n        ),\n        audit_commitment=AuditCommitment(\n            retention_days=90,\n            queryable=True,\n            query_endpoint=\"https://agent.example.com/api/traces\",\n        ),\n    )",
+  "description": "Alignment Card \u2014 Agent alignment declaration (SPEC Section 4).\n\nA structured document declaring an agent's alignment posture. It MUST be\nmachine-readable (JSON) and SHOULD be human-readable.\n\nExample:\n    card = AlignmentCard(\n        aap_version=\"0.5.0\",\n        card_id=\"ac-12345\",\n        agent_id=\"did:web:agent.example.com\",\n        issued_at=datetime.utcnow(),\n        principal=Principal(type=PrincipalType.HUMAN, relationship=RelationshipType.DELEGATED_AUTHORITY),\n        values=Values(declared=[\"principal_benefit\", \"transparency\"]),\n        autonomy_envelope=AutonomyEnvelope(\n            bounded_actions=[\"search\", \"recommend\"],\n            escalation_triggers=[\n                EscalationTrigger(\n                    condition='action_type == \"purchase\"',\n                    action=TriggerAction.ESCALATE,\n                    reason=\"Purchases require approval\",\n                )\n            ],\n        ),\n        audit_commitment=AuditCommitment(\n            retention_days=90,\n            queryable=True,\n            query_endpoint=\"https://agent.example.com/api/traces\",\n        ),\n    )",
   "properties": {
     "aap_version": {
-      "default": "0.1.0",
+      "default": "0.5.0",
       "description": "AAP specification version",
       "title": "Aap Version",
       "type": "string"

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/src/aap/__init__.py

@@ -36,7 +36,7 @@ Quick Start:
 See docs/SPEC.md for the full protocol specification.
 """
 
-__version__ = "0.4.0"
+__version__ = "1.0.0"
 
 # EU AI Act compliance presets
 from aap.compliance import (

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/src/aap/cli/main.py

@@ -196,7 +196,7 @@ def _create_card_from_values(
     """Create a minimal Alignment Card from a list of values."""
     now = datetime.now(timezone.utc)
     return {
-        "aap_version": "0.1.0",
+        "aap_version": "0.5.0",
         "card_id": card_id or f"ac-{uuid.uuid4().hex[:12]}",
         "agent_id": agent_id or f"agent-{uuid.uuid4().hex[:8]}",
         "issued_at": now.isoformat(),
@@ -291,7 +291,7 @@ def _create_card_interactive(agent_id: str | None = None, card_id: str | None =
 
     now = datetime.now(timezone.utc)
     return {
-        "aap_version": "0.1.0",
+        "aap_version": "0.5.0",
         "card_id": card_id or f"ac-{uuid.uuid4().hex[:12]}",
         "agent_id": agent_id or f"agent-{uuid.uuid4().hex[:8]}",
         "issued_at": now.isoformat(),

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/src/aap/schemas/__init__.py

@@ -61,6 +61,7 @@ from aap.schemas.ap_trace import (
     PrincipalResponse,
     TraceContext,
     TriggerCheck,
+    ValueScore,
 )
 from aap.schemas.value_coherence import (
     AlignmentCardRequest,
@@ -109,6 +110,7 @@ __all__ = [
     "TriggerCheck",
     "PrincipalResponse",
     "TraceContext",
+    "ValueScore",
     # Value Coherence (SPEC Section 6)
     "AlignmentCardRequest",
     "AlignmentCardResponse",

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/src/aap/schemas/alignment_card.py

@@ -223,7 +223,7 @@ class AlignmentCard(BaseModel):
 
     Example:
         card = AlignmentCard(
-            aap_version="0.1.0",
+            aap_version="0.5.0",
             card_id="ac-12345",
             agent_id="did:web:agent.example.com",
             issued_at=datetime.utcnow(),
@@ -248,7 +248,7 @@ class AlignmentCard(BaseModel):
     """
 
     aap_version: str = Field(
-        default="0.1.0", description="AAP specification version"
+        default="0.5.0", description="AAP specification version"
     )
     card_id: str = Field(
         ..., description="Unique identifier for this card (UUID or URI)"

{agent_alignment_protocol-0.4.0 → agent_alignment_protocol-1.3.0}/src/aap/schemas/ap_trace.py

@@ -14,7 +14,7 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Any
+from typing import Any, Literal
 
 from pydantic import BaseModel, Field, model_validator
 
@@ -87,6 +87,21 @@ class Alternative(BaseModel):
     )
 
 
+class ValueScore(BaseModel):
+    """Per-value score from V2 observer scoring (Phase 3.3)."""
+
+    score: Literal["on_track", "off_track", "not_applicable"] = Field(
+        ..., description="Score against the catalog entry's observer_signals rubric"
+    )
+    rationale: str = Field(
+        ...,
+        description=(
+            "Free-form rationale citing one of the catalog "
+            "observer_signals patterns"
+        ),
+    )
+
+
 class Decision(BaseModel):
     """Decision process record (SPEC Section 5.5)."""
 
@@ -105,6 +120,18 @@ class Decision(BaseModel):
     confidence: float | None = Field(
         None, ge=0.0, le=1.0, description="Decision confidence"
     )
+    value_scores: dict[str, ValueScore] | None = Field(
+        None,
+        description=(
+            "Per-declared-value score against the alignment card's catalog "
+            "observer_signals (Phase 3.3 V2 observer surface). Optional — "
+            "present when the card declares catalog values with "
+            "observer_signals defined; absent on V1 observer output. Keyed "
+            "by catalog value id. `values_applied` is derived from "
+            "`value_scores` entries whose score is 'on_track' to preserve "
+            "the V1 surface contract for downstream consumers."
+        ),
+    )
 
     @model_validator(mode="after")
     def selected_must_be_in_alternatives(self) -> Decision: