dominusnode-superagi 1.0.0__py3-none-any.whl

dominusnode_superagi/__init__.py

@@ -0,0 +1,5 @@
+"""DomiNode tools for SuperAGI agents."""
+from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+__version__ = "1.0.0"
+__all__ = ["DominusNodeToolkit"]

dominusnode_superagi/toolkit.py

@@ -0,0 +1,133 @@
+"""DomiNode SuperAGI Toolkit -- registers all 24 DomiNode tools.
+
+Provides a ``BaseToolkit`` subclass that exposes 24 tools for interacting
+with the DomiNode rotating proxy-as-a-service platform.  The toolkit
+covers proxied HTTP fetching, wallet and usage monitoring, agentic wallet
+management, team management, x402 micropayments, and PayPal top-up.
+
+Example::
+
+    from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+    toolkit = DominusNodeToolkit()
+    tools = toolkit.get_tools()
+    # Each tool has .name, .description, .args_schema, and ._execute()
+
+Requires ``DOMINUSNODE_API_KEY`` (and optionally ``DOMINUSNODE_BASE_URL``,
+``DOMINUSNODE_PROXY_HOST``, ``DOMINUSNODE_PROXY_PORT``) to be set in
+SuperAGI's tool configuration.
+"""
+
+from __future__ import annotations
+
+from superagi.tools.base_tool import BaseToolkit
+
+from dominusnode_superagi.tools import (
+    DominusNodeAgenticTransactionsTool,
+    DominusNodeAgenticWalletBalanceTool,
+    DominusNodeBalanceTool,
+    DominusNodeCreateAgenticWalletTool,
+    DominusNodeCreateTeamTool,
+    DominusNodeDeleteAgenticWalletTool,
+    DominusNodeFreezeAgenticWalletTool,
+    DominusNodeFundAgenticWalletTool,
+    DominusNodeListAgenticWalletsTool,
+    DominusNodeListTeamsTool,
+    DominusNodeProxiedFetchTool,
+    DominusNodeProxyConfigTool,
+    DominusNodeSessionsTool,
+    DominusNodeTeamCreateKeyTool,
+    DominusNodeTeamDetailsTool,
+    DominusNodeTeamFundTool,
+    DominusNodeTeamUsageTool,
+    DominusNodeTopupPaypalTool,
+    DominusNodeUnfreezeAgenticWalletTool,
+    DominusNodeUpdateTeamMemberRoleTool,
+    DominusNodeUpdateTeamTool,
+    DominusNodeUpdateWalletPolicyTool,
+    DominusNodeUsageTool,
+    DominusNodeX402InfoTool,
+)
+
+
+class DominusNodeToolkit(BaseToolkit):
+    """SuperAGI toolkit providing 22 DomiNode proxy service tools.
+
+    Tools include:
+
+    **Proxy Operations:**
+      - Proxied Fetch -- fetch URLs through rotating proxies
+      - Proxy Config -- get proxy endpoint configuration
+      - List Sessions -- view active proxy sessions
+
+    **Wallet:**
+      - Check Balance -- view wallet balance
+      - Check Usage -- view usage statistics
+      - TopUp PayPal -- create a PayPal wallet top-up order
+
+    **Agentic Wallets:**
+      - Create, Fund, Balance, List, Transactions
+      - Freeze, Unfreeze, Delete
+
+    **Teams:**
+      - Create, List, Details, Fund, Create Key, Usage
+      - Update Team, Update Member Role
+
+    **Payments:**
+      - X402 Info -- micropayment protocol details
+    """
+
+    name: str = "DomiNode Proxy Toolkit"
+    description: str = (
+        "Rotating proxy-as-a-service with wallet billing, team management, "
+        "agentic sub-wallets, and x402 micropayments. Datacenter proxies at "
+        "$3/GB, residential at $5/GB."
+    )
+
+    def get_tools(self) -> list:
+        """Return all 24 DomiNode tools for registration in SuperAGI.
+
+        Returns:
+            A list of 22 BaseTool instances covering proxy, wallet, team,
+            and payment operations.
+        """
+        return [
+            DominusNodeProxiedFetchTool(),
+            DominusNodeBalanceTool(),
+            DominusNodeUsageTool(),
+            DominusNodeProxyConfigTool(),
+            DominusNodeSessionsTool(),
+            DominusNodeCreateAgenticWalletTool(),
+            DominusNodeFundAgenticWalletTool(),
+            DominusNodeAgenticWalletBalanceTool(),
+            DominusNodeListAgenticWalletsTool(),
+            DominusNodeAgenticTransactionsTool(),
+            DominusNodeFreezeAgenticWalletTool(),
+            DominusNodeUnfreezeAgenticWalletTool(),
+            DominusNodeDeleteAgenticWalletTool(),
+            DominusNodeUpdateWalletPolicyTool(),
+            DominusNodeCreateTeamTool(),
+            DominusNodeListTeamsTool(),
+            DominusNodeTeamDetailsTool(),
+            DominusNodeTeamFundTool(),
+            DominusNodeTeamCreateKeyTool(),
+            DominusNodeTeamUsageTool(),
+            DominusNodeUpdateTeamTool(),
+            DominusNodeUpdateTeamMemberRoleTool(),
+            DominusNodeX402InfoTool(),
+            DominusNodeTopupPaypalTool(),
+        ]
+
+    def get_env_keys(self) -> list:
+        """Return the environment/config keys needed by DomiNode tools.
+
+        Returns:
+            A list of configuration key names that SuperAGI should prompt
+            the user to set.
+        """
+        return [
+            "DOMINUSNODE_API_KEY",
+            "DOMINUSNODE_BASE_URL",
+            "DOMINUSNODE_PROXY_HOST",
+            "DOMINUSNODE_PROXY_PORT",
+        ]