@mixrpay/agent-sdk 0.11.0 → 0.11.3

package/dist/index.d.cts

@@ -4,6 +4,8 @@
 interface AgentWalletConfig {
     /** Session key (sk_live_ or sk_test_ prefix). */
     sessionKey: string;
+    /** Session key ID (UUID) for X-Mixr-Session header authentication. */
+    sessionKeyId?: string;
     /** Override wallet address. */
     walletAddress?: string;
     /** Client-side max payment per request in USD. */
@@ -517,7 +519,7 @@ declare const NETWORKS: {
 interface AgentRegisterOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Optional display name for the agent */
     name?: string;
@@ -537,7 +539,7 @@ interface AgentRegisterResult {
 interface AgentGetSessionKeyOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Maximum total spending in USD (default: $25) */
     spendingLimitUsd?: number;
@@ -573,7 +575,7 @@ interface AgentGetSessionKeyResult {
 interface AgentGetStatusOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -603,7 +605,7 @@ interface AgentRevokeSessionKeyOptions {
     privateKey: `0x${string}`;
     /** The session key ID to revoke */
     sessionKeyId: string;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -614,7 +616,7 @@ interface AgentWithdrawOptions {
     privateKey: `0x${string}`;
     /** Amount to withdraw in USD */
     amountUsd: number;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -636,7 +638,7 @@ interface AgentClaimInviteOptions {
     inviteCode: string;
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -669,7 +671,7 @@ interface AgentClaimInviteResult {
  * Options for activating an agent
  */
 interface AgentActivateOptions {
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -716,6 +718,8 @@ interface AgentRuntime {
 interface ConnectOptions {
     /** Explicit session key (highest priority) */
     sessionKey?: string;
+    /** Session key ID (UUID) for X-Mixr-Session authentication */
+    sessionKeyId?: string;
     /** Access code from MixrPay dashboard (mixr-xxx) - one-time use, auto-cached */
     accessCode?: string;
     /** Master key for multi-agent deployments */
@@ -724,7 +728,7 @@ interface ConnectOptions {
     agentName?: string;
     /** Enable interactive device flow login if no credentials found */
     interactive?: boolean;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Log level for debugging */
     logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';
@@ -924,6 +928,7 @@ declare class AgentWallet {
     private selfCustodyKey?;
     private agentInstanceId?;
     private apiKey?;
+    private sessionKeyId?;
     /**
      * Create a new AgentWallet instance.
      *
@@ -1008,7 +1013,7 @@ declare class AgentWallet {
      *
      * Use this to diagnose registration issues before attempting to register.
      *
-     * @param baseUrl - MixrPay API base URL (default: https://www.mixrpay.com)
+     * @param baseUrl - Mixr Network API base URL (default: https://mixr.network)
      * @returns Server health status including agent registration availability
      *
      * @example
@@ -1469,6 +1474,12 @@ declare class AgentWallet {
      * @returns The Ethereum address of the smart wallet
      */
     getWalletAddress(): `0x${string}`;
+    /**
+     * Get the session key ID (UUID) for X-Mixr-Session authentication.
+     *
+     * @returns Session key ID if available, undefined otherwise
+     */
+    getSessionKeyId(): string | undefined;
     /**
      * Check if using testnet session key.
      *
@@ -2034,10 +2045,12 @@ declare class AgentWallet {
      */
     listMCPTools(): Promise<Tool[]>;
     /**
-     * Call a tool with wallet authentication (direct pay per call).
+     * Call a tool from the MixrPay gateway.
      *
-     * This method signs a fresh auth message for each call, charging
-     * directly from your wallet balance without needing a session.
+     * If a session key ID is available (from device flow login), this method
+     * uses session-based authentication (X-Mixr-Session header). Otherwise,
+     * it falls back to wallet signature authentication which requires the
+     * wallet to be registered in MixrPay.
      *
      * @param toolName - The tool name in format "merchant/tool"
      * @param args - Arguments to pass to the tool
@@ -3321,6 +3334,49 @@ declare class AgentWallet {
     private callApiWithAuth;
     /** Helper to call our API with auth */
     private callApi;
+    /**
+     * Store a credential in the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @param value - Credential value to store (encrypted at rest)
+     * @param description - Optional description of the credential
+     * @throws {MixrPayError} If storage fails
+     */
+    credsSet(service: string, key: string, value: string, description?: string): Promise<void>;
+    /**
+     * Retrieve a credential from the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @returns Decrypted credential value or null if not found
+     * @throws {MixrPayError} If retrieval fails
+     */
+    credsGet(service: string, key: string): Promise<string | null>;
+    /**
+     * List all credential names stored in the agent's vault (without values)
+     *
+     * @returns Array of credential metadata objects
+     * @throws {MixrPayError} If listing fails
+     */
+    credsList(): Promise<Array<{
+        service: string;
+        key: string;
+        description: string | null;
+        lastAccessedAt: string | null;
+        accessCount: number;
+        createdAt: string;
+        updatedAt: string;
+    }>>;
+    /**
+     * Delete a credential from the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @returns True if deleted, false if not found
+     * @throws {MixrPayError} If deletion fails
+     */
+    credsDelete(service: string, key: string): Promise<boolean>;
 }
 /** Task status */
 type TaskStatus = 'open' | 'claimed' | 'submitted' | 'completed' | 'cancelled' | 'completing';
@@ -4821,6 +4877,8 @@ declare function getErrorMessage(error: unknown): string;
 interface StoredCredentials {
     /** Session key (sk_live_xxx or sk_test_xxx) */
     sessionKey?: string;
+    /** Session key ID (UUID) for X-Mixr-Session header authentication */
+    sessionKeyId?: string;
     /** API token (agt_live_xxx) for API calls */
     apiToken?: string;
     /** @deprecated Use apiToken instead. Legacy connect token (ac_live_xxx) */
@@ -4833,6 +4891,12 @@ interface StoredCredentials {
     baseUrl?: string;
     /** When credentials were last updated */
     updatedAt?: string;
+    /** Private key for self-funded agents (0x...) */
+    privateKey?: string;
+    /** Wallet address for self-funded agents */
+    walletAddress?: string;
+    /** Deposit address for receiving funds */
+    depositAddress?: string;
 }
 type CredentialLoadResult = {
     success: true;

package/dist/index.d.ts

@@ -4,6 +4,8 @@
 interface AgentWalletConfig {
     /** Session key (sk_live_ or sk_test_ prefix). */
     sessionKey: string;
+    /** Session key ID (UUID) for X-Mixr-Session header authentication. */
+    sessionKeyId?: string;
     /** Override wallet address. */
     walletAddress?: string;
     /** Client-side max payment per request in USD. */
@@ -517,7 +519,7 @@ declare const NETWORKS: {
 interface AgentRegisterOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Optional display name for the agent */
     name?: string;
@@ -537,7 +539,7 @@ interface AgentRegisterResult {
 interface AgentGetSessionKeyOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Maximum total spending in USD (default: $25) */
     spendingLimitUsd?: number;
@@ -573,7 +575,7 @@ interface AgentGetSessionKeyResult {
 interface AgentGetStatusOptions {
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -603,7 +605,7 @@ interface AgentRevokeSessionKeyOptions {
     privateKey: `0x${string}`;
     /** The session key ID to revoke */
     sessionKeyId: string;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -614,7 +616,7 @@ interface AgentWithdrawOptions {
     privateKey: `0x${string}`;
     /** Amount to withdraw in USD */
     amountUsd: number;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -636,7 +638,7 @@ interface AgentClaimInviteOptions {
     inviteCode: string;
     /** The agent's external wallet private key (used for signing, NOT transmitted) */
     privateKey: `0x${string}`;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -669,7 +671,7 @@ interface AgentClaimInviteResult {
  * Options for activating an agent
  */
 interface AgentActivateOptions {
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
 }
 /**
@@ -716,6 +718,8 @@ interface AgentRuntime {
 interface ConnectOptions {
     /** Explicit session key (highest priority) */
     sessionKey?: string;
+    /** Session key ID (UUID) for X-Mixr-Session authentication */
+    sessionKeyId?: string;
     /** Access code from MixrPay dashboard (mixr-xxx) - one-time use, auto-cached */
     accessCode?: string;
     /** Master key for multi-agent deployments */
@@ -724,7 +728,7 @@ interface ConnectOptions {
     agentName?: string;
     /** Enable interactive device flow login if no credentials found */
     interactive?: boolean;
-    /** MixrPay API base URL (default: https://www.mixrpay.com) */
+    /** Mixr Network API base URL (default: https://mixr.network) */
     baseUrl?: string;
     /** Log level for debugging */
     logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';
@@ -924,6 +928,7 @@ declare class AgentWallet {
     private selfCustodyKey?;
     private agentInstanceId?;
     private apiKey?;
+    private sessionKeyId?;
     /**
      * Create a new AgentWallet instance.
      *
@@ -1008,7 +1013,7 @@ declare class AgentWallet {
      *
      * Use this to diagnose registration issues before attempting to register.
      *
-     * @param baseUrl - MixrPay API base URL (default: https://www.mixrpay.com)
+     * @param baseUrl - Mixr Network API base URL (default: https://mixr.network)
      * @returns Server health status including agent registration availability
      *
      * @example
@@ -1469,6 +1474,12 @@ declare class AgentWallet {
      * @returns The Ethereum address of the smart wallet
      */
     getWalletAddress(): `0x${string}`;
+    /**
+     * Get the session key ID (UUID) for X-Mixr-Session authentication.
+     *
+     * @returns Session key ID if available, undefined otherwise
+     */
+    getSessionKeyId(): string | undefined;
     /**
      * Check if using testnet session key.
      *
@@ -2034,10 +2045,12 @@ declare class AgentWallet {
      */
     listMCPTools(): Promise<Tool[]>;
     /**
-     * Call a tool with wallet authentication (direct pay per call).
+     * Call a tool from the MixrPay gateway.
      *
-     * This method signs a fresh auth message for each call, charging
-     * directly from your wallet balance without needing a session.
+     * If a session key ID is available (from device flow login), this method
+     * uses session-based authentication (X-Mixr-Session header). Otherwise,
+     * it falls back to wallet signature authentication which requires the
+     * wallet to be registered in MixrPay.
      *
      * @param toolName - The tool name in format "merchant/tool"
      * @param args - Arguments to pass to the tool
@@ -3321,6 +3334,49 @@ declare class AgentWallet {
     private callApiWithAuth;
     /** Helper to call our API with auth */
     private callApi;
+    /**
+     * Store a credential in the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @param value - Credential value to store (encrypted at rest)
+     * @param description - Optional description of the credential
+     * @throws {MixrPayError} If storage fails
+     */
+    credsSet(service: string, key: string, value: string, description?: string): Promise<void>;
+    /**
+     * Retrieve a credential from the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @returns Decrypted credential value or null if not found
+     * @throws {MixrPayError} If retrieval fails
+     */
+    credsGet(service: string, key: string): Promise<string | null>;
+    /**
+     * List all credential names stored in the agent's vault (without values)
+     *
+     * @returns Array of credential metadata objects
+     * @throws {MixrPayError} If listing fails
+     */
+    credsList(): Promise<Array<{
+        service: string;
+        key: string;
+        description: string | null;
+        lastAccessedAt: string | null;
+        accessCount: number;
+        createdAt: string;
+        updatedAt: string;
+    }>>;
+    /**
+     * Delete a credential from the agent's secure vault
+     *
+     * @param service - Service name (e.g., "openai", "github")
+     * @param key - Key name (e.g., "api_key", "token")
+     * @returns True if deleted, false if not found
+     * @throws {MixrPayError} If deletion fails
+     */
+    credsDelete(service: string, key: string): Promise<boolean>;
 }
 /** Task status */
 type TaskStatus = 'open' | 'claimed' | 'submitted' | 'completed' | 'cancelled' | 'completing';
@@ -4821,6 +4877,8 @@ declare function getErrorMessage(error: unknown): string;
 interface StoredCredentials {
     /** Session key (sk_live_xxx or sk_test_xxx) */
     sessionKey?: string;
+    /** Session key ID (UUID) for X-Mixr-Session header authentication */
+    sessionKeyId?: string;
     /** API token (agt_live_xxx) for API calls */
     apiToken?: string;
     /** @deprecated Use apiToken instead. Legacy connect token (ac_live_xxx) */
@@ -4833,6 +4891,12 @@ interface StoredCredentials {
     baseUrl?: string;
     /** When credentials were last updated */
     updatedAt?: string;
+    /** Private key for self-funded agents (0x...) */
+    privateKey?: string;
+    /** Wallet address for self-funded agents */
+    walletAddress?: string;
+    /** Deposit address for receiving funds */
+    depositAddress?: string;
 }
 type CredentialLoadResult = {
     success: true;