feat(B-HOOK): Lifecycle Hooks + Outbox Events — 55 neue Hooks, 10 Domain Events

B-HOOK-CORE: Company Hooks (6: before/after create/update/delete)
B-HOOK-MAIL: Mail Hooks (5: after_receive, before/after_delete, before/after_move)
B-HOOK-DMS: DMS Hooks (10: after_upload, before/after_update/delete/restore, folder CRUD)
B-HOOK-CAL: Calendar Hooks (4: before/after update/delete)
B-HOOK-TASK: Task Hooks (6: before/after create/update/delete)
B-HOOK-COMM: Communication Hooks (8: conversation create, message/edit/delete)
B-HOOK-AI: Agent Hooks (2: before/after_run)
B-HOOK-WF: Workflow Hooks (4: before/after_start, after_complete/cancel)
B-HOOK-TAG: Tag Hooks (8: create/assign/unassign/delete)
B-HOOK-SEARCH: Search Filters (2: before/after_search)

B-EVT-OUTBOX: 10 Domain Events (task.completed, file.created/deleted/restored, mail.received, workflow.started/completed/cancelled, agent.run_started/completed)

B-HOOK-TEST: 79 Tests in test_lifecycle_hooks.py — alle grün
B-HOOK-DOC: Plugin-Dev-Guide Kapitel 8 aktualisiert (Hook-Liste + Outbox Event-Liste)

app/plugins/builtins/automation/agent_runner.py

@@ -128,6 +128,21 @@ async def run_agent(
         # Reactive mode: use trigger_data as context
         context_data = trigger_data or {}
 
+    # ── Lifecycle: before run ──
+    from app.core.hooks import do_action
+    await do_action("agent.before_run", agent_id=str(agent.id), tenant_id=str(agent.tenant_id), trigger_type=trigger_type)
+    from app.core.outbox import enqueue_outbox_event
+    async with factory() as db:
+        await enqueue_outbox_event(
+            db,
+            agent.tenant_id,
+            'agent.run_started',
+            {'agent_id': str(agent.id), 'tenant_id': str(agent.tenant_id), 'trigger_type': trigger_type},
+            aggregate_type='agent',
+            aggregate_id=agent.id,
+        )
+        await db.commit()
+
     # Call LLM via LiteLLM
     result_data: dict[str, Any] = {
         "agent_id": str(agent.id),
@@ -239,6 +254,21 @@ async def run_agent(
         result_data["status"] = "failed"
         result_data["error"] = str(e)
 
+    # ── Lifecycle: after run ──
+    from app.core.hooks import do_action
+    await do_action("agent.after_run", agent_id=str(agent.id), tenant_id=str(agent.tenant_id), status=result_data.get("status"), result=result_data)
+    from app.core.outbox import enqueue_outbox_event
+    async with factory() as db:
+        await enqueue_outbox_event(
+            db,
+            agent.tenant_id,
+            'agent.run_completed',
+            {'agent_id': str(agent.id), 'tenant_id': str(agent.tenant_id), 'status': result_data.get('status'), 'cost_usd': result_data.get('cost_usd', 0.0)},
+            aggregate_type='agent',
+            aggregate_id=agent.id,
+        )
+        await db.commit()
+
     # Save result to AgentRun
     try:
         async with factory() as db: