@postman/postman-mcp-server 2.4.2 → 2.5.1

package/dist/src/tools/putCollection.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-function asMcpError(error) {
-    const cause = error?.cause ?? String(error);
-    return new McpError(ErrorCode.InternalError, cause);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'putCollection';
 export const description = "Replaces the contents of a collection using the [Postman Collection v2.1.0 schema format](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). Include the collection's ID values in the request body. If you do not, the endpoint removes the existing items and creates new items.\n\nTo perform an update asynchronously, use the \\`Prefer\\` header with the \\`respond-async\\` value. When performing an async update, this endpoint returns a HTTP \\`202 Accepted\\` response.\n\n**Note:**\n\n- The maximum collection size this endpoint accepts cannot exceed 100 MB.\n- If you don't include the collection items' ID values from the request body, the endpoint **removes** the existing items and recreates the items with new ID values.\n- To copy another collection's contents to the given collection, remove all ID values before you pass it in this endpoint. If you do not, this endpoint returns an error. These values include the \\`id\\`, \\`uid\\`, and \\`postman_id\\` values.\n- For protocol profile behavior, refer to Postman's [Protocol Profile Behavior documentation](https://github.com/postmanlabs/postman-runtime/blob/develop/docs/protocol-profile-behavior.md).\n";
 export const parameters = z.object({
@@ -164,7 +160,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -180,7 +176,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -196,7 +192,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -212,7 +208,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -228,7 +224,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -244,7 +240,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -260,7 +256,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -276,7 +272,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -292,7 +288,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -308,7 +304,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -324,7 +320,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -340,7 +336,7 @@ export const parameters = z.object({
                         .object({
                         key: z.string().describe("The auth method's key value."),
                         value: z
-                            .union([z.string(), z.array(z.record(z.any()))])
+                            .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                             .describe("The key's value.")
                             .optional(),
                         type: z
@@ -399,7 +395,7 @@ export const parameters = z.object({
                         .describe('A list of x-www-form-encoded key/value pairs.')
                         .optional(),
                     formdata: z
-                        .array(z.record(z.any()).and(z.union([
+                        .array(z.record(z.string(), z.unknown()).and(z.union([
                         z.object({
                             key: z.string().describe('The key value.').optional(),
                             value: z.string().describe("The key's value.").optional(),
@@ -417,7 +413,7 @@ export const parameters = z.object({
                         z.object({
                             key: z.string().describe('The key value.').optional(),
                             src: z
-                                .any()
+                                .unknown()
                                 .superRefine((x, ctx) => {
                                 const schemas = [z.string().nullable(), z.array(z.string())];
                                 const errors = schemas.reduce((errors, schema) => ((result) => result.error ? [...errors, result.error] : errors)(schema.safeParse(x)), []);
@@ -467,7 +463,7 @@ export const parameters = z.object({
                         .describe('If the `mode` value is `graphql`, an object containing the GraphQL request information.')
                         .optional(),
                     options: z
-                        .record(z.any())
+                        .record(z.string(), z.unknown())
                         .describe('Additional configurations and options set for various modes.')
                         .optional(),
                 })
@@ -476,6 +472,10 @@ export const parameters = z.object({
             })
                 .describe('Information about the collection request.')
                 .optional(),
+            response: z
+                .array(z.unknown().describe("Information about the request's response."))
+                .describe("A list of the collection's responses.")
+                .optional(),
             protocolProfileBehavior: z
                 .object({
                 strictSSL: z
@@ -617,7 +617,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -633,7 +633,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -649,7 +649,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -665,7 +665,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -681,7 +681,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -697,7 +697,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -713,7 +713,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -729,7 +729,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -745,7 +745,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -761,7 +761,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -777,7 +777,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -793,7 +793,7 @@ export const parameters = z.object({
                 .object({
                 key: z.string().describe("The auth method's key value."),
                 value: z
-                    .union([z.string(), z.array(z.record(z.any()))])
+                    .union([z.string(), z.array(z.record(z.string(), z.unknown()))])
                     .describe("The key's value.")
                     .optional(),
                 type: z
@@ -882,14 +882,14 @@ export const annotations = {
     destructiveHint: false,
     idempotentHint: true,
 };
-export async function handler(params, extra) {
+export async function handler(args, extra) {
     try {
-        const endpoint = `/collections/${params.collectionId}`;
+        const endpoint = `/collections/${args.collectionId}`;
         const query = new URLSearchParams();
         const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint;
         const bodyPayload = {};
-        if (params.collection !== undefined)
-            bodyPayload.collection = params.collection;
+        if (args.collection !== undefined)
+            bodyPayload.collection = args.collection;
         const options = {
             body: JSON.stringify(bodyPayload),
             contentType: ContentType.Json,

package/dist/src/tools/putEnvironment.js

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 import { ContentType } from '../clients/postman.js';
-import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
-function asMcpError(error) {
-    const cause = error?.cause ?? String(error);
-    return new McpError(ErrorCode.InternalError, cause);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'putEnvironment';
 export const description = 'Replaces all the contents of an environment with the given information.\n\n**Note:**\n\n- The request body size cannot exceed the maximum allowed size of 30MB.\n- If you receive an HTTP \\`411 Length Required\\` error response, manually pass the \\`Content-Length\\` header and its value in the request header.\n';
 export const parameters = z.object({

package/dist/src/tools/resolveCommentThread.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
-function asMcpError(error) {
-    const cause = error?.cause ?? String(error);
-    return new McpError(ErrorCode.InternalError, cause);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'resolveCommentThread';
 export const description = 'Resolves a comment and any associated replies. On success, this returns an HTTP \\`204 No Content\\` response.\n\nComment thread IDs return in the GET comments response for [APIs](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-2103ea20-f7de-4628-90e6-b823b3084a52), [collections](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-a6582e0a-9382-4760-8b91-53a8aa6cb8d7), and [collection items](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-efeda219-66e1-474c-a83b-253d15723bf7).\n';
 export const parameters = z.object({

package/dist/src/tools/runCollection.js

@@ -1,11 +1,6 @@
 import { z } from 'zod';
-import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
-import newman from 'newman';
-import { TestTracker, OutputBuilder, buildNewmanOptions } from './utils/runner.js';
-function asMcpError(error) {
-    const cause = error?.cause ?? String(error);
-    return new McpError(ErrorCode.InternalError, cause);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
+import { runCollection } from './runner/index.js';
 export const method = 'runCollection';
 export const description = 'Runs a Postman collection by ID with detailed test results and execution statistics. Supports optional environment for variable substitution. Note: Advanced parameters like custom delays and other runtime options are not yet available.';
 export const parameters = z.object({
@@ -41,85 +36,12 @@ export const annotations = {
 };
 export async function handler(params, extra) {
     try {
-        const tracker = new TestTracker();
-        const output = new OutputBuilder();
-        output.add(`🚀 Fetching collection with ID: ${params.collectionId}`);
-        const response = await extra.client.get(`/collections/${params.collectionId}`);
-        const collectionJSON = response.collection || response;
-        output.add(`✅ Successfully fetched collection: ${collectionJSON.info?.name || 'Unknown'}\n`);
-        let environmentJSON;
-        if (params.environmentId) {
-            output.add(`🌍 Fetching environment with ID: ${params.environmentId}`);
-            const envResponse = await extra.client.get(`/environments/${params.environmentId}`);
-            environmentJSON = envResponse.environment || envResponse;
-            output.add(`✅ Successfully fetched environment: ${environmentJSON.name || 'Unknown'}\n`);
-        }
-        const newmanOptions = buildNewmanOptions(params, collectionJSON, environmentJSON);
-        const startTime = Date.now();
-        await new Promise((resolve, reject) => {
-            newman
-                .run(newmanOptions)
-                .on('start', () => {
-                output.add('🎯 Starting collection run...\n');
-            })
-                .on('assertion', (_err, args) => {
-                if (args.assertion) {
-                    tracker.addAssertion({
-                        passed: !args.error,
-                        assertion: args.assertion,
-                        name: args.assertion,
-                        error: args.error,
-                    });
-                }
-            })
-                .on('item', (_err, args) => {
-                if (args.item) {
-                    const testResults = tracker.displayCurrentResults();
-                    if (testResults) {
-                        output.add(`\n📝 Request: ${args.item.name}`);
-                        output.add(testResults);
-                    }
-                }
-            })
-                .on('done', (err, summary) => {
-                const endTime = Date.now();
-                const durationMs = endTime - startTime;
-                const durationSec = (durationMs / 1000).toFixed(2);
-                if (err) {
-                    output.add('\n❌ Run error: ' + err.message);
-                    output.add(`⏱️  Duration: ${durationSec}s`);
-                    reject(err);
-                    return;
-                }
-                output.add('\n=== ✅ Run completed! ===');
-                output.add(`⏱️  Duration: ${durationSec}s`);
-                const testStats = tracker.getTotalStats();
-                if (testStats.total > 0) {
-                    output.add('\n📊 Overall Test Statistics:');
-                    output.add(`  Total tests: ${testStats.total}`);
-                    output.add(`  Passed: ${testStats.passed} ✅`);
-                    output.add(`  Failed: ${testStats.failed} ❌`);
-                    output.add(`  Success rate: ${((testStats.passed / testStats.total) * 100).toFixed(1)}%`);
-                }
-                if (summary?.run?.stats) {
-                    output.add('\n📈 Request Summary:');
-                    output.add(`  Total requests: ${summary.run.stats.requests?.total || 0}`);
-                    output.add(`  Failed requests: ${summary.run.stats.requests?.failed || 0}`);
-                    output.add(`  Total assertions: ${summary.run.stats.assertions?.total || 0}`);
-                    output.add(`  Failed assertions: ${summary.run.stats.assertions?.failed || 0}`);
-                    if (summary.run.stats.iterations) {
-                        output.add(`  Total iterations: ${summary.run.stats.iterations.total || 0}`);
-                        output.add(`  Failed iterations: ${summary.run.stats.iterations.failed || 0}`);
-                    }
-                }
-                resolve();
-            });
-        });
+        const output = await runCollection(params, extra.client);
         return {
             content: [
                 {
                     type: 'text',
-                    text: output.build(),
+                    text: output,
                 },
             ],
         };

package/dist/src/tools/runMonitor.js

@@ -1,9 +1,5 @@
 import { z } from 'zod';
-import { McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
-function asMcpError(error) {
-    const cause = error?.cause ?? String(error);
-    return new McpError(ErrorCode.InternalError, cause);
-}
+import { asMcpError, McpError } from './utils/toolHelpers.js';
 export const method = 'runMonitor';
 export const description = "Runs a monitor and returns its run results.\n\n**Note:**\n\n- If you pass the \\`async=true\\` query parameter, the response does not return the \\`stats\\`, \\`executions\\`, and \\`failures\\` responses. To get this information for an asynchronous run, call the GET \\`/monitors/{id}\\` endpoint.\n- If the call exceeds 300 seconds, the endpoint returns an HTTP \\`202 Accepted\\` response. Use the GET \\`/monitors/{id}\\` endpoint to check the run's status in the response's \\`lastRun\\` property. To avoid this, it is recommended that you include the \\`async=true\\` query parameter when using this endpoint.\n";
 export const parameters = z.object({

package/dist/src/tools/runner/executor.js

@@ -0,0 +1,165 @@
+import newman from 'newman';
+export class OutputBuilder {
+    lines = [];
+    add(line) {
+        this.lines.push(line);
+    }
+    build() {
+        return this.lines.join('\n');
+    }
+}
+export class TestTracker {
+    assertions = [];
+    totalTests = 0;
+    totalPassed = 0;
+    totalFailed = 0;
+    addAssertion(assertion) {
+        this.assertions.push(assertion);
+        this.totalTests++;
+        if (assertion.passed) {
+            this.totalPassed++;
+        }
+        else {
+            this.totalFailed++;
+        }
+    }
+    displayCurrentResults() {
+        if (this.assertions.length === 0) {
+            return '';
+        }
+        const lines = ['  📊 Test Results:'];
+        this.assertions.forEach((assertion) => {
+            const status = assertion.passed ? '✓' : '✗';
+            const name = assertion.assertion || assertion.name || 'Unnamed test';
+            lines.push(`    ${status} ${name}`);
+            if (!assertion.passed && assertion.error) {
+                const errorMessage = typeof assertion.error === 'string'
+                    ? assertion.error
+                    : assertion.error.message || 'Unknown error';
+                lines.push(`       └─ Error: ${errorMessage}`);
+            }
+        });
+        const passed = this.assertions.filter((a) => a.passed).length;
+        const failed = this.assertions.filter((a) => !a.passed).length;
+        lines.push(`    ────────────────────────────────────────`);
+        lines.push(`    ${this.assertions.length} tests | ✓ ${passed} passed | ✗ ${failed} failed\n`);
+        this.assertions.length = 0;
+        return lines.join('\n');
+    }
+    getTotalStats() {
+        return {
+            total: this.totalTests,
+            passed: this.totalPassed,
+            failed: this.totalFailed,
+        };
+    }
+    reset() {
+        this.assertions.length = 0;
+        this.totalTests = 0;
+        this.totalPassed = 0;
+        this.totalFailed = 0;
+    }
+}
+export function buildNewmanOptions(params, collection, environment) {
+    return {
+        collection: collection,
+        environment: environment,
+        iterationCount: params.iterationCount || 1,
+        timeout: params.requestTimeout || 60000,
+        timeoutRequest: params.requestTimeout || 60000,
+        timeoutScript: params.scriptTimeout || 5000,
+        delayRequest: 1000,
+        ignoreRedirects: false,
+        insecure: false,
+        bail: params.stopOnFailure ? ['failure'] : false,
+        suppressExitCode: true,
+        reporters: [],
+        reporter: {},
+        color: 'off',
+        verbose: false,
+        requestAgents: {
+            http: undefined,
+            https: undefined,
+        },
+    };
+}
+export async function executeCollection(context) {
+    const tracker = new TestTracker();
+    const output = new OutputBuilder();
+    output.add(`🚀 Starting collection: ${context.collection.name}`);
+    if (context.environment) {
+        output.add(`🌍 Using environment: ${context.environment.name}\n`);
+    }
+    const newmanOptions = buildNewmanOptions(context.params, context.collection.json, context.environment?.json);
+    const startTime = Date.now();
+    const summary = await runNewman(newmanOptions, tracker, output);
+    const endTime = Date.now();
+    const durationMs = endTime - startTime;
+    return {
+        output: output.build(),
+        testStats: tracker.getTotalStats(),
+        summary,
+        startTime,
+        endTime,
+        durationMs,
+    };
+}
+function runNewman(options, tracker, output) {
+    return new Promise((resolve, reject) => {
+        newman
+            .run(options)
+            .on('start', () => {
+            output.add('🎯 Starting collection run...\n');
+        })
+            .on('assertion', (_err, args) => {
+            if (args.assertion) {
+                tracker.addAssertion({
+                    passed: !args.error,
+                    assertion: args.assertion,
+                    name: args.assertion,
+                    error: args.error,
+                });
+            }
+        })
+            .on('item', (_err, args) => {
+            if (args.item) {
+                const testResults = tracker.displayCurrentResults();
+                if (testResults) {
+                    output.add(`\n📝 Request: ${args.item.name}`);
+                    output.add(testResults);
+                }
+            }
+        })
+            .on('done', (err, summary) => {
+            if (err) {
+                output.add('\n❌ Run error: ' + err.message);
+                reject(err);
+                return;
+            }
+            output.add('\n=== ✅ Run completed! ===');
+            appendSummaryToOutput(output, tracker, summary);
+            resolve(summary);
+        });
+    });
+}
+function appendSummaryToOutput(output, tracker, summary) {
+    const testStats = tracker.getTotalStats();
+    if (testStats.total > 0) {
+        output.add('\n📊 Overall Test Statistics:');
+        output.add(`  Total tests: ${testStats.total}`);
+        output.add(`  Passed: ${testStats.passed} ✅`);
+        output.add(`  Failed: ${testStats.failed} ❌`);
+        output.add(`  Success rate: ${((testStats.passed / testStats.total) * 100).toFixed(1)}%`);
+    }
+    if (summary?.run?.stats) {
+        output.add('\n📈 Request Summary:');
+        output.add(`  Total requests: ${summary.run.stats.requests?.total || 0}`);
+        output.add(`  Failed requests: ${summary.run.stats.requests?.failed || 0}`);
+        output.add(`  Total assertions: ${summary.run.stats.assertions?.total || 0}`);
+        output.add(`  Failed assertions: ${summary.run.stats.assertions?.failed || 0}`);
+        if (summary.run.stats.iterations) {
+            output.add(`  Total iterations: ${summary.run.stats.iterations.total || 0}`);
+            output.add(`  Failed iterations: ${summary.run.stats.iterations.failed || 0}`);
+        }
+    }
+}

package/dist/src/tools/runner/fetchers.js

@@ -0,0 +1,33 @@
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+export async function fetchCollection(collectionId, client) {
+    try {
+        const response = await client.get(`/collections/${collectionId}`);
+        const collectionJSON = response.collection || response;
+        return {
+            json: collectionJSON,
+            name: collectionJSON.info?.name || 'Unknown',
+            id: collectionId,
+        };
+    }
+    catch (error) {
+        throw new McpError(ErrorCode.InternalError, `Failed to fetch collection: ${collectionId}`, {
+            cause: error,
+        });
+    }
+}
+export async function fetchEnvironment(environmentId, client) {
+    try {
+        const response = await client.get(`/environments/${environmentId}`);
+        const environmentJSON = response.environment || response;
+        return {
+            json: environmentJSON,
+            name: environmentJSON.name || 'Unknown',
+            id: environmentId,
+        };
+    }
+    catch (error) {
+        throw new McpError(ErrorCode.InternalError, `Failed to fetch environment: ${environmentId}`, {
+            cause: error,
+        });
+    }
+}

package/dist/src/tools/runner/index.js

@@ -0,0 +1,20 @@
+import { fetchCollection, fetchEnvironment } from './fetchers.js';
+import { executeCollection } from './executor.js';
+import { parseToTelemetry, formatUserOutput } from './parsers.js';
+import { reportTelemetryAsync } from './telemetry.js';
+export async function runCollection(params, client) {
+    const collection = await fetchCollection(params.collectionId, client);
+    let environment;
+    if (params.environmentId) {
+        environment = await fetchEnvironment(params.environmentId, client);
+    }
+    const result = await executeCollection({
+        collection,
+        environment,
+        params,
+    });
+    const telemetryPayload = parseToTelemetry(result, params.collectionId, collection.name);
+    const userOutput = formatUserOutput(result);
+    reportTelemetryAsync(telemetryPayload, client);
+    return userOutput;
+}

package/dist/src/tools/runner/models.js

@@ -0,0 +1 @@
+export {};

package/dist/src/tools/runner/parsers.js

@@ -0,0 +1,8 @@
+import { buildTelemetryPayload } from './telemetry.js';
+export function parseToTelemetry(result, collectionId, collectionName) {
+    return buildTelemetryPayload(collectionId, collectionName, result);
+}
+export function formatUserOutput(result) {
+    const durationSec = (result.durationMs / 1000).toFixed(2);
+    return `${result.output}\n⏱️  Duration: ${durationSec}s`;
+}