@@ -71,7 +71,21 @@ <h2 class="section-title" id="header-classes">Classes</h2>
7171 def model_dump_json(self, **kwargs: Any) -> str:
7272 if "exclude_none" not in kwargs:
7373 kwargs["exclude_none"] = True
74- return super().model_dump_json(**kwargs)</ code > </ pre >
74+ return super().model_dump_json(**kwargs)
75+
76+ def summary(self) -> str:
77+ """Human-readable summary for protocol responses.
78+
79+ Returns a standardized human-readable message suitable for MCP tool
80+ results, A2A task communications, and REST API responses.
81+
82+ For types without a registered formatter, returns a generic message
83+ with the class name.
84+ """
85+ formatter = _RESPONSE_MESSAGE_REGISTRY.get(self.__class__.__name__)
86+ if formatter:
87+ return formatter(self)
88+ return f"{self.__class__.__name__} response"</ code > </ pre >
7589</ details >
7690< div class ="desc "> < p > Base model for AdCP types with spec-compliant serialization.</ p >
7791< p > AdCP JSON schemas use additionalProperties: false and do not allow null
@@ -399,6 +413,34 @@ <h2 id="args">Args</h2>
399413< h2 id ="returns "> Returns</ h2 >
400414< p > A JSON string representation of the model.</ p > </ div >
401415</ dd >
416+ < dt id ="adcp.types.base.AdCPBaseModel.summary "> < code class ="name flex ">
417+ < span > def < span class ="ident "> summary</ span > </ span > (< span > self) ‑> str</ span >
418+ </ code > </ dt >
419+ < dd >
420+ < details class ="source ">
421+ < summary >
422+ < span > Expand source code</ span >
423+ </ summary >
424+ < pre > < code class ="python "> def summary(self) -> str:
425+ """Human-readable summary for protocol responses.
426+
427+ Returns a standardized human-readable message suitable for MCP tool
428+ results, A2A task communications, and REST API responses.
429+
430+ For types without a registered formatter, returns a generic message
431+ with the class name.
432+ """
433+ formatter = _RESPONSE_MESSAGE_REGISTRY.get(self.__class__.__name__)
434+ if formatter:
435+ return formatter(self)
436+ return f"{self.__class__.__name__} response"</ code > </ pre >
437+ </ details >
438+ < div class ="desc "> < p > Human-readable summary for protocol responses.</ p >
439+ < p > Returns a standardized human-readable message suitable for MCP tool
440+ results, A2A task communications, and REST API responses.</ p >
441+ < p > For types without a registered formatter, returns a generic message
442+ with the class name.</ p > </ div >
443+ </ dd >
402444</ dl >
403445</ dd >
404446</ dl >
@@ -422,6 +464,7 @@ <h4><code><a title="adcp.types.base.AdCPBaseModel" href="#adcp.types.base.AdCPBa
422464< li > < code > < a title ="adcp.types.base.AdCPBaseModel.model_config " href ="#adcp.types.base.AdCPBaseModel.model_config "> model_config</ a > </ code > </ li >
423465< li > < code > < a title ="adcp.types.base.AdCPBaseModel.model_dump " href ="#adcp.types.base.AdCPBaseModel.model_dump "> model_dump</ a > </ code > </ li >
424466< li > < code > < a title ="adcp.types.base.AdCPBaseModel.model_dump_json " href ="#adcp.types.base.AdCPBaseModel.model_dump_json "> model_dump_json</ a > </ code > </ li >
467+ < li > < code > < a title ="adcp.types.base.AdCPBaseModel.summary " href ="#adcp.types.base.AdCPBaseModel.summary "> summary</ a > </ code > </ li >
425468</ ul >
426469</ li >
427470</ ul >
0 commit comments