meshagent-tools 0.24.5__tar.gz → 0.25.0__tar.gz

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.25.0]
+- Added SQL column-schema parsing and CLI support for SQL-like `--columns` when creating tables or adding columns.
+- Breaking: SQL query requests now use a single `params` map for typed bindings instead of `parameters`/`param_values`.
+- Added `published`/`public` port fields in service specs for externally routed services.
+- Secrets set now supports `for_identity` to set secrets on behalf of another identity.
+- Added a Slack events HTTP bot package with dependencies including `pyjwt` 2.10.
+- Breaking: the CLI `exec` command was removed.
+- ThreadAdapter message writing now uses `write_text_message` and accepts participant name strings.
+
 ## [0.24.5]
 - Stability
 

{meshagent_tools-0.24.5/meshagent_tools.egg-info → meshagent_tools-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-tools
-Version: 0.24.5
+Version: 0.25.0
 Summary: Tools for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
@@ -12,8 +12,8 @@ License-File: LICENSE
 Requires-Dist: pyjwt~=2.10
 Requires-Dist: pytest~=8.4
 Requires-Dist: pytest-asyncio~=0.26
-Requires-Dist: meshagent-api~=0.24.5
-Requires-Dist: aiohttp~=3.10
+Requires-Dist: meshagent-api~=0.25.0
+Requires-Dist: aiohttp[speedups]~=3.13.0
 Requires-Dist: opentelemetry-distro~=0.54b1
 Dynamic: license-file
 

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/__init__.py

@@ -16,6 +16,7 @@ from .tool import (
     ToolContext,
     Tool,
     BaseTool,
+    tool,
 )
 
 from .config import ToolkitConfig
@@ -52,6 +53,7 @@ __all__ = [
     ToolContext,
     Toolkit,
     Response,
+    tool,
     LinkResponse,
     BaseTool,
     RemoteToolkit,

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/blob.py

@@ -1,6 +1,6 @@
 from uuid import uuid4
 import base64
-import aiohttp
+from meshagent.api.http import new_client_session
 
 
 class Blob:
@@ -48,7 +48,7 @@ async def get_bytes_from_url(*, url: str) -> Blob:
         # file_name = str(uuid.uuid4())+extension
         return Blob(mime_type=mime_type, data=content)
     else:
-        async with aiohttp.ClientSession() as session:
+        async with new_client_session() as session:
             async with session.get(url=url) as response:
                 content = await response.content.read()
                 return Blob(mime_type=response.content_type, data=content)

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/database.py

@@ -128,7 +128,7 @@ class UpdateTool(Tool):
         columns = ""
 
         for k, v in schema.items():
-            columns += f"column {k} => {v.to_json()}"
+            columns += f"column {k} => {v.model_dump(mode='json')}"
 
         anyOf = []
 
@@ -500,7 +500,7 @@ class AdvancedSearchTool(Tool):
         columns = ""
 
         for k, v in schema.items():
-            columns += f"column {k} => {v.to_json()}\n"
+            columns += f"column {k} => {v.model_dump(mode='json')}\n"
 
         input_schema = {
             "type": "object",
@@ -542,7 +542,7 @@ class AdvancedDeleteRowsTool(Tool):
         columns = ""
 
         for k, v in schema.items():
-            columns += f"column {k} => {v.to_json()}"
+            columns += f"column {k} => {v.model_dump(mode='json')}"
 
         input_schema = {
             "type": "object",

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/script.py

@@ -311,3 +311,39 @@ class ScriptTool(Tool):
                 )
 
         return {"results": results}
+
+
+async def get_script_tools(room: RoomClient):
+    services = await room.services.list()
+
+    st = []
+
+    for service in services:
+        if service.metadata.annotations is not None:
+            print("X")
+            type = service.metadata.annotations.get("meshagent.tool.type")
+            print(type)
+            commands_str = service.metadata.annotations.get("meshagent.tool.commands")
+            print(commands_str)
+            tool_name = service.metadata.annotations.get(
+                "meshagent.tool.name", service.metadata.name
+            )
+            description = service.metadata.annotations.get(
+                "meshagent.tool.description", service.metadata.description
+            )
+
+            if type == "script" and tool_name is not None:
+                print("FOUND")
+                if commands_str is not None:
+                    commands = commands_str.split("\n")
+
+                    st.append(
+                        ScriptTool(
+                            name=tool_name,
+                            description=description,
+                            service_id=service.id,
+                            commands=commands,
+                        )
+                    )
+
+    return st

meshagent_tools-0.25.0/meshagent/tools/tests/tool_decorator_test.py

@@ -0,0 +1,45 @@
+import pytest
+from pydantic import BaseModel
+
+from meshagent.api.messaging import JsonResponse
+from meshagent.tools import Toolkit, ToolContext, tool
+
+
+class Payload(BaseModel):
+    name: str
+    count: int
+
+
+class Result(BaseModel):
+    name: str
+    count: int
+    flag: bool
+
+
+@tool(name="make_payload")
+async def make_payload(context: ToolContext, payload: Payload, flag: bool):
+    return Result(name=payload.name, count=payload.count, flag=flag)
+
+
+@pytest.mark.asyncio
+async def test_decorated_tool_executes_with_toolkit():
+    toolkit = Toolkit(name="test", tools=[make_payload])
+    context = ToolContext(room=object(), caller=object())
+
+    result = await toolkit.execute(
+        context=context,
+        name="make_payload",
+        arguments={"payload": {"name": "alpha", "count": 2}, "flag": True},
+    )
+
+    assert isinstance(result, JsonResponse)
+    assert result.json == {"name": "alpha", "count": 2, "flag": True}
+
+
+def test_decorator_schema_is_strict():
+    schema = make_payload.input_schema
+
+    assert schema["type"] == "object"
+    assert schema["additionalProperties"] is False
+    assert "payload" in schema["properties"]
+    assert "flag" in schema["properties"]

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/tool.py

@@ -3,9 +3,15 @@ from meshagent.api.participant import Participant
 import logging
 from abc import ABC
 
-from typing import Optional, Dict, Any, Callable
+from typing import Optional, Dict, Any, Callable, get_type_hints
 
-from meshagent.api.messaging import Response
+import inspect
+
+from pydantic import BaseModel, create_model
+
+from meshagent.tools.strict_schema import ensure_strict_json_schema
+
+from meshagent.api.messaging import Response, ensure_response
 
 
 from opentelemetry import trace
@@ -117,5 +123,84 @@ class Tool(BaseTool):
         if defs is not None:
             openai_schema["$defs"] = {**defs}
 
+    async def invoke(
+        self, context: ToolContext, arguments: dict, attachment: Optional[bytes] = None
+    ) -> Response:
+        return await self.execute(context=context, **arguments)
+
     async def execute(self, context: ToolContext, **kwargs) -> Response:
         raise (Exception("Not implemented"))
+
+
+def tool(
+    *,
+    name: Optional[str] = None,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    rules: Optional[list[str]] = None,
+    thumbnail_url: Optional[str] = None,
+):
+    def decorator(fn: Callable[..., Response]):
+        signature = inspect.signature(fn)
+        hints = get_type_hints(fn, include_extras=True)
+
+        supports_context = False
+        fields: dict[str, tuple[Any, Any]] = {}
+
+        for param_name, param in signature.parameters.items():
+            annotation = hints.get(param_name, Any)
+            if annotation is ToolContext:
+                supports_context = True
+                continue
+
+            default = param.default if param.default is not inspect._empty else ...
+            fields[param_name] = (annotation, default)
+
+        InputModel = create_model(f"{fn.__name__}Input", **fields)
+        schema = InputModel.model_json_schema()
+        strict_schema = ensure_strict_json_schema(schema)
+
+        tool_name = name or fn.__name__
+        tool_title = title or tool_name
+        tool_description = (
+            description if description is not None else (fn.__doc__ or "").strip()
+        )
+
+        class FunctionTool(Tool):
+            def __init__(self):
+                super().__init__(
+                    name=tool_name,
+                    title=tool_title,
+                    description=tool_description,
+                    rules=rules,
+                    thumbnail_url=thumbnail_url,
+                    input_schema=strict_schema,
+                    supports_context=supports_context,
+                )
+                self.strict = True
+
+            async def invoke(
+                self,
+                context: ToolContext,
+                arguments: dict,
+                attachment: Optional[bytes] = None,
+            ) -> Response:
+                data = InputModel.model_validate(arguments)
+                parsed_args = {field: getattr(data, field) for field in fields}
+
+                if supports_context:
+                    result = fn(context, **parsed_args)
+                else:
+                    result = fn(**parsed_args)
+
+                if inspect.isawaitable(result):
+                    result = await result
+
+                if isinstance(result, BaseModel):
+                    result = result.model_dump(mode="json")
+
+                return ensure_response(result)
+
+        return FunctionTool()
+
+    return decorator

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent/tools/toolkit.py

@@ -8,7 +8,7 @@ import json
 
 from typing import Optional, Literal
 from meshagent.tools.config import ToolkitConfig
-from meshagent.tools.tool import ToolContext, BaseTool
+from meshagent.tools.tool import ToolContext, BaseTool, Tool
 
 from opentelemetry import trace
 
@@ -91,7 +91,12 @@ class Toolkit(ToolkitBuilder):
                 schema["$defs"] = {**tool.defs}
 
             validate(arguments, schema)
-            response = await tool.execute(context=context, **arguments)
+            if isinstance(tool, Tool):
+                response = await tool.invoke(
+                    context=context, arguments=arguments, attachment=attachment
+                )
+            else:
+                raise RoomException("tools must extend the Tool class to be invokable")
             response = ensure_response(response)
 
             span.set_attribute("response_type", response.to_json()["type"])

meshagent_tools-0.25.0/meshagent/tools/version.py

@@ -0,0 +1 @@
+__version__ = "0.25.0"

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0/meshagent_tools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshagent-tools
-Version: 0.24.5
+Version: 0.25.0
 Summary: Tools for Meshagent
 License-Expression: Apache-2.0
 Project-URL: Documentation, https://docs.meshagent.com
@@ -12,8 +12,8 @@ License-File: LICENSE
 Requires-Dist: pyjwt~=2.10
 Requires-Dist: pytest~=8.4
 Requires-Dist: pytest-asyncio~=0.26
-Requires-Dist: meshagent-api~=0.24.5
-Requires-Dist: aiohttp~=3.10
+Requires-Dist: meshagent-api~=0.25.0
+Requires-Dist: aiohttp[speedups]~=3.13.0
 Requires-Dist: opentelemetry-distro~=0.54b1
 Dynamic: license-file
 

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent_tools.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ meshagent/tools/toolkit.py
 meshagent/tools/uuid.py
 meshagent/tools/version.py
 meshagent/tools/web_toolkit.py
+meshagent/tools/tests/tool_decorator_test.py
 meshagent_tools.egg-info/PKG-INFO
 meshagent_tools.egg-info/SOURCES.txt
 meshagent_tools.egg-info/dependency_links.txt

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/meshagent_tools.egg-info/requires.txt

@@ -1,6 +1,6 @@
 pyjwt~=2.10
 pytest~=8.4
 pytest-asyncio~=0.26
-meshagent-api~=0.24.5
-aiohttp~=3.10
+meshagent-api~=0.25.0
+aiohttp[speedups]~=3.13.0
 opentelemetry-distro~=0.54b1

{meshagent_tools-0.24.5 → meshagent_tools-0.25.0}/pyproject.toml

@@ -12,8 +12,8 @@ dependencies = [
   "pyjwt~=2.10",
   "pytest~=8.4",
   "pytest-asyncio~=0.26",
-  "meshagent-api~=0.24.5",
-  "aiohttp~=3.10",
+  "meshagent-api~=0.25.0",
+  "aiohttp[speedups]~=3.13.0",
   "opentelemetry-distro~=0.54b1"
 ]
 dynamic = ["version", "readme"]

meshagent_tools-0.24.5/meshagent/tools/version.py

@@ -1 +0,0 @@
-__version__ = "0.24.5"