macp-sdk-python 0.4.0__tar.gz → 0.5.0__tar.gz

{macp_sdk_python-0.4.0/src/macp_sdk_python.egg-info → macp_sdk_python-0.5.0}/PKG-INFO

@@ -1,9 +1,14 @@
 Metadata-Version: 2.4
 Name: macp-sdk-python
-Version: 0.4.0
+Version: 0.5.0
 Summary: Python SDK for the MACP Rust runtime
-Author-email: OpenAI <support@openai.com>
+Author-email: Multi-Agent Coordination Protocol <macp@multiagentcoordinationprotocol.org>
 License: Apache-2.0
+Project-URL: Homepage, https://github.com/multiagentcoordinationprotocol/macp-sdk-python
+Project-URL: Repository, https://github.com/multiagentcoordinationprotocol/macp-sdk-python
+Project-URL: Documentation, https://github.com/multiagentcoordinationprotocol/macp-sdk-python/tree/main/docs
+Project-URL: Changelog, https://github.com/multiagentcoordinationprotocol/macp-sdk-python/blob/main/CHANGELOG.md
+Project-URL: Bug Tracker, https://github.com/multiagentcoordinationprotocol/macp-sdk-python/issues
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -15,9 +20,9 @@ Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: grpcio>=1.81.1
-Requires-Dist: protobuf>=5.27.0
-Requires-Dist: macp-proto<0.2.0,>=0.1.3
+Requires-Dist: grpcio>=1.82.0
+Requires-Dist: protobuf>=7.35.0
+Requires-Dist: macp-proto<0.2.0,>=0.1.6
 Provides-Extra: dev
 Requires-Dist: grpcio-tools>=1.74.0; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
@@ -27,6 +32,7 @@ Requires-Dist: mypy>=1.10; extra == "dev"
 Requires-Dist: ruff>=0.5; extra == "dev"
 Requires-Dist: grpc-stubs>=1.53; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: jsonschema>=4.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material>=9.5; extra == "docs"
 Requires-Dist: mkdocstrings[python]>=0.25; extra == "docs"
@@ -144,6 +150,12 @@ export MACP_ALLOW_INSECURE=1
 cargo run   # in the runtime repo
 ```
 
+Since runtime **v0.5.0**, a runtime with no authentication configured
+(`MACP_AUTH_TOKENS_*` / `MACP_AUTH_ISSUER` unset) **refuses to start** unless
+`MACP_ALLOW_INSECURE=1` is set, and the published Docker image **no longer
+bakes that env in** — pass it explicitly for local dev (as above and in the
+`docker run` command in `CLAUDE.md`).
+
 Dev-agent auth rides the standard `Authorization: Bearer` header — the
 runtime's `dev_authenticate` fallback binds the token value verbatim
 as the sender.

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/README.md

@@ -110,6 +110,12 @@ export MACP_ALLOW_INSECURE=1
 cargo run   # in the runtime repo
 ```
 
+Since runtime **v0.5.0**, a runtime with no authentication configured
+(`MACP_AUTH_TOKENS_*` / `MACP_AUTH_ISSUER` unset) **refuses to start** unless
+`MACP_ALLOW_INSECURE=1` is set, and the published Docker image **no longer
+bakes that env in** — pass it explicitly for local dev (as above and in the
+`docker run` command in `CLAUDE.md`).
+
 Dev-agent auth rides the standard `Authorization: Bearer` header — the
 runtime's `dev_authenticate` fallback binds the token value verbatim
 as the sender.

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "macp-sdk-python"
-version = "0.4.0"
+version = "0.5.0"
 description = "Python SDK for the MACP Rust runtime"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "Apache-2.0"}
 authors = [
-  {name = "OpenAI", email = "support@openai.com"}
+  {name = "Multi-Agent Coordination Protocol", email = "macp@multiagentcoordinationprotocol.org"}
 ]
 classifiers = [
   "Development Status :: 3 - Alpha",
@@ -23,20 +23,33 @@ classifiers = [
   "Topic :: Software Development :: Libraries",
 ]
 dependencies = [
-  # macp-proto 0.1.3's generated gRPC stubs require grpcio>=1.81.1.
-  "grpcio>=1.81.1",
-  "protobuf>=5.27.0",
-  # Requires 0.1.3+ for the suspend/cancel/supersede surface: SuspendSession
-  # /ResumeSession RPCs, SESSION_STATE_SUSPENDED/CANCELLED, the SUSPENDED/
-  # RESUMED/CANCELLED lifecycle events, and CommitmentPayload.supersedes
-  # (CommitmentRef). 0.1.2 added the RFC-MACP-0006-A1 subscribe_session_id /
-  # after_sequence fields on StreamSessionRequest (used by MacpStream
-  # .send_subscribe and the gRPC agent transport adapter); 0.1.1 is the
-  # earlier baseline for context_id / extensions on SessionStartPayload.
-  # See docs/contributing.md "Bumping macp-proto".
-  "macp-proto>=0.1.3,<0.2.0",
+  # macp-proto 0.1.6's gencode was produced by protobuf 7.35.0 / grpc 1.82.0.
+  # protobuf enforces this at import time: importing macp.v1.core_pb2 under an
+  # older protobuf raises google.protobuf.runtime_version.VersionError
+  # ("runtime version cannot be older than the linked gencode version"), so
+  # these floors are hard requirements derived from the gencode, not from
+  # macp-proto's own (looser) METADATA. This is the consumer-visible bump in
+  # SDK 0.5.0 — deployments pinned to protobuf 6.x / grpcio < 1.82 cannot
+  # straddle it.
+  "grpcio>=1.82.0",
+  "protobuf>=7.35.0",
+  # Requires 0.1.6+ for the runtime v0.5.0 wire surface referenced by the SDK:
+  # SessionStartPayload.max_suspend_ms (0.1.5), HandoffAcceptPayload.implicit
+  # and ListSessionsRequest.page_size/page_token (0.1.6), and the canonical
+  # macp.modes.multi_round.v1.ContributePayload proto encoding (0.1.4).
+  # Retains the 0.1.3 surface (suspend/cancel/supersede, subscribe_session_id/
+  # after_sequence, context_id/extensions). See docs/contributing.md
+  # "Bumping macp-proto".
+  "macp-proto>=0.1.6,<0.2.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/multiagentcoordinationprotocol/macp-sdk-python"
+Repository = "https://github.com/multiagentcoordinationprotocol/macp-sdk-python"
+Documentation = "https://github.com/multiagentcoordinationprotocol/macp-sdk-python/tree/main/docs"
+Changelog = "https://github.com/multiagentcoordinationprotocol/macp-sdk-python/blob/main/CHANGELOG.md"
+"Bug Tracker" = "https://github.com/multiagentcoordinationprotocol/macp-sdk-python/issues"
+
 [project.optional-dependencies]
 dev = [
   "grpcio-tools>=1.74.0",  # only needed for proto-python package publishing
@@ -47,6 +60,7 @@ dev = [
   "ruff>=0.5",
   "grpc-stubs>=1.53",
   "build>=1.0",
+  "jsonschema>=4.0",  # validate vendored conformance fixtures against schema.json
 ]
 docs = [
   "mkdocs-material>=9.5",

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/src/macp_sdk/__init__.py

@@ -20,6 +20,7 @@ from .decision import DecisionSession
 from .envelope import (
     build_commitment_payload,
     build_commitment_ref,
+    build_contribute_payload,
     build_envelope,
     build_progress_payload,
     build_root,
@@ -183,6 +184,7 @@ __all__ = [
     "VotingRules",
     "build_commitment_payload",
     "build_commitment_ref",
+    "build_contribute_payload",
     "build_decision_policy",
     "build_envelope",
     "build_handoff_policy",

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/src/macp_sdk/agent/participant.py

@@ -69,6 +69,9 @@ class InitiatorConfig:
     mode_version: str | None = None
     configuration_version: str | None = None
     policy_version: str | None = None
+    # Runtime v0.5.0 per-session maximum-suspension cap (ms); 0 = runtime
+    # default (currently 7 days). Negative values are rejected at build time.
+    max_suspend_ms: int = 0
     kickoff_message_type: str | None = None
     kickoff_payload: dict[str, Any] = field(default_factory=dict)
 
@@ -113,8 +116,13 @@ class ParticipantActions:
         mode_version: str | None = None,
         configuration_version: str | None = None,
         policy_version: str | None = None,
+        max_suspend_ms: int = 0,
     ) -> Any:
-        """Send a SessionStart envelope to open the session."""
+        """Send a SessionStart envelope to open the session.
+
+        ``max_suspend_ms`` (runtime v0.5.0) binds a per-session maximum
+        suspension cap; ``0`` selects the runtime default.
+        """
         from ..constants import (
             DEFAULT_CONFIGURATION_VERSION,
             DEFAULT_MODE_VERSION,
@@ -135,6 +143,7 @@ class ParticipantActions:
             mode_version=mode_version or DEFAULT_MODE_VERSION,
             configuration_version=configuration_version or DEFAULT_CONFIGURATION_VERSION,
             policy_version=policy_version or DEFAULT_POLICY_VERSION,
+            max_suspend_ms=max_suspend_ms,
         )
         envelope = build_envelope(
             mode=self._mode,
@@ -522,6 +531,7 @@ class Participant:
             mode_version=cfg.mode_version,
             configuration_version=cfg.configuration_version,
             policy_version=cfg.policy_version,
+            max_suspend_ms=cfg.max_suspend_ms,
         )
         logger.info("SessionStart emitted (session=%s)", self._session_id)
 

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/src/macp_sdk/agent/runner.py

@@ -123,6 +123,11 @@ def from_bootstrap(bootstrap_path: str | None = None) -> Participant:
             intent=str(ss.get("intent", "")),
             participants=[str(p) for p in ss.get("participants", participants)],
             ttl_ms=int(ss.get("ttl_ms", 300000)),
+            # Runtime v0.5.0 per-session suspension cap; absent → 0 (runtime
+            # default). The TypeScript bootstrap schema does not yet map this
+            # key, so it is Python-only for now; a bootstrap that omits it
+            # behaves identically in both SDKs.
+            max_suspend_ms=int(ss.get("max_suspend_ms", 0)),
             context_id=str(ss.get("context_id", "")),
             extensions=_decode_extensions(ss.get("extensions")),
             roots=ss.get("roots"),

{macp_sdk_python-0.4.0 → macp_sdk_python-0.5.0}/src/macp_sdk/base_session.py

@@ -102,10 +102,17 @@ class BaseSession(ABC):
         context_id: str = "",
         extensions: Mapping[str, bytes] | None = None,
         roots: Iterable[Any] | None = None,
+        max_suspend_ms: int = 0,
         sender: str | None = None,
         auth: AuthConfig | None = None,
     ) -> envelope_pb2.Ack:
-        """Send SessionStart and begin tracking via the projection."""
+        """Send SessionStart and begin tracking via the projection.
+
+        ``max_suspend_ms`` (runtime v0.5.0) binds a per-session maximum
+        suspension cap; ``0`` selects the runtime default (currently 7 days).
+        A suspension outlasting this cap expires the session
+        (``SUSPENDED`` → ``EXPIRED``). Negative values are rejected.
+        """
         validate_participant_count(len(participants))
         payload = build_session_start_payload(
             intent=intent,
@@ -117,6 +124,7 @@ class BaseSession(ABC):
             context_id=context_id,
             extensions=extensions,
             roots=roots,
+            max_suspend_ms=max_suspend_ms,
         )
         envelope = build_envelope(
             mode=self.MODE,
@@ -138,7 +146,16 @@ class BaseSession(ABC):
         sender: str | None = None,
         auth: AuthConfig | None = None,
     ) -> envelope_pb2.Ack:
-        """Send Commitment to resolve the session."""
+        """Send Commitment to resolve the session.
+
+        The commitment echoes ``self.policy_version``. Runtime v0.5.0 relaxed
+        the match rule (RFC-MACP-0012, change review A3): an **empty**
+        ``policy_version`` matches whatever policy the session is bound to, so
+        a session started with an empty policy_version no longer has to echo
+        ``policy.default``. A **non-empty** value must still equal the
+        resolved policy id (e.g. ``policy.default``) or the commitment is
+        rejected with ``UNKNOWN_POLICY_VERSION``.
+        """
         payload = build_commitment_payload(
             action=action,
             authority_scope=authority_scope,