@runhuman/mcp-server 2.0.3 → 2.0.5

package/.env.example

@@ -1,4 +1,4 @@
-# RunHuman API Configuration
+# Runhuman API Configuration
 
 # API Base URL
 # For local development, use http://localhost:3400

package/README.md

@@ -1,10 +1,10 @@
-# RunHuman MCP Server
+# Runhuman MCP Server
 
-A Model Context Protocol (MCP) server that allows AI agents to interact with the RunHuman QA testing service.
+A Model Context Protocol (MCP) server that allows AI agents to interact with the Runhuman QA testing service.
 
 ## Overview
 
-This MCP server provides tools for creating and managing human QA jobs through the RunHuman API. AI agents can use this server to:
+This MCP server provides tools for creating and managing human QA jobs through the Runhuman API. AI agents can use this server to:
 
 - Create new QA jobs with custom schemas
 - Check the status of running jobs
@@ -14,7 +14,7 @@ This MCP server provides tools for creating and managing human QA jobs through t
 
 ### For Claude Desktop (Recommended)
 
-1. Get your API key at: https://runhuman.com/app.html
+1. Get your API key at: https://runhuman.com/dashboard/api-keys
 
 2. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
 
@@ -86,7 +86,11 @@ if (result.status !== 'completed') {
 - `status`: Job status (completed, failed, timeout, pending, claimed, in_progress)
 - `costUsd`: Exact cost in USD with full precision (e.g., 0.396)
 - `testDurationSeconds`: Time spent by tester in seconds (rounded up)
-- Additional metadata (timestamps, tester info, etc.)
+- `testerResponse`: Raw natural language feedback from the human tester
+- `testerAlias`: Anonymized tester name (e.g., "Tester Alpha")
+- `testerAvatarUrl`: Avatar image URL for UI display
+- `testerColor`: Hex color code for theming (e.g., "#4A90E2")
+- Additional metadata (timestamps, etc.)
 
 **Cost Calculation:**
 - Costs are calculated as: `duration × $0.0018/second` (general-use tier)
@@ -96,16 +100,15 @@ if (result.status !== 'completed') {
 
 ## Configuration
 
-The MCP server needs to be configured with your RunHuman API credentials.
+The MCP server needs to be configured with your Runhuman API credentials.
 
 ### 1. Get an API Key
 
 **Option A: Via Dashboard**
 1. Start the API server: `npm run dev --workspace=@runhuman/api`
-2. Open http://localhost:3400/app.html
-3. Go to "API Keys" tab
-4. Click "Create API Key"
-5. Copy the key (starts with `qa_live_`)
+2. Open http://localhost:3400/api-keys
+3. Click "Create API Key"
+4. Copy the key (starts with `qa_live_`)
 
 **Option B: Use Default Test Key**
 - For local development, you can use: `qa_live_test_key_123`
@@ -237,4 +240,4 @@ For developers working on this MCP server:
 ## Learn More
 
 - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
-- [RunHuman API Documentation](../api/README.md)
+- [Runhuman API Documentation](../api/README.md)

package/dist/index.d.ts

@@ -1,12 +1,9 @@
 #!/usr/bin/env node
 /**
- * RunHuman MCP Server
+ * Runhuman MCP Server - stdio entry point
  *
- * This MCP server provides tools for AI agents to interact with the RunHuman QA testing service.
- * It allows agents to:
- * - Create QA jobs
- * - Check job status
- * - Retrieve job results
+ * This is the CLI entry point for npx @runhuman/mcp-server.
+ * It uses stdio transport for communication with MCP clients like Claude Desktop.
  *
  * @see https://modelcontextprotocol.io/
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/index.js

@@ -1,19 +1,15 @@
 #!/usr/bin/env node
 /**
- * RunHuman MCP Server
+ * Runhuman MCP Server - stdio entry point
  *
- * This MCP server provides tools for AI agents to interact with the RunHuman QA testing service.
- * It allows agents to:
- * - Create QA jobs
- * - Check job status
- * - Retrieve job results
+ * This is the CLI entry point for npx @runhuman/mcp-server.
+ * It uses stdio transport for communication with MCP clients like Claude Desktop.
  *
  * @see https://modelcontextprotocol.io/
  */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import * as dotenv from 'dotenv';
+import { createMcpServer } from './mcp-server-factory.js';
 // Load environment variables (optional - for standalone testing)
 dotenv.config();
 // Configuration
@@ -25,7 +21,7 @@ const apiUrlArg = args.find(arg => arg.startsWith('--api-url='))?.split('=')[1];
 const API_URL = apiUrlArg || process.env.RUNHUMAN_API_URL || 'https://qa-experiment.fly.dev';
 const API_KEY = apiKeyArg || process.env.RUNHUMAN_API_KEY;
 if (!API_KEY) {
-    console.error('❌ Error: API key is required');
+    console.error('Error: API key is required');
     console.error('');
     console.error('For Claude Desktop, add to your config:');
     console.error('{');
@@ -40,389 +36,20 @@ if (!API_KEY) {
     console.error('Get your API key at: https://qa-experiment.fly.dev/app.html');
     process.exit(1);
 }
-console.error(`🔗 Connected to RunHuman API at: ${API_URL}`);
-console.error(`🔑 Using API key: ${API_KEY.substring(0, 12)}...`);
-/**
- * Create and configure the MCP server
- */
-const server = new Server({
-    name: 'runhuman-mcp-server',
-    version: '1.0.0',
-}, {
-    capabilities: {
-        tools: {},
-        prompts: {},
-    },
-});
-/**
- * List available prompts (documentation for the agent)
- */
-server.setRequestHandler(ListPromptsRequestSchema, async () => {
-    return {
-        prompts: [
-            {
-                name: 'explain_runhuman',
-                description: 'Get an explanation of how to use RunHuman for QA testing',
-            },
-        ],
-    };
-});
-/**
- * List available tools
- */
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            {
-                name: 'create_job',
-                description: `⚠️ IMPORTANT: This ONLY creates and queues a job. It does NOT perform the test or return results. You MUST follow up with wait_for_result.
-
-Creates a QA job that will be performed by a REAL HUMAN tester (not AI). The human will manually test your application, describe findings in natural language, and GPT-4o will extract structured data from their response.
-
-Use this when you need human verification of:
-- UI/UX functionality that's hard to automate
-- Visual issues, accessibility problems
-- Complex user flows (login, checkout, forms)
-- Cross-browser compatibility
-- Real user experience feedback
-
-⚠️ REQUIRED WORKFLOW (do NOT skip steps):
-1. create_job → Returns jobId (job is now QUEUED, not complete!)
-2. wait_for_result → Checks status, waits, and retrieves results (takes 2-10 min total)
-3. If not complete, call wait_for_result again with longer wait time
-
-DO NOT treat job creation as completion. You MUST wait for and retrieve results.`,
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        url: {
-                            type: 'string',
-                            description: 'The URL to test (must be publicly accessible). Example: "https://myapp.com/checkout"',
-                        },
-                        description: {
-                            type: 'string',
-                            description: 'Clear instructions for the human tester. Be specific about what to test and how. Example: "Test the checkout flow: Add a product to cart, proceed to checkout, fill in shipping info, and verify the order summary shows correct totals before submitting."',
-                        },
-                        schema: {
-                            type: 'object',
-                            description: 'JSON Schema defining the structure you want extracted from the tester\'s response. Example: { "type": "object", "properties": { "checkoutWorks": { "type": "boolean" }, "totalIsCorrect": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "string" } } } }',
-                        },
-                        targetDurationMinutes: {
-                            type: 'number',
-                            description: 'Time limit in minutes for the tester to complete the test after claiming. Default: 5 minutes. Range: 1-60.',
-                        },
-                        allowDurationExtension: {
-                            type: 'boolean',
-                            description: 'Allow test duration to exceed targetDurationMinutes if the tester needs more time. Default: true.',
-                        },
-                        maxExtensionMinutes: {
-                            type: ['number', 'boolean'],
-                            description: 'Maximum additional minutes allowed for extension. Set to false for unlimited. Default: false (unlimited). Range: 1-60 if number.',
-                        },
-                    },
-                    required: ['url', 'description', 'schema'],
-                },
-            },
-            {
-                name: 'wait_for_result',
-                description: `Check status, wait, and retrieve results for a QA job in a single call.
-
-This tool combines status checking, waiting, and result retrieval into one convenient function:
-- Checks status BEFORE waiting (returns immediately if already complete)
-- Waits for the specified duration (default 30s, configurable 1-300s)
-- Checks status AFTER waiting
-- Returns results if complete, otherwise suggests calling again with longer wait
-
-Jobs progress through states: pending → claimed → in_progress → completed (or failed/timeout)
-Typical completion time: 2-10 minutes total
-
-Use this tool repeatedly with increasing wait times until you get results:
-- First call: wait_for_result(jobId, { waitSeconds: 30 })
-- If not complete: wait_for_result(jobId, { waitSeconds: 45 })
-- If still not complete: wait_for_result(jobId, { waitSeconds: 60 })
-
-Returns immediately if job is already complete (no waiting needed).`,
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        jobId: {
-                            type: 'string',
-                            description: 'The job ID returned from create_job. Example: "550e8400-e29b-41d4-a716-446655440000"',
-                        },
-                        waitSeconds: {
-                            type: 'number',
-                            description: 'How long to wait (in seconds) before checking status again. Default: 30. Range: 1-300. Increase this on subsequent calls (30 → 45 → 60) for better efficiency.',
-                            minimum: 1,
-                            maximum: 300,
-                        },
-                    },
-                    required: ['jobId'],
-                },
-            },
-        ],
-    };
-});
-/**
- * Handle tool calls
- */
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    if (!args) {
-        throw new Error('Missing arguments');
-    }
-    switch (name) {
-        case 'create_job':
-            try {
-                // Call RunHuman API to create job
-                const response = await fetch(`${API_URL}/api/jobs`, {
-                    method: 'POST',
-                    headers: {
-                        'Authorization': `Bearer ${API_KEY}`,
-                        'Content-Type': 'application/json'
-                    },
-                    body: JSON.stringify({
-                        url: args.url,
-                        description: args.description,
-                        outputSchema: args.schema,
-                        targetDurationMinutes: args.targetDurationMinutes,
-                        allowDurationExtension: args.allowDurationExtension,
-                        maxExtensionMinutes: args.maxExtensionMinutes,
-                    })
-                });
-                if (!response.ok) {
-                    const error = await response.json().catch(() => ({ error: response.statusText }));
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `❌ Failed to create job
-
-Error: ${error.error || error.message || response.statusText}
-Status: ${response.status}
-
-Please check:
-- Your RUNHUMAN_API_KEY is valid
-- The API server is running at ${API_URL}
-- Your API key has permission to create jobs`
-                            }],
-                        isError: true
-                    };
-                }
-                const data = await response.json();
-                const duration = args.targetDurationMinutes || 5;
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `⏳ Job QUEUED (not complete yet!)
-
-Job ID: ${data.jobId}
-Status: ${data.status}
-URL: ${args.url}
-Time limit: ${duration} minutes
-
-The test has been queued for a HUMAN tester. It is NOT complete yet.
-
-⚠️ REQUIRED NEXT STEPS:
-1. Call wait_for_result(jobId: "${data.jobId}", waitSeconds: 30)
-2. If not complete, call wait_for_result again with waitSeconds: 45
-3. Continue with increasing wait times (60, 90, etc.) until complete
-
-Typical completion time: 2-10 minutes total.
-
-DO NOT consider this task done until you have retrieved the results!`,
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `❌ Error creating job
-
-${error instanceof Error ? error.message : 'Unknown error'}
-
-Please check:
-- The API server is running at ${API_URL}
-- Your network connection
-- Your .env file configuration`
-                        }],
-                    isError: true
-                };
-            }
-        case 'wait_for_result':
-            try {
-                const waitSeconds = Math.min(Math.max(args.waitSeconds || 30, 1), 300);
-                // Helper function to check job status
-                const checkJobStatus = async () => {
-                    const response = await fetch(`${API_URL}/api/job/${args.jobId}`, {
-                        headers: {
-                            'Authorization': `Bearer ${API_KEY}`
-                        }
-                    });
-                    if (!response.ok) {
-                        if (response.status === 404) {
-                            throw new Error(`Job not found: ${args.jobId}`);
-                        }
-                        throw new Error(`Failed to get job status: ${response.status} ${response.statusText}`);
-                    }
-                    return await response.json();
-                };
-                // Check status BEFORE waiting
-                console.error(`[wait_for_result] Checking initial status for job ${args.jobId}...`);
-                let job = await checkJobStatus();
-                // If already complete, return immediately
-                if (job.status === 'completed' || job.status === 'failed' || job.status === 'timeout') {
-                    console.error(`[wait_for_result] Job already in terminal state: ${job.status}`);
-                    if (job.status === 'completed') {
-                        return {
-                            content: [
-                                {
-                                    type: 'text',
-                                    text: `✅ Test completed!
-
-Job ID: ${job.id}
-
-**Test Results:**`
-                                },
-                                {
-                                    type: 'text',
-                                    text: JSON.stringify({
-                                        result: job.result || {},
-                                        testerData: job.testerData
-                                    }, null, 2)
-                                }
-                            ]
-                        };
-                    }
-                    else if (job.status === 'failed') {
-                        return {
-                            content: [{
-                                    type: 'text',
-                                    text: `❌ Job failed
-
-Job ID: ${job.id}
-Error: ${job.error || 'Unknown error'}`
-                                }],
-                            isError: true
-                        };
-                    }
-                    else { // timeout
-                        return {
-                            content: [{
-                                    type: 'text',
-                                    text: `⏰ Job timed out
-
-Job ID: ${job.id}
-
-The tester did not complete the test in time.`
-                                }],
-                            isError: true
-                        };
-                    }
-                }
-                // Job not complete yet, wait and check again
-                console.error(`[wait_for_result] Job status: ${job.status}. Waiting ${waitSeconds} seconds...`);
-                const statusEmoji = {
-                    pending: '⏳',
-                    claimed: '👤',
-                    in_progress: '🔄'
-                };
-                const emoji = statusEmoji[job.status] || '📊';
-                await new Promise(resolve => setTimeout(resolve, waitSeconds * 1000));
-                // Check status AFTER waiting
-                console.error(`[wait_for_result] Checking status after ${waitSeconds}s wait...`);
-                job = await checkJobStatus();
-                // Check if complete now
-                if (job.status === 'completed') {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: `✅ Test completed!
-
-Job ID: ${job.id}
-
-**Test Results:**`
-                            },
-                            {
-                                type: 'text',
-                                text: JSON.stringify({
-                                    result: job.result || {},
-                                    testerData: job.testerData
-                                }, null, 2)
-                            }
-                        ]
-                    };
-                }
-                else if (job.status === 'failed') {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `❌ Job failed
-
-Job ID: ${job.id}
-Error: ${job.error || 'Unknown error'}`
-                            }],
-                        isError: true
-                    };
-                }
-                else if (job.status === 'timeout') {
-                    return {
-                        content: [{
-                                type: 'text',
-                                text: `⏰ Job timed out
-
-Job ID: ${job.id}
-
-The tester did not complete the test in time.`
-                            }],
-                        isError: true
-                    };
-                }
-                // Still not complete, suggest calling again with longer wait
-                const nextWait = Math.min(waitSeconds + 15, 120);
-                const statusMessage = job.status === 'pending' ?
-                    'Waiting for a tester to claim this job...' :
-                    'The tester is working on your test...';
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `${emoji} Job Status: ${job.status}
-
-Job ID: ${job.id}
-
-${statusMessage}
-
-⏰ Waited ${waitSeconds}s, job not complete yet.
-
-💡 Suggestion: Call wait_for_result again with waitSeconds: ${nextWait}
-Typical completion time: 2-10 minutes total.`
-                        }]
-                };
-            }
-            catch (error) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `❌ Error waiting for result
-
-${error instanceof Error ? error.message : 'Unknown error'}`
-                        }],
-                    isError: true
-                };
-            }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
+console.error(`Connected to Runhuman API at: ${API_URL}`);
+console.error(`Using API key: ${API_KEY.substring(0, 12)}...`);
+// Create the MCP server with configuration
+const server = createMcpServer({
+    apiUrl: API_URL,
+    apiKey: API_KEY,
 });
 /**
- * Start the server
+ * Start the server with stdio transport
  */
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('RunHuman MCP server running on stdio');
+    console.error('Runhuman MCP server running on stdio');
 }
 main().catch((error) => {
     console.error('Server error:', error);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,iEAAiE;AACjE,MAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,gBAAgB;AAChB,2CAA2C;AAC3C,0EAA0E;AAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,OAAO,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,+BAA+B,CAAC;AAC7F,MAAM,OAAO,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAE1D,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACzF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;AAC1D,OAAO,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAE/D,2CAA2C;AAC3C,MAAM,MAAM,GAAG,eAAe,CAAC;IAC7B,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Server Library Exports
+ *
+ * This file provides library exports for programmatic use.
+ * The index.ts file is the CLI entry point (with shebang).
+ */
+export { createMcpServer } from './mcp-server-factory.js';
+export type { McpServerConfig, CreateJobArgs, WaitForResultArgs, JobResponse, CreateJobResponse } from './types.js';
+//# sourceMappingURL=lib.d.ts.map

package/dist/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib.js

@@ -0,0 +1,8 @@
+/**
+ * MCP Server Library Exports
+ *
+ * This file provides library exports for programmatic use.
+ * The index.ts file is the CLI entry point (with shebang).
+ */
+export { createMcpServer } from './mcp-server-factory.js';
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/mcp-server-factory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server Factory
+ *
+ * Creates a configured MCP Server instance without connecting a transport.
+ * This allows the server to be used with different transports (stdio, HTTP).
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { McpServerConfig } from './types.js';
+export declare function createMcpServer(config: McpServerConfig): Server;
+//# sourceMappingURL=mcp-server-factory.d.ts.map

package/dist/mcp-server-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-factory.d.ts","sourceRoot":"","sources":["../src/mcp-server-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,KAAK,EAAE,eAAe,EAAoC,MAAM,YAAY,CAAC;AAQpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAkD/D"}

package/dist/mcp-server-factory.js

@@ -0,0 +1,50 @@
+/**
+ * MCP Server Factory
+ *
+ * Creates a configured MCP Server instance without connecting a transport.
+ * This allows the server to be used with different transports (stdio, HTTP).
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { createJobToolDefinition, handleCreateJob, waitForResultToolDefinition, handleWaitForResult, } from './tools/index.js';
+export function createMcpServer(config) {
+    const server = new Server({
+        name: 'runhuman-mcp-server',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    // Register prompts
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: [
+            {
+                name: 'explain_runhuman',
+                description: 'Get an explanation of how to use Runhuman for QA testing',
+            },
+        ],
+    }));
+    // Register tools list
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [createJobToolDefinition, waitForResultToolDefinition],
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (!args) {
+            throw new Error('Missing arguments');
+        }
+        switch (name) {
+            case 'create_job':
+                return handleCreateJob(args, config);
+            case 'wait_for_result':
+                return handleWaitForResult(args, config);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=mcp-server-factory.js.map

package/dist/mcp-server-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-factory.js","sourceRoot":"","sources":["../src/mcp-server-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,mBAAmB;IACnB,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE,0DAA0D;aACxE;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,sBAAsB;IACtB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;KAC9D,CAAC,CAAC,CAAC;IAEJ,oBAAoB;IACpB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,YAAY;gBACf,OAAO,eAAe,CAAC,IAAgC,EAAE,MAAM,CAAC,CAAC;YAEnE,KAAK,iBAAiB;gBACpB,OAAO,mBAAmB,CAAC,IAAoC,EAAE,MAAM,CAAC,CAAC;YAE3E;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/create-job.tool.d.ts

@@ -0,0 +1,14 @@
+/**
+ * create_job Tool - Creates a QA job for human testing
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { McpServerConfig, CreateJobArgs } from '../types.js';
+export declare const createJobToolDefinition: Tool;
+export declare function handleCreateJob(args: CreateJobArgs, config: McpServerConfig): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=create-job.tool.d.ts.map

package/dist/tools/create-job.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-job.tool.d.ts","sourceRoot":"","sources":["../../src/tools/create-job.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAErF,eAAO,MAAM,uBAAuB,EAAE,IAqDrC,CAAC;AAEF,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAiFhF"}

package/dist/tools/create-job.tool.js

@@ -0,0 +1,137 @@
+/**
+ * create_job Tool - Creates a QA job for human testing
+ */
+export const createJobToolDefinition = {
+    name: 'create_job',
+    description: `IMPORTANT: This ONLY creates and queues a job. It does NOT perform the test or return results. You MUST follow up with wait_for_result.
+
+Creates a QA job that will be performed by a REAL HUMAN tester (not AI). The human will manually test your application, describe findings in natural language, and GPT-4o will extract structured data from their response.
+
+Use this when you need human verification of:
+- UI/UX functionality that's hard to automate
+- Visual issues, accessibility problems
+- Complex user flows (login, checkout, forms)
+- Cross-browser compatibility
+- Real user experience feedback
+
+REQUIRED WORKFLOW (do NOT skip steps):
+1. create_job → Returns jobId (job is now QUEUED, not complete!)
+2. wait_for_result → Checks status, waits, and retrieves results (takes 2-10 min total)
+3. If not complete, call wait_for_result again with longer wait time
+
+DO NOT treat job creation as completion. You MUST wait for and retrieve results.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to test (must be publicly accessible). Example: "https://myapp.com/checkout"',
+            },
+            description: {
+                type: 'string',
+                description: 'Clear instructions for the human tester. Be specific about what to test and how. Example: "Test the checkout flow: Add a product to cart, proceed to checkout, fill in shipping info, and verify the order summary shows correct totals before submitting."',
+            },
+            schema: {
+                type: 'object',
+                description: 'JSON Schema defining the structure you want extracted from the tester\'s response. Example: { "type": "object", "properties": { "checkoutWorks": { "type": "boolean" }, "totalIsCorrect": { "type": "boolean" }, "issues": { "type": "array", "items": { "type": "string" } } } }',
+            },
+            targetDurationMinutes: {
+                type: 'number',
+                description: 'Time limit in minutes for the tester to complete the test after claiming. Default: 5 minutes. Range: 1-60.',
+            },
+            allowDurationExtension: {
+                type: 'boolean',
+                description: 'Allow test duration to exceed targetDurationMinutes if the tester needs more time. Default: true.',
+            },
+            maxExtensionMinutes: {
+                type: ['number', 'boolean'],
+                description: 'Maximum additional minutes allowed for extension. Set to false for unlimited. Default: false (unlimited). Range: 1-60 if number.',
+            },
+            additionalValidationInstructions: {
+                type: 'string',
+                description: 'Optional custom instructions for the AI when validating test results. Use this to specify what to focus on, what to ignore, or how to interpret specific scenarios. Example: "Ignore minor UI glitches in the header. Only mark as failed if the core checkout functionality does not work."',
+            },
+        },
+        required: ['url', 'description', 'schema'],
+    },
+};
+export async function handleCreateJob(args, config) {
+    const { apiUrl, apiKey } = config;
+    try {
+        const response = await fetch(`${apiUrl}/api/jobs`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                url: args.url,
+                description: args.description,
+                outputSchema: args.schema,
+                targetDurationMinutes: args.targetDurationMinutes,
+                allowDurationExtension: args.allowDurationExtension,
+                maxExtensionMinutes: args.maxExtensionMinutes,
+                additionalValidationInstructions: args.additionalValidationInstructions,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to create job
+
+Error: ${error.error || error.message || response.statusText}
+Status: ${response.status}
+
+Please check:
+- Your RUNHUMAN_API_KEY is valid
+- The API server is running at ${apiUrl}
+- Your API key has permission to create jobs`,
+                    }],
+                isError: true,
+            };
+        }
+        const data = await response.json();
+        const duration = args.targetDurationMinutes || 5;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Job QUEUED (not complete yet!)
+
+Job ID: ${data.jobId}
+Status: ${data.status}
+URL: ${args.url}
+Time limit: ${duration} minutes
+
+The test has been queued for a HUMAN tester. It is NOT complete yet.
+
+REQUIRED NEXT STEPS:
+1. Call wait_for_result(jobId: "${data.jobId}", waitSeconds: 30)
+2. If not complete, call wait_for_result again with waitSeconds: 45
+3. Continue with increasing wait times (60, 90, etc.) until complete
+
+Typical completion time: 2-10 minutes total.
+
+DO NOT consider this task done until you have retrieved the results!`,
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error creating job
+
+${error instanceof Error ? error.message : 'Unknown error'}
+
+Please check:
+- The API server is running at ${apiUrl}
+- Your network connection
+- Your .env file configuration`,
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=create-job.tool.js.map

package/dist/tools/create-job.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-job.tool.js","sourceRoot":"","sources":["../../src/tools/create-job.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Tools - Barrel export
+ */
+export { createJobToolDefinition, handleCreateJob } from './create-job.tool.js';
+export { waitForResultToolDefinition, handleWaitForResult } from './wait-for-result.tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+/**
+ * MCP Tools - Barrel export
+ */
+export { createJobToolDefinition, handleCreateJob } from './create-job.tool.js';
+export { waitForResultToolDefinition, handleWaitForResult } from './wait-for-result.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/wait-for-result.tool.d.ts

@@ -0,0 +1,14 @@
+/**
+ * wait_for_result Tool - Check status and retrieve results for a QA job
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { McpServerConfig, WaitForResultArgs } from '../types.js';
+export declare const waitForResultToolDefinition: Tool;
+export declare function handleWaitForResult(args: WaitForResultArgs, config: McpServerConfig): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=wait-for-result.tool.d.ts.map

package/dist/tools/wait-for-result.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-result.tool.d.ts","sourceRoot":"","sources":["../../src/tools/wait-for-result.tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAEnF,eAAO,MAAM,2BAA2B,EAAE,IAwCzC,CAAC;AAyFF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAiHhF"}

package/dist/tools/wait-for-result.tool.js

@@ -0,0 +1,231 @@
+/**
+ * wait_for_result Tool - Check status and retrieve results for a QA job
+ */
+export const waitForResultToolDefinition = {
+    name: 'wait_for_result',
+    description: `Check status, wait, and retrieve results for a QA job in a single call.
+
+This tool combines status checking, waiting, and result retrieval into one convenient function:
+- Checks status BEFORE waiting (returns immediately if already complete)
+- Polls status every 5 seconds during the wait period
+- Returns immediately when job completes (no need to wait full duration)
+- Returns results if complete, otherwise suggests calling again with longer wait
+
+Jobs progress through states: pending → waiting → working → completed (or incomplete/abandoned/error)
+- pending: Job is being prepared
+- waiting: Job posted to Slack, waiting for a tester to claim it
+- working: Tester has claimed the job and is actively testing
+- completed/incomplete/abandoned/error: Terminal states
+
+Typical completion time: 2-10 minutes total
+
+Use this tool repeatedly with increasing wait times until you get results:
+- First call: wait_for_result(jobId, { waitSeconds: 30 })
+- If not complete: wait_for_result(jobId, { waitSeconds: 45 })
+- If still not complete: wait_for_result(jobId, { waitSeconds: 60 })
+
+Returns immediately if job is already complete (no waiting needed).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            jobId: {
+                type: 'string',
+                description: 'The job ID returned from create_job. Example: "550e8400-e29b-41d4-a716-446655440000"',
+            },
+            waitSeconds: {
+                type: 'number',
+                description: 'How long to wait (in seconds) before checking status again. Default: 30. Range: 1-300. Increase this on subsequent calls (30 → 45 → 60) for better efficiency.',
+                minimum: 1,
+                maximum: 300,
+            },
+        },
+        required: ['jobId'],
+    },
+};
+async function checkJobStatus(jobId, config) {
+    const response = await fetch(`${config.apiUrl}/api/job/${jobId}`, {
+        headers: {
+            'Authorization': `Bearer ${config.apiKey}`,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Job not found: ${jobId}`);
+        }
+        throw new Error(`Failed to get job status: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+}
+function formatCompletedResult(job) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Test completed!
+
+Job ID: ${job.id}
+
+**Test Results:**`,
+            },
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    result: job.result || {},
+                    testerResponse: job.testerResponse,
+                    testerAlias: job.testerAlias,
+                    testerAvatarUrl: job.testerAvatarUrl,
+                    testerColor: job.testerColor,
+                    testerData: job.testerData,
+                }, null, 2),
+            },
+        ],
+    };
+}
+function formatIncompleteResult(job) {
+    return {
+        content: [{
+                type: 'text',
+                text: `Test completed with incomplete data
+
+Job ID: ${job.id}
+
+The test was completed but some required data was missing or incomplete.
+${job.error ? `\nDetails: ${job.error}` : ''}`,
+            }],
+        isError: true,
+    };
+}
+function formatAbandonedResult(job) {
+    return {
+        content: [{
+                type: 'text',
+                text: `Test abandoned
+
+Job ID: ${job.id}
+
+The tester abandoned this test.
+${job.error ? `\nReason: ${job.error}` : ''}`,
+            }],
+        isError: true,
+    };
+}
+function formatErrorResult(job) {
+    return {
+        content: [{
+                type: 'text',
+                text: `Test failed due to system error
+
+Job ID: ${job.id}
+
+Error: ${job.error || 'Unknown error'}`,
+            }],
+        isError: true,
+    };
+}
+export async function handleWaitForResult(args, config) {
+    try {
+        const waitSeconds = Math.min(Math.max(args.waitSeconds || 30, 1), 300);
+        const pollIntervalSeconds = 5; // Poll every 5 seconds
+        // Check status BEFORE waiting
+        console.error(`[wait_for_result] Checking initial status for job ${args.jobId}...`);
+        let job = await checkJobStatus(args.jobId, config);
+        // If already in terminal state, return immediately
+        if (job.status === 'completed') {
+            console.error(`[wait_for_result] Job already completed`);
+            return formatCompletedResult(job);
+        }
+        if (job.status === 'incomplete') {
+            console.error(`[wait_for_result] Job already completed with incomplete data`);
+            return formatIncompleteResult(job);
+        }
+        if (job.status === 'abandoned') {
+            console.error(`[wait_for_result] Job already abandoned`);
+            return formatAbandonedResult(job);
+        }
+        if (job.status === 'error') {
+            console.error(`[wait_for_result] Job already failed with error`);
+            return formatErrorResult(job);
+        }
+        // Job not complete yet, poll periodically during the wait period
+        console.error(`[wait_for_result] Job status: ${job.status}. Polling every ${pollIntervalSeconds}s for up to ${waitSeconds}s...`);
+        const startTime = Date.now();
+        const maxWaitMs = waitSeconds * 1000;
+        let elapsedSeconds = 0;
+        while (true) {
+            // Wait for the poll interval
+            await new Promise(resolve => setTimeout(resolve, pollIntervalSeconds * 1000));
+            elapsedSeconds += pollIntervalSeconds;
+            // Check if we've exceeded the max wait time
+            const elapsed = Date.now() - startTime;
+            if (elapsed >= maxWaitMs) {
+                console.error(`[wait_for_result] Reached max wait time of ${waitSeconds}s`);
+                break;
+            }
+            // Check status
+            console.error(`[wait_for_result] Polling status (${elapsedSeconds}s elapsed)...`);
+            job = await checkJobStatus(args.jobId, config);
+            // Check if in terminal state now
+            if (job.status === 'completed') {
+                console.error(`[wait_for_result] Job completed after ${elapsedSeconds}s`);
+                return formatCompletedResult(job);
+            }
+            if (job.status === 'incomplete') {
+                console.error(`[wait_for_result] Job completed with incomplete data after ${elapsedSeconds}s`);
+                return formatIncompleteResult(job);
+            }
+            if (job.status === 'abandoned') {
+                console.error(`[wait_for_result] Job abandoned after ${elapsedSeconds}s`);
+                return formatAbandonedResult(job);
+            }
+            if (job.status === 'error') {
+                console.error(`[wait_for_result] Job failed with error after ${elapsedSeconds}s`);
+                return formatErrorResult(job);
+            }
+            console.error(`[wait_for_result] Job still ${job.status}, continuing to poll...`);
+        }
+        // Reached max wait time without completion
+        const nextWait = Math.min(waitSeconds + 15, 120);
+        // Determine appropriate status message based on job state
+        let statusMessage;
+        if (job.status === 'pending') {
+            statusMessage = 'Your test is being prepared and will be posted to testers shortly...';
+        }
+        else if (job.status === 'waiting') {
+            statusMessage = 'Waiting for a tester to claim your test...';
+        }
+        else if (job.status === 'working') {
+            statusMessage = 'The tester is working on your test...';
+        }
+        else {
+            // Fallback for any unexpected status
+            statusMessage = `Job is in ${job.status} state...`;
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Job Status: ${job.status}
+
+Job ID: ${job.id}
+
+${statusMessage}
+
+Waited ${waitSeconds}s (polling every ${pollIntervalSeconds}s), job not complete yet.
+
+Suggestion: Call wait_for_result again with waitSeconds: ${nextWait}
+Typical completion time: 2-10 minutes total.`,
+                }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error waiting for result
+
+${error instanceof Error ? error.message : 'Unknown error'}`,
+                }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=wait-for-result.tool.js.map

package/dist/tools/wait-for-result.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-result.tool.js","sourceRoot":"","sources":["../../src/tools/wait-for-result.tool.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP Server Configuration Types
+ */
+export interface McpServerConfig {
+    /** Base URL of the Runhuman API */
+    apiUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+}
+export interface CreateJobArgs {
+    url: string;
+    description: string;
+    schema: Record<string, unknown>;
+    targetDurationMinutes?: number;
+    allowDurationExtension?: boolean;
+    maxExtensionMinutes?: number | boolean;
+    /** Custom instructions for the AI when validating test results */
+    additionalValidationInstructions?: string;
+}
+export interface WaitForResultArgs {
+    jobId: string;
+    waitSeconds?: number;
+}
+export interface JobResponse {
+    id: string;
+    status: string;
+    result?: unknown;
+    error?: string;
+    testerResponse?: string;
+    testerAlias?: string;
+    testerAvatarUrl?: string;
+    testerColor?: string;
+    testerData?: {
+        testDurationSeconds: number;
+        consoleMessages: Array<{
+            type: string;
+            message: string;
+            timestamp: string;
+        }>;
+        networkRequests: Array<{
+            url: string;
+            method: string;
+            status?: number;
+            timestamp: string;
+        }>;
+        clicks: Array<{
+            x: number;
+            y: number;
+            timestamp: string;
+            element?: string;
+        }>;
+        screenshots: string[];
+        videoUrl?: string;
+    };
+}
+export interface CreateJobResponse {
+    jobId: string;
+    status: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kEAAkE;IAClE,gCAAgC,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7E,eAAe,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5F,MAAM,EAAE,KAAK,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * MCP Server Configuration Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,9 +1,24 @@
 {
   "name": "@runhuman/mcp-server",
-  "version": "2.0.3",
-  "description": "Model Context Protocol (MCP) server for RunHuman - Human-powered QA testing for AI agents",
-  "main": "dist/index.js",
+  "version": "2.0.5",
+  "description": "Model Context Protocol (MCP) server for Runhuman - Human-powered QA testing for AI agents",
+  "main": "dist/lib.js",
   "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/lib.js",
+      "require": "./dist/lib.js",
+      "types": "./dist/lib.d.ts"
+    },
+    "./factory": {
+      "import": "./dist/mcp-server-factory.js",
+      "types": "./dist/mcp-server-factory.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
   "bin": {
     "runhuman-mcp": "dist/index.js"
   },
@@ -17,6 +32,7 @@
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build",
+    "type-check": "tsc",
     "test": "node test-simple.cjs",
     "test:all": "node test-all-tools.cjs",
     "test:routes": "node test-route-fix.cjs",
@@ -36,7 +52,7 @@
     "qa-testing",
     "manual-testing"
   ],
-  "author": "RunHuman <hey@runhuman.com>",
+  "author": "Runhuman <hey@runhuman.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yueranyuan/qa-experiment.git",