nextcloud-agent 2.4.2__tar.gz → 3.1.0__tar.gz

{nextcloud_agent-2.4.2 → nextcloud_agent-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 2.4.2
+Version: 3.1.0
 Summary: Nextcloud MCP Server for Agentic AI!
 Author-email: Repository Maintainers <maintainers@knuckles.team>
 License: MIT
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: scion-sdk[mcp]<0.9,>=0.8.0
+Requires-Dist: scion-sdk[mcp]<0.12,>=0.11.0
 Requires-Dist: requests>=2.34.2
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: python-dateutil>=2.9.0.post0
@@ -82,58 +82,151 @@ This server use dynamic Action-Routed tools to optimize token overhead and maxim
 
 ### Available MCP Tools
 
-<!-- This table is auto-generated by `python -m scion_sdk.mcp.readme_tools` — do not edit by hand. -->
 
 <!-- MCP-TOOLS-TABLE:START -->
 
-#### Condensed action-routed tools (`MCP_TOOL_MODE=condensed`)
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_calendar` | `CALENDARTOOL` | Manage nextcloud calendar operations. |
-| `nextcloud_contacts` | `CONTACTSTOOL` | Manage nextcloud contacts operations. |
-| `nextcloud_files` | `FILESTOOL` | Manage nextcloud files operations. |
-| `nextcloud_ingest_file` | `INGESTTOOL` | Fetch a Nextcloud file over WebDAV and natively store it in the knowledge |
-| `nextcloud_sharing` | `SHARINGTOOL` | Manage nextcloud sharing operations. |
-| `nextcloud_user` | `USERTOOL` | Manage nextcloud user operations. |
-
-#### Verbose 1:1 API-mapped tools (`MCP_TOOL_MODE=verbose` or `both`)
-
-<details>
-<summary>26 per-operation tools — one per public API method (click to expand)</summary>
-
-| MCP Tool | Toggle Env Var | Description |
-|----------|----------------|-------------|
-| `nextcloud_copy_item` | `APITOOL` | Alias for copy_resource to support MCP server action. |
-| `nextcloud_copy_resource` | `APITOOL` | Copy a file or directory. |
-| `nextcloud_create_calendar_event` | `APITOOL` | Alias for create_event to support MCP server action. |
-| `nextcloud_create_contact` | `APITOOL` | Invoke the create_contact operation. |
-| `nextcloud_create_directory` | `APITOOL` | Create a directory (MKCOL). |
-| `nextcloud_create_event` | `APITOOL` | Create an event with ICS data. |
-| `nextcloud_create_folder` | `APITOOL` | Alias for create_directory to support MCP server action. |
-| `nextcloud_create_share` | `APITOOL` | Create a share. |
-| `nextcloud_delete_item` | `APITOOL` | Alias for delete_resource to support MCP server action. |
-| `nextcloud_delete_resource` | `APITOOL` | Delete a file or directory. |
-| `nextcloud_delete_share` | `APITOOL` | Delete a share. |
-| `nextcloud_get_properties` | `APITOOL` | Helper to get properties of a path by listing its contents. |
-| `nextcloud_get_user_info` | `APITOOL` | Get current user info. |
-| `nextcloud_get_user_quota` | `APITOOL` | Get storage quota information. |
-| `nextcloud_list_address_books` | `APITOOL` | List address books. |
-| `nextcloud_list_calendar_events` | `APITOOL` | Alias for list_events to support MCP server action. |
-| `nextcloud_list_calendars` | `APITOOL` | List available calendars. |
-| `nextcloud_list_contacts` | `APITOOL` | List contacts in address book. |
-| `nextcloud_list_contents` | `APITOOL` | List files and folders in a directory using PROPFIND. |
-| `nextcloud_list_events` | `APITOOL` | List events in a calendar (returns basic info). |
-| `nextcloud_list_files` | `APITOOL` | Alias for list_contents to support MCP server action. |
-| `nextcloud_list_shares` | `APITOOL` | List all shares. |
-| `nextcloud_move_item` | `APITOOL` | Alias for move_resource to support MCP server action. |
-| `nextcloud_move_resource` | `APITOOL` | Move a file or directory. |
-| `nextcloud_read_file` | `APITOOL` | Download a file. |
-| `nextcloud_write_file` | `APITOOL` | Upload a file. |
-
-</details>
-
-_6 action-routed tool(s) · 26 verbose 1:1 tool(s). Each is enabled unless its `<DOMAIN>TOOL` toggle is set false; `MCP_TOOL_MODE` selects the surface (**`intent` default** — the six verb-tools, granular set loaded on demand · `condensed` action-routed · `verbose` 1:1 · `both`). Auto-generated — do not edit._
+One typed tool per operation (89 tools), grouped by domain. Each domain is enabled unless its toggle is set false. Destructive tools ask for confirmation.
+
+**activity** (toggle `ACTIVITYTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_dismiss_notification` | Dismiss one notification. |
+| `nextcloud_list_activities` | Read the activity stream, newest first; narrow to one object (``object_type="files"`` with a file id) when given. |
+| `nextcloud_list_notifications` | List the account's current notifications. |
+
+**admin** (toggle `ADMINTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_user_to_group` | Add one account to a group. |
+| `nextcloud_create_group` | Create one group. |
+| `nextcloud_create_user` | Create one account. Give a password, or an email for a set-password invite. |
+| `nextcloud_delete_group` | Delete one group (its members keep their accounts). |
+| `nextcloud_delete_user` | Delete one account and its files. |
+| `nextcloud_disable_app` | Disable one app. |
+| `nextcloud_disable_user` | Disable one account (it can no longer log in; data is kept). |
+| `nextcloud_enable_app` | Enable one installed app. |
+| `nextcloud_enable_user` | Enable one disabled account. |
+| `nextcloud_get_app` | Read one installed app's metadata (name, version, dependencies). |
+| `nextcloud_get_user` | Read one account's details. |
+| `nextcloud_get_user_info` | Read the connected account: id, display name, email, quota, groups. |
+| `nextcloud_list_apps` | List installed app ids that are enabled, disabled, or all of them. |
+| `nextcloud_list_group_members` | List the account ids in one group. |
+| `nextcloud_list_groups` | List group ids, optionally matching a search string. |
+| `nextcloud_list_users` | List account ids, optionally matching a search string. |
+| `nextcloud_remove_user_from_group` | Remove one account from a group. |
+| `nextcloud_update_user` | Change one field of an account. |
+
+**calendar** (toggle `CALENDARTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_calendar` | Create one calendar that holds events and, by default, tasks. |
+| `nextcloud_create_event` | Create one event. Attendees get a draft invitation unless ``send_invitations``. |
+| `nextcloud_create_task` | Create one task (VTODO) in a task-capable calendar (the Tasks app shows it). |
+| `nextcloud_delete_calendar` | Delete one calendar and everything in it (it moves to the calendar trash). |
+| `nextcloud_delete_calendar_object` | Delete one event or task. |
+| `nextcloud_get_calendar_object` | Read one event or task: its parsed fields, etag and raw iCalendar text. |
+| `nextcloud_list_calendars` | List the account's calendars and the components (VEVENT, VTODO) each holds. |
+| `nextcloud_list_events` | List the events of one calendar, optionally within an ISO time range. |
+| `nextcloud_list_tasks` | List the tasks (VTODO) of one task-capable calendar. |
+| `nextcloud_update_event` | Change one event's fields; the write is guarded by the event's etag. |
+| `nextcloud_update_task` | Change one task, or mark it complete or open again; guarded by its etag. |
+
+**contacts** (toggle `CONTACTSTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_contact` | Create one contact in an address book. |
+| `nextcloud_delete_contact` | Delete one contact. |
+| `nextcloud_get_contact` | Read one contact: parsed fields, etag and the raw vCard. |
+| `nextcloud_list_address_books` | List the account's address books. |
+| `nextcloud_list_contacts` | List the contacts of one address book with name, emails, phones and organization. |
+| `nextcloud_update_contact` | Change one contact; omitted fields keep their value. Guarded by the etag. |
+
+**deck** (toggle `DECKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_assign_card_user` | Assign one user to a card. |
+| `nextcloud_create_board` | Create one board; ``color`` is a hex RGB value without ``#``. |
+| `nextcloud_create_card` | Create one card in a stack; ``duedate`` is ISO 8601. |
+| `nextcloud_create_stack` | Create one stack (column) on a board. |
+| `nextcloud_delete_board` | Delete one board (Deck keeps it restorable for a while). |
+| `nextcloud_delete_card` | Delete one card. |
+| `nextcloud_delete_stack` | Delete one stack and its cards. |
+| `nextcloud_get_board` | Read one board with its labels and members. |
+| `nextcloud_get_card` | Read one card. |
+| `nextcloud_list_boards` | List the Deck boards the account can see. |
+| `nextcloud_list_stacks` | List the stacks (columns) of one board, each with its cards. |
+| `nextcloud_move_card` | Move one card to a stack (column) of the board, at position ``order``. |
+| `nextcloud_update_card` | Change one card's title, description or due date. |
+
+**files** (toggle `FILESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_copy_item` | Copy one file or folder. |
+| `nextcloud_create_folder` | Create one folder. |
+| `nextcloud_delete_item` | Delete one file or folder (it moves to the trash bin). |
+| `nextcloud_get_properties` | Read the properties of one file or folder (size, type, etag, file id). |
+| `nextcloud_get_user_quota` | Read the storage quota of the connected account. |
+| `nextcloud_list_files` | List the files and folders in one folder (PROPFIND, depth 1). |
+| `nextcloud_list_trash` | List the items in the trash bin of the connected account. |
+| `nextcloud_list_versions` | List the stored versions of one file, newest first. |
+| `nextcloud_move_item` | Move or rename one file or folder. |
+| `nextcloud_read_file` | Download one file; the bytes come back base64-encoded. |
+| `nextcloud_restore_trash_item` | Restore one trash-bin item to its original location. |
+| `nextcloud_restore_version` | Restore one stored version of a file; the current content becomes a version. |
+| `nextcloud_search_files` | Search files by name (case-insensitive substring) under one folder. |
+| `nextcloud_write_file` | Upload one file, creating missing parent folders. |
+
+**notes** (toggle `NOTESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_note` | Create one note. |
+| `nextcloud_delete_note` | Delete one note. |
+| `nextcloud_get_note` | Read one note with its content. |
+| `nextcloud_list_notes` | List the account's notes, optionally of one category. |
+| `nextcloud_update_note` | Change one note's title, content, category or favorite flag. |
+
+**office** (toggle `OFFICETOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_document` | Create one new document at ``path``; the extension picks the type (``.docx``, ``.xlsx``, ``.pptx``, ``.odg``, ``.md``). |
+| `nextcloud_list_document_templates` | List the document types the server can create (document, spreadsheet, presentation, diagram, markdown) with their extensions and templates. |
+| `nextcloud_open_document` | Open one document for editing and return a one-time editor ``url`` for the connected account (Office for office files, Text for markdown). |
+
+**shares** (toggle `SHARESTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_create_share` | Share one file or folder and return the share (a public link carries its ``url``). |
+| `nextcloud_delete_share` | Revoke one share. |
+| `nextcloud_get_share` | Read one share by id. |
+| `nextcloud_list_shares` | List shares: all of the account's shares, the shares on one path, or the shares other people gave the account. |
+| `nextcloud_update_share` | Change one share's permissions, password, expiry, label or note. |
+
+**talk** (toggle `TALKTOOL`)
+
+| MCP Tool | Description |
+|----------|-------------|
+| `nextcloud_add_participant` | Add a user, group, email guest or team to one conversation. |
+| `nextcloud_create_conversation` | Create one conversation and return it with its ``token``. |
+| `nextcloud_delete_conversation` | Delete one conversation for everyone (moderators only). |
+| `nextcloud_delete_message` | Delete one chat message. |
+| `nextcloud_get_conversation` | Read one conversation by its token. |
+| `nextcloud_list_conversations` | List the conversations the account takes part in. |
+| `nextcloud_list_messages` | Read the chat history of one conversation, newest first. |
+| `nextcloud_list_participants` | List the participants of one conversation. |
+| `nextcloud_remove_participant` | Remove one attendee (by attendee id from list_participants) from a conversation. |
+| `nextcloud_rename_conversation` | Rename one conversation. |
+| `nextcloud_send_message` | Post one chat message to a conversation. |
+
+
 <!-- MCP-TOOLS-TABLE:END -->
 
 Detailed tool schemas, parameter shapes, and validation constraints are preserved in [docs/usage.md](docs/usage.md).
@@ -164,8 +257,8 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
 <!-- MCP-CONFIG-EXAMPLES:START -->
 
 > **Install the connector-focused `[mcp]` extra.** Examples use `nextcloud-agent[mcp]` to add
-> FastMCP / FastAPI through `scion-sdk[mcp]`; the required Agent Utilities core
-> still carries `epistemic-graph[full]`. The `[agent-runtime]` extra additionally
+> FastMCP / FastAPI through `scion-sdk[mcp]`; the required Meristem core
+> still carries `medulla[full]`. The `[agent-runtime]` extra additionally
 > enables model orchestration.
 
 #### stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)
@@ -187,8 +280,8 @@ When query strings or parameters are supplied, an LLM-free **Knowledge Graph res
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -225,8 +318,8 @@ own runtime secret boundary.
         "NEXTCLOUD_PASSWORD": "your_password",
         "NEXTCLOUD_URL": "https://nextcloud.example.com",
         "NEXTCLOUD_USERNAME": "your_username",
-        "SHARINGTOOL": "True",
-        "USERTOOL": "True"
+        "SHARESTOOL": "True",
+        "ADMINTOOL": "True"
       }
     }
   }
@@ -264,8 +357,8 @@ docker run -i --rm \
   -e NEXTCLOUD_PASSWORD=your_password \
   -e NEXTCLOUD_URL=https://nextcloud.example.com \
   -e NEXTCLOUD_USERNAME=your_username \
-  -e SHARINGTOOL=True \
-  -e USERTOOL=True \
+  -e SHARESTOOL=True \
+  -e ADMINTOOL=True \
   registry.example.invalid/nextcloud-agent@sha256:<digest> nextcloud-mcp
 ```
 
@@ -426,8 +519,8 @@ Built directly upon the enterprise-ready [`scion-sdk`](https://github.com/Knuckl
 | `TLS_PROFILE_REF` | `secret://transport/provider` | Direct runtime profile reference |
 | `TLS_PROFILES_REF` | `secret://transport/catalog` | Named runtime profile catalog |
 | `FILESTOOL` | `True` |  |
-| `USERTOOL` | `True` |  |
-| `SHARINGTOOL` | `True` |  |
+| `ADMINTOOL` | `True` |  |
+| `SHARESTOOL` | `True` |  |
 | `CALENDARTOOL` | `True` |  |
 | `CONTACTSTOOL` | `True` |  |
 
@@ -473,8 +566,8 @@ for a copy-paste starting point.
 | `MCP_ENABLED_TAGS` / `MCP_DISABLED_TAGS` | Comma-separated tag allow/deny list | — |
 
 ### Tool toggles
-Each action-routed tool can be disabled individually via its toggle env var (set to `false`):
-`FILESTOOL`, `USERTOOL`, `SHARINGTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`. See the
+Each tool domain can be disabled via its toggle env var (set to `false`):
+`FILESTOOL`, `SHARESTOOL`, `CALENDARTOOL`, `CONTACTSTOOL`, `TALKTOOL`, `DECKTOOL`, `NOTESTOOL`, `OFFICETOOL`, `ACTIVITYTOOL`, `ADMINTOOL`. See the
 [Available MCP Tools](#available-mcp-tools) table above.
 
 ### Telemetry & governance
@@ -496,8 +589,8 @@ Pick the extra that matches what the operator want to run:
 
 | Extra | Installs | Use when |
 |-------|----------|----------|
-| `nextcloud-agent[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `epistemic-graph[full]`) | The operator only run the **MCP server** (smallest install / image) |
-| `nextcloud-agent[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `epistemic-graph[full]`) | The operator run the **integrated agent** |
+| `nextcloud-agent[mcp]` | Connector-focused MCP server (`scion-sdk[mcp]` — FastMCP/FastAPI + `medulla[full]`) | The operator only run the **MCP server** (smallest install / image) |
+| `nextcloud-agent[agent]` | Agent runtime (`scion-sdk[agent-runtime,logfire]` — model orchestration + `medulla[full]`) | The operator run the **integrated agent** |
 | `nextcloud-agent[all]` | Everything (`mcp` + `agent` + `logfire`) | Development / both surfaces |
 
 ```bash
@@ -517,8 +610,8 @@ One multi-stage `docker/Dockerfile` builds two right-sized images, selected by `
 
 | Image tag | Build target | Contents | Entrypoint |
 |-----------|--------------|----------|------------|
-| `knucklessg1/nextcloud-agent:mcp` | `--target mcp` | `nextcloud-agent[mcp]` — **connector-focused**, includes `epistemic-graph[full]`; no model-orchestration stack | `nextcloud-mcp` |
-| `knucklessg1/nextcloud-agent:2.3.3` | `--target agent` (default) | `nextcloud-agent[agent]` — **agent runtime**, model orchestration + `epistemic-graph[full]` | `nextcloud-agent` |
+| `knucklessg1/nextcloud-agent:mcp` | `--target mcp` | `nextcloud-agent[mcp]` — **connector-focused**, includes `medulla[full]`; no model-orchestration stack | `nextcloud-mcp` |
+| `knucklessg1/nextcloud-agent:2.3.3` | `--target agent` (default) | `nextcloud-agent[agent]` — **agent runtime**, model orchestration + `medulla[full]` | `nextcloud-agent` |
 
 ```bash
 docker build --target mcp   -t knucklessg1/nextcloud-agent:mcp    docker/   # connector-focused MCP server
@@ -528,16 +621,16 @@ docker build --target agent -t knucklessg1/nextcloud-agent:2.3.3 docker/   # age
 `docker/mcp.compose.yml` runs the connector-focused `:mcp` server; `docker/agent.compose.yml` runs the
 agent (`:2.3.3`) with a co-located `:mcp` sidecar.
 
-### Knowledge-graph database (`epistemic-graph`)
+### Knowledge-graph database (`medulla`)
 
-Both `[mcp]` and `[agent]` carry the **epistemic-graph** engine through the required
-Agent Utilities core dependency (`epistemic-graph[full]`). The `[mcp]` extra keeps
+Both `[mcp]` and `[agent]` carry the **medulla** engine through the required
+Meristem core dependency (`medulla[full]`). The `[mcp]` extra keeps
 the server connector-focused; `[agent]` also enables model orchestration. Local
 deployments can use the bundled engine. For production — or to share one knowledge graph
-across multiple agents — run **epistemic-graph as its own database container** and point the
+across multiple agents — run **medulla as its own database container** and point the
 agent at it instead of embedding it. Deployment recipes (single-node + Raft HA), connection
 config, and the full database architecture (with diagrams) are documented in the
-[epistemic-graph deployment guide](https://knuckles-team.github.io/epistemic-graph/deployment/).
+[medulla deployment guide](https://knuckles-team.github.io/medulla/deployment/).
 
 ---
 
@@ -553,7 +646,7 @@ the recommended reference for installation, deployment, and day-to-day operation
 | [Deployment](https://knuckles-team.github.io/nextcloud-agent/deployment/) | run the MCP server and the agent, Compose, Caddy + Technitium, env config |
 | [Usage](https://knuckles-team.github.io/nextcloud-agent/usage/) | the MCP tools, the `NextcloudAPI` client, the agent CLI |
 | [Backing Platform](https://knuckles-team.github.io/nextcloud-agent/platform/) | deploy Nextcloud with Docker |
-| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the action-routed tool surface and ecosystem role |
+| [Overview](https://knuckles-team.github.io/nextcloud-agent/overview/) | the per-operation tool surface and ecosystem role |
 | [Concepts](https://knuckles-team.github.io/nextcloud-agent/concepts/) | concept registry (`CONCEPT:NC-*`) |
 
 ---