hypermind 0.11.0__py3-none-any.whl

hypermind/testing.py

@@ -0,0 +1,16 @@
+"""Test-only utilities — not part of the production surface.
+
+These helpers exist to make integration tests of HyperMind-backed
+applications easy. They are guaranteed-stable for testing but should
+not appear in production code paths.
+
+As of v0.5 (ROADMAP §0.5.4) ``testbed_cohort`` is canonically rooted
+here. The top-level re-export (``hypermind.testbed_cohort``) is now a
+deprecation shim that fires ``PendingDeprecationWarning`` on attribute
+lookup and forwards to this module. The shim escalates to
+``DeprecationWarning`` in v0.7 and is scheduled for removal in v1.0.
+"""
+
+from hypermind.agent import HyperMindAgent, testbed_cohort
+
+__all__ = ["HyperMindAgent", "testbed_cohort"]

hypermind/tools/__init__.py

@@ -0,0 +1,32 @@
+"""First-class HyperMind tool registry — promoted from
+:mod:`hypermind.simlab.tool_registry` to a public API surface (T1-02).
+
+The simlab module continues to own the canonical catalog and on-disk
+activation lifecycle; this package re-exports the relevant types and
+adds an MCP-server view helper (:func:`mcp_view`) used by
+:class:`hypermind.mcp.MCPServer` to publish a tool list.
+"""
+
+from hypermind.tools.registry import (
+    TOOL_CATALOG,
+    ActivatedTool,
+    ToolDef,
+    get_activated_tool,
+    get_tool_def,
+    list_active_tool_slugs,
+    list_catalog,
+    load_activated_tools,
+    mcp_view,
+)
+
+__all__ = [
+    "TOOL_CATALOG",
+    "ActivatedTool",
+    "ToolDef",
+    "get_activated_tool",
+    "get_tool_def",
+    "list_active_tool_slugs",
+    "list_catalog",
+    "load_activated_tools",
+    "mcp_view",
+]

hypermind/tools/registry.py

@@ -0,0 +1,61 @@
+"""Re-exports of the canonical tool registry plus an MCP view helper.
+
+The original implementation lives in :mod:`hypermind.simlab.tool_registry`
+(SimLab needs disk persistence for activation records); v0.10.1 promotes
+the in-memory catalog and dataclasses to a first-class API under
+``hypermind.tools``. The simlab module is unchanged so its callers
+keep working.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from hypermind.simlab.tool_registry import (
+    TOOL_CATALOG,
+    ActivatedTool,
+    ToolDef,
+    get_activated_tool,
+    get_tool_def,
+    list_active_tool_slugs,
+    list_catalog,
+    load_activated_tools,
+)
+
+__all__ = [
+    "TOOL_CATALOG",
+    "ActivatedTool",
+    "ToolDef",
+    "get_activated_tool",
+    "get_tool_def",
+    "list_active_tool_slugs",
+    "list_catalog",
+    "load_activated_tools",
+    "mcp_view",
+]
+
+
+def mcp_view(
+    catalog: dict[str, ToolDef] | None = None,
+    *,
+    only_slugs: list[str] | None = None,
+) -> list[dict[str, Any]]:
+    """Render a tool registry as an MCP ``tools/list`` payload.
+
+    The returned list of dicts is shaped per the MCP v1.0 schema
+    (``name`` / ``description`` / ``inputSchema``). When ``only_slugs``
+    is supplied, only those tools are emitted (in the requested order).
+    """
+    cat = catalog if catalog is not None else TOOL_CATALOG
+    if only_slugs is not None:
+        items = [cat[s] for s in only_slugs if s in cat]
+    else:
+        items = list(cat.values())
+    return [
+        {
+            "name": t.slug,
+            "description": t.description,
+            "inputSchema": t.parameters_schema,
+        }
+        for t in items
+    ]

hypermind/transport/__init__.py

@@ -0,0 +1,22 @@
+"""Transport layer.
+
+Two production-grade implementations of `GossipBus`:
+  - `InProcessBus`: zero-network for unit tests and CI.
+  - `TCPGossipBus`: real asyncio TCP gossipsub-shape with identity-bound
+    handshake and topic fan-out.
+"""
+
+from hypermind.transport.anti_entropy import AESession, BloomFilter, build_filter, diff
+from hypermind.transport.bus import GossipBus, InProcessBus, Subscription
+from hypermind.transport.tcp import TCPGossipBus
+
+__all__ = [
+    "AESession",
+    "BloomFilter",
+    "GossipBus",
+    "InProcessBus",
+    "Subscription",
+    "TCPGossipBus",
+    "build_filter",
+    "diff",
+]