@mixrpay/agent-sdk 0.8.5 → 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";
@@ -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.`);
@@ -2683,6 +2693,141 @@ Timestamp: ${timestamp}`;
       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
   // ===========================================================================

package/dist/index.d.cts

@@ -31,9 +31,8 @@ interface AgentWalletConfig {
      * Format: `sk_live_` (mainnet) or `sk_test_` (testnet) followed by 64 hex characters.
      *
      * Get session keys from:
-     * - The wallet owner's MixrPay dashboard
+     * - The wallet owner at https://mixrpay.com/manage/invites
      * - Programmatically via the MixrPay API
-     * - The MixrPay widget session key management
      *
      * @example 'sk_live_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
      */
@@ -890,7 +889,7 @@ declare class AgentWallet {
      *
      * @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',
@@ -983,6 +982,14 @@ declare class AgentWallet {
      * ```
      */
     getChildSessions(): Promise<ChildSession[]>;
+    /**
+     * List child sessions spawned by this agent.
+     *
+     * Alias for `getChildSessions()` for naming consistency.
+     *
+     * @returns Array of child session info
+     */
+    listChildSessions(): Promise<ChildSession[]>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *
@@ -1432,6 +1439,74 @@ declare class AgentWallet {
      * Parse JIT instance response data.
      */
     private parseJitInstance;
+    /**
+     * 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);
+     * ```
+     */
+    getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * 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: '...' },
+     *   });
+     * }
+     * ```
+     */
+    searchGlamaDirectory(query: string): Promise<GlamaSearchResult>;
+    /**
+     * 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));
+     * ```
+     */
+    getFeaturedGlamaServers(): Promise<GlamaSearchResult>;
+    /**
+     * Parse Glama server response data.
+     */
+    private parseGlamaServer;
     /**
      * Simple LLM completion - single-turn, no tools.
      *
@@ -2228,6 +2303,77 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * MCP server from the Glama directory
+ */
+interface GlamaServer {
+    /** Glama server ID */
+    id: string;
+    /** Server name */
+    name: string;
+    /** Namespace (e.g., "anthropics", "notion") */
+    namespace: string;
+    /** URL slug */
+    slug: string;
+    /** Server description */
+    description: string;
+    /** Glama URL */
+    url: string;
+    /** Server attributes (e.g., ["hosting:remote-capable", "author:official"]) */
+    attributes: string[];
+    /** Whether this server can be hosted as a JIT instance */
+    canHost: boolean;
+    /** Available tools */
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Repository info */
+    repository?: {
+        url: string;
+    };
+    /** License name */
+    license?: string;
+    /** Import data for deploying as JIT server */
+    importData?: GlamaImportData;
+}
+/**
+ * Import data for deploying a Glama server as JIT
+ */
+interface GlamaImportData {
+    /** Glama server ID */
+    glamaId: string;
+    /** Namespace */
+    glamaNamespace: string;
+    /** Slug */
+    glamaSlug: string;
+    /** Suggested display name */
+    suggestedName: string;
+    /** Suggested description */
+    suggestedDescription: string;
+    /** Hosting type */
+    hostingType: 'local' | 'remote' | 'hybrid';
+    /** Required environment variables (API keys) */
+    requiredEnvVars: string[];
+    /** Optional environment variables */
+    optionalEnvVars: string[];
+}
+/**
+ * Result from searching the Glama directory
+ */
+interface GlamaSearchResult {
+    /** Matching servers */
+    servers: GlamaServer[];
+    /** Pagination info */
+    pageInfo?: {
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    /** Original query (for search results) */
+    query?: string;
+    /** Whether these are featured servers */
+    featured?: boolean;
+}
 /**
  * Options for simple LLM completion
  */
@@ -2618,7 +2764,7 @@ declare class PaymentFailedError extends MixrPayError {
  * catch (error) {
  *   if (error instanceof InvalidSessionKeyError) {
  *     console.log(`Invalid key: ${error.reason}`);
- *     console.log('Get a valid session key from your MixrPay server /wallet/sessions');
+ *     console.log('Get a valid session key from https://mixrpay.com/manage/invites');
  *   }
  * }
  * ```
@@ -2836,4 +2982,4 @@ declare function isMixrPayError(error: unknown): error is MixrPayError;
  */
 declare function getErrorMessage(error: unknown): string;
 
-export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };
+export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, type GlamaImportData, type GlamaSearchResult, type GlamaServer, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.d.ts

@@ -31,9 +31,8 @@ interface AgentWalletConfig {
      * Format: `sk_live_` (mainnet) or `sk_test_` (testnet) followed by 64 hex characters.
      *
      * Get session keys from:
-     * - The wallet owner's MixrPay dashboard
+     * - The wallet owner at https://mixrpay.com/manage/invites
      * - Programmatically via the MixrPay API
-     * - The MixrPay widget session key management
      *
      * @example 'sk_live_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
      */
@@ -890,7 +889,7 @@ declare class AgentWallet {
      *
      * @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',
@@ -983,6 +982,14 @@ declare class AgentWallet {
      * ```
      */
     getChildSessions(): Promise<ChildSession[]>;
+    /**
+     * List child sessions spawned by this agent.
+     *
+     * Alias for `getChildSessions()` for naming consistency.
+     *
+     * @returns Array of child session info
+     */
+    listChildSessions(): Promise<ChildSession[]>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *
@@ -1432,6 +1439,74 @@ declare class AgentWallet {
      * Parse JIT instance response data.
      */
     private parseJitInstance;
+    /**
+     * 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);
+     * ```
+     */
+    getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * 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: '...' },
+     *   });
+     * }
+     * ```
+     */
+    searchGlamaDirectory(query: string): Promise<GlamaSearchResult>;
+    /**
+     * 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));
+     * ```
+     */
+    getFeaturedGlamaServers(): Promise<GlamaSearchResult>;
+    /**
+     * Parse Glama server response data.
+     */
+    private parseGlamaServer;
     /**
      * Simple LLM completion - single-turn, no tools.
      *
@@ -2228,6 +2303,77 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * MCP server from the Glama directory
+ */
+interface GlamaServer {
+    /** Glama server ID */
+    id: string;
+    /** Server name */
+    name: string;
+    /** Namespace (e.g., "anthropics", "notion") */
+    namespace: string;
+    /** URL slug */
+    slug: string;
+    /** Server description */
+    description: string;
+    /** Glama URL */
+    url: string;
+    /** Server attributes (e.g., ["hosting:remote-capable", "author:official"]) */
+    attributes: string[];
+    /** Whether this server can be hosted as a JIT instance */
+    canHost: boolean;
+    /** Available tools */
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Repository info */
+    repository?: {
+        url: string;
+    };
+    /** License name */
+    license?: string;
+    /** Import data for deploying as JIT server */
+    importData?: GlamaImportData;
+}
+/**
+ * Import data for deploying a Glama server as JIT
+ */
+interface GlamaImportData {
+    /** Glama server ID */
+    glamaId: string;
+    /** Namespace */
+    glamaNamespace: string;
+    /** Slug */
+    glamaSlug: string;
+    /** Suggested display name */
+    suggestedName: string;
+    /** Suggested description */
+    suggestedDescription: string;
+    /** Hosting type */
+    hostingType: 'local' | 'remote' | 'hybrid';
+    /** Required environment variables (API keys) */
+    requiredEnvVars: string[];
+    /** Optional environment variables */
+    optionalEnvVars: string[];
+}
+/**
+ * Result from searching the Glama directory
+ */
+interface GlamaSearchResult {
+    /** Matching servers */
+    servers: GlamaServer[];
+    /** Pagination info */
+    pageInfo?: {
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    /** Original query (for search results) */
+    query?: string;
+    /** Whether these are featured servers */
+    featured?: boolean;
+}
 /**
  * Options for simple LLM completion
  */
@@ -2618,7 +2764,7 @@ declare class PaymentFailedError extends MixrPayError {
  * catch (error) {
  *   if (error instanceof InvalidSessionKeyError) {
  *     console.log(`Invalid key: ${error.reason}`);
- *     console.log('Get a valid session key from your MixrPay server /wallet/sessions');
+ *     console.log('Get a valid session key from https://mixrpay.com/manage/invites');
  *   }
  * }
  * ```
@@ -2836,4 +2982,4 @@ declare function isMixrPayError(error: unknown): error is MixrPayError;
  */
 declare function getErrorMessage(error: unknown): string;
 
-export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };
+export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, type GlamaImportData, type GlamaSearchResult, type GlamaServer, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.js

@@ -63,7 +63,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 {
@@ -71,7 +71,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";
@@ -140,7 +140,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";
@@ -611,7 +611,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();
@@ -1124,7 +1124,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',
@@ -1350,6 +1350,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
   // ===========================================================================
@@ -1803,7 +1813,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;
@@ -1843,7 +1853,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.`);
@@ -2646,6 +2656,141 @@ Timestamp: ${timestamp}`;
       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
   // ===========================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixrpay/agent-sdk",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "MixrPay Agent SDK - Enable AI agents to make x402 payments with session keys",
   "type": "module",
   "main": "./dist/index.js",