@mixrpay/agent-sdk 0.8.4 → 0.8.5

package/dist/index.cjs

@@ -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 = {
@@ -2532,6 +2532,206 @@ 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)
+    };
+  }
+  // ===========================================================================
+  // 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
   // ===========================================================================
   /**

package/dist/index.d.cts

@@ -380,7 +380,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: {
@@ -1371,6 +1371,94 @@ 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;
+    /**
+     * 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 +2169,90 @@ 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;
+}
+/**
+ * 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
  */
@@ -2664,4 +2836,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, 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

@@ -380,7 +380,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: {
@@ -1371,6 +1371,94 @@ 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;
+    /**
+     * 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 +2169,90 @@ 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;
+}
+/**
+ * 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
  */
@@ -2664,4 +2836,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, 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

@@ -495,7 +495,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 = {
@@ -2495,6 +2495,206 @@ 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)
+    };
+  }
+  // ===========================================================================
+  // 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
   // ===========================================================================
   /**

package/package.json

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