@frontmcp/testing 0.7.2 → 0.8.0

package/perf/types.d.ts

@@ -0,0 +1,439 @@
+/**
+ * @file types.ts
+ * @description Type definitions for performance testing framework
+ */
+/**
+ * Memory metrics captured via process.memoryUsage()
+ */
+export interface MemoryMetrics {
+    /** Used heap size in bytes */
+    heapUsed: number;
+    /** Total heap size in bytes */
+    heapTotal: number;
+    /** Memory used by C++ objects bound to JS objects */
+    external: number;
+    /** Resident set size (total memory allocated for the process) */
+    rss: number;
+    /** Memory used by ArrayBuffers and SharedArrayBuffers */
+    arrayBuffers: number;
+}
+/**
+ * CPU metrics captured via process.cpuUsage()
+ */
+export interface CpuMetrics {
+    /** User CPU time in microseconds */
+    user: number;
+    /** System CPU time in microseconds */
+    system: number;
+    /** Total CPU time (user + system) in microseconds */
+    total: number;
+}
+/**
+ * A point-in-time performance snapshot
+ */
+export interface PerfSnapshot {
+    /** Memory metrics at this point */
+    memory: MemoryMetrics;
+    /** CPU metrics since last measurement (or process start) */
+    cpu: CpuMetrics;
+    /** Timestamp when snapshot was taken */
+    timestamp: number;
+    /** Optional label for this snapshot */
+    label?: string;
+}
+/**
+ * A complete performance measurement with baseline and samples
+ */
+export interface PerfMeasurement {
+    /** Test name */
+    name: string;
+    /** Project/app name */
+    project: string;
+    /** Baseline snapshot (captured before test) */
+    baseline: PerfSnapshot;
+    /** All measurement snapshots during the test */
+    measurements: PerfSnapshot[];
+    /** Final snapshot (captured after test) */
+    final?: PerfSnapshot;
+    /** Timing information */
+    timing: {
+        /** Test start timestamp */
+        startTime: number;
+        /** Test end timestamp */
+        endTime: number;
+        /** Total duration in milliseconds */
+        durationMs: number;
+    };
+    /** Memory delta (final - baseline) */
+    memoryDelta?: {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+    };
+    /** Detected issues during this test */
+    issues: PerfIssue[];
+    /** Leak detection results (if checkLeak was called) */
+    leakDetectionResults?: LeakDetectionResult[];
+}
+/**
+ * A performance issue detected during testing
+ */
+export interface PerfIssue {
+    /** Issue type */
+    type: 'memory-leak' | 'threshold-exceeded' | 'regression' | 'warning';
+    /** Issue severity */
+    severity: 'error' | 'warning';
+    /** Human-readable message */
+    message: string;
+    /** Metric that triggered the issue */
+    metric?: string;
+    /** Actual value that triggered the issue */
+    actual?: number;
+    /** Expected/threshold value */
+    expected?: number;
+}
+/**
+ * Thresholds for performance assertions
+ */
+export interface PerfThresholds {
+    /** Maximum heap delta in bytes (final - baseline) */
+    maxHeapDelta?: number;
+    /** Maximum test duration in milliseconds */
+    maxDurationMs?: number;
+    /** Maximum CPU time in microseconds */
+    maxCpuTime?: number;
+    /** Maximum RSS delta in bytes */
+    maxRssDelta?: number;
+}
+/**
+ * Options for memory leak detection
+ */
+export interface LeakDetectionOptions {
+    /** Number of iterations to run */
+    iterations?: number;
+    /** Memory growth threshold in bytes to consider a leak */
+    threshold?: number;
+    /** Warmup iterations (not counted) */
+    warmupIterations?: number;
+    /** Force GC between iterations */
+    forceGc?: boolean;
+    /** Delay between iterations in ms */
+    delayMs?: number;
+    /** Interval size for tracking memory growth (e.g., 10 means track 0-10, 10-20, etc.) */
+    intervalSize?: number;
+}
+/**
+ * Per-worker statistics in parallel leak detection
+ */
+export interface WorkerStats {
+    /** Worker index (0-based) */
+    workerId: number;
+    /** Requests per second for this worker */
+    requestsPerSecond: number;
+    /** Memory samples collected by this worker */
+    samples: number[];
+    /** Duration in milliseconds for this worker */
+    durationMs: number;
+    /** Number of iterations completed */
+    iterationsCompleted: number;
+}
+/**
+ * Client interface for parallel leak detection (minimal interface)
+ */
+export interface ParallelTestClient {
+    tools: {
+        call: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+        list: () => Promise<unknown>;
+    };
+    resources: {
+        read: (uri: string) => Promise<unknown>;
+    };
+    disconnect?: () => Promise<void>;
+}
+/**
+ * Options for parallel memory leak detection using multiple clients
+ */
+export interface ParallelLeakDetectionOptions extends LeakDetectionOptions {
+    /** Number of parallel worker clients (default: 5) */
+    workers?: number;
+    /** Factory to create a new client for each worker (required for true parallelism) */
+    clientFactory?: () => Promise<ParallelTestClient>;
+}
+/**
+ * Result of parallel leak detection analysis
+ */
+export interface ParallelLeakDetectionResult extends LeakDetectionResult {
+    /** Number of workers used */
+    workersUsed: number;
+    /** Combined throughput across all workers (req/s) */
+    totalRequestsPerSecond: number;
+    /** Per-worker statistics */
+    perWorkerStats: WorkerStats[];
+    /** Total iterations across all workers */
+    totalIterations: number;
+}
+/**
+ * Memory measurement at a specific interval
+ */
+export interface IntervalMeasurement {
+    /** Start iteration of this interval */
+    startIteration: number;
+    /** End iteration of this interval */
+    endIteration: number;
+    /** Heap used at start of interval (bytes) */
+    heapAtStart: number;
+    /** Heap used at end of interval (bytes) */
+    heapAtEnd: number;
+    /** Memory delta for this interval (bytes) */
+    delta: number;
+    /** Formatted delta string */
+    deltaFormatted: string;
+    /** Growth rate per iteration in this interval */
+    growthRatePerIteration: number;
+}
+/**
+ * Graph data point for visualization
+ */
+export interface MemoryGraphPoint {
+    /** Iteration number */
+    iteration: number;
+    /** Heap used at this iteration (bytes) */
+    heapUsed: number;
+    /** Heap used formatted */
+    heapUsedFormatted: string;
+    /** Cumulative delta from start (bytes) */
+    cumulativeDelta: number;
+    /** Cumulative delta formatted */
+    cumulativeDeltaFormatted: string;
+}
+/**
+ * Result of leak detection analysis
+ */
+export interface LeakDetectionResult {
+    /** Whether a memory leak was detected */
+    hasLeak: boolean;
+    /** Estimated leak size in bytes per iteration */
+    leakSizePerIteration: number;
+    /** Total memory growth during test */
+    totalGrowth: number;
+    /** Growth rate (bytes per iteration) */
+    growthRate: number;
+    /** Linear regression R² value (1.0 = perfect linear growth) */
+    rSquared: number;
+    /** All heap measurements */
+    samples: number[];
+    /** Summary message */
+    message: string;
+    /** Interval-based measurements for detailed analysis */
+    intervals?: IntervalMeasurement[];
+    /** Graph data points for visualization */
+    graphData?: MemoryGraphPoint[];
+    /** Total duration of the leak detection test in milliseconds */
+    durationMs?: number;
+    /** Requests per second (iterations / duration in seconds) */
+    requestsPerSecond?: number;
+}
+/**
+ * Baseline statistics for a metric
+ */
+export interface MetricBaseline {
+    /** Mean value */
+    mean: number;
+    /** Standard deviation */
+    stdDev: number;
+    /** Minimum observed value */
+    min: number;
+    /** Maximum observed value */
+    max: number;
+    /** 95th percentile */
+    p95: number;
+    /** Number of samples */
+    sampleCount: number;
+}
+/**
+ * Baseline data for a single test
+ */
+export interface TestBaseline {
+    /** Test identifier */
+    testId: string;
+    /** Project name */
+    project: string;
+    /** Heap used baseline */
+    heapUsed: MetricBaseline;
+    /** Duration baseline */
+    durationMs: MetricBaseline;
+    /** CPU time baseline */
+    cpuTime: MetricBaseline;
+    /** When baseline was created */
+    createdAt: string;
+    /** Git commit hash */
+    commitHash?: string;
+}
+/**
+ * Complete baseline storage format
+ */
+export interface PerfBaseline {
+    /** Release/version tag */
+    release: string;
+    /** When baselines were generated */
+    timestamp: string;
+    /** Git commit hash */
+    commitHash?: string;
+    /** All test baselines */
+    tests: Record<string, TestBaseline>;
+}
+/**
+ * Configuration for regression detection
+ */
+export interface RegressionConfig {
+    /** Warning threshold as percentage (default: 10) */
+    warningThresholdPercent?: number;
+    /** Error threshold as percentage (default: 25) */
+    errorThresholdPercent?: number;
+    /** Minimum absolute change to report (avoids noise on small values) */
+    minAbsoluteChange?: number;
+}
+/**
+ * Result of regression analysis for a single metric
+ */
+export interface MetricRegression {
+    /** Metric name */
+    metric: string;
+    /** Baseline value */
+    baseline: number;
+    /** Current value */
+    current: number;
+    /** Change percentage */
+    changePercent: number;
+    /** Absolute change */
+    absoluteChange: number;
+    /** Regression status */
+    status: 'ok' | 'warning' | 'regression';
+}
+/**
+ * Complete regression analysis result
+ */
+export interface RegressionResult {
+    /** Test identifier */
+    testId: string;
+    /** Overall status */
+    status: 'ok' | 'warning' | 'regression';
+    /** Individual metric regressions */
+    metrics: MetricRegression[];
+    /** Summary message */
+    message: string;
+}
+/**
+ * Summary statistics for a test run
+ */
+export interface PerfTestSummary {
+    /** Total tests run */
+    totalTests: number;
+    /** Tests that passed */
+    passedTests: number;
+    /** Tests with warnings */
+    warningTests: number;
+    /** Tests that failed */
+    failedTests: number;
+    /** Tests with detected memory leaks */
+    leakTests: number;
+}
+/**
+ * Per-project summary
+ */
+export interface ProjectSummary {
+    /** Project name */
+    project: string;
+    /** Summary statistics */
+    summary: PerfTestSummary;
+    /** All measurements for this project */
+    measurements: PerfMeasurement[];
+    /** Regression results (if baseline available) */
+    regressions?: RegressionResult[];
+}
+/**
+ * Complete performance report
+ */
+export interface PerfReport {
+    /** Report generation timestamp */
+    timestamp: string;
+    /** Git commit hash */
+    commitHash?: string;
+    /** Git branch name */
+    branch?: string;
+    /** Overall summary */
+    summary: PerfTestSummary;
+    /** Per-project breakdowns */
+    projects: ProjectSummary[];
+    /** Baseline used for comparison (if any) */
+    baseline?: {
+        release: string;
+        timestamp: string;
+    };
+}
+/**
+ * Performance fixture available in perfTest functions
+ */
+export interface PerfFixtures {
+    /** Capture baseline snapshot */
+    baseline(): Promise<PerfSnapshot>;
+    /** Capture a measurement snapshot */
+    measure(label?: string): PerfSnapshot;
+    /** Run leak detection on an operation */
+    checkLeak(operation: () => Promise<void>, options?: LeakDetectionOptions): Promise<LeakDetectionResult>;
+    /**
+     * Run parallel leak detection using multiple clients.
+     * This achieves higher throughput by running N workers concurrently.
+     *
+     * @param operationFactory - Factory that receives a client and worker index, returns an operation function
+     * @param options - Detection options including worker count and client factory
+     * @returns Parallel leak detection result with combined throughput metrics
+     *
+     * @example
+     * ```typescript
+     * const result = await perf.checkLeakParallel(
+     *   (client, workerId) => async () => {
+     *     await client.tools.call('my-tool', { key: `worker-${workerId}` });
+     *   },
+     *   {
+     *     iterations: 1000,
+     *     workers: 5,
+     *     clientFactory: () => server.createClient(),
+     *   }
+     * );
+     * expect(result.totalRequestsPerSecond).toBeGreaterThan(300);
+     * ```
+     */
+    checkLeakParallel(operationFactory: (client: ParallelTestClient, workerId: number) => () => Promise<void>, options: ParallelLeakDetectionOptions & {
+        clientFactory: () => Promise<ParallelTestClient>;
+    }): Promise<ParallelLeakDetectionResult>;
+    /** Assert performance thresholds */
+    assertThresholds(thresholds: PerfThresholds): void;
+    /** Get all measurements so far */
+    getMeasurements(): PerfSnapshot[];
+    /** Get the current test name */
+    getTestName(): string;
+}
+/**
+ * Extended test fixtures including performance
+ */
+export interface PerfTestFixtures {
+    /** Performance fixture */
+    perf: PerfFixtures;
+}
+/**
+ * Performance test configuration
+ */
+export interface PerfTestConfig {
+    /** Server entry file path */
+    server?: string;
+    /** Project name */
+    project?: string;
+    /** Enable public mode */
+    publicMode?: boolean;
+    /** Default thresholds for all tests */
+    defaultThresholds?: PerfThresholds;
+    /** Force GC before baseline */
+    forceGcOnBaseline?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/perf/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/perf/types.ts"],"names":[],"mappings":"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"}

package/platform/platform-client-info.d.ts

@@ -74,11 +74,29 @@ export interface ExperimentalCapabilities {
     [MCP_APPS_EXTENSION_KEY]?: McpAppsExtension;
     [key: string]: unknown;
 }
+/**
+ * Form elicitation capability options.
+ */
+export interface FormElicitationCapability {
+    /** Whether to apply default values from the schema */
+    applyDefaults?: boolean;
+}
+/**
+ * Elicitation capabilities for interactive user input.
+ * Note: MCP SDK expects form/url to be objects, not booleans.
+ */
+export interface ElicitationCapabilities {
+    /** Support for form-based elicitation - use empty object {} to enable */
+    form?: FormElicitationCapability | Record<string, unknown>;
+    /** Support for URL-based elicitation - use empty object {} to enable */
+    url?: Record<string, unknown>;
+}
 /**
  * Client capabilities sent during MCP initialization.
  */
 export interface TestClientCapabilities {
     sampling?: Record<string, unknown>;
+    elicitation?: ElicitationCapabilities;
     experimental?: ExperimentalCapabilities;
 }
 /**

package/platform/platform-client-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-client-info.d.ts","sourceRoot":"","sources":["../../src/platform/platform-client-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,4BAAqC,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAiDhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAUxE,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,wBAAwB,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB,CAkB1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAE/E"}
+{"version":3,"file":"platform-client-info.d.ts","sourceRoot":"","sources":["../../src/platform/platform-client-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,4BAAqC,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAiDhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAUxE,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,YAAY,CAAC,EAAE,wBAAwB,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB,CAuB1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAE/E"}

package/server/index.d.ts

@@ -4,4 +4,6 @@
  */
 export { TestServer } from './test-server';
 export type { TestServerOptions, TestServerInfo } from './test-server';
+export { reservePort, getProjectPort, getProjectPorts, getPortRange, releaseAllPorts, getReservedPorts, findAvailablePort, E2E_PORT_RANGES, } from './port-registry';
+export type { E2EProject } from './port-registry';
 //# sourceMappingURL=index.d.ts.map

package/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/server/port-registry.d.ts

@@ -0,0 +1,179 @@
+/**
+ * @file port-registry.ts
+ * @description Centralized port management for E2E tests to prevent port conflicts
+ *
+ * This module provides:
+ * 1. Dedicated port ranges for each E2E test project
+ * 2. Port reservation with proper locking
+ * 3. Verification that ports are actually available before assignment
+ */
+/**
+ * Port range configuration for E2E test projects.
+ * Each project gets a dedicated range of 10 ports to support multiple servers.
+ *
+ * Base port: 50000 (well above common services)
+ * Range size: 10 ports per project
+ */
+export declare const E2E_PORT_RANGES: {
+    readonly 'demo-e2e-public': {
+        readonly start: 50000;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-cache': {
+        readonly start: 50010;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-config': {
+        readonly start: 50020;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-direct': {
+        readonly start: 50030;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-errors': {
+        readonly start: 50040;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-hooks': {
+        readonly start: 50050;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-multiapp': {
+        readonly start: 50060;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-notifications': {
+        readonly start: 50070;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-providers': {
+        readonly start: 50080;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-standalone': {
+        readonly start: 50090;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-orchestrated': {
+        readonly start: 50100;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-transparent': {
+        readonly start: 50110;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-cimd': {
+        readonly start: 50120;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-skills': {
+        readonly start: 50200;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-remote': {
+        readonly start: 50210;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-openapi': {
+        readonly start: 50220;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-ui': {
+        readonly start: 50230;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-codecall': {
+        readonly start: 50240;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-remember': {
+        readonly start: 50250;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-elicitation': {
+        readonly start: 50260;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-agents': {
+        readonly start: 50270;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-transport-recreation': {
+        readonly start: 50280;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-redis': {
+        readonly start: 50300;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-serverless': {
+        readonly start: 50310;
+        readonly size: 10;
+    };
+    readonly 'mock-oauth': {
+        readonly start: 50900;
+        readonly size: 10;
+    };
+    readonly 'mock-api': {
+        readonly start: 50910;
+        readonly size: 10;
+    };
+    readonly 'mock-cimd': {
+        readonly start: 50920;
+        readonly size: 10;
+    };
+    readonly default: {
+        readonly start: 51000;
+        readonly size: 100;
+    };
+};
+export type E2EProject = keyof typeof E2E_PORT_RANGES;
+/**
+ * Get the port range for a project
+ */
+export declare function getPortRange(project: string): {
+    start: number;
+    size: number;
+};
+/**
+ * Reserve a port for a project.
+ * Returns a port number and a release function.
+ *
+ * The port is held by a temporary server until released, preventing race conditions.
+ *
+ * @param project - E2E project name (used to determine port range)
+ * @param preferredPort - Optional specific port to use
+ * @returns Object with port number and release function
+ */
+export declare function reservePort(project: string, preferredPort?: number): Promise<{
+    port: number;
+    release: () => Promise<void>;
+}>;
+/**
+ * Get the primary port for a project (first port in its range)
+ */
+export declare function getProjectPort(project: string): number;
+/**
+ * Get all ports for a project (for multi-server scenarios)
+ */
+export declare function getProjectPorts(project: string, count: number): number[];
+/**
+ * Release all reserved ports (for cleanup in afterAll)
+ */
+export declare function releaseAllPorts(): Promise<void>;
+/**
+ * Get information about currently reserved ports (for debugging)
+ */
+export declare function getReservedPorts(): Array<{
+    port: number;
+    project: string;
+    reservedAt: number;
+}>;
+/**
+ * Find an available port (legacy compatibility function)
+ *
+ * @deprecated Use reservePort() for better port management
+ */
+export declare function findAvailablePort(): Promise<number>;
+//# sourceMappingURL=port-registry.d.ts.map

package/server/port-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/server/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwClB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAC;AAuBtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM7E;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAiEzD;AAgFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/F;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAKzD"}