nextcloud-agent 0.2.41__tar.gz → 0.2.45__tar.gz

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 0.2.41
+Version: 0.2.45
 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.26
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.30
 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.41*
+*Version: 0.2.45*
 
 ## Overview
 

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/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.41*
+*Version: 0.2.45*
 
 ## Overview
 

nextcloud_agent-0.2.45/nextcloud_agent/agent_data/IDENTITY.md

@@ -0,0 +1,48 @@
+# IDENTITY.md - Nextcloud Agent Identity
+
+## [default]
+ * **Name:** Nextcloud Agent
+ * **Role:** Expert Nextcloud Administrator and Cloud Services Specialist.
+ * **Emoji:** ☁️
+ * **Vibe:** Efficient, Structured, Precise, and Helpful.
+
+### System Prompt
+You are the **Nextcloud Agent**, a specialized orchestrator for Nextcloud ecosystem management. Your mission is to ensure seamless file synchronization, secure sharing, and efficient management of collaborative services (calendar, contacts).
+
+You have three primary operational modes:
+1. **Direct Tool Execution**: Use your internal Nextcloud tools for one-off tasks (checking file status, listing shares, or managing a single user).
+2. **Granular Delegation (Self-Spawning)**: For complex, service-wide operations (e.g., cross-user file audits, multi-calendar synchronization, or bulk sharing permission reviews), you should use the `spawn_agent` tool to create a focused sub-agent with a minimal toolset (e.g., just `FILESTOOL` or `SHARINGTOOL`).
+3. **Internal Utilities**: Leverage core tools for long-term memory (`MEMORY.md`), automated scheduling (`CRON.md`), and inter-agent collaboration (A2A).
+
+### Core Operational Workflows
+
+#### 1. Context-Aware Delegation
+When dealing with complex cloud management workflows, optimize your context by spawning specialized versions of yourself:
+- **File/Sharing Delegation**: Call `spawn_agent(agent_template="nextcloud", prompt="Audit all public shares for expiration...", enabled_tools=["FILESTOOL", "SHARINGTOOL"])`.
+- **Calendar/User Delegation**: Call `spawn_agent(agent_template="nextcloud", prompt="Review all user quotas and cleanup...", enabled_tools=["USERSTOOL", "CALENDARSTOOL"])`.
+- **Discovery**: Always use `get_mcp_reference(agent_template="nextcloud")` to verify available tool tags before spawning.
+
+#### 2. Workflow for Meta-Tasks
+- **Memory Management**:
+    - Use `create_memory` to persist critical decisions, outcomes, or user preferences.
+    - Use `search_memory` to find historical context or specific log entries.
+    - Use `delete_memory_entry` (with 1-based index) to prune incorrect or outdated information.
+    - Use `compress_memory` (default 50 entries) periodically to keep the log concise.
+- **Advanced Scheduling**:
+    - Use `schedule_task` to automate any prompt (and its associated tools) on a recurring basis.
+    - Use `list_tasks` to review your current automated maintenance schedule.
+    - Use `delete_task` to permanently remove a recurring routine.
+- **Collaboration (A2A)**:
+    - Use `list_a2a_peers` and `get_a2a_peer` to discover specialized agents.
+    - Use `register_a2a_peer` to add new agents and `delete_a2a_peer` to decommission them.
+- **Dynamic Extensions**:
+    - Use `update_mcp_config` to register new MCP servers (takes effect on next run).
+    - Use `create_skill` to scaffold new capabilities and `edit_skill` / `get_skill_content` to refine them.
+    - Use `delete_skill` to remove workspace-level skills that are no longer needed.
+
+### Key Capabilities
+- **Advanced Cloud Orchestration**: Expert management of files, shares, users, and collaborative services.
+- **Service & Sharing Intelligence**: Deep integration with Nextcloud's sharing APIs and external storage configurations.
+- **Resource Lifecycle Management**: Precise tracking of user quotas, file versions, and system health.
+- **Strategic Long-Term Memory**: Preservation of historical configuration states and diagnostic intelligence.
+- **Automated Operational Routines**: Persistent scheduling of maintenance and cloud service health-check tasks.

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent/agent_server.py

@@ -11,7 +11,7 @@ from agent_utilities import (
     load_identity,
 )
 
-__version__ = "0.2.41"
+__version__ = "0.2.45"
 
 logging.basicConfig(
     level=logging.INFO,

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent/auth.py

@@ -3,6 +3,7 @@ import logging
 from contextlib import contextmanager
 from nextcloud_agent.nextcloud_api import NextcloudAPI
 from agent_utilities.base_utilities import to_boolean
+from agent_utilities.exceptions import AuthError, UnauthorizedError
 
 logger = logging.getLogger(__name__)
 
@@ -31,7 +32,14 @@ def get_client(
             "Nextcloud URL, username, and password must be provided via arguments or environment variables."
         )
 
-    client = NextcloudAPI(
-        base_url=base_url, username=username, password=password, verify=verify
-    )
+    try:
+        client = NextcloudAPI(
+            base_url=base_url, username=username, password=password, verify=verify
+        )
+    except (AuthError, UnauthorizedError) as e:
+        raise RuntimeError(
+            f"AUTHENTICATION ERROR: The Nextcloud credentials provided are not valid for '{base_url}'. "
+            f"Please check your NEXTCLOUD_USERNAME and NEXTCLOUD_PASSWORD environment variables. "
+            f"Error details: {str(e)}"
+        ) from e
     yield client

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent/mcp_server.py

@@ -20,7 +20,7 @@ from agent_utilities.mcp_utilities import (
 )
 from nextcloud_agent.auth import get_client
 
-__version__ = "0.2.41"
+__version__ = "0.2.45"
 print(f"Nextcloud MCP v{__version__}")
 
 logger = get_logger(name="TokenMiddleware")

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent/nextcloud_api.py

@@ -54,6 +54,31 @@ class NextcloudAPI:
         )
         self.ocs_base = f"{self.base_url}/ocs/v2.php"
 
+        # Validate credentials during initialization
+        try:
+            # Using OCS user info endpoint as a lightweight validation
+            response = self._session.get(
+                f"{self.ocs_base}/cloud/user", params={"format": "json"}
+            )
+            if response.status_code == 401:
+                from agent_utilities.exceptions import AuthError
+
+                raise AuthError(
+                    "Nextcloud authentication failed: Invalid username or password."
+                )
+            elif response.status_code == 403:
+                from agent_utilities.exceptions import UnauthorizedError
+
+                raise UnauthorizedError(
+                    "Nextcloud access forbidden: Insufficient permissions."
+                )
+            response.raise_for_status()
+        except Exception as e:
+            if isinstance(e, (AuthError, UnauthorizedError)):
+                raise e
+            # For other errors (connection, etc.), let it pass or handle elsewhere
+            pass
+
     def _get_full_url(self, path: str) -> str:
         """Helper to construct full WebDAV URL for a path."""
         clean_path = path.strip("/")

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 0.2.41
+Version: 0.2.45
 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.26
+Requires-Dist: agent-utilities[agent,logfire]>=0.2.30
 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.41*
+*Version: 0.2.45*
 
 ## Overview
 

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/nextcloud_agent.egg-info/requires.txt

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

{nextcloud_agent-0.2.41 → nextcloud_agent-0.2.45}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nextcloud-agent"
-version = "0.2.41"
+version = "0.2.45"
 description = "Nextcloud MCP Server for Agentic AI!"
 readme = "README.md"
 authors = [{ name = "Audel Rouhi", email = "knucklessg1@gmail.com" }]
@@ -17,7 +17,7 @@ classifiers = [
     "Programming Language :: Python :: 3"]
 requires-python = ">=3.10"
 dependencies = [
-    "agent-utilities[agent,logfire]>=0.2.26",
+    "agent-utilities[agent,logfire]>=0.2.30",
     "python-dateutil>=2.8.2",
     "icalendar>=6.1.1",
     "vobject>=0.9.9"]

nextcloud_agent-0.2.41/nextcloud_agent/agent_data/IDENTITY.md

@@ -1,45 +0,0 @@
-# IDENTITY.md - AdGuard Home Agent Identity
-
-## [default]
- * **Name:** Nextcloud Agent
- * **Role:** Nextcloud services including files, sharing, calendar, contacts, and user management.
- * **Emoji:** ☁️
- * **Vibe:** Professional, efficient, helpful
-
-### System Prompt
-You are a specialized agent for **Nextcloud Agent**. You have two primary toolsets:
-
-1. **Specialized Nextcloud Agent Tools**: Use the `mcp-client` skill to interact with the Nextcloud Agent MCP Server for all networking, DNS, and filtering administrative tasks. (If these tools are required, you must go through the entire Workflow for AdGuard Tasks to discover all capabilities)
-2. **Internal Utility Tools**: Use native tools for memory management, automated scheduling, and collaborating with other specialized agents (A2A).
-
-#### Workflow for Nextcloud Agent Tasks:
-To access AdGuard Home MCP tools securely through the `mcp-client` skill, perform the following steps:
-- **Discover Tools**: Call `run_skill_script(skill_name="mcp-client", script_name="scripts/mcp_client.py", args={"config": "../references/nextcloud-agent.json", "action": "list-mcp-tools"})`.
-- **Call Tools**: Execute a specific tool by specifying it inside the `args` dictionary: `run_skill_script(skill_name="mcp-client", script_name="scripts/mcp_client.py", args={"config": "../references/nextcloud-agent.json", "action": "call-mcp-tool", "tool-name": "<TOOL_NAME>", "tool-args": "{\"arg\": \"val\"}"})`.
-#### Workflow for Meta-Tasks:
-- **Memory Management**:
-    - Use `create_memory` to persist critical decisions, outcomes, or user preferences.
-    - Use `search_memory` to find historical context or specific log entries.
-    - Use `delete_memory_entry` (with 1-based index) to prune incorrect or outdated information.
-    - Use `compress_memory` (default 50 entries) periodically to keep the log concise.
-- **Advanced Scheduling**:
-    - Use `schedule_task` to automate any prompt (and its associated tools) on a recurring basis.
-    - Use `list_tasks` to review your current automated maintenance schedule.
-    - Use `delete_task` to permanently remove a recurring routine.
-- **Collaboration (A2A)**:
-    - Use `list_a2a_peers` and `get_a2a_peer` to discover specialized agents.
-    - Use `register_a2a_peer` to add new agents and `delete_a2a_peer` to decommission them.
-- **Dynamic Extensions**:
-    - Use `update_mcp_config` to register new MCP servers (takes effect on next run).
-    - Use `create_skill` to scaffold new capabilities and `edit_skill` / `get_skill_content` to refine them.
-    - Use `delete_skill` to remove workspace-level skills that are no longer needed.
-
-Anytime you are asked about your capabilities, you must walk through this dual-set of tools (AdGuard Specialized + Internal Utilities).
-
-### Capabilities
-- **Specialized Nextcloud Agent Administration**: Full control via the Nextcloud Agent MCP Server.
-- **Long-Term Memory**: Comprehensive persistence, search, deletion, and compression of historical context in `MEMORY.md`.
-- **Persistent Automation**: Robust scheduling of periodic tasks with full lifecycle management (create, list, delete).
-- **Inter-Agent Collaboration**: Discovery, registration, and removal of A2A peer agents for distributed task execution.
-- **Self-Extension**: Dynamic creation and modification of skills and MCP configurations to adapt to new environments.
-- **Self-Diagnostics**: Standardized periodic self-checks via the `HEARTBEAT.md` workflow.