@frontmcp/testing 0.12.2 → 1.0.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/testing",
-  "version": "0.12.2",
+  "version": "1.0.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,8 +87,8 @@
     "./esm": null
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "0.12.2",
-    "@frontmcp/ui": "0.12.2",
+    "@frontmcp/sdk": "1.0.0-beta.1",
+    "@frontmcp/ui": "1.0.0-beta.1",
     "@playwright/test": "^1.40.0",
     "jest": "^29.0.0",
     "@jest/globals": "^29.0.0"
@@ -111,8 +111,8 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "0.12.2",
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@frontmcp/utils": "1.0.0-beta.1",
+    "@frontmcp/protocol": "1.0.0-beta.1",
     "jose": "^6.0.11",
     "tslib": "^2.3.0"
   },

package/perf/index.js

@@ -898,7 +898,7 @@ function getPlatformCapabilities(platform) {
       ...baseCapabilities,
       experimental: {
         [MCP_APPS_EXTENSION_KEY]: {
-          mimeTypes: ["text/html+mcp"]
+          mimeTypes: ["text/html;profile=mcp-app"]
         }
       }
     };
@@ -1019,7 +1019,7 @@ var McpTestClientBuilder = class {
    *   .withCapabilities({
    *     sampling: {},
    *     experimental: {
-   *       'io.modelcontextprotocol/ui': { mimeTypes: ['text/html+mcp'] }
+   *       'io.modelcontextprotocol/ui': { mimeTypes: ['text/html;profile=mcp-app'] }
    *     }
    *   })
    *   .buildAndConnect();
@@ -2001,11 +2001,24 @@ var McpTestClient = class {
     this.log("debug", `Connecting to ${this.config.baseUrl}...`);
     this.transport = this.createTransport();
     await this.transport.connect();
-    const initResponse = await this.initialize();
-    if (!initResponse.success || !initResponse.data) {
-      throw new Error(`Failed to initialize MCP connection: ${initResponse.error?.message ?? "Unknown error"}`);
+    const maxRetries = 3;
+    const retryDelayMs = 500;
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      const initResponse = await this.initialize();
+      if (initResponse.success && initResponse.data) {
+        this.initResult = initResponse.data;
+        break;
+      }
+      lastError = initResponse.error?.message ?? "Unknown error";
+      if (attempt < maxRetries) {
+        this.log("debug", `MCP init attempt ${attempt} failed (${lastError}), retrying in ${retryDelayMs}ms...`);
+        await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+      }
+    }
+    if (!this.initResult) {
+      throw new Error(`Failed to initialize MCP connection after ${maxRetries} attempts: ${lastError}`);
     }
-    this.initResult = initResponse.data;
     this._sessionId = this.transport.getSessionId();
     this._sessionInfo = {
       id: this._sessionId ?? `session-${Date.now()}`,
@@ -2696,7 +2709,7 @@ var McpTestClient = class {
     const raw = response.data ?? { content: [] };
     const isError = !response.success || raw.isError === true;
     const meta = raw._meta;
-    const hasUI = meta?.["ui/html"] !== void 0 || meta?.["ui/component"] !== void 0 || meta?.["openai/html"] !== void 0 || meta?.["frontmcp/html"] !== void 0;
+    const hasUI = meta?.["ui/html"] !== void 0 || meta?.["ui/component"] !== void 0;
     const structuredContent = raw["structuredContent"];
     return {
       raw,
@@ -3048,6 +3061,7 @@ var TestTokenFactory = class {
 
 // libs/testing/src/server/test-server.ts
 var import_child_process = require("child_process");
+var import_utils = require("@frontmcp/utils");
 
 // libs/testing/src/errors/index.ts
 var TestClientError = class extends Error {
@@ -3095,9 +3109,16 @@ var E2E_PORT_RANGES = {
   "demo-e2e-agents": { start: 50270, size: 10 },
   "demo-e2e-transport-recreation": { start: 50280, size: 10 },
   "demo-e2e-jobs": { start: 50290, size: 10 },
-  // Infrastructure E2E tests (50300-50399)
+  // Infrastructure E2E tests (50300-50409)
   "demo-e2e-redis": { start: 50300, size: 10 },
   "demo-e2e-serverless": { start: 50310, size: 10 },
+  "demo-e2e-uipack": { start: 50320, size: 10 },
+  "demo-e2e-agent-adapters": { start: 50330, size: 10 },
+  "demo-e2e-guard": { start: 50340, size: 10 },
+  // ESM E2E tests (50400-50449)
+  "esm-package-server": { start: 50400, size: 10 },
+  "esm-package-server-hot-reload": { start: 50410, size: 10 },
+  "esm-package-server-cli": { start: 50420, size: 10 },
   // Mock servers and utilities (50900-50999)
   "mock-oauth": { start: 50900, size: 10 },
   "mock-api": { start: 50910, size: 10 },
@@ -3169,7 +3190,7 @@ async function tryReservePort(port, project) {
     server.once("error", () => {
       resolve(false);
     });
-    server.listen(port, "::", () => {
+    server.listen(port, () => {
       reservedPorts.set(port, {
         port,
         project,
@@ -3210,7 +3231,7 @@ async function isPortAvailable(port) {
     server.once("error", () => {
       resolve(false);
     });
-    server.listen(port, "::", () => {
+    server.listen(port, () => {
       server.close(() => {
         resolve(true);
       });
@@ -3248,15 +3269,37 @@ var TestServer = class _TestServer {
    */
   static async start(options) {
     const project = options.project ?? "default";
-    const { port, release } = await reservePort(project, options.port);
-    const server = new _TestServer(options, port, release);
-    try {
-      await server.startProcess();
-    } catch (error) {
-      await server.stop();
-      throw error;
+    const maxAttempts = 3;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      const { port, release } = await reservePort(project, options.port);
+      const server = new _TestServer(options, port, release);
+      try {
+        await server.startProcess();
+        return server;
+      } catch (error) {
+        try {
+          await server.stop();
+        } catch (cleanupError) {
+          if (options.debug || DEBUG_SERVER) {
+            const msg = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
+            console.warn(`[TestServer] Cleanup failed after startup error: ${msg}`);
+          }
+        }
+        const isEADDRINUSE = error instanceof Error && (error.message.includes("EADDRINUSE") || server.getLogs().some((l) => l.includes("EADDRINUSE")));
+        if (isEADDRINUSE && attempt < maxAttempts) {
+          const delayMs = attempt * 500;
+          if (options.debug || DEBUG_SERVER) {
+            console.warn(
+              `[TestServer] EADDRINUSE on port ${port}, retrying in ${delayMs}ms (attempt ${attempt}/${maxAttempts})`
+            );
+          }
+          await sleep4(delayMs);
+          continue;
+        }
+        throw error;
+      }
     }
-    return server;
+    throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`);
   }
   /**
    * Start an Nx project as test server
@@ -3267,22 +3310,44 @@ var TestServer = class _TestServer {
         `Invalid project name: ${project}. Must contain only alphanumeric, underscore, and hyphen characters.`
       );
     }
-    const { port, release } = await reservePort(project, options.port);
-    const serverOptions = {
-      ...options,
-      port,
-      project,
-      command: `npx nx serve ${project} --port ${port}`,
-      cwd: options.cwd ?? process.cwd()
-    };
-    const server = new _TestServer(serverOptions, port, release);
-    try {
-      await server.startProcess();
-    } catch (error) {
-      await server.stop();
-      throw error;
+    const maxAttempts = 3;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      const { port, release } = await reservePort(project, options.port);
+      const serverOptions = {
+        ...options,
+        port,
+        project,
+        command: `npx nx serve ${project} --port ${port}`,
+        cwd: options.cwd ?? process.cwd()
+      };
+      const server = new _TestServer(serverOptions, port, release);
+      try {
+        await server.startProcess();
+        return server;
+      } catch (error) {
+        try {
+          await server.stop();
+        } catch (cleanupError) {
+          if (options.debug || DEBUG_SERVER) {
+            const msg = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
+            console.warn(`[TestServer] Cleanup failed after startup error: ${msg}`);
+          }
+        }
+        const isEADDRINUSE = error instanceof Error && (error.message.includes("EADDRINUSE") || server.getLogs().some((l) => l.includes("EADDRINUSE")));
+        if (isEADDRINUSE && attempt < maxAttempts) {
+          const delayMs = attempt * 500;
+          if (options.debug || DEBUG_SERVER) {
+            console.warn(
+              `[TestServer] EADDRINUSE on port ${port}, retrying in ${delayMs}ms (attempt ${attempt}/${maxAttempts})`
+            );
+          }
+          await sleep4(delayMs);
+          continue;
+        }
+        throw error;
+      }
     }
-    return server;
+    throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`);
   }
   /**
    * Create a test server connected to an already running server
@@ -3319,7 +3384,21 @@ var TestServer = class _TestServer {
     }
     if (this.process) {
       this.log("Stopping server...");
-      this.process.kill("SIGTERM");
+      if (this.process.exitCode !== null || this.process.signalCode !== null) {
+        this.log(`Server already exited (code: ${this.process.exitCode}, signal: ${this.process.signalCode})`);
+        this.process = null;
+        return;
+      }
+      const pid = this.process.pid;
+      try {
+        if (pid !== void 0) {
+          process.kill(-pid, "SIGTERM");
+        } else {
+          this.process.kill("SIGTERM");
+        }
+      } catch {
+        this.process.kill("SIGTERM");
+      }
       const exitPromise = new Promise((resolve) => {
         if (this.process) {
           this.process.once("exit", () => resolve());
@@ -3330,7 +3409,16 @@ var TestServer = class _TestServer {
       const killTimeout = setTimeout(() => {
         if (this.process) {
           this.log("Force killing server after timeout...");
-          this.process.kill("SIGKILL");
+          const killPid = this.process.pid;
+          try {
+            if (killPid !== void 0) {
+              process.kill(-killPid, "SIGKILL");
+            } else {
+              this.process.kill("SIGKILL");
+            }
+          } catch {
+            this.process.kill("SIGKILL");
+          }
         }
       }, 5e3);
       await exitPromise;
@@ -3395,14 +3483,17 @@ var TestServer = class _TestServer {
       ...this.options.env,
       PORT: String(this.options.port)
     };
+    const runtimeEnv = withWorkspaceProtocolFallback(env, this.options.cwd);
     if (this.portRelease) {
       await this.portRelease();
       this.portRelease = null;
+      await sleep4(300);
     }
     this.process = (0, import_child_process.spawn)(this.options.command, [], {
       cwd: this.options.cwd,
-      env,
+      env: runtimeEnv,
       shell: true,
+      detached: true,
       stdio: ["pipe", "pipe", "pipe"]
     });
     if (this.process.pid !== void 0) {
@@ -3554,6 +3645,111 @@ TIP: Set DEBUG_SERVER=1 or DEBUG=1 environment variable for verbose output`
 function sleep4(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function withWorkspaceProtocolFallback(env, cwd) {
+  if (findInstalledProtocolPackageDir(cwd)) {
+    return env;
+  }
+  try {
+    const workspacePackageDir = findWorkspaceProtocolDir(cwd);
+    if (!workspacePackageDir) {
+      return env;
+    }
+    ensureWorkspaceProtocolLink(cwd, workspacePackageDir);
+    if (findInstalledProtocolPackageDir(cwd)) {
+      return env;
+    }
+    return withProtocolNodePathAlias(env, cwd, workspacePackageDir);
+  } catch (err) {
+    if (DEBUG_SERVER) {
+      console.error(
+        `[TestServer] Workspace protocol fallback failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    return env;
+  }
+}
+function ensureWorkspaceProtocolLink(cwd, workspacePackageDir) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  const nodeModulesDir = findWorkspaceNodeModulesDir(cwd);
+  if (!nodeModulesDir) {
+    return;
+  }
+  const scopeDir = path.join(nodeModulesDir, "@frontmcp");
+  const aliasPackageDir = path.join(scopeDir, "protocol");
+  if (fs.existsSync(aliasPackageDir)) {
+    return;
+  }
+  fs.mkdirSync(scopeDir, { recursive: true });
+  try {
+    fs.symlinkSync(workspacePackageDir, aliasPackageDir, process.platform === "win32" ? "junction" : "dir");
+  } catch (error) {
+    const err = error;
+    if (err.code !== "EEXIST") {
+      throw error;
+    }
+  }
+}
+function withProtocolNodePathAlias(env, cwd, workspacePackageDir) {
+  const fs = require("node:fs");
+  const os = require("node:os");
+  const path = require("node:path");
+  const aliasRoot = path.join(os.tmpdir(), "frontmcp-test-node-path", (0, import_utils.sha256Hex)(cwd).slice(0, 12));
+  const scopeDir = path.join(aliasRoot, "@frontmcp");
+  const aliasPackageDir = path.join(scopeDir, "protocol");
+  fs.mkdirSync(scopeDir, { recursive: true });
+  try {
+    if (!fs.existsSync(aliasPackageDir)) {
+      fs.symlinkSync(workspacePackageDir, aliasPackageDir, process.platform === "win32" ? "junction" : "dir");
+    }
+  } catch (error) {
+    const err = error;
+    if (err.code !== "EEXIST") throw error;
+  }
+  const existingNodePath = env["NODE_PATH"];
+  const nodePathEntries = [aliasRoot, ...existingNodePath ? existingNodePath.split(path.delimiter) : []].filter(
+    Boolean
+  );
+  return {
+    ...env,
+    NODE_PATH: [...new Set(nodePathEntries)].join(path.delimiter)
+  };
+}
+function findUp(startDir, testFn) {
+  const path = require("node:path");
+  let currentDir = startDir;
+  while (true) {
+    const result = testFn(currentDir);
+    if (result !== void 0) return result;
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) return void 0;
+    currentDir = parentDir;
+  }
+}
+function findWorkspaceProtocolDir(startDir) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  return findUp(startDir, (dir) => {
+    const candidate = path.join(dir, "libs", "protocol");
+    return fs.existsSync(path.join(candidate, "dist", "index.js")) ? candidate : void 0;
+  });
+}
+function findInstalledProtocolPackageDir(startDir) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  return findUp(startDir, (dir) => {
+    const candidate = path.join(dir, "node_modules", "@frontmcp", "protocol");
+    return fs.existsSync(path.join(candidate, "package.json")) ? candidate : void 0;
+  });
+}
+function findWorkspaceNodeModulesDir(startDir) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  return findUp(startDir, (dir) => {
+    const candidate = path.join(dir, "node_modules");
+    return fs.existsSync(candidate) ? candidate : void 0;
+  });
+}
 
 // libs/testing/src/perf/perf-test.ts
 var currentConfig = {};

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

@@ -22,7 +22,8 @@ import type { TestPlatformType } from './platform-types';
 export declare const MCP_APPS_EXTENSION_KEY: "io.modelcontextprotocol/ui";
 /**
  * Client info for MCP initialization.
- * Matches the Implementation type from @modelcontextprotocol/sdk.
+ * Contains the required fields (name, version) of the Implementation type
+ * from @frontmcp/protocol, used for testing and platform detection.
  */
 export interface TestClientInfo {
     /** Client name (used for User-Agent header) */

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,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"}
+{"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;;;;GAIG;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/platform/platform-types.d.ts

@@ -15,37 +15,29 @@
 /**
  * Supported AI platform types for testing.
  *
- * - `openai`: OpenAI ChatGPT (uses openai/* meta keys)
- * - `ext-apps`: MCP Apps per SEP-1865 (uses ui/* meta keys)
- * - `claude`: Claude Desktop (uses ui/* keys only)
- * - `cursor`: Cursor IDE (uses ui/* keys only)
- * - `continue`: Continue Dev (uses ui/* keys only)
- * - `cody`: Sourcegraph Cody (uses ui/* keys only)
- * - `gemini`: Google Gemini (uses ui/* keys only)
- * - `generic-mcp`: Generic MCP client (uses ui/* keys only)
- * - `unknown`: Unknown platform (uses ui/* keys only)
+ * All platforms use `ui/*` meta keys per the MCP Apps specification.
  */
 export type TestPlatformType = 'openai' | 'ext-apps' | 'claude' | 'cursor' | 'continue' | 'cody' | 'gemini' | 'generic-mcp' | 'unknown';
 /**
  * Platform meta namespace used for tool responses.
- *
- * - `openai`: Uses `openai/*` keys only
- * - `ui`: Uses `ui/*` keys only (all non-OpenAI platforms)
+ * All platforms now use `ui/*` keys per the MCP Apps specification.
  */
-export type PlatformMetaNamespace = 'openai' | 'ui';
+export type PlatformMetaNamespace = 'ui';
 /**
  * Get the meta namespace for a platform type.
+ * All platforms use the `ui` namespace.
  */
 export declare function getPlatformMetaNamespace(platform: TestPlatformType): PlatformMetaNamespace;
 /**
  * Get the expected MIME type for a platform.
  *
- * - OpenAI uses `text/html+skybridge`
- * - All other platforms use `text/html+mcp`
+ * - OpenAI uses `text/html;profile=mcp-app`
+ * - All other platforms use `text/html;profile=mcp-app`
  */
 export declare function getPlatformMimeType(platform: TestPlatformType): string;
 /**
  * Check if a platform uses OpenAI-specific meta keys.
+ * Note: OpenAI now uses the standard ui/* namespace like all other platforms.
  */
 export declare function isOpenAIPlatform(platform: TestPlatformType): boolean;
 /**
@@ -53,15 +45,18 @@ export declare function isOpenAIPlatform(platform: TestPlatformType): boolean;
  */
 export declare function isExtAppsPlatform(platform: TestPlatformType): boolean;
 /**
- * Check if a platform uses ui/* meta keys (non-OpenAI).
+ * Check if a platform uses ui/* meta keys.
+ * All platforms now use ui/* keys.
  */
 export declare function isUiPlatform(platform: TestPlatformType): boolean;
 /**
  * Get all expected meta key prefixes for a platform's tools/list response.
+ * All platforms use ui/* namespace.
  */
 export declare function getToolsListMetaPrefixes(platform: TestPlatformType): string[];
 /**
  * Get all expected meta key prefixes for a platform's tool/call response.
+ * All platforms use ui/* namespace.
  */
 export declare function getToolCallMetaPrefixes(platform: TestPlatformType): string[];
 /**

package/platform/platform-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-types.d.ts","sourceRoot":"","sources":["../../src/platform/platform-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEpD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,qBAAqB,CAQ1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAQ7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAS7E"}
+{"version":3,"file":"platform-types.d.ts","sourceRoot":"","sources":["../../src/platform/platform-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,qBAAqB,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAE7E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAE5E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAG7E"}

package/playwright/index.d.ts

@@ -15,7 +15,7 @@
  * test.describe('OAuth Flow', () => {
  *   test.use({
  *     server: MyServer,
- *     auth: { mode: 'orchestrated' }
+ *     auth: { mode: 'local' }
  *   });
  *
  *   test('completes OAuth flow', async ({ page, oauth }) => {

package/raw-client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Raw MCP protocol client re-exports for low-level e2e testing.
+ * For programmatic access, prefer connect()/connectOpenAI() from @frontmcp/sdk.
+ */
+export { Client as McpClient } from '@frontmcp/protocol';
+export { StdioClientTransport as McpStdioClientTransport } from '@frontmcp/protocol';
+//# sourceMappingURL=index.d.ts.map

package/raw-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/raw-client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/server/index.d.ts

@@ -4,6 +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 { reservePort, getProjectPort, getProjectPorts, getPortRange, releaseAllPorts, getReservedPorts, 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;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"}
+{"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,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/server/port-registry.d.ts

@@ -115,6 +115,30 @@ export declare const E2E_PORT_RANGES: {
         readonly start: 50310;
         readonly size: 10;
     };
+    readonly 'demo-e2e-uipack': {
+        readonly start: 50320;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-agent-adapters': {
+        readonly start: 50330;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-guard': {
+        readonly start: 50340;
+        readonly size: 10;
+    };
+    readonly 'esm-package-server': {
+        readonly start: 50400;
+        readonly size: 10;
+    };
+    readonly 'esm-package-server-hot-reload': {
+        readonly start: 50410;
+        readonly size: 10;
+    };
+    readonly 'esm-package-server-cli': {
+        readonly start: 50420;
+        readonly size: 10;
+    };
     readonly 'mock-oauth': {
         readonly start: 50900;
         readonly size: 10;
@@ -174,10 +198,4 @@ export declare function getReservedPorts(): Array<{
     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

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

package/server/test-server.d.ts

@@ -104,5 +104,5 @@ export declare class TestServer {
     private waitForReadyWithExitDetection;
     private log;
 }
-export { reservePort, getProjectPort, getProjectPorts, getPortRange, releaseAllPorts, getReservedPorts, findAvailablePort, E2E_PORT_RANGES, type E2EProject, } from './port-registry';
+export { reservePort, getProjectPort, getProjectPorts, getPortRange, releaseAllPorts, getReservedPorts, E2E_PORT_RANGES, type E2EProject, } from './port-registry';
 //# sourceMappingURL=test-server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"test-server.d.ts","sourceRoot":"","sources":["../../src/server/test-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsE;IAC9F,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,WAAW,CAAsC;IAEzD,OAAO;IAmBP;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAenE;;OAEG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA6BpG;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAoB3C;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAEzB;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B;;OAEG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,SAAS,IAAI,IAAI;YAQH,YAAY;IA0G1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;YACW,6BAA6B;IAmE3C,OAAO,CAAC,GAAG;CAKZ;AAcD,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"test-server.d.ts","sourceRoot":"","sources":["../../src/server/test-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsE;IAC9F,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,WAAW,CAAsC;IAEzD,OAAO;IAmBP;;OAEG;WACU,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CnE;;OAEG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA0DpG;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAoB3C;;OAEG;IACH,IAAI,IAAI,IAAI,cAAc,CAEzB;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6D3B;;OAEG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BnD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,SAAS,IAAI,IAAI;YAQH,YAAY;IA8G1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;YACW,6BAA6B;IAmE3C,OAAO,CAAC,GAAG;CAKZ;AA6JD,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC"}