@dominusnode/ai-tools 1.0.0

package/README.md

@@ -0,0 +1,188 @@
+# @dominusnode/ai-tools
+
+Vercel AI SDK tools for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform. Gives AI agents the ability to make proxied HTTP requests, check wallet balance, monitor usage, and manage proxy sessions.
+
+## Installation
+
+```bash
+npm install @dominusnode/ai-tools ai zod @dominusnode/sdk
+```
+
+## Quick Start
+
+### Next.js Route Handler
+
+```ts
+// app/api/chat/route.ts
+import { streamText } from "ai";
+import { openai } from "@ai-sdk/openai";
+import { createDominusNodeTools } from "@dominusnode/ai-tools";
+
+export async function POST(req: Request) {
+  const { messages } = await req.json();
+
+  const tools = await createDominusNodeTools({
+    apiKey: process.env.DOMINUSNODE_API_KEY!,
+    baseUrl: process.env.DOMINUSNODE_BASE_URL, // optional
+  });
+
+  const result = streamText({
+    model: openai("gpt-4o"),
+    messages,
+    tools,
+    maxSteps: 5,
+  });
+
+  return result.toDataStreamResponse();
+}
+```
+
+### Standalone with `generateText`
+
+```ts
+import { generateText } from "ai";
+import { openai } from "@ai-sdk/openai";
+import { createDominusNodeTools } from "@dominusnode/ai-tools";
+
+const tools = await createDominusNodeTools({
+  apiKey: "dn_live_your_api_key_here",
+});
+
+const { text } = await generateText({
+  model: openai("gpt-4o"),
+  tools,
+  maxSteps: 10,
+  prompt: "Fetch https://httpbin.org/ip through a US datacenter proxy and tell me the IP",
+});
+
+console.log(text);
+```
+
+## Tools
+
+### `proxiedFetch`
+
+Make HTTP requests through DomiNode's rotating proxy network with geo-targeting support.
+
+| Parameter   | Type                                    | Required | Description                                  |
+|-------------|-----------------------------------------|----------|----------------------------------------------|
+| `url`       | `string` (URL)                          | Yes      | The URL to fetch through the proxy           |
+| `method`    | `"GET" \| "POST" \| "PUT" \| "DELETE"` | No       | HTTP method (default: `GET`)                 |
+| `country`   | `string` (2-letter ISO)                 | No       | Country code for geo-targeting               |
+| `proxyType` | `"dc" \| "residential"`                 | No       | Proxy type (default: `dc`)                   |
+| `headers`   | `Record<string, string>`                | No       | Additional HTTP headers                      |
+| `body`      | `string`                                | No       | Request body for POST/PUT                    |
+
+**Returns:** `{ status, statusText, headers, body, proxyType, country }`
+
+**Security:** URLs are validated to prevent SSRF attacks. Blocked targets include localhost, private IP ranges (10.x, 172.16-31.x, 192.168.x), link-local (169.254.x), IPv6 loopback/ULA, and non-HTTP protocols. Response bodies are truncated to 4,000 characters. API keys are scrubbed from error messages.
+
+### `checkBalance`
+
+Check the current DomiNode wallet balance.
+
+**Parameters:** None
+
+**Returns:** `{ balanceCents, balanceUsd, currency, lastToppedUp }`
+
+### `checkUsage`
+
+Check proxy usage statistics for a given time period.
+
+| Parameter | Type                            | Required | Description              |
+|-----------|---------------------------------|----------|--------------------------|
+| `period`  | `"day" \| "week" \| "month"`   | No       | Time window for stats    |
+
+**Returns:** `{ summary: { totalBytes, totalGB, totalCostCents, totalCostUsd, requestCount }, period, recordCount }`
+
+### `getProxyConfig`
+
+Get proxy endpoint configuration and supported countries.
+
+**Parameters:** None
+
+**Returns:** `{ endpoints: { http, socks5 }, supportedCountries, blockedCountries, geoTargeting }`
+
+### `listSessions`
+
+List all active proxy sessions.
+
+**Parameters:** None
+
+**Returns:** `{ sessions: [{ id, startedAt, status }], count }`
+
+## Advanced Usage
+
+### Using an Existing Client
+
+If you already manage a `DominusNodeClient` instance:
+
+```ts
+import { DominusNodeClient } from "@dominusnode/sdk";
+import { createDominusNodeToolsFromClient } from "@dominusnode/ai-tools";
+
+const client = new DominusNodeClient({ baseUrl: "http://localhost:3000" });
+await client.connectWithKey("dn_live_your_key");
+
+const tools = createDominusNodeToolsFromClient(client, "dn_live_your_key");
+```
+
+### Using Individual Tool Creators
+
+For fine-grained control, import individual tool factory functions:
+
+```ts
+import {
+  createProxiedFetchTool,
+  createCheckBalanceTool,
+} from "@dominusnode/ai-tools";
+import { DominusNodeClient } from "@dominusnode/sdk";
+
+const client = new DominusNodeClient();
+await client.connectWithKey("dn_live_your_key");
+
+// Only expose the tools you need
+const tools = {
+  proxiedFetch: createProxiedFetchTool(client, "dn_live_your_key"),
+  checkBalance: createCheckBalanceTool(client),
+};
+```
+
+### With Anthropic Claude
+
+```ts
+import { generateText } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+import { createDominusNodeTools } from "@dominusnode/ai-tools";
+
+const tools = await createDominusNodeTools({
+  apiKey: process.env.DOMINUSNODE_API_KEY!,
+});
+
+const { text } = await generateText({
+  model: anthropic("claude-sonnet-4-20250514"),
+  tools,
+  maxSteps: 5,
+  prompt: "Check my balance, then fetch https://example.com through a German proxy",
+});
+```
+
+## Environment Variables
+
+| Variable                | Description                           | Default                         |
+|-------------------------|---------------------------------------|---------------------------------|
+| `DOMINUSNODE_API_KEY`   | DomiNode API key                      | Required                        |
+| `DOMINUSNODE_BASE_URL`  | DomiNode API base URL                 | `https://api.dominusnode.com`   |
+
+## Pricing
+
+Proxy usage is billed from your DomiNode wallet:
+
+- **Datacenter (dc):** $3.00/GB
+- **Residential:** $5.00/GB
+
+Check your balance with the `checkBalance` tool before heavy usage.
+
+## License
+
+MIT

package/dist/create-tools.d.ts

@@ -0,0 +1,100 @@
+import { DominusNodeClient } from "@dominusnode/sdk";
+import { createProxiedFetchTool, createCheckBalanceTool, createCheckUsageTool, createGetProxyConfigTool, createListSessionsTool, createTopupPaypalTool, createX402InfoTool, createCreateAgenticWalletTool, createFundAgenticWalletTool, createAgenticWalletBalanceTool, createListAgenticWalletsTool, createAgenticTransactionsTool, createFreezeAgenticWalletTool, createUnfreezeAgenticWalletTool, createDeleteAgenticWalletTool, createUpdateWalletPolicyTool } from "./tools.js";
+/**
+ * Configuration for creating DomiNode AI tools.
+ */
+export interface DominusNodeToolsConfig {
+    /**
+     * DomiNode API key for authentication.
+     * Must start with "dn_live_" or "dn_test_".
+     */
+    apiKey: string;
+    /**
+     * Base URL for the DomiNode API.
+     * @default "https://api.dominusnode.com"
+     */
+    baseUrl?: string;
+    /**
+     * Proxy host override.
+     * @default "proxy.dominusnode.com"
+     */
+    proxyHost?: string;
+    /**
+     * HTTP proxy port override.
+     * @default 8080
+     */
+    httpProxyPort?: number;
+    /**
+     * SOCKS5 proxy port override.
+     * @default 1080
+     */
+    socks5ProxyPort?: number;
+}
+/**
+ * The set of DomiNode tools for use with the Vercel AI SDK.
+ */
+export interface DominusNodeTools {
+    /** Make HTTP requests through DomiNode's rotating proxy network. */
+    proxiedFetch: ReturnType<typeof createProxiedFetchTool>;
+    /** Check the current wallet balance. */
+    checkBalance: ReturnType<typeof createCheckBalanceTool>;
+    /** Check proxy usage statistics for a given period. */
+    checkUsage: ReturnType<typeof createCheckUsageTool>;
+    /** Get proxy endpoint configuration and supported countries. */
+    getProxyConfig: ReturnType<typeof createGetProxyConfigTool>;
+    /** List all active proxy sessions. */
+    listSessions: ReturnType<typeof createListSessionsTool>;
+    /** Top up wallet balance via PayPal. */
+    topupPaypal: ReturnType<typeof createTopupPaypalTool>;
+    /** Get x402 micropayment protocol information. */
+    x402Info: ReturnType<typeof createX402InfoTool>;
+    /** Create a new agentic sub-wallet. */
+    createAgenticWallet: ReturnType<typeof createCreateAgenticWalletTool>;
+    /** Fund an agentic sub-wallet from the main wallet. */
+    fundAgenticWallet: ReturnType<typeof createFundAgenticWalletTool>;
+    /** Check the balance of an agentic sub-wallet. */
+    agenticWalletBalance: ReturnType<typeof createAgenticWalletBalanceTool>;
+    /** List all agentic sub-wallets. */
+    listAgenticWallets: ReturnType<typeof createListAgenticWalletsTool>;
+    /** List transactions for an agentic sub-wallet. */
+    agenticTransactions: ReturnType<typeof createAgenticTransactionsTool>;
+    /** Freeze an agentic sub-wallet. */
+    freezeAgenticWallet: ReturnType<typeof createFreezeAgenticWalletTool>;
+    /** Unfreeze an agentic sub-wallet. */
+    unfreezeAgenticWallet: ReturnType<typeof createUnfreezeAgenticWalletTool>;
+    /** Delete an agentic sub-wallet. */
+    deleteAgenticWallet: ReturnType<typeof createDeleteAgenticWalletTool>;
+    /** Update the policy of an agentic sub-wallet. */
+    updateWalletPolicy: ReturnType<typeof createUpdateWalletPolicyTool>;
+}
+/**
+ * Create a set of Vercel AI SDK tools for interacting with the DomiNode
+ * rotating proxy service.
+ *
+ * @example
+ * ```ts
+ * import { createDominusNodeTools } from "@dominusnode/ai-tools";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const tools = await createDominusNodeTools({
+ *   apiKey: process.env.DOMINUSNODE_API_KEY!,
+ * });
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4o"),
+ *   tools,
+ *   prompt: "Check my proxy balance and fetch https://httpbin.org/ip through a US proxy",
+ * });
+ * ```
+ */
+export declare function createDominusNodeTools(config: DominusNodeToolsConfig): Promise<DominusNodeTools>;
+/**
+ * Create DomiNode AI tools from an already-authenticated client instance.
+ * Use this when you manage the DominusNodeClient lifecycle yourself.
+ *
+ * @param client - An already-authenticated DominusNodeClient.
+ * @param apiKey - The API key (needed for building proxy URLs).
+ */
+export declare function createDominusNodeToolsFromClient(client: DominusNodeClient, apiKey: string): DominusNodeTools;
+//# sourceMappingURL=create-tools.d.ts.map

package/dist/create-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tools.d.ts","sourceRoot":"","sources":["../src/create-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,YAAY,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACxD,wCAAwC;IACxC,YAAY,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACxD,uDAAuD;IACvD,UAAU,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACpD,gEAAgE;IAChE,cAAc,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,sCAAsC;IACtC,YAAY,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACxD,wCAAwC;IACxC,WAAW,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IACtD,kDAAkD;IAClD,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAChD,uCAAuC;IACvC,mBAAmB,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;IACtE,uDAAuD;IACvD,iBAAiB,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IAClE,kDAAkD;IAClD,oBAAoB,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC;IACxE,oCAAoC;IACpC,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;IACpE,mDAAmD;IACnD,mBAAmB,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;IACtE,oCAAoC;IACpC,mBAAmB,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;IACtE,sCAAsC;IACtC,qBAAqB,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;IAC1E,oCAAoC;IACpC,mBAAmB,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;IACtE,kDAAkD;IAClD,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAoC3B;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,GACb,gBAAgB,CAuBlB"}

package/dist/create-tools.js

@@ -0,0 +1,88 @@
+import { DominusNodeClient } from "@dominusnode/sdk";
+import { createProxiedFetchTool, createCheckBalanceTool, createCheckUsageTool, createGetProxyConfigTool, createListSessionsTool, createTopupPaypalTool, createX402InfoTool, createCreateAgenticWalletTool, createFundAgenticWalletTool, createAgenticWalletBalanceTool, createListAgenticWalletsTool, createAgenticTransactionsTool, createFreezeAgenticWalletTool, createUnfreezeAgenticWalletTool, createDeleteAgenticWalletTool, createUpdateWalletPolicyTool, } from "./tools.js";
+/**
+ * Create a set of Vercel AI SDK tools for interacting with the DomiNode
+ * rotating proxy service.
+ *
+ * @example
+ * ```ts
+ * import { createDominusNodeTools } from "@dominusnode/ai-tools";
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const tools = await createDominusNodeTools({
+ *   apiKey: process.env.DOMINUSNODE_API_KEY!,
+ * });
+ *
+ * const result = await generateText({
+ *   model: openai("gpt-4o"),
+ *   tools,
+ *   prompt: "Check my proxy balance and fetch https://httpbin.org/ip through a US proxy",
+ * });
+ * ```
+ */
+export async function createDominusNodeTools(config) {
+    // Validate API key format
+    if (!config.apiKey || typeof config.apiKey !== "string") {
+        throw new Error("apiKey is required and must be a non-empty string");
+    }
+    if (!config.apiKey.startsWith("dn_live_") && !config.apiKey.startsWith("dn_test_")) {
+        throw new Error('apiKey must start with "dn_live_" or "dn_test_"');
+    }
+    // Create and authenticate the client
+    const client = new DominusNodeClient({
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl,
+        proxyHost: config.proxyHost,
+    });
+    await client.connectWithKey(config.apiKey);
+    return {
+        proxiedFetch: createProxiedFetchTool(client, config.apiKey),
+        checkBalance: createCheckBalanceTool(client),
+        checkUsage: createCheckUsageTool(client),
+        getProxyConfig: createGetProxyConfigTool(client),
+        listSessions: createListSessionsTool(client),
+        topupPaypal: createTopupPaypalTool(client),
+        x402Info: createX402InfoTool(client),
+        createAgenticWallet: createCreateAgenticWalletTool(client),
+        fundAgenticWallet: createFundAgenticWalletTool(client),
+        agenticWalletBalance: createAgenticWalletBalanceTool(client),
+        listAgenticWallets: createListAgenticWalletsTool(client),
+        agenticTransactions: createAgenticTransactionsTool(client),
+        freezeAgenticWallet: createFreezeAgenticWalletTool(client),
+        unfreezeAgenticWallet: createUnfreezeAgenticWalletTool(client),
+        deleteAgenticWallet: createDeleteAgenticWalletTool(client),
+        updateWalletPolicy: createUpdateWalletPolicyTool(client),
+    };
+}
+/**
+ * Create DomiNode AI tools from an already-authenticated client instance.
+ * Use this when you manage the DominusNodeClient lifecycle yourself.
+ *
+ * @param client - An already-authenticated DominusNodeClient.
+ * @param apiKey - The API key (needed for building proxy URLs).
+ */
+export function createDominusNodeToolsFromClient(client, apiKey) {
+    if (!apiKey || typeof apiKey !== "string") {
+        throw new Error("apiKey is required and must be a non-empty string");
+    }
+    return {
+        proxiedFetch: createProxiedFetchTool(client, apiKey),
+        checkBalance: createCheckBalanceTool(client),
+        checkUsage: createCheckUsageTool(client),
+        getProxyConfig: createGetProxyConfigTool(client),
+        listSessions: createListSessionsTool(client),
+        topupPaypal: createTopupPaypalTool(client),
+        x402Info: createX402InfoTool(client),
+        createAgenticWallet: createCreateAgenticWalletTool(client),
+        fundAgenticWallet: createFundAgenticWalletTool(client),
+        agenticWalletBalance: createAgenticWalletBalanceTool(client),
+        listAgenticWallets: createListAgenticWalletsTool(client),
+        agenticTransactions: createAgenticTransactionsTool(client),
+        freezeAgenticWallet: createFreezeAgenticWalletTool(client),
+        unfreezeAgenticWallet: createUnfreezeAgenticWalletTool(client),
+        deleteAgenticWallet: createDeleteAgenticWalletTool(client),
+        updateWalletPolicy: createUpdateWalletPolicyTool(client),
+    };
+}
+//# sourceMappingURL=create-tools.js.map

package/dist/create-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tools.js","sourceRoot":"","sources":["../src/create-tools.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createDominusNodeTools, createDominusNodeToolsFromClient, } from "./create-tools.js";
+export type { DominusNodeToolsConfig, DominusNodeTools, } from "./create-tools.js";
+export { createProxiedFetchTool, createCheckBalanceTool, createCheckUsageTool, createGetProxyConfigTool, createListSessionsTool, createTopupPaypalTool, createX402InfoTool, createCreateAgenticWalletTool, createFundAgenticWalletTool, createAgenticWalletBalanceTool, createListAgenticWalletsTool, createAgenticTransactionsTool, createFreezeAgenticWalletTool, createUnfreezeAgenticWalletTool, createDeleteAgenticWalletTool, createUpdateWalletPolicyTool, } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Factory functions
+export { createDominusNodeTools, createDominusNodeToolsFromClient, } from "./create-tools.js";
+// Individual tool creators (for advanced use cases)
+export { createProxiedFetchTool, createCheckBalanceTool, createCheckUsageTool, createGetProxyConfigTool, createListSessionsTool, createTopupPaypalTool, createX402InfoTool, createCreateAgenticWalletTool, createFundAgenticWalletTool, createAgenticWalletBalanceTool, createListAgenticWalletsTool, createAgenticTransactionsTool, createFreezeAgenticWalletTool, createUnfreezeAgenticWalletTool, createDeleteAgenticWalletTool, createUpdateWalletPolicyTool, } from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAM3B,oDAAoD;AACpD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,86 @@
+import type { DominusNodeClient } from "@dominusnode/sdk";
+/** RFC-1918, loopback, link-local, and other non-routable CIDRs. */
+declare function isPrivateIp(hostname: string): boolean;
+/** Validate a URL is safe to fetch through the proxy. */
+declare function validateUrl(urlStr: string): {
+    valid: true;
+    url: URL;
+} | {
+    valid: false;
+    error: string;
+};
+/** Truncate a string and append a notice if it exceeds the limit. */
+declare function truncateBody(body: string): string;
+declare function filterHeaders(headers: Record<string, string>): Record<string, string>;
+declare const UUID_RE: RegExp;
+declare const DOMAIN_RE: RegExp;
+/**
+ * Creates the `proxiedFetch` tool that makes HTTP requests through DomiNode's
+ * rotating proxy network.
+ */
+export declare function createProxiedFetchTool(client: DominusNodeClient, apiKey: string): any;
+/**
+ * Creates the `checkBalance` tool that retrieves the current wallet balance.
+ */
+export declare function createCheckBalanceTool(client: DominusNodeClient): any;
+/**
+ * Creates the `checkUsage` tool that retrieves usage statistics.
+ */
+export declare function createCheckUsageTool(client: DominusNodeClient): any;
+/**
+ * Creates the `getProxyConfig` tool that retrieves proxy endpoint configuration.
+ */
+export declare function createGetProxyConfigTool(client: DominusNodeClient): any;
+/**
+ * Creates the `listSessions` tool that lists active proxy sessions.
+ */
+export declare function createListSessionsTool(client: DominusNodeClient): any;
+/**
+ * Creates the `topupPaypal` tool that initiates a PayPal wallet top-up.
+ */
+export declare function createTopupPaypalTool(client: DominusNodeClient): any;
+/**
+ * Creates the `x402Info` tool that retrieves x402 micropayment protocol information.
+ */
+export declare function createX402InfoTool(client: DominusNodeClient): any;
+/** Make an authenticated JSON request to the DomiNode REST API. */
+declare function apiRequest(client: DominusNodeClient, method: "GET" | "POST" | "DELETE" | "PATCH", path: string, body?: Record<string, unknown>): Promise<Record<string, unknown>>;
+/**
+ * Creates a tool to create a new agentic sub-wallet with a spending limit.
+ */
+export declare function createCreateAgenticWalletTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to transfer funds from the main wallet to an agentic sub-wallet.
+ */
+export declare function createFundAgenticWalletTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to check the balance and details of an agentic sub-wallet.
+ */
+export declare function createAgenticWalletBalanceTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to list all agentic sub-wallets for the current user.
+ */
+export declare function createListAgenticWalletsTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to list recent transactions for an agentic sub-wallet.
+ */
+export declare function createAgenticTransactionsTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to freeze an agentic sub-wallet to prevent further spending.
+ */
+export declare function createFreezeAgenticWalletTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to unfreeze a previously frozen agentic sub-wallet.
+ */
+export declare function createUnfreezeAgenticWalletTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to delete an agentic sub-wallet. Must be active (not frozen).
+ * Remaining balance returns to main wallet.
+ */
+export declare function createDeleteAgenticWalletTool(client: DominusNodeClient): any;
+/**
+ * Creates a tool to update the policy (daily limit, allowed domains) of an agentic sub-wallet.
+ */
+export declare function createUpdateWalletPolicyTool(client: DominusNodeClient): any;
+export { validateUrl, isPrivateIp, truncateBody, filterHeaders, apiRequest, UUID_RE, DOMAIN_RE };
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D,oEAAoE;AACpE,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoD9C;AAED,yDAAyD;AACzD,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkDhG;AAKD,qEAAqE;AACrE,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1C;AAkBD,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9E;AAsFD,QAAA,MAAM,OAAO,QAAoE,CAAC;AAClF,QAAA,MAAM,SAAS,QAAuE,CAAC;AAYvF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,OAgK/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,OAsB/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,OAyD7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,OA+BjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,OAuB/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,OA4B9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,OAmB3D;AAMD,mEAAmE;AACnE,iBAAe,UAAU,CACvB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6BlC;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,OA6BtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iBAAiB,OAepE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,iBAAiB,OAcvE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,OAYrE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,OAgBtE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,OActE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,iBAAiB,OAcxE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,OActE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,OAwBrE;AAGD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC"}