langbot-plugin 0.3.6__tar.gz → 0.3.7__tar.gz

{langbot_plugin-0.3.6 → langbot_plugin-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langbot-plugin
-Version: 0.3.6
+Version: 0.3.7
 Summary: This package contains the SDK, CLI for building plugins for LangBot, plus the runtime for hosting LangBot plugins
 Project-URL: Homepage, https://langbot.app
 Project-URL: Repository, https://github.com/langbot-app/langbot-plugin-sdk

{langbot_plugin-0.3.6 → langbot_plugin-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langbot-plugin"
-version = "0.3.6"
+version = "0.3.7"
 description = "This package contains the SDK, CLI for building plugins for LangBot, plus the runtime for hosting LangBot plugins"
 readme = "README.md"
 authors = [

{langbot_plugin-0.3.6 → langbot_plugin-0.3.7}/src/langbot_plugin/api/proxies/langbot_api.py

@@ -194,14 +194,72 @@ class LangBotAPIProxy:
             )
         )["commands"]
 
-    async def list_tools(self) -> list[str]:
-        """List all tools"""
+    async def list_tools(self) -> list[dict[str, Any]]:
+        """List all available tools.
+
+        Returns:
+            List of tool info dicts, each containing:
+            - name: Tool name (plugin_author/plugin_name/tool_name format)
+            - label: I18n label dict
+            - description: I18n description dict
+            - parameters: JSON Schema of tool parameters
+            - spec: Full tool spec
+        """
         return (
             await self.plugin_runtime_handler.call_action(
                 PluginToRuntimeAction.LIST_TOOLS, {}
             )
         )["tools"]
 
+    async def get_tool_detail(self, tool_name: str) -> dict[str, Any]:
+        """Get detailed information about a specific tool.
+
+        Args:
+            tool_name: The name of the tool to get details for.
+
+        Returns:
+            Tool detail dict containing name, label, description, parameters, spec.
+
+        Raises:
+            Exception: If the tool is not found.
+        """
+        return (
+            await self.plugin_runtime_handler.call_action(
+                PluginToRuntimeAction.GET_TOOL_DETAIL, {"tool_name": tool_name}
+            )
+        )["tool"]
+
+    async def call_tool(
+        self,
+        tool_name: str,
+        parameters: dict[str, Any],
+        session: dict[str, Any],
+        query_id: int,
+    ) -> dict[str, Any]:
+        """Call a specific tool.
+
+        Args:
+            tool_name: The name of the tool to call.
+            parameters: The parameters to pass to the tool.
+            session: The current session dict.
+            query_id: The current query ID.
+
+        Returns:
+            Tool response dict.
+        """
+        return (
+            await self.plugin_runtime_handler.call_action(
+                PluginToRuntimeAction.CALL_TOOL,
+                {
+                    "tool_name": tool_name,
+                    "tool_parameters": parameters,
+                    "session": session,
+                    "query_id": query_id,
+                },
+                timeout=180,
+            )
+        )["tool_response"]
+
     # ================= RAG Capability APIs =================
 
     async def invoke_embedding(

{langbot_plugin-0.3.6 → langbot_plugin-0.3.7}/src/langbot_plugin/entities/io/actions/enums.py

@@ -57,6 +57,8 @@ class PluginToRuntimeAction(ActionType):
     LIST_PLUGINS_MANIFEST = "list_plugins_manifest"
     LIST_COMMANDS = "list_commands"
     LIST_TOOLS = "list_tools"
+    GET_TOOL_DETAIL = "get_tool_detail"
+    CALL_TOOL = "call_tool"
 
     INVOKE_EMBEDDING = "invoke_embedding"
     VECTOR_UPSERT = "vector_upsert"

{langbot_plugin-0.3.6 → langbot_plugin-0.3.7}/src/langbot_plugin/runtime/io/handlers/plugin.py

@@ -520,7 +520,33 @@ class PluginConnectionHandler(handler.Handler):
         async def list_tools(data: dict[str, Any]) -> handler.ActionResponse:
             tools = await self.context.plugin_mgr.list_tools()
             return handler.ActionResponse.success(
-                {"tools": [tool.model_dump() for tool in tools]}
+                {"tools": [tool.to_plain_dict() for tool in tools]}
+            )
+
+        @self.action(PluginToRuntimeAction.GET_TOOL_DETAIL)
+        async def get_tool_detail(data: dict[str, Any]) -> handler.ActionResponse:
+            tool_name = data["tool_name"]
+            tools = await self.context.plugin_mgr.list_tools()
+            for tool in tools:
+                if tool.metadata.name == tool_name:
+                    return handler.ActionResponse.success(
+                        {"tool": tool.to_plain_dict()}
+                    )
+            return handler.ActionResponse.error(
+                message=f"Tool not found: {tool_name}"
+            )
+
+        @self.action(PluginToRuntimeAction.CALL_TOOL)
+        async def call_tool_from_plugin(data: dict[str, Any]) -> handler.ActionResponse:
+            tool_name = data["tool_name"]
+            tool_parameters = data["tool_parameters"]
+            session = data["session"]
+            query_id = data["query_id"]
+            resp = await self.context.plugin_mgr.call_tool(
+                tool_name, tool_parameters, session, query_id
+            )
+            return handler.ActionResponse.success(
+                {"tool_response": resp}
             )
 
         @self.action(PluginToRuntimeAction.LIST_PLUGINS_MANIFEST)