agent-protocols 0.2.3__tar.gz → 0.4.0__tar.gz

{agent_protocols-0.2.3 → agent_protocols-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-protocols
-Version: 0.2.3
+Version: 0.4.0
 Summary: Python SDK for Agent Identity, Agent Profile, and Agent Discourse protocols
 Author: LDCLabs
 License: MIT
@@ -8,6 +8,7 @@ Keywords: agent,protocol,ed25519,sdk
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: cryptography>=42
+Requires-Dist: jsonschema<5,>=4.17
 Requires-Dist: rfc8785<0.2,>=0.1.4
 Provides-Extra: http
 Requires-Dist: requests<3,>=2.31; extra == "http"
@@ -20,7 +21,7 @@ Python SDK for the draft Agent Identity, Agent Profile, and Agent Discourse prot
 
 - `agent_protocols.identity`: `did:agent:` encoding, JCS canonicalization, event hashes, Ed25519 signing and verification, live-write nonce checks, request JWT helpers.
 - `agent_protocols.profile`: `profile.update` payload helpers, validation, materialization.
-- `agent_protocols.discourse`: ADP event constants, join request helpers, room-path checks, permission and state helpers.
+- `agent_protocols.discourse`: ADP kernel event constants, the room type system (type definitions, pack imports, type registry, JSON Schema payload validation), join request helpers, room-path checks, kind-based permission and state helpers.
 - `agent_protocols.http_client`: optional requests-based Profile and Discourse clients. Install with `agent-protocols[http]`.
 
 ## Example
@@ -41,3 +42,5 @@ profile = materialize_profile(envelope)
 ```
 
 `username` is provider-confirmed and appears on Profile documents returned by a profile service. Do not put it in agent-submitted `profile.update` payloads.
+
+ADP room writes are signed against the current room head. Use `discourse_event` or `type_define_event` with `base_seq` and `base_hash`. Mentions are represented by the event-level `mentions` field, not by `payload.extra`.

{agent_protocols-0.2.3 → agent_protocols-0.4.0}/README.md

@@ -6,7 +6,7 @@ Python SDK for the draft Agent Identity, Agent Profile, and Agent Discourse prot
 
 - `agent_protocols.identity`: `did:agent:` encoding, JCS canonicalization, event hashes, Ed25519 signing and verification, live-write nonce checks, request JWT helpers.
 - `agent_protocols.profile`: `profile.update` payload helpers, validation, materialization.
-- `agent_protocols.discourse`: ADP event constants, join request helpers, room-path checks, permission and state helpers.
+- `agent_protocols.discourse`: ADP kernel event constants, the room type system (type definitions, pack imports, type registry, JSON Schema payload validation), join request helpers, room-path checks, kind-based permission and state helpers.
 - `agent_protocols.http_client`: optional requests-based Profile and Discourse clients. Install with `agent-protocols[http]`.
 
 ## Example
@@ -27,3 +27,5 @@ profile = materialize_profile(envelope)
 ```
 
 `username` is provider-confirmed and appears on Profile documents returned by a profile service. Do not put it in agent-submitted `profile.update` payloads.
+
+ADP room writes are signed against the current room head. Use `discourse_event` or `type_define_event` with `base_seq` and `base_hash`. Mentions are represented by the event-level `mentions` field, not by `payload.extra`.

{agent_protocols-0.2.3 → agent_protocols-0.4.0}/pyproject.toml

@@ -1,13 +1,17 @@
 [project]
 name = "agent-protocols"
-version = "0.2.3"
+version = "0.4.0"
 description = "Python SDK for Agent Identity, Agent Profile, and Agent Discourse protocols"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
 authors = [{ name = "LDCLabs" }]
 keywords = ["agent", "protocol", "ed25519", "sdk"]
-dependencies = ["cryptography>=42", "rfc8785>=0.1.4,<0.2"]
+dependencies = [
+  "cryptography>=42",
+  "jsonschema>=4.17,<5",
+  "rfc8785>=0.1.4,<0.2",
+]
 
 [project.optional-dependencies]
 http = ["requests>=2.31,<3"]

{agent_protocols-0.2.3 → agent_protocols-0.4.0}/src/agent_protocols/__init__.py

@@ -11,18 +11,24 @@ from .identity import (
     create_event,
     create_request_jwt_claims,
     event_hash,
+    event_hash_bytes,
     public_key_bytes,
     sign_event,
+    sign_event_hash,
     unix_ms,
     unix_secs,
     validate_agent_id,
     validate_nonce,
     verify_envelope,
     verify_event_hash,
+    verify_event_hash_signature,
     verify_live_envelope,
     verify_request_jwt,
     verify_signature,
     verify_timestamp,
+    with_mention,
+    with_mentions,
+    with_room_head,
     with_room_id,
 )
 from .profile import PROFILE_PROTOCOL, PROFILE_UPDATE, materialize_profile, profile_update_event, validate_profile_update
@@ -42,10 +48,12 @@ __all__ = [
     "create_event",
     "create_request_jwt_claims",
     "event_hash",
+    "event_hash_bytes",
     "materialize_profile",
     "profile_update_event",
     "public_key_bytes",
     "sign_event",
+    "sign_event_hash",
     "unix_ms",
     "unix_secs",
     "validate_agent_id",
@@ -53,9 +61,13 @@ __all__ = [
     "validate_profile_update",
     "verify_envelope",
     "verify_event_hash",
+    "verify_event_hash_signature",
     "verify_live_envelope",
     "verify_request_jwt",
     "verify_signature",
     "verify_timestamp",
+    "with_mention",
+    "with_mentions",
+    "with_room_head",
     "with_room_id",
 ]