nextcloud-agent 0.2.24__tar.gz → 0.2.26__tar.gz

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 0.2.24
+Version: 0.2.26
 Summary: Nextcloud MCP Server for Agentic AI!
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.10
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.12
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: icalendar>=6.1.1
 Requires-Dist: vobject>=0.9.9
@@ -41,7 +41,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/nextcloud-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/nextcloud-agent)
 
-*Version: 0.2.24*
+*Version: 0.2.26*
 
 ## Overview
 

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/README.md

@@ -21,7 +21,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/nextcloud-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/nextcloud-agent)
 
-*Version: 0.2.24*
+*Version: 0.2.26*
 
 ## Overview
 

nextcloud_agent-0.2.26/nextcloud_agent/agent/IDENTITY.md

@@ -0,0 +1,16 @@
+# IDENTITY.md - Nextcloud Agent Identity
+
+## [default]
+ * **Name:** Nextcloud Agent
+ * **Role:** Nextcloud services including files, sharing, calendar, contacts, and user management.
+ * **Emoji:** ☁️
+
+ ### System Prompt
+ You are the Nextcloud Agent.
+ You must always first run list_skills and list_tools to discover available skills and tools.
+ Your goal is to assist the user with Nextcloud operations using the `mcp-client` universal skill.
+ Check the `mcp-client` reference documentation for `nextcloud-agent.md` to discover the exact tags and tools available for your capabilities.
+
+ ### Capabilities
+ - **MCP Operations**: Leverage the `mcp-client` skill to interact with the target MCP server. Refer to `nextcloud-agent.md` for specific tool capabilities.
+ - **Custom Agent**: Handle custom tasks or general tasks.

nextcloud_agent-0.2.26/nextcloud_agent/agent.py

@@ -0,0 +1,72 @@
+#!/usr/bin/python
+# coding: utf-8
+import os
+import logging
+
+from agent_utilities import (
+    build_system_prompt_from_workspace,
+    create_agent_parser,
+    create_agent_server,
+    initialize_workspace,
+    load_identity,
+)
+
+__version__ = "0.2.26"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    handlers=[logging.StreamHandler()],
+)
+logger = logging.getLogger(__name__)
+
+# Load identity and system prompt from workspace
+initialize_workspace()
+meta = load_identity()
+DEFAULT_AGENT_NAME = os.getenv(
+    "DEFAULT_AGENT_NAME", meta.get("name", "Nextcloud Agent")
+)
+DEFAULT_AGENT_DESCRIPTION = os.getenv(
+    "AGENT_DESCRIPTION",
+    meta.get("description", "AI agent for Nextcloud Agent management."),
+)
+DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
+    "AGENT_SYSTEM_PROMPT",
+    meta.get("content") or build_system_prompt_from_workspace(),
+)
+
+
+def agent_server():
+    print(f"{DEFAULT_AGENT_NAME} v{__version__}")
+    parser = create_agent_parser()
+
+    args = parser.parse_args()
+
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+        logger.debug("Debug mode enabled")
+
+    create_agent_server(
+        provider=args.provider,
+        model_id=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        custom_skills_directory=args.custom_skills_directory,
+        debug=args.debug,
+        host=args.host,
+        port=args.port,
+        enable_web_ui=args.web,
+        ssl_verify=not args.insecure,
+        name=DEFAULT_AGENT_NAME,
+        system_prompt=DEFAULT_AGENT_SYSTEM_PROMPT,
+        enable_otel=args.otel,
+        otel_endpoint=args.otel_endpoint,
+        otel_headers=args.otel_headers,
+        otel_public_key=args.otel_public_key,
+        otel_secret_key=args.otel_secret_key,
+        otel_protocol=args.otel_protocol,
+    )
+
+
+if __name__ == "__main__":
+    agent_server()

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/nextcloud_agent/mcp.py

@@ -1,6 +1,8 @@
 #!/usr/bin/python
 # coding: utf-8
 
+from dotenv import load_dotenv, find_dotenv
+from agent_utilities.base_utilities import to_boolean
 import os
 import sys
 import logging
@@ -31,7 +33,7 @@ from agent_utilities.middlewares import (
 )
 from nextcloud_agent.auth import get_client
 
-__version__ = "0.2.24"
+__version__ = "0.2.26"
 print(f"Nextcloud MCP v{__version__}")
 
 logger = get_logger(name="TokenMiddleware")
@@ -40,6 +42,7 @@ logger.setLevel(logging.DEBUG)
 
 def register_prompts(mcp: FastMCP):
     @mcp.prompt(name="list_files", description="List files in a directory.")
+    @mcp.tool(tags={"files"})
     def list_files(path: str = "/") -> str:
         """List files."""
         return f"Please list files in '{path}'"
@@ -55,11 +58,12 @@ def register_prompts(mcp: FastMCP):
         return "Please show recently modified files."
 
 
-def register_tools(mcp: FastMCP):
-    @mcp.custom_route("/health", methods=["GET"])
+def register_misc_tools(mcp: FastMCP):
     async def health_check() -> Dict:
         return {"status": "OK"}
 
+
+def register_files_tools(mcp: FastMCP):
     @mcp.tool(tags={"files"})
     async def list_files(
         path: str = Field(
@@ -249,6 +253,8 @@ def register_tools(mcp: FastMCP):
         except Exception as e:
             return f"Error getting properties: {str(e)}"
 
+
+def register_user_tools(mcp: FastMCP):
     @mcp.tool(tags={"user"})
     async def get_user_info(
         base_url: str = Field(
@@ -264,6 +270,8 @@ def register_tools(mcp: FastMCP):
         except Exception as e:
             return f"Error getting user info: {str(e)}"
 
+
+def register_sharing_tools(mcp: FastMCP):
     @mcp.tool(tags={"sharing"})
     async def list_shares(
         base_url: str = Field(
@@ -318,6 +326,8 @@ def register_tools(mcp: FastMCP):
         except Exception as e:
             return f"Error deleting share: {str(e)}"
 
+
+def register_calendar_tools(mcp: FastMCP):
     @mcp.tool(tags={"calendar"})
     async def list_calendars(
         base_url: str = Field(
@@ -390,6 +400,8 @@ def register_tools(mcp: FastMCP):
         except Exception as e:
             return f"Error creating event: {str(e)}"
 
+
+def register_contacts_tools(mcp: FastMCP):
     @mcp.tool(tags={"contacts"})
     async def list_address_books(
         base_url: str = Field(
@@ -448,6 +460,7 @@ def mcp_server() -> None:
     This function parses command-line arguments to configure and start the MCP server for Nextcloud API interactions.
     It supports stdio or TCP transport modes and exits on invalid arguments or help requests.
     """
+    load_dotenv(find_dotenv())
     parser = create_mcp_parser()
 
     args = parser.parse_args()
@@ -750,7 +763,24 @@ def mcp_server() -> None:
             sys.exit(1)
 
     mcp = FastMCP("Nextcloud", auth=auth)
-    register_tools(mcp)
+    DEFAULT_MISCTOOL = to_boolean(os.getenv("MISCTOOL", "True"))
+    if DEFAULT_MISCTOOL:
+        register_misc_tools(mcp)
+    DEFAULT_FILESTOOL = to_boolean(os.getenv("FILESTOOL", "True"))
+    if DEFAULT_FILESTOOL:
+        register_files_tools(mcp)
+    DEFAULT_USERTOOL = to_boolean(os.getenv("USERTOOL", "True"))
+    if DEFAULT_USERTOOL:
+        register_user_tools(mcp)
+    DEFAULT_SHARINGTOOL = to_boolean(os.getenv("SHARINGTOOL", "True"))
+    if DEFAULT_SHARINGTOOL:
+        register_sharing_tools(mcp)
+    DEFAULT_CALENDARTOOL = to_boolean(os.getenv("CALENDARTOOL", "True"))
+    if DEFAULT_CALENDARTOOL:
+        register_calendar_tools(mcp)
+    DEFAULT_CONTACTSTOOL = to_boolean(os.getenv("CONTACTSTOOL", "True"))
+    if DEFAULT_CONTACTSTOOL:
+        register_contacts_tools(mcp)
     register_prompts(mcp)
 
     for mw in middlewares:

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/nextcloud_agent.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 0.2.24
+Version: 0.2.26
 Summary: Nextcloud MCP Server for Agentic AI!
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -12,7 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.10
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.12
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: icalendar>=6.1.1
 Requires-Dist: vobject>=0.9.9
@@ -41,7 +41,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/nextcloud-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/nextcloud-agent)
 
-*Version: 0.2.24*
+*Version: 0.2.26*
 
 ## Overview
 

nextcloud_agent-0.2.26/nextcloud_agent.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE
+README.md
+pyproject.toml
+nextcloud_agent/__init__.py
+nextcloud_agent/agent.py
+nextcloud_agent/auth.py
+nextcloud_agent/mcp.py
+nextcloud_agent/nextcloud_api.py
+nextcloud_agent.egg-info/PKG-INFO
+nextcloud_agent.egg-info/SOURCES.txt
+nextcloud_agent.egg-info/dependency_links.txt
+nextcloud_agent.egg-info/entry_points.txt
+nextcloud_agent.egg-info/requires.txt
+nextcloud_agent.egg-info/top_level.txt
+nextcloud_agent/agent/AGENTS.md
+nextcloud_agent/agent/CRON.md
+nextcloud_agent/agent/HEARTBEAT.md
+nextcloud_agent/agent/IDENTITY.md
+nextcloud_agent/agent/MEMORY.md
+nextcloud_agent/agent/USER.md
+nextcloud_agent/agent/templates.py
+scripts/validate_a2a_agent.py

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/nextcloud_agent.egg-info/requires.txt

@@ -1,4 +1,4 @@
-agent-utilities[agent,logfire]>=0.2.10
+agent-utilities[agent,logfire]>=0.2.12
 python-dateutil>=2.8.2
 icalendar>=6.1.1
 vobject>=0.9.9

{nextcloud_agent-0.2.24 → nextcloud_agent-0.2.26}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nextcloud-agent"
-version = "0.2.24"
+version = "0.2.26"
 description = "Nextcloud MCP Server for Agentic AI!"
 readme = "README.md"
 authors = [{ name = "Audel Rouhi", email = "knucklessg1@gmail.com" }]
@@ -14,15 +14,13 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Environment :: Console",
     "Operating System :: POSIX :: Linux",
-    "Programming Language :: Python :: 3",
-]
+    "Programming Language :: Python :: 3"]
 requires-python = ">=3.10"
 dependencies = [
-    "agent-utilities[agent,logfire]>=0.2.10",
+    "agent-utilities[agent,logfire]>=0.2.12",
     "python-dateutil>=2.8.2",
     "icalendar>=6.1.1",
-    "vobject>=0.9.9",
-]
+    "vobject>=0.9.9"]
 
 [project.scripts]
 nextcloud-mcp = "nextcloud_agent.mcp:mcp_server"
@@ -35,4 +33,4 @@ where = ["."]
 include-package-data = true
 
 [tool.setuptools.package-data]
-nextcloud_agent = [ "mcp_config.json", "skills/**", "agent/**",]
+nextcloud_agent = [ "mcp_config.json", "agent/**"]

nextcloud_agent-0.2.24/nextcloud_agent/agent/IDENTITY.md

@@ -1,52 +0,0 @@
-# IDENTITY.md - Nextcloud Multi-Agent Identity
-
-## [supervisor]
- * **Name:** Nextcloud Supervisor
- * **Role:** Coordination of tasks across Nextcloud services.
- * **Emoji:** ☁️
- * **Vibe:** Helpful, organized, secure
-
- ### System Prompt
- You are the Nextcloud Supervisor Agent.
- Your goal is to assist the user with Nextcloud operations including file management, sharing, and personal information management.
- Delegate tasks to specialized agents and synthesize the output.
-
-## [files]
- * **Name:** Nextcloud Files Agent
- * **Role:** Manage files and directories.
- * **Emoji:** 📁
- ### System Prompt
- You are the Nextcloud Files Agent.
- You handle file uploads, downloads, listing, and direct file system operations via WebDAV.
-
-## [sharing]
- * **Name:** Nextcloud Sharing Agent
- * **Role:** Manage file shares and permissions.
- * **Emoji:** 🔗
- ### System Prompt
- You are the Nextcloud Sharing Agent.
- You handle the creation and management of public and internal file shares.
-
-## [calendar]
- * **Name:** Nextcloud Calendar Agent
- * **Role:** Manage Nextcloud calendars and events.
- * **Emoji:** 📅
- ### System Prompt
- You are the Nextcloud Calendar Agent.
- You handle calendar event creation, retrieval, and scheduling.
-
-## [contacts]
- * **Name:** Nextcloud Contacts Agent
- * **Role:** Manage Nextcloud address books.
- * **Emoji:** 📇
- ### System Prompt
- You are the Nextcloud Contacts Agent.
- You handle contact creation, search, and address book management.
-
-## [users]
- * **Name:** Nextcloud Users Agent
- * **Role:** Manage Nextcloud user profiles.
- * **Emoji:** 👤
- ### System Prompt
- You are the Nextcloud Users Agent.
- You handle user profile information and settings retrieval.

nextcloud_agent-0.2.24/nextcloud_agent/agent/skills/test-skill/SKILL.md

@@ -1,19 +0,0 @@
----
-name: test-skill
-description: A test skill.
-version: 0.1.0
-tags: [test-skill]
-input_modes: [text]
-output_modes: [text]
----
-
-# test-skill Skill
-
-## When to use
-For testing.
-
-## How to use
-Call it.
-
-## Examples
-- Example 1: ...

nextcloud_agent-0.2.24/nextcloud_agent/agent.py

@@ -1,95 +0,0 @@
-#!/usr/bin/python
-# coding: utf-8
-import os
-import logging
-
-from agent_utilities import (
-    create_agent_server,
-    initialize_workspace,
-    load_identities,
-    build_system_prompt_from_workspace,
-)
-from agent_utilities.agent_utilities import create_agent_parser, get_mcp_config_path
-from agent_utilities.base_utilities import to_integer, to_boolean
-
-__version__ = "0.2.24"
-
-logging.basicConfig(
-    level=logging.INFO,
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-    handlers=[logging.StreamHandler()],
-)
-logger = logging.getLogger(__name__)
-
-# Load identity and system prompt from workspace
-initialize_workspace()
-identities = load_identities()
-
-# Prepare supervisor identity
-supervisor_meta = identities.get("supervisor", identities.get("default", {}))
-DEFAULT_AGENT_NAME = os.getenv(
-    "DEFAULT_AGENT_NAME", supervisor_meta.get("name", "Nextcloud Agent")
-)
-DEFAULT_AGENT_DESCRIPTION = os.getenv(
-    "AGENT_DESCRIPTION",
-    supervisor_meta.get("description", "A multi-agent system."),
-)
-DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
-    "AGENT_SYSTEM_PROMPT",
-    supervisor_meta.get("content") or build_system_prompt_from_workspace(),
-)
-
-# Prepare child agent definitions from IDENTITY.md sections
-CHILD_AGENT_DEFS = {
-    tag: (data["content"], data["name"])
-    for tag, data in identities.items()
-    if tag not in ["supervisor", "default"]
-}
-
-DEFAULT_HOST = os.getenv("HOST", "0.0.0.0")
-DEFAULT_PORT = to_integer(os.getenv("PORT", "9000"))
-DEFAULT_DEBUG = to_boolean(os.getenv("DEBUG", "False"))
-DEFAULT_PROVIDER = os.getenv("PROVIDER", "openai")
-DEFAULT_MODEL_ID = os.getenv("MODEL_ID", "qwen/qwen3-coder-next")
-DEFAULT_LLM_BASE_URL = os.getenv("LLM_BASE_URL", "http://host.docker.internal:1234/v1")
-DEFAULT_LLM_API_KEY = os.getenv("LLM_API_KEY", "ollama")
-DEFAULT_MCP_URL = os.getenv("MCP_URL", None)
-DEFAULT_MCP_CONFIG = os.getenv("MCP_CONFIG", get_mcp_config_path())
-DEFAULT_CUSTOM_SKILLS_DIRECTORY = os.getenv("CUSTOM_SKILLS_DIRECTORY", None)
-DEFAULT_ENABLE_WEB_UI = to_boolean(os.getenv("ENABLE_WEB_UI", "False"))
-DEFAULT_ENABLE_OTEL = to_boolean(os.getenv("ENABLE_OTEL", "False"))
-DEFAULT_SSL_VERIFY = to_boolean(os.getenv("SSL_VERIFY", "True"))
-
-
-def agent_server():
-    print(f"{DEFAULT_AGENT_NAME} v{__version__}")
-    parser = create_agent_parser()
-
-    args = parser.parse_args()
-
-    if args.debug:
-        logging.getLogger().setLevel(logging.DEBUG)
-        logger.debug("Debug mode enabled")
-
-    create_agent_server(
-        provider=args.provider,
-        model_id=args.model_id,
-        base_url=args.base_url,
-        api_key=args.api_key,
-        mcp_url=args.mcp_url,
-        mcp_config=args.mcp_config,
-        custom_skills_directory=args.custom_skills_directory,
-        debug=args.debug,
-        host=args.host,
-        port=args.port,
-        enable_web_ui=args.web,
-        ssl_verify=not args.insecure,
-        name=DEFAULT_AGENT_NAME,
-        system_prompt=DEFAULT_AGENT_SYSTEM_PROMPT,
-        enable_otel=args.otel,
-        agent_definitions=CHILD_AGENT_DEFS if CHILD_AGENT_DEFS else None,
-    )
-
-
-if __name__ == "__main__":
-    agent_server()

nextcloud_agent-0.2.24/nextcloud_agent/skills/nextcloud-calendar/SKILL.md

@@ -1,39 +0,0 @@
----
-name: nextcloud-calendar
-description: "Generated skill for calendar operations. Contains 3 tools."
-tags: [calendar]
----
-
-### Overview
-This skill handles operations related to calendar.
-
-### Available Tools
-- `list_calendars`: List available calendars.
-  - **Parameters**:
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-- `list_calendar_events`: List events in a calendar.
-  - **Parameters**:
-    - `calendar_url` (str)
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-- `create_calendar_event`: No description provided.
-  - **Parameters**:
-    - `calendar_url` (str)
-    - `summary` (str)
-    - `start_time` (str)
-    - `end_time` (str)
-    - `description` (str)
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-
-### Usage Instructions
-1. Review the tool available in this skill.
-2. Call the tool with the required parameters.
-
-### Error Handling
-- Ensure all required parameters are provided.
-- Check return values for error messages.

nextcloud_agent-0.2.24/nextcloud_agent/skills/nextcloud-contacts/SKILL.md

@@ -1,36 +0,0 @@
----
-name: nextcloud-contacts
-description: "Generated skill for contacts operations. Contains 3 tools."
-tags: [contacts]
----
-
-### Overview
-This skill handles operations related to contacts.
-
-### Available Tools
-- `list_address_books`: List address books.
-  - **Parameters**:
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-- `list_contacts`: List contacts in an address book.
-  - **Parameters**:
-    - `address_book_url` (str)
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-- `create_contact`: Create a new contact using raw vCard data.
-  - **Parameters**:
-    - `address_book_url` (str)
-    - `vcard_data` (str)
-    - `base_url` (str)
-    - `username` (str)
-    - `password` (str)
-
-### Usage Instructions
-1. Review the tool available in this skill.
-2. Call the tool with the required parameters.
-
-### Error Handling
-- Ensure all required parameters are provided.
-- Check return values for error messages.

nextcloud_agent-0.2.24/nextcloud_agent/skills/nextcloud-dev-manual/SKILL.md

@@ -1,97 +0,0 @@
----
-name: nextcloud-dev-manual
-description: Developer manual for Nextcloud server version 14.
-source_url: https://docs.nextcloud.com/server/14/developer_manual/
-categories: [Documentation, Knowledge Base, Reference]
-tags: [docs, reference, nextcloud-dev-manual, knowledge-base]
----
-
-# Nextcloud Dev Manual Documentation
-
-Developer manual for Nextcloud server version 14.
-
-**Original Source**: [https://docs.nextcloud.com/server/14/developer_manual/](https://docs.nextcloud.com/server/14/developer_manual/)
-
-**Contains**: 71 markdown files with full folder structure.
-*Last updated: February 27, 2026*
-
-## 📚 Table of Contents
-
-- [Android Library Index.Html](reference/android_library_index.html.md)
-- [Api.Html](reference/api.html.md)
-- [App Api.Html](reference/app_api.html.md)
-- [App Appdata.Html](reference/app_appdata.html.md)
-- [App Backgroundjobs.Html](reference/app_backgroundjobs.html.md)
-- [App Changelog.Html](reference/app_changelog.html.md)
-- [App Classloader.Html](reference/app_classloader.html.md)
-- [App Code Signing.Html](reference/app_code_signing.html.md)
-- [App Configuration.Html](reference/app_configuration.html.md)
-- [App Container.Html](reference/app_container.html.md)
-- [App Controllers.Html](reference/app_controllers.html.md)
-- [App Css.Html](reference/app_css.html.md)
-- [App Database.Html](reference/app_database.html.md)
-- [App Filesystem.Html](reference/app_filesystem.html.md)
-- [App Hooks.Html](reference/app_hooks.html.md)
-- [App Index.Html](reference/app_index.html.md)
-- [App Info.Html](reference/app_info.html.md)
-- [App Init.Html](reference/app_init.html.md)
-- [App Js.Html](reference/app_js.html.md)
-- [App L10N.Html](reference/app_l10n.html.md)
-- [App Logging.Html](reference/app_logging.html.md)
-- [App Middleware.Html](reference/app_middleware.html.md)
-- [App Migrations.Html](reference/app_migrations.html.md)
-- [App Publishing.Html](reference/app_publishing.html.md)
-- [App Repair.Html](reference/app_repair.html.md)
-- [App Request.Html](reference/app_request.html.md)
-- [App Routes.Html](reference/app_routes.html.md)
-- [App Schema.Html](reference/app_schema.html.md)
-- [App Settings.Html](reference/app_settings.html.md)
-- [App Startapp.Html](reference/app_startapp.html.md)
-- [App Templates.Html](reference/app_templates.html.md)
-- [App Testing.Html](reference/app_testing.html.md)
-- [App Theming.Html](reference/app_theming.html.md)
-- [App Tutorial.Html](reference/app_tutorial.html.md)
-- [App Two Factor Provider.Html](reference/app_two-factor-provider.html.md)
-- [App Users.Html](reference/app_users.html.md)
-- [Bugtracker Index.Html](reference/bugtracker_index.html.md)
-- [Builds](reference/builds.md)
-- [Client Apis Loginflow Index.Html](reference/client_apis_LoginFlow_index.html.md)
-- [Client Apis Ocs Index.Html](reference/client_apis_OCS_index.html.md)
-- [Client Apis Webdav Index.Html](reference/client_apis_WebDAV_index.html.md)
-- [Client Apis Index.Html](reference/client_apis_index.html.md)
-- [Commun Index.Html](reference/commun_index.html.md)
-- [Core Externalapi.Html](reference/core_externalapi.html.md)
-- [Core Index.Html](reference/core_index.html.md)
-- [Core Ocs Share Api.Html](reference/core_ocs-share-api.html.md)
-- [Core Theming.Html](reference/core_theming.html.md)
-- [Core Translation.Html](reference/core_translation.html.md)
-- [Core Unit Testing.Html](reference/core_unit-testing.html.md)
-- [Design Content.Html](reference/design_content.html.md)
-- [Design Css.Html](reference/design_css.html.md)
-- [Design Html.Html](reference/design_html.html.md)
-- [Design Icons.Html](reference/design_icons.html.md)
-- [Design Index.Html](reference/design_index.html.md)
-- [Design List.Html](reference/design_list.html.md)
-- [Design Navigation.Html](reference/design_navigation.html.md)
-- [Design Popovermenu.Html](reference/design_popovermenu.html.md)
-- [General Backporting.Html](reference/general_backporting.html.md)
-- [General Code Of Conduct.Html](reference/general_code-of-conduct.html.md)
-- [General Codingguidelines.Html](reference/general_codingguidelines.html.md)
-- [General Debugging.Html](reference/general_debugging.html.md)
-- [General Devenv.Html](reference/general_devenv.html.md)
-- [General Index.Html](reference/general_index.html.md)
-- [General Performance.Html](reference/general_performance.html.md)
-- [General Security.Html](reference/general_security.html.md)
-- [Projects](reference/projects.md)
-- [Server 14 Developer Manual](reference/server_14_developer_manual.md)
-- [Nextcloud developer documentation[¶](https://docs.nextcloud.com/server/15/developer_manual/#nextcloud-developer-documentation "Permalink to this headline")](reference/server_15_developer_manual.md)
-- [Nextcloud developer documentation[¶](https://docs.nextcloud.com/server/16/developer_manual/#nextcloud-developer-documentation "Permalink to this headline")](reference/server_16_developer_manual.md)
-- [Nextcloud developer documentation[](https://docs.nextcloud.com/server/latest/developer_manual/#nextcloud-developer-documentation "Link to this heading")](reference/server_latest_developer_manual.md)
-- [Nextcloud developer documentation[](https://docs.nextcloud.com/server/stable/developer_manual/#nextcloud-developer-documentation "Link to this heading")](reference/server_stable_developer_manual.md)
-
-## 🤖 Agent Usage Guide
-
-- When the user asks anything about **Nextcloud Dev Manual**, consult the reference files.
-- Prefer exact quotes and direct links to the relevant file/section.
-- The hierarchical TOC above makes navigation fast and intuitive.
-- All images and assets are preserved so links work perfectly.