swarmauri_toolkit_runtime 0.1.1.dev2__tar.gz → 0.11.0.dev4__tar.gz

{swarmauri_toolkit_runtime-0.1.1.dev2 → swarmauri_toolkit_runtime-0.11.0.dev4}/PKG-INFO

@@ -1,31 +1,38 @@
 Metadata-Version: 2.4
 Name: swarmauri_toolkit_runtime
-Version: 0.1.1.dev2
+Version: 0.11.0.dev4
 Summary: Runtime toolkit for explicit-parameter registration, inspection, replacement, listing, and removal of Swarmauri tools during agent execution.
 License-Expression: Apache-2.0
 License-File: LICENSE
 Keywords: swarmauri,sdk,standards,toolkit,runtime,agent-runtime,tool-management,tool-registration,tool-inspection,tool-replacement,tool-removal,tool-schema,explicit-parameters,runtime-governance,agent,crud,runtime-tools
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
-Requires-Python: >=3.10,<3.13
+Requires-Python: >=3.10,<3.15
 Classifier: Development Status :: 1 - Planning
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Natural Language :: English
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: pydantic
-Requires-Dist: swarmauri_base
-Requires-Dist: swarmauri_core
-Requires-Dist: swarmauri_standard
+Requires-Dist: swarmauri_base (>=0.11.0.dev6,<0.12)
+Requires-Dist: swarmauri_core (>=0.11.0.dev6,<0.12)
+Requires-Dist: swarmauri_standard (>=0.11.0.dev8,<0.12)
+Requires-Dist: swarmauri_tool_inspectruntimetool (>=0.1.0,<0.2)
+Requires-Dist: swarmauri_tool_listruntimetools (>=0.1.0,<0.2)
+Requires-Dist: swarmauri_tool_registerruntimetool (>=0.1.0,<0.2)
+Requires-Dist: swarmauri_tool_replaceruntimetool (>=0.1.0,<0.2)
+Requires-Dist: swarmauri_tool_unregisterruntimetool (>=0.1.0,<0.2)
 Description-Content-Type: text/markdown
 
-![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
 
 <p align="center">
     <a href="https://pepy.tech/project/swarmauri_toolkit_runtime/">
@@ -33,22 +40,24 @@ Description-Content-Type: text/markdown
     <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_toolkit_runtime/">
         <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_toolkit_runtime.svg"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
-        <img src="https://img.shields.io/pypi/pyversions/swarmauri_toolkit_runtime" alt="PyPI - Python Version"/></a>
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
         <img src="https://img.shields.io/pypi/l/swarmauri_toolkit_runtime" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
         <img src="https://img.shields.io/pypi/v/swarmauri_toolkit_runtime?label=swarmauri_toolkit_runtime&color=green" alt="PyPI - swarmauri_toolkit_runtime"/></a>
-</p>
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
 
 # Swarmauri Toolkit RuntimeToolkit
 
-`RuntimeToolkit` is a Swarmauri runtime-management toolkit for agents that need to register, inspect, list, replace, and remove tools during execution. It keeps tool mutation inside the active toolkit instance and requires explicit parameter declarations when a new runtime tool is introduced.
+`RuntimeToolkit` is a Swarmauri runtime-management toolkit for agents that need to register, inspect, list, replace, and remove tools during execution. It keeps tool mutation inside the active toolkit instance and requires both explicit parameter declarations and an explicit `__call__` implementation when a new runtime tool is introduced.
 
 ## Features
 
 - Bundles agent-callable CRUD operations for toolkit members.
-- Accepts serialized tool specs with `type` fields and materializes installed Swarmauri tools at runtime.
-- Enforces a non-empty declared `parameters` list for runtime tool registration and replacement.
+- Accepts serialized runtime tool specs with `type`, `parameters`, and `__call__` fields.
+- Enforces a non-empty declared `parameters` list and a non-empty `__call__` body for runtime tool registration and replacement.
+- Evaluates runtime `__call__` bodies through a restricted expression rail rather than unrestricted Python execution.
 - Returns agent-friendly dictionaries for reads, lists, and mutation results.
 - Protects the toolkit's own management tools from accidental overwrite or removal.
 - Supports Python 3.10 through 3.12.
@@ -78,7 +87,7 @@ pip install swarmauri_toolkit_runtime
 Use `RuntimeToolkit` when an agent needs to mutate its own tool surface safely at runtime. The expected workflow is:
 
 1. Start with the management toolkit.
-2. Register a runtime tool using an explicit parameter contract.
+2. Register a runtime tool using an explicit parameter contract and explicit callable body.
 3. Inspect or list the available runtime tools.
 4. Execute the registered tool.
 5. Replace or unregister the tool when the runtime surface changes.
@@ -92,7 +101,7 @@ toolkit = RuntimeToolkit()
 
 toolkit.get_tool_by_name("RegisterRuntimeTool")(
     {
-        "type": "AdditionTool",
+        "type": "RuntimeAdditionTool",
         "name": "RuntimeAdditionTool",
         "description": "Adds two integers during the active agent session.",
         "parameters": [
@@ -109,6 +118,7 @@ toolkit.get_tool_by_name("RegisterRuntimeTool")(
                 "required": True,
             },
         ],
+        "__call__": '{"sum": str(x + y)}',
     }
 )
 
@@ -128,14 +138,15 @@ print(result)
 
 Mutation tools accept a serialized tool specification. At minimum, provide:
 
-- a `type` field that resolves to an installed Swarmauri tool import such as `swarmauri.tools.AdditionTool`
+- a non-empty `type` field that names the runtime tool surface
 - a non-empty `parameters` list that explicitly declares the runtime callable contract
+- a non-empty `__call__` string that evaluates as a safe Python expression over the declared parameters and approved builtins
 
-Resolution prefers the `swarmauri` facade when present and falls back to `swarmauri_standard.tools.<ToolName>` for isolated package installs.
+The runtime evaluator permits only a constrained expression subset and approved builtins such as `str`, `int`, `float`, `len`, `sum`, `min`, `max`, and `abs`. Imports, attribute traversal, and arbitrary function calls are rejected.
 
 ```python
 {
-    "type": "AdditionTool",
+    "type": "RuntimeAdditionTool",
     "name": "RuntimeAdditionTool",
     "description": "Adds two integers.",
     "parameters": [
@@ -152,15 +163,19 @@ Resolution prefers the `swarmauri` facade when present and falls back to `swarma
             "required": True,
         },
     ],
+    "__call__": '{"sum": str(x + y)}',
 }
 ```
 
-If the target tool defines extra fields, include them in the spec and the toolkit will validate them against the concrete tool class.
+The `__call__` value is evaluated against the declared parameter names. A body such as `{"sum": str(x + y)}` is valid. A body that tries to import modules, access attributes, or reference undeclared names is rejected.
 
 ## Failure Modes
 
 - Registration fails when the tool spec omits `parameters`.
+- Registration fails when the tool spec omits `__call__`.
+- Registration fails when the `__call__` body uses unsafe syntax or disallowed names.
 - Registration fails when the tool name collides with a protected management tool.
+- Execution failures inside an accepted runtime tool return a structured error payload instead of propagating a hard exception or terminating the host process.
 - Replacement fails when the target tool is missing, reserved, or renamed to an existing tool.
 - Unregistration fails when the target is reserved or absent.
 
@@ -169,3 +184,5 @@ If the target tool defines extra fields, include them in the spec and the toolki
 `swarmauri_toolkit_runtime` is released under the Apache 2.0 License. See `LICENSE` for details.
 
 
+
+

{swarmauri_toolkit_runtime-0.1.1.dev2 → swarmauri_toolkit_runtime-0.11.0.dev4}/README.md

@@ -1,4 +1,4 @@
-![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
 
 <p align="center">
     <a href="https://pepy.tech/project/swarmauri_toolkit_runtime/">
@@ -6,22 +6,24 @@
     <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_toolkit_runtime/">
         <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_toolkit_runtime.svg"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
-        <img src="https://img.shields.io/pypi/pyversions/swarmauri_toolkit_runtime" alt="PyPI - Python Version"/></a>
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
         <img src="https://img.shields.io/pypi/l/swarmauri_toolkit_runtime" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri_toolkit_runtime/">
         <img src="https://img.shields.io/pypi/v/swarmauri_toolkit_runtime?label=swarmauri_toolkit_runtime&color=green" alt="PyPI - swarmauri_toolkit_runtime"/></a>
-</p>
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
 
 # Swarmauri Toolkit RuntimeToolkit
 
-`RuntimeToolkit` is a Swarmauri runtime-management toolkit for agents that need to register, inspect, list, replace, and remove tools during execution. It keeps tool mutation inside the active toolkit instance and requires explicit parameter declarations when a new runtime tool is introduced.
+`RuntimeToolkit` is a Swarmauri runtime-management toolkit for agents that need to register, inspect, list, replace, and remove tools during execution. It keeps tool mutation inside the active toolkit instance and requires both explicit parameter declarations and an explicit `__call__` implementation when a new runtime tool is introduced.
 
 ## Features
 
 - Bundles agent-callable CRUD operations for toolkit members.
-- Accepts serialized tool specs with `type` fields and materializes installed Swarmauri tools at runtime.
-- Enforces a non-empty declared `parameters` list for runtime tool registration and replacement.
+- Accepts serialized runtime tool specs with `type`, `parameters`, and `__call__` fields.
+- Enforces a non-empty declared `parameters` list and a non-empty `__call__` body for runtime tool registration and replacement.
+- Evaluates runtime `__call__` bodies through a restricted expression rail rather than unrestricted Python execution.
 - Returns agent-friendly dictionaries for reads, lists, and mutation results.
 - Protects the toolkit's own management tools from accidental overwrite or removal.
 - Supports Python 3.10 through 3.12.
@@ -51,7 +53,7 @@ pip install swarmauri_toolkit_runtime
 Use `RuntimeToolkit` when an agent needs to mutate its own tool surface safely at runtime. The expected workflow is:
 
 1. Start with the management toolkit.
-2. Register a runtime tool using an explicit parameter contract.
+2. Register a runtime tool using an explicit parameter contract and explicit callable body.
 3. Inspect or list the available runtime tools.
 4. Execute the registered tool.
 5. Replace or unregister the tool when the runtime surface changes.
@@ -65,7 +67,7 @@ toolkit = RuntimeToolkit()
 
 toolkit.get_tool_by_name("RegisterRuntimeTool")(
     {
-        "type": "AdditionTool",
+        "type": "RuntimeAdditionTool",
         "name": "RuntimeAdditionTool",
         "description": "Adds two integers during the active agent session.",
         "parameters": [
@@ -82,6 +84,7 @@ toolkit.get_tool_by_name("RegisterRuntimeTool")(
                 "required": True,
             },
         ],
+        "__call__": '{"sum": str(x + y)}',
     }
 )
 
@@ -101,14 +104,15 @@ print(result)
 
 Mutation tools accept a serialized tool specification. At minimum, provide:
 
-- a `type` field that resolves to an installed Swarmauri tool import such as `swarmauri.tools.AdditionTool`
+- a non-empty `type` field that names the runtime tool surface
 - a non-empty `parameters` list that explicitly declares the runtime callable contract
+- a non-empty `__call__` string that evaluates as a safe Python expression over the declared parameters and approved builtins
 
-Resolution prefers the `swarmauri` facade when present and falls back to `swarmauri_standard.tools.<ToolName>` for isolated package installs.
+The runtime evaluator permits only a constrained expression subset and approved builtins such as `str`, `int`, `float`, `len`, `sum`, `min`, `max`, and `abs`. Imports, attribute traversal, and arbitrary function calls are rejected.
 
 ```python
 {
-    "type": "AdditionTool",
+    "type": "RuntimeAdditionTool",
     "name": "RuntimeAdditionTool",
     "description": "Adds two integers.",
     "parameters": [
@@ -125,15 +129,19 @@ Resolution prefers the `swarmauri` facade when present and falls back to `swarma
             "required": True,
         },
     ],
+    "__call__": '{"sum": str(x + y)}',
 }
 ```
 
-If the target tool defines extra fields, include them in the spec and the toolkit will validate them against the concrete tool class.
+The `__call__` value is evaluated against the declared parameter names. A body such as `{"sum": str(x + y)}` is valid. A body that tries to import modules, access attributes, or reference undeclared names is rejected.
 
 ## Failure Modes
 
 - Registration fails when the tool spec omits `parameters`.
+- Registration fails when the tool spec omits `__call__`.
+- Registration fails when the `__call__` body uses unsafe syntax or disallowed names.
 - Registration fails when the tool name collides with a protected management tool.
+- Execution failures inside an accepted runtime tool return a structured error payload instead of propagating a hard exception or terminating the host process.
 - Replacement fails when the target tool is missing, reserved, or renamed to an existing tool.
 - Unregistration fails when the target is reserved or absent.
 
@@ -141,3 +149,5 @@ If the target tool defines extra fields, include them in the spec and the toolki
 
 `swarmauri_toolkit_runtime` is released under the Apache 2.0 License. See `LICENSE` for details.
 
+
+

{swarmauri_toolkit_runtime-0.1.1.dev2 → swarmauri_toolkit_runtime-0.11.0.dev4}/pyproject.toml

@@ -1,30 +1,37 @@
 [project]
 name = "swarmauri_toolkit_runtime"
-version = "0.1.1.dev2"
+version = "0.11.0.dev4"
 description = "Runtime toolkit for explicit-parameter registration, inspection, replacement, listing, and removal of Swarmauri tools during agent execution."
 license = "Apache-2.0"
 readme = { file = "README.md", content-type = "text/markdown" }
 repository = "http://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_toolkit_runtime"
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.15"
 classifiers = [
     "Development Status :: 1 - Planning",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
     "Natural Language :: English",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
 dependencies = [
+    "swarmauri_tool_registerruntimetool>=0.1.0,<0.2",
+    "swarmauri_tool_inspectruntimetool>=0.1.0,<0.2",
+    "swarmauri_tool_listruntimetools>=0.1.0,<0.2",
+    "swarmauri_tool_replaceruntimetool>=0.1.0,<0.2",
+    "swarmauri_tool_unregisterruntimetool>=0.1.0,<0.2",
     "pydantic",
-    "swarmauri_core",
-    "swarmauri_base",
-    "swarmauri_standard",
+    "swarmauri_core>=0.11.0.dev6,<0.12",
+    "swarmauri_base>=0.11.0.dev6,<0.12",
+    "swarmauri_standard>=0.11.0.dev8,<0.12",
 ]
 keywords = [
     "swarmauri",
@@ -47,6 +54,11 @@ keywords = [
 ]
 
 [tool.uv.sources]
+swarmauri_tool_registerruntimetool = { workspace = true }
+swarmauri_tool_inspectruntimetool = { workspace = true }
+swarmauri_tool_listruntimetools = { workspace = true }
+swarmauri_tool_replaceruntimetool = { workspace = true }
+swarmauri_tool_unregisterruntimetool = { workspace = true }
 swarmauri_core = { workspace = true }
 swarmauri_base = { workspace = true }
 swarmauri_standard = { workspace = true }
@@ -74,13 +86,6 @@ asyncio_default_fixture_loop_scope = "function"
 [project.entry-points.'swarmauri.toolkits']
 RuntimeToolkit = "swarmauri_toolkit_runtime:RuntimeToolkit"
 
-[project.entry-points.'swarmauri.tools']
-RegisterRuntimeTool = "swarmauri_toolkit_runtime:RegisterRuntimeTool"
-InspectRuntimeTool = "swarmauri_toolkit_runtime:InspectRuntimeTool"
-ListRuntimeTools = "swarmauri_toolkit_runtime:ListRuntimeTools"
-UnregisterRuntimeTool = "swarmauri_toolkit_runtime:UnregisterRuntimeTool"
-ReplaceRuntimeTool = "swarmauri_toolkit_runtime:ReplaceRuntimeTool"
-
 [build-system]
 requires = ["poetry-core>=1.0.0"]
 build-backend = "poetry.core.masonry.api"
@@ -92,7 +97,7 @@ dev = [
     "pytest-xdist>=3.6.1",
     "pytest-json-report>=1.5.0",
     "python-dotenv",
-    "requests>=2.32.3",
+    "httpx>=0.27",
     "flake8>=7.0",
     "pytest-timeout>=2.3.1",
     "ruff>=0.9.9",

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/InspectRuntimeTool.py

@@ -0,0 +1,3 @@
+from swarmauri_tool_inspectruntimetool import InspectRuntimeTool
+
+__all__ = ["InspectRuntimeTool"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/ListRuntimeTools.py

@@ -0,0 +1,3 @@
+from swarmauri_tool_listruntimetools import ListRuntimeTools
+
+__all__ = ["ListRuntimeTools"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/RecipeTool.py

@@ -0,0 +1,47 @@
+from collections.abc import Callable
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field
+from swarmauri_base.ComponentBase import ComponentBase
+from swarmauri_base.tools.ToolBase import ToolBase
+
+
+class RecipeStep(BaseModel):
+    """Call one installed tool with literals or input references."""
+
+    tool: str
+    arguments: dict[str, Any] = Field(default_factory=dict)
+
+
+@ComponentBase.register_type(ToolBase, "RecipeTool")
+class RecipeTool(ToolBase):
+    """Run a sequence of existing tool calls through a host dispatcher."""
+
+    type: Literal["RecipeTool"] = "RecipeTool"
+    steps: list[RecipeStep] = Field(min_length=1, max_length=32)
+    dispatch: Callable[[str, dict[str, Any]], dict[str, Any]] = Field(
+        exclude=True
+    )
+
+    def __call__(self, **inputs):
+        declared = {parameter.name for parameter in self.parameters}
+        required = {
+            parameter.name
+            for parameter in self.parameters
+            if parameter.required
+        }
+        if inputs.keys() - declared or required - inputs.keys():
+            raise ValueError("Recipe inputs do not match its parameters")
+        results = []
+        for step in self.steps:
+            arguments = {
+                key: inputs[value["input"]]
+                if isinstance(value, dict) and value.keys() == {"input"}
+                else value
+                for key, value in step.arguments.items()
+            }
+            result = self.dispatch(step.tool, arguments)
+            results.append(result)
+            if result.get("status") != "completed":
+                break
+        return {"steps": results}

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/RegisterRuntimeTool.py

@@ -0,0 +1,3 @@
+from swarmauri_tool_registerruntimetool import RegisterRuntimeTool
+
+__all__ = ["RegisterRuntimeTool"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/ReplaceRuntimeTool.py

@@ -0,0 +1,3 @@
+from swarmauri_tool_replaceruntimetool import ReplaceRuntimeTool
+
+__all__ = ["ReplaceRuntimeTool"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/RuntimeToolkit.py

@@ -0,0 +1,75 @@
+from collections.abc import Callable, Mapping
+from typing import Dict, Literal
+
+from pydantic import Field, PrivateAttr
+
+from swarmauri_base.ComponentBase import ComponentBase
+from swarmauri_base.tools.ToolBase import ToolBase
+from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
+
+from .RegisterRuntimeTool import RegisterRuntimeTool
+from .InspectRuntimeTool import InspectRuntimeTool
+from .ListRuntimeTools import ListRuntimeTools
+from .UnregisterRuntimeTool import UnregisterRuntimeTool
+from .ReplaceRuntimeTool import ReplaceRuntimeTool
+from .RecipeTool import RecipeTool
+from ._tool_factory import build_tool_from_spec
+
+
+@ComponentBase.register_type(ToolkitBase, "RuntimeToolkit")
+class RuntimeToolkit(ToolkitBase):
+    type: Literal["RuntimeToolkit"] = "RuntimeToolkit"
+    tools: Dict[str, ToolBase] = {}
+    revision: int = Field(default=0, ge=0)
+    _recipe_dispatch: Callable | None = PrivateAttr(default=None)
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.tools = self._build_management_tools()
+
+    def _build_management_tools(self) -> Dict[str, ToolBase]:
+        protected_tool_names = {
+            "RegisterRuntimeTool",
+            "InspectRuntimeTool",
+            "ListRuntimeTools",
+            "UnregisterRuntimeTool",
+            "ReplaceRuntimeTool",
+        }
+        return {
+            "RegisterRuntimeTool": RegisterRuntimeTool(
+                toolkit=self,
+                protected_tool_names=protected_tool_names,
+                factory=self._build_tool,
+            ),
+            "InspectRuntimeTool": InspectRuntimeTool(toolkit=self),
+            "ListRuntimeTools": ListRuntimeTools(toolkit=self),
+            "UnregisterRuntimeTool": UnregisterRuntimeTool(
+                toolkit=self, protected_tool_names=protected_tool_names
+            ),
+            "ReplaceRuntimeTool": ReplaceRuntimeTool(
+                toolkit=self,
+                protected_tool_names=protected_tool_names,
+                factory=self._build_tool,
+            ),
+        }
+
+    def bind_recipe_dispatch(self, dispatch: Callable) -> None:
+        """Configure the application dispatcher for recipe steps."""
+        self._recipe_dispatch = dispatch
+
+    def _build_tool(self, spec):
+        if isinstance(spec, Mapping) and spec.get("type") == "RecipeTool":
+            if self._recipe_dispatch is None:
+                raise ValueError("Recipe dispatch is not configured")
+            return RecipeTool.model_validate(
+                {**spec, "dispatch": self._recipe_dispatch}
+            )
+        return build_tool_from_spec(spec)
+
+    def add_tool(self, tool):
+        super().add_tool(tool)
+        self.revision += 1
+
+    def remove_tool(self, tool_name):
+        super().remove_tool(tool_name)
+        self.revision += 1

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/UnregisterRuntimeTool.py

@@ -0,0 +1,3 @@
+from swarmauri_tool_unregisterruntimetool import UnregisterRuntimeTool
+
+__all__ = ["UnregisterRuntimeTool"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/_dynamic_runtime_tool.py

@@ -0,0 +1,3 @@
+from swarmauri_standard.tools._dynamic_runtime_tool import DynamicRuntimeTool
+
+__all__ = ["DynamicRuntimeTool"]

swarmauri_toolkit_runtime-0.11.0.dev4/swarmauri_toolkit_runtime/_tool_factory.py

@@ -0,0 +1,3 @@
+from swarmauri_standard.tools._tool_factory import build_tool_from_spec
+
+__all__ = ["build_tool_from_spec"]

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/InspectRuntimeTool.py

@@ -1,38 +0,0 @@
-from typing import Any, Dict, List, Literal
-
-from pydantic import Field
-
-from swarmauri_base.ComponentBase import ComponentBase
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-from swarmauri_standard.tools.Parameter import Parameter
-
-
-@ComponentBase.register_type(ToolBase, "InspectRuntimeTool")
-class InspectRuntimeTool(ToolBase):
-    version: str = "0.1.0"
-    name: str = "InspectRuntimeTool"
-    description: str = "Read one tool from the active toolkit by name."
-    type: Literal["InspectRuntimeTool"] = "InspectRuntimeTool"
-    toolkit: ToolkitBase | None = Field(default=None, exclude=True, repr=False)
-    parameters: List[Parameter] = Field(
-        default_factory=lambda: [
-            Parameter(
-                name="tool_name",
-                input_type="string",
-                description="Name of the tool to fetch from the toolkit.",
-                required=True,
-            )
-        ]
-    )
-
-    def __call__(self, tool_name: str) -> Dict[str, Any]:
-        if self.toolkit is None:
-            raise ValueError("toolkit is not configured")
-
-        tool = self.toolkit.get_tool_by_name(tool_name)
-        return {
-            "tool_name": tool_name,
-            "tool_type": tool.type,
-            "tool": tool.model_dump(exclude_none=True),
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/ListRuntimeTools.py

@@ -1,31 +0,0 @@
-from typing import Any, Dict, List, Literal
-
-from pydantic import Field
-
-from swarmauri_base.ComponentBase import ComponentBase
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-
-
-@ComponentBase.register_type(ToolBase, "ListRuntimeTools")
-class ListRuntimeTools(ToolBase):
-    version: str = "0.1.0"
-    name: str = "ListRuntimeTools"
-    description: str = "List all tools currently available in the active toolkit."
-    type: Literal["ListRuntimeTools"] = "ListRuntimeTools"
-    toolkit: ToolkitBase | None = Field(default=None, exclude=True, repr=False)
-    parameters: List[Any] = Field(default_factory=list)
-
-    def __call__(self) -> Dict[str, Any]:
-        if self.toolkit is None:
-            raise ValueError("toolkit is not configured")
-
-        tools = {
-            name: tool.model_dump(exclude_none=True)
-            for name, tool in self.toolkit.tools.items()
-        }
-        return {
-            "tool_count": len(self.toolkit),
-            "tool_names": list(self.toolkit.tools.keys()),
-            "tools": tools,
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/RegisterRuntimeTool.py

@@ -1,53 +0,0 @@
-from typing import Any, Dict, List, Literal, Mapping
-
-from pydantic import Field
-
-from swarmauri_base.ComponentBase import ComponentBase
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-from swarmauri_standard.tools.Parameter import Parameter
-
-from ._tool_factory import build_tool_from_spec
-
-
-@ComponentBase.register_type(ToolBase, "RegisterRuntimeTool")
-class RegisterRuntimeTool(ToolBase):
-    version: str = "0.1.0"
-    name: str = "RegisterRuntimeTool"
-    description: str = (
-        "Create a tool from a serialized tool spec and add it to the active toolkit."
-    )
-    type: Literal["RegisterRuntimeTool"] = "RegisterRuntimeTool"
-    toolkit: ToolkitBase | None = Field(default=None, exclude=True, repr=False)
-    protected_tool_names: set[str] = Field(
-        default_factory=set, exclude=True, repr=False
-    )
-    parameters: List[Parameter] = Field(
-        default_factory=lambda: [
-            Parameter(
-                name="tool_spec",
-                input_type="object",
-                description="Serialized tool payload with at least a 'type' field.",
-                required=True,
-            )
-        ]
-    )
-
-    def __call__(self, tool_spec: Mapping[str, Any] | ToolBase) -> Dict[str, Any]:
-        if self.toolkit is None:
-            raise ValueError("toolkit is not configured")
-
-        tool = build_tool_from_spec(tool_spec)
-        if tool.name in self.protected_tool_names:
-            raise ValueError(f"Tool '{tool.name}' is reserved by RuntimeToolkit")
-        if tool.name in self.toolkit.tools:
-            raise ValueError(f"Tool '{tool.name}' already exists in the toolkit")
-
-        self.toolkit.add_tool(tool)
-        return {
-            "status": "created",
-            "tool_name": tool.name,
-            "tool_type": tool.type,
-            "tool": tool.model_dump(exclude_none=True),
-            "tool_count": len(self.toolkit),
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/ReplaceRuntimeTool.py

@@ -1,68 +0,0 @@
-from typing import Any, Dict, List, Literal, Mapping
-
-from pydantic import Field
-
-from swarmauri_base.ComponentBase import ComponentBase
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-from swarmauri_standard.tools.Parameter import Parameter
-
-from ._tool_factory import build_tool_from_spec
-
-
-@ComponentBase.register_type(ToolBase, "ReplaceRuntimeTool")
-class ReplaceRuntimeTool(ToolBase):
-    version: str = "0.1.0"
-    name: str = "ReplaceRuntimeTool"
-    description: str = "Replace an existing non-reserved tool in the active toolkit with a new serialized tool spec."
-    type: Literal["ReplaceRuntimeTool"] = "ReplaceRuntimeTool"
-    toolkit: ToolkitBase | None = Field(default=None, exclude=True, repr=False)
-    protected_tool_names: set[str] = Field(
-        default_factory=set, exclude=True, repr=False
-    )
-    parameters: List[Parameter] = Field(
-        default_factory=lambda: [
-            Parameter(
-                name="tool_name",
-                input_type="string",
-                description="Existing tool name to replace.",
-                required=True,
-            ),
-            Parameter(
-                name="tool_spec",
-                input_type="object",
-                description="Serialized replacement tool payload with at least a 'type' field.",
-                required=True,
-            ),
-        ]
-    )
-
-    def __call__(
-        self, tool_name: str, tool_spec: Mapping[str, Any] | ToolBase
-    ) -> Dict[str, Any]:
-        if self.toolkit is None:
-            raise ValueError("toolkit is not configured")
-        if tool_name in self.protected_tool_names:
-            raise ValueError(f"Tool '{tool_name}' is reserved by RuntimeToolkit")
-        if tool_name not in self.toolkit.tools:
-            raise ValueError(f"Tool '{tool_name}' not found in the toolkit")
-
-        replacement = build_tool_from_spec(tool_spec)
-        if (
-            replacement.name in self.protected_tool_names
-            and replacement.name != tool_name
-        ):
-            raise ValueError(f"Tool '{replacement.name}' is reserved by RuntimeToolkit")
-        if replacement.name != tool_name and replacement.name in self.toolkit.tools:
-            raise ValueError(f"Tool '{replacement.name}' already exists in the toolkit")
-
-        self.toolkit.remove_tool(tool_name)
-        self.toolkit.add_tool(replacement)
-        return {
-            "status": "updated",
-            "previous_tool_name": tool_name,
-            "tool_name": replacement.name,
-            "tool_type": replacement.type,
-            "tool": replacement.model_dump(exclude_none=True),
-            "tool_count": len(self.toolkit),
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/RuntimeToolkit.py

@@ -1,43 +0,0 @@
-from typing import Dict, Literal
-
-from swarmauri_base.ComponentBase import ComponentBase, SubclassUnion
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-
-from .RegisterRuntimeTool import RegisterRuntimeTool
-from .InspectRuntimeTool import InspectRuntimeTool
-from .ListRuntimeTools import ListRuntimeTools
-from .UnregisterRuntimeTool import UnregisterRuntimeTool
-from .ReplaceRuntimeTool import ReplaceRuntimeTool
-
-
-@ComponentBase.register_type(ToolkitBase, "RuntimeToolkit")
-class RuntimeToolkit(ToolkitBase):
-    type: Literal["RuntimeToolkit"] = "RuntimeToolkit"
-    tools: Dict[str, SubclassUnion[ToolBase]] = {}
-
-    def __init__(self, **kwargs):
-        super().__init__(**kwargs)
-        self.tools = self._build_management_tools()
-
-    def _build_management_tools(self) -> Dict[str, SubclassUnion[ToolBase]]:
-        protected_tool_names = {
-            "RegisterRuntimeTool",
-            "InspectRuntimeTool",
-            "ListRuntimeTools",
-            "UnregisterRuntimeTool",
-            "ReplaceRuntimeTool",
-        }
-        return {
-            "RegisterRuntimeTool": RegisterRuntimeTool(
-                toolkit=self, protected_tool_names=protected_tool_names
-            ),
-            "InspectRuntimeTool": InspectRuntimeTool(toolkit=self),
-            "ListRuntimeTools": ListRuntimeTools(toolkit=self),
-            "UnregisterRuntimeTool": UnregisterRuntimeTool(
-                toolkit=self, protected_tool_names=protected_tool_names
-            ),
-            "ReplaceRuntimeTool": ReplaceRuntimeTool(
-                toolkit=self, protected_tool_names=protected_tool_names
-            ),
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/UnregisterRuntimeTool.py

@@ -1,43 +0,0 @@
-from typing import Any, Dict, List, Literal
-
-from pydantic import Field
-
-from swarmauri_base.ComponentBase import ComponentBase
-from swarmauri_base.tools.ToolBase import ToolBase
-from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
-from swarmauri_standard.tools.Parameter import Parameter
-
-
-@ComponentBase.register_type(ToolBase, "UnregisterRuntimeTool")
-class UnregisterRuntimeTool(ToolBase):
-    version: str = "0.1.0"
-    name: str = "UnregisterRuntimeTool"
-    description: str = "Delete a non-reserved tool from the active toolkit."
-    type: Literal["UnregisterRuntimeTool"] = "UnregisterRuntimeTool"
-    toolkit: ToolkitBase | None = Field(default=None, exclude=True, repr=False)
-    protected_tool_names: set[str] = Field(
-        default_factory=set, exclude=True, repr=False
-    )
-    parameters: List[Parameter] = Field(
-        default_factory=lambda: [
-            Parameter(
-                name="tool_name",
-                input_type="string",
-                description="Name of the tool to remove from the toolkit.",
-                required=True,
-            )
-        ]
-    )
-
-    def __call__(self, tool_name: str) -> Dict[str, Any]:
-        if self.toolkit is None:
-            raise ValueError("toolkit is not configured")
-        if tool_name in self.protected_tool_names:
-            raise ValueError(f"Tool '{tool_name}' is reserved by RuntimeToolkit")
-
-        self.toolkit.remove_tool(tool_name)
-        return {
-            "status": "deleted",
-            "tool_name": tool_name,
-            "tool_count": len(self.toolkit),
-        }

swarmauri_toolkit_runtime-0.1.1.dev2/swarmauri_toolkit_runtime/_tool_factory.py

@@ -1,49 +0,0 @@
-from importlib import import_module
-from typing import Any, Mapping
-
-from swarmauri_base.tools.ToolBase import ToolBase
-
-
-def _resolve_tool_module(tool_type: str):
-    module_names = [
-        f"swarmauri.tools.{tool_type}",
-        f"swarmauri_standard.tools.{tool_type}",
-    ]
-    last_error: ModuleNotFoundError | None = None
-    for module_name in module_names:
-        try:
-            return import_module(module_name)
-        except ModuleNotFoundError as exc:
-            last_error = exc
-    raise ValueError(f"Unable to resolve tool type '{tool_type}'") from last_error
-
-
-def build_tool_from_spec(tool_spec: Mapping[str, Any] | ToolBase) -> ToolBase:
-    if isinstance(tool_spec, ToolBase):
-        if not tool_spec.parameters:
-            raise ValueError("Runtime tool registration requires declared parameters")
-        return tool_spec
-    if not isinstance(tool_spec, Mapping):
-        raise TypeError("tool_spec must be a mapping or ToolBase instance")
-
-    tool_data = dict(tool_spec)
-    tool_type = tool_data.get("type")
-    if not isinstance(tool_type, str) or not tool_type:
-        raise ValueError("tool_spec must include a non-empty string 'type' field")
-    declared_parameters = tool_data.get("parameters")
-    if not isinstance(declared_parameters, list) or not declared_parameters:
-        raise ValueError(
-            "Runtime tool registration requires a non-empty 'parameters' list"
-        )
-
-    module = _resolve_tool_module(tool_type)
-
-    tool_cls = getattr(module, tool_type, None)
-    if tool_cls is None:
-        raise ValueError(
-            f"Module for tool type '{tool_type}' does not expose that class"
-        )
-    if not issubclass(tool_cls, ToolBase):
-        raise TypeError(f"Resolved class '{tool_type}' is not a ToolBase subtype")
-
-    return tool_cls.model_validate(tool_data)