@runhuman/mcp-server 2.0.3 → 2.0.4

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

@@ -0,0 +1,132 @@
+/**
+ * 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.',
+            },
+        },
+        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,
+            }),
+        });
+        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":"AAAA;;GAEG;AAKH,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;;;;;;;;;;iFAgBkE;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6PAA6P;aAC3Q;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mRAAmR;aACjS;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4GAA4G;aAC1H;YACD,sBAAsB,EAAE;gBACtB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mGAAmG;aACjH;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC3B,WAAW,EAAE,kIAAkI;aAChJ;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC;KAC3C;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAmB,EACnB,MAAuB;IAEvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,WAAW,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;gBACjD,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;gBACnD,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;aAC9C,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAyC,CAAC;YAC1H,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;SAEP,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU;UAClD,QAAQ,CAAC,MAAM;;;;iCAIQ,MAAM;6CACM;qBACpC,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC;QAEjD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;UAEJ,IAAI,CAAC,KAAK;UACV,IAAI,CAAC,MAAM;OACd,IAAI,CAAC,GAAG;cACD,QAAQ;;;;;kCAKY,IAAI,CAAC,KAAK;;;;;;qEAMyB;iBAC9D,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;EAEZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;;;iCAGzB,MAAM;;+BAER;iBACxB,CAAC;YACF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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,IAmCzC,CAAC;AAwEF,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,CAqGhF"}

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

@@ -0,0 +1,196 @@
+/**
+ * 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 → 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'],
+    },
+};
+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 formatFailedResult(job) {
+    return {
+        content: [{
+                type: 'text',
+                text: `❌ Job failed
+
+Job ID: ${job.id}
+Error: ${job.error || 'Unknown error'}`,
+            }],
+        isError: true,
+    };
+}
+function formatTimeoutResult(job) {
+    return {
+        content: [{
+                type: 'text',
+                text: `⏰ Job timed out
+
+Job ID: ${job.id}
+
+The tester did not complete the test in time.`,
+            }],
+        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 === 'failed') {
+            console.error(`[wait_for_result] Job already failed`);
+            return formatFailedResult(job);
+        }
+        if (job.status === 'timeout') {
+            console.error(`[wait_for_result] Job already timed out`);
+            return formatTimeoutResult(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 complete now
+            if (job.status === 'completed') {
+                console.error(`[wait_for_result] Job completed after ${elapsedSeconds}s`);
+                return formatCompletedResult(job);
+            }
+            if (job.status === 'failed') {
+                console.error(`[wait_for_result] Job failed after ${elapsedSeconds}s`);
+                return formatFailedResult(job);
+            }
+            if (job.status === 'timeout') {
+                console.error(`[wait_for_result] Job timed out after ${elapsedSeconds}s`);
+                return formatTimeoutResult(job);
+            }
+            console.error(`[wait_for_result] Job still ${job.status}, continuing to poll...`);
+        }
+        // Reached max wait time without completion
+        const statusEmoji = {
+            pending: '⏳',
+            claimed: '👤',
+            in_progress: '🔄',
+        };
+        const emoji = statusEmoji[job.status] || '📊';
+        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 (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,58 @@
+/**
+ * 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;
+}
+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;CACxC;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,62 +1,78 @@
-{
-  "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",
-  "type": "module",
-  "bin": {
-    "runhuman-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    ".env.example"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/index.ts",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build",
-    "test": "node test-simple.cjs",
-    "test:all": "node test-all-tools.cjs",
-    "test:routes": "node test-route-fix.cjs",
-    "test:endpoints": "node test-api-endpoints.cjs",
-    "test:ci": "npm run test:endpoints && npm run test:routes",
-    "test:inspector": "npx @modelcontextprotocol/inspector node dist/index.js"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "qa",
-    "testing",
-    "human-in-the-loop",
-    "ai-agent",
-    "claude",
-    "anthropic",
-    "qa-testing",
-    "manual-testing"
-  ],
-  "author": "RunHuman <hey@runhuman.com>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/yueranyuan/qa-experiment.git",
-    "directory": "packages/mcp-server"
-  },
-  "homepage": "https://runhuman.com",
-  "bugs": {
-    "url": "https://github.com/yueranyuan/qa-experiment/issues"
-  },
-  "license": "ISC",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "latest",
-    "dotenv": "^17.2.3"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.17",
-    "tsx": "^4.7.1",
-    "typescript": "^5.3.3"
-  }
-}
+{
+  "name": "@runhuman/mcp-server",
+  "version": "2.0.4",
+  "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"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "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",
+    "test:endpoints": "node test-api-endpoints.cjs",
+    "test:ci": "npm run test:endpoints && npm run test:routes",
+    "test:inspector": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "qa",
+    "testing",
+    "human-in-the-loop",
+    "ai-agent",
+    "claude",
+    "anthropic",
+    "qa-testing",
+    "manual-testing"
+  ],
+  "author": "RunHuman <hey@runhuman.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yueranyuan/qa-experiment.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://runhuman.com",
+  "bugs": {
+    "url": "https://github.com/yueranyuan/qa-experiment/issues"
+  },
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.17",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3"
+  }
+}