@mixrpay/agent-sdk 0.8.4 → 0.8.6

package/dist/index.cjs

@@ -100,7 +100,7 @@ var InsufficientBalanceError = class extends MixrPayError {
     this.name = "InsufficientBalanceError";
     this.required = required;
     this.available = available;
-    this.topUpUrl = "/wallet";
+    this.topUpUrl = "https://mixrpay.com/manage/wallet";
   }
 };
 var SessionKeyExpiredError = class extends MixrPayError {
@@ -108,7 +108,7 @@ var SessionKeyExpiredError = class extends MixrPayError {
   expiredAt;
   constructor(expiredAt) {
     super(
-      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner or create one at your MixrPay server /wallet/sessions`,
+      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner at https://mixrpay.com/manage/invites`,
       "SESSION_KEY_EXPIRED"
     );
     this.name = "SessionKeyExpiredError";
@@ -177,7 +177,7 @@ var InvalidSessionKeyError = class extends MixrPayError {
   reason;
   constructor(reason = "Invalid session key format") {
     super(
-      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from your MixrPay server /wallet/sessions`,
+      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from https://mixrpay.com/manage/invites`,
       "INVALID_SESSION_KEY"
     );
     this.name = "InvalidSessionKeyError";
@@ -532,7 +532,7 @@ function getAmountUsd(requirements) {
 }
 
 // src/agent-wallet.ts
-var SDK_VERSION = "0.8.3";
+var SDK_VERSION = "0.8.5";
 var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
 var DEFAULT_TIMEOUT = 3e4;
 var NETWORKS = {
@@ -648,7 +648,7 @@ var AgentWallet = class {
   validateConfig(config) {
     if (!config.sessionKey) {
       throw new InvalidSessionKeyError(
-        "Session key is required. Get one from the wallet owner or create one at your MixrPay server /wallet/sessions"
+        "Session key is required. Get one from the wallet owner at https://mixrpay.com/manage/invites"
       );
     }
     const key = config.sessionKey.trim();
@@ -1161,7 +1161,7 @@ var AgentWallet = class {
    * 
    * @example
    * ```typescript
-   * // Human creates invite at their dashboard, shares code "mixr-abc123"
+   * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
    * 
    * const result = await AgentWallet.claimInvite({
    *   inviteCode: 'mixr-abc123',
@@ -1387,6 +1387,16 @@ var AgentWallet = class {
     const data = await response.json();
     return data.children || [];
   }
+  /**
+   * List child sessions spawned by this agent.
+   * 
+   * Alias for `getChildSessions()` for naming consistency.
+   * 
+   * @returns Array of child session info
+   */
+  async listChildSessions() {
+    return this.getChildSessions();
+  }
   // ===========================================================================
   // Core Methods
   // ===========================================================================
@@ -1840,7 +1850,7 @@ var AgentWallet = class {
       checks.sessionKeyValid = info.isValid;
       if (!info.isValid) {
         issues.push("Session key is invalid or has been revoked.");
-        recommendations.push("Request a new session key from the wallet owner or create one at /wallet/sessions.");
+        recommendations.push("Request a new session key from the wallet owner at https://mixrpay.com/manage/invites");
       }
       const now = /* @__PURE__ */ new Date();
       let expiresInHours = null;
@@ -1880,7 +1890,7 @@ var AgentWallet = class {
       balance = await this.getBalance();
       checks.hasBalance = balance > 0;
       if (balance <= 0) {
-        issues.push("Wallet has no USDC balance. Top up at your MixrPay server /wallet");
+        issues.push("Wallet has no USDC balance. Top up at https://mixrpay.com/manage/wallet");
         recommendations.push("Deposit USDC to your wallet address to enable payments.");
       } else if (balance < 1) {
         issues.push(`Low balance: $${balance.toFixed(2)}. Consider topping up.`);
@@ -2532,6 +2542,341 @@ Timestamp: ${timestamp}`;
     };
   }
   // ===========================================================================
+  // JIT MCP Server Methods
+  // ===========================================================================
+  /**
+   * Deploy a JIT MCP server from the Glama directory.
+   * 
+   * Deploys any remote-capable MCP server to Cloudflare Workers.
+   * Charges $1 from your session budget.
+   * 
+   * @param options - Deployment options including Glama server details and env vars
+   * @returns Deployed instance with private endpoint URL
+   * 
+   * @example
+   * ```typescript
+   * const result = await wallet.deployJitMcp({
+   *   glamaId: 'notion-mcp',
+   *   glamaNamespace: 'notion',
+   *   glamaSlug: 'notion-mcp',
+   *   toolName: 'My Notion Server',
+   *   envVars: { NOTION_API_KEY: 'secret_...' },
+   *   ttlHours: 24,
+   * });
+   * 
+   * console.log('Endpoint:', result.instance.endpointUrl);
+   * console.log('Expires:', result.instance.expiresAt);
+   * ```
+   */
+  async deployJitMcp(options) {
+    this.logger.debug("deployJitMcp", { glamaId: options.glamaId, toolName: options.toolName });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(`${this.baseUrl}/api/v2/jit/deploy`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders
+      },
+      body: JSON.stringify({
+        glama_id: options.glamaId,
+        glama_namespace: options.glamaNamespace,
+        glama_slug: options.glamaSlug,
+        tool_name: options.toolName,
+        tool_description: options.toolDescription,
+        env_vars: options.envVars,
+        ttl_hours: options.ttlHours || 24
+        // session_id not needed - derived from X-Session-Auth
+      })
+    });
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `JIT deploy failed: ${response.status}`);
+    }
+    const data = await response.json();
+    if (data.payment?.amount_usd > 0) {
+      const payment = {
+        amountUsd: data.payment.amount_usd,
+        recipient: "mixrpay-jit-deploy",
+        txHash: data.payment.tx_hash,
+        timestamp: /* @__PURE__ */ new Date(),
+        description: `JIT Deploy: ${options.toolName}`,
+        url: `${this.baseUrl}/api/v2/jit/deploy`,
+        requestId: data.request_id || crypto.randomUUID()
+      };
+      this.payments.push(payment);
+      this.totalSpentUsd += data.payment.amount_usd;
+      this.logger.payment(data.payment.amount_usd, "jit-deploy", options.toolName);
+      if (this.onPayment) {
+        this.onPayment(payment);
+      }
+    }
+    return {
+      instance: this.parseJitInstance(data.instance),
+      payment: {
+        method: data.payment.method,
+        amountUsd: data.payment.amount_usd,
+        txHash: data.payment.tx_hash
+      }
+    };
+  }
+  /**
+   * List your deployed JIT MCP server instances.
+   * 
+   * @param options - Optional filters
+   * @returns Array of JIT instances
+   * 
+   * @example
+   * ```typescript
+   * const instances = await wallet.listJitInstances({ status: 'active' });
+   * for (const inst of instances) {
+   *   console.log(`${inst.toolName}: ${inst.endpointUrl}`);
+   * }
+   * ```
+   */
+  async listJitInstances(options) {
+    this.logger.debug("listJitInstances", options);
+    const authHeaders = await this.getSessionAuthHeaders();
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    const response = await fetch(
+      `${this.baseUrl}/api/v2/jit/instances?${params}`,
+      { headers: authHeaders }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to list JIT instances: ${response.status}`);
+    }
+    const data = await response.json();
+    return (data.instances || []).map((i) => this.parseJitInstance(i));
+  }
+  /**
+   * Stop a running JIT MCP server instance.
+   * 
+   * Instance will be marked as stopped and Worker cleaned up.
+   * No refund is given - instances are billed at deploy time.
+   * 
+   * @param instanceId - The instance ID to stop
+   * 
+   * @example
+   * ```typescript
+   * await wallet.stopJitInstance('inst_abc123');
+   * console.log('Instance stopped');
+   * ```
+   */
+  async stopJitInstance(instanceId) {
+    this.logger.debug("stopJitInstance", { instanceId });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(
+      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
+      { method: "DELETE", headers: authHeaders }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to stop JIT instance: ${response.status}`);
+    }
+  }
+  /**
+   * Parse JIT instance response data.
+   */
+  parseJitInstance(data) {
+    return {
+      id: data.id,
+      endpointUrl: data.endpoint_url,
+      toolName: data.tool_name,
+      glamaId: data.glama_id,
+      glamaNamespace: data.glama_namespace,
+      glamaSlug: data.glama_slug,
+      status: data.status,
+      mode: data.mode,
+      ttlHours: data.ttl_hours,
+      expiresAt: new Date(data.expires_at),
+      createdAt: new Date(data.created_at)
+    };
+  }
+  /**
+   * Get details of a specific JIT MCP server instance.
+   * 
+   * @param instanceId - The instance ID to retrieve
+   * @returns Full instance details including endpoint URL
+   * 
+   * @example
+   * ```typescript
+   * const instance = await wallet.getJitInstance('inst_abc123');
+   * console.log('Endpoint:', instance.endpointUrl);
+   * console.log('Expires:', instance.expiresAt);
+   * ```
+   */
+  async getJitInstance(instanceId) {
+    this.logger.debug("getJitInstance", { instanceId });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(
+      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
+      { headers: authHeaders }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get JIT instance: ${response.status}`);
+    }
+    const data = await response.json();
+    return this.parseJitInstance(data.instance);
+  }
+  // ===========================================================================
+  // Glama MCP Directory Methods
+  // ===========================================================================
+  /**
+   * Search the Glama MCP server directory.
+   * 
+   * Glama indexes 15,000+ MCP servers. Use this to discover tools
+   * that can be deployed as JIT servers.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @param query - Search query (e.g., "notion", "github", "database")
+   * @returns Array of matching servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const results = await wallet.searchGlamaDirectory('notion');
+   * 
+   * // Filter to only hostable servers
+   * const hostable = results.servers.filter(s => s.canHost);
+   * console.log(`Found ${hostable.length} deployable servers`);
+   * 
+   * // Deploy one
+   * if (hostable.length > 0) {
+   *   const server = hostable[0];
+   *   await wallet.deployJitMcp({
+   *     glamaId: server.id,
+   *     glamaNamespace: server.namespace,
+   *     glamaSlug: server.slug,
+   *     toolName: server.name,
+   *     envVars: { API_KEY: '...' },
+   *   });
+   * }
+   * ```
+   */
+  async searchGlamaDirectory(query) {
+    this.logger.debug("searchGlamaDirectory", { query });
+    const params = new URLSearchParams({ q: query });
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama?${params}`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Glama search failed: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      pageInfo: data.pageInfo,
+      query: data.query
+    };
+  }
+  /**
+   * Get featured/popular MCP servers from the Glama directory.
+   * 
+   * Returns curated list of popular servers when you don't have
+   * a specific search query.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @returns Array of featured servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const { servers } = await wallet.getFeaturedGlamaServers();
+   * console.log('Featured servers:', servers.map(s => s.name));
+   * ```
+   */
+  async getFeaturedGlamaServers() {
+    this.logger.debug("getFeaturedGlamaServers");
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get featured servers: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      featured: data.featured
+    };
+  }
+  /**
+   * Parse Glama server response data.
+   */
+  parseGlamaServer(data) {
+    const importData = data.importData;
+    return {
+      id: data.id,
+      name: data.name,
+      namespace: data.namespace,
+      slug: data.slug,
+      description: data.description,
+      url: data.url,
+      attributes: data.attributes,
+      canHost: data.canHost,
+      tools: data.tools || [],
+      repository: data.repository,
+      license: data.spdxLicense?.name,
+      importData: importData ? {
+        glamaId: importData.glamaId,
+        glamaNamespace: importData.glamaNamespace,
+        glamaSlug: importData.glamaSlug,
+        suggestedName: importData.suggestedName,
+        suggestedDescription: importData.suggestedDescription,
+        hostingType: importData.hostingType,
+        requiredEnvVars: importData.requiredEnvVars,
+        optionalEnvVars: importData.optionalEnvVars
+      } : void 0
+    };
+  }
+  // ===========================================================================
+  // LLM Completion Methods
+  // ===========================================================================
+  /**
+   * Simple LLM completion - single-turn, no tools.
+   * 
+   * This is a convenience method for agents that just need to call an LLM
+   * without the full agentic loop. Useful when Clawdbot spawns agents
+   * that need to make their own LLM calls through MixrPay.
+   * 
+   * @param prompt - The user prompt to send
+   * @param options - Optional configuration
+   * @returns The LLM response text and cost
+   * 
+   * @example Basic usage
+   * ```typescript
+   * const result = await wallet.complete('Summarize this text: ...');
+   * console.log(result.text);
+   * console.log(`Cost: $${result.costUsd.toFixed(4)}`);
+   * ```
+   * 
+   * @example With custom model
+   * ```typescript
+   * const result = await wallet.complete(
+   *   'Write a haiku about coding',
+   *   { model: 'gpt-4o', systemPrompt: 'You are a poet.' }
+   * );
+   * ```
+   */
+  async complete(prompt, options) {
+    this.logger.debug("complete", { promptLength: prompt.length, model: options?.model });
+    const result = await this.runAgent({
+      messages: [{ role: "user", content: prompt }],
+      config: {
+        model: options?.model || "gpt-4o-mini",
+        maxIterations: 1,
+        tools: [],
+        // No tools - pure LLM completion
+        systemPrompt: options?.systemPrompt
+      }
+    });
+    return {
+      text: result.response,
+      costUsd: result.cost.totalUsd,
+      tokens: result.tokens,
+      model: options?.model || "gpt-4o-mini"
+    };
+  }
+  // ===========================================================================
   // Agent Runtime API
   // ===========================================================================
   /**