aiohttp-tiny-mcp 0.5.6__tar.gz → 0.5.7__tar.gz

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohttp-tiny-mcp
-Version: 0.5.6
+Version: 0.5.7
 Summary: Remote MCP server and client library for aiohttp
 License-Expression: Apache-2.0
 License-File: LICENSE

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aiohttp-tiny-mcp"
-version = "0.5.6"
+version = "0.5.7"
 description = "Remote MCP server and client library for aiohttp"
 readme = "README.md"
 license = "Apache-2.0"

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "aiohttp-tiny-mcp"
-version = "0.5.6"
+version = "0.5.7"
 description = "Remote MCP server and client library for aiohttp"
 readme = "README.md"
 license = "Apache-2.0"

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/adapter.py

@@ -320,8 +320,23 @@ class Adapter(ABC):
     def describe_server(self, registry: RegistryProtocol, call: Call) -> BaseModel:
         """Negotiate the requested legacy revision from `call.params.protocol_version`."""
 
+    def describe_tool(self, spec: ToolSpec) -> ToolDef | None:
+        """Return how this revision shows `spec`, or None where it hides it.
+
+        The projection is cached on the spec. A tool does not change after
+        registration, so each revision simplifies its schemas once instead of
+        once per `tools/list` and once per `tools/call`.
+        """
+        cache = spec.described
+        try:
+            return cache[self.version]
+        except KeyError:
+            definition = cache[self.version] = self.build_tool(spec)
+            return definition
+
     @abstractmethod
-    def describe_tool(self, spec: ToolSpec) -> ToolDef | None: ...
+    def build_tool(self, spec: ToolSpec) -> ToolDef | None:
+        """Project `spec` onto this revision. `describe_tool` caches the result."""
 
     def describe_resource(self, spec: ResourceSpec) -> ResourceDef | ResourceTemplateDef | None:
         """Project extension resources onto the URI understood by this revision."""

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/models.py

@@ -10,6 +10,17 @@ from typing import Annotated, Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt, StrictStr
 from pydantic.alias_generators import to_camel
+from pydantic_core import to_json
+
+
+def serialized(payload: Any) -> bytes:
+    """Encode one wire payload as UTF-8 JSON.
+
+    `to_json` is the serializer pydantic already carries. It is about three
+    times faster than `json.dumps` and writes the same bytes for the JSON-mode
+    values `Model.wire` returns. Non-ASCII characters stay as they are.
+    """
+    return to_json(payload)
 
 
 class Model(BaseModel):

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/v2024_11_05.py

@@ -16,8 +16,8 @@ class Adapter2024_11_05(Adapter2025_03_26):  # noqa: N801 -- revision date, grep
     allows_batch: ClassVar[bool] = False
     progress_message: ClassVar[bool] = False
 
-    def describe_tool(self, spec: ToolSpec) -> ToolDef | None:
-        definition = super().describe_tool(spec)
+    def build_tool(self, spec: ToolSpec) -> ToolDef | None:
+        definition = super().build_tool(spec)
         if definition is None:
             return None
         return definition.model_copy(update={"annotations": None})

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/v2025_03_26.py

@@ -86,8 +86,8 @@ class Adapter2025_03_26(Adapter2025_06_18):  # noqa: N801 -- revision date, grep
         """Only handlers receiving Exchange need the extra answer/state arguments."""
         return any(kind.__name__ == "Exchange" for _, kind in spec.bound.plan)
 
-    def describe_tool(self, spec: ToolSpec) -> ToolDef | None:
-        definition = super().describe_tool(spec)
+    def build_tool(self, spec: ToolSpec) -> ToolDef | None:
+        definition = super().build_tool(spec)
         if definition is None:
             return None
         definition = definition.model_copy(update={"output_schema": None, "title": None})

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/v2025_11_25.py

@@ -135,7 +135,7 @@ class Adapter2025_11_25(Adapter):  # noqa: N801 -- revision date, greppable agai
             instructions=registry.instructions,
         )
 
-    def describe_tool(self, spec: ToolSpec) -> ToolDef | None:
+    def build_tool(self, spec: ToolSpec) -> ToolDef | None:
         if spec.min_revision is not None and spec.min_revision > self.version:
             return None
         schema = simplify_legacy_schema(spec.input_schema)

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/protocol/v2026_07_28.py

@@ -341,7 +341,7 @@ class Adapter2026_07_28(Adapter):  # noqa: N801 -- revision date, greppable agai
             caps["extensions"] = extensions
         return caps
 
-    def describe_tool(self, spec: ToolSpec) -> ToolDef | None:
+    def build_tool(self, spec: ToolSpec) -> ToolDef | None:
         if spec.min_revision is not None and spec.min_revision > self.version:
             return None
         return spec.definition(spec.input_schema, spec.output_schema)

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/server/exchange.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 import asyncio
 import inspect
-import json
 import logging
 from collections.abc import Awaitable, Callable, Mapping
 from contextlib import AsyncExitStack, asynccontextmanager
@@ -25,6 +24,7 @@ from aiohttp_tiny_mcp.protocol.core import (
     answer_of,
     logs_at,
 )
+from aiohttp_tiny_mcp.protocol.models import serialized
 from aiohttp_tiny_mcp.storage.hub import ASK, Hub, topic
 from aiohttp_tiny_mcp.storage.sessions import Session, SessionAccess
 from aiohttp_tiny_mcp.storage.sessions import new_session_id as new_id
@@ -232,7 +232,7 @@ class Exchange:
             await self.send(payload)
             return
         assert self.sse is not None
-        text = json.dumps(payload, ensure_ascii=False)
+        text = serialized(payload).decode()
         log.debug("-> [%s] %s", self.adapter.version, text)
         await self.sse.send(text)
 

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/server/http.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import asyncio
-import json
 import logging
 import re
 from collections.abc import Mapping
@@ -26,6 +25,7 @@ from aiohttp_tiny_mcp.protocol.core import (
     Rejected,
     Value,
 )
+from aiohttp_tiny_mcp.protocol.models import serialized
 from aiohttp_tiny_mcp.protocol.selection import AdapterSet
 from aiohttp_tiny_mcp.storage.hub import NOTIFICATIONS, Subscription, topic
 from aiohttp_tiny_mcp.storage.namespaces import current, namespace, scoped
@@ -325,7 +325,8 @@ class Endpoint:
             return self.render_failure(self.adapters.fallback(), e.failure)
         held = self.open_values(request, session)
 
-        log.debug("<- [%s] %s", adapter.version, raw.decode("utf-8", "replace"))
+        if log.isEnabledFor(logging.DEBUG):
+            log.debug("<- [%s] %s", adapter.version, raw.decode("utf-8", "replace"))
 
         try:
             items = adapter.decode(pre, self.registry)
@@ -390,13 +391,13 @@ class Endpoint:
             return web.Response(
                 status=200,
                 content_type="application/json",
-                text=json.dumps([p for _, p in replies], ensure_ascii=False),
+                body=serialized([p for _, p in replies]),
             )
         status, payload = replies[0]
         response = web.Response(
             status=status,
             content_type="application/json",
-            text=json.dumps(payload, ensure_ascii=False),
+            body=serialized(payload),
         )
         if minted is not None:
             response.headers[SESSION_HEADER] = minted
@@ -466,7 +467,7 @@ class Endpoint:
             )
             for event in found:
                 if relays(event.message, accepted):
-                    text = json.dumps(event.message, ensure_ascii=False)
+                    text = serialized(event.message).decode()
                     log.debug("-> [%s] %s %s", adapter.version, event.id, text)
                     await response.send(text, id=event.id)
 
@@ -561,15 +562,17 @@ class Endpoint:
     ) -> tuple[int, Mapping[str, Any]]:
         status = adapter.http_status(outcome) if isinstance(outcome, Failure) else 200
         payload = adapter.encode(call, self.registry, outcome)
-        log.debug("-> [%s] %s %s", adapter.version, status, json.dumps(payload, ensure_ascii=False))
+        if log.isEnabledFor(logging.DEBUG):
+            log.debug("-> [%s] %s %s", adapter.version, status, serialized(payload).decode())
         return status, payload
 
     def render_failure(self, adapter: Adapter, failure: Failure) -> web.Response:
         payload = adapter.encode_failure(None, failure)
-        text = json.dumps(payload, ensure_ascii=False)
-        log.debug("-> [%s] %s %s", adapter.version, adapter.http_status(failure), text)
+        body = serialized(payload)
+        if log.isEnabledFor(logging.DEBUG):
+            log.debug("-> [%s] %s %s", adapter.version, adapter.http_status(failure), body.decode())
         return web.Response(
-            status=adapter.http_status(failure), content_type="application/json", text=text
+            status=adapter.http_status(failure), content_type="application/json", body=body
         )
 
     async def stream(self, request: web.Request, ex: Exchange) -> web.StreamResponse:

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/server/specs.py

@@ -10,7 +10,7 @@ from collections.abc import Awaitable, Callable, Iterable, Mapping
 from contextlib import AbstractAsyncContextManager
 from typing import Any, ClassVar, Literal, Protocol, get_type_hints
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, PrivateAttr
 
 from aiohttp_tiny_mcp.protocol.models import (
     BlobResourceContents,
@@ -101,6 +101,16 @@ class ToolSpec(Model):
     min_revision: str | None = None
     streaming: bool = False
 
+    #: One projection of this tool per revision, keyed by adapter version.
+    #: A spec never changes after registration, so each revision simplifies
+    #: the schema once instead of once per request. `None` means the revision
+    #: hides the tool. `Adapter.describe_tool` owns this cache.
+    _described: dict[str, ToolDef | None] = PrivateAttr(default_factory=dict)
+
+    @property
+    def described(self) -> dict[str, ToolDef | None]:
+        return self._described
+
     @classmethod
     def build(
         cls,

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/server/sse.py

@@ -23,6 +23,7 @@ from aiohttp_tiny_mcp.protocol.core import (
     Rejected,
     Value,
 )
+from aiohttp_tiny_mcp.protocol.models import serialized
 from aiohttp_tiny_mcp.protocol.selection import AdapterSet
 from aiohttp_tiny_mcp.storage.hub import NOTIFICATIONS, Subscription, topic
 from aiohttp_tiny_mcp.storage.namespaces import scoped
@@ -184,7 +185,7 @@ class SseEndpoint:
             )
             for event in found:
                 if relays(event.message, accepted):
-                    text = json.dumps(event.message, ensure_ascii=False)
+                    text = serialized(event.message).decode()
                     await self.write(response, "message", text)
 
     async def write(self, response: SSEResponse, event: str, data: str) -> None:
@@ -211,7 +212,8 @@ class SseEndpoint:
         )
 
         raw = await request.read()
-        log.debug("<- [%s] %s", VERSION, raw.decode("utf-8", "replace"))
+        if log.isEnabledFor(logging.DEBUG):
+            log.debug("<- [%s] %s", VERSION, raw.decode("utf-8", "replace"))
         where = topic(STREAM, session_id)
 
         pre = Preamble.of(raw, request.headers)

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/server/stdio.py

@@ -7,7 +7,6 @@ In-flight tasks support subscriptions and cancellation. HTTP header checks belon
 from __future__ import annotations
 
 import asyncio
-import json
 import logging
 import sys
 from collections.abc import Callable, Mapping
@@ -23,6 +22,7 @@ from aiohttp_tiny_mcp.protocol.core import (
     Preamble,
     Rejected,
 )
+from aiohttp_tiny_mcp.protocol.models import serialized
 from aiohttp_tiny_mcp.protocol.selection import AdapterSet
 
 from .dispatcher import Dispatcher
@@ -60,7 +60,8 @@ async def serve_stdio(
     level: list[str | None] = [None]
 
     def send(version: str, payload: Mapping[str, Any]) -> None:
-        log.debug("-> [%s] %s", version, json.dumps(payload, ensure_ascii=False))
+        if log.isEnabledFor(logging.DEBUG):
+            log.debug("-> [%s] %s", version, serialized(payload).decode())
         write(payload)
 
     def keep_log_level(value: str) -> None:
@@ -98,7 +99,8 @@ async def serve_stdio(
             if not raw:
                 continue
 
-            log.debug("<- %s", raw.decode("utf-8", "replace"))
+            if log.isEnabledFor(logging.DEBUG):
+                log.debug("<- %s", raw.decode("utf-8", "replace"))
             pre = Preamble.of(raw, {})
             if is_reply(pre.body):
                 await relay_reply(registry.hub, pre.body)
@@ -172,8 +174,8 @@ async def stdin_reader() -> asyncio.StreamReader:
 
 
 def write_stdout(payload: Mapping[str, Any]) -> None:
-    sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
-    sys.stdout.flush()
+    sys.stdout.buffer.write(serialized(payload) + b"\n")
+    sys.stdout.buffer.flush()
 
 
 async def run_stdio(

{aiohttp_tiny_mcp-0.5.6 → aiohttp_tiny_mcp-0.5.7}/src/aiohttp_tiny_mcp/transport/sse.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import asyncio
-import json
 from collections.abc import AsyncIterator, Mapping
 from dataclasses import dataclass, replace
 from typing import Any, ClassVar
@@ -14,6 +13,8 @@ from aiohttp import web
 from aiohttp.compression_utils import ZLibCompressor
 from multidict import CIMultiDict, CIMultiDictProxy
 
+from aiohttp_tiny_mcp.protocol.models import serialized
+
 BOM = b"\xef\xbb\xbf"
 
 
@@ -188,7 +189,7 @@ class SSEResponse(web.StreamResponse):
     async def send_json(
         self, value: Any, *, event: str | None = None, id: str | None = None
     ) -> None:
-        await self.send(json.dumps(value, ensure_ascii=False), event=event, id=id)
+        await self.send(serialized(value).decode(), event=event, id=id)
 
     async def comment(self, text: str = "") -> None:
         await self.push(SSEEvent(comment=text))