@dominusnode/openai-functions 1.0.0 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
-# DomiNode OpenAI-Compatible Function Calling Schemas
+# Dominus Node OpenAI-Compatible Function Calling Schemas
 
-OpenAI function-calling schemas and handler implementations for the DomiNode rotating proxy-as-a-service platform. These schemas allow any LLM with function/tool calling support to interact with DomiNode's proxy network, wallet, and agentic wallet APIs.
+OpenAI function-calling schemas and handler implementations for the Dominus Node rotating proxy-as-a-service platform. These schemas allow any LLM with function/tool calling support to interact with Dominus Node's proxy network, wallet, and agentic wallet APIs.
 
 ## What This Is
 
@@ -9,8 +9,8 @@ This directory contains:
 | File | Description |
 |------|-------------|
 | `functions.json` | Array of 8 OpenAI function definitions (JSON Schema format) |
-| `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 schemas follow the [OpenAI function calling specification](https://platform.openai.com/docs/guides/function-calling), which has become a de facto standard adopted by Claude (tool_use), Gemini, Mistral, Llama, and others.
 
@@ -18,7 +18,7 @@ The function schemas follow the [OpenAI function calling specification](https://
 
 | 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 |
@@ -38,7 +38,7 @@ from handler import create_dominusnode_function_handler
 with open("functions.json") as f:
     functions = 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",
@@ -49,7 +49,7 @@ client = openai.OpenAI()
 response = client.chat.completions.create(
     model="gpt-4o",
     messages=[
-        {"role": "system", "content": "You have access to DomiNode proxy tools."},
+        {"role": "system", "content": "You have access to Dominus Node proxy tools."},
         {"role": "user", "content": "What is my current proxy balance?"},
     ],
     functions=functions,
@@ -62,14 +62,14 @@ if message.function_call:
     name = message.function_call.name
     args = json.loads(message.function_call.arguments)
 
-    # Dispatch to DomiNode handler
+    # Dispatch to Dominus Node handler
     result = await dominusnode(name, args)
 
     # Send the result back to the LLM
     response = client.chat.completions.create(
         model="gpt-4o",
         messages=[
-            {"role": "system", "content": "You have access to DomiNode proxy tools."},
+            {"role": "system", "content": "You have access to Dominus Node proxy tools."},
             {"role": "user", "content": "What is my current proxy balance?"},
             message,
             {"role": "function", "name": name, "content": result},
@@ -100,7 +100,7 @@ tools = [
     for fn in functions
 ]
 
-# Create the DomiNode handler
+# Create the Dominus Node handler
 dominusnode = create_dominusnode_function_handler(
     api_key="dn_live_your_api_key_here",
 )
@@ -112,7 +112,7 @@ response = client.messages.create(
     max_tokens=1024,
     tools=tools,
     messages=[
-        {"role": "user", "content": "Check my DomiNode proxy balance and usage this week."},
+        {"role": "user", "content": "Check my Dominus Node proxy balance and usage this week."},
     ],
 )
 
@@ -127,7 +127,7 @@ for block in response.content:
             max_tokens=1024,
             tools=tools,
             messages=[
-                {"role": "user", "content": "Check my DomiNode proxy balance and usage this week."},
+                {"role": "user", "content": "Check my Dominus Node proxy balance and usage this week."},
                 {"role": "assistant", "content": response.content},
                 {
                     "role": "user",
@@ -204,7 +204,7 @@ The `functions.json` file follows the standard OpenAI function definition schema
 | **OpenAI SDK** | Pass `functions` directly to `chat.completions.create()` |
 | **Anthropic SDK** | Convert to `tools` format (rename `parameters` to `input_schema`) |
 | **Google Gemini** | Convert to `FunctionDeclaration` objects |
-| **LangChain** | Use `StructuredTool.from_function()` or the DomiNode LangChain integration |
+| **LangChain** | Use `StructuredTool.from_function()` or the Dominus Node LangChain integration |
 | **Vercel AI SDK** | See the `integrations/vercel-ai/` package |
 | **LlamaIndex** | Use `FunctionTool.from_defaults()` with the handler |
 | **Ollama** | Pass as `tools` parameter in chat API |

package/dist/handler.d.ts

@@ -1,8 +1,8 @@
 /**
- * DomiNode OpenAI-compatible function calling handler (TypeScript).
+ * Dominus Node OpenAI-compatible function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * OpenAI function calls to the DomiNode REST API. Works with any
+ * OpenAI function calls to the Dominus Node REST API. Works with any
  * function-calling LLM system: OpenAI GPT, Anthropic Claude tool_use,
  * Google Gemini, or custom implementations.
  *
@@ -40,23 +40,23 @@ 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;
 }
 /**
  * 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 OpenAI-compatible function calling.
+ * Create a Dominus Node function handler for OpenAI-compatible 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 OpenAI-compatible function calling handler (TypeScript).
+ * Dominus Node OpenAI-compatible function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * OpenAI function calls to the DomiNode REST API. Works with any
+ * OpenAI function calls to the Dominus Node REST API. Works with any
  * function-calling LLM system: OpenAI GPT, Anthropic Claude tool_use,
  * Google Gemini, or custom implementations.
  *
@@ -364,10 +364,10 @@ function periodToDateRange(period) {
     return { since: since.toISOString(), until };
 }
 /**
- * Create a DomiNode function handler for OpenAI-compatible function calling.
+ * Create a Dominus Node function handler for OpenAI-compatible 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>
@@ -487,7 +487,7 @@ export function createDominusNodeFunctionHandler(config) {
         }
         const username = userParts.join("-");
         // Use the proxy gateway for the actual request
-        // The handler routes through the DomiNode proxy endpoint
+        // The handler routes through the Dominus Node proxy endpoint
         try {
             // Strip security-sensitive headers from user-provided headers
             const BLOCKED_HEADERS = new Set([
@@ -640,7 +640,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.",
             });
         }
     }

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": {
@@ -38,7 +38,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": {},
@@ -47,7 +47,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": {
@@ -63,7 +63,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": {},
@@ -72,7 +72,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": {},
@@ -402,7 +402,7 @@
   },
   {
     "name": "dominusnode_topup_paypal",
-    "description": "Create a PayPal payment order to top up your DomiNode wallet. Returns an approval URL where you complete the payment. After approval, the wallet is credited automatically. Lower fees than Stripe for PayPal users. Minimum $5 (500 cents), maximum $1,000 (100,000 cents).",
+    "description": "Create a PayPal payment order to top up your Dominus Node wallet. Returns an approval URL where you complete the payment. After approval, the wallet is credited automatically. Lower fees than Stripe for PayPal users. Minimum $5 (500 cents), maximum $1,000 (100,000 cents).",
     "parameters": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dominusnode/openai-functions",
-  "version": "1.0.0",
-  "description": "DomiNode OpenAI-compatible function calling handler — dispatches LLM function calls to the DomiNode REST API",
+  "version": "1.0.1",
+  "description": "Dominus Node OpenAI-compatible function calling handler — dispatches LLM function calls to the Dominus Node REST API",
   "main": "dist/handler.js",
   "types": "dist/handler.d.ts",
   "type": "module",