From c6e5a8e6876ce5808073cc045c56786b0f0ef26f Mon Sep 17 00:00:00 2001
From: Marcel Klehr <mklehr@gmx.net>
Date: Wed, 6 May 2026 13:45:30 +0200
Subject: [PATCH] feat(assignments): Add assignments tools

Signed-off-by: Marcel Klehr <mklehr@gmx.net>
---
 ex_app/lib/agent.py                 |  1 -
 ex_app/lib/all_tools/assignments.py | 85 +++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 1 deletion(-)
 create mode 100644 ex_app/lib/all_tools/assignments.py

diff --git a/ex_app/lib/agent.py b/ex_app/lib/agent.py
index 4c10b76..544f6c0 100644
--- a/ex_app/lib/agent.py
+++ b/ex_app/lib/agent.py
@@ -90,7 +90,6 @@ def export_conversation(checkpointer):
 	# prepare the to-serialize blob
 	state = {"last_config": last_config, "last_checkpoint": last_checkpoint}
 	serialized_state = JsonPlusSerializer().dumps(state)
-	print(serialized_state)
 	# sign the serialized state
 	conversation_token = add_signature(serialized_state.decode('utf-8'), key)
 	return conversation_token
diff --git a/ex_app/lib/all_tools/assignments.py b/ex_app/lib/all_tools/assignments.py
new file mode 100644
index 0000000..6ef374f
--- /dev/null
+++ b/ex_app/lib/all_tools/assignments.py
@@ -0,0 +1,85 @@
+# SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+# SPDX-License-Identifier: AGPL-3.0-or-later
+import datetime
+
+from langchain_core.tools import tool
+from nc_py_api import AsyncNextcloudApp
+
+from ex_app.lib.all_tools.lib.decorator import dangerous_tool, safe_tool
+
+
+async def get_tools(nc: AsyncNextcloudApp):
+
+	@tool
+	@dangerous_tool
+	async def create_assignment(prompt: str, recurrence_rule: str, starts_at: None|str = None):
+		"""
+		Create a recurring assignment for the assistant that will be carried out autonomously.
+		The user will still have to approve sensitive actions.
+		For example, the user could ask to transcribe new files in a certain folder every hour. Then the
+		prompt argument for this tool would be "Transcribe new files in folder /Audio" and the recurrence_rule would be "FREQ=HOURLY".
+		After having created the assignment, let the user know that the assignment will run in a newly created chat session.
+		:param prompt: The instructions for the AI carrying out the assignment
+		:param recurrence_rule: An RRule compliant with RFC 5545 that defines the recurrence rule for the assignment. For example "FREQ=DAILY;INTERVAL=1" to run the assignment every day.
+		:param starts_at: A date time string in ISO 8601 format that defines when the assignment should start. For example "2025-01-01T09:00:00Z". If not provided, the assignment will start immediately.
+		:return:
+		"""
+
+		await nc.ocs('POST', f'/ocs/v2.php/apps/assistant/assignments', json={
+			'prompt': prompt,
+			'recurrence': recurrence_rule,
+			'startsAt': int(datetime.datetime.fromisoformat(starts_at.replace('Z', '+00:00')).timestamp()) if starts_at is not None else datetime.datetime.now(datetime.UTC).timestamp(),
+		})
+
+		return True
+
+	@tool
+	@safe_tool
+	async def list_assignments():
+		"""
+		List all recurring assistant assignments by the current user.
+		:return:
+		"""
+
+		return await nc.ocs('GET', f'/ocs/v2.php/apps/assistant/assignments')
+
+	@tool
+	@dangerous_tool
+	async def update_assignment(id: int, prompt: None|str = None, recurrence_rule: None|str = None, starts_at: None|str = None):
+		"""
+		Update a recurring assistant assignment
+		:param id: The ID of the assignment to update, you can obtain this from the list_assignments tool
+		:param prompt: The instructions for the AI carrying out the assignment. Pass `None` to leave this unchanged.
+		:param recurrence_rule: An RRule compliant with RFC 5545 that defines the recurrence rule for the assignment. For example "FREQ=DAILY;INTERVAL=1" to run the assignment every day. Pass `None` to leave this unchanged.
+		:param starts_at: A date time string in ISO 8601 format that defines when the assignment should start. For example "2025-01-01T09:00:00Z". If not provided, the assignment will start immediately. Pass `None` to leave this unchanged.
+		:return:
+		"""
+
+		return await nc.ocs('PATCH', f'/ocs/v2.php/apps/assistant/assignments/{id}', json={
+			'prompt': prompt,
+			'recurrence': recurrence_rule,
+			'startsAt': int(datetime.datetime.fromisoformat(starts_at.replace('Z', '+00:00')).timestamp()) if starts_at is not None else None,
+		})
+
+	@tool
+	@dangerous_tool
+	async def delete_assignment(id: int):
+		"""
+		Delete a recurring assistant assignment
+		:param id: The ID of the assignment to delete, you can obtain this from the list_assignments tool
+		:return:
+		"""
+		return await nc.ocs('DELETE', f'/ocs/v2.php/apps/assistant/assignments/{id}')
+
+	return [
+		create_assignment,
+		list_assignments,
+		update_assignment,
+		delete_assignment,
+	]
+
+def get_category_name():
+	return "Assistant assignments"
+
+async def is_available(nc: AsyncNextcloudApp):
+	return True
\ No newline at end of file