@mixrpay/agent-sdk 0.8.4 → 0.8.6

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'
      */
@@ -380,7 +379,7 @@ interface SessionStats {
  */
 
 /** Current SDK version */
-declare const SDK_VERSION = "0.8.3";
+declare const SDK_VERSION = "0.8.5";
 /** Supported networks */
 declare const NETWORKS: {
     readonly BASE_MAINNET: {
@@ -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.
      *
@@ -1371,6 +1378,162 @@ declare class AgentWallet {
      * ```
      */
     callMCPTool(toolName: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
+    /**
+     * 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);
+     * ```
+     */
+    deployJitMcp(options: DeployJitMcpOptions): Promise<DeployJitMcpResult>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    listJitInstances(options?: {
+        status?: 'provisioning' | 'active' | 'stopped' | 'expired';
+    }): Promise<JitInstance[]>;
+    /**
+     * 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');
+     * ```
+     */
+    stopJitInstance(instanceId: string): Promise<void>;
+    /**
+     * 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.
+     *
+     * 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.' }
+     * );
+     * ```
+     */
+    complete(prompt: string, options?: CompleteOptions): Promise<CompleteResult>;
     /**
      * Run an AI agent with LLM and tool execution.
      *
@@ -2081,6 +2244,161 @@ interface AgentMessage {
     /** Message content */
     content: string;
 }
+/**
+ * Options for deploying a JIT MCP server
+ */
+interface DeployJitMcpOptions {
+    /** Glama server ID (e.g., 'notion-mcp') */
+    glamaId: string;
+    /** Glama namespace (e.g., 'notion') */
+    glamaNamespace: string;
+    /** Glama slug (e.g., 'notion-mcp') */
+    glamaSlug: string;
+    /** Human-readable name for the tool */
+    toolName: string;
+    /** Optional description */
+    toolDescription?: string;
+    /** Environment variables for the MCP server (e.g., API keys) */
+    envVars?: Record<string, string>;
+    /** Time-to-live in hours (default: 24, max: 168) */
+    ttlHours?: number;
+}
+/**
+ * Result from deploying a JIT MCP server
+ */
+interface DeployJitMcpResult {
+    /** Deployed instance details */
+    instance: JitInstance;
+    /** Payment details */
+    payment: {
+        method: string;
+        amountUsd: number;
+        txHash?: string;
+    };
+}
+/**
+ * JIT MCP server instance
+ */
+interface JitInstance {
+    /** Instance ID */
+    id: string;
+    /** Private endpoint URL with secret token */
+    endpointUrl: string;
+    /** Tool name */
+    toolName: string;
+    /** Glama server ID */
+    glamaId: string;
+    /** Glama namespace */
+    glamaNamespace: string;
+    /** Glama slug */
+    glamaSlug: string;
+    /** Instance status */
+    status: 'provisioning' | 'active' | 'stopped' | 'expired' | 'failed';
+    /** Access mode */
+    mode: 'private' | 'public';
+    /** TTL in hours */
+    ttlHours: number;
+    /** Expiration time */
+    expiresAt: Date;
+    /** 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
+ */
+interface CompleteOptions {
+    /** LLM model to use (default: gpt-4o-mini) */
+    model?: string;
+    /** System prompt to set context */
+    systemPrompt?: string;
+}
+/**
+ * Result from simple LLM completion
+ */
+interface CompleteResult {
+    /** The LLM response text */
+    text: string;
+    /** Cost in USD */
+    costUsd: number;
+    /** Token usage */
+    tokens: {
+        prompt: number;
+        completion: number;
+    };
+    /** Model used */
+    model: string;
+}
 /**
  * Configuration for an agent run
  */
@@ -2446,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');
  *   }
  * }
  * ```
@@ -2664,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 DiagnosticsResult, InsufficientBalanceError, InvalidSessionKeyError, 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 };