From 99fd1a1338d870316e24d727380a9b1e46169e0a Mon Sep 17 00:00:00 2001
From: CREDO23 <bakerathierry@gmail.com>
Date: Wed, 27 May 2026 13:58:57 +0200
Subject: [PATCH] feat(automation): register agent_task action and
 schedule/manual triggers

---
 .../registries/actions/__init__.py            |  3 +++
 .../registries/actions/agent_task.py          | 27 +++++++++++++++++++
 .../registries/triggers/__init__.py           |  3 +++
 .../automations/registries/triggers/manual.py | 17 ++++++++++++
 .../registries/triggers/schedule.py           | 21 +++++++++++++++
 5 files changed, 71 insertions(+)
 create mode 100644 surfsense_backend/app/automations/registries/actions/agent_task.py
 create mode 100644 surfsense_backend/app/automations/registries/triggers/manual.py
 create mode 100644 surfsense_backend/app/automations/registries/triggers/schedule.py

diff --git a/surfsense_backend/app/automations/registries/actions/__init__.py b/surfsense_backend/app/automations/registries/actions/__init__.py
index 1bb3ae9cc..68e507133 100644
--- a/surfsense_backend/app/automations/registries/actions/__init__.py
+++ b/surfsense_backend/app/automations/registries/actions/__init__.py
@@ -12,3 +12,6 @@ __all__ = [
     "get_action",
     "register_action",
 ]
+
+# Built-in actions self-register at import time.
+from . import agent_task  # noqa: E402, F401
diff --git a/surfsense_backend/app/automations/registries/actions/agent_task.py b/surfsense_backend/app/automations/registries/actions/agent_task.py
new file mode 100644
index 000000000..9acc11c2c
--- /dev/null
+++ b/surfsense_backend/app/automations/registries/actions/agent_task.py
@@ -0,0 +1,27 @@
+"""Built-in ``agent_task`` action. Self-registers at import time."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from app.automations.schemas.actions import AgentTaskActionParams
+
+from .store import register_action
+from .types import ActionDefinition
+
+
+async def _handle_agent_task(args: dict[str, Any]) -> dict[str, Any]:
+    """Stub. Validates params; real wiring lands with the executor."""
+    AgentTaskActionParams.model_validate(args)
+    return {"status": "stubbed"}
+
+
+AGENT_TASK_ACTION = ActionDefinition(
+    type="agent_task",
+    name="Agent task",
+    description="Run an agent task with a scoped tool allowlist.",
+    params_schema=AgentTaskActionParams.model_json_schema(),
+    handler=_handle_agent_task,
+)
+
+register_action(AGENT_TASK_ACTION)
diff --git a/surfsense_backend/app/automations/registries/triggers/__init__.py b/surfsense_backend/app/automations/registries/triggers/__init__.py
index 843da5e70..e08dcce76 100644
--- a/surfsense_backend/app/automations/registries/triggers/__init__.py
+++ b/surfsense_backend/app/automations/registries/triggers/__init__.py
@@ -11,3 +11,6 @@ __all__ = [
     "get_trigger",
     "register_trigger",
 ]
+
+# Built-in triggers self-register at import time.
+from . import manual, schedule  # noqa: E402, F401
diff --git a/surfsense_backend/app/automations/registries/triggers/manual.py b/surfsense_backend/app/automations/registries/triggers/manual.py
new file mode 100644
index 000000000..173c38655
--- /dev/null
+++ b/surfsense_backend/app/automations/registries/triggers/manual.py
@@ -0,0 +1,17 @@
+"""Built-in ``manual`` trigger. Self-registers at import time."""
+
+from __future__ import annotations
+
+from app.automations.schemas.triggers import ManualTriggerParams
+
+from .store import register_trigger
+from .types import TriggerDefinition
+
+MANUAL_TRIGGER = TriggerDefinition(
+    type="manual",
+    description="Fire on a user-initiated 'Run now' invocation.",
+    params_schema=ManualTriggerParams.model_json_schema(),
+    payload_schema={"type": "object"},
+)
+
+register_trigger(MANUAL_TRIGGER)
diff --git a/surfsense_backend/app/automations/registries/triggers/schedule.py b/surfsense_backend/app/automations/registries/triggers/schedule.py
new file mode 100644
index 000000000..0a6575f39
--- /dev/null
+++ b/surfsense_backend/app/automations/registries/triggers/schedule.py
@@ -0,0 +1,21 @@
+"""Built-in ``schedule`` trigger. Self-registers at import time."""
+
+from __future__ import annotations
+
+from app.automations.schemas.triggers import ScheduleTriggerParams
+
+from .store import register_trigger
+from .types import TriggerDefinition
+
+SCHEDULE_TRIGGER = TriggerDefinition(
+    type="schedule",
+    description="Fire on a cron schedule in a given timezone.",
+    params_schema=ScheduleTriggerParams.model_json_schema(),
+    payload_schema={
+        "type": "object",
+        "additionalProperties": False,
+        "properties": {},
+    },
+)
+
+register_trigger(SCHEDULE_TRIGGER)