dockerhub-api 1.3.3__tar.gz → 1.3.4__tar.gz

{dockerhub_api-1.3.3/dockerhub_api.egg-info → dockerhub_api-1.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dockerhub-api
-Version: 1.3.3
+Version: 1.3.4
 Summary: Docker Hub API + MCP Server
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -12,11 +12,11 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.15,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.18
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: python-dotenv>=1.2.4
 Provides-Extra: mcp
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.18; extra == "mcp"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "mcp"
 Provides-Extra: all
 Requires-Dist: dockerhub-api[mcp]>=1.0.1; extra == "all"
 Provides-Extra: test
@@ -41,7 +41,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/dockerhub-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/dockerhub-api)
 
-*Version: 1.3.3*
+*Version: 1.3.4*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > Docker Hub platform are maintained in [docs/](docs/index.md).

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/README.md

@@ -13,7 +13,7 @@
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/dockerhub-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/dockerhub-api)
 
-*Version: 1.3.3*
+*Version: 1.3.4*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > Docker Hub platform are maintained in [docs/](docs/index.md).

dockerhub_api-1.3.4/dockerhub_api/connector_sources.py

@@ -0,0 +1,192 @@
+"""Data sources of this connector, declared by tool name (generated by connector-ontology-map migrate).
+
+Served live as ``connector://resources``. Regenerate by editing the declarations, not the tools.
+"""
+
+# ruff: noqa: E501
+from __future__ import annotations
+
+from agent_connector_sdk.ingest.live_declaration import source_meta
+from agent_connector_sdk.ingest.sources import IngestSourceDeclaration, IngestSourceSpec
+
+CONNECTOR = "dockerhub-mcp"
+
+SOURCES = (
+    source_meta(
+        tool="dockerhub_get_repositories",
+        source_id="dockerhub-repositories",
+        record_type="Repository",
+        id_field="name",
+        cursor_field="last_updated",
+        page_param="page",
+        page_size_param="page_size",
+        pagination="page",
+        preset={
+            "doc_type": "repository",
+            "page_kind": "number",
+            "params_style": "args",
+        },
+        records_path="data.results",
+        server="dockerhub-mcp",
+        text_field="description",
+        title_field="name",
+    ),
+)
+
+SCHEMA_MAPPINGS = {
+    "AccessToken": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": None,
+    },
+    "ContainerImage": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": None,
+    },
+    "Namespace": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": None,
+    },
+    "Organization": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": "Namespace",
+    },
+    "Repository": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": "SoftwareProject",
+    },
+    "Team": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": "Team",
+    },
+    "Vulnerability": {
+        "fields": {
+            "architecture": "xsd:string",
+            "digest": "xsd:string",
+            "imageSize": "xsd:integer",
+            "isPrivate": "xsd:boolean",
+            "lastPushed": "xsd:string",
+            "permission": "xsd:string",
+            "pullCount": "xsd:integer",
+            "scopes": "xsd:string",
+            "starCount": "xsd:integer",
+        },
+        "ontology_class": None,
+    },
+}
+
+RESOURCES = (
+    {
+        "id_prefix": "accesstoken",
+        "label": "Access Token",
+        "name": "AccessToken",
+    },
+    {
+        "id_prefix": "containerimage",
+        "label": "Container Image",
+        "name": "ContainerImage",
+    },
+    {
+        "id_prefix": "namespace",
+        "label": "Docker Hub Namespace",
+        "name": "Namespace",
+    },
+    {
+        "id_prefix": "organization",
+        "label": "Docker Hub Organization",
+        "name": "Organization",
+    },
+    {
+        "id_prefix": "repository",
+        "label": "Container Repository",
+        "name": "Repository",
+    },
+    {
+        "id_prefix": "team",
+        "label": "Team",
+        "name": "Team",
+    },
+    {
+        "id_prefix": "vulnerability",
+        "label": "Vulnerability",
+        "name": "Vulnerability",
+    },
+)
+
+
+def declaration() -> IngestSourceDeclaration:
+    """The declaration the server assembles from this module."""
+    specs = []
+    for item in SOURCES:
+        for entry in item["connector_sources"]:
+            body = {k: v for k, v in entry.items() if k not in ("tool", "mapping")}
+            specs.append(
+                IngestSourceSpec.model_validate({**body, "tools": (entry["tool"],)})
+            )
+    return IngestSourceDeclaration.model_validate(
+        {
+            "connector": CONNECTOR,
+            "sources": specs,
+            "schema_mappings": SCHEMA_MAPPINGS,
+            "resources": RESOURCES,
+        }
+    )

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api/mcp_server.py

@@ -45,7 +45,7 @@ from dockerhub_api.mcp import (
     register_teams_tools,  # noqa: F401
 )
 
-__version__ = "1.3.3"
+__version__ = "1.3.4"
 print(f"Docker Hub MCP v{__version__}", file=sys.stderr)
 
 logger = get_logger(name="mcp_server")

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api/ontology/certification.json

@@ -1,9 +1,6 @@
 {
   "api_version": "arbora.io/v1",
   "artifacts": {
-    "connector_manifest.yml": "1d2826d511f1b9ad3c921d7cca5d094285890c92bdd61cf4d27fc33853301e7d",
-    "dockerhub_api/connectors/mcp_source_presets.json": "96b893636a49ece1a5f32decb9aea8e3740178cb5e4a19753748b4d18e7ca678",
-    "dockerhub_api/connectors/tool_schema_fingerprints.json": "60f37329f11dc900fa385099069f005c7fc8f4b8afcb0ac05d48794b1c62324a",
     "dockerhub_api/ontology/dockerhub.ttl": "bd3f4498e3e9463ee4395a5da1d6afcbfc081a1437e1be52437ab4d52e18d55a",
     "dockerhub_api/ontology/fixtures/records.json": "cdf24bdcd53b75daef789c05f93d55ced4ce4a138360a2ff9f1e34c55f8f6da8",
     "dockerhub_api/ontology/mappings/source.yaml": "72d333a63cb808bbc9a2f031834fa4c75919b11a8171ad5b347fad61247fa016",

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api/ontology/dockerhub.ttl

@@ -16,30 +16,25 @@
     rdfs:label "Docker Hub Namespace" ;
     rdfs:comment "A Docker Hub account/organization namespace that owns image repositories (the {namespace} in namespaces/{ns}/repositories)." .
 
-:Organization a owl:Class ;
-    rdfs:subClassOf :Namespace ;
-    rdfs:label "Docker Hub Organization" ;
-    rdfs:comment "An organization namespace with members, teams, settings, and invites (hub_org)." .
+:Organization a owl:Class .
+
+
+:Repository a owl:Class .
 
-:Repository a owl:Class ;
-    rdfs:label "Container Repository" ;
-    rdfs:comment "A Docker Hub image repository holding tags and container images (hub_repos list/get)." .
 
 :ContainerImage a owl:Class ;
     rdfs:label "Container Image" ;
     rdfs:comment "A concrete, content-addressable OCI/Docker image (a repository tag resolving to a digest, size, and platform) — hub_repos list_tags / get_tag and hub_registry manifests." .
 
-:Team a owl:Class ;
-    rdfs:label "Team" ;
-    rdfs:comment "An organization group (team) granted repository permissions (hub_teams / hub_repos assign_group)." .
+:Team a owl:Class .
+
 
 :AccessToken a owl:Class ;
     rdfs:label "Access Token" ;
     rdfs:comment "A personal or organization access token (PAT / OAT) scoped for registry and API access (hub_auth / hub_org tokens). Secret material is never ingested." .
 
-:Vulnerability a owl:Class ;
-    rdfs:label "Vulnerability" ;
-    rdfs:comment "A CVE / security finding reported against a container image by Docker Scout (hub_scout)." .
+:Vulnerability a owl:Class .
+
 
 # --- links (owl:ObjectProperty) ---
 
@@ -138,5 +133,8 @@
     rdfs:comment """Docker Hub container-registry model — namespaces and organizations,
     image repositories, tags and the concrete container images they resolve to (digest,
     architecture, size), teams and their repository permissions, access tokens, and Docker
-    Scout vulnerabilities — federated into the agent-connector-sdk knowledge-graph hub.""" ;
-    owl:imports <http://knuckles.team/kg> .
+    Scout vulnerabilities — federated into the agent-connector-sdk knowledge-graph hub.""" .
+
+# ontology-codemod R3
+<http://knuckles.team/kg#ContainerImage> rdfs:subClassOf <http://knuckles.team/kg/infrastructure#ContainerImage> .
+<http://knuckles.team/kg#Namespace> rdfs:subClassOf <http://knuckles.team/kg/infrastructure#Namespace> .

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4/dockerhub_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dockerhub-api
-Version: 1.3.3
+Version: 1.3.4
 Summary: Docker Hub API + MCP Server
 Author-email: Project Maintainers <maintainers@users.noreply.github.com>
 License: MIT
@@ -12,11 +12,11 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: <3.15,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.18
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: python-dotenv>=1.2.4
 Provides-Extra: mcp
-Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.3.18; extra == "mcp"
+Requires-Dist: agent-connector-sdk[mcp]<1.0.0,>=0.4.1; extra == "mcp"
 Provides-Extra: all
 Requires-Dist: dockerhub-api[mcp]>=1.0.1; extra == "all"
 Provides-Extra: test
@@ -41,7 +41,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/dockerhub-api)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/dockerhub-api)
 
-*Version: 1.3.3*
+*Version: 1.3.4*
 
 > **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
 > Docker Hub platform are maintained in [docs/](docs/index.md).

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ dockerhub_api/__init__.py
 dockerhub_api/__main__.py
 dockerhub_api/api_client.py
 dockerhub_api/auth.py
+dockerhub_api/connector_sources.py
 dockerhub_api/dockerhub_input_models.py
 dockerhub_api/dockerhub_response_models.py
 dockerhub_api/kg_ingest.py
@@ -32,8 +33,6 @@ dockerhub_api/api/api_client_repositories.py
 dockerhub_api/api/api_client_scim.py
 dockerhub_api/api/api_client_scout.py
 dockerhub_api/connectors/__init__.py
-dockerhub_api/connectors/mcp_source_presets.json
-dockerhub_api/connectors/tool_schema_fingerprints.json
 dockerhub_api/mcp/__init__.py
 dockerhub_api/mcp/mcp_admin.py
 dockerhub_api/mcp/mcp_audit.py

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api.egg-info/entry_points.txt

@@ -7,8 +7,5 @@ dockerhub-api = dockerhub_api.ontology
 [agent_connector_sdk.skill_providers]
 dockerhub-api = dockerhub_api.skills
 
-[agent_connector_sdk.source_connector_providers]
-dockerhub-api = dockerhub_api.connectors
-
 [console_scripts]
 dockerhub-mcp = dockerhub_api.mcp_server:mcp_server

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/dockerhub_api.egg-info/requires.txt

@@ -1,4 +1,4 @@
-agent-connector-sdk[mcp]<1.0.0,>=0.3.18
+agent-connector-sdk[mcp]<1.0.0,>=0.4.1
 httpx>=0.28.1
 python-dotenv>=1.2.4
 
@@ -6,7 +6,7 @@ python-dotenv>=1.2.4
 dockerhub-api[mcp]>=1.0.1
 
 [mcp]
-agent-connector-sdk[mcp]<1.0.0,>=0.3.18
+agent-connector-sdk[mcp]<1.0.0,>=0.4.1
 
 [test]
 pytest-xdist>=3.8.0

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dockerhub-api"
-version = "1.3.3"
+version = "1.3.4"
 description = "Docker Hub API + MCP Server"
 readme = "README.md"
 classifiers = [ "Development Status :: 5 - Production/Stable", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
 requires-python = ">=3.12, <3.15"
-dependencies = [ "agent-connector-sdk[mcp]>=0.3.18,<1.0.0", "httpx>=0.28.1", "python-dotenv>=1.2.4",]
+dependencies = [ "agent-connector-sdk[mcp]>=0.4.1,<1.0.0", "httpx>=0.28.1", "python-dotenv>=1.2.4",]
 [[project.authors]]
 name = "Project Maintainers"
 email = "maintainers@users.noreply.github.com"
@@ -18,7 +18,7 @@ email = "maintainers@users.noreply.github.com"
 text = "MIT"
 
 [project.optional-dependencies]
-mcp = [ "agent-connector-sdk[mcp]>=0.3.18,<1.0.0",]
+mcp = [ "agent-connector-sdk[mcp]>=0.4.1,<1.0.0",]
 all = [ "dockerhub-api[mcp]>=1.0.1",]
 test = [
     "pytest-xdist>=3.8.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0",]
@@ -32,9 +32,6 @@ dockerhub-api = "dockerhub_api.skills"
 [project.entry-points."agent_connector_sdk.ontology_providers"]
 dockerhub-api = "dockerhub_api.ontology"
 
-[project.entry-points."agent_connector_sdk.source_connector_providers"]
-dockerhub-api = "dockerhub_api.connectors"
-
 # The one declared connector identity: the fleet name (SDK-CONNECTOR-CONTROL-R071).
 [project.entry-points."agent_connector_sdk.connector"]
 dockerhub-mcp = "dockerhub_api"

dockerhub_api-1.3.4/requirements.txt

@@ -0,0 +1,3 @@
+agent-connector-sdk[mcp]>=0.4.1,<1.0.0
+httpx>=0.27.0
+python-dotenv>=1.0.0

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/tests/test_fleet_name.py

@@ -2,9 +2,8 @@
 
 from __future__ import annotations
 
+from agent_connector_sdk.connector_identity import connector_name
 import ast
-import json
-import re
 import tomllib
 from pathlib import Path
 
@@ -38,16 +37,6 @@ def test_connector_name_is_the_fleet_name() -> None:
     assert pyproject["project"]["entry-points"]["agent_connector_sdk.connector"] == {
         FLEET: "dockerhub_api"
     }
-    manifest_path = PACKAGE / "connector_manifest.yml"
-    if not manifest_path.is_file():
-        manifest_path = ROOT / "connector_manifest.yml"
-    manifest = manifest_path.read_text(encoding="utf-8")
-    match = re.search(r'^\s*"?connector"?\s*:\s*"?([^"\s,]+)', manifest, re.MULTILINE)
-    assert match is not None and match.group(1) == FLEET
-    fingerprints = PACKAGE / "connectors" / "tool_schema_fingerprints.json"
-    if fingerprints.is_file():
-        assert (
-            json.loads(fingerprints.read_text(encoding="utf-8"))["connector"] == FLEET
-        )
+    assert connector_name("dockerhub_api") == FLEET
     for module in sorted(PACKAGE.glob("*.py")):
         assert all(name == FLEET for name in _call_connectors(module)), module.name

{dockerhub_api-1.3.3 → dockerhub_api-1.3.4}/tests/test_kg_ingest.py

@@ -69,7 +69,7 @@ async def test_ingest_entities_writes_nodes_and_edges(ingest):
     a_record = next(r for r in request.records if r.record_id == "a")
     assert a_record.payload["name"] == "r"
     assert request.relationships[0].relation_reference.endswith(
-        "resources/Repository/relations/inNamespace"
+        "relations/Repository/inNamespace"
     )
 
 

dockerhub_api-1.3.3/dockerhub_api/connectors/mcp_source_presets.json

@@ -1,18 +0,0 @@
-{
-  "_comment": "Tier-1 mcp_tool source presets for dockerhub-api (AU-KG.ingest.mcp-tool-connector). Syncs Docker Hub repositories into the KG as repository documents via the dockerhub-api MCP server hub_repos tool. Contributed presets win over the central MCP_TOOL_PRESETS. The native dockerhub_ingest_repositories tool + kg_ingest.py provide the typed :Repository/:ContainerImage graph nodes.",
-  "dockerhub-repositories": {
-    "server": "dockerhub-mcp",
-    "tool": "dockerhub_get_repositories",
-    "records_path": "data.results",
-    "id_field": "name",
-    "title_field": "name",
-    "text_field": "description",
-    "updated_field": "last_updated",
-    "pagination": "page",
-    "page_kind": "number",
-    "page_param": "page",
-    "page_size_param": "page_size",
-    "doc_type": "repository",
-    "params_style": "args"
-  }
-}

dockerhub_api-1.3.3/dockerhub_api/connectors/tool_schema_fingerprints.json

@@ -1,8 +0,0 @@
-{
-  "algorithm": "agent-connector-sdk:mcp-tool-contract-compat:v2",
-  "connector": "dockerhub-mcp",
-  "schema_version": "1",
-  "tools": {
-    "dockerhub_get_repositories": "c6fb6018860f39159633a23ca0b19a3555daa371598111e280e753ef80ca0595"
-  }
-}

dockerhub_api-1.3.3/requirements.txt

@@ -1,3 +0,0 @@
-agent-connector-sdk[mcp]>=0.2.1,<1.0.0
-httpx>=0.27.0
-python-dotenv>=1.0.0