@dominusnode/openai-functions 1.1.0 → 1.3.0

package/README.md

@@ -6,26 +6,26 @@ OpenAI function-calling schemas and handler implementations for the Dominus Node
 
 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 Dominus Node API |
-| `handler.py` | Python handler that dispatches function calls to the Dominus Node API |
+| File             | Description                                                               |
+| ---------------- | ------------------------------------------------------------------------- |
+| `functions.json` | Array of 8 OpenAI function definitions (JSON Schema format)               |
+| `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.
 
 ## Available Functions
 
-| Function | Description | Auth Required |
-|----------|-------------|---------------|
-| `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 |
-| `dominusnode_list_sessions` | List currently active proxy sessions | Yes |
-| `dominusnode_create_agentic_wallet` | Create a sub-wallet for an AI agent with spending limits | Yes |
-| `dominusnode_fund_agentic_wallet` | Transfer funds from main wallet to an agentic wallet | Yes |
-| `dominusnode_agentic_wallet_balance` | Check an agentic wallet's balance and status | Yes |
+| Function                             | Description                                                        | Auth Required |
+| ------------------------------------ | ------------------------------------------------------------------ | ------------- |
+| `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           |
+| `dominusnode_list_sessions`          | List currently active proxy sessions                               | Yes           |
+| `dominusnode_create_agentic_wallet`  | Create a sub-wallet for an AI agent with spending limits           | Yes           |
+| `dominusnode_fund_agentic_wallet`    | Transfer funds from main wallet to an agentic wallet               | Yes           |
+| `dominusnode_agentic_wallet_balance` | Check an agentic wallet's balance and status                       | Yes           |
 
 ## Usage with OpenAI GPT (Function Calling)
 
@@ -176,13 +176,13 @@ console.log(JSON.parse(fetchResult));
 // Example: create and fund an agentic wallet for an AI agent
 const wallet = await handler("dominusnode_create_agentic_wallet", {
   label: "research-agent-1",
-  spending_limit_cents: 500,  // $5.00 per-transaction limit
+  spending_limit_cents: 500, // $5.00 per-transaction limit
 });
 const walletData = JSON.parse(wallet);
 
 await handler("dominusnode_fund_agentic_wallet", {
   wallet_id: walletData.id,
-  amount_cents: 2000,  // Fund with $20.00
+  amount_cents: 2000, // Fund with $20.00
 });
 ```
 
@@ -199,15 +199,15 @@ The `functions.json` file follows the standard OpenAI function definition schema
 
 ### Framework-Specific Notes
 
-| Framework | How to Use |
-|-----------|-----------|
-| **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 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 |
+| Framework         | How to Use                                                                     |
+| ----------------- | ------------------------------------------------------------------------------ |
+| **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 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                                          |
 
 ## Security
 
@@ -224,6 +224,7 @@ Both handlers (TypeScript and Python) include comprehensive SSRF prevention that
 ### Header Injection Prevention
 
 User-supplied HTTP headers are filtered to block:
+
 - Security-sensitive headers (Host, Authorization, Proxy-Authorization, etc.)
 - CRLF injection attempts (headers containing \r or \n)
 - Null byte injection
@@ -248,18 +249,20 @@ Requests targeting OFAC-sanctioned countries (CU, IR, KP, RU, SY) are blocked at
 
 ## Proxy Pricing
 
-| Proxy Type | Price | Best For |
-|------------|-------|----------|
+| Proxy Type        | Price    | Best For                               |
+| ----------------- | -------- | -------------------------------------- |
 | Datacenter (`dc`) | $3.00/GB | General scraping, speed-critical tasks |
-| Residential | $5.00/GB | Anti-detection, geo-restricted content |
+| Residential       | $5.00/GB | Anti-detection, geo-restricted content |
 
 ## Dependencies
 
 ### TypeScript Handler
+
 - Node.js 18+ (uses native `fetch` and `AbortSignal.timeout`)
 - No external dependencies
 
 ### Python Handler
+
 - Python 3.8+
 - `httpx` (`pip install httpx`)
 

package/dist/handler.d.ts

@@ -1,6 +1,9 @@
 /**
  * Dominus Node OpenAI-compatible function calling handler (TypeScript).
  *
+ * 57 tools covering proxy, wallet, usage, account lifecycle, API keys,
+ * plans, and teams.
+ *
  * Provides a factory function that creates a handler for dispatching
  * OpenAI function calls to the Dominus Node REST API. Works with any
  * function-calling LLM system: OpenAI GPT, Anthropic Claude tool_use,