@dominusnode/pi-extension 1.0.0

package/dist/toolkit.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Dominus Node Pi Extension Toolkit
+ *
+ * Provides 26 tools for the pi-mono agent framework (github.com/badlogic/pi-mono).
+ * Covers proxied fetching, wallet management, agentic wallets, teams,
+ * Stripe/PayPal/crypto top-up, and x402 micropayment info.
+ *
+ * Security:
+ *  - Full SSRF protection (private IP blocking, DNS rebinding, Teredo/6to4,
+ *    IPv4-mapped/compatible IPv6, hex/octal/decimal normalization, zone ID
+ *    stripping, .localhost/.local/.internal/.arpa TLD blocking, embedded
+ *    credential blocking)
+ *  - OFAC sanctioned country validation (CU, IR, KP, RU, SY)
+ *  - Credential scrubbing in all error outputs
+ *  - Prototype pollution prevention on all parsed JSON (recursive)
+ *  - HTTP method restriction (GET/HEAD/OPTIONS only for proxied fetch)
+ *  - 10 MB response cap, 4000 char truncation, 30 s timeout
+ *  - Redirect following disabled to prevent open redirect abuse
+ *  - DNS rebinding protection on all proxied requests
+ */
+/** OFAC sanctioned countries — must never be used as geo-targeting destinations. */
+export declare const SANCTIONED_COUNTRIES: Set<string>;
+export declare const BLOCKED_HOSTNAMES: Set<string>;
+/** Remove any dn_live_* or dn_test_* tokens from error messages. */
+export declare function scrubCredentials(msg: string): string;
+export declare function truncate(text: string, max?: number): string;
+/**
+ * Normalize non-standard IPv4 representations to dotted-decimal.
+ * Handles: decimal integers (2130706433), hex (0x7f000001), octal octets (0177.0.0.1).
+ */
+export declare function normalizeIpv4(hostname: string): string | null;
+export declare function isPrivateIp(hostname: string): boolean;
+export declare function validateTargetUrl(url: string): URL;
+export declare function validateCountry(country: string | undefined): string | undefined;
+export declare function validateUuid(id: string, label: string): string;
+export declare function checkDnsRebinding(hostname: string): Promise<void>;
+export declare function stripDangerousKeys(obj: unknown, depth?: number): void;
+export declare function formatBytes(bytes: number): string;
+export declare function formatCents(cents: number): string;
+export interface PiToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: Record<string, unknown>;
+}
+export interface DominusNodeToolkitOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    proxyHost?: string;
+    proxyPort?: number;
+    timeout?: number;
+}
+export declare class DominusNodeToolkit {
+    private apiKey;
+    private baseUrl;
+    private proxyHost;
+    private proxyPort;
+    private timeout;
+    private token;
+    private tokenExpiresAt;
+    private _authPromise;
+    constructor(options?: DominusNodeToolkitOptions);
+    private _authenticate;
+    private _ensureAuth;
+    private _apiRequest;
+    private _req;
+    proxiedFetch(url: string, method?: string, country?: string, proxyType?: string): Promise<PiToolResult>;
+    checkBalance(): Promise<PiToolResult>;
+    checkUsage(days?: number): Promise<PiToolResult>;
+    getProxyConfig(): Promise<PiToolResult>;
+    listSessions(): Promise<PiToolResult>;
+    createAgenticWallet(label: string, spendingLimitCents?: number): Promise<PiToolResult>;
+    fundAgenticWallet(walletId: string, amountCents: number): Promise<PiToolResult>;
+    checkAgenticBalance(walletId: string): Promise<PiToolResult>;
+    listAgenticWallets(): Promise<PiToolResult>;
+    agenticTransactions(walletId: string, limit?: number): Promise<PiToolResult>;
+    freezeAgenticWallet(walletId: string): Promise<PiToolResult>;
+    unfreezeAgenticWallet(walletId: string): Promise<PiToolResult>;
+    deleteAgenticWallet(walletId: string): Promise<PiToolResult>;
+    createTeam(name: string, maxMembers?: number): Promise<PiToolResult>;
+    listTeams(limit?: number): Promise<PiToolResult>;
+    teamDetails(teamId: string): Promise<PiToolResult>;
+    teamFund(teamId: string, amountCents: number): Promise<PiToolResult>;
+    teamCreateApiKey(teamId: string, label: string): Promise<PiToolResult>;
+    teamUsage(teamId: string, days?: number): Promise<PiToolResult>;
+    updateTeam(teamId: string, name?: string, maxMembers?: number): Promise<PiToolResult>;
+    updateTeamMemberRole(teamId: string, userId: string, role: string): Promise<PiToolResult>;
+    topupPaypal(amountCents: number): Promise<PiToolResult>;
+    topupStripe(amountCents: number): Promise<PiToolResult>;
+    topupCrypto(amountUsd: number, currency: string): Promise<PiToolResult>;
+    x402Info(): Promise<PiToolResult>;
+    updateWalletPolicy(walletId: string, dailyLimitCents?: number, allowedDomains?: string[]): Promise<PiToolResult>;
+}