@mixrpay/agent-sdk 0.8.8 → 0.8.9

package/dist/index.cjs

@@ -2723,6 +2723,248 @@ Timestamp: ${timestamp}`;
     return this.parseJitInstance(data.instance);
   }
   // ===========================================================================
+  // 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);
+    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
   // ===========================================================================
   /**

package/dist/index.d.cts

@@ -1459,6 +1459,143 @@ declare class AgentWallet {
      * ```
      */
     getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * 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
+     */
+    useSkill(skillId: string, options?: UseSkillOptions): Promise<UseSkillResult>;
+    /**
+     * 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(', ')}`);
+     * }
+     * ```
+     */
+    listSkills(): Promise<SkillInfo[]>;
+    /**
+     * 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.
+     *   }
+     * }
+     * ```
+     */
+    getConnectedApps(): Promise<ConnectedAppsResult>;
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    getSkillStatus(skillId: string): Promise<SkillStatus>;
+    /**
+     * 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
+     * ```
+     */
+    configureSkill(skillId: string, envVars: Record<string, string>): Promise<{
+        success: boolean;
+        skillId: string;
+        configuredVars: string[];
+    }>;
     /**
      * Search the Glama MCP server directory.
      *
@@ -2468,6 +2605,115 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * Options for using a skill
+ */
+interface UseSkillOptions {
+    /** Time-to-live in hours for the MCP server (default: 24, max: 48) */
+    ttlHours?: number;
+}
+/**
+ * Result from using a skill
+ */
+interface UseSkillResult {
+    /** Skill ID */
+    skillId: string;
+    /** MCP server endpoint URL */
+    endpoint: string;
+    /** Available tool names */
+    tools: string[];
+    /** When the MCP server expires */
+    expiresAt: Date;
+    /** JIT instance ID for reference */
+    instanceId: string;
+}
+/**
+ * Skill information from the skills list
+ */
+interface SkillInfo {
+    /** Skill ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Category */
+    category: string;
+    /** Category display name */
+    categoryName: string;
+    /** Icon name */
+    icon: string;
+    /** Whether this is a built-in skill */
+    builtIn: boolean;
+    /** Whether this skill requires MCP deployment */
+    requiresMcp: boolean;
+    /** Whether this skill is available */
+    available: boolean;
+    /** Configuration status */
+    status: 'not_configured' | 'configured' | 'error';
+    /** Last used timestamp */
+    lastUsedAt?: string;
+    /** Error message if status is 'error' */
+    errorMessage?: string;
+    /** Environment variables required */
+    envVars: Array<{
+        name: string;
+        label: string;
+        description: string;
+        required: boolean;
+        isSecret: boolean;
+        configured: boolean;
+    }>;
+}
+/**
+ * Skill configuration status
+ */
+interface SkillStatus {
+    /** Skill ID */
+    skillId: string;
+    /** Configuration status */
+    status: 'not_configured' | 'configured' | 'error';
+    /** Names of configured environment variables */
+    configuredVars: string[];
+    /** Last used timestamp */
+    lastUsedAt?: Date;
+    /** Error message if status is 'error' */
+    errorMessage?: string;
+}
+/**
+ * Connected apps information from Composio
+ */
+interface ConnectedAppsResult {
+    /** Array of connected app IDs (e.g., ['gmail', 'slack', 'github']) */
+    connected: string[];
+    /** Full connection details */
+    connections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        type: 'oauth' | 'api_key';
+        status: string;
+        account_name: string | null;
+        connected_at: string;
+    }>;
+    /** OAuth connections only */
+    oauthConnections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        status: string;
+        account_name: string | null;
+        connected_at: string;
+    }>;
+    /** API key connections only */
+    apiKeyConnections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        status: string;
+        connected_at: string;
+    }>;
+}
 /**
  * MCP server from the Glama directory
  */
@@ -3403,4 +3649,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, 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 };
+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 SkillInfo, type SkillStatus, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, type UseSkillOptions, type UseSkillResult, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.d.ts

@@ -1459,6 +1459,143 @@ declare class AgentWallet {
      * ```
      */
     getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * 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
+     */
+    useSkill(skillId: string, options?: UseSkillOptions): Promise<UseSkillResult>;
+    /**
+     * 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(', ')}`);
+     * }
+     * ```
+     */
+    listSkills(): Promise<SkillInfo[]>;
+    /**
+     * 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.
+     *   }
+     * }
+     * ```
+     */
+    getConnectedApps(): Promise<ConnectedAppsResult>;
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    getSkillStatus(skillId: string): Promise<SkillStatus>;
+    /**
+     * 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
+     * ```
+     */
+    configureSkill(skillId: string, envVars: Record<string, string>): Promise<{
+        success: boolean;
+        skillId: string;
+        configuredVars: string[];
+    }>;
     /**
      * Search the Glama MCP server directory.
      *
@@ -2468,6 +2605,115 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * Options for using a skill
+ */
+interface UseSkillOptions {
+    /** Time-to-live in hours for the MCP server (default: 24, max: 48) */
+    ttlHours?: number;
+}
+/**
+ * Result from using a skill
+ */
+interface UseSkillResult {
+    /** Skill ID */
+    skillId: string;
+    /** MCP server endpoint URL */
+    endpoint: string;
+    /** Available tool names */
+    tools: string[];
+    /** When the MCP server expires */
+    expiresAt: Date;
+    /** JIT instance ID for reference */
+    instanceId: string;
+}
+/**
+ * Skill information from the skills list
+ */
+interface SkillInfo {
+    /** Skill ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Category */
+    category: string;
+    /** Category display name */
+    categoryName: string;
+    /** Icon name */
+    icon: string;
+    /** Whether this is a built-in skill */
+    builtIn: boolean;
+    /** Whether this skill requires MCP deployment */
+    requiresMcp: boolean;
+    /** Whether this skill is available */
+    available: boolean;
+    /** Configuration status */
+    status: 'not_configured' | 'configured' | 'error';
+    /** Last used timestamp */
+    lastUsedAt?: string;
+    /** Error message if status is 'error' */
+    errorMessage?: string;
+    /** Environment variables required */
+    envVars: Array<{
+        name: string;
+        label: string;
+        description: string;
+        required: boolean;
+        isSecret: boolean;
+        configured: boolean;
+    }>;
+}
+/**
+ * Skill configuration status
+ */
+interface SkillStatus {
+    /** Skill ID */
+    skillId: string;
+    /** Configuration status */
+    status: 'not_configured' | 'configured' | 'error';
+    /** Names of configured environment variables */
+    configuredVars: string[];
+    /** Last used timestamp */
+    lastUsedAt?: Date;
+    /** Error message if status is 'error' */
+    errorMessage?: string;
+}
+/**
+ * Connected apps information from Composio
+ */
+interface ConnectedAppsResult {
+    /** Array of connected app IDs (e.g., ['gmail', 'slack', 'github']) */
+    connected: string[];
+    /** Full connection details */
+    connections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        type: 'oauth' | 'api_key';
+        status: string;
+        account_name: string | null;
+        connected_at: string;
+    }>;
+    /** OAuth connections only */
+    oauthConnections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        status: string;
+        account_name: string | null;
+        connected_at: string;
+    }>;
+    /** API key connections only */
+    apiKeyConnections: Array<{
+        id: string;
+        app: string;
+        app_name: string;
+        status: string;
+        connected_at: string;
+    }>;
+}
 /**
  * MCP server from the Glama directory
  */
@@ -3403,4 +3649,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, 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 };
+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 SkillInfo, type SkillStatus, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, type UseSkillOptions, type UseSkillResult, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.js

@@ -2686,6 +2686,248 @@ Timestamp: ${timestamp}`;
     return this.parseJitInstance(data.instance);
   }
   // ===========================================================================
+  // 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);
+    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
   // ===========================================================================
   /**

package/package.json

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