Initial commit

opc/plugins/office_ui/services/models.py

@@ -0,0 +1,35 @@
+"""Shared service result types for Office UI, CLI, and CLI board surfaces."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass(frozen=True)
+class ServiceEvent:
+    """Outbound event to publish on UI transports or consume by CLI callers."""
+
+    type: str
+    payload: dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class ServiceResult:
+    """Structured service response plus optional side-effect events."""
+
+    payload: dict[str, Any] = field(default_factory=dict)
+    events: list[ServiceEvent] = field(default_factory=list)
+
+
+class ServiceError(Exception):
+    """Expected business error from a shared service."""
+
+    def __init__(self, code: str, message: str, payload: dict[str, Any] | None = None) -> None:
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.payload = dict(payload or {})
+
+    def to_payload(self) -> dict[str, Any]:
+        return {"error": self.message, "code": self.code, **self.payload}