arcade-core 3.3.2__py3-none-any.whl → 3.3.4__py3-none-any.whl

arcade_core/catalog.py

@@ -266,22 +266,37 @@ class ToolCatalog(BaseModel):
             output_model=output_model,
         )
 
-    def add_module(self, module: ModuleType, name: str | None = None) -> None:
+    def add_module(
+        self,
+        module: ModuleType,
+        name: str | None = None,
+        version: str | None = None,
+        description: str | None = None,
+    ) -> None:
         """
         Add all the tools in a module to the catalog.
 
         Args:
             module: The module to add.
             name: Optionally override the name of the toolkit with this parameter
+            version: Optionally override the version of the toolkit with this parameter
+            description: Optionally override the description of the toolkit with this parameter
         """
         toolkit = Toolkit.from_module(module)
         if name:
             toolkit.name = name
-        self.add_toolkit(toolkit)
+        self.add_toolkit(toolkit, version=version, description=description)
 
-    def add_toolkit(self, toolkit: Toolkit) -> None:
+    def add_toolkit(
+        self, toolkit: Toolkit, version: str | None = None, description: str | None = None
+    ) -> None:
         """
         Add the tools from a loaded toolkit to the catalog.
+
+        Args:
+            toolkit: The toolkit to add.
+            version: Optionally override the version of the toolkit with this parameter
+            description: Optionally override the description of the toolkit with this parameter
         """
 
         if str(toolkit).lower() in self._disabled_toolkits:
@@ -293,7 +308,13 @@ class ToolCatalog(BaseModel):
                 try:
                     module = import_module(module_name)
                     tool_func = getattr(module, tool_name)
-                    self.add_tool(tool_func, toolkit, module)
+                    self.add_tool(
+                        tool_func,
+                        toolkit,
+                        module,
+                        toolkit_version=version,
+                        toolkit_description=description,
+                    )
                 except ToolDefinitionError as e:
                     raise e.with_context(tool_name) from e
                 except ToolkitLoadError as e:

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.2.dist-info → arcade_core-3.3.4.dist-info}/METADATA

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

{arcade_core-3.3.2.dist-info → arcade_core-3.3.4.dist-info}/RECORD

@@ -1,7 +1,7 @@
 arcade_core/__init__.py,sha256=1heu3AROAjpistehPzY2H-2nkj_IjQEh-vVlVOCRF1E,88
 arcade_core/annotations.py,sha256=Nst6aejLWXlpTu7GwzWETu1gQCG1XVAUR_qcFbNvyRc,198
 arcade_core/auth.py,sha256=On9sJPOxvHjKBxgKC1yqp7oijF6KYBsG6fG8KUw-9OY,5882
-arcade_core/catalog.py,sha256=n1HtwpaDYdP2K2zqyxJlPbPoEfR3gCkqqzJNDdFUoRc,42679
+arcade_core/catalog.py,sha256=AA13L-ZG4O0S5rB1Fjc-wpLaa6im-dwIBx7GsE2ZW80,43527
 arcade_core/config.py,sha256=e98XQAkYySGW9T_yrJg54BB8Wuq06GPVHp7xqe2d1vU,572
 arcade_core/config_model.py,sha256=78BR6Ch9BDuG4ddWGfpuEKqWcb1fyOF6kxiF4qLFogM,4481
 arcade_core/constants.py,sha256=wakdklI7TyJ0agq9n-Cmb2lbVa95D0oUaMGm30eiv9Y,375
@@ -12,7 +12,7 @@ arcade_core/executor.py,sha256=aFRqB4OdC4b8JJN3zekx0hOWYmihWHAZqVWVlSFXzE4,4308
 arcade_core/output.py,sha256=CMY1pHlQIR27Beiz2I-Yg1aO-P-pbsEbhBZ1RdYuflc,4040
 arcade_core/parse.py,sha256=arKGKL9C6g__tRfZ4re6IM_wAqr1v3LrOzTOBEDLhDc,2366
 arcade_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arcade_core/schema.py,sha256=l1eE4__sliPIMOp70YxQMlEIpiYQWlBUWEUvr9K1wxA,16927
+arcade_core/schema.py,sha256=y32Ndlb1b3Hw7_Wm3eVXxh0kSg3oGitWUYBfwFLjHuY,21198
 arcade_core/toolkit.py,sha256=lLlOL6fA6Lmo-dtLTMMcPCzKDf9YQObwxG1LdVADv3E,14431
 arcade_core/utils.py,sha256=_3bM-yfIDFmMVqt-NFYp2Lx1QcNWp7xytGjUQzPs2LY,3255
 arcade_core/version.py,sha256=CpXi3jGlx23RvRyU7iytOMZrnspdWw4yofS8lpP1AJU,18
@@ -23,6 +23,6 @@ arcade_core/usage/constants.py,sha256=1FQIhkFFMZUhU-H4A7GvMb7KQ3qLFrNAZb2-LEvSF3
 arcade_core/usage/identity.py,sha256=2dP1iusI9pE_GrPlz3VXEdz51R5JlNo9_-OXbe6vn7I,6716
 arcade_core/usage/usage_service.py,sha256=xzWWSEktm58liiNYugBHRactSru8V5foriHcsoH0j1A,3407
 arcade_core/usage/utils.py,sha256=FqBOmlhwT68cbnpI5Vx9ZW6vLRYPVg4FJ0GaMEp8qEM,398
-arcade_core-3.3.2.dist-info/METADATA,sha256=yn7yDI5j9Ud6kj8S4ffI58UzkgXOYWlE0roic8YjlYk,2383
-arcade_core-3.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-arcade_core-3.3.2.dist-info/RECORD,,
+arcade_core-3.3.4.dist-info/METADATA,sha256=FMQ0jM6jmF1V2IuebikCeV5fK4HKphhFthhVBfE30uY,2383
+arcade_core-3.3.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+arcade_core-3.3.4.dist-info/RECORD,,