@frontmcp/testing 1.0.3 → 1.1.0-beta.1

package/containers/redis-container.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Redis Test Container
+ *
+ * Starts a Redis container via testcontainers for distributed E2E tests.
+ * Skips when Docker is not available or SKIP_REDIS_TESTS=1 is set.
+ */
+export interface RedisContainerInfo {
+    /** Redis host (usually localhost) */
+    host: string;
+    /** Mapped Redis port */
+    port: number;
+    /** Full Redis URL: redis://host:port */
+    url: string;
+    /** Stop the container */
+    stop: () => Promise<void>;
+}
+/**
+ * Start a Redis container for testing.
+ *
+ * @returns Container info with host, port, url, and stop function
+ * @throws When Docker is not available
+ */
+export declare function startRedisContainer(): Promise<RedisContainerInfo>;
+/**
+ * Check if distributed tests should be skipped.
+ * Returns true if SKIP_REDIS_TESTS=1 or SKIP_DISTRIBUTED_TESTS=1.
+ */
+export declare function shouldSkipDistributedTests(): boolean;
+//# sourceMappingURL=redis-container.d.ts.map

package/containers/redis-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-container.d.ts","sourceRoot":"","sources":["../../src/containers/redis-container.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAKD;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAiBvE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/esm/fixtures/index.mjs

@@ -2303,11 +2303,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },

package/esm/index.mjs

@@ -3910,11 +3910,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },
@@ -6309,7 +6311,7 @@ var UIAssertions = {
 };
 
 // libs/testing/src/example-tools/tool-configs.ts
-import { z } from "zod";
+import { z } from "@frontmcp/lazy-zod";
 var basicUIToolInputSchema = z.object({
   name: z.string().optional().default("World")
 });

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/testing",
-  "version": "1.0.3",
+  "version": "1.1.0-beta.1",
   "description": "E2E testing framework for FrontMCP servers - MCP client, auth mocks, Playwright integration",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -87,11 +87,12 @@
     "./esm": null
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "1.0.3",
-    "@frontmcp/ui": "1.0.3",
+    "@frontmcp/sdk": "1.1.0-beta.1",
+    "@frontmcp/ui": "1.1.0-beta.1",
     "@playwright/test": "^1.40.0",
     "jest": "^29.0.0 || ^30.0.0",
-    "@jest/globals": "^29.0.0 || ^30.0.0"
+    "@jest/globals": "^29.0.0 || ^30.0.0",
+    "@frontmcp/lazy-zod": "1.1.0-beta.1"
   },
   "peerDependenciesMeta": {
     "@frontmcp/ui": {
@@ -111,8 +112,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "1.0.3",
-    "@frontmcp/protocol": "1.0.3",
+    "@frontmcp/utils": "1.1.0-beta.1",
+    "@frontmcp/protocol": "1.1.0-beta.1",
     "jose": "^6.0.11",
     "tslib": "^2.3.0"
   },

package/esm/perf/index.mjs

@@ -3058,11 +3058,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },

package/example-tools/tool-configs.d.ts

@@ -15,27 +15,27 @@
  *   description: BASIC_UI_TOOL_CONFIG.description,
  *   ui: BASIC_UI_TOOL_CONFIG.ui,
  * })
- * export class BasicUITool extends ToolContext<typeof inputSchema, typeof outputSchema> {
+ * export class BasicUITool extends ToolContext {
  *   async execute(input) {
  *     return { message: `Hello, ${input.name}!`, timestamp: Date.now() };
  *   }
  * }
  * ```
  */
-import { z } from 'zod';
+import { z } from '@frontmcp/lazy-zod';
 /**
  * Input schema for the basic UI tool.
  */
-export declare const basicUIToolInputSchema: z.ZodObject<{
-    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>;
+export declare const basicUIToolInputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    name: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>>;
+}, import("zod/v4/core").$strip>;
 /**
  * Output schema for the basic UI tool.
  */
-export declare const basicUIToolOutputSchema: z.ZodObject<{
-    message: z.ZodString;
-    timestamp: z.ZodNumber;
-}, z.core.$strip>;
+export declare const basicUIToolOutputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    message: import("@frontmcp/lazy-zod").ZodString;
+    timestamp: import("@frontmcp/lazy-zod").ZodNumber;
+}, import("zod/v4/core").$strip>;
 /**
  * Basic UI tool configuration with minimal UI config.
  * Use this for testing that platform-specific meta keys are correctly applied.
@@ -43,13 +43,13 @@ export declare const basicUIToolOutputSchema: z.ZodObject<{
 export declare const BASIC_UI_TOOL_CONFIG: {
     readonly name: "platform-test-basic";
     readonly description: "Basic UI tool for platform testing";
-    readonly inputSchema: z.ZodObject<{
-        name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, z.core.$strip>;
-    readonly outputSchema: z.ZodObject<{
-        message: z.ZodString;
-        timestamp: z.ZodNumber;
-    }, z.core.$strip>;
+    readonly inputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+        name: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>>;
+    }, import("zod/v4/core").$strip>;
+    readonly outputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+        message: import("@frontmcp/lazy-zod").ZodString;
+        timestamp: import("@frontmcp/lazy-zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
     readonly ui: {
         /**
          * Simple template that displays the output.
@@ -61,19 +61,19 @@ export declare const BASIC_UI_TOOL_CONFIG: {
 /**
  * Input schema for the full UI tool.
  */
-export declare const fullUIToolInputSchema: z.ZodObject<{
-    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
+export declare const fullUIToolInputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    name: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>>;
+    count: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>>;
+}, import("zod/v4/core").$strip>;
 /**
  * Output schema for the full UI tool.
  */
-export declare const fullUIToolOutputSchema: z.ZodObject<{
-    message: z.ZodString;
-    count: z.ZodNumber;
-    items: z.ZodArray<z.ZodString>;
-    timestamp: z.ZodNumber;
-}, z.core.$strip>;
+export declare const fullUIToolOutputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    message: import("@frontmcp/lazy-zod").ZodString;
+    count: import("@frontmcp/lazy-zod").ZodNumber;
+    items: import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>;
+    timestamp: import("@frontmcp/lazy-zod").ZodNumber;
+}, import("zod/v4/core").$strip>;
 /**
  * Full UI tool configuration with all UI options.
  * Use this for testing comprehensive platform-specific meta key behavior.
@@ -81,16 +81,16 @@ export declare const fullUIToolOutputSchema: z.ZodObject<{
 export declare const FULL_UI_TOOL_CONFIG: {
     readonly name: "platform-test-full";
     readonly description: "Full UI tool with all options for comprehensive platform testing";
-    readonly inputSchema: z.ZodObject<{
-        name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-        count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    }, z.core.$strip>;
-    readonly outputSchema: z.ZodObject<{
-        message: z.ZodString;
-        count: z.ZodNumber;
-        items: z.ZodArray<z.ZodString>;
-        timestamp: z.ZodNumber;
-    }, z.core.$strip>;
+    readonly inputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+        name: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>>;
+        count: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>>;
+    }, import("zod/v4/core").$strip>;
+    readonly outputSchema: import("@frontmcp/lazy-zod").ZodObject<{
+        message: import("@frontmcp/lazy-zod").ZodString;
+        count: import("@frontmcp/lazy-zod").ZodNumber;
+        items: import("@frontmcp/lazy-zod").ZodArray<import("@frontmcp/lazy-zod").ZodString>;
+        timestamp: import("@frontmcp/lazy-zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
     readonly ui: {
         /**
          * Template with more complex UI elements.

package/example-tools/tool-configs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-configs.d.ts","sourceRoot":"","sources":["../../src/example-tools/tool-configs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;QAM7B;;;WAGG;;;CASG,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;QAM5B;;WAEG;;QAqBH;;WAEG;;QAEH;;WAEG;;;;;QAKH;;WAEG;;;;;QAKH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;CAGG,CAAC;AAMX;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;;EAKtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;EAWpF;AAMD;;;GAGG;AACH,eAAO,MAAM,oCAAoC,iEAAkE,CAAC;AAEpH;;;GAGG;AACH,eAAO,MAAM,mCAAmC,gDAAiD,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,qCAAqC,iEAAkE,CAAC;AAErH;;GAEG;AACH,eAAO,MAAM,oCAAoC,gDAAiD,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,qCAAqC,iEAAkE,CAAC;AAErH;;;GAGG;AACH,eAAO,MAAM,oCAAoC,gDAAiD,CAAC"}
+{"version":3,"file":"tool-configs.d.ts","sourceRoot":"","sources":["../../src/example-tools/tool-configs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAMvC;;GAEG;AACH,eAAO,MAAM,sBAAsB;;gCAEjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;gCAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;QAM7B;;;WAGG;;;CASG,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;gCAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;gCAKjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;QAM5B;;WAEG;;QAqBH;;WAEG;;QAEH;;WAEG;;;;;QAKH;;WAEG;;;;;QAKH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;CAGG,CAAC;AAMX;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;;EAKtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;EAWpF;AAMD;;;GAGG;AACH,eAAO,MAAM,oCAAoC,iEAAkE,CAAC;AAEpH;;;GAGG;AACH,eAAO,MAAM,mCAAmC,gDAAiD,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,qCAAqC,iEAAkE,CAAC;AAErH;;GAEG;AACH,eAAO,MAAM,oCAAoC,gDAAiD,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,qCAAqC,iEAAkE,CAAC;AAErH;;;GAGG;AACH,eAAO,MAAM,oCAAoC,gDAAiD,CAAC"}

package/fixtures/index.js

@@ -2319,11 +2319,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },

package/index.js

@@ -4028,11 +4028,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },
@@ -6420,13 +6422,13 @@ var UIAssertions = {
 };
 
 // libs/testing/src/example-tools/tool-configs.ts
-var import_zod = require("zod");
-var basicUIToolInputSchema = import_zod.z.object({
-  name: import_zod.z.string().optional().default("World")
+var import_lazy_zod = require("@frontmcp/lazy-zod");
+var basicUIToolInputSchema = import_lazy_zod.z.object({
+  name: import_lazy_zod.z.string().optional().default("World")
 });
-var basicUIToolOutputSchema = import_zod.z.object({
-  message: import_zod.z.string(),
-  timestamp: import_zod.z.number()
+var basicUIToolOutputSchema = import_lazy_zod.z.object({
+  message: import_lazy_zod.z.string(),
+  timestamp: import_lazy_zod.z.number()
 });
 var BASIC_UI_TOOL_CONFIG = {
   name: "platform-test-basic",
@@ -6447,15 +6449,15 @@ var BASIC_UI_TOOL_CONFIG = {
     `.trim()
   }
 };
-var fullUIToolInputSchema = import_zod.z.object({
-  name: import_zod.z.string().optional().default("World"),
-  count: import_zod.z.number().optional().default(1)
+var fullUIToolInputSchema = import_lazy_zod.z.object({
+  name: import_lazy_zod.z.string().optional().default("World"),
+  count: import_lazy_zod.z.number().optional().default(1)
 });
-var fullUIToolOutputSchema = import_zod.z.object({
-  message: import_zod.z.string(),
-  count: import_zod.z.number(),
-  items: import_zod.z.array(import_zod.z.string()),
-  timestamp: import_zod.z.number()
+var fullUIToolOutputSchema = import_lazy_zod.z.object({
+  message: import_lazy_zod.z.string(),
+  count: import_lazy_zod.z.number(),
+  items: import_lazy_zod.z.array(import_lazy_zod.z.string()),
+  timestamp: import_lazy_zod.z.number()
 });
 var FULL_UI_TOOL_CONFIG = {
   name: "platform-test-full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/testing",
-  "version": "1.0.3",
+  "version": "1.1.0-beta.1",
   "description": "E2E testing framework for FrontMCP servers - MCP client, auth mocks, Playwright integration",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -87,11 +87,12 @@
     "./esm": null
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "1.0.3",
-    "@frontmcp/ui": "1.0.3",
+    "@frontmcp/sdk": "1.1.0-beta.1",
+    "@frontmcp/ui": "1.1.0-beta.1",
     "@playwright/test": "^1.40.0",
     "jest": "^29.0.0 || ^30.0.0",
-    "@jest/globals": "^29.0.0 || ^30.0.0"
+    "@jest/globals": "^29.0.0 || ^30.0.0",
+    "@frontmcp/lazy-zod": "1.1.0-beta.1"
   },
   "peerDependenciesMeta": {
     "@frontmcp/ui": {
@@ -111,8 +112,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "1.0.3",
-    "@frontmcp/protocol": "1.0.3",
+    "@frontmcp/utils": "1.1.0-beta.1",
+    "@frontmcp/protocol": "1.1.0-beta.1",
     "jose": "^6.0.11",
     "tslib": "^2.3.0"
   },

package/perf/index.js

@@ -3120,11 +3120,13 @@ var E2E_PORT_RANGES = {
   "demo-e2e-esm": { start: 50370, size: 10 },
   "demo-e2e-feature-flags": { start: 50380, size: 10 },
   "demo-e2e-resource-providers": { start: 50390, size: 10 },
-  // ESM E2E tests (50400-50449)
+  // ESM E2E tests (50400-50439)
   "esm-package-server": { start: 50400, size: 10 },
   "esm-package-server-hot-reload": { start: 50410, size: 10 },
   "esm-package-server-cli": { start: 50420, size: 10 },
   "demo-e2e-unix-socket": { start: 50430, size: 10 },
+  // Distributed E2E tests (50440-50459)
+  "demo-e2e-distributed": { start: 50440, size: 20 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },

package/server/distributed-test-cluster.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Distributed Test Cluster
+ *
+ * Manages multiple TestServer instances that share a single Redis,
+ * each with a unique MACHINE_ID.
+ * Used for E2E testing of session scaling, SSE routing, and takeover.
+ */
+import { TestServer, type TestServerInfo } from './test-server';
+export interface ClusterNode {
+    /** Node index (0-based) */
+    index: number;
+    /** Machine ID for this node */
+    machineId: string;
+    /** Server info (baseUrl, port) */
+    info: TestServerInfo;
+    /** Underlying TestServer instance */
+    server: TestServer;
+}
+export interface DistributedClusterOptions {
+    /** Redis URL (e.g., redis://localhost:6379) */
+    redisUrl: string;
+    /** Path to the server entry file (e.g., apps/e2e/demo-e2e-distributed/src/main.ts) */
+    serverEntry: string;
+    /** E2E project name for port allocation */
+    project?: string;
+    /** Additional environment variables for all nodes */
+    env?: Record<string, string>;
+    /** Server startup timeout in ms (default: 45000) */
+    startupTimeout?: number;
+}
+/**
+ * Manages a cluster of FrontMCP server instances for distributed testing.
+ *
+ * @example
+ * ```typescript
+ * const redis = await startRedisContainer();
+ * const cluster = new DistributedTestCluster({
+ *   redisUrl: redis.url,
+ *   serverEntry: 'apps/e2e/demo-e2e-distributed/src/main.ts',
+ *   project: 'demo-e2e-distributed',
+ * });
+ *
+ * const nodes = await cluster.start(2);
+ * // nodes[0].info.baseUrl, nodes[1].info.baseUrl
+ *
+ * await cluster.stopNode(0); // simulate pod death
+ * await cluster.teardown();
+ * ```
+ */
+export declare class DistributedTestCluster {
+    private nodes;
+    private readonly options;
+    private nextIndex;
+    constructor(options: DistributedClusterOptions);
+    /**
+     * Start N server instances with unique MACHINE_IDs sharing the same Redis.
+     * Can only be called once — call teardown() before starting again.
+     */
+    start(count: number): Promise<ClusterNode[]>;
+    /**
+     * Start a single node at the given index.
+     */
+    startNode(index: number): Promise<ClusterNode>;
+    /**
+     * Stop a specific node (simulate pod death).
+     * Removes the node from the cluster — it cannot be reused.
+     */
+    stopNode(index: number): Promise<void>;
+    /**
+     * Get info for a running node. Returns undefined if the node
+     * was never started or has been stopped.
+     */
+    getNode(index: number): ClusterNode | undefined;
+    /**
+     * Stop all nodes and clean up.
+     */
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=distributed-test-cluster.d.ts.map

package/server/distributed-test-cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-test-cluster.d.ts","sourceRoot":"","sources":["../../src/server/distributed-test-cluster.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,CAAqE;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,EAAE,yBAAyB;IAI9C;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBlD;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BpD;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAW/C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWhC"}

package/server/port-registry.d.ts

@@ -163,6 +163,10 @@ export declare const E2E_PORT_RANGES: {
         readonly start: 50430;
         readonly size: 10;
     };
+    readonly 'demo-e2e-distributed': {
+        readonly start: 50440;
+        readonly size: 20;
+    };
     readonly 'mock-oauth': {
         readonly start: 50900;
         readonly size: 10;

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDlB,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;AAkFD;;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"}
+{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/server/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DlB,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;AAkFD;;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"}