canvas 0.53.0__py3-none-any.whl → 0.53.2__py3-none-any.whl

{canvas-0.53.0.dist-info → canvas-0.53.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: canvas
-Version: 0.53.0
+Version: 0.53.2
 Summary: SDK to customize event-driven actions in your Canvas instance
 Author-email: Canvas Team <engineering@canvasmedical.com>
 License-Expression: MIT

{canvas-0.53.0.dist-info → canvas-0.53.2.dist-info}/RECORD

@@ -98,12 +98,12 @@ canvas_generated/messages/effects_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCN
 canvas_generated/messages/events_pb2.py,sha256=T8aM_hyYLeWcrhtPO4bwQLQb31x36iNkZe9OJBAdcvs,55188
 canvas_generated/messages/events_pb2.pyi,sha256=h__s2YxcuA6YFooql3fl4VXAT_eT5Yoh028H_k5m59o,99437
 canvas_generated/messages/events_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCNMhZD2VXqocC9l_gk,159
-canvas_generated/messages/plugins_pb2.py,sha256=j2yt9uoSlVMtWg-cAoOmxiT-XWbBrqqCBZXOxEz7z4g,1271
-canvas_generated/messages/plugins_pb2.pyi,sha256=G1seqytP8GlJJh-AL2CJ0VyUNlReEvK61C-Oh8QuGiE,501
+canvas_generated/messages/plugins_pb2.py,sha256=5Hs1MSJVWSbkdID3Iir9Vvq3AH2Abt7MyLv0qzuA2MY,1989
+canvas_generated/messages/plugins_pb2.pyi,sha256=0vHABVzAzqthoUrxFeGOZ4OmGQTIfD3mW4DZtjtq-YI,1277
 canvas_generated/messages/plugins_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCNMhZD2VXqocC9l_gk,159
-canvas_generated/services/plugin_runner_pb2.py,sha256=RfAo_imYoSuoexq-1IHhMhXZgQpzq91pqugxsigL8NU,1557
+canvas_generated/services/plugin_runner_pb2.py,sha256=yXJbhjxCJsbUhM3iKF_ACeNNBpD423jCE3v4Wr8Alig,1727
 canvas_generated/services/plugin_runner_pb2.pyi,sha256=1w-Pa4k7HtlmQAr7B6sgV64zdZplBKQKHN-S8bjwO3w,265
-canvas_generated/services/plugin_runner_pb2_grpc.py,sha256=EzJJVkP_AZ3dwBA7OxUito0NSalRmjjg8q9TZ_P18ww,4549
+canvas_generated/services/plugin_runner_pb2_grpc.py,sha256=jBu1qk1Ud6SWKE1p-LSgrT0qknOW-B-ywes1UZuvOK0,8065
 canvas_sdk/__init__.py,sha256=3GEB9s-a9icf8c4JBEXbrsKYbagWNyn1TtJ50n1F3Z0,170
 canvas_sdk/base.py,sha256=vHSb9aKhvKFkQ0ROpIMqQWfPxQG1B7iBk2kGcFWoKEU,4125
 canvas_sdk/caching/__init__.py,sha256=YYXr5tEQlnwMgTXJbOG963tKSPiUOM4mUkX8wuiqp7U,17
@@ -137,7 +137,7 @@ canvas_sdk/commands/commands/medication_statement.py,sha256=1nH-N3sI1T_dLHXksGLH
 canvas_sdk/commands/commands/past_surgical_history.py,sha256=0mwybwfiAFE7elVXw1ichVitC3Jpl1JhPfNP89jhVhU,503
 canvas_sdk/commands/commands/perform.py,sha256=8o5q3snZ7TdkFFTsExZQWctXlpItSJfSihRQVZ3EEGo,409
 canvas_sdk/commands/commands/plan.py,sha256=2aJ9sUzP45sGw5ExHQToCkndidod5zwVx0a93LA1oRk,251
-canvas_sdk/commands/commands/prescribe.py,sha256=q4AHX4efshGcQmxIrEDOqcBNpkCuevtD6tKLInCgl28,8404
+canvas_sdk/commands/commands/prescribe.py,sha256=nuCIDABvFmDUXsUUQl7TvLX-owvO7j5GBd6Gg75Rmr8,8556
 canvas_sdk/commands/commands/reason_for_visit.py,sha256=eEUnlmRa6yNjJ-_6oIHx18s_DKZxkgY0sv7CkyxIbVY,1986
 canvas_sdk/commands/commands/refer.py,sha256=uZFYxBajCiMSABEEztRM-jYxhOa1W2dw--fgi68mIOs,1620
 canvas_sdk/commands/commands/refill.py,sha256=4uTgwIryz_ab4pUGN_wgrEHlDGv__9ecOXOTuLJM6n8,1228
@@ -298,19 +298,19 @@ plugin_runner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plugin_runner/allowed-module-imports.json,sha256=j6-KDxn9oJLZXfLwXBSg35znDOUPHqluxu5CcOC1bOA,35350
 plugin_runner/authentication.py,sha256=UyyhXajokVFH866dpDhoTlXS9Cg7y0sQltn0_LcwXrY,1131
 plugin_runner/aws_headers.py,sha256=wZ8584E1fTW0CdGxOCnLSF8alH27z-URcUyoc6y6ohg,2782
-plugin_runner/exceptions.py,sha256=YnRZiQVzbU3HrVlmEXLje_np99009YnhTRVHHyBCtqc,433
+plugin_runner/exceptions.py,sha256=ltqn56SMTg-T5miSh5hux4ojwx0hZGSWaB7BxyAmcAo,545
 plugin_runner/generate_allowed_imports.py,sha256=LQuVxL_j5n0Sj-KgR4Q8D9mj0xfuDqzO69kBfZUqwGE,2565
-plugin_runner/installation.py,sha256=LLjtnzPk-w4go3UbXnBItJTKz1ajR_5kGQbFXTaWTFU,7693
+plugin_runner/installation.py,sha256=Cpt6FEhIEFColopp9xoCWGn0C3wrRF7BAMOK00W9ZSU,8489
 plugin_runner/load_all_plugins.py,sha256=4T2gW2YljhIx4xfwf1c0F_8oIbE1ubsLj0ShkHRtlVY,5847
-plugin_runner/plugin_runner.py,sha256=PqtvyUHOSvIHRW97zX_NKEjszJ1GVmETXxkZhzkZoe0,21975
+plugin_runner/plugin_runner.py,sha256=ldijT97b5zsnMvr5XxUZ_1wMhVSZ7epvE1ueCrUG5wc,25165
 plugin_runner/sandbox.py,sha256=3xPlDuCHuJkb-K41gV8uABOn-Hla54qkq9iSafP2LVI,30210
 protobufs/canvas_generated/messages/effects.proto,sha256=zTCelFeZ2ajsQPadiWFPOfqqpEB2ekSiLrdqmSd6tbY,9316
 protobufs/canvas_generated/messages/events.proto,sha256=XBMsexTQb_4ZnvRF_u4ghEfKpuHN7eU6CJJmHGM-ThU,51507
-protobufs/canvas_generated/messages/plugins.proto,sha256=oNainUPWFYQjgCX7bJEPI9_VnHC5VZduzOqgR4Q7dNM,109
-protobufs/canvas_generated/services/plugin_runner.proto,sha256=doadBKn5k4xAtOgR-q_pEvW4yzxpUaHNOowMG6CL5GY,304
+protobufs/canvas_generated/messages/plugins.proto,sha256=xJyEeTwM6wWja3vGECLsIzfabwf1VahDgacoPL3TuwI,323
+protobufs/canvas_generated/services/plugin_runner.proto,sha256=PZ0Ts11b9tdA5Gkg2M05JVEKAm0R4LFEwrGRS-TQ16E,466
 pubsub/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pubsub/pubsub.py,sha256=PHIvJ5SD3M-jQSYeGGSj1FuG6CvP6BQffAoGax9Uudk,1423
-canvas-0.53.0.dist-info/METADATA,sha256=abVbeams2cH3qPdbzfknUGPGciSjSF6hcOi-26yxHU4,4645
-canvas-0.53.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-canvas-0.53.0.dist-info/entry_points.txt,sha256=0Vs_9GmTVUNniH6eDBlRPgofmADMV4BES6Ao26M4AbM,47
-canvas-0.53.0.dist-info/RECORD,,
+canvas-0.53.2.dist-info/METADATA,sha256=i5-M9AqUD6vN0_AkeoM-J0bgr3veI232-eW-T4_mxvo,4645
+canvas-0.53.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+canvas-0.53.2.dist-info/entry_points.txt,sha256=0Vs_9GmTVUNniH6eDBlRPgofmADMV4BES6Ao26M4AbM,47
+canvas-0.53.2.dist-info/RECORD,,

canvas_generated/messages/plugins_pb2.py

@@ -14,7 +14,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\'canvas_generated/messages/plugins.proto\"\x16\n\x14ReloadPluginsRequest\"(\n\x15ReloadPluginsResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\'canvas_generated/messages/plugins.proto\"\x16\n\x14ReloadPluginsRequest\"(\n\x15ReloadPluginsResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"%\n\x13ReloadPluginRequest\x12\x0e\n\x06plugin\x18\x01 \x01(\t\"\'\n\x14ReloadPluginResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"%\n\x13UnloadPluginRequest\x12\x0e\n\x06plugin\x18\x01 \x01(\t\"\'\n\x14UnloadPluginResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -25,4 +25,12 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _globals['_RELOADPLUGINSREQUEST']._serialized_end=65
   _globals['_RELOADPLUGINSRESPONSE']._serialized_start=67
   _globals['_RELOADPLUGINSRESPONSE']._serialized_end=107
+  _globals['_RELOADPLUGINREQUEST']._serialized_start=109
+  _globals['_RELOADPLUGINREQUEST']._serialized_end=146
+  _globals['_RELOADPLUGINRESPONSE']._serialized_start=148
+  _globals['_RELOADPLUGINRESPONSE']._serialized_end=187
+  _globals['_UNLOADPLUGINREQUEST']._serialized_start=189
+  _globals['_UNLOADPLUGINREQUEST']._serialized_end=226
+  _globals['_UNLOADPLUGINRESPONSE']._serialized_start=228
+  _globals['_UNLOADPLUGINRESPONSE']._serialized_end=267
 # @@protoc_insertion_point(module_scope)

canvas_generated/messages/plugins_pb2.pyi

@@ -13,3 +13,27 @@ class ReloadPluginsResponse(_message.Message):
     SUCCESS_FIELD_NUMBER: _ClassVar[int]
     success: bool
     def __init__(self, success: bool = ...) -> None: ...
+
+class ReloadPluginRequest(_message.Message):
+    __slots__ = ("plugin",)
+    PLUGIN_FIELD_NUMBER: _ClassVar[int]
+    plugin: str
+    def __init__(self, plugin: _Optional[str] = ...) -> None: ...
+
+class ReloadPluginResponse(_message.Message):
+    __slots__ = ("success",)
+    SUCCESS_FIELD_NUMBER: _ClassVar[int]
+    success: bool
+    def __init__(self, success: bool = ...) -> None: ...
+
+class UnloadPluginRequest(_message.Message):
+    __slots__ = ("plugin",)
+    PLUGIN_FIELD_NUMBER: _ClassVar[int]
+    plugin: str
+    def __init__(self, plugin: _Optional[str] = ...) -> None: ...
+
+class UnloadPluginResponse(_message.Message):
+    __slots__ = ("success",)
+    SUCCESS_FIELD_NUMBER: _ClassVar[int]
+    success: bool
+    def __init__(self, success: bool = ...) -> None: ...

canvas_generated/services/plugin_runner_pb2.py

@@ -16,7 +16,7 @@ from canvas_generated.messages import events_pb2 as canvas__generated_dot_messag
 from canvas_generated.messages import plugins_pb2 as canvas__generated_dot_messages_dot_plugins__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n-canvas_generated/services/plugin_runner.proto\x12\x06\x63\x61nvas\x1a&canvas_generated/messages/events.proto\x1a\'canvas_generated/messages/plugins.proto2\x87\x01\n\x0cPluginRunner\x12\x35\n\x0bHandleEvent\x12\r.canvas.Event\x1a\x15.canvas.EventResponse0\x01\x12@\n\rReloadPlugins\x12\x15.ReloadPluginsRequest\x1a\x16.ReloadPluginsResponse0\x01\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n-canvas_generated/services/plugin_runner.proto\x12\x06\x63\x61nvas\x1a&canvas_generated/messages/events.proto\x1a\'canvas_generated/messages/plugins.proto2\x85\x02\n\x0cPluginRunner\x12\x35\n\x0bHandleEvent\x12\r.canvas.Event\x1a\x15.canvas.EventResponse0\x01\x12@\n\rReloadPlugins\x12\x15.ReloadPluginsRequest\x1a\x16.ReloadPluginsResponse0\x01\x12=\n\x0cReloadPlugin\x12\x14.ReloadPluginRequest\x1a\x15.ReloadPluginResponse0\x01\x12=\n\x0cUnloadPlugin\x12\x14.UnloadPluginRequest\x1a\x15.UnloadPluginResponse0\x01\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -24,5 +24,5 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'canvas_generated.services.p
 if _descriptor._USE_C_DESCRIPTORS == False:
   DESCRIPTOR._options = None
   _globals['_PLUGINRUNNER']._serialized_start=139
-  _globals['_PLUGINRUNNER']._serialized_end=274
+  _globals['_PLUGINRUNNER']._serialized_end=400
 # @@protoc_insertion_point(module_scope)

canvas_generated/services/plugin_runner_pb2_grpc.py

@@ -25,6 +25,16 @@ class PluginRunnerStub(object):
                 request_serializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginsRequest.SerializeToString,
                 response_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginsResponse.FromString,
                 )
+        self.ReloadPlugin = channel.unary_stream(
+                '/canvas.PluginRunner/ReloadPlugin',
+                request_serializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginRequest.SerializeToString,
+                response_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginResponse.FromString,
+                )
+        self.UnloadPlugin = channel.unary_stream(
+                '/canvas.PluginRunner/UnloadPlugin',
+                request_serializer=canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginRequest.SerializeToString,
+                response_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginResponse.FromString,
+                )
 
 
 class PluginRunnerServicer(object):
@@ -42,6 +52,18 @@ class PluginRunnerServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def ReloadPlugin(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def UnloadPlugin(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
 
 def add_PluginRunnerServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -55,6 +77,16 @@ def add_PluginRunnerServicer_to_server(servicer, server):
                     request_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginsRequest.FromString,
                     response_serializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginsResponse.SerializeToString,
             ),
+            'ReloadPlugin': grpc.unary_stream_rpc_method_handler(
+                    servicer.ReloadPlugin,
+                    request_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginRequest.FromString,
+                    response_serializer=canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginResponse.SerializeToString,
+            ),
+            'UnloadPlugin': grpc.unary_stream_rpc_method_handler(
+                    servicer.UnloadPlugin,
+                    request_deserializer=canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginRequest.FromString,
+                    response_serializer=canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginResponse.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'canvas.PluginRunner', rpc_method_handlers)
@@ -98,3 +130,37 @@ class PluginRunner(object):
             canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginsResponse.FromString,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def ReloadPlugin(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(request, target, '/canvas.PluginRunner/ReloadPlugin',
+            canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginRequest.SerializeToString,
+            canvas__generated_dot_messages_dot_plugins__pb2.ReloadPluginResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def UnloadPlugin(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(request, target, '/canvas.PluginRunner/UnloadPlugin',
+            canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginRequest.SerializeToString,
+            canvas__generated_dot_messages_dot_plugins__pb2.UnloadPluginResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

canvas_sdk/commands/commands/prescribe.py

@@ -170,6 +170,9 @@ class PrescribeCommand(_SendableCommandMixin, _BaseCommand):
             if isinstance(compound_data, CompoundMedicationData):
                 values["compound_medication_values"] = compound_data.to_dict()
 
+        if values.get("fdb_code") is not None and values.get("compound_medication_values") == {}:
+            del values["compound_medication_values"]
+
         return values
 
     def originate(self, line_number: int = -1) -> Effect:

plugin_runner/exceptions.py

@@ -12,3 +12,7 @@ class InvalidPluginFormat(PluginValidationError):
 
 class PluginInstallationError(PluginError):
     """An exception raised when a plugin fails to install."""
+
+
+class PluginUninstallationError(PluginError):
+    """An exception raised when a plugin fails to uninstall."""

plugin_runner/installation.py

@@ -17,7 +17,11 @@ from psycopg.rows import dict_row
 
 from logger import log
 from plugin_runner.aws_headers import aws_sig_v4_headers
-from plugin_runner.exceptions import InvalidPluginFormat, PluginInstallationError
+from plugin_runner.exceptions import (
+    InvalidPluginFormat,
+    PluginInstallationError,
+    PluginUninstallationError,
+)
 from settings import (
     AWS_ACCESS_KEY_ID,
     AWS_REGION,
@@ -68,15 +72,28 @@ class PluginAttributes(TypedDict):
     secrets: dict[str, str]
 
 
-def enabled_plugins() -> dict[str, PluginAttributes]:
-    """Returns a dictionary of enabled plugins and their attributes."""
+def enabled_plugins(plugin_names: list[str] | None = None) -> dict[str, PluginAttributes]:
+    """Returns a dictionary of enabled plugins and their attributes.
+
+    If `plugin_names` is provided, only returns those plugins (if enabled).
+    """
     conn = open_database_connection()
 
     with conn.cursor(row_factory=dict_row) as cursor:
-        cursor.execute(
-            "SELECT name, package, version, key, value FROM plugin_io_plugin p "
-            "LEFT JOIN plugin_io_pluginsecret s ON p.id = s.plugin_id WHERE is_enabled"
+        base_query = (
+            "SELECT name, package, version, key, value "
+            "FROM plugin_io_plugin p "
+            "LEFT JOIN plugin_io_pluginsecret s ON p.id = s.plugin_id "
+            "WHERE is_enabled"
         )
+
+        params = []
+        if plugin_names:
+            placeholders = ",".join(["%s"] * len(plugin_names))
+            base_query += f" AND name IN ({placeholders})"
+            params.extend(plugin_names)
+
+        cursor.execute(base_query, params)
         rows = cursor.fetchall()
         plugins = _extract_rows_to_dict(rows)
 
@@ -210,22 +227,31 @@ def disable_plugin(plugin_name: str) -> None:
 
 def uninstall_plugin(plugin_name: str) -> None:
     """Remove the plugin from the filesystem."""
-    log.info(f'Uninstalling plugin "{plugin_name}"')
+    try:
+        log.info(f'Uninstalling plugin "{plugin_name}"')
 
-    plugin_path = Path(PLUGIN_DIRECTORY) / plugin_name
+        plugin_path = Path(PLUGIN_DIRECTORY) / plugin_name
 
-    if plugin_path.exists():
-        shutil.rmtree(plugin_path)
+        if plugin_path.exists():
+            shutil.rmtree(plugin_path)
+    except Exception as e:
+        raise PluginUninstallationError() from e
 
 
 def install_plugins() -> None:
     """Install all enabled plugins."""
     log.info("Installing plugins")
+    try:
+        plugins_dir = Path(PLUGIN_DIRECTORY).resolve()
 
-    if Path(PLUGIN_DIRECTORY).exists():
-        shutil.rmtree(PLUGIN_DIRECTORY)
+        if plugins_dir.exists():
+            shutil.rmtree(plugins_dir.as_posix())
 
-    os.mkdir(PLUGIN_DIRECTORY)
+        plugins_dir.mkdir(parents=False, exist_ok=True)
+    except Exception as e:
+        raise PluginInstallationError(
+            f'Failed to reset plugin directory "{PLUGIN_DIRECTORY}": {e}"'
+        ) from e
 
     for plugin_name, attributes in enabled_plugins().items():
         try:

plugin_runner/plugin_runner.py

@@ -24,7 +24,14 @@ from sentry_sdk.integrations.logging import ignore_logger
 
 import settings
 from canvas_generated.messages.effects_pb2 import EffectType
-from canvas_generated.messages.plugins_pb2 import ReloadPluginsRequest, ReloadPluginsResponse
+from canvas_generated.messages.plugins_pb2 import (
+    ReloadPluginRequest,
+    ReloadPluginResponse,
+    ReloadPluginsRequest,
+    ReloadPluginsResponse,
+    UnloadPluginRequest,
+    UnloadPluginResponse,
+)
 from canvas_generated.services.plugin_runner_pb2_grpc import (
     PluginRunnerServicer,
     add_PluginRunnerServicer_to_server,
@@ -38,7 +45,13 @@ from canvas_sdk.utils import metrics
 from canvas_sdk.utils.metrics import measured
 from logger import log
 from plugin_runner.authentication import token_for_plugin
-from plugin_runner.installation import install_plugins
+from plugin_runner.exceptions import PluginInstallationError, PluginUninstallationError
+from plugin_runner.installation import (
+    enabled_plugins,
+    install_plugin,
+    install_plugins,
+    uninstall_plugin,
+)
 from plugin_runner.sandbox import Sandbox, sandbox_from_module
 from settings import (
     CHANNEL_NAME,
@@ -305,14 +318,51 @@ class PluginRunner(PluginRunnerServicer):
         self, request: ReloadPluginsRequest, context: Any
     ) -> Iterable[ReloadPluginsResponse]:
         """This is invoked when we need to reload plugins."""
-        log.info("Reloading plugins...")
+        log.info("Reloading all plugins...")
+
+        message = {"action": "reload"}
+
         try:
-            publish_message(message={"action": "reload"})
+            publish_message(message=message)
         except ImportError:
             yield ReloadPluginsResponse(success=False)
         else:
             yield ReloadPluginsResponse(success=True)
 
+    def ReloadPlugin(
+        self, request: ReloadPluginRequest, context: Any
+    ) -> Iterable[ReloadPluginResponse]:
+        """This is invoked when we need to reload a specific plugin."""
+        log.info(f'Reloading plugin "{request.plugin}"...')
+
+        message = {
+            "action": "reload",
+            "plugin": request.plugin,
+        }
+        try:
+            publish_message(message=message)
+        except ImportError:
+            yield ReloadPluginResponse(success=False)
+        else:
+            yield ReloadPluginResponse(success=True)
+
+    def UnloadPlugin(
+        self, request: UnloadPluginRequest, context: Any
+    ) -> Iterable[UnloadPluginResponse]:
+        """This is invoked when we need to reload a specific plugin."""
+        log.info(f'Unloading plugin "{request.plugin}"...')
+
+        message = {
+            "action": "unload",
+            "plugin": request.plugin,
+        }
+        try:
+            publish_message(message=message)
+        except ImportError:
+            yield UnloadPluginResponse(success=False)
+        else:
+            yield UnloadPluginResponse(success=True)
+
 
 STOP_SYNCHRONIZER = threading.Event()
 
@@ -346,20 +396,40 @@ def synchronize_plugins(run_once: bool = False) -> None:
         if "action" not in data:
             continue
 
-        if data["action"] == "reload":
-            log.info("synchronize_plugins: installing/reloading plugins for action=reload")
+        plugin_name = data.get("plugin", None)
+        try:
+            if data["action"] == "reload":
+                if plugin_name:
+                    plugin = enabled_plugins([plugin_name]).get(plugin_name, None)
+
+                    if plugin:
+                        log.info(
+                            f'synchronize_plugins: installing/reloading plugin "{plugin_name}" for action=reload'
+                        )
+                        install_plugin(plugin_name, attributes=plugin)
+                        plugin_dir = pathlib.Path(PLUGIN_DIRECTORY) / plugin_name
+                        load_plugin(plugin_dir.resolve())
+                else:
+                    log.info("synchronize_plugins: installing/reloading plugins for action=reload")
+                    install_plugins()
+                    load_plugins()
+            elif data["action"] == "unload" and plugin_name:
+                log.info(f'synchronize_plugins: uninstalling plugin "{plugin_name}"')
+                unload_plugin(plugin_name)
+                uninstall_plugin(plugin_name)
+        except Exception as e:
+            if isinstance(e, PluginInstallationError):
+                message = "install_plugins failed"
+            elif isinstance(e, PluginUninstallationError):
+                message = "uninstall_plugin failed"
+            else:
+                message = "load_plugins failed"
 
-            try:
-                install_plugins()
-            except Exception as e:
-                log.error(f"synchronize_plugins: install_plugins failed: {e}")
-                sentry_sdk.capture_exception(e)
+            if plugin_name:
+                message += f' for plugin "{plugin_name}"'
 
-            try:
-                load_plugins()
-            except Exception as e:
-                log.error(f"synchronize_plugins: load_plugins failed: {e}")
-                sentry_sdk.capture_exception(e)
+            log.error(f"synchronize_plugins: {message}: {e}")
+            sentry_sdk.capture_exception(e)
 
         if run_once:
             break
@@ -523,7 +593,7 @@ def load_or_reload_plugin(path: pathlib.Path) -> bool:
             result = sandbox.execute()
 
             if name_and_class in LOADED_PLUGINS:
-                log.info(f"Reloading plugin '{name_and_class}'")
+                log.info(f"Reloading handler '{name_and_class}'")
 
                 LOADED_PLUGINS[name_and_class]["active"] = True
 
@@ -531,7 +601,7 @@ def load_or_reload_plugin(path: pathlib.Path) -> bool:
                 LOADED_PLUGINS[name_and_class]["sandbox"] = result
                 LOADED_PLUGINS[name_and_class]["secrets"] = secrets_json
             else:
-                log.info(f"Loading plugin '{name_and_class}'")
+                log.info(f'Loading handler "{name_and_class}"')
 
                 LOADED_PLUGINS[name_and_class] = {
                     "active": True,
@@ -553,6 +623,23 @@ def load_or_reload_plugin(path: pathlib.Path) -> bool:
     return not any_failed
 
 
+def unload_plugin(name: str) -> None:
+    """Unload a plugin by its name."""
+    handlers_removed = False
+
+    for handler_name in LOADED_PLUGINS.copy():
+        if handler_name.startswith(f"{name}:"):
+            log.info(f'Unloading handler "{handler_name}"')
+            del LOADED_PLUGINS[handler_name]
+            handlers_removed = True
+
+    if handlers_removed:
+        # Refresh the event type map to remove any handlers for the unloaded plugin
+        refresh_event_type_map()
+    else:
+        log.warning(f"No handlers found for plugin '{name}' to unload.")
+
+
 def refresh_event_type_map() -> None:
     """Ensure the event subscriptions are up to date."""
     EVENT_HANDLER_MAP.clear()
@@ -608,6 +695,13 @@ def load_plugins(specified_plugin_paths: list[str] | None = None) -> None:
     refresh_event_type_map()
 
 
+@measured
+def load_plugin(path: pathlib.Path) -> None:
+    """Load a plugin from the specified path."""
+    load_or_reload_plugin(path)
+    refresh_event_type_map()
+
+
 # NOTE: specified_plugin_paths powers the `canvas run-plugins` command
 def main(specified_plugin_paths: list[str] | None = None) -> None:
     """Run the server and the synchronize_plugins loop."""

protobufs/canvas_generated/messages/plugins.proto

@@ -1,9 +1,24 @@
 syntax = "proto3";
 
 message ReloadPluginsRequest {
-
 }
 
 message ReloadPluginsResponse {
   bool success = 1;
 }
+
+message ReloadPluginRequest {
+  string plugin = 1;
+}
+
+message ReloadPluginResponse {
+  bool success = 1;
+}
+
+message UnloadPluginRequest {
+  string plugin = 1;
+}
+
+message UnloadPluginResponse {
+  bool success = 1;
+}

protobufs/canvas_generated/services/plugin_runner.proto

@@ -9,4 +9,8 @@ service PluginRunner {
   rpc HandleEvent (Event) returns (stream EventResponse);
 
   rpc ReloadPlugins (ReloadPluginsRequest) returns (stream ReloadPluginsResponse);
+
+  rpc ReloadPlugin (ReloadPluginRequest) returns (stream ReloadPluginResponse);
+
+  rpc UnloadPlugin (UnloadPluginRequest) returns (stream UnloadPluginResponse);
 }