macp-sdk-python 0.12.1__tar.gz → 0.13.0__tar.gz

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: macp-sdk-python
-Version: 0.12.1
+Version: 0.13.0
 Summary: Python SDK for the MACP Rust runtime
 Author-email: Multi-Agent Coordination Protocol <macp@multiagentcoordinationprotocol.org>
 License: Apache-2.0

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "macp-sdk-python"
-version = "0.12.1"
+version = "0.13.0"
 description = "Python SDK for the MACP Rust runtime"
 readme = "README.md"
 requires-python = ">=3.11"

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/src/macp_sdk/projections.py

@@ -132,7 +132,10 @@ class DecisionProjection(BaseProjection):
         """Count votes per proposal, keyed by proposal_id.
 
         ABSTAIN votes are tracked but excluded from the totals returned
-        here (which counts only APPROVE votes).
+        here (which counts only APPROVE votes). A proposal_id that received
+        no votes at all is **absent** from the returned dict -- not present
+        with a 0 value. Use ``.get(proposal_id, 0)`` when checking an
+        arbitrary proposal_id.
         """
         totals: dict[str, int] = {}
         for proposal_id, sender_votes in self.votes.items():

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/src/macp_sdk/proposal.py

@@ -25,7 +25,7 @@ class ProposalRecord:
     proposal_id: str
     title: str
     summary: str
-    proposer: str
+    sender: str
     supersedes: str  # "" if original
     # Reachable values only. An Accept is recorded on the projection's
     # ``accepts`` list (and surfaced via ``accepted_proposal`` /
@@ -45,6 +45,30 @@ class ProposalRecord:
     status: str  # "open" | "rejected" | "withdrawn"
     tags: list[str]
 
+    # ── Deprecated alias (issue #120 / multiagentcoordinationprotocol#177) ──
+    # ``proposer`` is kept as a read-only, INSTANCE-level property alias for
+    # one minor version, removed at this SDK's next major version. This is a
+    # different mechanism from the module-level ``__getattr__``/PEP 562
+    # aliases below (``RejectRecord``/``AcceptRecord``, issue #103): those
+    # intercept MODULE attribute access (``macp_sdk.proposal.RejectRecord``);
+    # PEP 562 has no bearing on INSTANCE attribute access
+    # (``some_record.proposer``), which is what this field needs. A
+    # ``@dataclass(slots=True)`` class derives ``__slots__`` strictly from
+    # its annotated fields, so a plain same-named class attribute alias is
+    # not an option here -- but a property is not a field and is untouched
+    # by the slots transformation, so it coexists cleanly: ``fields()``,
+    # ``__slots__``, ``repr()``, and ``dataclasses.replace()`` all still
+    # see/use only the real ``sender`` field. No setter is defined: nothing
+    # in this module ever assigns ``.proposer``.
+    @property
+    def proposer(self) -> str:
+        warnings.warn(
+            "ProposalRecord.proposer is deprecated; use ProposalRecord.sender instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.sender
+
 
 @dataclass(slots=True)
 class ProposalRejectRecord:
@@ -94,7 +118,7 @@ class ProposalProjection(BaseProjection):
                 proposal_id=p.proposal_id,
                 title=p.title,
                 summary=p.summary,
-                proposer=envelope.sender,
+                sender=envelope.sender,
                 supersedes="",
                 status="open",
                 tags=list(p.tags),
@@ -108,7 +132,7 @@ class ProposalProjection(BaseProjection):
                 proposal_id=p.proposal_id,
                 title=p.title,
                 summary=p.summary,
-                proposer=envelope.sender,
+                sender=envelope.sender,
                 supersedes=p.supersedes_proposal_id,
                 status="open",
                 tags=[],
@@ -141,9 +165,20 @@ class ProposalProjection(BaseProjection):
             )
             if p.terminal:
                 rec = self.proposals.get(p.proposal_id)
+                # A terminal Reject must name a proposal this projection has
+                # actually seen (RFC-MACP-0008 §5 rule 3) before it ends the
+                # negotiation. "TerminalRejected" is in TERMINAL_PHASES
+                # (agent/participant.py:57-59), so moving phase here for an
+                # unknown proposal_id would fire a Participant's on_terminal
+                # and tear down its stream for a session that never actually
+                # terminated. Same shape as task.py's per-task gates
+                # (:172/:196/:212): gate the state transition, keep the
+                # audit append above unconditional. has_terminal_rejection()
+                # / is_terminally_rejected() deliberately still read
+                # self.rejections, not phase, so they stay True either way.
                 if rec is not None:
                     rec.status = "rejected"
-                self._set_phase("TerminalRejected")
+                    self._set_phase("TerminalRejected")
             return
 
         if mt == "Withdraw":

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/src/macp_sdk/quorum.py

@@ -97,8 +97,12 @@ class QuorumProjection(BaseProjection):
         # enforces RFC-MACP-0011 §5 rule 3's *across-type* cardinality rule
         # ("at most one ballot across Approve, Reject, or Abstain"). First
         # ballot per sender stands; which-of-two-stands is inferred from
-        # RFC-MACP-0007 §5.3 parity plus what the only runtime enforces
-        # (quorum.rs:164/184/204) -- RFC-0011 itself is silent on that.
+        # RFC-MACP-0007 §5.3 parity plus what the only runtime enforces: the
+        # three same-sender ballot guards in macp-runtime's
+        # crates/macp-modes/src/mode/quorum.rs (QuorumMode's
+        # Approve/Reject/Abstain arms, each rejecting when
+        # state.ballots.contains_key(&env.sender), confirmed at runtime
+        # v0.8.6) -- RFC-0011 itself is silent on that.
         sender = envelope.sender
         sender_map = self.ballots.setdefault(request_id, {})
         existing = sender_map.get(sender)

{macp_sdk_python-0.12.1 → macp_sdk_python-0.13.0}/src/macp_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: macp-sdk-python
-Version: 0.12.1
+Version: 0.13.0
 Summary: Python SDK for the MACP Rust runtime
 Author-email: Multi-Agent Coordination Protocol <macp@multiagentcoordinationprotocol.org>
 License: Apache-2.0