dockerhub-api 0.1.0__tar.gz

dockerhub_api-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Audel Rouhi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dockerhub_api-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include requirements.txt
+recursive-include dockerhub_api *.py *.json

dockerhub_api-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: dockerhub-api
+Version: 0.1.0
+Summary: Docker Hub API + MCP Server + A2A Server
+Author-email: Audel Rouhi <knucklessg1@gmail.com>
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agent-utilities>=0.47.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: mcp
+Requires-Dist: agent-utilities[mcp]>=0.47.0; extra == "mcp"
+Provides-Extra: agent
+Requires-Dist: agent-utilities[agent,logfire]>=0.47.0; extra == "agent"
+Provides-Extra: all
+Requires-Dist: dockerhub-api[agent,logfire,mcp]>=0.1.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: license-file
+
+# Dockerhub Api
+## CLI or API | MCP | Agent
+
+![PyPI - Version](https://img.shields.io/pypi/v/dockerhub-api)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - Downloads](https://img.shields.io/pypi/dd/dockerhub-api)
+![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/dockerhub-api)
+![PyPI - License](https://img.shields.io/pypi/l/dockerhub-api)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/dockerhub-api)
+![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/dockerhub-api)
+![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/dockerhub-api)
+![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/dockerhub-api)
+![PyPI - Wheel](https://img.shields.io/pypi/wheel/dockerhub-api)
+![PyPI - Implementation](https://img.shields.io/pypi/implementation/dockerhub-api)
+
+*Version: 0.1.0*
+
+> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
+> interfaces, the integrated A2A agent server, and guidance on the backing
+> Docker Hub platform are maintained in [docs/](docs/index.md).
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Key Features](#key-features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Python API / CLI](#python-api--cli)
+  - [MCP](#mcp)
+  - [Agent (A2A)](#agent-a2a)
+- [Environment Variables](#environment-variables)
+- [Deployment](#deployment)
+- [Safety Model](#safety-model)
+- [Concepts](#concepts)
+- [License](#license)
+
+---
+
+## Overview
+
+**Dockerhub Api** is a production-grade Agent and Model Context Protocol (MCP) server
+that wraps the official **Docker Hub API v2** (`https://hub.docker.com`): repositories
+and tags, immutable tags, personal and organization access tokens, organization
+members/settings/invites, teams, audit logs, and SCIM 2.0 provisioning.
+
+---
+
+## Key Features
+
+- **Consolidated Action-Routed MCP Tools:** Seven togglable tool modules
+  (`hub_auth`, `hub_repos`, `hub_org`, `hub_teams`, `hub_audit`, `hub_scim`,
+  `hub_admin`) minimize token overhead in LLM contexts.
+- **JWT Auth Lifecycle:** Short-lived bearer minted from `POST /v2/auth/token`
+  (password, PAT `dckr_pat_*`, or org access token), cached and refreshed before
+  expiry, with one transparent re-mint on 401.
+- **Rate-Limit Telemetry:** `X-RateLimit-*` headers surfaced in every result;
+  HTTP 429 retried with bounded `Retry-After` backoff.
+- **Safety by Default:** Deletes and org-settings writes are gated behind
+  `DOCKERHUB_ALLOW_DESTRUCTIVE` (default `False`); secrets are redacted from tool
+  results (plaintext tokens appear exactly once — on creation). Repository creation
+  stays enabled: it is the primary release-provisioning use case.
+- **Integrated Graph Agent:** Built-in Pydantic AI agent (`dockerhub-agent`) with
+  A2A and AG-UI web interfaces.
+- **Native Telemetry & Tracing:** Out-of-the-box OpenTelemetry exports and Langfuse
+  tracing via agent-utilities.
+
+---
+
+## Installation
+
+```bash
+pip install dockerhub-api            # API client only
+pip install "dockerhub-api[mcp]"     # + MCP server
+pip install "dockerhub-api[agent]"   # + A2A agent server
+pip install "dockerhub-api[all]"     # everything
+```
+
+| Extra | Adds |
+|---|---|
+| `mcp` | FastMCP server (`dockerhub-mcp`) via `agent-utilities[mcp]` |
+| `agent` | Pydantic-AI A2A agent (`dockerhub-agent`) + Logfire via `agent-utilities[agent,logfire]` |
+| `all` | `mcp` + `agent` |
+| `test` | pytest toolchain for development |
+
+Or pull the published image:
+
+```bash
+docker pull knucklessg1/dockerhub-api:latest
+```
+
+---
+
+## Usage
+
+### Python API / CLI
+
+```python
+from dockerhub_api.auth import get_client
+
+api = get_client()   # reads DOCKERHUB_URL / DOCKER_HUB_USER / DOCKER_HUB_TOKEN
+
+repos = api.get_repositories(namespace="acme", ordering="-last_updated")
+api.create_repository(namespace="acme", name="release-images", is_private=True)
+tags = api.get_repository_tags(namespace="acme", repository="release-images")
+print(api.rate_limit)   # latest X-RateLimit-* snapshot
+```
+
+Every client method returns a uniform envelope:
+`{"status_code": int, "data": ..., "rate_limit": {"limit", "remaining", "reset"}}`.
+
+### MCP
+
+#### Available MCP Tools
+
+| Tool Module | Toggle Env Var | Enabled by Default | Description & Nested Actions |
+|---|---|---|---|
+| `hub_auth` | `AUTHTOOL` | True | Token lifecycle: `create_token`, `login` (deprecated), `two_factor_login`, `list_pats`, `create_pat`, `get_pat`, `update_pat`, `delete_pat`, `list_oats`, `create_oat`, `get_oat`, `update_oat`, `delete_oat` |
+| `hub_repos` | `REPOSTOOL` | True | Repositories & tags: `list`, `create`, `get`, `check`, `list_tags`, `check_tags`, `get_tag`, `check_tag`, `set_immutable_tags`, `verify_immutable_tags`, `assign_group` |
+| `hub_org` | `ORGTOOL` | True | Org admin: `get_settings`, `update_settings`, `list_members`, `export_members`, `update_member`, `remove_member`, `list_invites`, `delete_invite`, `resend_invite`, `bulk_invite` |
+| `hub_teams` | `TEAMSTOOL` | True | Teams: `list`, `create`, `get`, `update`, `patch`, `delete`, `list_members`, `add_member`, `remove_member` |
+| `hub_audit` | `AUDITTOOL` | True | Audit trail: `logs`, `actions` |
+| `hub_scim` | `SCIMTOOL` | True | SCIM 2.0: `service_provider_config`, `resource_types`, `resource_type`, `schemas`, `schema`, `list_users`, `get_user`, `create_user`, `update_user` |
+| `hub_admin` | `ADMINTOOL` | True | Diagnostics: `rate_limit`, `whoami` (local JWT introspection) |
+
+Run the server:
+
+```bash
+export DOCKER_HUB_USER=youruser
+export DOCKER_HUB_TOKEN=dckr_pat_xxx
+dockerhub-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+### Agent (A2A)
+
+```bash
+dockerhub-agent --mcp-url http://localhost:8000/mcp --web
+```
+
+---
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `DOCKERHUB_URL` | `https://hub.docker.com` | Docker Hub API base URL |
+| `DOCKER_HUB_USER` | — | Account identifier (official hub-tool name, primary) |
+| `DOCKER_HUB_TOKEN` | — | Password, PAT `dckr_pat_*`, or org access token (primary) |
+| `DOCKERHUB_USERNAME` / `DOCKERHUB_TOKEN` | — | Legacy fallback aliases for the two above |
+| `DOCKERHUB_JWT` | — | Optional pre-minted bearer (overrides credential exchange) |
+| `DOCKERHUB_SSL_VERIFY` | `True` | TLS certificate verification |
+| `DOCKERHUB_ALLOW_DESTRUCTIVE` | `False` | Enable deletes and org-settings writes |
+| `AUTHTOOL` … `ADMINTOOL` | `True` | Per-module MCP tool toggles (see table above) |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind & transport (`stdio`, `streamable-http`, `sse`) |
+| `AUTH_TYPE` | `none` | MCP server auth mode (Docker image) |
+| `MCP_URL` | — | MCP endpoint the A2A agent connects to |
+| `ENABLE_OTEL` | `True` | OpenTelemetry / Langfuse export via agent-utilities |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` / `EUNOMIA_REMOTE_URL` | `none` / `mcp_policies.json` / — | Eunomia access-governance middleware |
+| `FASTMCP_LOG_LEVEL` / `NO_COLOR` | — | FastMCP logging controls |
+
+A complete annotated template lives in [.env.example](.env.example).
+
+---
+
+## Deployment
+
+Docker Compose definitions ship in [docker/](docker/):
+
+```bash
+cp .env.example .env       # fill in DOCKER_HUB_USER / DOCKER_HUB_TOKEN
+docker compose -f docker/mcp.compose.yml up -d     # MCP server only
+docker compose -f docker/agent.compose.yml up -d   # MCP server + A2A agent (port 9018)
+```
+
+Both services expose `/health` endpoints; see
+[docs/deployment.md](docs/deployment.md) for transports, Caddy ingress, and
+Technitium DNS guidance.
+
+---
+
+## Safety Model
+
+| Operation class | Default | Override |
+|---|---|---|
+| Reads (repos, tags, members, logs, SCIM) | allowed | — |
+| Repository create / immutable-tag config / invites / role updates | allowed | — |
+| Deletes (PATs, OATs, groups, members, invites) | **blocked** | `DOCKERHUB_ALLOW_DESTRUCTIVE=True` |
+| Org-settings writes (`PUT /v2/orgs/{org}/settings`) | **blocked** | `DOCKERHUB_ALLOW_DESTRUCTIVE=True` |
+
+---
+
+## Concepts
+
+The concept registry (`CONCEPT:HUB-1.x`) is documented in
+[docs/concepts.md](docs/concepts.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

dockerhub_api-0.1.0/README.md

@@ -0,0 +1,200 @@
+# Dockerhub Api
+## CLI or API | MCP | Agent
+
+![PyPI - Version](https://img.shields.io/pypi/v/dockerhub-api)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - Downloads](https://img.shields.io/pypi/dd/dockerhub-api)
+![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/dockerhub-api)
+![PyPI - License](https://img.shields.io/pypi/l/dockerhub-api)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/dockerhub-api)
+![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/dockerhub-api)
+![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/dockerhub-api)
+![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/dockerhub-api)
+![PyPI - Wheel](https://img.shields.io/pypi/wheel/dockerhub-api)
+![PyPI - Implementation](https://img.shields.io/pypi/implementation/dockerhub-api)
+
+*Version: 0.1.0*
+
+> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
+> interfaces, the integrated A2A agent server, and guidance on the backing
+> Docker Hub platform are maintained in [docs/](docs/index.md).
+
+---
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Key Features](#key-features)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Python API / CLI](#python-api--cli)
+  - [MCP](#mcp)
+  - [Agent (A2A)](#agent-a2a)
+- [Environment Variables](#environment-variables)
+- [Deployment](#deployment)
+- [Safety Model](#safety-model)
+- [Concepts](#concepts)
+- [License](#license)
+
+---
+
+## Overview
+
+**Dockerhub Api** is a production-grade Agent and Model Context Protocol (MCP) server
+that wraps the official **Docker Hub API v2** (`https://hub.docker.com`): repositories
+and tags, immutable tags, personal and organization access tokens, organization
+members/settings/invites, teams, audit logs, and SCIM 2.0 provisioning.
+
+---
+
+## Key Features
+
+- **Consolidated Action-Routed MCP Tools:** Seven togglable tool modules
+  (`hub_auth`, `hub_repos`, `hub_org`, `hub_teams`, `hub_audit`, `hub_scim`,
+  `hub_admin`) minimize token overhead in LLM contexts.
+- **JWT Auth Lifecycle:** Short-lived bearer minted from `POST /v2/auth/token`
+  (password, PAT `dckr_pat_*`, or org access token), cached and refreshed before
+  expiry, with one transparent re-mint on 401.
+- **Rate-Limit Telemetry:** `X-RateLimit-*` headers surfaced in every result;
+  HTTP 429 retried with bounded `Retry-After` backoff.
+- **Safety by Default:** Deletes and org-settings writes are gated behind
+  `DOCKERHUB_ALLOW_DESTRUCTIVE` (default `False`); secrets are redacted from tool
+  results (plaintext tokens appear exactly once — on creation). Repository creation
+  stays enabled: it is the primary release-provisioning use case.
+- **Integrated Graph Agent:** Built-in Pydantic AI agent (`dockerhub-agent`) with
+  A2A and AG-UI web interfaces.
+- **Native Telemetry & Tracing:** Out-of-the-box OpenTelemetry exports and Langfuse
+  tracing via agent-utilities.
+
+---
+
+## Installation
+
+```bash
+pip install dockerhub-api            # API client only
+pip install "dockerhub-api[mcp]"     # + MCP server
+pip install "dockerhub-api[agent]"   # + A2A agent server
+pip install "dockerhub-api[all]"     # everything
+```
+
+| Extra | Adds |
+|---|---|
+| `mcp` | FastMCP server (`dockerhub-mcp`) via `agent-utilities[mcp]` |
+| `agent` | Pydantic-AI A2A agent (`dockerhub-agent`) + Logfire via `agent-utilities[agent,logfire]` |
+| `all` | `mcp` + `agent` |
+| `test` | pytest toolchain for development |
+
+Or pull the published image:
+
+```bash
+docker pull knucklessg1/dockerhub-api:latest
+```
+
+---
+
+## Usage
+
+### Python API / CLI
+
+```python
+from dockerhub_api.auth import get_client
+
+api = get_client()   # reads DOCKERHUB_URL / DOCKER_HUB_USER / DOCKER_HUB_TOKEN
+
+repos = api.get_repositories(namespace="acme", ordering="-last_updated")
+api.create_repository(namespace="acme", name="release-images", is_private=True)
+tags = api.get_repository_tags(namespace="acme", repository="release-images")
+print(api.rate_limit)   # latest X-RateLimit-* snapshot
+```
+
+Every client method returns a uniform envelope:
+`{"status_code": int, "data": ..., "rate_limit": {"limit", "remaining", "reset"}}`.
+
+### MCP
+
+#### Available MCP Tools
+
+| Tool Module | Toggle Env Var | Enabled by Default | Description & Nested Actions |
+|---|---|---|---|
+| `hub_auth` | `AUTHTOOL` | True | Token lifecycle: `create_token`, `login` (deprecated), `two_factor_login`, `list_pats`, `create_pat`, `get_pat`, `update_pat`, `delete_pat`, `list_oats`, `create_oat`, `get_oat`, `update_oat`, `delete_oat` |
+| `hub_repos` | `REPOSTOOL` | True | Repositories & tags: `list`, `create`, `get`, `check`, `list_tags`, `check_tags`, `get_tag`, `check_tag`, `set_immutable_tags`, `verify_immutable_tags`, `assign_group` |
+| `hub_org` | `ORGTOOL` | True | Org admin: `get_settings`, `update_settings`, `list_members`, `export_members`, `update_member`, `remove_member`, `list_invites`, `delete_invite`, `resend_invite`, `bulk_invite` |
+| `hub_teams` | `TEAMSTOOL` | True | Teams: `list`, `create`, `get`, `update`, `patch`, `delete`, `list_members`, `add_member`, `remove_member` |
+| `hub_audit` | `AUDITTOOL` | True | Audit trail: `logs`, `actions` |
+| `hub_scim` | `SCIMTOOL` | True | SCIM 2.0: `service_provider_config`, `resource_types`, `resource_type`, `schemas`, `schema`, `list_users`, `get_user`, `create_user`, `update_user` |
+| `hub_admin` | `ADMINTOOL` | True | Diagnostics: `rate_limit`, `whoami` (local JWT introspection) |
+
+Run the server:
+
+```bash
+export DOCKER_HUB_USER=youruser
+export DOCKER_HUB_TOKEN=dckr_pat_xxx
+dockerhub-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+### Agent (A2A)
+
+```bash
+dockerhub-agent --mcp-url http://localhost:8000/mcp --web
+```
+
+---
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `DOCKERHUB_URL` | `https://hub.docker.com` | Docker Hub API base URL |
+| `DOCKER_HUB_USER` | — | Account identifier (official hub-tool name, primary) |
+| `DOCKER_HUB_TOKEN` | — | Password, PAT `dckr_pat_*`, or org access token (primary) |
+| `DOCKERHUB_USERNAME` / `DOCKERHUB_TOKEN` | — | Legacy fallback aliases for the two above |
+| `DOCKERHUB_JWT` | — | Optional pre-minted bearer (overrides credential exchange) |
+| `DOCKERHUB_SSL_VERIFY` | `True` | TLS certificate verification |
+| `DOCKERHUB_ALLOW_DESTRUCTIVE` | `False` | Enable deletes and org-settings writes |
+| `AUTHTOOL` … `ADMINTOOL` | `True` | Per-module MCP tool toggles (see table above) |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind & transport (`stdio`, `streamable-http`, `sse`) |
+| `AUTH_TYPE` | `none` | MCP server auth mode (Docker image) |
+| `MCP_URL` | — | MCP endpoint the A2A agent connects to |
+| `ENABLE_OTEL` | `True` | OpenTelemetry / Langfuse export via agent-utilities |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` / `EUNOMIA_REMOTE_URL` | `none` / `mcp_policies.json` / — | Eunomia access-governance middleware |
+| `FASTMCP_LOG_LEVEL` / `NO_COLOR` | — | FastMCP logging controls |
+
+A complete annotated template lives in [.env.example](.env.example).
+
+---
+
+## Deployment
+
+Docker Compose definitions ship in [docker/](docker/):
+
+```bash
+cp .env.example .env       # fill in DOCKER_HUB_USER / DOCKER_HUB_TOKEN
+docker compose -f docker/mcp.compose.yml up -d     # MCP server only
+docker compose -f docker/agent.compose.yml up -d   # MCP server + A2A agent (port 9018)
+```
+
+Both services expose `/health` endpoints; see
+[docs/deployment.md](docs/deployment.md) for transports, Caddy ingress, and
+Technitium DNS guidance.
+
+---
+
+## Safety Model
+
+| Operation class | Default | Override |
+|---|---|---|
+| Reads (repos, tags, members, logs, SCIM) | allowed | — |
+| Repository create / immutable-tag config / invites / role updates | allowed | — |
+| Deletes (PATs, OATs, groups, members, invites) | **blocked** | `DOCKERHUB_ALLOW_DESTRUCTIVE=True` |
+| Org-settings writes (`PUT /v2/orgs/{org}/settings`) | **blocked** | `DOCKERHUB_ALLOW_DESTRUCTIVE=True` |
+
+---
+
+## Concepts
+
+The concept registry (`CONCEPT:HUB-1.x`) is documented in
+[docs/concepts.md](docs/concepts.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

dockerhub_api-0.1.0/dockerhub_api/__init__.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python
+
+import importlib
+import inspect
+from typing import Any
+
+__all__: list[str] = []
+
+CORE_MODULES: list[str] = [
+    "dockerhub_api.dockerhub_input_models",
+    "dockerhub_api.dockerhub_response_models",
+    "dockerhub_api.api_client",
+    "dockerhub_api.auth",
+]
+
+OPTIONAL_MODULES = {
+    "dockerhub_api.agent_server": "agent",
+    "dockerhub_api.mcp_server": "mcp",
+}
+
+
+def _expose_members(module):
+    """Expose public classes and functions from a module into globals and __all__."""
+    for name, obj in inspect.getmembers(module):
+        if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
+            "_"
+        ):
+            globals()[name] = obj
+            if name not in __all__:
+                __all__.append(name)
+
+
+# Eagerly import core modules (keeps API wrappers fast & light)
+for module_name in CORE_MODULES:
+    if module_name:
+        module = importlib.import_module(module_name)
+        _expose_members(module)
+
+# Dynamic/lazy loading of optional modules (agent_server, mcp_server)
+_loaded_optional_modules: dict[str, Any] = {}
+
+
+def _import_module_safely(module_name: str):
+    """Try to import a module and return it, or None if not available."""
+    try:
+        return importlib.import_module(module_name)
+    except ImportError:
+        return None
+
+
+def __getattr__(name: str) -> Any:
+    # Handle availability flags dynamically without eager imports
+    if name == "_MCP_AVAILABLE":
+        mcp_key = next((k for k in OPTIONAL_MODULES if "mcp_server" in k), None)
+        if mcp_key:
+            return _import_module_safely(mcp_key) is not None
+        return False
+    if name == "_AGENT_AVAILABLE":
+        agent_key = next((k for k in OPTIONAL_MODULES if "agent_server" in k), None)
+        if agent_key:
+            return _import_module_safely(agent_key) is not None
+        return False
+
+    # Check optional modules
+    for module_name in OPTIONAL_MODULES:
+        if module_name not in _loaded_optional_modules:
+            module = _import_module_safely(module_name)
+            if module is not None:
+                _loaded_optional_modules[module_name] = module
+                _expose_members(module)
+
+        module = _loaded_optional_modules.get(module_name)
+        if module is not None and hasattr(module, name):
+            return getattr(module, name)
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted(list(globals().keys()) + __all__)

dockerhub_api-0.1.0/dockerhub_api/__main__.py

@@ -0,0 +1,4 @@
+from dockerhub_api.agent_server import agent_server
+
+if __name__ == "__main__":
+    agent_server()

dockerhub_api-0.1.0/dockerhub_api/agent_server.py

@@ -0,0 +1,92 @@
+#!/usr/bin/python
+"""Docker Hub A2A agent server.
+
+CONCEPT:HUB-1.6 — A2A agent server. A Pydantic-AI graph agent over the
+Docker Hub MCP tool surface, exposed via agent-utilities'
+``create_agent_server`` (A2A + AG-UI web interface).
+"""
+
+import logging
+import os
+import sys
+import warnings
+
+__version__ = "0.1.0"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    handlers=[logging.StreamHandler()],
+)
+logger = logging.getLogger(__name__)
+
+
+DEFAULT_AGENT_NAME = None
+DEFAULT_AGENT_DESCRIPTION = None
+DEFAULT_AGENT_SYSTEM_PROMPT = None
+
+
+def agent_server():
+    from agent_utilities import (
+        build_system_prompt_from_workspace,
+        create_agent_parser,
+        create_agent_server,
+        initialize_workspace,
+        load_identity,
+    )
+
+    global DEFAULT_AGENT_NAME, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_SYSTEM_PROMPT
+    initialize_workspace()
+    meta = load_identity()
+    DEFAULT_AGENT_NAME = os.getenv(
+        "DEFAULT_AGENT_NAME", meta.get("name", "Dockerhub Api")
+    )
+    DEFAULT_AGENT_DESCRIPTION = os.getenv(
+        "AGENT_DESCRIPTION",
+        meta.get(
+            "description",
+            "AI agent for Docker Hub management.",
+        ),
+    )
+    DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
+        "AGENT_SYSTEM_PROMPT",
+        meta.get("content") or build_system_prompt_from_workspace(),
+    )
+
+    warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
+    warnings.filterwarnings("ignore", category=DeprecationWarning, module="fastmcp")
+
+    print(f"{DEFAULT_AGENT_NAME} v{__version__}", file=sys.stderr)
+    parser = create_agent_parser()
+    args = parser.parse_args()
+
+    if args.debug:
+        logging.getLogger().setLevel(logging.DEBUG)
+        logger.debug("Debug mode enabled")
+
+    # Start server using the auto-discovery pattern (from mcp_config.json)
+    create_agent_server(
+        mcp_url=args.mcp_url,
+        mcp_config=args.mcp_config or "mcp_config.json",
+        host=args.host,
+        port=args.port,
+        provider=args.provider,
+        model_id=args.model_id,
+        router_model=args.model_id,
+        agent_model=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        custom_skills_directory=args.custom_skills_directory,
+        enable_web_ui=args.web,
+        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,
+        debug=args.debug,
+    )
+
+
+if __name__ == "__main__":
+    agent_server()

dockerhub_api-0.1.0/dockerhub_api/api/__init__.py

@@ -0,0 +1 @@
+"""Per-domain Docker Hub API client mixins."""