@mixrpay/agent-sdk 0.8.8 → 0.9.1

package/dist/index.js

@@ -1,9 +1,6 @@
+import { privateKeyToAccount, signMessage, signTypedData } from 'viem/accounts';
+
 // src/session-key.ts
-import {
-  privateKeyToAccount,
-  signTypedData,
-  signMessage as viemSignMessage
-} from "viem/accounts";
 
 // src/errors.ts
 var MixrPayError = class extends Error {
@@ -352,7 +349,7 @@ var SessionKey = class _SessionKey {
    * @returns Hex-encoded signature
    */
   async signMessage(message) {
-    return viemSignMessage({
+    return signMessage({
       privateKey: this.privateKey,
       message
     });
@@ -403,9 +400,6 @@ async function createSessionAuthPayload(sessionKey) {
   };
 }
 
-// src/agent-wallet.ts
-import { privateKeyToAccount as privateKeyToAccount2, signMessage } from "viem/accounts";
-
 // src/x402.ts
 async function parse402Response(response) {
   let paymentData = null;
@@ -767,7 +761,7 @@ var AgentWallet = class {
   /**
    * Register a new agent with MixrPay.
    * 
-   * This creates a Privy-managed embedded wallet for the agent's payments.
+   * This creates a platform-managed embedded wallet for the agent's payments.
    * The agent proves ownership of their external wallet by signing a challenge.
    * 
    * @param options - Registration options including the private key
@@ -787,7 +781,7 @@ var AgentWallet = class {
   static async register(options) {
     const { privateKey, name } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=register`
@@ -855,7 +849,7 @@ var AgentWallet = class {
           healthy: false,
           database: "unknown",
           agentRegistrationAvailable: false,
-          privyConfigured: false,
+          walletServiceConfigured: false,
           error: `Health check failed with status ${response.status}`
         };
       }
@@ -864,14 +858,14 @@ var AgentWallet = class {
         healthy: data.status === "ready",
         database: data.database || "unknown",
         agentRegistrationAvailable: data.services?.agentRegistration?.available ?? false,
-        privyConfigured: data.services?.privy?.configured ?? false
+        walletServiceConfigured: data.services?.wallet?.configured ?? data.services?.privy?.configured ?? false
       };
     } catch (error) {
       return {
         healthy: false,
         database: "unreachable",
         agentRegistrationAvailable: false,
-        privyConfigured: false,
+        walletServiceConfigured: false,
         error: error instanceof Error ? error.message : "Failed to reach server"
       };
     }
@@ -904,7 +898,7 @@ var AgentWallet = class {
   static async getSessionKey(options) {
     const { privateKey, spendingLimitUsd, maxPerTxUsd, maxDailyUsd, durationDays } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=session-key`
@@ -967,7 +961,7 @@ var AgentWallet = class {
   static async getStatus(options) {
     const { privateKey } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=status`
@@ -1023,7 +1017,7 @@ var AgentWallet = class {
   static async revokeSessionKey(options) {
     const { privateKey, sessionKeyId } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=revoke`
@@ -1077,7 +1071,7 @@ var AgentWallet = class {
   static async withdraw(options) {
     const { privateKey, amountUsd } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=withdraw`
@@ -1143,7 +1137,7 @@ var AgentWallet = class {
   static async claimInvite(options) {
     const { inviteCode, privateKey } = options;
     const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
+    const account = privateKeyToAccount(privateKey);
     const walletAddress = account.address;
     const challengeResponse = await fetch(
       `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=claim-invite`
@@ -1203,7 +1197,7 @@ var AgentWallet = class {
    * Spawn a child invite for sub-agents.
    * 
    * Allows an agent to create an invite code for a sub-agent with a portion
-   * of their remaining budget (max 20%). The child inherits merchant restrictions
+   * of their remaining budget. The child inherits merchant restrictions
    * and cannot outlive the parent session.
    * 
    * @param options - Spawn options
@@ -1217,7 +1211,7 @@ var AgentWallet = class {
    * 
    * // Spawn a child invite for a sub-agent
    * const childInvite = await wallet.spawnChildInvite({
-   *   budgetUsd: 10.00,  // Max 20% of available budget
+   *   budgetUsd: 10.00,
    *   name: 'Research Sub-Agent',
    *   allowedMerchants: ['firecrawl.dev'],  // Must be subset of parent
    *   expiresInDays: 7,  // Will be capped to parent's expiry
@@ -1273,8 +1267,7 @@ var AgentWallet = class {
   /**
    * Get available budget information for spawning.
    * 
-   * Returns the current budget status including how much can be spawned
-   * to child agents (20% of available).
+   * Returns the current budget status including spawn availability.
    * 
    * @returns Budget information
    * 
@@ -2686,6 +2679,317 @@ Timestamp: ${timestamp}`;
     return this.parseJitInstance(data.instance);
   }
   // ===========================================================================
+  // Transaction Execution
+  // ===========================================================================
+  /**
+   * Execute an on-chain transaction from the human's wallet.
+   * 
+   * Submits arbitrary calldata to any contract, bounded by the session key's
+   * budget limits (max_total, max_per_tx, max_daily). The platform validates
+   * the budget, executes the transaction, and records a charge.
+   * 
+   * @param params - Transaction parameters
+   * @returns Transaction result with hash and remaining budget
+   * @throws {MixrPayError} If budget exceeded, tx reverted, or auth fails
+   * 
+   * @example
+   * ```typescript
+   * // Bridge USDC via deBridge
+   * const quote = await deBridgeMcp.create_tx({ ... });
+   * const result = await wallet.executeTransaction({
+   *   to: quote.contractAddress,
+   *   data: quote.calldata,
+   *   estimatedCostUsd: 25.0,
+   *   description: 'Bridge 25 USDC Base -> Avalanche via deBridge',
+   * });
+   * console.log('TX:', result.txHash);
+   * console.log('Budget remaining:', result.remainingBudgetUsd);
+   * ```
+   */
+  async executeTransaction(params) {
+    this.logger.debug("executeTransaction", { to: params.to, estimatedCostUsd: params.estimatedCostUsd });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/tx/execute`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({
+        to: params.to,
+        data: params.data,
+        value: params.value?.toString() ?? "0",
+        chain_id: params.chainId,
+        estimated_cost_usd: params.estimatedCostUsd,
+        description: params.description,
+        idempotency_key: params.idempotencyKey
+      })
+    });
+    const result = await response.json().catch(() => ({}));
+    if (!response.ok) {
+      const errorCode = result.error_code || "TX_FAILED";
+      const errorMessage = result.error || `Transaction execution failed: ${response.status}`;
+      if (errorCode === "BUDGET_EXCEEDED") {
+        throw new MixrPayError(errorMessage, "SPENDING_LIMIT_EXCEEDED");
+      }
+      throw new MixrPayError(errorMessage, errorCode);
+    }
+    this.logger.info("Transaction executed", {
+      txHash: result.tx_hash,
+      estimatedCostUsd: params.estimatedCostUsd,
+      remainingBudgetUsd: result.remaining_budget_usd
+    });
+    return {
+      success: true,
+      txHash: result.tx_hash,
+      chargeId: result.charge_id,
+      estimatedCostUsd: result.estimated_cost_usd,
+      remainingBudgetUsd: result.remaining_budget_usd
+    };
+  }
+  // ===========================================================================
+  // Skills Methods
+  // ===========================================================================
+  /**
+   * Use a configured skill by deploying a JIT MCP server with your saved API keys.
+   * 
+   * Skills are configured on the MixrPay dashboard with your API keys stored securely.
+   * When you call useSkill(), MixrPay deploys an ephemeral MCP server with your keys
+   * injected server-side - your keys are never exposed to the agent.
+   * 
+   * @param skillId - The skill ID (e.g., 'github', 'notion', 'spotify')
+   * @param options - Optional configuration
+   * @returns Skill endpoint and available tools
+   * 
+   * @example
+   * ```typescript
+   * // Use the GitHub skill
+   * const github = await wallet.useSkill('github');
+   * 
+   * console.log('Endpoint:', github.endpoint);
+   * console.log('Tools:', github.tools);
+   * console.log('Expires:', github.expiresAt);
+   * 
+   * // Connect to the MCP endpoint and call tools
+   * // The exact method depends on your MCP client
+   * ```
+   * 
+   * @example
+   * ```typescript
+   * // Use Notion with custom TTL
+   * const notion = await wallet.useSkill('notion', { ttlHours: 48 });
+   * ```
+   * 
+   * @throws {MixrPayError} If skill is not configured or deployment fails
+   */
+  async useSkill(skillId, options) {
+    this.logger.debug("useSkill", { skillId, options });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/skills/${skillId}/use`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({
+        ttl_hours: options?.ttlHours || 24
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      if (error.configure_url) {
+        throw new MixrPayError(
+          `${error.error || "Skill not configured"}. Configure at: ${this.baseUrl}${error.configure_url}`,
+          "SKILL_NOT_CONFIGURED"
+        );
+      }
+      throw new MixrPayError(error.error || `Failed to use skill: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      skillId: data.skill_id,
+      endpoint: data.endpoint,
+      tools: data.tools || [],
+      expiresAt: new Date(data.expires_at),
+      instanceId: data.instance_id
+    };
+  }
+  /**
+   * List all available skills and their configuration status.
+   * 
+   * @returns Array of skills with status
+   * 
+   * @example
+   * ```typescript
+   * const skills = await wallet.listSkills();
+   * 
+   * // Find configured skills
+   * const configured = skills.filter(s => s.status === 'configured');
+   * console.log(`${configured.length} skills ready to use`);
+   * 
+   * // Find skills that need configuration
+   * const needsConfig = skills.filter(s => s.status === 'not_configured' && s.envVars.length > 0);
+   * for (const skill of needsConfig) {
+   *   console.log(`${skill.name} needs: ${skill.envVars.map(v => v.label).join(', ')}`);
+   * }
+   * ```
+   */
+  async listSkills() {
+    this.logger.debug("listSkills");
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/skills`, {
+      headers: authHeaders
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to list skills: ${response.status}`);
+    }
+    const data = await response.json();
+    return data.skills || [];
+  }
+  /**
+   * Get apps connected via Composio (Gmail, Slack, GitHub, etc.).
+   * 
+   * Use this to discover which apps the owner has connected before
+   * attempting to use them via `wallet.useSkill('composio')`.
+   * 
+   * @returns Object with connected app names and connection details
+   * 
+   * @example
+   * ```typescript
+   * const apps = await wallet.getConnectedApps();
+   * 
+   * if (apps.connected.length === 0) {
+   *   console.log('No apps connected. Ask your owner to connect apps at the dashboard.');
+   * } else {
+   *   console.log('Connected apps:', apps.connected.join(', '));
+   *   
+   *   if (apps.connected.includes('gmail')) {
+   *     // Safe to use Composio for Gmail
+   *     const { endpoint, tools } = await wallet.useSkill('composio');
+   *     // tools will include 'gmail_read_emails', 'gmail_send_email', etc.
+   *   }
+   * }
+   * ```
+   */
+  async getConnectedApps() {
+    this.logger.debug("getConnectedApps");
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/skills/composio/connections`, {
+      headers: authHeaders
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(
+        error.error || `Failed to get connected apps: ${response.status}`,
+        "CONNECTED_APPS_FAILED"
+      );
+    }
+    const data = await response.json();
+    const connectedAppNames = (data.connections || []).filter((c) => c.status === "connected").map((c) => c.app.toLowerCase());
+    return {
+      connected: connectedAppNames,
+      connections: data.connections || [],
+      oauthConnections: data.oauth_connections || [],
+      apiKeyConnections: data.api_key_connections || []
+    };
+  }
+  /**
+   * Get configuration status for a specific skill.
+   * 
+   * @param skillId - The skill ID
+   * @returns Skill configuration status
+   * 
+   * @example
+   * ```typescript
+   * const status = await wallet.getSkillStatus('github');
+   * 
+   * if (status.status === 'configured') {
+   *   console.log('GitHub is ready!');
+   *   console.log('Configured vars:', status.configuredVars);
+   * } else {
+   *   console.log('Please configure GitHub at the MixrPay dashboard');
+   * }
+   * ```
+   */
+  async getSkillStatus(skillId) {
+    this.logger.debug("getSkillStatus", { skillId });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/skills/${skillId}/configure`, {
+      headers: authHeaders
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get skill status: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      skillId: data.skill_id,
+      status: data.status,
+      configuredVars: data.configured_vars || [],
+      lastUsedAt: data.last_used_at ? new Date(data.last_used_at) : void 0,
+      errorMessage: data.error_message
+    };
+  }
+  /**
+   * Configure a skill with API keys.
+   * 
+   * This allows agents to save API keys received via chat to the MixrPay platform.
+   * Keys are encrypted at rest and will be available for use on subsequent deploy/redeploy.
+   * 
+   * @param skillId - The skill ID (e.g., 'web-search', 'github', 'notion') or custom skill with 'custom-' prefix
+   * @param envVars - Environment variables with API keys (e.g., { BRAVE_API_KEY: 'xxx' })
+   * @returns Configuration result with list of configured variables
+   * 
+   * @example Predefined skill
+   * ```typescript
+   * // User provides API key in chat, agent saves it
+   * const result = await wallet.configureSkill('web-search', {
+   *   BRAVE_API_KEY: 'BSA_abc123xyz',
+   * });
+   * 
+   * console.log('Configured:', result.configuredVars);
+   * // After next redeploy, the skill will be enabled with this key
+   * ```
+   * 
+   * @example Custom API key
+   * ```typescript
+   * // For APIs not in predefined skills, use custom- prefix
+   * // User: "Here's my Polymarket API key: pk_abc123"
+   * const result = await wallet.configureSkill('custom-polymarket', {
+   *   POLYMARKET_API_KEY: 'pk_abc123',
+   * });
+   * 
+   * // The key is now available in the agent's environment
+   * // Access via: process.env.POLYMARKET_API_KEY
+   * ```
+   */
+  async configureSkill(skillId, envVars) {
+    this.logger.debug("configureSkill", { skillId, varNames: Object.keys(envVars) });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/skills/${skillId}/configure`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({ env_vars: envVars })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(
+        error.error || `Failed to configure skill: ${response.status}`,
+        error.error_code
+      );
+    }
+    const data = await response.json();
+    return {
+      success: true,
+      skillId: data.skill_id,
+      configuredVars: data.configured_vars || []
+    };
+  }
+  // ===========================================================================
   // Glama MCP Directory Methods
   // ===========================================================================
   /**
@@ -4325,7 +4629,7 @@ Timestamp: ${timestamp}`;
       ...init.headers
     };
     if (this.sessionKey) {
-      const account = privateKeyToAccount2(this.sessionKey.rawPrivateKey);
+      const account = privateKeyToAccount(this.sessionKey.rawPrivateKey);
       const address = account.address.toLowerCase();
       const timestamp = Date.now();
       const message = `MixrPay:${timestamp}:${address}`;
@@ -4345,21 +4649,5 @@ Timestamp: ${timestamp}`;
     });
   }
 };
-export {
-  AgentWallet,
-  InsufficientBalanceError,
-  InvalidSessionKeyError,
-  MerchantNotAllowedError,
-  MixrPayError,
-  PaymentFailedError,
-  SDK_VERSION,
-  SessionExpiredError,
-  SessionKeyExpiredError,
-  SessionLimitExceededError,
-  SessionNotFoundError,
-  SessionRevokedError,
-  SpendingLimitExceededError,
-  X402ProtocolError,
-  getErrorMessage,
-  isMixrPayError
-};
+
+export { AgentWallet, InsufficientBalanceError, InvalidSessionKeyError, MerchantNotAllowedError, MixrPayError, PaymentFailedError, SDK_VERSION, SessionExpiredError, SessionKeyExpiredError, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, SpendingLimitExceededError, X402ProtocolError, getErrorMessage, isMixrPayError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixrpay/agent-sdk",
-  "version": "0.8.8",
+  "version": "0.9.1",
   "description": "MixrPay Agent SDK - Enable AI agents to make x402 payments with session keys",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "build": "tsup --config tsup.config.ts",
     "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",