nlalpha-capability 0.2.0__tar.gz → 0.3.1__tar.gz

{nlalpha_capability-0.2.0 → nlalpha_capability-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nlalpha-capability
-Version: 0.2.0
+Version: 0.3.1
 Summary: NLAlpha capability discovery MCP server.
 Project-URL: Homepage, https://github.com/ruimarj/nlalpha-capability
 Project-URL: Repository, https://github.com/ruimarj/nlalpha-capability
@@ -9,7 +9,7 @@ License-Expression: AGPL-3.0-or-later
 License-File: LICENSE
 Requires-Python: <3.13,>=3.12
 Requires-Dist: mcp<2.0,>=1.6.0
-Requires-Dist: nlalpha-core[json-log,telemetry]>=0.7.0
+Requires-Dist: nlalpha-core[json-log,telemetry]>=0.7.1
 Requires-Dist: starlette>=0.37
 Requires-Dist: uvicorn>=0.30
 Description-Content-Type: text/markdown

{nlalpha_capability-0.2.0 → nlalpha_capability-0.3.1}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nlalpha-capability"
-version = "0.2.0"
+version = "0.3.1"
 description = "NLAlpha capability discovery MCP server."
 readme = "README.md"
 license = "AGPL-3.0-or-later"
 license-files = ["LICENSE"]
 requires-python = ">=3.12,<3.13"
 dependencies = [
-    "nlalpha-core[telemetry,json-log]>=0.7.0",
+    "nlalpha-core[telemetry,json-log]>=0.7.1",
     "mcp>=1.6.0,<2.0",
     "uvicorn>=0.30",
     "starlette>=0.37",

{nlalpha_capability-0.2.0 → nlalpha_capability-0.3.1}/src/nlalpha_capability/server.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 from contextlib import asynccontextmanager
 from dataclasses import asdict
 from importlib.metadata import version
@@ -26,24 +27,46 @@ from nlalpha.core.telemetry import configure_telemetry, shutdown, get_meter, set
 
 logger = logging.getLogger("nlalpha-capability")
 
+
+@asynccontextmanager
+async def _session_manager_lifespan(mcp):
+    stop = asyncio.Event()
+    started = asyncio.Event()
+
+    async def run():
+        async with mcp.session_manager.run():
+            started.set()
+            await stop.wait()
+
+    task = asyncio.create_task(run())
+    task.add_done_callback(lambda _: started.set())
+    await started.wait()
+    if task.done():
+        task.result()
+    try:
+        yield
+    finally:
+        stop.set()
+        await task
+
 _meter = get_meter()
 _domains_counter = _meter.create_counter("nlalpha.capability.domains.listed")
 _helpers_histogram = _meter.create_histogram("nlalpha.capability.helpers.count")
 
 
 def about(sections: list[str] | None = None) -> dict[str, Any]:
-    """Describe the capability service, installed providers, helper domains, and families."""
+    """Start here: describe installed providers, helper domains, families, and diagnostics; task workflows use the strategy service's list_skills and load_skill."""
     with start_span("mcp.about"):
         try:
             return describe_document("service", "nlalpha-capability", "nlalpha-capability", version("nlalpha-capability"), {
                 "principles": common_description(),
                 "navigation": {
-                    "about": "Read this service's shared principles and installed capability directory.",
+                    "about": "Start here: read shared principles, installed capability providers, and helper domains.",
                     "list_capability_providers": "Discover selectable capability providers and their installed identities.",
                     "list_capability_domains": "Discover domains from actual available helper declarations.",
                     "list_capabilities_by_domain": "Read available helpers in a selected helper domain.",
                     "list_family_helpers": "Read helpers from the same cached family contract used by strategy validation.",
-                    "confess": "Read a provider's manifest, methods, helpers, and declared guidance.",
+                    "confess": "Read a provider's manifest, methods, helpers, and guidance before using its capabilities.",
                     "diagnose_providers": "Inspect installed providers or families that failed discovery or are unavailable.",
                 },
                 "providers": CapabilityPluginRegistry.list_provider_records(),
@@ -56,7 +79,7 @@ def about(sections: list[str] | None = None) -> dict[str, Any]:
 
 
 def confess(provider_id: str, sections: list[str] | None = None) -> dict[str, Any]:
-    """Describe a cached provider from its manifest, helpers, and required declared material."""
+    """Read a cached provider's manifest, helpers, and guidance before using its capabilities."""
     with start_span("mcp.confess", attributes={"provider_id": provider_id}):
         try:
             record = CapabilityPluginRegistry.get_record(provider_id)
@@ -182,24 +205,34 @@ async def _health(request):
 def create_app(*, allowed_hosts: list[str] | tuple[str, ...] | None = None,
                on_shutdown: Callable[[], None] | None = None) -> Starlette:
     """Create an independent MCP transport with an explicit host allowlist."""
-    mcp = FastMCP("nlalpha-capability")
+    mcp = FastMCP(
+        "nlalpha-capability",
+        instructions=(
+            "NLAlpha capability MCP service. Start with `about` for navigation and `confess(provider_id)` "
+            "for provider semantics before using helpers. Task workflows are packaged as NLAlpha skills "
+            "in the strategy service: call `list_skills` then `load_skill` there when a workflow is "
+            "needed, one language per call."
+        ),
+    )
     mcp.settings.transport_security = TransportSecuritySettings(
         enable_dns_rebinding_protection=True, allowed_hosts=resolve_allowed_hosts(allowed_hosts),
     )
     for tool in (list_capability_domains, list_capabilities_by_domain, list_family_helpers,
                  list_capability_providers, diagnose_providers, about, confess):
         mcp.add_tool(tool)
+    http_app = mcp.streamable_http_app()
+
     @asynccontextmanager
     async def lifespan(app):
         """Invoke only the explicitly injected process cleanup on application shutdown."""
-        try:
-            yield
-        finally:
-            if on_shutdown is not None:
-                on_shutdown()
-
-    sse_app = mcp.sse_app()
-    app = Starlette(routes=[Route("/health", _health), *sse_app.routes], lifespan=lifespan)
+        async with _session_manager_lifespan(mcp):
+            try:
+                yield
+            finally:
+                if on_shutdown is not None:
+                    on_shutdown()
+
+    app = Starlette(routes=[Route("/health", _health), *http_app.routes], lifespan=lifespan)
     app.state.mcp = mcp
     return app