arcade-core 3.3.3__tar.gz → 3.3.4__tar.gz

{arcade_core-3.3.3 → arcade_core-3.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arcade-core
-Version: 3.3.3
+Version: 3.3.4
 Summary: Arcade Core - Core library for Arcade platform
 Author-email: Arcade <dev@arcade.dev>
 License: MIT

{arcade_core-3.3.3 → arcade_core-3.3.4}/arcade_core/schema.py

@@ -19,7 +19,7 @@ from __future__ import annotations
 import os
 from dataclasses import dataclass
 from enum import Enum
-from typing import Any, Literal
+from typing import Any, Literal, Protocol
 
 from pydantic import BaseModel, Field
 
@@ -29,6 +29,75 @@ from arcade_core.errors import ErrorKind
 TOOL_NAME_SEPARATOR = os.getenv("ARCADE_TOOL_NAME_SEPARATOR", ".")
 
 
+# =====================
+# MCP Feature Protocols and No-Op Implementations
+# =====================
+# These protocols and stubs enable graceful degradation of MCP features
+# in deployed (non-local) environments where the full MCP context is not available.
+
+
+class LogsProtocol(Protocol):
+    """Protocol for logging interface."""
+
+    async def log(
+        self,
+        level: str,
+        message: str,
+        logger_name: str | None = None,
+        extra: dict[str, Any] | None = None,
+    ) -> None: ...
+
+    async def debug(self, message: str, **kwargs: Any) -> None: ...
+
+    async def info(self, message: str, **kwargs: Any) -> None: ...
+
+    async def warning(self, message: str, **kwargs: Any) -> None: ...
+
+    async def error(self, message: str, **kwargs: Any) -> None: ...
+
+
+class ProgressProtocol(Protocol):
+    """Protocol for progress reporting interface."""
+
+    async def report(
+        self, progress: float, total: float | None = None, message: str | None = None
+    ) -> None: ...
+
+
+class _NoOpLogs:
+    """No-op implementation for logging in deployed environments."""
+
+    async def log(
+        self,
+        level: str,
+        message: str,
+        logger_name: str | None = None,
+        extra: dict[str, Any] | None = None,
+    ) -> None:
+        pass
+
+    async def debug(self, message: str, **kwargs: Any) -> None:
+        pass
+
+    async def info(self, message: str, **kwargs: Any) -> None:
+        pass
+
+    async def warning(self, message: str, **kwargs: Any) -> None:
+        pass
+
+    async def error(self, message: str, **kwargs: Any) -> None:
+        pass
+
+
+class _NoOpProgress:
+    """No-op implementation for progress in deployed environments."""
+
+    async def report(
+        self, progress: float, total: float | None = None, message: str | None = None
+    ) -> None:
+        pass
+
+
 class ValueSchema(BaseModel):
     """Value schema for input parameters and outputs."""
 
@@ -390,6 +459,75 @@ class ToolContext(BaseModel):
 
         raise ValueError(f"{item_name.capitalize()} '{key}' not found in context.")
 
+    # ============ MCP Feature Properties ============
+    # Non-critical features (no-op in deployed environments)
+
+    @property
+    def log(self) -> LogsProtocol:
+        """No-op logging interface (not supported in deployed environments)."""
+        return _NoOpLogs()
+
+    @property
+    def progress(self) -> ProgressProtocol:
+        """No-op progress reporting (not supported in deployed environments)."""
+        return _NoOpProgress()
+
+    # Critical features (raise error in deployed environments)
+
+    @property
+    def resources(self) -> Any:
+        """Resources are not available in deployed environments."""
+        raise RuntimeError(
+            "The resources feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def tools(self) -> Any:
+        """Tool calling is not available in deployed environments."""
+        raise RuntimeError(
+            "The tools feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def prompts(self) -> Any:
+        """Prompts are not available in deployed environments."""
+        raise RuntimeError(
+            "The prompts feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def sampling(self) -> Any:
+        """Sampling is not available in deployed environments."""
+        raise RuntimeError(
+            "The sampling feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def ui(self) -> Any:
+        """UI/elicitation is not available in deployed environments."""
+        raise RuntimeError("The ui feature is not supported for Arcade managed servers (non-local)")
+
+    @property
+    def notifications(self) -> Any:
+        """Notifications are not available in deployed environments."""
+        raise RuntimeError(
+            "The notifications feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def request_id(self) -> Any:
+        """Request ID is not available in deployed environments."""
+        raise RuntimeError(
+            "The request_id feature is not supported for Arcade managed servers (non-local)"
+        )
+
+    @property
+    def session_id(self) -> Any:
+        """Session ID is not available in deployed environments."""
+        raise RuntimeError(
+            "The session_id feature is not supported for Arcade managed servers (non-local)"
+        )
+
 
 class ToolCallRequest(BaseModel):
     """The request to call (invoke) a tool."""

{arcade_core-3.3.3 → arcade_core-3.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arcade-core"
-version = "3.3.3"
+version = "3.3.4"
 description = "Arcade Core - Core library for Arcade platform"
 readme = "README.md"
 license = {text = "MIT"}