Merge branch 'master' into dependabot/pip/master/docutils-0.22

Signed-off-by: rakekniven <[email protected]>

Author: rakekniven

.github/workflows/check-occ-command.yml

@@ -10,7 +10,7 @@ jobs:
     name: Check occ command syntax
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Run script
         run: |

.github/workflows/codespell.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: self-hosted
     steps:
       - name: Check out code
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.2.2
         with:
           persist-credentials: false
 

.github/workflows/generate_catalog_templates.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.2.2
         with:
           persist-credentials: false
 

.github/workflows/openapi.yml

@@ -15,12 +15,12 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.2.2
         with:
           submodules: true
 
       - name: Set up php
-        uses: shivammathur/setup-php@0f7f1d08e3e32076e51cae65eb0b0c871405b16e # v2
+        uses: shivammathur/setup-php@20529878ed81ef8e78ddf08b480401e6101a850f # v2
         with:
           php-version: '8.1'
           # https://docs.nextcloud.com/server/stable/admin_manual/installation/source_installation.html#prerequisites-for-manual-installation

.github/workflows/sphinxbuild.yml

@@ -11,7 +11,7 @@ jobs:
   user_manual:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+    - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
     - uses: actions/setup-python@v5
       with:
         python-version: '3.10'
@@ -32,7 +32,7 @@ jobs:
   user_manual-en:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+    - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
     - uses: actions/setup-python@v5
       with:
         python-version: '3.10'
@@ -45,7 +45,7 @@ jobs:
   developer_manual:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+    - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
     - uses: actions/setup-python@v5
       with:
         python-version: '3.10'
@@ -66,7 +66,7 @@ jobs:
   admin_manual:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+    - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
     - uses: actions/setup-python@v5
       with:
         python-version: '3.10'

admin_manual/ai/app_assistant.rst

@@ -193,6 +193,14 @@ Set 1 to enable and 0 to disable an implemented task type.
 
 shows statistics for all task processing Tasks.
 
+5. Clean-up old tasks
+
+.. code-block::
+
+   occ taskprocessing:task:cleanup
+
+delete tasks that are older than this number of seconds, defaults to 4 months.
+
 Image storage
 ~~~~~~~~~~~~~
 

admin_manual/ai/app_context_agent.rst

@@ -143,6 +143,21 @@ These tools can also be combined by the agent to fulfil tasks like the following
 
   * Uses contacts to look up Andrew's email and then sends an email
 
+Custom Tools using MCP
+-----------------------
+
+Model Context Protocol (MCP) is a protocol that enables Large Language Models (LLMs) to interact with external data sources and tools.
+The Context Agent app allows administrators to extend its capabilities by adding custom services via MCP. This can be configured in the admin settings under "MCP Config," where you can provide a JSON configuration in the following format:
+
+.. code-block:: json
+
+  {
+    "service-name": {
+      "url": "https://service-url.com/endpoint",
+      "transport": "streamable_http"
+    }
+  }
+
 Requirements
 ------------
 
@@ -176,6 +191,13 @@ Other models that may give good results are:
 
 See :ref:`llm2 documentation <ai-app-llm2>` on how to configure alternate models.
 
+Using Nextcloud MCP Server
+--------------------------
+
+Context Agent exposes an MCP server that can be used by other large language models or applications to access the tools provided by Context Agent.
+The server will be available at `https://your-nextcloud-domain.com/index.php/apps/app_api/proxy/context_agent/mcp/`, and
+it requires authentication via an app password passed in the `Authorization` header. Ex: `Authorization: Bearer <app-password>`.
+
 Scaling
 -------
 
@@ -198,4 +220,7 @@ Known Limitations
 * Make sure to test the language model you are using in concert with this app for whether they meet the use-case's quality requirements
 * Most models have difficulties with languages other than English. Some sometimes answer in another language than used by the user. 
 * Customer support is available upon request, however we can't solve false or problematic output, most performance issues, or other problems caused by the underlying model. 
-  Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app. 
+  Support is thus limited only to bugs directly caused by the implementation of the app (connectors, API, front-end, AppAPI). We still try to optimize this as far as possible, so if you encounter any false or problematic output, you can report it `in a dedicated Github issue <https://github.com/nextcloud/context_agent/issues/51>`_ to help us improve this app. 
+* When multiple MCP services are configured that have tools with the same name undefined behavior will occur.
+* Only remote MCP services are supported (streamable_http transport).
+* MCP services that require different access tokens for each user are not currently supported.

admin_manual/ai/overview.rst

@@ -244,6 +244,21 @@ Provider apps
 
 See *Context Chat* section above.
 
+Document generation
+^^^^^^^^^^^^^^^^^^^
+Since Hub 11 you can let Nextcloud automatically generate Office documents with content.
+This functionality is available in the assistant app and made possible by the Nextcloud Office app.
+
+Frontend apps
+~~~~~~~~~~~~~
+
+* `Assistant <https://apps.nextcloud.com/apps/assistant>`_ for offering a graphical UI for the context chat search tasks
+
+Backend apps
+~~~~~~~~~~~~
+
+* `Nextcloud Office <https://apps.nextcloud.com/apps/richdocuments>`_
+
 
 .. _ai-overview_improve-ai-task-pickup-speed:
 

admin_manual/configuration_files/encryption_configuration.rst

@@ -131,6 +131,19 @@ Encryption settings can be configured in the mount options for an external
 storage mount, see :ref:`external_storage_mount_options_label`
 (:doc:`external_storage_configuration_gui`)
 
+
+Encrypting team folders
+-----------------------
+
+By default team folder are not encrypted. If you want to encrypt your team folders
+as well you need to run following occ command:
+
+ occ config:app:set groupfolders enable_encryption --value=true
+
+Like for all other files and server-side-encryption in general, this will not encrypt
+already existing files in team folders but only new or updated files after
+the occ command was executed.
+
 .. _occ_encryption_label:
 
 occ encryption commands

admin_manual/configuration_files/encryption_details.rst

@@ -1,6 +1,6 @@
-==================
-Encryption details
-==================
+==============================
+Server-side encryption details
+==============================
 
 This document - provided by `SysEleven <https://syseleven.de>`_ - describes the server-side encryption scheme implemented by Nextcloud's default encryption module. This includes: