hypermind 2.1.0__tar.gz → 2.1.5__tar.gz

{hypermind-2.1.0 → hypermind-2.1.5}/.github/workflows/release.yml

@@ -5,14 +5,6 @@ on:
     tags:
       - 'v*'
   workflow_dispatch:
-    inputs:
-      version:
-        description: >-
-          Version tag to publish (e.g. v2.1.0). Only used when this workflow
-          is run manually instead of by a tag push — TEMPORARY escape hatch,
-          revert once the tag-push path is available again.
-        required: true
-        type: string
 
 permissions:
   contents: read
@@ -168,7 +160,7 @@ jobs:
     name: publish → PyPI
     runs-on: ubuntu-latest
     needs: build
-    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+    if: startsWith(github.ref, 'refs/tags/v')
     environment:
       name: pypi
       url: https://pypi.org/p/hypermind
@@ -241,22 +233,12 @@ jobs:
     name: docker — hub.docker.com/openworkbench/hypermind
     runs-on: ubuntu-latest
     needs: build
-    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+    if: startsWith(github.ref, 'refs/tags/v')
     permissions:
       contents: read
     steps:
       - uses: actions/checkout@v4
 
-      - name: resolve release tag
-        id: reltag
-        run: |
-          set -euo pipefail
-          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
-            echo "tag=${{ github.event.inputs.version }}" >> "$GITHUB_OUTPUT"
-          else
-            echo "tag=${{ github.ref_name }}" >> "$GITHUB_OUTPUT"
-          fi
-
       - name: set up QEMU (multi-arch)
         uses: docker/setup-qemu-action@v3
 
@@ -283,7 +265,7 @@ jobs:
           platforms: linux/amd64,linux/arm64
           tags: |
             openworkbench/hypermind:latest
-            openworkbench/hypermind:${{ steps.reltag.outputs.tag }}
+            openworkbench/hypermind:${{ github.ref_name }}
             openworkbench/hypermind:${{ steps.sha.outputs.short }}
           cache-from: type=gha
           cache-to: type=gha,mode=max

{hypermind-2.1.0 → hypermind-2.1.5}/CHANGELOG.md

@@ -14,6 +14,47 @@ changes only on major-version bumps.
 
 ## [Unreleased]
 
+## [2.1.5] — 2026-07-27
+
+### Changed
+- `hmctl eval` HTML report: professional dark-theme redesign (Inter + JetBrains Mono, dark palette, leaderboard cards, sticky tables, category pills, print-friendly)
+
+## [2.1.4] — 2026-07-27
+
+### Added
+- `hmctl eval` — 9-category IEEE-defensible benchmark (18 questions × 4 models)
+- Categories: Domain Knowledge, Hallucination Trap, Adversarial, OOD, Distributional Bias, Temporal Drift, Factual Friction, Confidence Calibration, Specificity
+- Auto-seed via `/v1/hm/publish` before eval
+- Category breakdown, calibration analysis, per-question comparison in HTML report
+- How-Each-Model-Works architecture table + MoA two-phase diagram
+
+## [2.1.3] — 2026-07-27
+
+### Added
+- `hmctl eval run` — research-grade HTML benchmark across all 4 models (hm-network, hm-corpus, hm-moa, hm-direct)
+- 5-question curated set: Domain Knowledge, Hallucination Trap, Adversarial categories
+- Self-contained HTML report: leaderboard, confidence bars, use-case matrix, model reference cards
+
+## [2.1.2] — 2026-07-27
+
+### Added
+- **`hmctl serve-endpoint` LLM responder auto-wiring**: auto-detects `OPENAI_API_KEY` / `OPENAI_BASE_URL` / `HYPERMIND_LLM_MODEL` from env and wires `OpenAIResponder` at startup — all three models (`hm-network`, `hm-corpus`, `hm-moa`) now generate real LLM rationale when a key is present. Falls back to reputation-only with a warning when no key is set.
+- **`--system-prompt` flag on `serve-endpoint`**: default scopes every panel member to swarm-verified knowledge and prefixes answers with `"HyperMind says — "`. Override with `--system-prompt "..."` per invocation.
+- **`"HyperMind says — "` response prefix**: all `/v1/chat/completions` responses (streaming and non-streaming) are now prefixed, making it clear answers come from the HyperMind swarm.
+
+### Fixed
+- Docker `CMD`: `hmctl mcp serve` now explicitly passes `--write --log-level info` — connections and tool calls are visible in `docker logs` output.
+
+## [2.1.1] — 2026-07-27
+
+### Added
+- **Web search result capture** (#973): agents now fetch every search result URL (previously capped at 3), convert HTML to clean markdown via `trafilatura` (strips nav/ads/footers), and store in Relata `/memory/remember` under `{agent_id}/web-search/{url_hash}` with full metadata. Each page is linked to its originating claim via `associate("source_for")`. Future rounds can recall full page content via `/memory/recall` instead of snippets only. `trafilatura>=1.6` added to the `[ingest]` optional extra; falls back to bs4 then skips gracefully.
+- **`hmctl status` endpoint panel**: a dedicated always-visible panel shows HyperMind's OpenAI-compatible endpoint URL, connection snippet, all models with descriptions, and all routes — turns green when live.
+- **`GET /v1/models` spec compliance**: response now includes `created` (Unix timestamp) alongside `id`, `object`, `owned_by`, and `description` — fully OpenAI-spec-compliant.
+
+### Fixed
+- Docker: `hmctl mcp serve` env file no longer overrides compose-set env vars (e.g. `RELATA_URL`) — process env takes priority over `/data/env` file values.
+
 ## [2.1.0] — 2026-07-27
 
 ### Added

{hypermind-2.1.0 → hypermind-2.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypermind
-Version: 2.1.0
+Version: 2.1.5
 Summary: Federated agent intelligence — reference SDK for the HyperMind SCITT contested-claims profile
 Project-URL: Homepage, https://github.com/ZySec-AI/hypermind
 Project-URL: Documentation, https://github.com/ZySec-AI/hypermind/tree/main/docs
@@ -55,6 +55,7 @@ Provides-Extra: ingest
 Requires-Dist: beautifulsoup4>=4.12; extra == 'ingest'
 Requires-Dist: pypdf>=4.0; extra == 'ingest'
 Requires-Dist: python-docx>=1.0; extra == 'ingest'
+Requires-Dist: trafilatura>=1.6; extra == 'ingest'
 Provides-Extra: libp2p
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0; extra == 'mcp'

{hypermind-2.1.0 → hypermind-2.1.5}/deploy/Dockerfile

@@ -60,4 +60,4 @@ EXPOSE 8484 8766
 #   OPENAI_BASE_URL=http://...     # local model (Ollama etc.)
 #   HYPERMIND_LLM_MODEL=gpt-4o
 #   RELATA_URL=http://relata:9090  # optional durable ledger
-CMD ["hmctl", "mcp", "serve"]
+CMD ["hmctl", "mcp", "serve", "--write", "--log-level", "info"]

{hypermind-2.1.0 → hypermind-2.1.5}/deploy/Dockerfile.mcp

@@ -16,4 +16,4 @@ VOLUME ["/config"]
 # TCP MCP (multi-user JSON-RPC), SSE dashboard
 EXPOSE 8484 8766
 
-CMD ["hmctl", "mcp", "serve", "--config", "/config/mcp.toml"]
+CMD ["hmctl", "mcp", "serve", "--config", "/config/mcp.toml", "--write", "--log-level", "info"]

{hypermind-2.1.0 → hypermind-2.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypermind"
-version = "2.1.0"
+version = "2.1.5"
 description = "Federated agent intelligence — reference SDK for the HyperMind SCITT contested-claims profile"
 readme = "README.md"
 requires-python = ">=3.12,<3.15"
@@ -83,6 +83,8 @@ ingest = [
     "pypdf>=4.0",
     "python-docx>=1.0",
     "beautifulsoup4>=4.12",
+    # #973: web page fetch + markdown conversion for search result capture.
+    "trafilatura>=1.6",
 ]
 vector = [
     # #854: local (in-process, no external embedding service) semantic

{hypermind-2.1.0 → hypermind-2.1.5}/src/hmctl/cli.py

@@ -63,6 +63,11 @@ from hmctl.orgs_cmd import orgs as _orgs_group
 
 main.add_command(_orgs_group, name="orgs")
 
+# `hmctl eval …` — benchmark HyperMind models, output HTML comparison table.
+from hmctl.eval_cmd import eval_group as _eval_group
+
+main.add_command(_eval_group, name="eval")
+
 
 @main.command()
 @click.option(
@@ -516,7 +521,8 @@ def status_cmd(as_json: bool) -> None:
 
     otel_ep = _os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "")
     db_path = _os.environ.get("HYPERMIND_DB", "")
-    openai_key = bool(_os.environ.get("OPENAI_API_KEY"))
+    openai_key_raw = _os.environ.get("OPENAI_API_KEY", "")
+    openai_key = bool(openai_key_raw)
     anthropic_key = bool(_os.environ.get("ANTHROPIC_API_KEY"))
     base_url = _os.environ.get("OPENAI_BASE_URL", "")
     llm_model = _os.environ.get("HYPERMIND_LLM_MODEL", "")
@@ -541,6 +547,41 @@ def status_cmd(as_json: bool) -> None:
             "  # Ollama (no key): OPENAI_BASE_URL=http://localhost:11434/v1"
         )
 
+    # HyperMind's own OpenAI-compatible endpoint (hmctl serve-endpoint)
+    _hm_api_host = _os.environ.get("HYPERMIND_API_HOST", "127.0.0.1")
+    _hm_api_port = int(_os.environ.get("HYPERMIND_API_PORT", "8899"))
+    _hm_api_url = f"http://{_hm_api_host}:{_hm_api_port}/v1"
+    # probe if it's actually running
+    try:
+        import socket as _sock
+
+        _s = _sock.socket()
+        _s.settimeout(0.5)
+        _s.connect((_hm_api_host, _hm_api_port))
+        _s.close()
+        _hm_api_running = True
+    except Exception:
+        _hm_api_running = False
+    if _hm_api_running:
+        _oai_ok = True
+        _oai_detail = (
+            f"[bold]{_hm_api_url}[/bold]  (live)\n"
+            f"  POST /v1/chat/completions  GET /v1/models  GET /healthz\n"
+            f"  models: hm-network, hm-corpus, hm-moa\n"
+            f"  client = OpenAI(base_url='{_hm_api_url}', api_key='hm')"
+        )
+        _oai_fix = ""
+    else:
+        _oai_ok = False
+        _oai_detail = (
+            f"{_hm_api_url}  (not running)\n"
+            f"  POST /v1/chat/completions backed by reputation-weighted swarm\n"
+            f"  models: hm-network, hm-corpus, hm-moa"
+        )
+        _oai_fix = (
+            "hmctl serve-endpoint --host 0.0.0.0 --port 8899  # pip install 'hypermind[api]' first"
+        )
+
     rows = [
         # (feature, ok, detail, fix)
         (
@@ -552,6 +593,7 @@ def status_cmd(as_json: bool) -> None:
             f"touch {_HM_HOME}/env  # one KEY=VALUE per line",
         ),
         ("llm", llm_ok, llm_note, llm_fix),
+        ("openai_endpoint", _oai_ok, _oai_detail, _oai_fix),
         (
             "relata",
             *(
@@ -681,6 +723,49 @@ def status_cmd(as_json: bool) -> None:
 
     console.print(table)
 
+    # OpenAI-compatible endpoint connection panel — always shown
+    from rich.panel import Panel
+
+    _ep_models = (
+        "  [bold]hm-network[/bold]  Live reputation-weighted swarm consult — best for open questions\n"
+        "  [bold]hm-corpus [/bold]  Query learned knowledge from past research runs (no LLM calls)\n"
+        "  [bold]hm-moa    [/bold]  Mixture-of-Agents: proposer fan-out → aggregation (highest quality)"
+    )
+    if _hm_api_running:
+        _ep_status = "[green]● LIVE[/green]"
+        _ep_snippet = (
+            f"[bold]base_url[/bold] = [cyan]{_hm_api_url}[/cyan]   [bold]api_key[/bold] = [dim]'hm'[/dim] [dim](any string)[/dim]\n\n"
+            f"[dim]Python:[/dim]  from openai import OpenAI\n"
+            f"          client = OpenAI(base_url=[cyan]'{_hm_api_url}'[/cyan], api_key=[cyan]'hm'[/cyan])\n"
+            f"          client.chat.completions.create(model=[cyan]'hm-network'[/cyan], messages=[...])\n\n"
+            f"[dim]curl:  [/dim]  curl {_hm_api_url}/chat/completions \\\n"
+            f"            -H 'Content-Type: application/json' \\\n"
+            f'            -d \'{{"model":"hm-network","messages":[{{"role":"user","content":"your question"}}]}}\'\n\n'
+            f"[bold]Models:[/bold]\n{_ep_models}\n\n"
+            f"[dim]Routes:[/dim]  POST /v1/chat/completions · GET /v1/models · GET /healthz\n"
+            f"          POST /v1/hm/publish · POST /v1/hm/ask · GET /v1/hm/agents · GET /v1/hm/reputation"
+        )
+    else:
+        _ep_status = "[yellow]● NOT RUNNING[/yellow]"
+        _ep_snippet = (
+            f"[bold]base_url[/bold] = [cyan]{_hm_api_url}[/cyan]   [bold]api_key[/bold] = [dim]'hm'[/dim] [dim](any string)[/dim]\n\n"
+            f"[dim]Python:[/dim]  from openai import OpenAI\n"
+            f"          client = OpenAI(base_url=[cyan]'{_hm_api_url}'[/cyan], api_key=[cyan]'hm'[/cyan])\n"
+            f"          client.chat.completions.create(model=[cyan]'hm-network'[/cyan], messages=[...])\n\n"
+            f"[bold]Models:[/bold]\n{_ep_models}\n\n"
+            f"[dim]Routes:[/dim]  POST /v1/chat/completions · GET /v1/models · GET /healthz\n"
+            f"          POST /v1/hm/publish · POST /v1/hm/ask · GET /v1/hm/agents · GET /v1/hm/reputation\n\n"
+            f"[yellow]▶ Start:[/yellow]  hmctl serve-endpoint --host 0.0.0.0 --port {_hm_api_port}"
+        )
+    console.print(
+        Panel(
+            _ep_snippet,
+            title=f"[bold]HyperMind OpenAI-compatible endpoint[/bold]  {_ep_status}",
+            border_style="green" if _hm_api_running else "yellow",
+            padding=(1, 2),
+        )
+    )
+
     # MCP servers panel
     if _mcp_servers:
         from rich.table import Table as _Table
@@ -1283,7 +1368,7 @@ def conformance(verify: bool) -> None:
         sys.exit(1)
 
 
-@main.command("eval")
+@main.command("eval-suite")
 @click.option(
     "--vectors",
     type=click.Path(exists=True, dir_okay=False, readable=True),
@@ -1314,7 +1399,7 @@ def conformance(verify: bool) -> None:
     default=None,
     help="Annotation only: deliberation rounds used in this run (recorded in the report).",
 )
-def eval_cmd(
+def eval_suite_cmd(
     vectors: str | None,
     namespace: str,
     output_path: str | None,
@@ -2314,12 +2399,22 @@ def claims_list_cmd(topic: str | None, limit: int, room: str) -> None:
     console.print(table)
 
 
+_DEFAULT_SYSTEM_PROMPT = (
+    "You are HyperMind — a federated agent intelligence network. "
+    "Answer only from what the HyperMind swarm knows. "
+    "Prefix every answer with 'HyperMind says — ' and stay within swarm-verified knowledge."
+)
+
+
 @main.command("serve-endpoint")
 @click.option("--host", default="127.0.0.1")
 @click.option("--port", type=int, default=8899)
 @click.option("--swarm", type=int, default=3)
-def serve_endpoint_cmd(host: str, port: int, swarm: int) -> None:
+@click.option("--system-prompt", default=None, help="Override default HyperMind system prompt.")
+def serve_endpoint_cmd(host: str, port: int, swarm: int, system_prompt: str | None) -> None:
     """Serve an OpenAI-compatible /v1/chat/completions backed by the HM network."""
+    import os as _os_ep
+
     try:
         import uvicorn
     except ImportError:
@@ -2329,7 +2424,36 @@ def serve_endpoint_cmd(host: str, port: int, swarm: int) -> None:
     from hypermind.integrations import HyperMindClient
     from hypermind.integrations.openai_endpoint import create_app
 
-    client = HyperMindClient.sandbox(swarm=swarm)
+    _prompt = system_prompt or _DEFAULT_SYSTEM_PROMPT
+
+    # Auto-wire OpenAI-compatible responder from env
+    responder = None
+    _api_key = _os_ep.environ.get("OPENAI_API_KEY", "")
+    _base_url = _os_ep.environ.get("OPENAI_BASE_URL", "")
+    _model = _os_ep.environ.get("HYPERMIND_LLM_MODEL", "gpt-4o-mini")
+    if _api_key:
+        try:
+            from openai import AsyncOpenAI
+
+            from hypermind.responders import OpenAIResponder
+
+            responder = OpenAIResponder(
+                client=AsyncOpenAI(api_key=_api_key, base_url=_base_url or None),
+                model=_model,
+                system_prompt=_prompt,
+            )
+            console.print(
+                f"[green]✓[/] LLM responder: [bold]{_model}[/]"
+                + (f"  via {_base_url}" if _base_url else "")
+            )
+        except ImportError:
+            console.print("[yellow]~ openai package not installed — reputation-only mode[/]")
+    else:
+        console.print(
+            "[yellow]~ No OPENAI_API_KEY — reputation-only (set key for LLM rationale)[/]"
+        )
+
+    client = HyperMindClient.sandbox(swarm=swarm, responder=responder)
     console.print(
         f"[bold]HyperMind endpoint[/] on http://{host}:{port}/v1  "
         f"(model: hm-network) — point any OpenAI-compatible base_url here"
@@ -3085,7 +3209,7 @@ def mcp_serve_cmd(
                         continue
                     _hek, _, _hev = _heline.partition("=")
                     _hek = _hek.strip()
-                    if _hek:
+                    if _hek and _hek not in _os_serve.environ:
                         _os_serve.environ[_hek] = _hev.strip()
 
         async def _resolve_tcp_port(host: str, port: int) -> int | None: