new: agents can now optionally specify a minimum nerve required version

Author: evilsocket

nerve/cli/run.py

@@ -85,7 +85,7 @@ def run(
     logger.info(f"🧠 nerve v{nerve.__version__}")
 
     asyncio.run(
-        execute_flow(
+        _run(
             input_path,
             generator,
             # convert the conversation strategy string to a valid enum
@@ -130,7 +130,7 @@ def _resolve_input_path(input_path: pathlib.Path) -> pathlib.Path:
     return input_path
 
 
-async def execute_flow(
+async def _run(
     input_path: pathlib.Path,
     generator: str,
     conv_window_strategy: WindowStrategy,

nerve/models.py

@@ -2,9 +2,12 @@
 import typing as t
 from enum import Enum
 
-from pydantic import BaseModel, Field
+from loguru import logger
+from pydantic import AfterValidator, BaseModel, Field
 from pydantic_yaml import parse_yaml_raw_as
 
+import nerve
+
 
 class Mode(str, Enum):
     """
@@ -71,6 +74,30 @@ class Argument(BaseModel):
     tool: str | None = None
 
 
+def _check_required_version(required: str | None) -> str | None:
+    if required:
+        from packaging.requirements import Requirement
+
+        try:
+            # a version was specified, convert to a valid requirement
+            if required[0].isdigit():
+                required_str = f"nerve-adk>={required}"
+            else:
+                # a full expression was specified, use it as is
+                required_str = f"nerve-adk{required}"
+            req = Requirement(required_str)
+        except Exception as e:
+            logger.error(f"error parsing required version '{required}': {e}")
+            raise
+
+        if nerve.__version__ not in req.specifier:
+            msg = f"required version {required} not satisfied by installed version {nerve.__version__}"
+            logger.error(msg)
+            raise ValueError(msg)
+
+    return required
+
+
 class Configuration(BaseModel):
     """
     Configuration for an agent determining its "identity", task and capabilities.
@@ -81,6 +108,8 @@ class Configuration(BaseModel):
 
     # optional generator
     generator: str | None = None
+    # optional nerve version requirement
+    requires: t.Annotated[str | None, AfterValidator(_check_required_version)] = None
     # used for versioning the agents
     version: str = "1.0.0"
     # the system prompt, the agent identity

poetry.lock

@@ -36,6 +36,7 @@ types-pyperclip = { version = "^1.9.0.20250218", optional = true }
 termcolor = "^2.5.0"
 requests = "^2.32.3"
 types-requests = "^2.32.0.20250328"
+packaging = "^24.2"
 
 [tool.poetry.extras]
 computer_use = [