corvix.actions

Action execution for matched rules.

Classes

MarkReadGateway	Gateway interface for marking notification threads as read.
DismissGateway	Gateway interface for dismissing (deleting) notification threads.
ActionExecutionResult	Summary of actions taken on one notification.
ActionExecutionContext	Bundles all execution dependencies for execute_actions().
_ActionHandler	Strategy interface for a single action type.
_MarkReadHandler	Handles the mark_read action.
_DismissHandler	Handles the dismiss action.

Functions

execute_actions(→ ActionExecutionResult)

Execute configured actions against a notification.

Module Contents

class corvix.actions.MarkReadGateway

Bases: Protocol

Gateway interface for marking notification threads as read.

mark_thread_read(thread_id: str) → None

Mark a thread as read.

class corvix.actions.DismissGateway

Bases: Protocol

Gateway interface for dismissing (deleting) notification threads.

dismiss_thread(thread_id: str) → None

Dismiss a thread from the inbox permanently.

class corvix.actions.ActionExecutionResult

Summary of actions taken on one notification.

actions_taken: list[str] = []

errors: list[str] = []

class corvix.actions.ActionExecutionContext

Bundles all execution dependencies for execute_actions().

Attributes:

gateway: Must implement MarkReadGateway. apply_actions: If False actions are recorded as dry-run only. dismiss_gateway: Must implement DismissGateway; required for dismiss actions. record: The associated NotificationRecord used for dismiss state tracking.

gateway: MarkReadGateway

apply_actions: bool = False

dismiss_gateway: DismissGateway | None = None

record: corvix.domain.NotificationRecord | None = None

class corvix.actions._ActionHandler

Bases: Protocol

Strategy interface for a single action type.

execute(notification: corvix.domain.Notification, result: ActionExecutionResult) → None

Execute the action, mutating result in place.

class corvix.actions._MarkReadHandler(gateway: MarkReadGateway, apply_actions: bool)

Handles the mark_read action.

_gateway

_apply_actions

execute(notification: corvix.domain.Notification, result: ActionExecutionResult) → None

class corvix.actions._DismissHandler(gateway: DismissGateway | None, apply_actions: bool, record: corvix.domain.NotificationRecord | None)

Handles the dismiss action.

_gateway

_apply_actions

_record

execute(notification: corvix.domain.Notification, result: ActionExecutionResult) → None

corvix.actions.execute_actions(notification: corvix.domain.Notification, actions: list[corvix.config.RuleAction], context: ActionExecutionContext) → ActionExecutionResult

Execute configured actions against a notification.

Args:

notification: The notification to act on. actions: The list of rule actions to execute. context: Execution context carrying gateways and flags.