nextcloud-agent 2.3.4__tar.gz → 2.3.6__tar.gz

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 2.3.4
+Version: 2.3.6
 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: agent-connector-sdk[mcp]<0.6.0,>=0.5.4
+Requires-Dist: scion-sdk[mcp]<0.6.0,>=0.5.9
 Requires-Dist: requests>=2.34.2
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: python-dateutil>=2.9.0.post0

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/nextcloud_agent/auth.py

@@ -1,5 +1,4 @@
 import logging
-from contextlib import contextmanager
 
 from agent_connector_sdk.config import setting
 from agent_connector_sdk.exceptions import AuthError, UnauthorizedError
@@ -9,14 +8,17 @@ from nextcloud_agent.api_client import NextcloudAPI
 logger = logging.getLogger(__name__)
 
 
-@contextmanager
 def get_client(
     base_url: str | None = None,
     username: str | None = None,
     password: str | None = None,
 ):
     """
-    Returns a NextcloudAPI client.
+    Yield a NextcloudAPI client and close it afterwards.
+
+    A plain generator, because FastMCP's ``Depends`` drives generator
+    dependencies itself; wrapping it in ``contextlib.contextmanager`` handed
+    every tool the context-manager object instead of the client.
 
     CONCEPT:AU-OS.config.secrets-authentication
     """

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/nextcloud_agent/ontology/certification.json

@@ -29,5 +29,5 @@
   "signer": "UNSIGNED-PREVIEW",
   "signing_public_key": "",
   "status": "source-validated",
-  "validated_at": "2026-10-24T13:49:17Z"
+  "validated_at": "2026-10-30T01:41:48Z"
 }

nextcloud_agent-2.3.6/nextcloud_agent/skills/nextcloud-agent-development/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: nextcloud-agent-development
+skill_type: skill
+description: >-
+  Develop and verify nextcloud-agent as a connector-owned package while preserving
+  its SDK Connector wiring, action-routed MCP tools, Nextcloud authentication and
+  TLS boundary, packaged content, and source-backed spec-delivery publication.
+---
+
+# Nextcloud Agent Development
+
+Use this skill for changes to the `nextcloud-agent` connector. The package owns
+Nextcloud API calls, mappings, MCP tools, and connector content; it does not own
+the connector SDK, Arbora admission, the shared Pages renderer, or Pipelines
+hooks.
+
+## Repository map and runtime boundary
+
+- `nextcloud_agent/__init__.py` creates the SDK `Connector` with `NextcloudAPI`,
+  `get_client`, and `nextcloud_agent.mcp_server` as its tool module. Preserve this
+  wiring when changing a client or tool.
+- `nextcloud_agent/mcp_server.py` registers the condensed action-routed tools
+  `nextcloud_files`, `nextcloud_user`, `nextcloud_sharing`, `nextcloud_calendar`,
+  and `nextcloud_contacts`. Their action lists and client calls are the runtime
+  contract; the domain clients live under `nextcloud_agent/api/` and are composed
+  by `nextcloud_agent/api/__init__.py`.
+- `nextcloud_agent/auth.py` reads `NEXTCLOUD_URL`, `NEXTCLOUD_USERNAME`, and
+  `NEXTCLOUD_PASSWORD` through the SDK setting boundary. The API client resolves
+  the named `nextcloud` TLS profile through the SDK and configures a verified,
+  same-origin requests session; preserve that transport boundary and its cleanup.
+- `nextcloud_agent/ontology/`, `nextcloud_agent/prompts/`, and
+  `nextcloud_agent/skills/` contain connector content. The package-data table in
+  `pyproject.toml` declares those trees plus `agent_data/**` and `connectors/**`;
+  inspect a built wheel when changing packaged content.
+- The current `pyproject.toml` declares `nextcloud-mcp` as its console script and
+  `nextcloud-mcp` as its connector identity. Older README, AGENTS, and deployment
+  examples mention a `nextcloud-agent` console script and `agent_server.py`, but
+  those are not declared or present in this source tree. Do not invent that
+  runtime or rewrite it as part of a Pages/skill change.
+
+## Rapid delivery: the 5-minute contract
+
+1. Read the owning `specs/` row and this repository's `AGENTS.md` before editing.
+2. Inspect the active client/tool path and focused tests before changing API
+   behavior, auth, ontology content, or packaged skills.
+3. Prefer the smallest connector-owned change. Preserve action names, parameter
+   schemas, SDK `Connector` wiring, Nextcloud credentials, TLS verification,
+   same-origin checks, and package-data declarations unless the owning requirement
+   changes them.
+4. Run focused tests through the narrow test-slot wrapper, then run the repository
+   pre-commit and pre-push gates without bypasses.
+5. For public packaged content, bump the patch version and refresh `uv.lock`
+   together; inspect the built wheel for the new skill.
+6. Treat Pages as a separate proof: after the exact main SHA has a successful
+   Pages run, check `/spec-delivery/`, its `index.html`, and `snapshot.json` over
+   HTTPS and record the revision from the snapshot.
+
+## Focused development commands
+
+From the repository root:
+
+```bash
+uv sync --locked
+
+/var/tmp/arbora-delivery/scale/run-narrow-test-slot.sh \
+  uv run --locked --extra test pytest -q \
+    tests/test_init.py \
+    tests/test_init_dynamics.py \
+    tests/test_auth.py \
+    tests/test_api_client.py \
+    tests/test_mcp_server.py \
+    tests/test_kg_ingest.py \
+    tests/test_xml_security.py \
+    tests/test_fleet_name.py \
+    tests/test_publication_workflow.py
+
+uvx pre-commit run --all-files
+uvx pre-commit run --all-files --hook-stage pre-push
+```
+
+These checks cover SDK server construction, runtime entry points, action
+dispatch, authentication, XML security, ingestion, fleet identity, and the
+Pages/release contract. Do not replace them with a live Nextcloud call or a
+credential-bearing test.
+
+## Pages and package publication
+
+`.github/workflows/pages.yml` is the one Pages caller. It invokes the shared
+Pipelines `pages_pipeline.yml@main` with `content_source: docs` and the version 1
+`.github/spec-dashboard.json` source declaration for `specs/*/status.json`.
+Keep manual dispatch and the docs/spec/config/workflow path filters. The old direct
+`mkdocs gh-deploy` publisher must not be restored because it would compete with the
+shared dashboard build.
+
+After a merge, verify the exact main SHA in the successful Pages run and probe:
+
+```bash
+curl -fsSI https://knuckles-team.github.io/nextcloud-agent/
+curl -fsSI https://knuckles-team.github.io/nextcloud-agent/spec-delivery/
+curl -fsSI https://knuckles-team.github.io/nextcloud-agent/spec-delivery/index.html
+curl -fsS https://knuckles-team.github.io/nextcloud-agent/spec-delivery/snapshot.json
+```
+
+Keep `.github/workflows/pipeline.yml` on the shared `connector: true` and
+`render_connector: true` flags. Central generation owns generated connector
+manifests and release container artifacts; preserve this package's existing
+runtime, auth, and port semantics and inspect generated output before making
+claims.
+
+## Change discipline
+
+- Keep Nextcloud API calls, request models, ontology mappings, MCP schemas, and
+  ingestion declarations under this repository's `CONN-NEXTCLOUD-AGENT-*` boundary.
+  SDK transport and central renderer behavior belong to their owner repositories.
+- Use `NEXTCLOUD_URL`, `NEXTCLOUD_USERNAME`, and `NEXTCLOUD_PASSWORD` only in
+  injected runtime configuration; never print or commit their values. Preserve
+  TLS certificate verification, same-origin checks, and the SDK-resolved named
+  profile path.
+- For mutations, inspect current state first, require operator approval where the
+  existing connector procedure calls for it, and verify the result. Keep KG
+  ingestion opt-in and preserve its provenance/tenant contract.
+- Keep generated status changes and central promotion with the Pipelines/status
+  owner. Do not claim Pages or public package results from a local build.

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/nextcloud_agent.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nextcloud-agent
-Version: 2.3.4
+Version: 2.3.6
 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: agent-connector-sdk[mcp]<0.6.0,>=0.5.4
+Requires-Dist: scion-sdk[mcp]<0.6.0,>=0.5.9
 Requires-Dist: requests>=2.34.2
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: python-dateutil>=2.9.0.post0

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/nextcloud_agent.egg-info/SOURCES.txt

@@ -29,6 +29,7 @@ nextcloud_agent/ontology/mappings/source.yaml
 nextcloud_agent/ontology/migrations/manifest.json
 nextcloud_agent/ontology/shapes/connector.shacl.ttl
 nextcloud_agent/prompts/file_steward.json
+nextcloud_agent/skills/nextcloud-agent-development/SKILL.md
 nextcloud_agent/skills/nextcloud-agent-operations/SKILL.md
 nextcloud_agent/skills/nextcloud-agent-operations/agents/openai.yaml
 nextcloud_agent/skills/nextcloud-agent-operations/references/catalog.md
@@ -46,4 +47,5 @@ tests/test_init.py
 tests/test_init_dynamics.py
 tests/test_kg_ingest.py
 tests/test_mcp_server.py
+tests/test_publication_workflow.py
 tests/test_xml_security.py

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/nextcloud_agent.egg-info/requires.txt

@@ -1,4 +1,4 @@
-agent-connector-sdk[mcp]<0.6.0,>=0.5.4
+scion-sdk[mcp]<0.6.0,>=0.5.9
 requests>=2.34.2
 defusedxml>=0.7.1
 python-dateutil>=2.9.0.post0

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nextcloud-agent"
-version = "2.3.4"
+version = "2.3.6"
 description = "Nextcloud MCP Server for Agentic AI!"
 readme = "README.md"
 classifiers = [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
 requires-python = ">=3.12"
-dependencies = [ "agent-connector-sdk[mcp]>=0.5.4,<0.6.0", "requests>=2.34.2", "defusedxml>=0.7.1", "python-dateutil>=2.9.0.post0", "icalendar>=7.3.0", "vobject>=0.9.9",]
+dependencies = [ "scion-sdk[mcp]>=0.5.9,<0.6.0", "requests>=2.34.2", "defusedxml>=0.7.1", "python-dateutil>=2.9.0.post0", "icalendar>=7.3.0", "vobject>=0.9.9",]
 [[project.authors]]
 name = "Repository Maintainers"
 email = "maintainers@knuckles.team"
@@ -27,7 +27,7 @@ test = [
 [project.entry-points."agent_connector_sdk.prompt_providers"]
 nextcloud-agent = "nextcloud_agent.prompts"
 
-# The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
+# The one declared connector identity: the fleet name (SCION-CONNECTOR-CONTROL-R071).
 [project.entry-points."agent_connector_sdk.connector"]
 nextcloud-mcp = "nextcloud_agent:connector"
 

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/tests/test_auth.py

@@ -1,10 +1,13 @@
 import os
+from contextlib import contextmanager
 from unittest.mock import patch
 
 import pytest
 from agent_connector_sdk.exceptions import AuthError, UnauthorizedError
 
-from nextcloud_agent.auth import get_client
+from nextcloud_agent.auth import get_client as _get_client
+
+get_client = contextmanager(_get_client)
 
 
 @pytest.mark.concept("OS-5.1")
@@ -57,3 +60,18 @@ def test_auth_coverage():
         with pytest.raises(RuntimeError, match="AUTHENTICATION ERROR"):
             with get_client(base_url="https://x.com", username="u", password="p"):
                 pass
+
+
+@pytest.mark.concept("OS-5.1")
+def test_get_client_is_a_generator_dependency_that_yields_the_client():
+    """``Depends(get_client)`` must resolve to the client, not a context manager."""
+    import inspect
+
+    from nextcloud_agent.auth import get_client as dependency
+
+    assert inspect.isgeneratorfunction(dependency)
+    gen = dependency(base_url="https://x.test", username="u", password="p")
+    client = next(gen)
+    assert client.base_url == "https://x.test"
+    assert not hasattr(client, "__enter__") or hasattr(client, "get_user_info")
+    gen.close()

{nextcloud_agent-2.3.4 → nextcloud_agent-2.3.6}/tests/test_kg_ingest.py

@@ -24,9 +24,9 @@ class _FakeTransport:
         self.requests: list[Any] = []
 
     async def source_status(self, connector, stream):
-
-        del connector, stream
-        return SimpleNamespace(accepted_checkpoint=None)
+        return SimpleNamespace(
+            connector=connector, stream=stream, accepted_checkpoint=None
+        )
 
     async def submit(self, request):
         self.requests.append(request)
@@ -72,7 +72,10 @@ async def test_ingest_listing_maps_files_and_folders(ingest):
         {"name": "sub", "is_folder": True, "file_id": "11"},
     ]
     res = await ingest_listing(entries, parent_path="Documents", ingest=service)
-    assert res == {"nodes": 3, "edges": 2}  # parent folder + file + subfolder, 2 inFolder
+    assert res == {
+        "nodes": 3,
+        "edges": 2,
+    }  # parent folder + file + subfolder, 2 inFolder
 
     records = {r.record_id: r for r in transport.requests[0].records}
     file_node = records["nextcloud:file:10"]
@@ -92,7 +95,14 @@ async def test_ingest_listing_maps_files_and_folders(ingest):
 async def test_ingest_shares_maps_share_and_resource(ingest):
     service, transport = ingest
     res = await ingest_shares(
-        [{"id": "42", "path": "/Documents/report.pdf", "share_type": 3, "share_with": None}],
+        [
+            {
+                "id": "42",
+                "path": "/Documents/report.pdf",
+                "share_type": 3,
+                "share_with": None,
+            }
+        ],
         ingest=service,
     )
     assert res is not None

nextcloud_agent-2.3.6/tests/test_publication_workflow.py

@@ -0,0 +1,57 @@
+"""Keep the connector's shared Pages and publication contracts explicit."""
+
+import json
+from pathlib import Path
+
+import tomllib
+import yaml
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def _workflow(name: str):
+    return yaml.safe_load((ROOT / ".github/workflows" / name).read_text())
+
+
+def _actions_on(workflow):
+    # PyYAML's YAML 1.1 reader represents the Actions ``on`` key as True.
+    return workflow["on"] if "on" in workflow else workflow[True]
+
+
+def test_pages_publishes_spec_dashboard_and_supports_manual_refresh():
+
+    config = json.loads((ROOT / ".github/spec-dashboard.json").read_text())
+    assert config == {
+        "version": 1,
+        "sources": [{"glob": "specs/*/status.json", "kind": "spec"}],
+    }
+
+
+def test_single_pages_publisher_and_release_flags_remain_canonical():
+    assert not (ROOT / ".github/workflows/docs.yml").exists()
+
+
+def test_development_skill_and_runtime_entrypoints_match_source_tree():
+    skill = ROOT / "nextcloud_agent/skills/nextcloud-agent-development/SKILL.md"
+    content = skill.read_text()
+
+    assert "name: nextcloud-agent-development" in content
+    assert "## Rapid delivery: the 5-minute contract" in content
+    for path in (
+        "nextcloud_agent/__init__.py",
+        "nextcloud_agent/auth.py",
+        "nextcloud_agent/mcp_server.py",
+        "nextcloud_agent/api_client.py",
+        "nextcloud_agent/api/api_client_base.py",
+        "tests/test_auth.py",
+        "tests/test_mcp_server.py",
+        "nextcloud_agent/skills/nextcloud-files/SKILL.md",
+        "nextcloud_agent/ontology/nextcloud.ttl",
+    ):
+        assert (ROOT / path).exists(), path
+
+    project = tomllib.loads((ROOT / "pyproject.toml").read_text())["project"]
+    assert project["scripts"]["nextcloud-mcp"] == "agent_connector_sdk.cli:serve"
+    assert project["entry-points"]["agent_connector_sdk.connector"][
+        "nextcloud-mcp"
+    ] == ("nextcloud_agent:connector")