canvas 0.11.1__py3-none-any.whl → 0.13.0__py3-none-any.whl

canvas_generated/messages/events_pb2.pyi

@@ -647,6 +647,9 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     DEFER_CODING_GAP_COMMAND__PRE_EXECUTE_ACTION: _ClassVar[EventType]
     DEFER_CODING_GAP_COMMAND__POST_EXECUTE_ACTION: _ClassVar[EventType]
     DEFER_CODING_GAP_COMMAND__POST_INSERTED_INTO_NOTE: _ClassVar[EventType]
+    SHOW_NOTE_HEADER_BUTTON: _ClassVar[EventType]
+    SHOW_NOTE_FOOTER_BUTTON: _ClassVar[EventType]
+    ACTION_BUTTON_CLICKED: _ClassVar[EventType]
     PATIENT_CHART__CONDITIONS: _ClassVar[EventType]
     PATIENT_CHART_SUMMARY__SECTION_CONFIGURATION: _ClassVar[EventType]
     PATIENT_PROFILE__SECTION_CONFIGURATION: _ClassVar[EventType]
@@ -654,6 +657,8 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     CLAIM__CONDITIONS: _ClassVar[EventType]
     PLUGIN_CREATED: _ClassVar[EventType]
     PLUGIN_UPDATED: _ClassVar[EventType]
+    APPLICATION__ON_OPEN: _ClassVar[EventType]
+    PATIENT_PORTAL__GET_INTAKE_FORMS: _ClassVar[EventType]
 UNKNOWN: EventType
 ALLERGY_INTOLERANCE_CREATED: EventType
 ALLERGY_INTOLERANCE_UPDATED: EventType
@@ -1292,6 +1297,9 @@ DEFER_CODING_GAP_COMMAND__POST_ENTER_IN_ERROR: EventType
 DEFER_CODING_GAP_COMMAND__PRE_EXECUTE_ACTION: EventType
 DEFER_CODING_GAP_COMMAND__POST_EXECUTE_ACTION: EventType
 DEFER_CODING_GAP_COMMAND__POST_INSERTED_INTO_NOTE: EventType
+SHOW_NOTE_HEADER_BUTTON: EventType
+SHOW_NOTE_FOOTER_BUTTON: EventType
+ACTION_BUTTON_CLICKED: EventType
 PATIENT_CHART__CONDITIONS: EventType
 PATIENT_CHART_SUMMARY__SECTION_CONFIGURATION: EventType
 PATIENT_PROFILE__SECTION_CONFIGURATION: EventType
@@ -1299,6 +1307,8 @@ PATIENT_PROFILE__ADD_PHARMACY__POST_SEARCH: EventType
 CLAIM__CONDITIONS: EventType
 PLUGIN_CREATED: EventType
 PLUGIN_UPDATED: EventType
+APPLICATION__ON_OPEN: EventType
+PATIENT_PORTAL__GET_INTAKE_FORMS: EventType
 
 class Event(_message.Message):
     __slots__ = ("type", "target", "context", "target_type")

canvas_sdk/commands/__init__.py

@@ -2,6 +2,7 @@ from canvas_sdk.commands.commands.allergy import AllergyCommand
 from canvas_sdk.commands.commands.assess import AssessCommand
 from canvas_sdk.commands.commands.close_goal import CloseGoalCommand
 from canvas_sdk.commands.commands.diagnose import DiagnoseCommand
+from canvas_sdk.commands.commands.exam import PhysicalExamCommand
 from canvas_sdk.commands.commands.family_history import FamilyHistoryCommand
 from canvas_sdk.commands.commands.goal import GoalCommand
 from canvas_sdk.commands.commands.history_present_illness import (
@@ -21,7 +22,9 @@ from canvas_sdk.commands.commands.questionnaire import QuestionnaireCommand
 from canvas_sdk.commands.commands.reason_for_visit import ReasonForVisitCommand
 from canvas_sdk.commands.commands.refill import RefillCommand
 from canvas_sdk.commands.commands.remove_allergy import RemoveAllergyCommand
+from canvas_sdk.commands.commands.review_of_systems import ReviewOfSystemsCommand
 from canvas_sdk.commands.commands.stop_medication import StopMedicationCommand
+from canvas_sdk.commands.commands.structured_assessment import StructuredAssessmentCommand
 from canvas_sdk.commands.commands.task import TaskCommand
 from canvas_sdk.commands.commands.update_diagnosis import UpdateDiagnosisCommand
 from canvas_sdk.commands.commands.update_goal import UpdateGoalCommand
@@ -43,11 +46,14 @@ __all__ = (
     "PerformCommand",
     "PlanCommand",
     "PrescribeCommand",
+    "PhysicalExamCommand",
     "QuestionnaireCommand",
     "ReasonForVisitCommand",
     "RefillCommand",
     "RemoveAllergyCommand",
+    "ReviewOfSystemsCommand",
     "StopMedicationCommand",
+    "StructuredAssessmentCommand",
     "TaskCommand",
     "UpdateDiagnosisCommand",
     "UpdateGoalCommand",

canvas_sdk/commands/commands/exam.py

@@ -0,0 +1,9 @@
+from canvas_sdk.commands.commands.questionnaire import QuestionnaireCommand
+
+
+class PhysicalExamCommand(QuestionnaireCommand):
+    """A class for managing physical exam command."""
+
+    class Meta:
+        key = "exam"
+        commit_required_fields = ("questionnaire_id",)

canvas_sdk/commands/commands/review_of_systems.py

@@ -0,0 +1,9 @@
+from canvas_sdk.commands.commands.questionnaire import QuestionnaireCommand
+
+
+class ReviewOfSystemsCommand(QuestionnaireCommand):
+    """A class for managing physical exam command."""
+
+    class Meta:
+        key = "ros"
+        commit_required_fields = ("questionnaire_id",)

canvas_sdk/commands/commands/structured_assessment.py

@@ -0,0 +1,9 @@
+from canvas_sdk.commands.commands.questionnaire import QuestionnaireCommand
+
+
+class StructuredAssessmentCommand(QuestionnaireCommand):
+    """A class for managing physical exam command."""
+
+    class Meta:
+        key = "structuredAssessment"
+        commit_required_fields = ("questionnaire_id",)

canvas_sdk/effects/__init__.py

@@ -1,3 +1,5 @@
 from canvas_generated.messages.effects_pb2 import Effect, EffectType
 
-__all__ = ("Effect", "EffectType")
+from .base import _BaseEffect
+
+__all__ = ("Effect", "EffectType", "_BaseEffect")

canvas_sdk/effects/launch_modal.py

@@ -0,0 +1,24 @@
+from enum import StrEnum
+from typing import Any
+
+from canvas_sdk.effects import EffectType, _BaseEffect
+
+
+class LaunchModalEffect(_BaseEffect):
+    """An Effect that will launch a modal."""
+
+    class Meta:
+        effect_type = EffectType.LAUNCH_MODAL
+
+    class TargetType(StrEnum):
+        DEFAULT_MODAL = "default_modal"
+        NEW_WINDOW = "new_window"
+        RIGHT_CHART_PANE = "right_chart_pane"
+
+    url: str
+    target: TargetType = TargetType.DEFAULT_MODAL
+
+    @property
+    def values(self) -> dict[str, Any]:
+        """The LaunchModalEffect values."""
+        return {"url": self.url, "target": self.target.value}

canvas_sdk/effects/patient_portal/intake_form_results.py

@@ -0,0 +1,24 @@
+from typing import Any
+
+from pydantic import Field
+
+from canvas_sdk.effects.base import EffectType, _BaseEffect
+
+
+class IntakeFormResults(_BaseEffect):
+    """An Effect that will decide which intake forms (questionnaires) appear on the patient portal."""
+
+    class Meta:
+        effect_type = EffectType.PATIENT_PORTAL__INTAKE_FORM_RESULTS
+
+    questionnaire_ids: list = Field(min_length=0)
+
+    @property
+    def values(self) -> dict[str, Any]:
+        """The IntakeFormResults's values."""
+        return {"questionnaire_ids": [str(q) for q in self.questionnaire_ids]}
+
+    @property
+    def effect_payload(self) -> dict[str, Any]:
+        """The payload of the effect."""
+        return {"data": self.values}

canvas_sdk/effects/show_button.py

@@ -0,0 +1,28 @@
+from typing import Any
+
+from pydantic import Field
+
+from canvas_generated.messages.effects_pb2 import EffectType
+from canvas_sdk.effects.base import _BaseEffect
+
+
+class ShowButtonEffect(_BaseEffect):
+    """
+    An Effect that will decide an action button's properties.
+    """
+
+    class Meta:
+        effect_type = EffectType.SHOW_ACTION_BUTTON
+
+    key: str = Field(min_length=1)
+    title: str = Field(min_length=1)
+
+    @property
+    def values(self) -> dict[str, Any]:
+        """The ShowButtonEffect's values."""
+        return {"key": self.key, "title": self.title}
+
+    @property
+    def effect_payload(self) -> dict[str, Any]:
+        """The payload of the effect."""
+        return {"data": self.values}

canvas_sdk/handlers/action_button.py

@@ -0,0 +1,55 @@
+from abc import abstractmethod
+from enum import StrEnum
+
+from canvas_sdk.effects import Effect
+from canvas_sdk.effects.show_button import ShowButtonEffect
+from canvas_sdk.events import EventType
+from canvas_sdk.handlers.base import BaseHandler
+
+
+class ActionButton(BaseHandler):
+    """Base class for action buttons."""
+
+    RESPONDS_TO = [
+        EventType.Name(EventType.SHOW_NOTE_HEADER_BUTTON),
+        EventType.Name(EventType.SHOW_NOTE_FOOTER_BUTTON),
+        EventType.Name(EventType.ACTION_BUTTON_CLICKED),
+    ]
+
+    class ButtonLocation(StrEnum):
+        NOTE_HEADER = "note_header"
+        NOTE_FOOTER = "note_footer"
+
+    BUTTON_TITLE: str = ""
+    BUTTON_KEY: str = ""
+    BUTTON_LOCATION: ButtonLocation | None = None
+
+    @abstractmethod
+    def handle(self) -> list[Effect]:
+        """Method to handle button click."""
+        raise NotImplementedError("Implement to handle button click")
+
+    def visible(self) -> bool:
+        """Method to determine button visibility."""
+        return True
+
+    def compute(self) -> list[Effect]:
+        """Method to compute the effects."""
+        if self.BUTTON_LOCATION is None:
+            return []
+
+        if self.event.type in (
+            EventType.SHOW_NOTE_HEADER_BUTTON,
+            EventType.SHOW_NOTE_FOOTER_BUTTON,
+        ):
+            if self.context["location"].lower() == self.BUTTON_LOCATION.value and self.visible():
+                return [ShowButtonEffect(key=self.BUTTON_KEY, title=self.BUTTON_TITLE).apply()]
+            else:
+                return []
+        elif (
+            self.event.type == EventType.ACTION_BUTTON_CLICKED
+            and self.context["key"] == self.BUTTON_KEY
+        ):
+            return self.handle()
+
+        return []

canvas_sdk/handlers/application.py

@@ -0,0 +1,29 @@
+from abc import ABC, abstractmethod
+
+from canvas_sdk.effects import Effect
+from canvas_sdk.events import EventType
+from canvas_sdk.handlers import BaseHandler
+
+
+class Application(BaseHandler, ABC):
+    """An embeddable application that can be registered to Canvas."""
+
+    RESPONDS_TO = [EventType.Name(EventType.APPLICATION__ON_OPEN)]
+
+    def compute(self) -> list[Effect]:
+        """Handle the application events."""
+        match self.event.type:
+            case EventType.APPLICATION__ON_OPEN:
+                return [self.on_open()] if self.target == self.identifier else []
+            case _:
+                return []
+
+    @abstractmethod
+    def on_open(self) -> Effect:
+        """Handle the application open event."""
+        ...
+
+    @property
+    def identifier(self) -> str:
+        """The application identifier."""
+        return f"{self.__class__.__module__}:{self.__class__.__qualname__}"

canvas_sdk/handlers/base.py

@@ -1,14 +1,16 @@
 import importlib.metadata
+from abc import ABC, abstractmethod
 from typing import Any
 
 import deprecation
 
+from canvas_sdk.effects import Effect
 from canvas_sdk.events import Event
 
 version = importlib.metadata.version("canvas")
 
 
-class BaseHandler:
+class BaseHandler(ABC):
     """The class that all handlers inherit from."""
 
     secrets: dict[str, Any]
@@ -43,3 +45,8 @@ class BaseHandler:
     def target(self) -> str:
         """The target id of the event."""
         return self.event.target.id
+
+    @abstractmethod
+    def compute(self) -> list[Effect]:
+        """Compute the effects to be applied."""
+        pass

canvas_sdk/protocols/base.py

@@ -1,7 +1,9 @@
+from abc import ABC
+
 from canvas_sdk.handlers.base import BaseHandler
 
 
-class BaseProtocol(BaseHandler):
+class BaseProtocol(BaseHandler, ABC):
     """
     The class that protocols inherit from.
     """

canvas_sdk/v1/data/__init__.py

@@ -1,7 +1,9 @@
 from .billing import BillingLineItem
 from .condition import Condition, ConditionCoding
 from .medication import Medication, MedicationCoding
+from .organization import Organization
 from .patient import Patient
+from .practicelocation import PracticeLocation
 from .staff import Staff
 from .task import Task, TaskComment, TaskLabel
 
@@ -11,7 +13,9 @@ __all__ = (
     "ConditionCoding",
     "Medication",
     "MedicationCoding",
+    "Organization",
     "Patient",
+    "PracticeLocation",
     "Staff",
     "Task",
     "TaskComment",

canvas_sdk/v1/data/note.py

@@ -141,7 +141,7 @@ class Note(models.Model):
     created = models.DateTimeField()
     modified = models.DateTimeField()
     patient = models.ForeignKey(Patient, on_delete=models.DO_NOTHING)
-    # provider = models.ForeignKey(Staff, on_delete=models.DO_NOTHING, related_name="notes")
+    provider = models.ForeignKey("Staff", on_delete=models.DO_NOTHING, related_name="notes")
     note_type = models.CharField(choices=NoteTypes.choices, null=True)
     note_type_version = models.ForeignKey(
         "NoteType", on_delete=models.DO_NOTHING, related_name="notes"
@@ -149,13 +149,12 @@ class Note(models.Model):
     title = models.TextField()
     body = models.JSONField()
     originator = models.ForeignKey(CanvasUser, on_delete=models.DO_NOTHING)
-    # last_modified_by_staff = models.ForeignKey(Staff, on_delete=models.DO_NOTHING, null=True)
+    last_modified_by_staff = models.ForeignKey("Staff", on_delete=models.DO_NOTHING, null=True)
     checksum = models.CharField()
     billing_note = models.TextField()
     # TODO -implement InpatientStay model
     # inpatient_stay = models.ForeignKey("InpatientStay", on_delete=models.DO_NOTHING)
     related_data = models.JSONField()
-    # TODO -implement PracticeLocation model
-    # location = models.ForeignKey(PracticeLocation, on_delete=models.DO_NOTHING)
+    location = models.ForeignKey("PracticeLocation", on_delete=models.DO_NOTHING)
     datetime_of_service = models.DateTimeField()
     place_of_service = models.CharField()

canvas_sdk/v1/data/organization.py

@@ -0,0 +1,29 @@
+from django.db import models
+
+from canvas_sdk.v1.data.common import TaxIDType
+
+
+class Organization(models.Model):
+    """Organization."""
+
+    class Meta:
+        managed = False
+        app_label = "canvas_sdk"
+        db_table = "canvas_sdk_data_api_organization_001"
+
+    dbid = models.BigIntegerField(primary_key=True)
+    created = models.DateTimeField()
+    modified = models.DateTimeField()
+    full_name = models.CharField()
+    short_name = models.CharField()
+    subdomain = models.CharField()
+    logo_url = models.CharField()
+    background_image_url = models.CharField()
+    background_gradient = models.CharField()
+    active = models.BooleanField()
+    tax_id = models.CharField(null=True)
+    tax_id_type = models.CharField(choices=TaxIDType.choices)
+    group_npi_number = models.CharField()
+    group_taxonomy_number = models.CharField()
+    include_zz_qualifier = models.BooleanField()
+    main_location = models.OneToOneField("PracticeLocation", on_delete=models.DO_NOTHING)

canvas_sdk/v1/data/practicelocation.py

@@ -0,0 +1,105 @@
+from django.db import models
+
+from canvas_sdk.v1.data.common import TaxIDType
+
+
+class PracticeLocationPOS(models.TextChoices):
+    """PracticeLocationPOS choices."""
+
+    PHARMACY = "01", "Pharmacy"
+    TELEHEALTH = "02", "Telehealth"
+    SCHOOL = "03", "Education Facility"
+    HOMELESS_SHELTER = "04", "Homeless Shelter"
+    PRISON = "09", "Prison"
+    TELEHEALTH_IN_PATIENT_HOME = "10", "Telehealth in Patient's Home"
+    OFFICE = "11", "Office"
+    HOME = "12", "Home"
+    ASSISTED_LIVING = "13", "Asssisted Living Facility"
+    GROUP_HOME = "14", "Group Home"
+    MOBILE = "15", "Mobile Unit"
+    WALK_IN_RETAIL = "17", "Walk-In Retail Health Clinic"
+    OFF_CAMPUS_OUTPATIENT_HOSPITAL = "19", "Off-Campus Outpatient Hospital"
+    URGENT_CARE = "20", "Urgent Care Facility"
+    INPATIENT_HOSPITAL = "21", "Inpatient Hospital"
+    ON_CAMPUS_OUTPATIENT_HOSPITAL = "22", "On-Campus Outpatient Hospital"
+    ER_HOSPITAL = "23", "Emergency Room Hospital"
+    AMBULATORY_SURGERY_CENTER = "24", "Ambulatory Surgery Center"
+    BIRTHING_CENTER = "25", "Birthing Center"
+    MILITARY_FACILITY = "26", "Military Treatment Facility"
+    STREET = "27", "Outreach Site / Street"
+    SNF = "31", "Skilled Nursing Facility"
+    NURSING = "32", "Nursing Facility"
+    CUSTODIAL = "33", "Custodial Care Facility"
+    HOSPICE = "34", "Hospice"
+    AMBULANCE_LAND = "41", "Ambulance Land"
+    AMBULANCE_AIR_WATER = "42", "Ambulance Air or Water"
+    INDEPENDENT_CLINIC = "49", "Independent Clinic"
+    FQHC = "50", "Federally Qualified Health Center"
+    PSYCH = "51", "Inpatient Psychiatric Facility"
+    PSYCH_PARTIAL = "52", "Inpatient Psychiatric Facility - Partial Hospitalization"
+    MENTAL_HEALTH_CENTER = "53", "Community Mental Health Center"
+    INTERMEDIATE_MENTAL = "54", "Intermediate Care Facility for Mentally Retarded"
+    SUBSTANCE_RESIDENTIAL = "55", "Residential Substance Abuse Treatment Facility"
+    PSYCH_RESIDENTIAL = "56", "Psychiatric Residential Treatment Center"
+    SUBSTANCE_NON_RESIDENTIAL = "57", "Non-Residential Substance Abuse Treatment Facility"
+    MASS_IMMUNIZATION = "60", "Mass Immunization Center"
+    INPATIENT_REHAB = "61", "Inpatient Rehabilitation Facility"
+    OUTPATIENT_REHAB = "62", "Outpatient Rehabilitation Facility"
+    ESRD = "65", "End-Stage Renal Disease Treatment Facility"
+    PUBLIC_CLINIC = "71", "State or Local Public Health Clinic"
+    RURAL_CLINIC = "72", "Rural Health Clinic"
+    INDEPENDENT_LAB = "81", "Independent Laboratory"
+    OTHER = "99", "Other Place of Service"
+
+
+class PracticeLocation(models.Model):
+    """PracticeLocation."""
+
+    class Meta:
+        managed = False
+        app_label = "canvas_sdk"
+        db_table = "canvas_sdk_data_api_practicelocation_001"
+
+    id = models.UUIDField()
+    dbid = models.BigIntegerField(primary_key=True)
+    created = models.DateTimeField()
+    modified = models.DateTimeField()
+    organization = models.ForeignKey(
+        "Organization", on_delete=models.DO_NOTHING, related_name="practice_locations"
+    )
+    place_of_service_code = models.CharField(choices=PracticeLocationPOS.choices)
+    full_name = models.CharField()
+    short_name = models.CharField()
+    background_image_url = models.CharField()
+    background_gradient = models.CharField()
+    active = models.BooleanField()
+    npi_number = models.CharField()
+    bill_through_organization = models.BooleanField()
+    tax_id = models.CharField()
+    tax_id_type = models.CharField(choices=TaxIDType.choices)
+    billing_location_name = models.CharField()
+    group_npi_number = models.CharField()
+    taxonomy_number = models.CharField()
+    include_zz_qualifier = models.BooleanField()
+
+    def __str__(self) -> str:
+        return self.full_name
+
+
+class PracticeLocationSetting(models.Model):
+    """PracticeLocationSetting."""
+
+    class Meta:
+        managed = False
+        app_label = "canvas_sdk"
+        db_table = "canvas_sdk_data_api_practicelocationsetting_001"
+
+    dbid = models.BigIntegerField(primary_key=True)
+    practice_location = models.ForeignKey(
+        PracticeLocation, on_delete=models.DO_NOTHING, related_name="settings"
+    )
+    name = models.CharField()
+    value = models.JSONField()
+
+    def __str__(self) -> str:
+        return self.name

plugin_runner/plugin_runner.py

@@ -42,8 +42,8 @@ sys.path.append(PLUGIN_DIRECTORY)
 # TODO: create typings here for the subkeys
 LOADED_PLUGINS: dict = {}
 
-# a global dictionary of events to protocol class names
-EVENT_PROTOCOL_MAP: dict[str, list] = defaultdict(list)
+# a global dictionary of events to handler class names
+EVENT_HANDLER_MAP: dict[str, list] = defaultdict(list)
 
 
 class DataAccess(TypedDict):
@@ -63,6 +63,17 @@ Protocol = TypedDict(
 )
 
 
+ApplicationConfig = TypedDict(
+    "ApplicationConfig",
+    {
+        "class": str,
+        "description": str,
+        "icon": str,
+        "scope": str,
+    },
+)
+
+
 class Components(TypedDict):
     """Components."""
 
@@ -71,6 +82,7 @@ class Components(TypedDict):
     content: list[dict]
     effects: list[dict]
     views: list[dict]
+    applications: list[ApplicationConfig]
 
 
 class PluginManifest(TypedDict):
@@ -106,7 +118,7 @@ class PluginRunner(PluginRunnerServicer):
         event = Event(request)
         event_type = event.type
         event_name = event.name
-        relevant_plugins = EVENT_PROTOCOL_MAP[event_name]
+        relevant_plugins = EVENT_HANDLER_MAP[event_name]
 
         if event_type in [EventType.PLUGIN_CREATED, EventType.PLUGIN_UPDATED]:
             plugin_name = event.target.id
@@ -117,22 +129,22 @@ class PluginRunner(PluginRunnerServicer):
 
         for plugin_name in relevant_plugins:
             plugin = LOADED_PLUGINS[plugin_name]
-            protocol_class = plugin["class"]
+            handler_class = plugin["class"]
             base_plugin_name = plugin_name.split(":")[0]
 
             secrets = plugin.get("secrets", {})
             secrets["graphql_jwt"] = token_for_plugin(plugin_name=plugin_name, audience="home")
 
             try:
-                protocol = protocol_class(event, secrets)
+                handler = handler_class(event, secrets)
                 classname = (
-                    protocol.__class__.__name__
-                    if isinstance(protocol, ClinicalQualityMeasure)
+                    handler.__class__.__name__
+                    if isinstance(handler, ClinicalQualityMeasure)
                     else None
                 )
 
                 compute_start_time = time.time()
-                _effects = await asyncio.get_running_loop().run_in_executor(None, protocol.compute)
+                _effects = await asyncio.get_running_loop().run_in_executor(None, handler.compute)
                 effects = [
                     Effect(
                         type=effect.type,
@@ -165,7 +177,7 @@ class PluginRunner(PluginRunnerServicer):
 
         event_duration = get_duration_ms(event_start_time)
 
-        # Don't log anything if a protocol didn't actually run.
+        # Don't log anything if a plugin handler didn't actually run.
         if relevant_plugins:
             log.info(f"Responded to Event {event_name} ({event_duration} ms)")
             statsd_tags = tags_to_line_protocol({"event": event_name})
@@ -275,7 +287,7 @@ def sandbox_from_module(package_path: pathlib.Path, module_name: str) -> Any:
 
     full_module_name = f"{package_path.name}.{module_name}"
 
-    sandbox = Sandbox(source_code, module_name=full_module_name)
+    sandbox = Sandbox(source_code, namespace=full_module_name)
     return sandbox.execute()
 
 
@@ -306,43 +318,45 @@ def load_or_reload_plugin(path: pathlib.Path) -> None:
 
     # TODO add existing schema validation from Michela here
     try:
-        protocols = manifest_json["components"]["protocols"]
+        handlers = manifest_json["components"].get("protocols", []) + manifest_json[
+            "components"
+        ].get("applications", [])
         results = sandbox_from_package(path)
     except Exception as e:
         log.error(f'Unable to load plugin "{name}": {str(e)}')
         return
 
-    for protocol in protocols:
+    for handler in handlers:
         # TODO add class colon validation to existing schema validation
         # TODO when we encounter an exception here, disable the plugin in response
         try:
-            protocol_module, protocol_class = protocol["class"].split(":")
-            name_and_class = f"{name}:{protocol_module}:{protocol_class}"
+            handler_module, handler_class = handler["class"].split(":")
+            name_and_class = f"{name}:{handler_module}:{handler_class}"
         except ValueError:
-            log.error(f"Unable to parse class for plugin '{name}': '{protocol['class']}'")
+            log.error(f"Unable to parse class for plugin '{name}': '{handler['class']}'")
             continue
 
         try:
             if name_and_class in LOADED_PLUGINS:
                 log.info(f"Reloading plugin '{name_and_class}'")
 
-                result = results[protocol_module]
+                result = results[handler_module]
 
                 LOADED_PLUGINS[name_and_class]["active"] = True
 
-                LOADED_PLUGINS[name_and_class]["class"] = result[protocol_class]
+                LOADED_PLUGINS[name_and_class]["class"] = result[handler_class]
                 LOADED_PLUGINS[name_and_class]["sandbox"] = result
                 LOADED_PLUGINS[name_and_class]["secrets"] = secrets_json
             else:
                 log.info(f"Loading plugin '{name_and_class}'")
 
-                result = results[protocol_module]
+                result = results[handler_module]
 
                 LOADED_PLUGINS[name_and_class] = {
                     "active": True,
-                    "class": result[protocol_class],
+                    "class": result[handler_class],
                     "sandbox": result,
-                    "protocol": protocol,
+                    "handler": handler,
                     "secrets": secrets_json,
                 }
         except Exception as err:
@@ -353,17 +367,17 @@ def load_or_reload_plugin(path: pathlib.Path) -> None:
 
 def refresh_event_type_map() -> None:
     """Ensure the event subscriptions are up to date."""
-    EVENT_PROTOCOL_MAP.clear()
+    EVENT_HANDLER_MAP.clear()
 
     for name, plugin in LOADED_PLUGINS.items():
         if hasattr(plugin["class"], "RESPONDS_TO"):
             responds_to = plugin["class"].RESPONDS_TO
 
             if isinstance(responds_to, str):
-                EVENT_PROTOCOL_MAP[responds_to].append(name)
+                EVENT_HANDLER_MAP[responds_to].append(name)
             elif isinstance(responds_to, list):
                 for event in responds_to:
-                    EVENT_PROTOCOL_MAP[event].append(name)
+                    EVENT_HANDLER_MAP[event].append(name)
             else:
                 log.warning(f"Unknown RESPONDS_TO type: {type(responds_to)}")