@dominusnode/gemini-functions 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
-# DomiNode Google Gemini / Vertex AI Function Declarations
+# Dominus Node Google Gemini / Vertex AI Function Declarations
 
-Gemini-format function declarations and handler implementations for the DomiNode rotating proxy-as-a-service platform. These declarations allow Google Gemini and Vertex AI models to interact with DomiNode's proxy network, wallet, agentic wallet, and team APIs via function calling.
+Gemini-format function declarations and handler implementations for the Dominus Node rotating proxy-as-a-service platform. These declarations allow Google Gemini and Vertex AI models to interact with Dominus Node's proxy network, wallet, agentic wallet, and team APIs via function calling.
 
 ## What This Is
 
@@ -9,8 +9,8 @@ This directory contains:
 | File | Description |
 |------|-------------|
 | `functions.json` | Array of 22 Gemini `FunctionDeclaration` objects |
-| `handler.ts` | TypeScript handler that dispatches function calls to the DomiNode API |
-| `handler.py` | Python handler that dispatches function calls to the DomiNode API |
+| `handler.ts` | TypeScript handler that dispatches function calls to the Dominus Node API |
+| `handler.py` | Python handler that dispatches function calls to the Dominus Node API |
 
 The function declarations follow the [Gemini function calling specification](https://ai.google.dev/docs/function_calling), using uppercase types (`STRING`, `INTEGER`, `OBJECT`, `BOOLEAN`, `ARRAY`) and embedding constraints in description text rather than using JSON Schema keywords like `minimum`, `maximum`, `enum`, or `default`.
 
@@ -18,7 +18,7 @@ The function declarations follow the [Gemini function calling specification](htt
 
 | Function | Description | Auth Required |
 |----------|-------------|---------------|
-| `dominusnode_proxied_fetch` | Make an HTTP request through DomiNode's rotating proxy network | Yes |
+| `dominusnode_proxied_fetch` | Make an HTTP request through Dominus Node's rotating proxy network | Yes |
 | `dominusnode_check_balance` | Check wallet balance (cents, USD, currency) | Yes |
 | `dominusnode_check_usage` | Check usage stats for a time period (day/week/month) | Yes |
 | `dominusnode_get_proxy_config` | Get proxy endpoints, supported countries, geo-targeting info | Yes |
@@ -52,7 +52,7 @@ from handler import create_dominusnode_function_handler
 with open("functions.json") as f:
     declarations = json.load(f)
 
-# Create the DomiNode handler
+# Create the Dominus Node handler
 dominusnode = create_dominusnode_function_handler(
     api_key="dn_live_your_api_key_here",
     base_url="https://api.dominusnode.com",
@@ -67,7 +67,7 @@ model = genai.GenerativeModel(
 
 # Start a chat
 chat = model.start_chat()
-response = chat.send_message("What is my DomiNode proxy balance?")
+response = chat.send_message("What is my Dominus Node proxy balance?")
 
 # Handle function calls
 for part in response.parts:

package/dist/handler.d.ts

@@ -1,8 +1,8 @@
 /**
- * DomiNode Gemini / Vertex AI function calling handler (TypeScript).
+ * Dominus Node Gemini / Vertex AI function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * Google Gemini function calls to the DomiNode REST API. Works with
+ * Google Gemini function calls to the Dominus Node REST API. Works with
  * Gemini, Vertex AI, or any system that uses Gemini-format function
  * declarations.
  *
@@ -40,23 +40,25 @@ declare function stripDangerousKeys(obj: unknown, depth?: number): void;
 declare function safeJsonParse<T>(text: string): T;
 declare function sanitizeError(message: string): string;
 export interface DominusNodeFunctionConfig {
-    /** DomiNode API key (starts with dn_live_ or dn_test_). */
+    /** Dominus Node API key (starts with dn_live_ or dn_test_). */
     apiKey: string;
-    /** Base URL of the DomiNode REST API. Defaults to https://api.dominusnode.com */
+    /** Base URL of the Dominus Node REST API. Defaults to https://api.dominusnode.com */
     baseUrl?: string;
     /** Request timeout in milliseconds. Defaults to 30000. */
     timeoutMs?: number;
+    /** Optional agent secret for MCP agent auto-verification (bypasses reCAPTCHA). */
+    agentSecret?: string;
 }
 /**
  * Handler function type returned by createDominusNodeFunctionHandler.
- * Dispatches function calls to the DomiNode API and returns JSON string results.
+ * Dispatches function calls to the Dominus Node API and returns JSON string results.
  */
 export type FunctionHandler = (name: string, args: Record<string, unknown>) => Promise<string>;
 /**
- * Create a DomiNode function handler for Gemini / Vertex AI function calling.
+ * Create a Dominus Node function handler for Gemini / Vertex AI function calling.
  *
  * Authenticates using the provided API key, then returns a handler function
- * that dispatches function calls to the appropriate DomiNode REST API endpoint.
+ * that dispatches function calls to the appropriate Dominus Node REST API endpoint.
  *
  * @param config - API key and optional base URL / timeout.
  * @returns A handler function: (name, args) => Promise<string>

package/dist/handler.js

@@ -1,8 +1,8 @@
 /**
- * DomiNode Gemini / Vertex AI function calling handler (TypeScript).
+ * Dominus Node Gemini / Vertex AI function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * Google Gemini function calls to the DomiNode REST API. Works with
+ * Google Gemini function calls to the Dominus Node REST API. Works with
  * Gemini, Vertex AI, or any system that uses Gemini-format function
  * declarations.
  *
@@ -325,6 +325,10 @@ async function apiRequest(config, method, path, body) {
         "Content-Type": "application/json",
         Authorization: `Bearer ${config.token}`,
     };
+    if (config.agentSecret) {
+        headers["X-DominusNode-Agent"] = "mcp";
+        headers["X-DominusNode-Agent-Secret"] = config.agentSecret;
+    }
     const response = await fetch(url, {
         method,
         headers,
@@ -377,10 +381,10 @@ function periodToDateRange(period) {
     return { since: since.toISOString(), until };
 }
 /**
- * Create a DomiNode function handler for Gemini / Vertex AI function calling.
+ * Create a Dominus Node function handler for Gemini / Vertex AI function calling.
  *
  * Authenticates using the provided API key, then returns a handler function
- * that dispatches function calls to the appropriate DomiNode REST API endpoint.
+ * that dispatches function calls to the appropriate Dominus Node REST API endpoint.
  *
  * @param config - API key and optional base URL / timeout.
  * @returns A handler function: (name, args) => Promise<string>
@@ -405,6 +409,7 @@ export { isPrivateIp, validateUrl, normalizeIpv4, sanitizeError, stripDangerousK
 export function createDominusNodeFunctionHandler(config) {
     const baseUrl = config.baseUrl ?? "https://api.dominusnode.com";
     const timeoutMs = config.timeoutMs ?? 30_000;
+    const agentSecret = config.agentSecret || process.env.DOMINUSNODE_AGENT_SECRET;
     if (!config.apiKey || typeof config.apiKey !== "string") {
         throw new Error("apiKey is required and must be a non-empty string");
     }
@@ -412,12 +417,17 @@ export function createDominusNodeFunctionHandler(config) {
     let authToken = null;
     let authPromise = null;
     async function authenticate() {
+        const authHeaders = {
+            "User-Agent": "dominusnode-gemini/1.0.0",
+            "Content-Type": "application/json",
+        };
+        if (agentSecret) {
+            authHeaders["X-DominusNode-Agent"] = "mcp";
+            authHeaders["X-DominusNode-Agent-Secret"] = agentSecret;
+        }
         const response = await fetch(`${baseUrl}/api/auth/verify-key`, {
             method: "POST",
-            headers: {
-                "User-Agent": "dominusnode-gemini/1.0.0",
-                "Content-Type": "application/json",
-            },
+            headers: authHeaders,
             body: JSON.stringify({ apiKey: config.apiKey }),
             signal: AbortSignal.timeout(timeoutMs),
             redirect: "error",
@@ -445,7 +455,7 @@ export function createDominusNodeFunctionHandler(config) {
     function api(method, path, body) {
         if (!authToken)
             throw new Error("Not authenticated");
-        return apiRequest({ baseUrl, timeoutMs, token: authToken }, method, path, body);
+        return apiRequest({ baseUrl, timeoutMs, token: authToken, agentSecret }, method, path, body);
     }
     // -----------------------------------------------------------------------
     // Function handlers
@@ -645,7 +655,7 @@ export function createDominusNodeFunctionHandler(config) {
         catch (err) {
             return JSON.stringify({
                 error: `Proxy fetch failed: ${sanitizeError(err instanceof Error ? err.message : String(err))}`,
-                hint: "Ensure the DomiNode proxy gateway is running and accessible.",
+                hint: "Ensure the Dominus Node proxy gateway is running and accessible.",
             });
         }
     }
@@ -953,6 +963,43 @@ export function createDominusNodeFunctionHandler(config) {
         const result = await api("POST", "/api/wallet/topup/paypal", { amountCents });
         return JSON.stringify(result);
     }
+    async function handleTopupStripe(args) {
+        const amountCents = args.amount_cents;
+        if (!Number.isInteger(amountCents) ||
+            amountCents < 500 ||
+            amountCents > 100_000) {
+            return JSON.stringify({
+                error: "amount_cents must be an integer between 500 ($5) and 100,000 ($1,000)",
+            });
+        }
+        const result = await api("POST", "/api/wallet/topup/stripe", { amountCents });
+        return JSON.stringify(result);
+    }
+    const VALID_CRYPTO_CURRENCIES = new Set([
+        "btc", "eth", "ltc", "xmr", "zec", "usdc", "sol", "usdt", "dai", "bnb", "link",
+    ]);
+    async function handleTopupCrypto(args) {
+        const amountUsd = args.amount_usd;
+        const currency = String(args.currency ?? "").toLowerCase();
+        if (typeof amountUsd !== "number" ||
+            !Number.isFinite(amountUsd) ||
+            amountUsd < 5 ||
+            amountUsd > 1_000) {
+            return JSON.stringify({
+                error: "amount_usd must be a number between 5 and 1,000",
+            });
+        }
+        if (!VALID_CRYPTO_CURRENCIES.has(currency)) {
+            return JSON.stringify({
+                error: `currency must be one of: ${[...VALID_CRYPTO_CURRENCIES].join(", ")}`,
+            });
+        }
+        const result = await api("POST", "/api/wallet/topup/crypto", {
+            amountUsd,
+            currency,
+        });
+        return JSON.stringify(result);
+    }
     // -----------------------------------------------------------------------
     // Dispatch table
     // -----------------------------------------------------------------------
@@ -979,6 +1026,8 @@ export function createDominusNodeFunctionHandler(config) {
         dominusnode_update_team: handleUpdateTeam,
         dominusnode_update_team_member_role: handleUpdateTeamMemberRole,
         dominusnode_topup_paypal: handleTopupPaypal,
+        dominusnode_topup_stripe: handleTopupStripe,
+        dominusnode_topup_crypto: handleTopupCrypto,
         dominusnode_x402_info: handleX402Info,
         dominusnode_update_wallet_policy: handleUpdateWalletPolicy,
     };

package/functions.json

@@ -1,7 +1,7 @@
 [
   {
     "name": "dominusnode_proxied_fetch",
-    "description": "Make an HTTP request through DomiNode's rotating proxy network. Routes traffic through datacenter ($3/GB) or residential ($5/GB) proxies with optional geo-targeting. Useful for accessing geo-restricted content, avoiding IP blocks, or web scraping. Private/internal IPs and sanctioned countries (CU, IR, KP, RU, SY) are blocked.",
+    "description": "Make an HTTP request through Dominus Node's rotating proxy network. Routes traffic through datacenter ($3/GB) or residential ($5/GB) proxies with optional geo-targeting. Useful for accessing geo-restricted content, avoiding IP blocks, or web scraping. Private/internal IPs and sanctioned countries (CU, IR, KP, RU, SY) are blocked.",
     "parameters": {
       "type": "OBJECT",
       "properties": {
@@ -31,7 +31,7 @@
   },
   {
     "name": "dominusnode_check_balance",
-    "description": "Check the current wallet balance for the authenticated DomiNode account. Returns balance in cents and USD, currency, and last top-up timestamp. The wallet uses a prepaid model -- top up first, then usage is debited automatically.",
+    "description": "Check the current wallet balance for the authenticated Dominus Node account. Returns balance in cents and USD, currency, and last top-up timestamp. The wallet uses a prepaid model -- top up first, then usage is debited automatically.",
     "parameters": {
       "type": "OBJECT",
       "properties": {},
@@ -40,7 +40,7 @@
   },
   {
     "name": "dominusnode_check_usage",
-    "description": "Check proxy usage statistics for the authenticated DomiNode account. Returns total bytes transferred, total cost, and request count for the specified period. Useful for monitoring bandwidth consumption and spending.",
+    "description": "Check proxy usage statistics for the authenticated Dominus Node account. Returns total bytes transferred, total cost, and request count for the specified period. Useful for monitoring bandwidth consumption and spending.",
     "parameters": {
       "type": "OBJECT",
       "properties": {
@@ -54,7 +54,7 @@
   },
   {
     "name": "dominusnode_get_proxy_config",
-    "description": "Get DomiNode proxy endpoint configuration and supported features. Returns HTTP and SOCKS5 proxy connection details, list of supported countries for geo-targeting, blocked/sanctioned countries, and geo-targeting capabilities. Use this to discover available proxy endpoints before making proxied requests.",
+    "description": "Get Dominus Node proxy endpoint configuration and supported features. Returns HTTP and SOCKS5 proxy connection details, list of supported countries for geo-targeting, blocked/sanctioned countries, and geo-targeting capabilities. Use this to discover available proxy endpoints before making proxied requests.",
     "parameters": {
       "type": "OBJECT",
       "properties": {},
@@ -63,7 +63,7 @@
   },
   {
     "name": "dominusnode_list_sessions",
-    "description": "List all currently active proxy sessions for the authenticated DomiNode account. Returns session IDs, start times, and status. Useful for monitoring concurrent connections and debugging active proxy usage.",
+    "description": "List all currently active proxy sessions for the authenticated Dominus Node account. Returns session IDs, start times, and status. Useful for monitoring concurrent connections and debugging active proxy usage.",
     "parameters": {
       "type": "OBJECT",
       "properties": {},
@@ -362,16 +362,48 @@
   },
   {
     "name": "dominusnode_topup_paypal",
-    "description": "Create a PayPal wallet top-up session. Initiates a PayPal payment for the specified amount to add funds to your DomiNode wallet. Returns a PayPal approval URL to complete the payment.",
+    "description": "Create a PayPal wallet top-up session. Initiates a PayPal payment for the specified amount to add funds to your Dominus Node wallet. Returns a PayPal approval URL to complete the payment. Minimum $5 (500 cents), maximum $1,000 (100000 cents).",
     "parameters": {
       "type": "OBJECT",
       "properties": {
         "amount_cents": {
           "type": "INTEGER",
-          "description": "Amount to top up in cents. Must be a positive integer, no greater than 2,147,483,647. Example: 1000 = $10.00."
+          "description": "Amount to top up in cents. Must be an integer between 500 ($5) and 100000 ($1,000). Example: 1000 = $10.00."
         }
       },
       "required": ["amount_cents"]
     }
+  },
+  {
+    "name": "dominusnode_topup_stripe",
+    "description": "Create a Stripe wallet top-up checkout session. Initiates a Stripe payment for the specified amount to add funds to your Dominus Node wallet. Returns a Stripe checkout URL to complete the payment. Minimum $5 (500 cents), maximum $1,000 (100000 cents).",
+    "parameters": {
+      "type": "OBJECT",
+      "properties": {
+        "amount_cents": {
+          "type": "INTEGER",
+          "description": "Amount to top up in cents. Must be an integer between 500 ($5) and 100000 ($1,000). Example: 1000 = $10.00."
+        }
+      },
+      "required": ["amount_cents"]
+    }
+  },
+  {
+    "name": "dominusnode_topup_crypto",
+    "description": "Create a cryptocurrency wallet top-up invoice. Initiates a crypto payment for the specified amount to add funds to your Dominus Node wallet. Returns payment address and amount. Minimum $5, maximum $1,000. Supported currencies: BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, LINK.",
+    "parameters": {
+      "type": "OBJECT",
+      "properties": {
+        "amount_usd": {
+          "type": "NUMBER",
+          "description": "Amount to top up in USD. Must be between 5 and 1000."
+        },
+        "currency": {
+          "type": "STRING",
+          "description": "Cryptocurrency to pay with. One of: btc, eth, ltc, xmr, zec, usdc, sol, usdt, dai, bnb, link."
+        }
+      },
+      "required": ["amount_usd", "currency"]
+    }
   }
 ]

package/package.json

@@ -1,18 +1,29 @@
 {
   "name": "@dominusnode/gemini-functions",
-  "version": "1.0.0",
-  "description": "DomiNode function declarations and handlers for Google Gemini / Vertex AI",
+  "version": "1.1.0",
+  "description": "Dominus Node function declarations and handlers for Google Gemini / Vertex AI",
   "main": "dist/handler.js",
   "types": "dist/handler.d.ts",
   "type": "module",
-  "files": ["dist/", "functions.json", "README.md", "LICENSE"],
+  "files": [
+    "dist/",
+    "functions.json",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:py": "python -m pytest test_handler.py -v"
   },
-  "keywords": ["dominusnode", "gemini", "vertex-ai", "proxy", "function-calling"],
+  "keywords": [
+    "dominusnode",
+    "gemini",
+    "vertex-ai",
+    "proxy",
+    "function-calling"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",