feat: add OCR port family protocols

src/polygateway/ports.py

@@ -14,6 +14,10 @@ from .types import (
     ChatRequest,
     EmbeddingTransportResult,
     LLMResponse,
+    OcrLayoutResult,
+    OcrLayoutTransportResult,
+    OcrTextResult,
+    OcrTextTransportResult,
     SourceConfig,
     SourceStats,
     TransportResult,
@@ -53,6 +57,39 @@ class EmbeddingTransport(Protocol):
     ) -> EmbeddingTransportResult: ...
 
 
+@runtime_checkable
+class OcrTextPort(Protocol):
+    """OCR 文本转录端口(D9;对应 MonkeyOCR POST /ocr/text)。"""
+
+    async def recognize_text(self, image: bytes) -> OcrTextResult: ...
+
+
+@runtime_checkable
+class OcrLayoutPort(Protocol):
+    """OCR 版面解析端口(D9;对应 MonkeyOCR POST /parse → GET ZIP)。"""
+
+    async def parse_layout(self, image: bytes) -> OcrLayoutResult: ...
+
+
+@runtime_checkable
+class OcrTransport(Protocol):
+    """一次原始 OCR 调用的协议细节(M3 设计 §3.2);不含任何治理。
+
+    check_health 是探测不是调用: 2xx → True,异常 → False,
+    CancelledError 穿透;由消费方(启动门)决定成败语义。
+    """
+
+    async def recognize_text(
+        self, *, image: bytes, source: SourceConfig, call_id: str
+    ) -> OcrTextTransportResult: ...
+
+    async def parse_layout(
+        self, *, image: bytes, source: SourceConfig, call_id: str
+    ) -> OcrLayoutTransportResult: ...
+
+    async def check_health(self, *, source: SourceConfig) -> bool: ...
+
+
 @runtime_checkable
 class Permit(Protocol):
     """限流入场许可;settle/release 均幂等,finally 中必然执行。"""