@frontmcp/testing 1.10.9-rc.1 → 1.10.9-rc.3

package/esm/fixtures/index.mjs

@@ -1,4275 +1,35 @@
 var __frontmcpModule = typeof process !== "undefined" && typeof process.getBuiltinModule === "function" ? process.getBuiltinModule("module") : undefined;
 const require = __frontmcpModule ? __frontmcpModule.createRequire(import.meta.url || 'file:///') : undefined;
 // __frontmcpCreateRequire
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// libs/testing/src/auth/token-factory.ts
-import { exportJWK, generateKeyPair, SignJWT } from "jose";
-var TestTokenFactory = class {
-  issuer;
-  audience;
-  privateKey = null;
-  publicKey = null;
-  jwk = null;
-  keyId;
-  /** HS256 shared secret (gateway mode). Null → RS256 + JWKS (default). */
-  hmacSecret;
-  constructor(options = {}) {
-    this.issuer = options.issuer ?? "https://test.frontmcp.local";
-    this.audience = options.audience ?? "frontmcp-test";
-    this.keyId = `test-key-${Date.now()}`;
-    this.hmacSecret = options.hmacSecret ? new TextEncoder().encode(options.hmacSecret) : null;
-  }
-  /** True when this factory signs HS256 with a shared secret (gateway mode). */
-  get isHmac() {
-    return this.hmacSecret !== null;
-  }
-  /** The JWS `alg` this factory signs with. */
-  get alg() {
-    return this.isHmac ? "HS256" : "RS256";
-  }
-  /**
-   * The signing key: the shared HMAC secret in gateway mode, otherwise the
-   * generated RSA private key (lazily created via ensureKeys()).
-   */
-  signingKey() {
-    if (this.hmacSecret) return this.hmacSecret;
-    if (!this.privateKey) {
-      throw new Error("Private key not initialized");
-    }
-    return this.privateKey;
-  }
-  /**
-   * Initialize the key pair (called automatically on first use). No-op in HS256
-   * mode — there is no asymmetric keypair, just the shared secret.
-   */
-  async ensureKeys() {
-    if (this.isHmac) return;
-    if (this.privateKey && this.publicKey) return;
-    const { publicKey, privateKey } = await generateKeyPair("RS256", {
-      extractable: true
-    });
-    this.privateKey = privateKey;
-    this.publicKey = publicKey;
-    this.jwk = await exportJWK(publicKey);
-    this.jwk.kid = this.keyId;
-    this.jwk.use = "sig";
-    this.jwk.alg = "RS256";
-  }
-  /**
-   * Create a JWT token with the specified claims
-   */
-  async createTestToken(options) {
-    await this.ensureKeys();
-    const nowMs = Date.now();
-    const iat = Math.floor(nowMs / 1e3);
-    const exp = options.exp ?? 3600;
-    const payload = {
-      iss: options.iss ?? this.issuer,
-      sub: options.sub,
-      aud: options.aud ?? this.audience,
-      iat,
-      exp: Math.ceil(nowMs / 1e3) + exp,
-      scope: options.scopes?.join(" "),
-      ...options.claims
-    };
-    const header = this.isHmac ? { alg: this.alg, typ: "JWT" } : { alg: this.alg, kid: this.keyId };
-    const token = await new SignJWT(payload).setProtectedHeader(header).sign(this.signingKey());
-    return token;
-  }
-  /**
-   * Create an admin token with full access
-   */
-  async createAdminToken(sub = "admin-001") {
-    return this.createTestToken({
-      sub,
-      scopes: ["admin:*", "read", "write", "delete"],
-      claims: {
-        email: "admin@test.local",
-        name: "Test Admin",
-        role: "admin"
-      }
-    });
-  }
-  /**
-   * Create a regular user token
-   */
-  async createUserToken(sub = "user-001", scopes2 = ["read", "write"]) {
-    return this.createTestToken({
-      sub,
-      scopes: scopes2,
-      claims: {
-        email: "user@test.local",
-        name: "Test User",
-        role: "user"
-      }
-    });
-  }
-  /**
-   * Create an anonymous user token
-   */
-  async createAnonymousToken(expiresIn) {
-    return this.createTestToken({
-      sub: `anon:${Date.now()}`,
-      scopes: ["anonymous"],
-      exp: expiresIn,
-      claims: {
-        name: "Anonymous",
-        role: "anonymous"
-      }
-    });
-  }
-  /**
-   * Create an expired token (for testing token expiration)
-   */
-  async createExpiredToken(options) {
-    await this.ensureKeys();
-    const now = Math.floor(Date.now() / 1e3);
-    const payload = {
-      iss: this.issuer,
-      sub: options.sub,
-      aud: this.audience,
-      iat: now - 7200,
-      // 2 hours ago
-      exp: now - 3600
-      // Expired 1 hour ago
-    };
-    const header = this.isHmac ? { alg: this.alg, typ: "JWT" } : { alg: this.alg, kid: this.keyId };
-    const token = await new SignJWT(payload).setProtectedHeader(header).sign(this.signingKey());
-    return token;
-  }
-  /**
-   * Create a token with an invalid signature (for testing signature validation)
-   */
-  createTokenWithInvalidSignature(options) {
-    const now = Math.floor(Date.now() / 1e3);
-    const headerObj = this.isHmac ? { alg: this.alg, typ: "JWT" } : { alg: this.alg, kid: this.keyId };
-    const header = Buffer.from(JSON.stringify(headerObj)).toString("base64url");
-    const payload = Buffer.from(
-      JSON.stringify({
-        iss: this.issuer,
-        sub: options.sub,
-        aud: this.audience,
-        iat: now,
-        exp: now + 3600
-      })
-    ).toString("base64url");
-    const signature = Buffer.from("invalid-signature-" + Date.now()).toString("base64url");
-    return `${header}.${payload}.${signature}`;
-  }
-  /**
-   * Get the public JWKS for verifying tokens.
-   *
-   * Only meaningful in RS256 mode — HS256 (gateway) tokens are verified against
-   * the shared secret, not a published public key, so there is no JWKS to serve.
-   */
-  async getPublicJwks() {
-    if (this.isHmac) {
-      throw new Error("getPublicJwks() is not available in HS256 mode (gateway tokens use a shared secret)");
-    }
-    await this.ensureKeys();
-    if (!this.jwk) {
-      throw new Error("JWK not initialized");
-    }
-    return {
-      keys: [this.jwk]
-    };
-  }
-  /**
-   * Get the issuer URL
-   */
-  getIssuer() {
-    return this.issuer;
-  }
-  /**
-   * Get the audience
-   */
-  getAudience() {
-    return this.audience;
-  }
-};
-
-// libs/testing/src/interceptor/mock-registry.ts
-var DefaultMockRegistry = class {
-  mocks = [];
-  add(mock) {
-    const entry = {
-      definition: mock,
-      callCount: 0,
-      calls: [],
-      remainingUses: mock.times ?? Infinity
-    };
-    this.mocks.push(entry);
-    return {
-      remove: () => {
-        const index = this.mocks.indexOf(entry);
-        if (index !== -1) {
-          this.mocks.splice(index, 1);
-        }
-      },
-      callCount: () => entry.callCount,
-      calls: () => [...entry.calls]
-    };
-  }
-  clear() {
-    this.mocks = [];
-  }
-  getAll() {
-    return this.mocks.map((e) => e.definition);
-  }
-  match(request) {
-    for (const entry of this.mocks) {
-      if (entry.remainingUses <= 0) continue;
-      const { definition } = entry;
-      if (definition.method !== request.method) continue;
-      if (definition.params !== void 0) {
-        const params = request.params ?? {};
-        if (typeof definition.params === "function") {
-          if (!definition.params(params)) continue;
-        } else {
-          if (!this.paramsMatch(definition.params, params)) continue;
-        }
-      }
-      entry.callCount++;
-      entry.calls.push(request);
-      entry.remainingUses--;
-      return definition;
-    }
-    return void 0;
-  }
-  /**
-   * Check if request params match the mock params definition
-   */
-  paramsMatch(expected, actual) {
-    for (const [key, value] of Object.entries(expected)) {
-      if (!(key in actual)) return false;
-      const actualValue = actual[key];
-      if (Array.isArray(value)) {
-        if (!Array.isArray(actualValue)) return false;
-        if (value.length !== actualValue.length) return false;
-        for (let i = 0; i < value.length; i++) {
-          const expectedItem = value[i];
-          const actualItem = actualValue[i];
-          if (typeof expectedItem === "object" && expectedItem !== null) {
-            if (typeof actualItem !== "object" || actualItem === null) return false;
-            if (!this.paramsMatch(expectedItem, actualItem)) {
-              return false;
-            }
-          } else if (actualItem !== expectedItem) {
-            return false;
-          }
-        }
-      } else if (typeof value === "object" && value !== null) {
-        if (typeof actualValue !== "object" || actualValue === null) return false;
-        if (!this.paramsMatch(value, actualValue)) {
-          return false;
-        }
-      } else if (actualValue !== value) {
-        return false;
-      }
-    }
-    return true;
-  }
-};
-var mockResponse = {
-  /**
-   * Create a successful JSON-RPC response
-   */
-  success(result, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      result
-    };
-  },
-  /**
-   * Create an error JSON-RPC response
-   */
-  error(code, message, data, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      error: { code, message, data }
-    };
-  },
-  /**
-   * Create a tool result response
-   */
-  toolResult(content, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      result: { content }
-    };
-  },
-  /**
-   * Create a tools/list response
-   */
-  toolsList(tools, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      result: { tools }
-    };
-  },
-  /**
-   * Create a resources/list response
-   */
-  resourcesList(resources, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      result: { resources }
-    };
-  },
-  /**
-   * Create a resources/read response
-   */
-  resourceRead(contents, id = 1) {
-    return {
-      jsonrpc: "2.0",
-      id,
-      result: { contents }
-    };
-  },
-  /**
-   * Common MCP errors
-   */
-  errors: {
-    methodNotFound: (method, id = 1) => mockResponse.error(-32601, `Method not found: ${method}`, void 0, id),
-    invalidParams: (message, id = 1) => mockResponse.error(-32602, message, void 0, id),
-    internalError: (message, id = 1) => mockResponse.error(-32603, message, void 0, id),
-    resourceNotFound: (uri, id = 1) => mockResponse.error(-32002, `Resource not found: ${uri}`, { uri }, id),
-    toolNotFound: (name, id = 1) => mockResponse.error(-32601, `Tool not found: ${name}`, { name }, id),
-    unauthorized: (id = 1) => mockResponse.error(-32001, "Unauthorized", void 0, id),
-    forbidden: (id = 1) => mockResponse.error(-32003, "Forbidden", void 0, id)
-  }
-};
-
-// libs/testing/src/interceptor/interceptor-chain.ts
-var DefaultInterceptorChain = class {
-  request = [];
-  response = [];
-  mocks;
-  constructor() {
-    this.mocks = new DefaultMockRegistry();
-  }
-  /**
-   * Add a request interceptor
-   */
-  addRequestInterceptor(interceptor) {
-    this.request.push(interceptor);
-    return () => {
-      const index = this.request.indexOf(interceptor);
-      if (index !== -1) {
-        this.request.splice(index, 1);
-      }
-    };
-  }
-  /**
-   * Add a response interceptor
-   */
-  addResponseInterceptor(interceptor) {
-    this.response.push(interceptor);
-    return () => {
-      const index = this.response.indexOf(interceptor);
-      if (index !== -1) {
-        this.response.splice(index, 1);
-      }
-    };
-  }
-  /**
-   * Process a request through the interceptor chain
-   * Returns either:
-   * - { type: 'continue', request } - continue with (possibly modified) request
-   * - { type: 'mock', response } - return mock response immediately
-   * - { type: 'error', error } - throw error
-   */
-  async processRequest(request, meta) {
-    let currentRequest = request;
-    const mockDef = this.mocks.match(request);
-    if (mockDef) {
-      if (mockDef.delay && mockDef.delay > 0) {
-        await sleep(mockDef.delay);
-      }
-      let mockResponse2;
-      if (typeof mockDef.response === "function") {
-        mockResponse2 = await mockDef.response(request);
-      } else {
-        mockResponse2 = mockDef.response;
-      }
-      return {
-        type: "mock",
-        response: { ...mockResponse2, id: request.id ?? mockResponse2.id }
-      };
-    }
-    for (const interceptor of this.request) {
-      const ctx = {
-        request: currentRequest,
-        meta
-      };
-      const result = await interceptor(ctx);
-      switch (result.action) {
-        case "passthrough":
-          break;
-        case "modify":
-          currentRequest = result.request;
-          break;
-        case "mock":
-          return {
-            type: "mock",
-            response: { ...result.response, id: request.id ?? result.response.id }
-          };
-        case "error":
-          return { type: "error", error: result.error };
-      }
-    }
-    return { type: "continue", request: currentRequest };
-  }
-  /**
-   * Process a response through the interceptor chain
-   */
-  async processResponse(request, response, durationMs) {
-    let currentResponse = response;
-    for (const interceptor of this.response) {
-      const ctx = {
-        request,
-        response: currentResponse,
-        durationMs
-      };
-      const result = await interceptor(ctx);
-      switch (result.action) {
-        case "passthrough":
-          break;
-        case "modify":
-          currentResponse = result.response;
-          break;
-      }
-    }
-    return currentResponse;
-  }
-  /**
-   * Clear all interceptors and mocks
-   */
-  clear() {
-    this.request = [];
-    this.response = [];
-    this.mocks.clear();
-  }
-};
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-// libs/testing/src/transport/error-utils.ts
-function errorName(err) {
-  if (typeof err !== "object" || err === null) return void 0;
-  const name = err.name;
-  return typeof name === "string" ? name : void 0;
-}
-function isAbortError(err) {
-  return errorName(err) === "AbortError";
-}
-function errorMessage(err, fallback = "Unknown error") {
-  if (typeof err === "string" && err) return err;
-  if (typeof err === "object" && err !== null) {
-    const message = err.message;
-    if (typeof message === "string" && message) return message;
-  }
-  return fallback;
-}
-var interceptedErrors = /* @__PURE__ */ new WeakSet();
-function markInterceptedError(err) {
-  interceptedErrors.add(err);
-  return err;
-}
-function isInterceptedError(err) {
-  return typeof err === "object" && err !== null && interceptedErrors.has(err);
-}
-
-// libs/testing/src/transport/sse.transport.ts
-var DEFAULT_TIMEOUT = 3e4;
-var SseTransport = class {
-  baseUrl;
-  entryPath;
-  timeout;
-  authHeaders;
-  publicMode;
-  debug;
-  clientInfo;
-  notificationHandler;
-  interceptors;
-  elicitationHandler;
-  state = "disconnected";
-  authToken;
-  sessionId;
-  messageEndpoint;
-  stream;
-  pending = /* @__PURE__ */ new Map();
-  connectionCount = 0;
-  reconnectCount = 0;
-  lastRequestHeaders = {};
-  constructor(config) {
-    this.baseUrl = config.baseUrl.replace(/\/$/, "");
-    this.entryPath = config.entryPath;
-    this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
-    this.authHeaders = config.auth?.headers ?? {};
-    this.authToken = config.auth?.token;
-    this.publicMode = config.publicMode ?? false;
-    this.debug = config.debug ?? false;
-    this.clientInfo = config.clientInfo;
-    this.notificationHandler = config.notificationHandler;
-    this.interceptors = config.interceptors;
-    this.elicitationHandler = config.elicitationHandler;
-  }
-  async connect() {
-    this.state = "connecting";
-    this.connectionCount++;
-    try {
-      if (!this.publicMode && !this.authToken) {
-        await this.requestAnonymousToken();
-      }
-      await this.openStream();
-      this.state = "connected";
-      this.log(`Connected; messages go to ${this.messageEndpoint}`);
-    } catch (error) {
-      this.state = "error";
-      this.stream?.abort();
-      this.stream = void 0;
-      throw error;
-    }
-  }
-  async request(message) {
-    this.ensureConnected();
-    const startTime = Date.now();
-    if (this.interceptors) {
-      const intercepted = await this.interceptors.processRequest(message, {
-        timestamp: /* @__PURE__ */ new Date(),
-        transport: "sse",
-        sessionId: this.sessionId
-      });
-      switch (intercepted.type) {
-        case "mock":
-          return await this.interceptors.processResponse(
-            message,
-            intercepted.response,
-            Date.now() - startTime
-          );
-        case "error":
-          throw markInterceptedError(intercepted.error);
-        case "continue":
-          message = intercepted.request;
-          break;
-      }
-    }
-    let response;
-    if (message.id === void 0) {
-      await this.post(JSON.stringify(message));
-      response = { jsonrpc: "2.0", id: null, result: void 0 };
-    } else {
-      response = await this.postAndAwait(message.id, JSON.stringify(message));
-    }
-    if (this.interceptors) {
-      response = await this.interceptors.processResponse(message, response, Date.now() - startTime);
-    }
-    return response;
-  }
-  async notify(message) {
-    this.ensureConnected();
-    const result = await this.post(JSON.stringify(message));
-    if (!result.ok) this.log(`HTTP ${result.status} on notification: ${result.body}`);
-  }
-  async sendRaw(data) {
-    this.ensureConnected();
-    let id;
-    try {
-      const parsed = JSON.parse(data);
-      if (typeof parsed.id === "string" || typeof parsed.id === "number") id = parsed.id;
-    } catch {
-    }
-    if (id !== void 0) return this.postAndAwait(id, data);
-    const result = await this.post(data);
-    if (!result.ok) {
-      return { jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error", data: result.body } };
-    }
-    return { jsonrpc: "2.0", id: null, result: void 0 };
-  }
-  async close() {
-    this.closeStream("Transport closed");
-    this.state = "disconnected";
-    this.sessionId = void 0;
-    this.messageEndpoint = void 0;
-    this.log("SSE transport closed");
-  }
-  isConnected() {
-    return this.state === "connected";
-  }
-  getState() {
-    return this.state;
-  }
-  getSessionId() {
-    return this.sessionId;
-  }
-  setAuthToken(token) {
-    this.authToken = token;
-  }
-  setTimeout(ms) {
-    this.timeout = ms;
-  }
-  getMessageEndpoint() {
-    return this.messageEndpoint;
-  }
-  getConnectionCount() {
-    return this.connectionCount;
-  }
-  getReconnectCount() {
-    return this.reconnectCount;
-  }
-  getLastRequestHeaders() {
-    return { ...this.lastRequestHeaders };
-  }
-  setInterceptors(interceptors2) {
-    this.interceptors = interceptors2;
-  }
-  getInterceptors() {
-    return this.interceptors;
-  }
-  setElicitationHandler(handler) {
-    this.elicitationHandler = handler;
-  }
-  async simulateDisconnect() {
-    this.closeStream("Simulated disconnect");
-    this.state = "disconnected";
-    this.sessionId = void 0;
-    this.messageEndpoint = void 0;
-  }
-  async waitForReconnect(timeoutMs) {
-    this.reconnectCount++;
-    let timer;
-    try {
-      await Promise.race([
-        this.connect(),
-        new Promise((_, reject) => {
-          timer = setTimeout(() => reject(new Error("Timeout waiting for reconnection")), timeoutMs);
-        })
-      ]);
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // STREAM
-  // ═══════════════════════════════════════════════════════════════════
-  /** Open `GET <entry>/sse` and wait for the `endpoint` event. */
-  async openStream() {
-    const controller = new AbortController();
-    this.stream = controller;
-    const url = this.sseUrl();
-    const { "Content-Type": _contentType, ...headers } = this.buildHeaders();
-    this.log(`GET ${url}`);
-    const connectTimer = setTimeout(() => controller.abort(), this.timeout);
-    let response;
-    try {
-      response = await fetch(url, {
-        method: "GET",
-        headers: { ...headers, Accept: "text/event-stream" },
-        signal: controller.signal
-      });
-    } catch (error) {
-      clearTimeout(connectTimer);
-      throw new Error(
-        isAbortError(error) ? `SSE connection to ${url} timed out after ${this.timeout}ms` : `SSE connection to ${url} failed: ${errorMessage(error)}`,
-        { cause: error }
-      );
-    }
-    const isEventStream = response.headers.get("content-type")?.includes("text/event-stream") ?? false;
-    if (!response.ok || !response.body || !isEventStream) {
-      clearTimeout(connectTimer);
-      const body = await response.text().catch(() => "");
-      throw new Error(
-        `SSE connection to ${url} failed: HTTP ${response.status} ${response.statusText}${body ? ` \u2014 ${body}` : ""}. The legacy HTTP+SSE transport needs a server that serves it (@FrontMcp({ transport: { protocol: { legacy: true } } })).`
-      );
-    }
-    const endpoint = new Promise((resolve, reject) => {
-      const reader = response.body?.getReader();
-      if (!reader) {
-        reject(new Error(`SSE connection to ${url} has no body`));
-        return;
-      }
-      void this.readStream(controller, reader, resolve, reject);
-    });
-    try {
-      const data = await endpoint;
-      const messageUrl = new URL(data, url);
-      this.messageEndpoint = messageUrl.toString();
-      this.sessionId = messageUrl.searchParams.get("sessionId") ?? void 0;
-    } finally {
-      clearTimeout(connectTimer);
-    }
-  }
-  async readStream(controller, reader, onEndpoint, onEndpointError) {
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let endpointSeen = false;
-    try {
-      for (let chunk = await reader.read(); !chunk.done; chunk = await reader.read()) {
-        const { completeEvents, remainder } = splitSSEEvents(buffer + decoder.decode(chunk.value, { stream: true }));
-        buffer = remainder;
-        for (const text of completeEvents) {
-          const event = parseSSEEvent(text);
-          if (!event) continue;
-          if (event.type === "endpoint") {
-            if (!endpointSeen) {
-              endpointSeen = true;
-              onEndpoint(event.data);
-            }
-            continue;
-          }
-          await this.handleMessage(event.data);
-        }
-      }
-    } catch (error) {
-      if (!controller.signal.aborted) this.log("SSE stream failed:", error);
-    } finally {
-      reader.releaseLock();
-    }
-    if (!endpointSeen) {
-      onEndpointError(
-        new Error(
-          controller.signal.aborted ? `SSE stream at ${this.sseUrl()} sent no endpoint event within ${this.timeout}ms` : `SSE stream at ${this.sseUrl()} ended before the server sent its endpoint`
-        )
-      );
-    }
-    if (this.stream === controller) {
-      this.stream = void 0;
-      this.rejectPending("SSE stream closed by the server");
-      if (this.state === "connected") this.state = "disconnected";
-    }
-  }
-  async handleMessage(data) {
-    let message;
-    try {
-      message = JSON.parse(data);
-    } catch {
-      this.log("Ignoring SSE event that is not JSON:", data);
-      return;
-    }
-    if (!message || typeof message !== "object") return;
-    if (typeof message.method === "string") {
-      const request = message;
-      if (request.id === void 0 || request.id === null) {
-        this.notificationHandler?.(request);
-        return;
-      }
-      await this.answerServerRequest(request);
-      return;
-    }
-    if (message.id !== void 0 && message.id !== null) {
-      const pending = this.pending.get(message.id);
-      if (pending) {
-        clearTimeout(pending.timer);
-        this.pending.delete(message.id);
-        pending.resolve(message);
-      }
-    }
-  }
-  /** Server→client requests: elicitation goes to the handler, `ping` is answered, the rest refused. */
-  async answerServerRequest(request) {
-    const id = request.id;
-    let reply;
-    if (request.method === "elicitation/create") {
-      reply = { jsonrpc: "2.0", id, result: await this.elicit(request.params) };
-    } else if (request.method === "ping") {
-      reply = { jsonrpc: "2.0", id, result: {} };
-    } else {
-      reply = { jsonrpc: "2.0", id, error: { code: -32601, message: `Method not found: ${request.method}` } };
-    }
-    const result = await this.post(JSON.stringify(reply));
-    if (!result.ok) this.log(`HTTP ${result.status} answering ${request.method}: ${result.body}`);
-  }
-  async elicit(params) {
-    if (!this.elicitationHandler) return { action: "decline" };
-    try {
-      return await this.elicitationHandler(params);
-    } catch (error) {
-      this.log("Elicitation handler error:", error);
-      return { action: "cancel" };
-    }
-  }
-  closeStream(reason) {
-    const controller = this.stream;
-    this.stream = void 0;
-    controller?.abort();
-    this.rejectPending(reason);
-  }
-  rejectPending(reason) {
-    for (const [id, pending] of this.pending) {
-      clearTimeout(pending.timer);
-      pending.resolve({ jsonrpc: "2.0", id, error: { code: -32e3, message: reason } });
-    }
-    this.pending.clear();
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // POSTING
-  // ═══════════════════════════════════════════════════════════════════
-  /** POST a message and resolve with the response the stream carries for `id`. */
-  async postAndAwait(id, body) {
-    const answer = new Promise((resolve) => {
-      const timer = setTimeout(() => {
-        this.pending.delete(id);
-        resolve({ jsonrpc: "2.0", id, error: { code: -32e3, message: `Request timeout after ${this.timeout}ms` } });
-      }, this.timeout);
-      this.pending.set(id, { resolve, timer });
-    });
-    const result = await this.post(body);
-    if (!result.ok) {
-      const pending = this.pending.get(id);
-      if (pending) {
-        clearTimeout(pending.timer);
-        this.pending.delete(id);
-      }
-      return {
-        jsonrpc: "2.0",
-        id,
-        error: { code: -32e3, message: `HTTP ${result.status}: ${result.statusText}`, data: result.body }
-      };
-    }
-    return answer;
-  }
-  async post(body) {
-    const endpoint = this.messageEndpoint;
-    if (!endpoint) throw new Error("SSE transport has no message endpoint. Call connect() first.");
-    const headers = this.buildHeaders();
-    this.lastRequestHeaders = headers;
-    this.log(`POST ${endpoint}`, body);
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(endpoint, { method: "POST", headers, body, signal: controller.signal });
-      const text = await response.text();
-      return { ok: response.ok, status: response.status, statusText: response.statusText, body: text };
-    } catch (error) {
-      if (isAbortError(error)) {
-        return { ok: false, status: 0, statusText: `timeout after ${this.timeout}ms`, body: "" };
-      }
-      throw error;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // HELPERS
-  // ═══════════════════════════════════════════════════════════════════
-  async requestAnonymousToken() {
-    const url = new URL(this.baseUrl);
-    url.pathname = `${url.pathname.replace(/\/+$/, "")}/oauth/token`;
-    url.search = "";
-    const tokenUrl = url.toString();
-    try {
-      const response = await fetch(tokenUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ grant_type: "anonymous", client_id: crypto.randomUUID(), resource: this.baseUrl })
-      });
-      if (!response.ok) {
-        this.log(`No anonymous token (HTTP ${response.status})`);
-        return;
-      }
-      const token = await response.json();
-      if (token.access_token) this.authToken = token.access_token;
-    } catch (error) {
-      this.log("Error requesting anonymous token:", error);
-    }
-  }
-  /** `<baseUrl><entryPath>/sse`, built from URL parts so query params on `baseUrl` survive. */
-  sseUrl() {
-    const url = new URL(this.baseUrl);
-    const entry = (this.entryPath ?? "").replace(/^\/+|\/+$/g, "");
-    const basePath = url.pathname.replace(/\/+$/, "");
-    url.pathname = entry ? `${basePath}/${entry}/sse` : `${basePath}/sse`;
-    return url.toString();
-  }
-  buildHeaders() {
-    const headers = {
-      "Content-Type": "application/json",
-      Accept: "application/json, text/event-stream"
-    };
-    if (this.clientInfo) headers["User-Agent"] = `${this.clientInfo.name}/${this.clientInfo.version}`;
-    if (this.authToken) headers["Authorization"] = `Bearer ${this.authToken}`;
-    if (this.sessionId) headers["mcp-session-id"] = this.sessionId;
-    Object.assign(headers, this.authHeaders);
-    return headers;
-  }
-  ensureConnected() {
-    if (this.state !== "connected") {
-      throw new Error("Transport not connected. Call connect() first.");
-    }
-  }
-  log(message, data) {
-    if (this.debug) {
-      console.log(`[SSE] ${message}`, data ?? "");
-    }
-  }
-};
-function splitSSEEvents(buffer) {
-  const endsWithCarriageReturn = buffer.endsWith("\r");
-  const normalized = (endsWithCarriageReturn ? buffer.slice(0, -1) : buffer).replace(/\r\n?/g, "\n");
-  const completeEvents = normalized.split("\n\n");
-  const remainder = completeEvents.pop() ?? "";
-  return { completeEvents, remainder: endsWithCarriageReturn ? `${remainder}\r` : remainder };
-}
-function parseSSEEvent(text) {
-  let type = "message";
-  const data = [];
-  for (const line of text.split("\n")) {
-    if (line.startsWith(":")) continue;
-    const colon = line.indexOf(":");
-    const field = colon === -1 ? line : line.slice(0, colon);
-    const value = colon === -1 ? "" : line.slice(colon + 1).replace(/^ /, "");
-    if (field === "event") type = value;
-    else if (field === "data") data.push(value);
-  }
-  return data.length > 0 ? { type, data: data.join("\n") } : void 0;
-}
-
-// libs/testing/src/transport/streamable-http.transport.ts
-var DEFAULT_TIMEOUT2 = 3e4;
-var NOTIFICATION_STREAM_REOPEN_DELAY_MS = 250;
-var StreamableHttpTransport = class {
-  config;
-  state = "disconnected";
-  sessionId;
-  authToken;
-  connectionCount = 0;
-  reconnectCount = 0;
-  lastRequestHeaders = {};
-  interceptors;
-  publicMode;
-  elicitationHandler;
-  notificationHandler;
-  notificationStream;
-  notificationProtocolVersion = "";
-  notificationStreamReopenTimer;
-  constructor(config) {
-    this.config = {
-      baseUrl: config.baseUrl.replace(/\/$/, ""),
-      // Remove trailing slash
-      entryPath: config.entryPath,
-      timeout: config.timeout ?? DEFAULT_TIMEOUT2,
-      auth: config.auth ?? {},
-      publicMode: config.publicMode ?? false,
-      debug: config.debug ?? false,
-      interceptors: config.interceptors,
-      clientInfo: config.clientInfo
-    };
-    this.authToken = config.auth?.token;
-    this.interceptors = config.interceptors;
-    this.publicMode = config.publicMode ?? false;
-    this.elicitationHandler = config.elicitationHandler;
-    this.notificationHandler = config.notificationHandler;
-  }
-  async connect() {
-    this.state = "connecting";
-    this.connectionCount++;
-    try {
-      if (this.publicMode) {
-        this.log("Public mode: connecting without authentication");
-        this.state = "connected";
-        return;
-      }
-      if (!this.authToken) {
-        await this.requestAnonymousToken();
-      }
-      this.state = "connected";
-      this.log("Connected to StreamableHTTP transport");
-    } catch (error) {
-      this.state = "error";
-      throw error;
-    }
-  }
-  /**
-   * Request an anonymous token from the FrontMCP OAuth endpoint
-   * This allows the test client to authenticate without user interaction
-   */
-  async requestAnonymousToken() {
-    const clientId = crypto.randomUUID();
-    const tokenUrl = `${this.config.baseUrl}/oauth/token`;
-    this.log(`Requesting anonymous token from ${tokenUrl}`);
-    try {
-      const response = await fetch(tokenUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({
-          grant_type: "anonymous",
-          client_id: clientId,
-          resource: this.config.baseUrl
-        })
-      });
-      if (!response.ok) {
-        const errorText = await response.text();
-        this.log(`Failed to get anonymous token: ${response.status} ${errorText}`);
-        return;
-      }
-      const tokenResponse = await response.json();
-      if (tokenResponse.access_token) {
-        this.authToken = tokenResponse.access_token;
-        this.log("Anonymous token acquired successfully");
-      }
-    } catch (error) {
-      this.log(`Error requesting anonymous token: ${error}`);
-    }
-  }
-  async request(message) {
-    this.ensureConnected();
-    const startTime = Date.now();
-    if (this.interceptors) {
-      const interceptResult = await this.interceptors.processRequest(message, {
-        timestamp: /* @__PURE__ */ new Date(),
-        transport: "streamable-http",
-        sessionId: this.sessionId
-      });
-      switch (interceptResult.type) {
-        case "mock": {
-          const mockResponse2 = await this.interceptors.processResponse(
-            message,
-            interceptResult.response,
-            Date.now() - startTime
-          );
-          return mockResponse2;
-        }
-        case "error":
-          throw markInterceptedError(interceptResult.error);
-        case "continue":
-          message = interceptResult.request;
-          break;
-      }
-    }
-    const headers = this.buildHeaders();
-    this.lastRequestHeaders = headers;
-    const url = this.mcpUrl();
-    this.log(`POST ${url}`, message);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers,
-        body: JSON.stringify(message),
-        signal: controller.signal
-      });
-      const newSessionId = response.headers.get("mcp-session-id");
-      if (newSessionId) {
-        this.sessionId = newSessionId;
-      }
-      let jsonResponse;
-      if (!response.ok) {
-        const errorText = await response.text();
-        this.log(`HTTP Error ${response.status}: ${errorText}`);
-        jsonResponse = {
-          jsonrpc: "2.0",
-          id: message.id ?? null,
-          error: {
-            code: -32e3,
-            message: `HTTP ${response.status}: ${response.statusText}`,
-            data: errorText
-          }
-        };
-      } else {
-        const contentType = response.headers.get("content-type") ?? "";
-        if (contentType.includes("text/event-stream")) {
-          jsonResponse = await this.handleSSEResponseWithElicitation(response, message);
-        } else {
-          const text = await response.text();
-          this.log("Response:", text);
-          if (!text.trim()) {
-            jsonResponse = {
-              jsonrpc: "2.0",
-              id: message.id ?? null,
-              result: void 0
-            };
-          } else {
-            jsonResponse = JSON.parse(text);
-          }
-        }
-      }
-      if (this.interceptors) {
-        jsonResponse = await this.interceptors.processResponse(message, jsonResponse, Date.now() - startTime);
-      }
-      clearTimeout(timeoutId);
-      return jsonResponse;
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (isAbortError(error)) {
-        return {
-          jsonrpc: "2.0",
-          id: message.id ?? null,
-          error: {
-            code: -32e3,
-            message: `Request timeout after ${this.config.timeout}ms`
-          }
-        };
-      }
-      throw error;
-    }
-  }
-  async notify(message) {
-    this.ensureConnected();
-    const headers = this.buildHeaders();
-    this.lastRequestHeaders = headers;
-    const url = this.mcpUrl();
-    this.log(`POST ${url} (notification)`, message);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers,
-        body: JSON.stringify(message),
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      const newSessionId = response.headers.get("mcp-session-id");
-      if (newSessionId) {
-        this.sessionId = newSessionId;
-      }
-      if (!response.ok) {
-        const errorText = await response.text();
-        this.log(`HTTP Error ${response.status} on notification: ${errorText}`);
-      }
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (!isAbortError(error)) {
-        throw error;
-      }
-    }
-  }
-  async sendRaw(data) {
-    this.ensureConnected();
-    const headers = this.buildHeaders();
-    this.lastRequestHeaders = headers;
-    const url = this.mcpUrl();
-    this.log(`POST ${url} (raw)`, data);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "POST",
-        headers,
-        body: data,
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      const text = await response.text();
-      if (!text.trim()) {
-        return {
-          jsonrpc: "2.0",
-          id: null,
-          error: {
-            code: -32700,
-            message: "Parse error"
-          }
-        };
-      }
-      return JSON.parse(text);
-    } catch (error) {
-      clearTimeout(timeoutId);
-      return {
-        jsonrpc: "2.0",
-        id: null,
-        error: {
-          code: -32700,
-          message: "Parse error",
-          data: errorMessage(error)
-        }
-      };
-    }
-  }
-  async openNotificationStream(protocolVersion) {
-    this.notificationProtocolVersion = protocolVersion;
-    await this.connectNotificationStream();
-  }
-  async close() {
-    this.closeNotificationStream();
-    this.state = "disconnected";
-    this.sessionId = void 0;
-    this.log("StreamableHTTP transport closed");
-  }
-  isConnected() {
-    return this.state === "connected";
-  }
-  getState() {
-    return this.state;
-  }
-  getSessionId() {
-    return this.sessionId;
-  }
-  setAuthToken(token) {
-    this.authToken = token;
-  }
-  setTimeout(ms) {
-    this.config.timeout = ms;
-  }
-  setInterceptors(interceptors2) {
-    this.interceptors = interceptors2;
-  }
-  getInterceptors() {
-    return this.interceptors;
-  }
-  setElicitationHandler(handler) {
-    this.elicitationHandler = handler;
-  }
-  getConnectionCount() {
-    return this.connectionCount;
-  }
-  getReconnectCount() {
-    return this.reconnectCount;
-  }
-  getLastRequestHeaders() {
-    return { ...this.lastRequestHeaders };
-  }
-  async simulateDisconnect() {
-    this.closeNotificationStream();
-    this.state = "disconnected";
-    this.sessionId = void 0;
-  }
-  async waitForReconnect(timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    this.reconnectCount++;
-    await this.connect();
-    while (Date.now() < deadline) {
-      if (this.state === "connected") {
-        return;
-      }
-      await new Promise((r) => setTimeout(r, 50));
-    }
-    throw new Error("Timeout waiting for reconnection");
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE HELPERS
-  // ═══════════════════════════════════════════════════════════════════
-  closeNotificationStream() {
-    clearTimeout(this.notificationStreamReopenTimer);
-    this.notificationStream?.abort();
-    this.notificationStream = void 0;
-  }
-  /** Opens the stream without holding up the caller past the request timeout; close() aborts it at any point. */
-  async connectNotificationStream() {
-    if (!this.sessionId || this.notificationStream) return;
-    const controller = new AbortController();
-    this.notificationStream = controller;
-    const { "Content-Type": _contentType, ...headers } = this.buildHeaders();
-    const established = fetch(this.mcpUrl(), {
-      method: "GET",
-      headers: { ...headers, Accept: "text/event-stream", "MCP-Protocol-Version": this.notificationProtocolVersion },
-      signal: controller.signal
-    }).then(
-      async (response) => {
-        const isEventStream = response.headers.get("content-type")?.includes("text/event-stream") ?? false;
-        if (!response.ok || !response.body || !isEventStream) {
-          await response.body?.cancel();
-          this.log(`Server offers no notification stream (HTTP ${response.status})`);
-          this.releaseNotificationStream(controller);
-          return;
-        }
-        void this.readNotificationStream(controller, response.body.getReader());
-      },
-      (error) => {
-        this.log("Failed to open the notification stream:", error);
-        this.releaseNotificationStream(controller);
-      }
-    );
-    let establishTimer;
-    const establishDeadline = new Promise((resolve) => {
-      establishTimer = setTimeout(resolve, this.config.timeout);
-    });
-    await Promise.race([established, establishDeadline]);
-    clearTimeout(establishTimer);
-  }
-  releaseNotificationStream(controller) {
-    if (this.notificationStream === controller) this.notificationStream = void 0;
-  }
-  async readNotificationStream(controller, reader) {
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-      for (let chunk = await reader.read(); !chunk.done; chunk = await reader.read()) {
-        const { completeEvents, remainder } = splitSSEEvents2(buffer + decoder.decode(chunk.value, { stream: true }));
-        buffer = remainder;
-        for (const eventText of completeEvents) {
-          for (const event of this.parseSSEEvents(eventText, void 0).events) {
-            await this.handleSSEEvent(event);
-          }
-        }
-      }
-    } catch (error) {
-      this.log("Notification stream ended:", error);
-    } finally {
-      reader.releaseLock();
-    }
-    if (controller.signal.aborted || this.notificationStream !== controller) return;
-    this.releaseNotificationStream(controller);
-    this.notificationStreamReopenTimer = setTimeout(
-      () => void this.connectNotificationStream(),
-      NOTIFICATION_STREAM_REOPEN_DELAY_MS
-    );
-  }
-  /**
-   * Handle SSE response with elicitation support.
-   *
-   * Streams the SSE response, detects elicitation/create requests, and handles them
-   * by calling the registered handler and sending the response back to the server.
-   */
-  async handleSSEResponseWithElicitation(response, originalRequest) {
-    this.log("handleSSEResponseWithElicitation: starting", { requestId: originalRequest.id });
-    const reader = response.body?.getReader();
-    if (!reader) {
-      this.log("handleSSEResponseWithElicitation: no response body");
-      return {
-        jsonrpc: "2.0",
-        id: originalRequest.id ?? null,
-        error: { code: -32e3, message: "No response body" }
-      };
-    }
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let finalResponse = null;
-    let sseSessionId;
-    try {
-      let readCount = 0;
-      while (true) {
-        readCount++;
-        this.log(`handleSSEResponseWithElicitation: reading chunk ${readCount}`);
-        const { done, value } = await reader.read();
-        this.log(`handleSSEResponseWithElicitation: read result`, { done, valueLength: value?.length });
-        if (done) {
-          if (buffer.trim()) {
-            const parsed = this.parseSSEEvents(buffer, originalRequest.id);
-            for (const event of parsed.events) {
-              const handled = await this.handleSSEEvent(event);
-              if (handled.isFinal) {
-                finalResponse = handled.response;
-              }
-            }
-            if (parsed.sessionId && !sseSessionId) {
-              sseSessionId = parsed.sessionId;
-            }
-          }
-          break;
-        }
-        buffer += decoder.decode(value, { stream: true });
-        const eventEndPattern = /\n\n/g;
-        let lastEventEnd = 0;
-        let match;
-        while ((match = eventEndPattern.exec(buffer)) !== null) {
-          const eventText = buffer.slice(lastEventEnd, match.index);
-          lastEventEnd = match.index + 2;
-          if (eventText.trim()) {
-            const parsed = this.parseSSEEvents(eventText, originalRequest.id);
-            for (const event of parsed.events) {
-              const handled = await this.handleSSEEvent(event);
-              if (handled.isFinal) {
-                finalResponse = handled.response;
-              }
-            }
-            if (parsed.sessionId && !sseSessionId) {
-              sseSessionId = parsed.sessionId;
-            }
-          }
-        }
-        buffer = buffer.slice(lastEventEnd);
-      }
-    } finally {
-      reader.releaseLock();
-    }
-    if (sseSessionId && !this.sessionId) {
-      this.sessionId = sseSessionId;
-      this.log("Session ID from SSE:", this.sessionId);
-    }
-    if (finalResponse) {
-      return finalResponse;
-    }
-    return {
-      jsonrpc: "2.0",
-      id: originalRequest.id ?? null,
-      error: { code: -32e3, message: "No final response received in SSE stream" }
-    };
-  }
-  /**
-   * Parse SSE event text into structured events
-   */
-  parseSSEEvents(text, _requestId) {
-    const lines = text.split("\n");
-    const events = [];
-    let currentEvent = { type: "message", data: [] };
-    let sessionId;
-    for (const line of lines) {
-      if (line.startsWith("event: ")) {
-        currentEvent.type = line.slice(7);
-      } else if (line.startsWith("data: ")) {
-        currentEvent.data.push(line.slice(6));
-      } else if (line === "data:") {
-        currentEvent.data.push("");
-      } else if (line.startsWith("id: ")) {
-        const idValue = line.slice(4);
-        currentEvent.id = idValue;
-        const colonIndex = idValue.lastIndexOf(":");
-        if (colonIndex > 0) {
-          sessionId = idValue.substring(0, colonIndex);
-        } else {
-          sessionId = idValue;
-        }
-      } else if (line === "" && currentEvent.data.length > 0) {
-        events.push({
-          type: currentEvent.type,
-          data: currentEvent.data.join("\n"),
-          id: currentEvent.id
-        });
-        currentEvent = { type: "message", data: [] };
-      }
-    }
-    if (currentEvent.data.length > 0) {
-      events.push({
-        type: currentEvent.type,
-        data: currentEvent.data.join("\n"),
-        id: currentEvent.id
-      });
-    }
-    return { events, sessionId };
-  }
-  /**
-   * Handle a single SSE event, including elicitation requests
-   */
-  async handleSSEEvent(event) {
-    this.log("SSE Event:", { type: event.type, data: event.data.slice(0, 200) });
-    try {
-      const parsed = JSON.parse(event.data);
-      if ("method" in parsed && parsed.method === "elicitation/create") {
-        await this.handleElicitationRequest(parsed);
-        return {
-          isFinal: false,
-          response: { jsonrpc: "2.0", id: null, result: void 0 }
-        };
-      }
-      if ("method" in parsed && parsed.id === void 0) {
-        this.notificationHandler?.(parsed);
-        return {
-          isFinal: false,
-          response: { jsonrpc: "2.0", id: null, result: void 0 }
-        };
-      }
-      if ("result" in parsed || "error" in parsed) {
-        return { isFinal: true, response: parsed };
-      }
-      return {
-        isFinal: false,
-        response: { jsonrpc: "2.0", id: null, result: void 0 }
-      };
-    } catch {
-      this.log("Failed to parse SSE event data:", event.data);
-      return {
-        isFinal: false,
-        response: { jsonrpc: "2.0", id: null, result: void 0 }
-      };
-    }
-  }
-  /**
-   * Handle an elicitation/create request from the server
-   */
-  async handleElicitationRequest(request) {
-    const params = request.params;
-    this.log("Elicitation request received:", {
-      mode: params?.mode,
-      message: params?.message?.slice(0, 100)
-    });
-    const requestId = request.id;
-    if (requestId === void 0 || requestId === null) {
-      this.log("Elicitation request has no ID, cannot respond");
-      return;
-    }
-    if (!this.elicitationHandler) {
-      this.log("No elicitation handler registered, sending error");
-      await this.sendElicitationResponse(requestId, {
-        action: "decline"
-      });
-      return;
-    }
-    try {
-      const response = await this.elicitationHandler(params);
-      this.log("Elicitation handler response:", response);
-      await this.sendElicitationResponse(requestId, response);
-    } catch (error) {
-      this.log("Elicitation handler error:", error);
-      await this.sendElicitationResponse(requestId, {
-        action: "cancel"
-      });
-    }
-  }
-  /**
-   * Send an elicitation response back to the server
-   */
-  async sendElicitationResponse(requestId, response) {
-    const headers = this.buildHeaders();
-    const url = this.mcpUrl();
-    const rpcResponse = {
-      jsonrpc: "2.0",
-      id: requestId,
-      result: response
-    };
-    this.log("Sending elicitation response:", rpcResponse);
-    try {
-      const fetchResponse = await fetch(url, {
-        method: "POST",
-        headers,
-        body: JSON.stringify(rpcResponse)
-      });
-      if (!fetchResponse.ok) {
-        this.log(`Elicitation response HTTP error: ${fetchResponse.status}`);
-      }
-    } catch (error) {
-      this.log("Failed to send elicitation response:", error);
-    }
-  }
-  /**
-   * The MCP endpoint URL. `entryPath` is where the server mounts MCP; the
-   * trailing slash is kept because both hosts normalize it and the original
-   * behaviour (`${baseUrl}/`) relied on it (issue #543).
-   */
-  mcpUrl() {
-    const url = new URL(this.config.baseUrl);
-    const entry = (this.config.entryPath ?? "").replace(/^\/+|\/+$/g, "");
-    const basePath = url.pathname.replace(/\/+$/, "");
-    url.pathname = entry ? `${basePath}/${entry}` : `${basePath}/`;
-    return url.toString();
-  }
-  buildHeaders() {
-    const headers = {
-      "Content-Type": "application/json",
-      Accept: "application/json, text/event-stream"
-    };
-    if (this.config.clientInfo) {
-      headers["User-Agent"] = `${this.config.clientInfo.name}/${this.config.clientInfo.version}`;
-    }
-    if (this.authToken) {
-      headers["Authorization"] = `Bearer ${this.authToken}`;
-    }
-    if (this.sessionId) {
-      headers["mcp-session-id"] = this.sessionId;
-    }
-    if (this.config.auth.headers) {
-      Object.assign(headers, this.config.auth.headers);
-    }
-    return headers;
-  }
-  ensureConnected() {
-    if (this.state !== "connected") {
-      throw new Error("Transport not connected. Call connect() first.");
-    }
-  }
-  log(message, data) {
-    if (this.config.debug) {
-      console.log(`[StreamableHTTP] ${message}`, data ?? "");
-    }
-  }
-  /**
-   * Parse SSE (Server-Sent Events) response format with session ID extraction
-   * SSE format is:
-   * event: message
-   * id: sessionId:messageId
-   * data: {"jsonrpc":"2.0",...}
-   *
-   * The id field contains the session ID followed by a colon and the message ID.
-   *
-   * @param text - The raw SSE response text
-   * @param requestId - The original request ID
-   * @returns Object with parsed JSON-RPC response and session ID (if found)
-   */
-  parseSSEResponseWithSession(text, requestId) {
-    const lines = text.split("\n");
-    const dataLines = [];
-    let sseSessionId;
-    for (const line of lines) {
-      if (line.startsWith("data: ")) {
-        dataLines.push(line.slice(6));
-      } else if (line === "data:") {
-        dataLines.push("");
-      } else if (line.startsWith("id: ")) {
-        const idValue = line.slice(4);
-        const colonIndex = idValue.lastIndexOf(":");
-        if (colonIndex > 0) {
-          sseSessionId = idValue.substring(0, colonIndex);
-        } else {
-          sseSessionId = idValue;
-        }
-      }
-    }
-    if (dataLines.length > 0) {
-      const jsonData = dataLines.join("\n");
-      try {
-        return {
-          response: JSON.parse(jsonData),
-          sseSessionId
-        };
-      } catch {
-        this.log("Failed to parse SSE data as JSON:", jsonData);
-      }
-    }
-    return {
-      response: {
-        jsonrpc: "2.0",
-        id: requestId ?? null,
-        error: {
-          code: -32700,
-          message: "Failed to parse SSE response",
-          data: text
-        }
-      },
-      sseSessionId
-    };
-  }
-};
-function splitSSEEvents2(buffer) {
-  const endsWithCarriageReturn = buffer.endsWith("\r");
-  const normalized = (endsWithCarriageReturn ? buffer.slice(0, -1) : buffer).replace(/\r\n?/g, "\n");
-  const completeEvents = normalized.split("\n\n");
-  const remainder = completeEvents.pop() ?? "";
-  return { completeEvents, remainder: endsWithCarriageReturn ? `${remainder}\r` : remainder };
-}
-
-// libs/testing/src/platform/platform-client-info.ts
-var MCP_APPS_EXTENSION_KEY = "io.modelcontextprotocol/ui";
-function getPlatformClientInfo(platform) {
-  switch (platform) {
-    case "openai":
-      return {
-        name: "ChatGPT",
-        version: "1.0"
-      };
-    case "ext-apps":
-      return {
-        name: "mcp-ext-apps",
-        version: "1.0"
-      };
-    case "claude":
-      return {
-        name: "claude-desktop",
-        version: "1.0"
-      };
-    case "cursor":
-      return {
-        name: "cursor",
-        version: "1.0"
-      };
-    case "continue":
-      return {
-        name: "continue",
-        version: "1.0"
-      };
-    case "cody":
-      return {
-        name: "cody",
-        version: "1.0"
-      };
-    case "gemini":
-      return {
-        name: "gemini",
-        version: "1.0"
-      };
-    case "generic-mcp":
-      return {
-        name: "generic-mcp-client",
-        version: "1.0"
-      };
-    case "unknown":
-    default:
-      return {
-        name: "mcp-test-client",
-        version: "1.0"
-      };
-  }
-}
-function getPlatformCapabilities(platform) {
-  const baseCapabilities = {
-    sampling: {},
-    // Include elicitation.form by default for testing elicitation workflows
-    // Note: MCP SDK expects form to be an object, not boolean
-    elicitation: {
-      form: {}
-    }
-  };
-  if (platform === "ext-apps") {
-    return {
-      ...baseCapabilities,
-      experimental: {
-        [MCP_APPS_EXTENSION_KEY]: {
-          mimeTypes: ["text/html;profile=mcp-app"]
-        }
-      }
-    };
-  }
-  return baseCapabilities;
-}
-
-// libs/testing/src/client/mcp-test-client.builder.ts
-var McpTestClientBuilder = class {
-  config;
-  constructor(config) {
-    this.config = { ...config };
-  }
-  /**
-   * Set the authentication configuration
-   */
-  withAuth(auth) {
-    this.config.auth = { ...this.config.auth, ...auth };
-    return this;
-  }
-  /**
-   * Set the bearer token for authentication
-   */
-  withToken(token) {
-    this.config.auth = { ...this.config.auth, token };
-    return this;
-  }
-  /**
-   * Add custom headers to all requests
-   */
-  withHeaders(headers) {
-    this.config.auth = {
-      ...this.config.auth,
-      headers: { ...this.config.auth?.headers, ...headers }
-    };
-    return this;
-  }
-  /**
-   * Set the transport type
-   */
-  withTransport(transport) {
-    this.config.transport = transport;
-    return this;
-  }
-  /**
-   * Set the request timeout in milliseconds
-   */
-  withTimeout(timeoutMs) {
-    this.config.timeout = timeoutMs;
-    return this;
-  }
-  /**
-   * Enable debug logging
-   */
-  withDebug(enabled = true) {
-    this.config.debug = enabled;
-    return this;
-  }
-  /**
-   * Enable public mode - skip authentication entirely.
-   * When true, no Authorization header is sent and anonymous token is not requested.
-   * Use this for testing public/unauthenticated endpoints in CI/CD pipelines.
-   */
-  withPublicMode(enabled = true) {
-    this.config.publicMode = enabled;
-    return this;
-  }
-  /**
-   * Set the MCP protocol version to request (default '2025-06-18').
-   * '2026-07-28' has no initialize handshake, so `build()` throws for it.
-   */
-  withProtocolVersion(version) {
-    this.config.protocolVersion = version;
-    return this;
-  }
-  /**
-   * Set the client info sent during initialization
-   */
-  withClientInfo(info) {
-    this.config.clientInfo = info;
-    return this;
-  }
-  /**
-   * Set the platform type for testing platform-specific meta keys.
-   * Automatically configures clientInfo and capabilities for platform detection.
-   *
-   * Platform-specific behavior:
-   * - `openai`: Uses openai/* meta keys, sets User-Agent to "ChatGPT/1.0"
-   * - `ext-apps`: Uses ui/* meta keys per SEP-1865, sets io.modelcontextprotocol/ui capability
-   * - `claude`: Uses frontmcp/* + ui/* keys, sets User-Agent to "claude-desktop/1.0"
-   * - `cursor`: Uses frontmcp/* + ui/* keys, sets User-Agent to "cursor/1.0"
-   * - Other platforms follow similar patterns
-   *
-   * @example
-   * ```typescript
-   * const client = await McpTestClient.create({ baseUrl })
-   *   .withPlatform('openai')
-   *   .buildAndConnect();
-   *
-   * // ext-apps automatically sets the io.modelcontextprotocol/ui capability
-   * const extAppsClient = await McpTestClient.create({ baseUrl })
-   *   .withPlatform('ext-apps')
-   *   .buildAndConnect();
-   * ```
-   */
-  withPlatform(platform) {
-    this.config.platform = platform;
-    this.config.clientInfo = getPlatformClientInfo(platform);
-    this.config.capabilities = getPlatformCapabilities(platform);
-    return this;
-  }
-  /**
-   * Set custom client capabilities for MCP initialization.
-   * Use this for fine-grained control over capabilities sent during initialization.
-   *
-   * @example
-   * ```typescript
-   * const client = await McpTestClient.create({ baseUrl })
-   *   .withCapabilities({
-   *     sampling: {},
-   *     experimental: {
-   *       'io.modelcontextprotocol/ui': { mimeTypes: ['text/html;profile=mcp-app'] }
-   *     }
-   *   })
-   *   .buildAndConnect();
-   * ```
-   */
-  withCapabilities(capabilities) {
-    this.config.capabilities = capabilities;
-    return this;
-  }
-  /**
-   * Set query parameters to append to the connection URL.
-   * Useful for testing mode switches like `?mode=skills_only`.
-   *
-   * @example
-   * ```typescript
-   * const client = await McpTestClient.create({ baseUrl })
-   *   .withQueryParams({ mode: 'skills_only' })
-   *   .buildAndConnect();
-   * ```
-   */
-  withQueryParams(params) {
-    this.config.queryParams = { ...this.config.queryParams, ...params };
-    return this;
-  }
-  /**
-   * Build the McpTestClient instance (does not connect)
-   */
-  build() {
-    return new McpTestClient(this.config);
-  }
-  /**
-   * Build the McpTestClient and connect to the server
-   */
-  async buildAndConnect() {
-    const client = this.build();
-    await client.connect();
-    return client;
-  }
-};
-
-// libs/testing/src/client/mcp-test-client.ts
-var DEFAULT_TIMEOUT3 = 3e4;
-var DEFAULT_PROTOCOL_VERSION = "2025-06-18";
-var UNSUPPORTED_PROTOCOL_VERSIONS = ["2026-07-28"];
-var DEFAULT_CLIENT_INFO = {
-  name: "@frontmcp/testing",
-  version: "0.4.0"
-};
-var MAX_LIST_PAGES = 1e3;
-function isAuthFailure(error) {
-  return typeof error?.message === "string" && /^HTTP (401|403)\b/.test(error.message);
-}
-function describeInitializeError(error) {
-  const message = error?.message ?? "Unknown error";
-  const data = error?.data;
-  const detail = typeof data === "string" ? data.trim() : "";
-  return detail ? `${message} - ${detail.slice(0, 500)}` : message;
-}
-function extractEntryPaths(data) {
-  let payload = data;
-  if (typeof payload === "string") {
-    try {
-      payload = JSON.parse(payload);
-    } catch {
-      return void 0;
-    }
-  }
-  if (!payload || typeof payload !== "object") return void 0;
-  const paths = payload.entryPaths;
-  if (!Array.isArray(paths)) return void 0;
-  const strings = paths.filter((p) => typeof p === "string");
-  return strings.length > 0 ? strings : void 0;
-}
-var McpTestClient = class {
-  // Platform, capabilities, and queryParams are optional - only set when needed
-  config;
-  transport = null;
-  initResult = null;
-  requestIdCounter = 0;
-  _lastRequestId = 0;
-  _sessionId;
-  /** #543 — discovery is attempted at most once per connect. */
-  triedDiscoveredEntryPath = false;
-  _sessionInfo = null;
-  _authState = { isAnonymous: true, scopes: [] };
-  // Logging and tracing
-  _logs = [];
-  _traces = [];
-  _notifications = [];
-  _progressUpdates = [];
-  collectingProgress = false;
-  progressTokenCounter = 0;
-  // Interceptor chain
-  _interceptors;
-  // Elicitation handler for server→client elicit requests
-  _elicitationHandler;
-  // ═══════════════════════════════════════════════════════════════════
-  // CONSTRUCTOR & FACTORY
-  // ═══════════════════════════════════════════════════════════════════
-  constructor(config) {
-    if (config.protocolVersion && UNSUPPORTED_PROTOCOL_VERSIONS.includes(config.protocolVersion)) {
-      throw new Error(
-        `McpTestClient does not support protocol version ${config.protocolVersion}: it has no initialize handshake. Use ${DEFAULT_PROTOCOL_VERSION} or earlier.`
-      );
-    }
-    this.config = {
-      baseUrl: config.baseUrl,
-      entryPath: config.entryPath,
-      transport: config.transport ?? "streamable-http",
-      auth: config.auth ?? {},
-      publicMode: config.publicMode ?? false,
-      timeout: config.timeout ?? DEFAULT_TIMEOUT3,
-      debug: config.debug ?? false,
-      protocolVersion: config.protocolVersion ?? DEFAULT_PROTOCOL_VERSION,
-      clientInfo: config.clientInfo ?? DEFAULT_CLIENT_INFO,
-      platform: config.platform,
-      capabilities: config.capabilities,
-      queryParams: config.queryParams
-    };
-    if (config.auth?.token) {
-      this._authState = {
-        isAnonymous: false,
-        token: config.auth.token,
-        scopes: this.parseScopesFromToken(config.auth.token),
-        user: this.parseUserFromToken(config.auth.token)
-      };
-    }
-    this._interceptors = new DefaultInterceptorChain();
-  }
-  /**
-   * Create a new McpTestClientBuilder for fluent configuration
-   */
-  static create(config) {
-    return new McpTestClientBuilder(config);
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // CONNECTION & LIFECYCLE
-  // ═══════════════════════════════════════════════════════════════════
-  /**
-   * Connect to the MCP server and perform initialization
-   */
-  async connect() {
-    this.log("debug", `Connecting to ${this.config.baseUrl}...`);
-    this.triedDiscoveredEntryPath = false;
-    this.initResult = null;
-    this.transport = this.createTransport();
-    await this.transport.connect();
-    const maxRetries = 3;
-    const retryDelayMs = 500;
-    let lastError;
-    let reportedEntryPaths;
-    let attemptsMade = 0;
-    for (let attempt = 1; attempt <= maxRetries; attempt++) {
-      attemptsMade = attempt;
-      const initResponse = await this.initialize();
-      if (initResponse.success && initResponse.data) {
-        this.initResult = initResponse.data;
-        break;
-      }
-      lastError = describeInitializeError(initResponse.error);
-      reportedEntryPaths = extractEntryPaths(initResponse.error?.data) ?? reportedEntryPaths;
-      if (reportedEntryPaths?.length === 1 && !this.triedDiscoveredEntryPath) {
-        this.triedDiscoveredEntryPath = true;
-        const discovered = reportedEntryPaths[0];
-        this.log("info", `Server serves MCP at ${discovered}; reconnecting there (configured: ${this.mcpPathLabel()})`);
-        this.config.entryPath = discovered;
-        await this.transport.close();
-        this.transport = this.createTransport();
-        await this.transport.connect();
-        continue;
-      }
-      if (isAuthFailure(initResponse.error)) break;
-      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) {
-      const served = reportedEntryPaths?.length ? ` The server reports it serves MCP at ${reportedEntryPaths.join(", ")}; set \`entryPath\` in test.use() (or \`http.entryPath\` on the server) to match.` : "";
-      throw new Error(
-        `Failed to initialize MCP connection to ${this.config.baseUrl}${this.mcpPathLabel()} after ${attemptsMade} attempt${attemptsMade === 1 ? "" : "s"}: ${lastError}.${served}`
-      );
-    }
-    this._sessionId = this.transport.getSessionId();
-    this._sessionInfo = {
-      id: this._sessionId ?? `session-${Date.now()}`,
-      createdAt: /* @__PURE__ */ new Date(),
-      lastActivityAt: /* @__PURE__ */ new Date(),
-      requestCount: 1
-    };
-    await this.transport.notify({
-      jsonrpc: "2.0",
-      method: "notifications/initialized"
-    });
-    await this.transport.openNotificationStream?.(this.initResult.protocolVersion);
-    this.log("info", `Connected to ${this.initResult.serverInfo?.name ?? "MCP Server"}`);
-    return this.initResult;
-  }
-  /**
-   * Disconnect from the MCP server
-   */
-  async disconnect() {
-    if (this.transport) {
-      await this.transport.close();
-      this.transport = null;
-    }
-    this.initResult = null;
-    this.log("info", "Disconnected from MCP server");
-  }
-  /**
-   * Reconnect to the server, optionally with an existing session ID
-   */
-  async reconnect(options) {
-    await this.disconnect();
-    if (options?.sessionId && this.transport) {
-      this._sessionId = options.sessionId;
-    }
-    await this.connect();
-  }
-  /**
-   * Check if the client is currently connected
-   */
-  isConnected() {
-    return this.transport?.isConnected() ?? false;
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // SESSION & AUTH PROPERTIES
-  // ═══════════════════════════════════════════════════════════════════
-  get sessionId() {
-    return this._sessionId ?? "";
-  }
-  get session() {
-    const info = this._sessionInfo ?? {
-      id: "",
-      createdAt: /* @__PURE__ */ new Date(),
-      lastActivityAt: /* @__PURE__ */ new Date(),
-      requestCount: 0
-    };
-    return {
-      ...info,
-      expire: async () => {
-        this._sessionId = void 0;
-        this._sessionInfo = null;
-      }
-    };
-  }
-  get auth() {
-    return this._authState;
-  }
-  /**
-   * Authenticate with a token.
-   *
-   * When connected, this opens a NEW session with the token (the previous session was created
-   * for the previous identity) and rejects if the server refuses it — for example because the
-   * token is expired or badly signed. On rejection the client keeps its previous identity and
-   * session. The token is kept in the client config, so `reconnect()` keeps using it.
-   */
-  async authenticate(token) {
-    if (typeof token !== "string" || token.trim() === "") {
-      throw new Error("authenticate() requires a non-empty token");
-    }
-    const previousAuthState = this._authState;
-    const previousConfigAuth = this.config.auth;
-    this.config.auth = { ...previousConfigAuth, token };
-    this._authState = {
-      isAnonymous: false,
-      token,
-      scopes: this.parseScopesFromToken(token),
-      user: this.parseUserFromToken(token)
-    };
-    const previousTransport = this.transport;
-    if (!previousTransport) {
-      this.log("debug", "Authentication updated (not connected yet)");
-      return;
-    }
-    const previousInit = this.initResult;
-    const previousSessionId = this._sessionId;
-    const previousSessionInfo = this._sessionInfo;
-    try {
-      await this.connect();
-    } catch (err) {
-      await this.transport?.close().catch(() => void 0);
-      this.transport = previousTransport;
-      this.initResult = previousInit;
-      this._sessionId = previousSessionId;
-      this._sessionInfo = previousSessionInfo;
-      this.config.auth = previousConfigAuth;
-      this._authState = previousAuthState;
-      throw err;
-    }
-    await previousTransport.close().catch(() => void 0);
-    this.log("debug", "Authentication updated");
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // SERVER INFO & CAPABILITIES
-  // ═══════════════════════════════════════════════════════════════════
-  get serverInfo() {
-    return {
-      name: this.initResult?.serverInfo?.name ?? "",
-      version: this.initResult?.serverInfo?.version ?? ""
-    };
-  }
-  get protocolVersion() {
-    return this.initResult?.protocolVersion ?? "";
-  }
-  get instructions() {
-    return this.initResult?.instructions ?? "";
-  }
-  get capabilities() {
-    return this.initResult?.capabilities ?? {};
-  }
-  /**
-   * Check if server has a specific capability
-   */
-  hasCapability(name) {
-    return !!this.capabilities[name];
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // TOOLS API
-  // ═══════════════════════════════════════════════════════════════════
-  tools = {
-    /**
-     * List all available tools
-     */
-    list: async () => this.listAllPages(
-      "tools/list",
-      "tools",
-      (cursor) => this.listTools(cursor),
-      (page) => page.tools
-    ),
-    /**
-     * Call a tool by name with arguments
-     */
-    call: async (name, args, options = {}) => {
-      const response = await this.callTool(name, args, this.progressTokenFor(options));
-      return this.wrapToolResult(response);
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // RESOURCES API
-  // ═══════════════════════════════════════════════════════════════════
-  resources = {
-    /**
-     * List all static resources
-     */
-    list: async () => this.listAllPages(
-      "resources/list",
-      "resources",
-      (cursor) => this.listResources(cursor),
-      (page) => page.resources
-    ),
-    /**
-     * List all resource templates
-     */
-    listTemplates: async () => this.listAllPages(
-      "resources/templates/list",
-      "resource templates",
-      (cursor) => this.listResourceTemplates(cursor),
-      (page) => page.resourceTemplates
-    ),
-    /**
-     * Read a resource by URI
-     */
-    read: async (uri) => {
-      const response = await this.readResource(uri);
-      return this.wrapResourceContent(response);
-    },
-    /**
-     * Subscribe to resource changes (placeholder for future implementation)
-     */
-    subscribe: async (_uri) => {
-      this.log("warn", "Resource subscription not yet implemented");
-    },
-    /**
-     * Unsubscribe from resource changes (placeholder for future implementation)
-     */
-    unsubscribe: async (_uri) => {
-      this.log("warn", "Resource unsubscription not yet implemented");
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // PROMPTS API
-  // ═══════════════════════════════════════════════════════════════════
-  prompts = {
-    /**
-     * List all available prompts
-     */
-    list: async () => this.listAllPages(
-      "prompts/list",
-      "prompts",
-      (cursor) => this.listPrompts(cursor),
-      (page) => page.prompts
-    ),
-    /**
-     * Get a prompt with arguments
-     */
-    get: async (name, args) => {
-      const response = await this.getPrompt(name, args);
-      return this.wrapPromptResult(response);
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // RAW PROTOCOL ACCESS
-  // ═══════════════════════════════════════════════════════════════════
-  raw = {
-    /**
-     * Send any JSON-RPC request
-     */
-    request: async (message) => {
-      const transport = this.getConnectedTransport();
-      const start = Date.now();
-      const response = await transport.request(message);
-      this.traceRequest(message.method, message.params, message.id, response, Date.now() - start);
-      return response;
-    },
-    /**
-     * Send a notification (no response expected)
-     */
-    notify: async (message) => {
-      const transport = this.getConnectedTransport();
-      await transport.notify(message);
-    },
-    /**
-     * Send raw string data (for error testing)
-     */
-    sendRaw: async (data) => {
-      const transport = this.getConnectedTransport();
-      return transport.sendRaw(data);
-    }
-  };
-  get lastRequestId() {
-    return this._lastRequestId;
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // TRANSPORT INFO
-  // ═══════════════════════════════════════════════════════════════════
-  /**
-   * Get transport information and utilities
-   */
-  get transport_info() {
-    return {
-      type: this.config.transport,
-      isConnected: () => this.transport?.isConnected() ?? false,
-      messageEndpoint: this.transport?.getMessageEndpoint?.(),
-      connectionCount: this.transport?.getConnectionCount?.() ?? 0,
-      reconnectCount: this.transport?.getReconnectCount?.() ?? 0,
-      lastRequestHeaders: this.transport?.getLastRequestHeaders?.() ?? {},
-      simulateDisconnect: async () => {
-        await this.transport?.simulateDisconnect?.();
-      },
-      waitForReconnect: async (timeoutMs) => {
-        await this.transport?.waitForReconnect?.(timeoutMs);
-      }
-    };
-  }
-  // Alias for transport info
-  get transport_() {
-    return this.transport_info;
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // NOTIFICATIONS
-  // ═══════════════════════════════════════════════════════════════════
-  notifications = {
-    /**
-     * Start collecting server notifications
-     */
-    collect: () => {
-      return new NotificationCollector(this._notifications);
-    },
-    /**
-     * Collect progress notifications specifically
-     */
-    collectProgress: () => {
-      this.collectingProgress = true;
-      return new ProgressCollector(this._progressUpdates);
-    },
-    /**
-     * Send a notification to the server
-     */
-    send: async (method, params) => {
-      await this.raw.notify({ jsonrpc: "2.0", method, params });
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // ELICITATION
-  // ═══════════════════════════════════════════════════════════════════
-  /**
-   * Register a handler for elicitation requests from the server.
-   *
-   * When a tool calls `this.elicit()` during execution, the server sends an
-   * `elicitation/create` request to the client. This handler is called to
-   * provide the response that would normally come from user interaction.
-   *
-   * @param handler - Function that receives the elicitation request and returns a response
-   *
-   * @example
-   * ```typescript
-   * // Simple acceptance
-   * mcp.onElicitation(async () => ({
-   *   action: 'accept',
-   *   content: { confirmed: true }
-   * }));
-   *
-   * // Conditional response based on request
-   * mcp.onElicitation(async (request) => {
-   *   if (request.message.includes('delete')) {
-   *     return { action: 'decline' };
-   *   }
-   *   return { action: 'accept', content: { approved: true } };
-   * });
-   *
-   * // Multi-step wizard
-   * let step = 0;
-   * mcp.onElicitation(async () => {
-   *   step++;
-   *   if (step === 1) return { action: 'accept', content: { name: 'Alice' } };
-   *   return { action: 'accept', content: { color: 'blue' } };
-   * });
-   * ```
-   */
-  onElicitation(handler) {
-    this._elicitationHandler = handler;
-    if (this.transport?.setElicitationHandler) {
-      this.transport.setElicitationHandler(handler);
-    }
-    this.log("debug", "Elicitation handler registered");
-  }
-  /**
-   * Clear the elicitation handler.
-   *
-   * After calling this, elicitation requests from the server will not be
-   * handled automatically. This can be used to test timeout scenarios.
-   */
-  clearElicitationHandler() {
-    this._elicitationHandler = void 0;
-    if (this.transport?.setElicitationHandler) {
-      this.transport.setElicitationHandler(void 0);
-    }
-    this.log("debug", "Elicitation handler cleared");
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // LOGGING & DEBUGGING
-  // ═══════════════════════════════════════════════════════════════════
-  logs = {
-    all: () => [...this._logs],
-    filter: (level) => this._logs.filter((l) => l.level === level),
-    search: (text) => this._logs.filter((l) => l.message.includes(text)),
-    last: () => this._logs[this._logs.length - 1],
-    clear: () => {
-      this._logs = [];
-    }
-  };
-  trace = {
-    all: () => [...this._traces],
-    last: () => this._traces[this._traces.length - 1],
-    clear: () => {
-      this._traces = [];
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // MOCKING & INTERCEPTION
-  // ═══════════════════════════════════════════════════════════════════
-  /**
-   * API for mocking MCP requests
-   *
-   * @example
-   * ```typescript
-   * // Mock a specific tool call
-   * const handle = mcp.mock.tool('my-tool', { result: 'mocked!' });
-   *
-   * // Mock with params matching
-   * mcp.mock.add({
-   *   method: 'tools/call',
-   *   params: { name: 'my-tool' },
-   *   response: mockResponse.toolResult([{ type: 'text', text: 'mocked' }]),
-   * });
-   *
-   * // Clear all mocks after test
-   * mcp.mock.clear();
-   * ```
-   */
-  mock = {
-    /**
-     * Add a mock definition
-     */
-    add: (mock) => {
-      return this._interceptors.mocks.add(mock);
-    },
-    /**
-     * Mock a tools/call request for a specific tool
-     */
-    tool: (name, result, options) => {
-      return this._interceptors.mocks.add({
-        method: "tools/call",
-        params: { name },
-        response: mockResponse.toolResult([
-          { type: "text", text: typeof result === "string" ? result : JSON.stringify(result) }
-        ]),
-        times: options?.times,
-        delay: options?.delay
-      });
-    },
-    /**
-     * Mock a tools/call request to return an error
-     */
-    toolError: (name, code, message, options) => {
-      return this._interceptors.mocks.add({
-        method: "tools/call",
-        params: { name },
-        response: mockResponse.error(code, message),
-        times: options?.times
-      });
-    },
-    /**
-     * Mock a resources/read request
-     */
-    resource: (uri, content, options) => {
-      const contentObj = typeof content === "string" ? { uri, text: content } : { uri, ...content };
-      return this._interceptors.mocks.add({
-        method: "resources/read",
-        params: { uri },
-        response: mockResponse.resourceRead([contentObj]),
-        times: options?.times,
-        delay: options?.delay
-      });
-    },
-    /**
-     * Mock a resources/read request to return an error
-     */
-    resourceError: (uri, options) => {
-      return this._interceptors.mocks.add({
-        method: "resources/read",
-        params: { uri },
-        response: mockResponse.errors.resourceNotFound(uri),
-        times: options?.times
-      });
-    },
-    /**
-     * Mock the tools/list response
-     */
-    toolsList: (tools, options) => {
-      return this._interceptors.mocks.add({
-        method: "tools/list",
-        response: mockResponse.toolsList(tools),
-        times: options?.times
-      });
-    },
-    /**
-     * Mock the resources/list response
-     */
-    resourcesList: (resources, options) => {
-      return this._interceptors.mocks.add({
-        method: "resources/list",
-        response: mockResponse.resourcesList(resources),
-        times: options?.times
-      });
-    },
-    /**
-     * Clear all mocks
-     */
-    clear: () => {
-      this._interceptors.mocks.clear();
-    },
-    /**
-     * Get all active mocks
-     */
-    all: () => {
-      return this._interceptors.mocks.getAll();
-    }
-  };
-  /**
-   * API for intercepting requests and responses
-   *
-   * @example
-   * ```typescript
-   * // Log all requests
-   * const remove = mcp.intercept.request((ctx) => {
-   *   console.log('Request:', ctx.request.method);
-   *   return { action: 'passthrough' };
-   * });
-   *
-   * // Modify requests
-   * mcp.intercept.request((ctx) => {
-   *   if (ctx.request.method === 'tools/call') {
-   *     return {
-   *       action: 'modify',
-   *       request: { ...ctx.request, params: { ...ctx.request.params, extra: true } },
-   *     };
-   *   }
-   *   return { action: 'passthrough' };
-   * });
-   *
-   * // Add latency to all requests
-   * mcp.intercept.delay(100);
-   *
-   * // Clean up
-   * remove();
-   * mcp.intercept.clear();
-   * ```
-   */
-  intercept = {
-    /**
-     * Add a request interceptor
-     * @returns Function to remove the interceptor
-     */
-    request: (interceptor) => {
-      return this._interceptors.addRequestInterceptor(interceptor);
-    },
-    /**
-     * Add a response interceptor
-     * @returns Function to remove the interceptor
-     */
-    response: (interceptor) => {
-      return this._interceptors.addResponseInterceptor(interceptor);
-    },
-    /**
-     * Add latency to all requests
-     * @returns Function to remove the interceptor
-     */
-    delay: (ms) => {
-      return this._interceptors.addRequestInterceptor(async () => {
-        await new Promise((r) => setTimeout(r, ms));
-        return { action: "passthrough" };
-      });
-    },
-    /**
-     * Fail requests matching a method
-     * @returns Function to remove the interceptor
-     */
-    failMethod: (method, error) => {
-      return this._interceptors.addRequestInterceptor((ctx) => {
-        if (ctx.request.method === method) {
-          return { action: "error", error: new Error(error ?? `Intercepted: ${method}`) };
-        }
-        return { action: "passthrough" };
-      });
-    },
-    /**
-     * Clear all interceptors (but not mocks)
-     */
-    clear: () => {
-      this._interceptors.request = [];
-      this._interceptors.response = [];
-    },
-    /**
-     * Clear everything (interceptors and mocks)
-     */
-    clearAll: () => {
-      this._interceptors.clear();
-    }
-  };
-  // ═══════════════════════════════════════════════════════════════════
-  // TIMEOUT
-  // ═══════════════════════════════════════════════════════════════════
-  setTimeout(ms) {
-    this.config.timeout = ms;
-    if (this.transport) {
-      this.transport.setTimeout(ms);
-    }
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE: MCP OPERATIONS
-  // ═══════════════════════════════════════════════════════════════════
-  async initialize() {
-    const capabilities = this.config.capabilities ?? {
-      sampling: {},
-      elicitation: {
-        form: {}
-      }
-    };
-    return this.request("initialize", {
-      protocolVersion: this.config.protocolVersion,
-      capabilities,
-      clientInfo: this.config.clientInfo
-    });
-  }
-  async listTools(cursor) {
-    return this.request("tools/list", cursor ? { cursor } : {});
-  }
-  /**
-   * Follow `nextCursor` until the server stops returning one, concatenating the
-   * pages. A server that hands back a cursor it already returned, or never stops
-   * paging, fails the call rather than looping.
-   */
-  async listAllPages(method, label, fetchPage, itemsOf) {
-    const items = [];
-    const seenCursors = /* @__PURE__ */ new Set();
-    let cursor;
-    for (let page = 0; page < MAX_LIST_PAGES; page++) {
-      const response = await fetchPage(cursor);
-      if (!response.success || !response.data) {
-        throw new Error(`Failed to list ${label}: ${response.error?.message}`);
-      }
-      items.push(...itemsOf(response.data) ?? []);
-      const next = response.data.nextCursor;
-      if (!next) return items;
-      if (seenCursors.has(next)) {
-        throw new Error(`Failed to list ${label}: ${method} returned the cursor "${next}" twice`);
-      }
-      seenCursors.add(next);
-      cursor = next;
-    }
-    throw new Error(`Failed to list ${label}: ${method} did not finish within ${MAX_LIST_PAGES} pages`);
-  }
-  async callTool(name, args, progressToken) {
-    return this.request("tools/call", {
-      name,
-      arguments: args ?? {},
-      ...progressToken !== void 0 && { _meta: { progressToken } }
-    });
-  }
-  progressTokenFor(options) {
-    if (options.progressToken !== void 0) return options.progressToken;
-    return this.collectingProgress ? `progress-${++this.progressTokenCounter}` : void 0;
-  }
-  recordNotification = (notification) => {
-    const timestamp = /* @__PURE__ */ new Date();
-    this._notifications.push({ method: notification.method, params: notification.params, timestamp });
-    if (notification.method !== "notifications/progress") return;
-    const { progress, total, progressToken } = notification.params ?? {};
-    this._progressUpdates.push({
-      progress: Number(progress),
-      total: typeof total === "number" ? total : void 0,
-      progressToken: typeof progressToken === "string" || typeof progressToken === "number" ? progressToken : void 0,
-      timestamp
-    });
-  };
-  async listResources(cursor) {
-    return this.request("resources/list", cursor ? { cursor } : {});
-  }
-  async listResourceTemplates(cursor) {
-    return this.request("resources/templates/list", cursor ? { cursor } : {});
-  }
-  async readResource(uri) {
-    return this.request("resources/read", { uri });
-  }
-  async listPrompts(cursor) {
-    return this.request("prompts/list", cursor ? { cursor } : {});
-  }
-  async getPrompt(name, args) {
-    return this.request("prompts/get", {
-      name,
-      arguments: args ?? {}
-    });
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE: TRANSPORT & REQUEST HELPERS
-  // ═══════════════════════════════════════════════════════════════════
-  /** The MCP path this client is currently pointed at, for log and error text. */
-  mcpPathLabel() {
-    const entry = (this.config.entryPath ?? "").replace(/^\/+|\/+$/g, "");
-    return entry ? `/${entry}` : "/";
-  }
-  createTransport() {
-    let baseUrl = this.config.baseUrl;
-    if (this.config.queryParams && Object.keys(this.config.queryParams).length > 0) {
-      const url = new URL(baseUrl);
-      Object.entries(this.config.queryParams).forEach(([key, value]) => {
-        url.searchParams.set(key, String(value));
-      });
-      baseUrl = url.toString();
-    }
-    switch (this.config.transport) {
-      case "streamable-http":
-        return new StreamableHttpTransport({
-          baseUrl,
-          entryPath: this.config.entryPath,
-          timeout: this.config.timeout,
-          auth: this.config.auth,
-          publicMode: this.config.publicMode,
-          debug: this.config.debug,
-          interceptors: this._interceptors,
-          clientInfo: this.config.clientInfo,
-          elicitationHandler: this._elicitationHandler,
-          notificationHandler: this.recordNotification
-        });
-      case "sse":
-        return new SseTransport({
-          baseUrl,
-          entryPath: this.config.entryPath,
-          timeout: this.config.timeout,
-          auth: this.config.auth,
-          publicMode: this.config.publicMode,
-          debug: this.config.debug,
-          interceptors: this._interceptors,
-          clientInfo: this.config.clientInfo,
-          elicitationHandler: this._elicitationHandler,
-          notificationHandler: this.recordNotification
-        });
-      default:
-        throw new Error(`Unknown transport type: ${this.config.transport}`);
-    }
-  }
-  async request(method, params) {
-    const transport = this.getConnectedTransport();
-    const id = ++this.requestIdCounter;
-    this._lastRequestId = id;
-    const start = Date.now();
-    try {
-      const response = await transport.request({
-        jsonrpc: "2.0",
-        id,
-        method,
-        params
-      });
-      const durationMs = Date.now() - start;
-      this.updateSessionActivity();
-      if ("error" in response && response.error) {
-        const error = response.error;
-        this.traceRequest(method, params, id, response, durationMs);
-        return {
-          success: false,
-          error,
-          durationMs,
-          requestId: id
-        };
-      }
-      this.traceRequest(method, params, id, response, durationMs);
-      return {
-        success: true,
-        data: response.result,
-        durationMs,
-        requestId: id
-      };
-    } catch (err) {
-      if (isInterceptedError(err)) throw err;
-      const durationMs = Date.now() - start;
-      const error = {
-        code: -32603,
-        message: errorMessage(err)
-      };
-      return {
-        success: false,
-        error,
-        durationMs,
-        requestId: id
-      };
-    }
-  }
-  /**
-   * Get the transport, throwing if not connected.
-   */
-  getConnectedTransport() {
-    if (!this.transport || !this.transport.isConnected()) {
-      throw new Error("Not connected to MCP server. Call connect() first.");
-    }
-    return this.transport;
-  }
-  updateSessionActivity() {
-    if (this._sessionInfo) {
-      this._sessionInfo.lastActivityAt = /* @__PURE__ */ new Date();
-      this._sessionInfo.requestCount++;
-    }
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE: RESULT WRAPPERS
-  // ═══════════════════════════════════════════════════════════════════
-  wrapToolResult(response) {
-    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;
-    const structuredContent = raw["structuredContent"];
-    return {
-      raw,
-      isSuccess: !isError,
-      isError,
-      error: response.error,
-      durationMs: response.durationMs,
-      json() {
-        if (hasUI && structuredContent !== void 0) {
-          return structuredContent;
-        }
-        const textContent = raw.content?.find((c) => c.type === "text");
-        if (textContent && "text" in textContent) {
-          return JSON.parse(textContent.text);
-        }
-        throw new Error("No text content to parse as JSON");
-      },
-      text() {
-        const textContent = raw.content?.find((c) => c.type === "text");
-        if (textContent && "text" in textContent) {
-          return textContent.text;
-        }
-        return void 0;
-      },
-      hasTextContent() {
-        return raw.content?.some((c) => c.type === "text") ?? false;
-      },
-      hasImageContent() {
-        return raw.content?.some((c) => c.type === "image") ?? false;
-      },
-      hasResourceContent() {
-        return raw.content?.some((c) => c.type === "resource") ?? false;
-      },
-      hasToolUI() {
-        return hasUI;
-      }
-    };
-  }
-  wrapResourceContent(response) {
-    const raw = response.data ?? { contents: [] };
-    const isError = !response.success;
-    const firstContent = raw.contents?.[0];
-    return {
-      raw,
-      isSuccess: !isError,
-      isError,
-      error: response.error,
-      durationMs: response.durationMs,
-      json() {
-        if (firstContent && "text" in firstContent) {
-          return JSON.parse(firstContent.text);
-        }
-        throw new Error("No text content to parse as JSON");
-      },
-      text() {
-        if (firstContent && "text" in firstContent) {
-          return firstContent.text;
-        }
-        return void 0;
-      },
-      mimeType() {
-        return firstContent?.mimeType;
-      },
-      hasMimeType(type) {
-        return firstContent?.mimeType === type;
-      }
-    };
-  }
-  wrapPromptResult(response) {
-    const raw = response.data ?? { messages: [] };
-    const isError = !response.success;
-    return {
-      raw,
-      isSuccess: !isError,
-      isError,
-      error: response.error,
-      durationMs: response.durationMs,
-      messages: raw.messages ?? [],
-      description: raw.description
-    };
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE: LOGGING & TRACING
-  // ═══════════════════════════════════════════════════════════════════
-  log(level, message, data) {
-    const entry = {
-      level,
-      message,
-      timestamp: /* @__PURE__ */ new Date(),
-      data
-    };
-    this._logs.push(entry);
-    if (this.config.debug) {
-      console.log(`[${level.toUpperCase()}] ${message}`, data ?? "");
-    }
-  }
-  traceRequest(method, params, id, response, durationMs) {
-    this._traces.push({
-      request: { method, params, id },
-      response: {
-        result: "result" in response ? response.result : void 0,
-        error: "error" in response ? response.error : void 0
-      },
-      durationMs,
-      timestamp: /* @__PURE__ */ new Date()
-    });
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE: TOKEN PARSING
-  // ═══════════════════════════════════════════════════════════════════
-  parseScopesFromToken(token) {
-    try {
-      const payload = this.decodeJwtPayload(token);
-      if (!payload) return [];
-      const scope = payload["scope"];
-      const scopes2 = payload["scopes"];
-      if (typeof scope === "string") {
-        return scope.split(" ");
-      }
-      if (Array.isArray(scopes2)) {
-        return scopes2;
-      }
-      return [];
-    } catch {
-      return [];
-    }
-  }
-  parseUserFromToken(token) {
-    try {
-      const payload = this.decodeJwtPayload(token);
-      const sub = payload?.["sub"];
-      if (!sub || typeof sub !== "string") return void 0;
-      return {
-        sub,
-        email: payload["email"],
-        name: payload["name"]
-      };
-    } catch {
-      return void 0;
-    }
-  }
-  decodeJwtPayload(token) {
-    try {
-      const parts = token.split(".");
-      if (parts.length !== 3) return null;
-      const payload = Buffer.from(parts[1], "base64url").toString("utf-8");
-      return JSON.parse(payload);
-    } catch {
-      return null;
-    }
-  }
-};
-var NotificationCollector = class {
-  constructor(notifications) {
-    this.notifications = notifications;
-  }
-  notifications;
-  get received() {
-    return [...this.notifications];
-  }
-  has(method) {
-    return this.notifications.some((n) => n.method === method);
-  }
-  async waitFor(method, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-      const found = this.notifications.find((n) => n.method === method);
-      if (found) return found;
-      await new Promise((r) => setTimeout(r, 50));
-    }
-    throw new Error(`Timeout waiting for notification: ${method}`);
-  }
-};
-var ProgressCollector = class {
-  constructor(updates) {
-    this.updates = updates;
-  }
-  updates;
-  get all() {
-    return [...this.updates];
-  }
-  async waitForComplete(timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-      const last = this.updates[this.updates.length - 1];
-      if (last && last.total !== void 0 && last.progress >= last.total) {
-        return;
-      }
-      await new Promise((r) => setTimeout(r, 50));
-    }
-    throw new Error("Timeout waiting for progress to complete");
-  }
-};
-
-// libs/testing/src/server/test-server.ts
-import { execFile, spawn } from "child_process";
-import { connect } from "net";
-import { sha256Hex } from "@frontmcp/utils";
-
-// libs/testing/src/errors/index.ts
-var TestClientError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "TestClientError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var ServerStartError = class extends TestClientError {
-  constructor(message, cause) {
-    super(message);
-    this.cause = cause;
-    this.name = "ServerStartError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  cause;
-};
-
-// libs/testing/src/server/port-registry.ts
-import { createServer } from "net";
-var E2E_PORT_RANGES = {
-  // Core E2E tests (50000-50099)
-  "demo-e2e-public": { start: 5e4, size: 10 },
-  "demo-e2e-cache": { start: 50010, size: 10 },
-  "demo-e2e-config": { start: 50020, size: 10 },
-  "demo-e2e-direct": { start: 50030, size: 10 },
-  "demo-e2e-errors": { start: 50040, size: 10 },
-  "demo-e2e-hooks": { start: 50050, size: 10 },
-  "demo-e2e-multiapp": { start: 50060, size: 10 },
-  "demo-e2e-notifications": { start: 50070, size: 10 },
-  "demo-e2e-providers": { start: 50080, size: 10 },
-  "demo-e2e-standalone": { start: 50090, size: 10 },
-  // Auth E2E tests (50100-50199)
-  "demo-e2e-orchestrated": { start: 50100, size: 10 },
-  "demo-e2e-transparent": { start: 50110, size: 10 },
-  "demo-e2e-cimd": { start: 50120, size: 10 },
-  "demo-e2e-remote-proxy": { start: 50130, size: 10 },
-  // Feature E2E tests (50200-50299)
-  "demo-e2e-skills": { start: 50200, size: 10 },
-  "demo-e2e-remote": { start: 50210, size: 10 },
-  "demo-e2e-openapi": { start: 50220, size: 10 },
-  "demo-e2e-ui": { start: 50230, size: 10 },
-  "demo-e2e-codecall": { start: 50240, size: 10 },
-  "demo-e2e-remember": { start: 50250, size: 10 },
-  "demo-e2e-elicitation": { start: 50260, size: 10 },
-  "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-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 },
-  "demo-e2e-cli-exec": { start: 50350, size: 10 },
-  "demo-e2e-env-awareness": { start: 50360, size: 10 },
-  "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-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 },
-  // Protocol revision E2E tests (50460-50479)
-  "demo-e2e-protocol-20260728": { start: 50460, size: 20 },
-  // Testing library E2E tests (50480-50499)
-  "demo-e2e-testing": { start: 50480, size: 20 },
-  // Mock servers and utilities (50900-50999)
-  "mock-oauth": { start: 50900, size: 10 },
-  "mock-api": { start: 50910, size: 10 },
-  "mock-cimd": { start: 50920, size: 10 },
-  // Dynamic/unknown projects (51000+)
-  default: { start: 51e3, size: 100 }
-};
-var reservedPorts = /* @__PURE__ */ new Map();
-var lockedPorts = /* @__PURE__ */ new Set();
-var LOCK_MAX_AGE_MS = 10 * 60 * 1e3;
-function lockDir() {
-  try {
-    const os = __require("node:os");
-    const path = __require("node:path");
-    return path.join(os.tmpdir(), "frontmcp-testing-ports");
-  } catch {
-    return void 0;
-  }
-}
-function pidIsAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error) {
-    return error.code === "EPERM";
-  }
-}
-function acquirePortLock(port) {
-  if (lockedPorts.has(port)) return false;
-  let fs;
-  let file;
-  try {
-    fs = __require("node:fs");
-    const dir = lockDir();
-    if (!dir) return true;
-    fs.mkdirSync(dir, { recursive: true });
-    file = __require("node:path").join(dir, `${port}.lock`);
-  } catch {
-    return true;
-  }
-  const payload = JSON.stringify({ pid: process.pid, at: Date.now() });
-  for (let attempt = 0; attempt < 2; attempt++) {
-    try {
-      fs.writeFileSync(file, payload, { flag: "wx" });
-      lockedPorts.add(port);
-      return true;
-    } catch (error) {
-      if (error.code !== "EEXIST") return true;
-      try {
-        const held = JSON.parse(fs.readFileSync(file, "utf8"));
-        const fresh = typeof held.at === "number" && Date.now() - held.at < LOCK_MAX_AGE_MS;
-        if (fresh && typeof held.pid === "number" && pidIsAlive(held.pid)) return false;
-        fs.unlinkSync(file);
-      } catch {
-      }
-    }
-  }
-  return false;
-}
-function releasePortLock(port) {
-  if (!lockedPorts.delete(port)) return;
-  try {
-    const fs = __require("node:fs");
-    const dir = lockDir();
-    if (dir) fs.unlinkSync(__require("node:path").join(dir, `${port}.lock`));
-  } catch {
-  }
-}
-var projectPortIndex = /* @__PURE__ */ new Map();
-function getPortRange(project) {
-  const key = project;
-  if (key in E2E_PORT_RANGES) {
-    return E2E_PORT_RANGES[key];
-  }
-  return E2E_PORT_RANGES.default;
-}
-async function reservePort(project, preferredPort) {
-  const range = getPortRange(project);
-  const handle = (port) => ({
-    port,
-    // Frees the socket only, so the server about to be spawned can bind the port; the lock file stays
-    releaseSocket: async () => {
-      await releasePort(port);
-    },
-    release: async () => {
-      await releasePort(port);
-      releasePortLock(port);
-    }
-  });
-  const wantsSpecificPort = preferredPort !== void 0 && Number.isInteger(preferredPort) && preferredPort > 0;
-  if (wantsSpecificPort) {
-    const reservation = await tryReservePort(preferredPort, project);
-    if (reservation) {
-      return handle(preferredPort);
-    }
-    console.warn(`[PortRegistry] Preferred port ${preferredPort} not available for ${project}, allocating from range`);
-  }
-  let index = projectPortIndex.get(project) ?? 0;
-  const maxAttempts = range.size;
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    const port = range.start + index % range.size;
-    index = (index + 1) % range.size;
-    if (reservedPorts.has(port) || lockedPorts.has(port)) {
-      continue;
-    }
-    const reservation = await tryReservePort(port, project);
-    if (reservation) {
-      projectPortIndex.set(project, index);
-      return handle(port);
-    }
-  }
-  for (let port = 51e3; port < 52e3; port++) {
-    if (reservedPorts.has(port) || lockedPorts.has(port)) continue;
-    if (await tryReservePort(port, project)) {
-      return handle(port);
-    }
-  }
-  throw new Error(
-    `[PortRegistry] Could not reserve a port for ${project}. Range: ${range.start}-${range.start + range.size - 1}. Currently reserved: ${Array.from(reservedPorts.keys()).join(", ")}`
-  );
-}
-async function tryReservePort(port, project) {
-  if (!acquirePortLock(port)) {
-    return false;
-  }
-  return new Promise((resolve) => {
-    const server = createServer();
-    server.once("error", () => {
-      releasePortLock(port);
-      resolve(false);
-    });
-    server.listen(port, () => {
-      reservedPorts.set(port, {
-        port,
-        project,
-        holder: server,
-        reservedAt: Date.now()
-      });
-      resolve(true);
-    });
-  });
-}
-async function releasePort(port) {
-  const reservation = reservedPorts.get(port);
-  if (!reservation) {
-    return;
-  }
-  return new Promise((resolve) => {
-    reservation.holder.close(() => {
-      reservedPorts.delete(port);
-      resolve();
-    });
-  });
-}
-
-// libs/testing/src/server/test-server.ts
-var SERVER_EXIT_TIMEOUT_MS = 12e3;
-var DEBUG_SERVER = process.env["DEBUG_SERVER"] === "1" || process.env["DEBUG"] === "1";
-var TestServer = class _TestServer {
-  process = null;
-  options;
-  _info;
-  logs = [];
-  /** Frees the port reservation (socket and cross-process lock); held until stop() */
-  portRelease = null;
-  /** Frees only the reservation socket, just before the server is spawned */
-  portReleaseSocket = null;
-  constructor(options, port, portRelease, portReleaseSocket) {
-    this.options = {
-      port,
-      project: options.project,
-      command: options.command ?? "",
-      cwd: options.cwd ?? process.cwd(),
-      env: options.env ?? {},
-      startupTimeout: options.startupTimeout ?? 3e4,
-      healthCheckPath: options.healthCheckPath ?? "/health",
-      debug: options.debug ?? DEBUG_SERVER
-    };
-    this.portRelease = portRelease ?? null;
-    this.portReleaseSocket = portReleaseSocket ?? portRelease ?? null;
-    this._info = {
-      baseUrl: `http://localhost:${port}`,
-      port
-    };
-  }
-  /**
-   * Start a test server with custom command
-   */
-  static async start(options) {
-    const project = options.project ?? "default";
-    const maxAttempts = 3;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-      const { port, release, releaseSocket } = await reservePort(project, options.port);
-      const server = new _TestServer(options, port, release, releaseSocket);
-      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 sleep2(delayMs);
-          continue;
-        }
-        throw error;
-      }
-    }
-    throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`);
-  }
-  /**
-   * Start an Nx project as test server
-   */
-  static async startNx(project, options = {}) {
-    if (!/^[\w-]+$/.test(project)) {
-      throw new Error(
-        `Invalid project name: ${project}. Must contain only alphanumeric, underscore, and hyphen characters.`
-      );
-    }
-    const maxAttempts = 3;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-      const { port, release, releaseSocket } = 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, releaseSocket);
-      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 sleep2(delayMs);
-          continue;
-        }
-        throw error;
-      }
-    }
-    throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`);
-  }
-  /**
-   * Create a test server connected to an already running server
-   */
-  static connect(baseUrl) {
-    const url = new URL(baseUrl);
-    const port = parseInt(url.port, 10) || (url.protocol === "https:" ? 443 : 80);
-    const server = new _TestServer(
-      {
-        command: "",
-        port
-      },
-      port
-    );
-    server._info = {
-      baseUrl: baseUrl.replace(/\/$/, ""),
-      port
-    };
-    return server;
-  }
-  /**
-   * Get server information
-   */
-  get info() {
-    return { ...this._info };
-  }
-  /**
-   * Stop the test server
-   */
-  async stop() {
-    try {
-      await this.stopProcess();
-    } finally {
-      if (this.portRelease) {
-        await this.portRelease();
-        this.portRelease = null;
-      }
-      this.portReleaseSocket = null;
-    }
-  }
-  async stopProcess() {
-    if (this.process) {
-      this.log("Stopping server...");
-      const serverPid = this._info.pid !== this._info.shellPid ? this._info.pid : void 0;
-      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;
-        if (serverPid !== void 0) signalIfRunning(serverPid, "SIGTERM");
-        await this.waitForServerGone(serverPid);
-        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());
-        } else {
-          resolve();
-        }
-      });
-      const killTimeout = setTimeout(() => {
-        if (this.process) {
-          this.log("Force killing server after timeout...");
-          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;
-      clearTimeout(killTimeout);
-      this.process = null;
-      await this.waitForServerGone(serverPid);
-      this.log("Server stopped");
-    }
-  }
-  /**
-   * Wait until the server process has exited and its port refuses connections. A server that
-   * drains on SIGTERM can keep listening after the shell it was started through has exited.
-   */
-  async waitForServerGone(serverPid) {
-    const deadline = Date.now() + SERVER_EXIT_TIMEOUT_MS;
-    while (Date.now() < deadline) {
-      const serverRunning = serverPid !== void 0 && pidIsAlive(serverPid);
-      if (!serverRunning && !await acceptsConnections(this._info.port)) return;
-      await sleep2(100);
-    }
-    if (serverPid !== void 0 && pidIsAlive(serverPid)) {
-      this.log("Force killing server process after timeout...");
-      signalIfRunning(serverPid, "SIGKILL");
-    }
-  }
-  /**
-   * Wait for server to be ready
-   */
-  async waitForReady(timeout) {
-    const timeoutMs = timeout ?? this.options.startupTimeout;
-    const deadline = Date.now() + timeoutMs;
-    const checkInterval = 100;
-    while (Date.now() < deadline) {
-      try {
-        const response = await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`, {
-          method: "GET",
-          signal: AbortSignal.timeout(1e3)
-        });
-        if (response.ok || response.status === 404) {
-          this.log("Server is ready");
-          return;
-        }
-      } catch {
-      }
-      await sleep2(checkInterval);
-    }
-    throw new Error(`Server did not become ready within ${timeoutMs}ms`);
-  }
-  /**
-   * Restart the server
-   */
-  async restart() {
-    await this.stopProcess();
-    await this.startProcess();
-  }
-  /**
-   * Get captured server logs
-   */
-  getLogs() {
-    return [...this.logs];
-  }
-  /**
-   * Clear captured logs
-   */
-  clearLogs() {
-    this.logs = [];
-  }
-  // ═══════════════════════════════════════════════════════════════════
-  // PRIVATE METHODS
-  // ═══════════════════════════════════════════════════════════════════
-  async startProcess() {
-    if (!this.options.command) {
-      await this.waitForReady();
-      return;
-    }
-    this.log(`Starting server: ${this.options.command}`);
-    const env = {
-      ...process.env,
-      ...this.options.env,
-      PORT: String(this.options.port)
-    };
-    const runtimeEnv = withWorkspaceProtocolFallback(env, this.options.cwd);
-    if (this.portReleaseSocket) {
-      await this.portReleaseSocket();
-      this.portReleaseSocket = null;
-      await sleep2(300);
-    }
-    this.process = spawn(this.options.command, [], {
-      cwd: this.options.cwd,
-      env: runtimeEnv,
-      shell: true,
-      detached: true,
-      stdio: ["pipe", "pipe", "pipe"]
-    });
-    this._info.pid = this.process.pid;
-    this._info.shellPid = this.process.pid;
-    let processExited = false;
-    let exitCode = null;
-    let exitError = null;
-    this.process.stdout?.on("data", (data) => {
-      const text = data.toString();
-      this.logs.push(text);
-      if (this.options.debug) {
-        console.log("[SERVER]", text);
-      }
-    });
-    this.process.stderr?.on("data", (data) => {
-      const text = data.toString();
-      this.logs.push(`[ERROR] ${text}`);
-      if (this.options.debug) {
-        console.error("[SERVER ERROR]", text);
-      }
-    });
-    this.process.on("error", (err) => {
-      this.logs.push(`[SPAWN ERROR] ${err.message}`);
-      exitError = err;
-      if (this.options.debug) {
-        console.error("[SERVER SPAWN ERROR]", err);
-      }
-    });
-    this.process.once("exit", (code) => {
-      processExited = true;
-      exitCode = code;
-      this.log(`Server process exited with code ${code}`);
-    });
-    try {
-      await this.waitForReadyWithExitDetection(() => {
-        if (exitError) {
-          return { exited: true, error: exitError };
-        }
-        if (processExited) {
-          const allLogs = this.logs.join("\n");
-          const errorLogs = this.logs.filter((l) => l.includes("[ERROR]") || l.toLowerCase().includes("error")).join("\n");
-          return {
-            exited: true,
-            error: new ServerStartError(
-              `Server process exited unexpectedly with code ${exitCode}.
+var __require=(x=>typeof require!=="undefined"?require:typeof Proxy!=="undefined"?new Proxy(x,{get:(a,b)=>(typeof require!=="undefined"?require:a)[b]}):x)(function(x){if(typeof require!=="undefined")return require.apply(this,arguments);throw Error('Dynamic require of "'+x+'" is not supported')});import{exportJWK,generateKeyPair,SignJWT}from"jose";var TestTokenFactory=class{issuer;audience;privateKey=null;publicKey=null;jwk=null;keyId;hmacSecret;constructor(options={}){this.issuer=options.issuer??"https://test.frontmcp.local";this.audience=options.audience??"frontmcp-test";this.keyId=`test-key-${Date.now()}`;this.hmacSecret=options.hmacSecret?new TextEncoder().encode(options.hmacSecret):null}get isHmac(){return this.hmacSecret!==null}get alg(){return this.isHmac?"HS256":"RS256"}signingKey(){if(this.hmacSecret)return this.hmacSecret;if(!this.privateKey){throw new Error("Private key not initialized")}return this.privateKey}async ensureKeys(){if(this.isHmac)return;if(this.privateKey&&this.publicKey)return;const{publicKey,privateKey}=await generateKeyPair("RS256",{extractable:true});this.privateKey=privateKey;this.publicKey=publicKey;this.jwk=await exportJWK(publicKey);this.jwk.kid=this.keyId;this.jwk.use="sig";this.jwk.alg="RS256"}async createTestToken(options){await this.ensureKeys();const nowMs=Date.now();const iat=Math.floor(nowMs/1e3);const exp=options.exp??3600;const payload={iss:options.iss??this.issuer,sub:options.sub,aud:options.aud??this.audience,iat,exp:Math.ceil(nowMs/1e3)+exp,scope:options.scopes?.join(" "),...options.claims};const header=this.isHmac?{alg:this.alg,typ:"JWT"}:{alg:this.alg,kid:this.keyId};const token=await new SignJWT(payload).setProtectedHeader(header).sign(this.signingKey());return token}async createAdminToken(sub="admin-001"){return this.createTestToken({sub,scopes:["admin:*","read","write","delete"],claims:{email:"admin@test.local",name:"Test Admin",role:"admin"}})}async createUserToken(sub="user-001",scopes2=["read","write"]){return this.createTestToken({sub,scopes:scopes2,claims:{email:"user@test.local",name:"Test User",role:"user"}})}async createAnonymousToken(expiresIn){return this.createTestToken({sub:`anon:${Date.now()}`,scopes:["anonymous"],exp:expiresIn,claims:{name:"Anonymous",role:"anonymous"}})}async createExpiredToken(options){await this.ensureKeys();const now=Math.floor(Date.now()/1e3);const payload={iss:this.issuer,sub:options.sub,aud:this.audience,iat:now-7200,exp:now-3600};const header=this.isHmac?{alg:this.alg,typ:"JWT"}:{alg:this.alg,kid:this.keyId};const token=await new SignJWT(payload).setProtectedHeader(header).sign(this.signingKey());return token}createTokenWithInvalidSignature(options){const now=Math.floor(Date.now()/1e3);const headerObj=this.isHmac?{alg:this.alg,typ:"JWT"}:{alg:this.alg,kid:this.keyId};const header=Buffer.from(JSON.stringify(headerObj)).toString("base64url");const payload=Buffer.from(JSON.stringify({iss:this.issuer,sub:options.sub,aud:this.audience,iat:now,exp:now+3600})).toString("base64url");const signature=Buffer.from("invalid-signature-"+Date.now()).toString("base64url");return`${header}.${payload}.${signature}`}async getPublicJwks(){if(this.isHmac){throw new Error("getPublicJwks() is not available in HS256 mode (gateway tokens use a shared secret)")}await this.ensureKeys();if(!this.jwk){throw new Error("JWK not initialized")}return{keys:[this.jwk]}}getIssuer(){return this.issuer}getAudience(){return this.audience}};var DefaultMockRegistry=class{mocks=[];add(mock){const entry={definition:mock,callCount:0,calls:[],remainingUses:mock.times??Infinity};this.mocks.push(entry);return{remove:()=>{const index=this.mocks.indexOf(entry);if(index!==-1){this.mocks.splice(index,1)}},callCount:()=>entry.callCount,calls:()=>[...entry.calls]}}clear(){this.mocks=[]}getAll(){return this.mocks.map(e=>e.definition)}match(request){for(const entry of this.mocks){if(entry.remainingUses<=0)continue;const{definition}=entry;if(definition.method!==request.method)continue;if(definition.params!==void 0){const params=request.params??{};if(typeof definition.params==="function"){if(!definition.params(params))continue}else{if(!this.paramsMatch(definition.params,params))continue}}entry.callCount++;entry.calls.push(request);entry.remainingUses--;return definition}return void 0}paramsMatch(expected,actual){for(const[key,value]of Object.entries(expected)){if(!(key in actual))return false;const actualValue=actual[key];if(Array.isArray(value)){if(!Array.isArray(actualValue))return false;if(value.length!==actualValue.length)return false;for(let i=0;i<value.length;i++){const expectedItem=value[i];const actualItem=actualValue[i];if(typeof expectedItem==="object"&&expectedItem!==null){if(typeof actualItem!=="object"||actualItem===null)return false;if(!this.paramsMatch(expectedItem,actualItem)){return false}}else if(actualItem!==expectedItem){return false}}}else if(typeof value==="object"&&value!==null){if(typeof actualValue!=="object"||actualValue===null)return false;if(!this.paramsMatch(value,actualValue)){return false}}else if(actualValue!==value){return false}}return true}};var mockResponse={success(result,id=1){return{jsonrpc:"2.0",id,result}},error(code,message,data,id=1){return{jsonrpc:"2.0",id,error:{code,message,data}}},toolResult(content,id=1){return{jsonrpc:"2.0",id,result:{content}}},toolsList(tools,id=1){return{jsonrpc:"2.0",id,result:{tools}}},resourcesList(resources,id=1){return{jsonrpc:"2.0",id,result:{resources}}},resourceRead(contents,id=1){return{jsonrpc:"2.0",id,result:{contents}}},errors:{methodNotFound:(method,id=1)=>mockResponse.error(-32601,`Method not found: ${method}`,void 0,id),invalidParams:(message,id=1)=>mockResponse.error(-32602,message,void 0,id),internalError:(message,id=1)=>mockResponse.error(-32603,message,void 0,id),resourceNotFound:(uri,id=1)=>mockResponse.error(-32002,`Resource not found: ${uri}`,{uri},id),toolNotFound:(name,id=1)=>mockResponse.error(-32601,`Tool not found: ${name}`,{name},id),unauthorized:(id=1)=>mockResponse.error(-32001,"Unauthorized",void 0,id),forbidden:(id=1)=>mockResponse.error(-32003,"Forbidden",void 0,id)}};var DefaultInterceptorChain=class{request=[];response=[];mocks;constructor(){this.mocks=new DefaultMockRegistry}addRequestInterceptor(interceptor){this.request.push(interceptor);return()=>{const index=this.request.indexOf(interceptor);if(index!==-1){this.request.splice(index,1)}}}addResponseInterceptor(interceptor){this.response.push(interceptor);return()=>{const index=this.response.indexOf(interceptor);if(index!==-1){this.response.splice(index,1)}}}async processRequest(request,meta){let currentRequest=request;const mockDef=this.mocks.match(request);if(mockDef){if(mockDef.delay&&mockDef.delay>0){await sleep(mockDef.delay)}let mockResponse2;if(typeof mockDef.response==="function"){mockResponse2=await mockDef.response(request)}else{mockResponse2=mockDef.response}return{type:"mock",response:{...mockResponse2,id:request.id??mockResponse2.id}}}for(const interceptor of this.request){const ctx={request:currentRequest,meta};const result=await interceptor(ctx);switch(result.action){case"passthrough":break;case"modify":currentRequest=result.request;break;case"mock":return{type:"mock",response:{...result.response,id:request.id??result.response.id}};case"error":return{type:"error",error:result.error}}}return{type:"continue",request:currentRequest}}async processResponse(request,response,durationMs){let currentResponse=response;for(const interceptor of this.response){const ctx={request,response:currentResponse,durationMs};const result=await interceptor(ctx);switch(result.action){case"passthrough":break;case"modify":currentResponse=result.response;break}}return currentResponse}clear(){this.request=[];this.response=[];this.mocks.clear()}};function sleep(ms){return new Promise(resolve=>setTimeout(resolve,ms))}function errorName(err){if(typeof err!=="object"||err===null)return void 0;const name=err.name;return typeof name==="string"?name:void 0}function isAbortError(err){return errorName(err)==="AbortError"}function errorMessage(err,fallback="Unknown error"){if(typeof err==="string"&&err)return err;if(typeof err==="object"&&err!==null){const message=err.message;if(typeof message==="string"&&message)return message}return fallback}var interceptedErrors=new WeakSet;function markInterceptedError(err){interceptedErrors.add(err);return err}function isInterceptedError(err){return typeof err==="object"&&err!==null&&interceptedErrors.has(err)}var DEFAULT_TIMEOUT=3e4;var SseTransport=class{baseUrl;entryPath;timeout;authHeaders;publicMode;debug;clientInfo;notificationHandler;interceptors;elicitationHandler;state="disconnected";authToken;sessionId;messageEndpoint;stream;pending=new Map;connectionCount=0;reconnectCount=0;lastRequestHeaders={};constructor(config){this.baseUrl=config.baseUrl.replace(/\/$/,"");this.entryPath=config.entryPath;this.timeout=config.timeout??DEFAULT_TIMEOUT;this.authHeaders=config.auth?.headers??{};this.authToken=config.auth?.token;this.publicMode=config.publicMode??false;this.debug=config.debug??false;this.clientInfo=config.clientInfo;this.notificationHandler=config.notificationHandler;this.interceptors=config.interceptors;this.elicitationHandler=config.elicitationHandler}async connect(){this.state="connecting";this.connectionCount++;try{if(!this.publicMode&&!this.authToken){await this.requestAnonymousToken()}await this.openStream();this.state="connected";this.log(`Connected; messages go to ${this.messageEndpoint}`)}catch(error){this.state="error";this.stream?.abort();this.stream=void 0;throw error}}async request(message){this.ensureConnected();const startTime=Date.now();if(this.interceptors){const intercepted=await this.interceptors.processRequest(message,{timestamp:new Date,transport:"sse",sessionId:this.sessionId});switch(intercepted.type){case"mock":return await this.interceptors.processResponse(message,intercepted.response,Date.now()-startTime);case"error":throw markInterceptedError(intercepted.error);case"continue":message=intercepted.request;break}}let response;if(message.id===void 0){await this.post(JSON.stringify(message));response={jsonrpc:"2.0",id:null,result:void 0}}else{response=await this.postAndAwait(message.id,JSON.stringify(message))}if(this.interceptors){response=await this.interceptors.processResponse(message,response,Date.now()-startTime)}return response}async notify(message){this.ensureConnected();const result=await this.post(JSON.stringify(message));if(!result.ok)this.log(`HTTP ${result.status} on notification: ${result.body}`)}async sendRaw(data){this.ensureConnected();let id;try{const parsed=JSON.parse(data);if(typeof parsed.id==="string"||typeof parsed.id==="number")id=parsed.id}catch{}if(id!==void 0)return this.postAndAwait(id,data);const result=await this.post(data);if(!result.ok){return{jsonrpc:"2.0",id:null,error:{code:-32700,message:"Parse error",data:result.body}}}return{jsonrpc:"2.0",id:null,result:void 0}}async close(){this.closeStream("Transport closed");this.state="disconnected";this.sessionId=void 0;this.messageEndpoint=void 0;this.log("SSE transport closed")}isConnected(){return this.state==="connected"}getState(){return this.state}getSessionId(){return this.sessionId}setAuthToken(token){this.authToken=token}setTimeout(ms){this.timeout=ms}getMessageEndpoint(){return this.messageEndpoint}getConnectionCount(){return this.connectionCount}getReconnectCount(){return this.reconnectCount}getLastRequestHeaders(){return{...this.lastRequestHeaders}}setInterceptors(interceptors2){this.interceptors=interceptors2}getInterceptors(){return this.interceptors}setElicitationHandler(handler){this.elicitationHandler=handler}async simulateDisconnect(){this.closeStream("Simulated disconnect");this.state="disconnected";this.sessionId=void 0;this.messageEndpoint=void 0}async waitForReconnect(timeoutMs){this.reconnectCount++;let timer;try{await Promise.race([this.connect(),new Promise((_,reject)=>{timer=setTimeout(()=>reject(new Error("Timeout waiting for reconnection")),timeoutMs)})])}finally{clearTimeout(timer)}}async openStream(){const controller=new AbortController;this.stream=controller;const url=this.sseUrl();const{"Content-Type":_contentType,...headers}=this.buildHeaders();this.log(`GET ${url}`);const connectTimer=setTimeout(()=>controller.abort(),this.timeout);let response;try{response=await fetch(url,{method:"GET",headers:{...headers,Accept:"text/event-stream"},signal:controller.signal})}catch(error){clearTimeout(connectTimer);throw new Error(isAbortError(error)?`SSE connection to ${url} timed out after ${this.timeout}ms`:`SSE connection to ${url} failed: ${errorMessage(error)}`,{cause:error})}const isEventStream=response.headers.get("content-type")?.includes("text/event-stream")??false;if(!response.ok||!response.body||!isEventStream){clearTimeout(connectTimer);const body=await response.text().catch(()=>"");throw new Error(`SSE connection to ${url} failed: HTTP ${response.status} ${response.statusText}${body?` \u2014 ${body}`:""}. The legacy HTTP+SSE transport needs a server that serves it (@FrontMcp({ transport: { protocol: { legacy: true } } })).`)}const endpoint=new Promise((resolve,reject)=>{const reader=response.body?.getReader();if(!reader){reject(new Error(`SSE connection to ${url} has no body`));return}void this.readStream(controller,reader,resolve,reject)});try{const data=await endpoint;const messageUrl=new URL(data,url);this.messageEndpoint=messageUrl.toString();this.sessionId=messageUrl.searchParams.get("sessionId")??void 0}finally{clearTimeout(connectTimer)}}async readStream(controller,reader,onEndpoint,onEndpointError){const decoder=new TextDecoder;let buffer="";let endpointSeen=false;try{for(let chunk=await reader.read();!chunk.done;chunk=await reader.read()){const{completeEvents,remainder}=splitSSEEvents(buffer+decoder.decode(chunk.value,{stream:true}));buffer=remainder;for(const text of completeEvents){const event=parseSSEEvent(text);if(!event)continue;if(event.type==="endpoint"){if(!endpointSeen){endpointSeen=true;onEndpoint(event.data)}continue}await this.handleMessage(event.data)}}}catch(error){if(!controller.signal.aborted)this.log("SSE stream failed:",error)}finally{reader.releaseLock()}if(!endpointSeen){onEndpointError(new Error(controller.signal.aborted?`SSE stream at ${this.sseUrl()} sent no endpoint event within ${this.timeout}ms`:`SSE stream at ${this.sseUrl()} ended before the server sent its endpoint`))}if(this.stream===controller){this.stream=void 0;this.rejectPending("SSE stream closed by the server");if(this.state==="connected")this.state="disconnected"}}async handleMessage(data){let message;try{message=JSON.parse(data)}catch{this.log("Ignoring SSE event that is not JSON:",data);return}if(!message||typeof message!=="object")return;if(typeof message.method==="string"){const request=message;if(request.id===void 0||request.id===null){this.notificationHandler?.(request);return}await this.answerServerRequest(request);return}if(message.id!==void 0&&message.id!==null){const pending=this.pending.get(message.id);if(pending){clearTimeout(pending.timer);this.pending.delete(message.id);pending.resolve(message)}}}async answerServerRequest(request){const id=request.id;let reply;if(request.method==="elicitation/create"){reply={jsonrpc:"2.0",id,result:await this.elicit(request.params)}}else if(request.method==="ping"){reply={jsonrpc:"2.0",id,result:{}}}else{reply={jsonrpc:"2.0",id,error:{code:-32601,message:`Method not found: ${request.method}`}}}const result=await this.post(JSON.stringify(reply));if(!result.ok)this.log(`HTTP ${result.status} answering ${request.method}: ${result.body}`)}async elicit(params){if(!this.elicitationHandler)return{action:"decline"};try{return await this.elicitationHandler(params)}catch(error){this.log("Elicitation handler error:",error);return{action:"cancel"}}}closeStream(reason){const controller=this.stream;this.stream=void 0;controller?.abort();this.rejectPending(reason)}rejectPending(reason){for(const[id,pending]of this.pending){clearTimeout(pending.timer);pending.resolve({jsonrpc:"2.0",id,error:{code:-32e3,message:reason}})}this.pending.clear()}async postAndAwait(id,body){const answer=new Promise(resolve=>{const timer=setTimeout(()=>{this.pending.delete(id);resolve({jsonrpc:"2.0",id,error:{code:-32e3,message:`Request timeout after ${this.timeout}ms`}})},this.timeout);this.pending.set(id,{resolve,timer})});const result=await this.post(body);if(!result.ok){const pending=this.pending.get(id);if(pending){clearTimeout(pending.timer);this.pending.delete(id)}return{jsonrpc:"2.0",id,error:{code:-32e3,message:`HTTP ${result.status}: ${result.statusText}`,data:result.body}}}return answer}async post(body){const endpoint=this.messageEndpoint;if(!endpoint)throw new Error("SSE transport has no message endpoint. Call connect() first.");const headers=this.buildHeaders();this.lastRequestHeaders=headers;this.log(`POST ${endpoint}`,body);const controller=new AbortController;const timer=setTimeout(()=>controller.abort(),this.timeout);try{const response=await fetch(endpoint,{method:"POST",headers,body,signal:controller.signal});const text=await response.text();return{ok:response.ok,status:response.status,statusText:response.statusText,body:text}}catch(error){if(isAbortError(error)){return{ok:false,status:0,statusText:`timeout after ${this.timeout}ms`,body:""}}throw error}finally{clearTimeout(timer)}}async requestAnonymousToken(){const url=new URL(this.baseUrl);url.pathname=`${url.pathname.replace(/\/+$/,"")}/oauth/token`;url.search="";const tokenUrl=url.toString();try{const response=await fetch(tokenUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({grant_type:"anonymous",client_id:crypto.randomUUID(),resource:this.baseUrl})});if(!response.ok){this.log(`No anonymous token (HTTP ${response.status})`);return}const token=await response.json();if(token.access_token)this.authToken=token.access_token}catch(error){this.log("Error requesting anonymous token:",error)}}sseUrl(){const url=new URL(this.baseUrl);const entry=(this.entryPath??"").replace(/^\/+|\/+$/g,"");const basePath=url.pathname.replace(/\/+$/,"");url.pathname=entry?`${basePath}/${entry}/sse`:`${basePath}/sse`;return url.toString()}buildHeaders(){const headers={"Content-Type":"application/json",Accept:"application/json, text/event-stream"};if(this.clientInfo)headers["User-Agent"]=`${this.clientInfo.name}/${this.clientInfo.version}`;if(this.authToken)headers["Authorization"]=`Bearer ${this.authToken}`;if(this.sessionId)headers["mcp-session-id"]=this.sessionId;Object.assign(headers,this.authHeaders);return headers}ensureConnected(){if(this.state!=="connected"){throw new Error("Transport not connected. Call connect() first.")}}log(message,data){if(this.debug){console.log(`[SSE] ${message}`,data??"")}}};function splitSSEEvents(buffer){const endsWithCarriageReturn=buffer.endsWith("\r");const normalized=(endsWithCarriageReturn?buffer.slice(0,-1):buffer).replace(/\r\n?/g,"\n");const completeEvents=normalized.split("\n\n");const remainder=completeEvents.pop()??"";return{completeEvents,remainder:endsWithCarriageReturn?`${remainder}\r`:remainder}}function parseSSEEvent(text){let type="message";const data=[];for(const line of text.split("\n")){if(line.startsWith(":"))continue;const colon=line.indexOf(":");const field=colon===-1?line:line.slice(0,colon);const value=colon===-1?"":line.slice(colon+1).replace(/^ /,"");if(field==="event")type=value;else if(field==="data")data.push(value)}return data.length>0?{type,data:data.join("\n")}:void 0}var DEFAULT_TIMEOUT2=3e4;var NOTIFICATION_STREAM_REOPEN_DELAY_MS=250;var StreamableHttpTransport=class{config;state="disconnected";sessionId;authToken;connectionCount=0;reconnectCount=0;lastRequestHeaders={};interceptors;publicMode;elicitationHandler;notificationHandler;notificationStream;notificationProtocolVersion="";notificationStreamReopenTimer;constructor(config){this.config={baseUrl:config.baseUrl.replace(/\/$/,""),entryPath:config.entryPath,timeout:config.timeout??DEFAULT_TIMEOUT2,auth:config.auth??{},publicMode:config.publicMode??false,debug:config.debug??false,interceptors:config.interceptors,clientInfo:config.clientInfo};this.authToken=config.auth?.token;this.interceptors=config.interceptors;this.publicMode=config.publicMode??false;this.elicitationHandler=config.elicitationHandler;this.notificationHandler=config.notificationHandler}async connect(){this.state="connecting";this.connectionCount++;try{if(this.publicMode){this.log("Public mode: connecting without authentication");this.state="connected";return}if(!this.authToken){await this.requestAnonymousToken()}this.state="connected";this.log("Connected to StreamableHTTP transport")}catch(error){this.state="error";throw error}}async requestAnonymousToken(){const clientId=crypto.randomUUID();const tokenUrl=`${this.config.baseUrl}/oauth/token`;this.log(`Requesting anonymous token from ${tokenUrl}`);try{const response=await fetch(tokenUrl,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({grant_type:"anonymous",client_id:clientId,resource:this.config.baseUrl})});if(!response.ok){const errorText=await response.text();this.log(`Failed to get anonymous token: ${response.status} ${errorText}`);return}const tokenResponse=await response.json();if(tokenResponse.access_token){this.authToken=tokenResponse.access_token;this.log("Anonymous token acquired successfully")}}catch(error){this.log(`Error requesting anonymous token: ${error}`)}}async request(message){this.ensureConnected();const startTime=Date.now();if(this.interceptors){const interceptResult=await this.interceptors.processRequest(message,{timestamp:new Date,transport:"streamable-http",sessionId:this.sessionId});switch(interceptResult.type){case"mock":{const mockResponse2=await this.interceptors.processResponse(message,interceptResult.response,Date.now()-startTime);return mockResponse2}case"error":throw markInterceptedError(interceptResult.error);case"continue":message=interceptResult.request;break}}const headers=this.buildHeaders();this.lastRequestHeaders=headers;const url=this.mcpUrl();this.log(`POST ${url}`,message);const controller=new AbortController;const timeoutId=setTimeout(()=>controller.abort(),this.config.timeout);try{const response=await fetch(url,{method:"POST",headers,body:JSON.stringify(message),signal:controller.signal});const newSessionId=response.headers.get("mcp-session-id");if(newSessionId){this.sessionId=newSessionId}let jsonResponse;if(!response.ok){const errorText=await response.text();this.log(`HTTP Error ${response.status}: ${errorText}`);jsonResponse={jsonrpc:"2.0",id:message.id??null,error:{code:-32e3,message:`HTTP ${response.status}: ${response.statusText}`,data:errorText}}}else{const contentType=response.headers.get("content-type")??"";if(contentType.includes("text/event-stream")){jsonResponse=await this.handleSSEResponseWithElicitation(response,message)}else{const text=await response.text();this.log("Response:",text);if(!text.trim()){jsonResponse={jsonrpc:"2.0",id:message.id??null,result:void 0}}else{jsonResponse=JSON.parse(text)}}}if(this.interceptors){jsonResponse=await this.interceptors.processResponse(message,jsonResponse,Date.now()-startTime)}clearTimeout(timeoutId);return jsonResponse}catch(error){clearTimeout(timeoutId);if(isAbortError(error)){return{jsonrpc:"2.0",id:message.id??null,error:{code:-32e3,message:`Request timeout after ${this.config.timeout}ms`}}}throw error}}async notify(message){this.ensureConnected();const headers=this.buildHeaders();this.lastRequestHeaders=headers;const url=this.mcpUrl();this.log(`POST ${url} (notification)`,message);const controller=new AbortController;const timeoutId=setTimeout(()=>controller.abort(),this.config.timeout);try{const response=await fetch(url,{method:"POST",headers,body:JSON.stringify(message),signal:controller.signal});clearTimeout(timeoutId);const newSessionId=response.headers.get("mcp-session-id");if(newSessionId){this.sessionId=newSessionId}if(!response.ok){const errorText=await response.text();this.log(`HTTP Error ${response.status} on notification: ${errorText}`)}}catch(error){clearTimeout(timeoutId);if(!isAbortError(error)){throw error}}}async sendRaw(data){this.ensureConnected();const headers=this.buildHeaders();this.lastRequestHeaders=headers;const url=this.mcpUrl();this.log(`POST ${url} (raw)`,data);const controller=new AbortController;const timeoutId=setTimeout(()=>controller.abort(),this.config.timeout);try{const response=await fetch(url,{method:"POST",headers,body:data,signal:controller.signal});clearTimeout(timeoutId);const text=await response.text();if(!text.trim()){return{jsonrpc:"2.0",id:null,error:{code:-32700,message:"Parse error"}}}return JSON.parse(text)}catch(error){clearTimeout(timeoutId);return{jsonrpc:"2.0",id:null,error:{code:-32700,message:"Parse error",data:errorMessage(error)}}}}async openNotificationStream(protocolVersion){this.notificationProtocolVersion=protocolVersion;await this.connectNotificationStream()}async close(){this.closeNotificationStream();this.state="disconnected";this.sessionId=void 0;this.log("StreamableHTTP transport closed")}isConnected(){return this.state==="connected"}getState(){return this.state}getSessionId(){return this.sessionId}setAuthToken(token){this.authToken=token}setTimeout(ms){this.config.timeout=ms}setInterceptors(interceptors2){this.interceptors=interceptors2}getInterceptors(){return this.interceptors}setElicitationHandler(handler){this.elicitationHandler=handler}getConnectionCount(){return this.connectionCount}getReconnectCount(){return this.reconnectCount}getLastRequestHeaders(){return{...this.lastRequestHeaders}}async simulateDisconnect(){this.closeNotificationStream();this.state="disconnected";this.sessionId=void 0}async waitForReconnect(timeoutMs){const deadline=Date.now()+timeoutMs;this.reconnectCount++;await this.connect();while(Date.now()<deadline){if(this.state==="connected"){return}await new Promise(r=>setTimeout(r,50))}throw new Error("Timeout waiting for reconnection")}closeNotificationStream(){clearTimeout(this.notificationStreamReopenTimer);this.notificationStream?.abort();this.notificationStream=void 0}async connectNotificationStream(){if(!this.sessionId||this.notificationStream)return;const controller=new AbortController;this.notificationStream=controller;const{"Content-Type":_contentType,...headers}=this.buildHeaders();const established=fetch(this.mcpUrl(),{method:"GET",headers:{...headers,Accept:"text/event-stream","MCP-Protocol-Version":this.notificationProtocolVersion},signal:controller.signal}).then(async response=>{const isEventStream=response.headers.get("content-type")?.includes("text/event-stream")??false;if(!response.ok||!response.body||!isEventStream){await response.body?.cancel();this.log(`Server offers no notification stream (HTTP ${response.status})`);this.releaseNotificationStream(controller);return}void this.readNotificationStream(controller,response.body.getReader())},error=>{this.log("Failed to open the notification stream:",error);this.releaseNotificationStream(controller)});let establishTimer;const establishDeadline=new Promise(resolve=>{establishTimer=setTimeout(resolve,this.config.timeout)});await Promise.race([established,establishDeadline]);clearTimeout(establishTimer)}releaseNotificationStream(controller){if(this.notificationStream===controller)this.notificationStream=void 0}async readNotificationStream(controller,reader){const decoder=new TextDecoder;let buffer="";try{for(let chunk=await reader.read();!chunk.done;chunk=await reader.read()){const{completeEvents,remainder}=splitSSEEvents2(buffer+decoder.decode(chunk.value,{stream:true}));buffer=remainder;for(const eventText of completeEvents){for(const event of this.parseSSEEvents(eventText,void 0).events){await this.handleSSEEvent(event)}}}}catch(error){this.log("Notification stream ended:",error)}finally{reader.releaseLock()}if(controller.signal.aborted||this.notificationStream!==controller)return;this.releaseNotificationStream(controller);this.notificationStreamReopenTimer=setTimeout(()=>void this.connectNotificationStream(),NOTIFICATION_STREAM_REOPEN_DELAY_MS)}async handleSSEResponseWithElicitation(response,originalRequest){this.log("handleSSEResponseWithElicitation: starting",{requestId:originalRequest.id});const reader=response.body?.getReader();if(!reader){this.log("handleSSEResponseWithElicitation: no response body");return{jsonrpc:"2.0",id:originalRequest.id??null,error:{code:-32e3,message:"No response body"}}}const decoder=new TextDecoder;let buffer="";let finalResponse=null;let sseSessionId;try{let readCount=0;while(true){readCount++;this.log(`handleSSEResponseWithElicitation: reading chunk ${readCount}`);const{done,value}=await reader.read();this.log(`handleSSEResponseWithElicitation: read result`,{done,valueLength:value?.length});if(done){if(buffer.trim()){const parsed=this.parseSSEEvents(buffer,originalRequest.id);for(const event of parsed.events){const handled=await this.handleSSEEvent(event);if(handled.isFinal){finalResponse=handled.response}}if(parsed.sessionId&&!sseSessionId){sseSessionId=parsed.sessionId}}break}buffer+=decoder.decode(value,{stream:true});const eventEndPattern=/\n\n/g;let lastEventEnd=0;let match;while((match=eventEndPattern.exec(buffer))!==null){const eventText=buffer.slice(lastEventEnd,match.index);lastEventEnd=match.index+2;if(eventText.trim()){const parsed=this.parseSSEEvents(eventText,originalRequest.id);for(const event of parsed.events){const handled=await this.handleSSEEvent(event);if(handled.isFinal){finalResponse=handled.response}}if(parsed.sessionId&&!sseSessionId){sseSessionId=parsed.sessionId}}}buffer=buffer.slice(lastEventEnd)}}finally{reader.releaseLock()}if(sseSessionId&&!this.sessionId){this.sessionId=sseSessionId;this.log("Session ID from SSE:",this.sessionId)}if(finalResponse){return finalResponse}return{jsonrpc:"2.0",id:originalRequest.id??null,error:{code:-32e3,message:"No final response received in SSE stream"}}}parseSSEEvents(text,_requestId){const lines=text.split("\n");const events=[];let currentEvent={type:"message",data:[]};let sessionId;for(const line of lines){if(line.startsWith("event: ")){currentEvent.type=line.slice(7)}else if(line.startsWith("data: ")){currentEvent.data.push(line.slice(6))}else if(line==="data:"){currentEvent.data.push("")}else if(line.startsWith("id: ")){const idValue=line.slice(4);currentEvent.id=idValue;const colonIndex=idValue.lastIndexOf(":");if(colonIndex>0){sessionId=idValue.substring(0,colonIndex)}else{sessionId=idValue}}else if(line===""&&currentEvent.data.length>0){events.push({type:currentEvent.type,data:currentEvent.data.join("\n"),id:currentEvent.id});currentEvent={type:"message",data:[]}}}if(currentEvent.data.length>0){events.push({type:currentEvent.type,data:currentEvent.data.join("\n"),id:currentEvent.id})}return{events,sessionId}}async handleSSEEvent(event){this.log("SSE Event:",{type:event.type,data:event.data.slice(0,200)});try{const parsed=JSON.parse(event.data);if("method"in parsed&&parsed.method==="elicitation/create"){await this.handleElicitationRequest(parsed);return{isFinal:false,response:{jsonrpc:"2.0",id:null,result:void 0}}}if("method"in parsed&&parsed.id===void 0){this.notificationHandler?.(parsed);return{isFinal:false,response:{jsonrpc:"2.0",id:null,result:void 0}}}if("result"in parsed||"error"in parsed){return{isFinal:true,response:parsed}}return{isFinal:false,response:{jsonrpc:"2.0",id:null,result:void 0}}}catch{this.log("Failed to parse SSE event data:",event.data);return{isFinal:false,response:{jsonrpc:"2.0",id:null,result:void 0}}}}async handleElicitationRequest(request){const params=request.params;this.log("Elicitation request received:",{mode:params?.mode,message:params?.message?.slice(0,100)});const requestId=request.id;if(requestId===void 0||requestId===null){this.log("Elicitation request has no ID, cannot respond");return}if(!this.elicitationHandler){this.log("No elicitation handler registered, sending error");await this.sendElicitationResponse(requestId,{action:"decline"});return}try{const response=await this.elicitationHandler(params);this.log("Elicitation handler response:",response);await this.sendElicitationResponse(requestId,response)}catch(error){this.log("Elicitation handler error:",error);await this.sendElicitationResponse(requestId,{action:"cancel"})}}async sendElicitationResponse(requestId,response){const headers=this.buildHeaders();const url=this.mcpUrl();const rpcResponse={jsonrpc:"2.0",id:requestId,result:response};this.log("Sending elicitation response:",rpcResponse);try{const fetchResponse=await fetch(url,{method:"POST",headers,body:JSON.stringify(rpcResponse)});if(!fetchResponse.ok){this.log(`Elicitation response HTTP error: ${fetchResponse.status}`)}}catch(error){this.log("Failed to send elicitation response:",error)}}mcpUrl(){const url=new URL(this.config.baseUrl);const entry=(this.config.entryPath??"").replace(/^\/+|\/+$/g,"");const basePath=url.pathname.replace(/\/+$/,"");url.pathname=entry?`${basePath}/${entry}`:`${basePath}/`;return url.toString()}buildHeaders(){const headers={"Content-Type":"application/json",Accept:"application/json, text/event-stream"};if(this.config.clientInfo){headers["User-Agent"]=`${this.config.clientInfo.name}/${this.config.clientInfo.version}`}if(this.authToken){headers["Authorization"]=`Bearer ${this.authToken}`}if(this.sessionId){headers["mcp-session-id"]=this.sessionId}if(this.config.auth.headers){Object.assign(headers,this.config.auth.headers)}return headers}ensureConnected(){if(this.state!=="connected"){throw new Error("Transport not connected. Call connect() first.")}}log(message,data){if(this.config.debug){console.log(`[StreamableHTTP] ${message}`,data??"")}}parseSSEResponseWithSession(text,requestId){const lines=text.split("\n");const dataLines=[];let sseSessionId;for(const line of lines){if(line.startsWith("data: ")){dataLines.push(line.slice(6))}else if(line==="data:"){dataLines.push("")}else if(line.startsWith("id: ")){const idValue=line.slice(4);const colonIndex=idValue.lastIndexOf(":");if(colonIndex>0){sseSessionId=idValue.substring(0,colonIndex)}else{sseSessionId=idValue}}}if(dataLines.length>0){const jsonData=dataLines.join("\n");try{return{response:JSON.parse(jsonData),sseSessionId}}catch{this.log("Failed to parse SSE data as JSON:",jsonData)}}return{response:{jsonrpc:"2.0",id:requestId??null,error:{code:-32700,message:"Failed to parse SSE response",data:text}},sseSessionId}}};function splitSSEEvents2(buffer){const endsWithCarriageReturn=buffer.endsWith("\r");const normalized=(endsWithCarriageReturn?buffer.slice(0,-1):buffer).replace(/\r\n?/g,"\n");const completeEvents=normalized.split("\n\n");const remainder=completeEvents.pop()??"";return{completeEvents,remainder:endsWithCarriageReturn?`${remainder}\r`:remainder}}var MCP_APPS_EXTENSION_KEY="io.modelcontextprotocol/ui";function getPlatformClientInfo(platform){switch(platform){case"openai":return{name:"ChatGPT",version:"1.0"};case"ext-apps":return{name:"mcp-ext-apps",version:"1.0"};case"claude":return{name:"claude-desktop",version:"1.0"};case"cursor":return{name:"cursor",version:"1.0"};case"continue":return{name:"continue",version:"1.0"};case"cody":return{name:"cody",version:"1.0"};case"gemini":return{name:"gemini",version:"1.0"};case"generic-mcp":return{name:"generic-mcp-client",version:"1.0"};case"unknown":default:return{name:"mcp-test-client",version:"1.0"}}}function getPlatformCapabilities(platform){const baseCapabilities={sampling:{},elicitation:{form:{}}};if(platform==="ext-apps"){return{...baseCapabilities,experimental:{[MCP_APPS_EXTENSION_KEY]:{mimeTypes:["text/html;profile=mcp-app"]}}}}return baseCapabilities}var McpTestClientBuilder=class{config;constructor(config){this.config={...config}}withAuth(auth){this.config.auth={...this.config.auth,...auth};return this}withToken(token){this.config.auth={...this.config.auth,token};return this}withHeaders(headers){this.config.auth={...this.config.auth,headers:{...this.config.auth?.headers,...headers}};return this}withTransport(transport){this.config.transport=transport;return this}withTimeout(timeoutMs){this.config.timeout=timeoutMs;return this}withDebug(enabled=true){this.config.debug=enabled;return this}withPublicMode(enabled=true){this.config.publicMode=enabled;return this}withProtocolVersion(version){this.config.protocolVersion=version;return this}withClientInfo(info){this.config.clientInfo=info;return this}withPlatform(platform){this.config.platform=platform;this.config.clientInfo=getPlatformClientInfo(platform);this.config.capabilities=getPlatformCapabilities(platform);return this}withCapabilities(capabilities){this.config.capabilities=capabilities;return this}withQueryParams(params){this.config.queryParams={...this.config.queryParams,...params};return this}build(){return new McpTestClient(this.config)}async buildAndConnect(){const client=this.build();await client.connect();return client}};var DEFAULT_TIMEOUT3=3e4;var DEFAULT_PROTOCOL_VERSION="2025-06-18";var UNSUPPORTED_PROTOCOL_VERSIONS=["2026-07-28"];var DEFAULT_CLIENT_INFO={name:"@frontmcp/testing",version:"0.4.0"};var MAX_LIST_PAGES=1e3;function isAuthFailure(error){return typeof error?.message==="string"&&/^HTTP (401|403)\b/.test(error.message)}function describeInitializeError(error){const message=error?.message??"Unknown error";const data=error?.data;const detail=typeof data==="string"?data.trim():"";return detail?`${message} - ${detail.slice(0,500)}`:message}function extractEntryPaths(data){let payload=data;if(typeof payload==="string"){try{payload=JSON.parse(payload)}catch{return void 0}}if(!payload||typeof payload!=="object")return void 0;const paths=payload.entryPaths;if(!Array.isArray(paths))return void 0;const strings=paths.filter(p=>typeof p==="string");return strings.length>0?strings:void 0}var McpTestClient=class{config;transport=null;initResult=null;requestIdCounter=0;_lastRequestId=0;_sessionId;triedDiscoveredEntryPath=false;_sessionInfo=null;_authState={isAnonymous:true,scopes:[]};_logs=[];_traces=[];_notifications=[];_progressUpdates=[];collectingProgress=false;progressTokenCounter=0;_interceptors;_elicitationHandler;constructor(config){if(config.protocolVersion&&UNSUPPORTED_PROTOCOL_VERSIONS.includes(config.protocolVersion)){throw new Error(`McpTestClient does not support protocol version ${config.protocolVersion}: it has no initialize handshake. Use ${DEFAULT_PROTOCOL_VERSION} or earlier.`)}this.config={baseUrl:config.baseUrl,entryPath:config.entryPath,transport:config.transport??"streamable-http",auth:config.auth??{},publicMode:config.publicMode??false,timeout:config.timeout??DEFAULT_TIMEOUT3,debug:config.debug??false,protocolVersion:config.protocolVersion??DEFAULT_PROTOCOL_VERSION,clientInfo:config.clientInfo??DEFAULT_CLIENT_INFO,platform:config.platform,capabilities:config.capabilities,queryParams:config.queryParams};if(config.auth?.token){this._authState={isAnonymous:false,token:config.auth.token,scopes:this.parseScopesFromToken(config.auth.token),user:this.parseUserFromToken(config.auth.token)}}this._interceptors=new DefaultInterceptorChain}static create(config){return new McpTestClientBuilder(config)}async connect(){this.log("debug",`Connecting to ${this.config.baseUrl}...`);this.triedDiscoveredEntryPath=false;this.initResult=null;this.transport=this.createTransport();await this.transport.connect();const maxRetries=3;const retryDelayMs=500;let lastError;let reportedEntryPaths;let attemptsMade=0;for(let attempt=1;attempt<=maxRetries;attempt++){attemptsMade=attempt;const initResponse=await this.initialize();if(initResponse.success&&initResponse.data){this.initResult=initResponse.data;break}lastError=describeInitializeError(initResponse.error);reportedEntryPaths=extractEntryPaths(initResponse.error?.data)??reportedEntryPaths;if(reportedEntryPaths?.length===1&&!this.triedDiscoveredEntryPath){this.triedDiscoveredEntryPath=true;const discovered=reportedEntryPaths[0];this.log("info",`Server serves MCP at ${discovered}; reconnecting there (configured: ${this.mcpPathLabel()})`);this.config.entryPath=discovered;await this.transport.close();this.transport=this.createTransport();await this.transport.connect();continue}if(isAuthFailure(initResponse.error))break;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){const served=reportedEntryPaths?.length?` The server reports it serves MCP at ${reportedEntryPaths.join(", ")}; set \`entryPath\` in test.use() (or \`http.entryPath\` on the server) to match.`:"";throw new Error(`Failed to initialize MCP connection to ${this.config.baseUrl}${this.mcpPathLabel()} after ${attemptsMade} attempt${attemptsMade===1?"":"s"}: ${lastError}.${served}`)}this._sessionId=this.transport.getSessionId();this._sessionInfo={id:this._sessionId??`session-${Date.now()}`,createdAt:new Date,lastActivityAt:new Date,requestCount:1};await this.transport.notify({jsonrpc:"2.0",method:"notifications/initialized"});await this.transport.openNotificationStream?.(this.initResult.protocolVersion);this.log("info",`Connected to ${this.initResult.serverInfo?.name??"MCP Server"}`);return this.initResult}async disconnect(){if(this.transport){await this.transport.close();this.transport=null}this.initResult=null;this.log("info","Disconnected from MCP server")}async reconnect(options){await this.disconnect();if(options?.sessionId&&this.transport){this._sessionId=options.sessionId}await this.connect()}isConnected(){return this.transport?.isConnected()??false}get sessionId(){return this._sessionId??""}get session(){const info=this._sessionInfo??{id:"",createdAt:new Date,lastActivityAt:new Date,requestCount:0};return{...info,expire:async()=>{this._sessionId=void 0;this._sessionInfo=null}}}get auth(){return this._authState}async authenticate(token){if(typeof token!=="string"||token.trim()===""){throw new Error("authenticate() requires a non-empty token")}const previousAuthState=this._authState;const previousConfigAuth=this.config.auth;this.config.auth={...previousConfigAuth,token};this._authState={isAnonymous:false,token,scopes:this.parseScopesFromToken(token),user:this.parseUserFromToken(token)};const previousTransport=this.transport;if(!previousTransport){this.log("debug","Authentication updated (not connected yet)");return}const previousInit=this.initResult;const previousSessionId=this._sessionId;const previousSessionInfo=this._sessionInfo;try{await this.connect()}catch(err){await this.transport?.close().catch(()=>void 0);this.transport=previousTransport;this.initResult=previousInit;this._sessionId=previousSessionId;this._sessionInfo=previousSessionInfo;this.config.auth=previousConfigAuth;this._authState=previousAuthState;throw err}await previousTransport.close().catch(()=>void 0);this.log("debug","Authentication updated")}get serverInfo(){return{name:this.initResult?.serverInfo?.name??"",version:this.initResult?.serverInfo?.version??""}}get protocolVersion(){return this.initResult?.protocolVersion??""}get instructions(){return this.initResult?.instructions??""}get capabilities(){return this.initResult?.capabilities??{}}hasCapability(name){return!!this.capabilities[name]}tools={list:async()=>this.listAllPages("tools/list","tools",cursor=>this.listTools(cursor),page=>page.tools),call:async(name,args,options={})=>{const response=await this.callTool(name,args,this.progressTokenFor(options));return this.wrapToolResult(response)}};resources={list:async()=>this.listAllPages("resources/list","resources",cursor=>this.listResources(cursor),page=>page.resources),listTemplates:async()=>this.listAllPages("resources/templates/list","resource templates",cursor=>this.listResourceTemplates(cursor),page=>page.resourceTemplates),read:async uri=>{const response=await this.readResource(uri);return this.wrapResourceContent(response)},subscribe:async _uri=>{this.log("warn","Resource subscription not yet implemented")},unsubscribe:async _uri=>{this.log("warn","Resource unsubscription not yet implemented")}};prompts={list:async()=>this.listAllPages("prompts/list","prompts",cursor=>this.listPrompts(cursor),page=>page.prompts),get:async(name,args)=>{const response=await this.getPrompt(name,args);return this.wrapPromptResult(response)}};raw={request:async message=>{const transport=this.getConnectedTransport();const start=Date.now();const response=await transport.request(message);this.traceRequest(message.method,message.params,message.id,response,Date.now()-start);return response},notify:async message=>{const transport=this.getConnectedTransport();await transport.notify(message)},sendRaw:async data=>{const transport=this.getConnectedTransport();return transport.sendRaw(data)}};get lastRequestId(){return this._lastRequestId}get transport_info(){return{type:this.config.transport,isConnected:()=>this.transport?.isConnected()??false,messageEndpoint:this.transport?.getMessageEndpoint?.(),connectionCount:this.transport?.getConnectionCount?.()??0,reconnectCount:this.transport?.getReconnectCount?.()??0,lastRequestHeaders:this.transport?.getLastRequestHeaders?.()??{},simulateDisconnect:async()=>{await this.transport?.simulateDisconnect?.()},waitForReconnect:async timeoutMs=>{await this.transport?.waitForReconnect?.(timeoutMs)}}}get transport_(){return this.transport_info}notifications={collect:()=>{return new NotificationCollector(this._notifications)},collectProgress:()=>{this.collectingProgress=true;return new ProgressCollector(this._progressUpdates)},send:async(method,params)=>{await this.raw.notify({jsonrpc:"2.0",method,params})}};onElicitation(handler){this._elicitationHandler=handler;if(this.transport?.setElicitationHandler){this.transport.setElicitationHandler(handler)}this.log("debug","Elicitation handler registered")}clearElicitationHandler(){this._elicitationHandler=void 0;if(this.transport?.setElicitationHandler){this.transport.setElicitationHandler(void 0)}this.log("debug","Elicitation handler cleared")}logs={all:()=>[...this._logs],filter:level=>this._logs.filter(l=>l.level===level),search:text=>this._logs.filter(l=>l.message.includes(text)),last:()=>this._logs[this._logs.length-1],clear:()=>{this._logs=[]}};trace={all:()=>[...this._traces],last:()=>this._traces[this._traces.length-1],clear:()=>{this._traces=[]}};mock={add:mock=>{return this._interceptors.mocks.add(mock)},tool:(name,result,options)=>{return this._interceptors.mocks.add({method:"tools/call",params:{name},response:mockResponse.toolResult([{type:"text",text:typeof result==="string"?result:JSON.stringify(result)}]),times:options?.times,delay:options?.delay})},toolError:(name,code,message,options)=>{return this._interceptors.mocks.add({method:"tools/call",params:{name},response:mockResponse.error(code,message),times:options?.times})},resource:(uri,content,options)=>{const contentObj=typeof content==="string"?{uri,text:content}:{uri,...content};return this._interceptors.mocks.add({method:"resources/read",params:{uri},response:mockResponse.resourceRead([contentObj]),times:options?.times,delay:options?.delay})},resourceError:(uri,options)=>{return this._interceptors.mocks.add({method:"resources/read",params:{uri},response:mockResponse.errors.resourceNotFound(uri),times:options?.times})},toolsList:(tools,options)=>{return this._interceptors.mocks.add({method:"tools/list",response:mockResponse.toolsList(tools),times:options?.times})},resourcesList:(resources,options)=>{return this._interceptors.mocks.add({method:"resources/list",response:mockResponse.resourcesList(resources),times:options?.times})},clear:()=>{this._interceptors.mocks.clear()},all:()=>{return this._interceptors.mocks.getAll()}};intercept={request:interceptor=>{return this._interceptors.addRequestInterceptor(interceptor)},response:interceptor=>{return this._interceptors.addResponseInterceptor(interceptor)},delay:ms=>{return this._interceptors.addRequestInterceptor(async()=>{await new Promise(r=>setTimeout(r,ms));return{action:"passthrough"}})},failMethod:(method,error)=>{return this._interceptors.addRequestInterceptor(ctx=>{if(ctx.request.method===method){return{action:"error",error:new Error(error??`Intercepted: ${method}`)}}return{action:"passthrough"}})},clear:()=>{this._interceptors.request=[];this._interceptors.response=[]},clearAll:()=>{this._interceptors.clear()}};setTimeout(ms){this.config.timeout=ms;if(this.transport){this.transport.setTimeout(ms)}}async initialize(){const capabilities=this.config.capabilities??{sampling:{},elicitation:{form:{}}};return this.request("initialize",{protocolVersion:this.config.protocolVersion,capabilities,clientInfo:this.config.clientInfo})}async listTools(cursor){return this.request("tools/list",cursor?{cursor}:{})}async listAllPages(method,label,fetchPage,itemsOf){const items=[];const seenCursors=new Set;let cursor;for(let page=0;page<MAX_LIST_PAGES;page++){const response=await fetchPage(cursor);if(!response.success||!response.data){throw new Error(`Failed to list ${label}: ${response.error?.message}`)}items.push(...itemsOf(response.data)??[]);const next=response.data.nextCursor;if(!next)return items;if(seenCursors.has(next)){throw new Error(`Failed to list ${label}: ${method} returned the cursor "${next}" twice`)}seenCursors.add(next);cursor=next}throw new Error(`Failed to list ${label}: ${method} did not finish within ${MAX_LIST_PAGES} pages`)}async callTool(name,args,progressToken){return this.request("tools/call",{name,arguments:args??{},...progressToken!==void 0&&{_meta:{progressToken}}})}progressTokenFor(options){if(options.progressToken!==void 0)return options.progressToken;return this.collectingProgress?`progress-${++this.progressTokenCounter}`:void 0}recordNotification=notification=>{const timestamp=new Date;this._notifications.push({method:notification.method,params:notification.params,timestamp});if(notification.method!=="notifications/progress")return;const{progress,total,progressToken}=notification.params??{};this._progressUpdates.push({progress:Number(progress),total:typeof total==="number"?total:void 0,progressToken:typeof progressToken==="string"||typeof progressToken==="number"?progressToken:void 0,timestamp})};async listResources(cursor){return this.request("resources/list",cursor?{cursor}:{})}async listResourceTemplates(cursor){return this.request("resources/templates/list",cursor?{cursor}:{})}async readResource(uri){return this.request("resources/read",{uri})}async listPrompts(cursor){return this.request("prompts/list",cursor?{cursor}:{})}async getPrompt(name,args){return this.request("prompts/get",{name,arguments:args??{}})}mcpPathLabel(){const entry=(this.config.entryPath??"").replace(/^\/+|\/+$/g,"");return entry?`/${entry}`:"/"}createTransport(){let baseUrl=this.config.baseUrl;if(this.config.queryParams&&Object.keys(this.config.queryParams).length>0){const url=new URL(baseUrl);Object.entries(this.config.queryParams).forEach(([key,value])=>{url.searchParams.set(key,String(value))});baseUrl=url.toString()}switch(this.config.transport){case"streamable-http":return new StreamableHttpTransport({baseUrl,entryPath:this.config.entryPath,timeout:this.config.timeout,auth:this.config.auth,publicMode:this.config.publicMode,debug:this.config.debug,interceptors:this._interceptors,clientInfo:this.config.clientInfo,elicitationHandler:this._elicitationHandler,notificationHandler:this.recordNotification});case"sse":return new SseTransport({baseUrl,entryPath:this.config.entryPath,timeout:this.config.timeout,auth:this.config.auth,publicMode:this.config.publicMode,debug:this.config.debug,interceptors:this._interceptors,clientInfo:this.config.clientInfo,elicitationHandler:this._elicitationHandler,notificationHandler:this.recordNotification});default:throw new Error(`Unknown transport type: ${this.config.transport}`)}}async request(method,params){const transport=this.getConnectedTransport();const id=++this.requestIdCounter;this._lastRequestId=id;const start=Date.now();try{const response=await transport.request({jsonrpc:"2.0",id,method,params});const durationMs=Date.now()-start;this.updateSessionActivity();if("error"in response&&response.error){const error=response.error;this.traceRequest(method,params,id,response,durationMs);return{success:false,error,durationMs,requestId:id}}this.traceRequest(method,params,id,response,durationMs);return{success:true,data:response.result,durationMs,requestId:id}}catch(err){if(isInterceptedError(err))throw err;const durationMs=Date.now()-start;const error={code:-32603,message:errorMessage(err)};return{success:false,error,durationMs,requestId:id}}}getConnectedTransport(){if(!this.transport||!this.transport.isConnected()){throw new Error("Not connected to MCP server. Call connect() first.")}return this.transport}updateSessionActivity(){if(this._sessionInfo){this._sessionInfo.lastActivityAt=new Date;this._sessionInfo.requestCount++}}wrapToolResult(response){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;const structuredContent=raw["structuredContent"];return{raw,isSuccess:!isError,isError,error:response.error,durationMs:response.durationMs,json(){if(hasUI&&structuredContent!==void 0){return structuredContent}const textContent=raw.content?.find(c=>c.type==="text");if(textContent&&"text"in textContent){return JSON.parse(textContent.text)}throw new Error("No text content to parse as JSON")},text(){const textContent=raw.content?.find(c=>c.type==="text");if(textContent&&"text"in textContent){return textContent.text}return void 0},hasTextContent(){return raw.content?.some(c=>c.type==="text")??false},hasImageContent(){return raw.content?.some(c=>c.type==="image")??false},hasResourceContent(){return raw.content?.some(c=>c.type==="resource")??false},hasToolUI(){return hasUI}}}wrapResourceContent(response){const raw=response.data??{contents:[]};const isError=!response.success;const firstContent=raw.contents?.[0];return{raw,isSuccess:!isError,isError,error:response.error,durationMs:response.durationMs,json(){if(firstContent&&"text"in firstContent){return JSON.parse(firstContent.text)}throw new Error("No text content to parse as JSON")},text(){if(firstContent&&"text"in firstContent){return firstContent.text}return void 0},mimeType(){return firstContent?.mimeType},hasMimeType(type){return firstContent?.mimeType===type}}}wrapPromptResult(response){const raw=response.data??{messages:[]};const isError=!response.success;return{raw,isSuccess:!isError,isError,error:response.error,durationMs:response.durationMs,messages:raw.messages??[],description:raw.description}}log(level,message,data){const entry={level,message,timestamp:new Date,data};this._logs.push(entry);if(this.config.debug){console.log(`[${level.toUpperCase()}] ${message}`,data??"")}}traceRequest(method,params,id,response,durationMs){this._traces.push({request:{method,params,id},response:{result:"result"in response?response.result:void 0,error:"error"in response?response.error:void 0},durationMs,timestamp:new Date})}parseScopesFromToken(token){try{const payload=this.decodeJwtPayload(token);if(!payload)return[];const scope=payload["scope"];const scopes2=payload["scopes"];if(typeof scope==="string"){return scope.split(" ")}if(Array.isArray(scopes2)){return scopes2}return[]}catch{return[]}}parseUserFromToken(token){try{const payload=this.decodeJwtPayload(token);const sub=payload?.["sub"];if(!sub||typeof sub!=="string")return void 0;return{sub,email:payload["email"],name:payload["name"]}}catch{return void 0}}decodeJwtPayload(token){try{const parts=token.split(".");if(parts.length!==3)return null;const payload=Buffer.from(parts[1],"base64url").toString("utf-8");return JSON.parse(payload)}catch{return null}}};var NotificationCollector=class{constructor(notifications){this.notifications=notifications}notifications;get received(){return[...this.notifications]}has(method){return this.notifications.some(n=>n.method===method)}async waitFor(method,timeoutMs){const deadline=Date.now()+timeoutMs;while(Date.now()<deadline){const found=this.notifications.find(n=>n.method===method);if(found)return found;await new Promise(r=>setTimeout(r,50))}throw new Error(`Timeout waiting for notification: ${method}`)}};var ProgressCollector=class{constructor(updates){this.updates=updates}updates;get all(){return[...this.updates]}async waitForComplete(timeoutMs){const deadline=Date.now()+timeoutMs;while(Date.now()<deadline){const last=this.updates[this.updates.length-1];if(last&&last.total!==void 0&&last.progress>=last.total){return}await new Promise(r=>setTimeout(r,50))}throw new Error("Timeout waiting for progress to complete")}};import{execFile,spawn}from"child_process";import{connect}from"net";import{sha256Hex}from"@frontmcp/utils";var TestClientError=class extends Error{constructor(message){super(message);this.name="TestClientError";Object.setPrototypeOf(this,new.target.prototype)}};var ServerStartError=class extends TestClientError{constructor(message,cause){super(message);this.cause=cause;this.name="ServerStartError";Object.setPrototypeOf(this,new.target.prototype)}cause};import{createServer}from"net";var E2E_PORT_RANGES={"demo-e2e-public":{start:5e4,size:10},"demo-e2e-cache":{start:50010,size:10},"demo-e2e-config":{start:50020,size:10},"demo-e2e-direct":{start:50030,size:10},"demo-e2e-errors":{start:50040,size:10},"demo-e2e-hooks":{start:50050,size:10},"demo-e2e-multiapp":{start:50060,size:10},"demo-e2e-notifications":{start:50070,size:10},"demo-e2e-providers":{start:50080,size:10},"demo-e2e-standalone":{start:50090,size:10},"demo-e2e-orchestrated":{start:50100,size:10},"demo-e2e-transparent":{start:50110,size:10},"demo-e2e-cimd":{start:50120,size:10},"demo-e2e-remote-proxy":{start:50130,size:10},"demo-e2e-skills":{start:50200,size:10},"demo-e2e-remote":{start:50210,size:10},"demo-e2e-openapi":{start:50220,size:10},"demo-e2e-ui":{start:50230,size:10},"demo-e2e-codecall":{start:50240,size:10},"demo-e2e-remember":{start:50250,size:10},"demo-e2e-elicitation":{start:50260,size:10},"demo-e2e-agents":{start:50270,size:10},"demo-e2e-transport-recreation":{start:50280,size:10},"demo-e2e-jobs":{start:50290,size:10},"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},"demo-e2e-cli-exec":{start:50350,size:10},"demo-e2e-env-awareness":{start:50360,size:10},"demo-e2e-esm":{start:50370,size:10},"demo-e2e-feature-flags":{start:50380,size:10},"demo-e2e-resource-providers":{start:50390,size:10},"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},"demo-e2e-distributed":{start:50440,size:20},"demo-e2e-protocol-20260728":{start:50460,size:20},"demo-e2e-testing":{start:50480,size:20},"mock-oauth":{start:50900,size:10},"mock-api":{start:50910,size:10},"mock-cimd":{start:50920,size:10},default:{start:51e3,size:100}};var reservedPorts=new Map;var lockedPorts=new Set;var LOCK_MAX_AGE_MS=10*60*1e3;function lockDir(){try{const os=__require("node:os");const path=__require("node:path");return path.join(os.tmpdir(),"frontmcp-testing-ports")}catch{return void 0}}function pidIsAlive(pid){try{process.kill(pid,0);return true}catch(error){return error.code==="EPERM"}}function acquirePortLock(port){if(lockedPorts.has(port))return false;let fs;let file;try{fs=__require("node:fs");const dir=lockDir();if(!dir)return true;fs.mkdirSync(dir,{recursive:true});file=__require("node:path").join(dir,`${port}.lock`)}catch{return true}const payload=JSON.stringify({pid:process.pid,at:Date.now()});for(let attempt=0;attempt<2;attempt++){try{fs.writeFileSync(file,payload,{flag:"wx"});lockedPorts.add(port);return true}catch(error){if(error.code!=="EEXIST")return true;try{const held=JSON.parse(fs.readFileSync(file,"utf8"));const fresh=typeof held.at==="number"&&Date.now()-held.at<LOCK_MAX_AGE_MS;if(fresh&&typeof held.pid==="number"&&pidIsAlive(held.pid))return false;fs.unlinkSync(file)}catch{}}}return false}function releasePortLock(port){if(!lockedPorts.delete(port))return;try{const fs=__require("node:fs");const dir=lockDir();if(dir)fs.unlinkSync(__require("node:path").join(dir,`${port}.lock`))}catch{}}var projectPortIndex=new Map;function getPortRange(project){const key=project;if(key in E2E_PORT_RANGES){return E2E_PORT_RANGES[key]}return E2E_PORT_RANGES.default}async function reservePort(project,preferredPort){const range=getPortRange(project);const handle=port=>({port,releaseSocket:async()=>{await releasePort(port)},release:async()=>{await releasePort(port);releasePortLock(port)}});const wantsSpecificPort=preferredPort!==void 0&&Number.isInteger(preferredPort)&&preferredPort>0;if(wantsSpecificPort){const reservation=await tryReservePort(preferredPort,project);if(reservation){return handle(preferredPort)}console.warn(`[PortRegistry] Preferred port ${preferredPort} not available for ${project}, allocating from range`)}let index=projectPortIndex.get(project)??0;const maxAttempts=range.size;for(let attempt=0;attempt<maxAttempts;attempt++){const port=range.start+index%range.size;index=(index+1)%range.size;if(reservedPorts.has(port)||lockedPorts.has(port)){continue}const reservation=await tryReservePort(port,project);if(reservation){projectPortIndex.set(project,index);return handle(port)}}for(let port=51e3;port<52e3;port++){if(reservedPorts.has(port)||lockedPorts.has(port))continue;if(await tryReservePort(port,project)){return handle(port)}}throw new Error(`[PortRegistry] Could not reserve a port for ${project}. Range: ${range.start}-${range.start+range.size-1}. Currently reserved: ${Array.from(reservedPorts.keys()).join(", ")}`)}async function tryReservePort(port,project){if(!acquirePortLock(port)){return false}return new Promise(resolve=>{const server=createServer();server.once("error",()=>{releasePortLock(port);resolve(false)});server.listen(port,()=>{reservedPorts.set(port,{port,project,holder:server,reservedAt:Date.now()});resolve(true)})})}async function releasePort(port){const reservation=reservedPorts.get(port);if(!reservation){return}return new Promise(resolve=>{reservation.holder.close(()=>{reservedPorts.delete(port);resolve()})})}var SERVER_EXIT_TIMEOUT_MS=12e3;var DEBUG_SERVER=process.env["DEBUG_SERVER"]==="1"||process.env["DEBUG"]==="1";var TestServer=class _TestServer{process=null;options;_info;logs=[];portRelease=null;portReleaseSocket=null;constructor(options,port,portRelease,portReleaseSocket){this.options={port,project:options.project,command:options.command??"",cwd:options.cwd??process.cwd(),env:options.env??{},startupTimeout:options.startupTimeout??3e4,healthCheckPath:options.healthCheckPath??"/health",debug:options.debug??DEBUG_SERVER};this.portRelease=portRelease??null;this.portReleaseSocket=portReleaseSocket??portRelease??null;this._info={baseUrl:`http://localhost:${port}`,port}}static async start(options){const project=options.project??"default";const maxAttempts=3;for(let attempt=1;attempt<=maxAttempts;attempt++){const{port,release,releaseSocket}=await reservePort(project,options.port);const server=new _TestServer(options,port,release,releaseSocket);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 sleep2(delayMs);continue}throw error}}throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`)}static async startNx(project,options={}){if(!/^[\w-]+$/.test(project)){throw new Error(`Invalid project name: ${project}. Must contain only alphanumeric, underscore, and hyphen characters.`)}const maxAttempts=3;for(let attempt=1;attempt<=maxAttempts;attempt++){const{port,release,releaseSocket}=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,releaseSocket);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 sleep2(delayMs);continue}throw error}}throw new Error(`[TestServer] Failed to start after ${maxAttempts} attempts`)}static connect(baseUrl){const url=new URL(baseUrl);const port=parseInt(url.port,10)||(url.protocol==="https:"?443:80);const server=new _TestServer({command:"",port},port);server._info={baseUrl:baseUrl.replace(/\/$/,""),port};return server}get info(){return{...this._info}}async stop(){try{await this.stopProcess()}finally{if(this.portRelease){await this.portRelease();this.portRelease=null}this.portReleaseSocket=null}}async stopProcess(){if(this.process){this.log("Stopping server...");const serverPid=this._info.pid!==this._info.shellPid?this._info.pid:void 0;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;if(serverPid!==void 0)signalIfRunning(serverPid,"SIGTERM");await this.waitForServerGone(serverPid);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())}else{resolve()}});const killTimeout=setTimeout(()=>{if(this.process){this.log("Force killing server after timeout...");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;clearTimeout(killTimeout);this.process=null;await this.waitForServerGone(serverPid);this.log("Server stopped")}}async waitForServerGone(serverPid){const deadline=Date.now()+SERVER_EXIT_TIMEOUT_MS;while(Date.now()<deadline){const serverRunning=serverPid!==void 0&&pidIsAlive(serverPid);if(!serverRunning&&!await acceptsConnections(this._info.port))return;await sleep2(100)}if(serverPid!==void 0&&pidIsAlive(serverPid)){this.log("Force killing server process after timeout...");signalIfRunning(serverPid,"SIGKILL")}}async waitForReady(timeout){const timeoutMs=timeout??this.options.startupTimeout;const deadline=Date.now()+timeoutMs;const checkInterval=100;while(Date.now()<deadline){try{const response=await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`,{method:"GET",signal:AbortSignal.timeout(1e3)});if(response.ok||response.status===404){this.log("Server is ready");return}}catch{}await sleep2(checkInterval)}throw new Error(`Server did not become ready within ${timeoutMs}ms`)}async restart(){await this.stopProcess();await this.startProcess()}getLogs(){return[...this.logs]}clearLogs(){this.logs=[]}async startProcess(){if(!this.options.command){await this.waitForReady();return}this.log(`Starting server: ${this.options.command}`);const env={...process.env,...this.options.env,PORT:String(this.options.port)};const runtimeEnv=withWorkspaceProtocolFallback(env,this.options.cwd);if(this.portReleaseSocket){await this.portReleaseSocket();this.portReleaseSocket=null;await sleep2(300)}this.process=spawn(this.options.command,[],{cwd:this.options.cwd,env:runtimeEnv,shell:true,detached:true,stdio:["pipe","pipe","pipe"]});this._info.pid=this.process.pid;this._info.shellPid=this.process.pid;let processExited=false;let exitCode=null;let exitError=null;this.process.stdout?.on("data",data=>{const text=data.toString();this.logs.push(text);if(this.options.debug){console.log("[SERVER]",text)}});this.process.stderr?.on("data",data=>{const text=data.toString();this.logs.push(`[ERROR] ${text}`);if(this.options.debug){console.error("[SERVER ERROR]",text)}});this.process.on("error",err=>{this.logs.push(`[SPAWN ERROR] ${err.message}`);exitError=err;if(this.options.debug){console.error("[SERVER SPAWN ERROR]",err)}});this.process.once("exit",code=>{processExited=true;exitCode=code;this.log(`Server process exited with code ${code}`)});try{await this.waitForReadyWithExitDetection(()=>{if(exitError){return{exited:true,error:exitError}}if(processExited){const allLogs=this.logs.join("\n");const errorLogs=this.logs.filter(l=>l.includes("[ERROR]")||l.toLowerCase().includes("error")).join("\n");return{exited:true,error:new ServerStartError(`Server process exited unexpectedly with code ${exitCode}.
 
 Command: ${this.options.command}
 CWD: ${this.options.cwd}
 Port: ${this.options.port}
 
 === Error Logs ===
-${errorLogs || "No error logs captured"}
+${errorLogs||"No error logs captured"}
 
 === Full Logs ===
-${allLogs || "No logs captured"}`
-            )
-          };
-        }
-        return { exited: false };
-      });
-    } catch (error) {
-      this.printLogsOnFailure("Server startup failed");
-      throw error;
-    }
-  }
-  /**
-   * Print server logs on failure for debugging
-   */
-  printLogsOnFailure(context) {
-    const allLogs = this.logs.join("\n");
-    if (allLogs) {
-      console.error(`
-[TestServer] ${context}`);
-      console.error(`[TestServer] Command: ${this.options.command}`);
-      console.error(`[TestServer] Port: ${this.options.port}`);
-      console.error(`[TestServer] CWD: ${this.options.cwd}`);
-      console.error(`[TestServer] === Server Logs ===
-${allLogs}`);
-      console.error(`[TestServer] === End Logs ===
-`);
-    }
-  }
-  /**
-   * Wait for server to be ready, but also detect early process exit
-   */
-  async waitForReadyWithExitDetection(checkExit) {
-    const timeoutMs = this.options.startupTimeout;
-    const deadline = Date.now() + timeoutMs;
-    const checkInterval = 100;
-    let lastHealthCheckError = null;
-    let healthCheckAttempts = 0;
-    this.log(`Waiting for server to be ready (timeout: ${timeoutMs}ms)...`);
-    while (Date.now() < deadline) {
-      const exitStatus = checkExit();
-      if (exitStatus.exited) {
-        throw exitStatus.error ?? new ServerStartError("Server process exited unexpectedly");
-      }
-      healthCheckAttempts++;
-      try {
-        const healthUrl = `${this._info.baseUrl}${this.options.healthCheckPath}`;
-        const response = await fetch(healthUrl, {
-          method: "GET",
-          signal: AbortSignal.timeout(1e3)
-        });
-        if (response.ok || response.status === 404) {
-          this.log(`Server is ready after ${healthCheckAttempts} health check attempts`);
-          const listeningPid = await findListeningPid(this.options.port);
-          if (listeningPid !== void 0) this._info.pid = listeningPid;
-          return;
-        }
-        lastHealthCheckError = `HTTP ${response.status}: ${response.statusText}`;
-      } catch (err) {
-        lastHealthCheckError = err instanceof Error ? err.message : String(err);
-      }
-      const elapsed = Date.now() - (deadline - timeoutMs);
-      if (elapsed > 0 && elapsed % 5e3 < checkInterval) {
-        this.log(
-          `Still waiting for server... (${Math.round(elapsed / 1e3)}s elapsed, last error: ${lastHealthCheckError})`
-        );
-      }
-      await sleep2(checkInterval);
-    }
-    const finalExitStatus = checkExit();
-    if (finalExitStatus.exited) {
-      throw finalExitStatus.error ?? new ServerStartError("Server process exited unexpectedly");
-    }
-    const allLogs = this.logs.join("\n");
-    throw new ServerStartError(
-      `Server did not become ready within ${timeoutMs}ms.
+${allLogs||"No logs captured"}`)}}return{exited:false}})}catch(error){this.printLogsOnFailure("Server startup failed");throw error}}printLogsOnFailure(context){const allLogs=this.logs.join("\n");if(allLogs){console.error(`
+[TestServer] ${context}`);console.error(`[TestServer] Command: ${this.options.command}`);console.error(`[TestServer] Port: ${this.options.port}`);console.error(`[TestServer] CWD: ${this.options.cwd}`);console.error(`[TestServer] === Server Logs ===
+${allLogs}`);console.error(`[TestServer] === End Logs ===
+`)}}async waitForReadyWithExitDetection(checkExit){const timeoutMs=this.options.startupTimeout;const deadline=Date.now()+timeoutMs;const checkInterval=100;let lastHealthCheckError=null;let healthCheckAttempts=0;this.log(`Waiting for server to be ready (timeout: ${timeoutMs}ms)...`);while(Date.now()<deadline){const exitStatus=checkExit();if(exitStatus.exited){throw exitStatus.error??new ServerStartError("Server process exited unexpectedly")}healthCheckAttempts++;try{const healthUrl=`${this._info.baseUrl}${this.options.healthCheckPath}`;const response=await fetch(healthUrl,{method:"GET",signal:AbortSignal.timeout(1e3)});if(response.ok||response.status===404){this.log(`Server is ready after ${healthCheckAttempts} health check attempts`);const listeningPid=await findListeningPid(this.options.port);if(listeningPid!==void 0)this._info.pid=listeningPid;return}lastHealthCheckError=`HTTP ${response.status}: ${response.statusText}`}catch(err){lastHealthCheckError=err instanceof Error?err.message:String(err)}const elapsed=Date.now()-(deadline-timeoutMs);if(elapsed>0&&elapsed%5e3<checkInterval){this.log(`Still waiting for server... (${Math.round(elapsed/1e3)}s elapsed, last error: ${lastHealthCheckError})`)}await sleep2(checkInterval)}const finalExitStatus=checkExit();if(finalExitStatus.exited){throw finalExitStatus.error??new ServerStartError("Server process exited unexpectedly")}const allLogs=this.logs.join("\n");throw new ServerStartError(`Server did not become ready within ${timeoutMs}ms.
 
 Command: ${this.options.command}
 CWD: ${this.options.cwd}
 Port: ${this.options.port}
 Health check URL: ${this._info.baseUrl}${this.options.healthCheckPath}
 Health check attempts: ${healthCheckAttempts}
-Last health check error: ${lastHealthCheckError ?? "none"}
+Last health check error: ${lastHealthCheckError??"none"}
 
 === Server Logs ===
-${allLogs || "No logs captured"}
-
-TIP: Set DEBUG_SERVER=1 or DEBUG=1 environment variable for verbose output`
-    );
-  }
-  log(message) {
-    if (this.options.debug) {
-      console.log(`[TestServer] ${message}`);
-    }
-  }
-};
-function sleep2(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function signalIfRunning(pid, signal) {
-  try {
-    process.kill(pid, signal);
-  } catch (error) {
-    if (error.code !== "ESRCH") throw error;
-  }
-}
-function acceptsConnections(port) {
-  return new Promise((resolve) => {
-    const socket = connect(port, "127.0.0.1");
-    socket.once("connect", () => {
-      socket.destroy();
-      resolve(true);
-    });
-    socket.once("error", () => resolve(false));
-  });
-}
-function findListeningPid(port) {
-  if (process.platform === "win32") return Promise.resolve(void 0);
-  return new Promise((resolve) => {
-    execFile("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], { timeout: 2e3 }, (error, stdout) => {
-      if (error) {
-        resolve(void 0);
-        return;
-      }
-      const pid = parseInt(String(stdout).split("\n")[0] ?? "", 10);
-      resolve(Number.isInteger(pid) && pid > 0 ? pid : void 0);
-    });
-  });
-}
-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", 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/fixtures/gateway-token-binding.ts
-import { trimSlashes, trimTrailing } from "@frontmcp/utils";
-function gatewayTokenBinding(serverUrl, entryPath) {
-  const base = trimTrailing(serverUrl, "/");
-  const prefix = trimSlashes(entryPath ?? "");
-  const mcpUrl = prefix ? `${base}/${prefix}` : base;
-  return { issuer: mcpUrl, audience: mcpUrl };
-}
+${allLogs||"No logs captured"}
 
-// libs/testing/src/fixtures/test-fixture.ts
-var jestApi;
-function jestGlobals() {
-  if (jestApi) return jestApi;
-  try {
-    const api = __require("@jest/globals");
-    jestApi = {
-      describe: api["describe"],
-      beforeAll: api["beforeAll"],
-      beforeEach: api["beforeEach"],
-      afterEach: api["afterEach"],
-      afterAll: api["afterAll"],
-      it: api["it"]
-    };
-    return jestApi;
-  } catch (error) {
-    throw new Error(
-      `@frontmcp/testing fixtures ("test", "test.use", ...) can only be used inside a Jest test file: ${error instanceof Error ? error.message : String(error)}`,
-      { cause: error }
-    );
-  }
-}
-function newScope(parent) {
-  return {
-    skipped: parent?.skipped ?? false,
-    reason: parent?.reason,
-    config: {},
-    envs: [],
-    configured: false,
-    cleanupRegistered: false,
-    beforeEachHooks: [],
-    afterEachHooks: []
-  };
-}
-var scopes = [newScope()];
-function currentScope() {
-  return scopes[scopes.length - 1];
-}
-var serverEntries = /* @__PURE__ */ new Map();
-function resolveConfig(chain) {
-  const merged = {};
-  for (const scope of chain) {
-    Object.assign(merged, scope.config);
-    for (const env of scope.envs) merged.env = { ...merged.env, ...env };
-  }
-  return merged;
-}
-function ownerScopeOf(chain) {
-  for (let i = chain.length - 1; i > 0; i--) {
-    if (chain[i].configured) return chain[i];
-  }
-  return chain[0];
-}
-function serverKey(config) {
-  const env = Object.fromEntries(Object.entries(config.env ?? {}).sort(([a], [b]) => a.localeCompare(b)));
-  return JSON.stringify({
-    server: config.server,
-    baseUrl: config.baseUrl,
-    project: config.project,
-    port: config.port,
-    entryPath: config.entryPath,
-    startupTimeout: config.startupTimeout,
-    logLevel: config.logLevel,
-    auth: config.auth,
-    env
-  });
-}
-function serverEnv(config) {
-  const extra = {};
-  if (config.logLevel) extra["FRONTMCP_LOG_LEVEL"] = config.logLevel;
-  if (config.auth?.mode) extra["FRONTMCP_TEST_AUTH_MODE"] = config.auth.mode;
-  if (config.auth?.type) extra["FRONTMCP_TEST_AUTH_TYPE"] = config.auth.type;
-  if (Object.keys(extra).length === 0 && !config.env) return void 0;
-  return { ...extra, ...config.env };
-}
-async function startServerEntry(config, owner) {
-  let server;
-  let startedByUs = false;
-  if (config.baseUrl && !config.server) {
-    server = TestServer.connect(config.baseUrl);
-  } else if (config.server) {
-    const serverCommand = resolveServerCommand(config.server);
-    const isDebug = config.logLevel === "debug" || process.env["DEBUG"] === "1" || process.env["DEBUG_SERVER"] === "1";
-    if (isDebug) {
-      console.log(`[TestFixture] Starting server: ${serverCommand}`);
-    }
-    try {
-      server = await TestServer.start({
-        project: config.project,
-        port: config.port,
-        command: serverCommand,
-        env: serverEnv(config),
-        startupTimeout: config.startupTimeout ?? 3e4,
-        debug: isDebug
-      });
-      startedByUs = true;
-      if (isDebug) {
-        console.log(`[TestFixture] Server started at ${server.info.baseUrl}`);
-      }
-    } catch (error) {
-      const errMsg = error instanceof Error ? error.message : String(error);
-      throw new Error(
-        `Failed to start test server.
+TIP: Set DEBUG_SERVER=1 or DEBUG=1 environment variable for verbose output`)}log(message){if(this.options.debug){console.log(`[TestServer] ${message}`)}}};function sleep2(ms){return new Promise(resolve=>setTimeout(resolve,ms))}function signalIfRunning(pid,signal){try{process.kill(pid,signal)}catch(error){if(error.code!=="ESRCH")throw error}}function acceptsConnections(port){return new Promise(resolve=>{const socket=connect(port,"127.0.0.1");socket.once("connect",()=>{socket.destroy();resolve(true)});socket.once("error",()=>resolve(false))})}function findListeningPid(port){if(process.platform==="win32")return Promise.resolve(void 0);return new Promise(resolve=>{execFile("lsof",["-nP",`-iTCP:${port}`,"-sTCP:LISTEN","-t"],{timeout:2e3},(error,stdout)=>{if(error){resolve(void 0);return}const pid=parseInt(String(stdout).split("\n")[0]??"",10);resolve(Number.isInteger(pid)&&pid>0?pid:void 0)})})}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",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})}import{trimSlashes,trimTrailing}from"@frontmcp/utils";function gatewayTokenBinding(serverUrl,entryPath){const base=trimTrailing(serverUrl,"/");const prefix=trimSlashes(entryPath??"");const mcpUrl=prefix?`${base}/${prefix}`:base;return{issuer:mcpUrl,audience:mcpUrl}}var jestApi;function jestGlobals(){if(jestApi)return jestApi;try{const api=__require("@jest/globals");jestApi={describe:api["describe"],beforeAll:api["beforeAll"],beforeEach:api["beforeEach"],afterEach:api["afterEach"],afterAll:api["afterAll"],it:api["it"]};return jestApi}catch(error){throw new Error(`@frontmcp/testing fixtures ("test", "test.use", ...) can only be used inside a Jest test file: ${error instanceof Error?error.message:String(error)}`,{cause:error})}}function newScope(parent){return{skipped:parent?.skipped??false,reason:parent?.reason,config:{},envs:[],configured:false,cleanupRegistered:false,beforeEachHooks:[],afterEachHooks:[]}}var scopes=[newScope()];function currentScope(){return scopes[scopes.length-1]}var serverEntries=new Map;function resolveConfig(chain){const merged={};for(const scope of chain){Object.assign(merged,scope.config);for(const env of scope.envs)merged.env={...merged.env,...env}}return merged}function ownerScopeOf(chain){for(let i=chain.length-1;i>0;i--){if(chain[i].configured)return chain[i]}return chain[0]}function serverKey(config){const env=Object.fromEntries(Object.entries(config.env??{}).sort(([a],[b])=>a.localeCompare(b)));return JSON.stringify({server:config.server,baseUrl:config.baseUrl,project:config.project,port:config.port,entryPath:config.entryPath,startupTimeout:config.startupTimeout,logLevel:config.logLevel,auth:config.auth,env})}function serverEnv(config){const extra={};if(config.logLevel)extra["FRONTMCP_LOG_LEVEL"]=config.logLevel;if(config.auth?.mode)extra["FRONTMCP_TEST_AUTH_MODE"]=config.auth.mode;if(config.auth?.type)extra["FRONTMCP_TEST_AUTH_TYPE"]=config.auth.type;if(Object.keys(extra).length===0&&!config.env)return void 0;return{...extra,...config.env}}async function startServerEntry(config,owner){let server;let startedByUs=false;if(config.baseUrl&&!config.server){server=TestServer.connect(config.baseUrl)}else if(config.server){const serverCommand=resolveServerCommand(config.server);const isDebug=config.logLevel==="debug"||process.env["DEBUG"]==="1"||process.env["DEBUG_SERVER"]==="1";if(isDebug){console.log(`[TestFixture] Starting server: ${serverCommand}`)}try{server=await TestServer.start({project:config.project,port:config.port,command:serverCommand,env:serverEnv(config),startupTimeout:config.startupTimeout??3e4,debug:isDebug});startedByUs=true;if(isDebug){console.log(`[TestFixture] Server started at ${server.info.baseUrl}`)}}catch(error){const errMsg=error instanceof Error?error.message:String(error);throw new Error(`Failed to start test server.
 
 Server entry: ${config.server}
-Project: ${config.project ?? "default"}
+Project: ${config.project??"default"}
 Command: ${serverCommand}
 
-Error: ${errMsg}`,
-        { cause: error }
-      );
-    }
-  } else {
-    throw new Error('test.use() requires either "server" (entry file path) or "baseUrl" (for external server) option');
-  }
-  const sharedSecret = config.env?.["JWT_SECRET"];
-  const binding = sharedSecret ? gatewayTokenBinding(config.baseUrl ?? server.info.baseUrl, config.entryPath) : void 0;
-  const tokenFactory = new TestTokenFactory(sharedSecret ? { hmacSecret: sharedSecret, ...binding } : {});
-  return { server, startedByUs, tokenFactory, owner };
-}
-function acquireServer(chain) {
-  const config = resolveConfig(chain);
-  const key = serverKey(config);
-  let entry = serverEntries.get(key);
-  if (!entry) {
-    entry = startServerEntry(config, ownerScopeOf(chain));
-    serverEntries.set(key, entry);
-    entry.catch(() => serverEntries.delete(key));
-  }
-  return entry;
-}
-async function stopServers(owner) {
-  for (const [key, pending] of Array.from(serverEntries)) {
-    let entry;
-    try {
-      entry = await pending;
-    } catch {
-      serverEntries.delete(key);
-      continue;
-    }
-    if (owner && entry.owner !== owner) continue;
-    serverEntries.delete(key);
-    if (entry.startedByUs) {
-      await entry.server.stop();
-    }
-  }
-}
-var fixtureContexts = /* @__PURE__ */ new WeakMap();
-async function buildFixtures(chain) {
-  const config = resolveConfig(chain);
-  const entry = await acquireServer(chain);
-  const { server, tokenFactory } = entry;
-  const publicMode = config.publicMode ?? config.auth?.mode === "public";
-  const clientConfig = { ...config, publicMode };
-  const clientInstance = McpTestClient.create({
-    baseUrl: resolveClientBaseUrl(server, clientConfig),
-    entryPath: clientConfig.entryPath,
-    transport: clientConfig.transport ?? "streamable-http",
-    publicMode
-  }).build();
-  try {
-    await clientInstance.connect();
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (/\b401\b|unauthor/i.test(message)) {
-      console.warn(
-        `[TestFixture] MCP client could not connect anonymously \u2014 the server requires authentication (${message}). Tests using only the 'server'/'auth' fixtures are unaffected; tests using the 'mcp' fixture must supply a token.`
-      );
-    } else {
-      throw err;
-    }
-  }
-  const context = { extraClients: [] };
-  const fixtures = {
-    mcp: clientInstance,
-    auth: createAuthFixture(tokenFactory),
-    server: createServerFixture(server, clientConfig, clientInstance, context)
-  };
-  fixtureContexts.set(fixtures, context);
-  return fixtures;
-}
-async function createTestFixtures() {
-  return buildFixtures(scopes.slice());
-}
-async function initializeSharedResources() {
-  await acquireServer(scopes.slice());
-}
-async function cleanupTestFixtures(fixtures, testFailed = false) {
-  if (testFailed) {
-    const logs = fixtures.server.getLogs();
-    if (logs.length > 0) {
-      console.error("\n[TestFixture] === Server Logs (test failed) ===");
-      const recentLogs = logs.slice(-50);
-      if (logs.length > 50) {
-        console.error(`[TestFixture] (showing last 50 of ${logs.length} log entries)`);
-      }
-      console.error(recentLogs.join("\n"));
-      console.error("[TestFixture] === End Server Logs ===\n");
-    }
-  }
-  const extras = fixtureContexts.get(fixtures)?.extraClients ?? [];
-  for (const client of extras) {
-    if (client.isConnected()) {
-      await client.disconnect().catch(() => void 0);
-    }
-  }
-  if (fixtures.mcp.isConnected()) {
-    await fixtures.mcp.disconnect();
-  }
-}
-async function cleanupSharedResources() {
-  await stopServers();
-}
-function resolveClientBaseUrl(server, config) {
-  return config.baseUrl ?? server.info.baseUrl;
-}
-function createAuthFixture(factory) {
-  const users = {
-    admin: {
-      sub: "admin-001",
-      scopes: ["admin:*", "read", "write", "delete"],
-      email: "admin@test.local",
-      name: "Test Admin"
-    },
-    user: {
-      sub: "user-001",
-      scopes: ["read", "write"],
-      email: "user@test.local",
-      name: "Test User"
-    },
-    readOnly: {
-      sub: "readonly-001",
-      scopes: ["read"],
-      email: "readonly@test.local",
-      name: "Read Only User"
-    }
-  };
-  return {
-    createToken: (opts) => factory.createTestToken({
-      sub: opts.sub,
-      scopes: opts.scopes,
-      claims: {
-        email: opts.email,
-        name: opts.name,
-        ...opts.claims
-      },
-      exp: opts.expiresIn
-    }),
-    createExpiredToken: (opts) => factory.createExpiredToken(opts),
-    createInvalidToken: (opts) => factory.createTokenWithInvalidSignature(opts),
-    users: {
-      admin: users["admin"],
-      user: users["user"],
-      readOnly: users["readOnly"]
-    },
-    getJwks: () => factory.getPublicJwks(),
-    getIssuer: () => factory.getIssuer(),
-    getAudience: () => factory.getAudience()
-  };
-}
-function createServerFixture(server, config, mcp, context) {
-  return {
-    // Live view: `pid` is filled in once the server is listening and follows restarts
-    get info() {
-      return server.info;
-    },
-    createClient: async (opts) => {
-      const client = await McpTestClient.create({
-        baseUrl: resolveClientBaseUrl(server, config),
-        entryPath: opts?.entryPath ?? config.entryPath,
-        transport: opts?.transport ?? "streamable-http",
-        auth: opts?.token ? { token: opts.token } : void 0,
-        clientInfo: opts?.clientInfo,
-        publicMode: config.publicMode
-      }).buildAndConnect();
-      context.extraClients.push(client);
-      return client;
-    },
-    createClientBuilder: () => {
-      const builder = new McpTestClientBuilder({
-        baseUrl: resolveClientBaseUrl(server, config),
-        entryPath: config.entryPath,
-        publicMode: config.publicMode
-      });
-      return builder;
-    },
-    restart: async () => {
-      const reconnect = [mcp, ...context.extraClients].filter((client) => client.isConnected());
-      await server.restart();
-      for (const client of reconnect) {
-        await client.reconnect();
-      }
-    },
-    getLogs: () => server.getLogs(),
-    clearLogs: () => server.clearLogs()
-  };
-}
-function resolveServerCommand(server) {
-  if (server.includes(" ")) {
-    return server;
-  }
-  return `npx tsx ${server}`;
-}
-function runWithFixtures(fn, chain) {
-  return async (...extra) => {
-    const fixtures = await buildFixtures(chain);
-    let failure;
-    try {
-      for (const scope of chain) {
-        for (const hook of scope.beforeEachHooks) await hook(fixtures);
-      }
-      await fn(fixtures, ...extra);
-    } catch (error) {
-      failure = { error };
-    }
-    try {
-      await runAfterEachHooks(chain, fixtures);
-    } catch (error) {
-      failure ??= { error };
-    }
-    await cleanupTestFixtures(fixtures, failure !== void 0);
-    if (failure) throw failure.error;
-  };
-}
-async function runAfterEachHooks(chain, fixtures) {
-  let firstError;
-  let failed = false;
-  for (let i = chain.length - 1; i >= 0; i--) {
-    for (const hook of chain[i].afterEachHooks) {
-      try {
-        await hook(fixtures);
-      } catch (error) {
-        if (!failed) firstError = error;
-        failed = true;
-      }
-    }
-  }
-  if (failed) throw firstError;
-}
-function skipTitle(name, scope) {
-  return scope.reason ? `${name} (skipped: ${scope.reason})` : name;
-}
-function testWithFixtures(name, fn) {
-  const chain = scopes.slice();
-  const scope = currentScope();
-  if (scope.skipped) {
-    jestGlobals().it.skip(skipTitle(name, scope), runWithFixtures(fn, chain));
-    return;
-  }
-  jestGlobals().it(name, runWithFixtures(fn, chain));
-}
-function use(config) {
-  const scope = currentScope();
-  const { env, ...rest } = config;
-  scope.config = { ...scope.config, ...rest };
-  if (env) scope.envs.push(env);
-  scope.configured = true;
-  if (!scope.cleanupRegistered) {
-    scope.cleanupRegistered = true;
-    jestGlobals().afterAll(async () => {
-      await stopServers(scope === scopes[0] ? void 0 : scope);
-    });
-  }
-}
-function skip(nameOrCondition, fnOrReason) {
-  if (typeof nameOrCondition === "boolean") {
-    if (nameOrCondition) {
-      const scope = currentScope();
-      scope.skipped = true;
-      scope.reason = typeof fnOrReason === "string" ? fnOrReason : void 0;
-    }
-    return;
-  }
-  if (typeof fnOrReason !== "function") {
-    throw new TypeError(
-      `test.skip expects either (name: string, fn) or (condition: boolean, reason?: string); received (${typeof nameOrCondition}, ${typeof fnOrReason}).`
-    );
-  }
-  jestGlobals().it.skip(nameOrCondition, runWithFixtures(fnOrReason, scopes.slice()));
-}
-function only(name, fn) {
-  const scope = currentScope();
-  if (scope.skipped) {
-    jestGlobals().it.skip(skipTitle(name, scope), runWithFixtures(fn, scopes.slice()));
-    return;
-  }
-  jestGlobals().it.only(name, runWithFixtures(fn, scopes.slice()));
-}
-function todo(name) {
-  jestGlobals().it.todo(name);
-}
-function each(table, ...tagged) {
-  const chain = scopes.slice();
-  const register = jestGlobals().it.each(table, ...tagged);
-  return (name, fn) => {
-    const scope = currentScope();
-    if (scope.skipped) {
-      const skipRegister = jestGlobals().it.skip.each(table, ...tagged);
-      skipRegister(skipTitle(name, scope), runWithFixtures(fn, chain));
-      return;
-    }
-    register(name, runWithFixtures(fn, chain));
-  };
-}
-function withScope(fn) {
-  return (...args) => {
-    scopes.push(newScope(currentScope()));
-    try {
-      fn(...args);
-    } finally {
-      scopes.pop();
-    }
-  };
-}
-function scopedRegister(pick) {
-  return (name, fn, timeout) => {
-    pick()(name, withScope(fn), timeout);
-  };
-}
-function scopedEach(pick) {
-  return (...eachArgs) => (name, fn, timeout) => {
-    const register = pick()(...eachArgs);
-    register(name, withScope(fn), timeout);
-  };
-}
-var describeWithScope = Object.assign(
-  scopedRegister(() => jestGlobals().describe),
-  {
-    // `describe.skip` still evaluates its callback during collection, so it needs a scope too
-    only: Object.assign(
-      scopedRegister(() => jestGlobals().describe.only),
-      {
-        each: scopedEach(() => jestGlobals().describe.only.each)
-      }
-    ),
-    skip: Object.assign(
-      scopedRegister(() => jestGlobals().describe.skip),
-      {
-        each: scopedEach(() => jestGlobals().describe.skip.each)
-      }
-    ),
-    each: scopedEach(() => jestGlobals().describe.each)
-  }
-);
-function eachHook(kind) {
-  return (fn, timeout) => {
-    if (typeof fn === "function" && fn.length > 0) {
-      const scope = currentScope();
-      (kind === "beforeEach" ? scope.beforeEachHooks : scope.afterEachHooks).push(fn);
-      return;
-    }
-    jestGlobals()[kind](fn, timeout);
-  };
-}
-var test = testWithFixtures;
-test.use = use;
-test.describe = describeWithScope;
-test.beforeAll = ((...args) => jestGlobals().beforeAll(...args));
-test.beforeEach = eachHook("beforeEach");
-test.afterEach = eachHook("afterEach");
-test.afterAll = ((...args) => jestGlobals().afterAll(...args));
-test.skip = skip;
-test.only = only;
-test.todo = todo;
-test.each = each;
-export {
-  cleanupSharedResources,
-  cleanupTestFixtures,
-  createTestFixtures,
-  initializeSharedResources,
-  test
-};
+Error: ${errMsg}`,{cause:error})}}else{throw new Error('test.use() requires either "server" (entry file path) or "baseUrl" (for external server) option')}const sharedSecret=config.env?.["JWT_SECRET"];const binding=sharedSecret?gatewayTokenBinding(config.baseUrl??server.info.baseUrl,config.entryPath):void 0;const tokenFactory=new TestTokenFactory(sharedSecret?{hmacSecret:sharedSecret,...binding}:{});return{server,startedByUs,tokenFactory,owner}}function acquireServer(chain){const config=resolveConfig(chain);const key=serverKey(config);let entry=serverEntries.get(key);if(!entry){entry=startServerEntry(config,ownerScopeOf(chain));serverEntries.set(key,entry);entry.catch(()=>serverEntries.delete(key))}return entry}async function stopServers(owner){for(const[key,pending]of Array.from(serverEntries)){let entry;try{entry=await pending}catch{serverEntries.delete(key);continue}if(owner&&entry.owner!==owner)continue;serverEntries.delete(key);if(entry.startedByUs){await entry.server.stop()}}}var fixtureContexts=new WeakMap;async function buildFixtures(chain){const config=resolveConfig(chain);const entry=await acquireServer(chain);const{server,tokenFactory}=entry;const publicMode=config.publicMode??config.auth?.mode==="public";const clientConfig={...config,publicMode};const clientInstance=McpTestClient.create({baseUrl:resolveClientBaseUrl(server,clientConfig),entryPath:clientConfig.entryPath,transport:clientConfig.transport??"streamable-http",publicMode}).build();try{await clientInstance.connect()}catch(err){const message=err instanceof Error?err.message:String(err);if(/\b401\b|unauthor/i.test(message)){console.warn(`[TestFixture] MCP client could not connect anonymously \u2014 the server requires authentication (${message}). Tests using only the 'server'/'auth' fixtures are unaffected; tests using the 'mcp' fixture must supply a token.`)}else{throw err}}const context={extraClients:[]};const fixtures={mcp:clientInstance,auth:createAuthFixture(tokenFactory),server:createServerFixture(server,clientConfig,clientInstance,context)};fixtureContexts.set(fixtures,context);return fixtures}async function createTestFixtures(){return buildFixtures(scopes.slice())}async function initializeSharedResources(){await acquireServer(scopes.slice())}async function cleanupTestFixtures(fixtures,testFailed=false){if(testFailed){const logs=fixtures.server.getLogs();if(logs.length>0){console.error("\n[TestFixture] === Server Logs (test failed) ===");const recentLogs=logs.slice(-50);if(logs.length>50){console.error(`[TestFixture] (showing last 50 of ${logs.length} log entries)`)}console.error(recentLogs.join("\n"));console.error("[TestFixture] === End Server Logs ===\n")}}const extras=fixtureContexts.get(fixtures)?.extraClients??[];for(const client of extras){if(client.isConnected()){await client.disconnect().catch(()=>void 0)}}if(fixtures.mcp.isConnected()){await fixtures.mcp.disconnect()}}async function cleanupSharedResources(){await stopServers()}function resolveClientBaseUrl(server,config){return config.baseUrl??server.info.baseUrl}function createAuthFixture(factory){const users={admin:{sub:"admin-001",scopes:["admin:*","read","write","delete"],email:"admin@test.local",name:"Test Admin"},user:{sub:"user-001",scopes:["read","write"],email:"user@test.local",name:"Test User"},readOnly:{sub:"readonly-001",scopes:["read"],email:"readonly@test.local",name:"Read Only User"}};return{createToken:opts=>factory.createTestToken({sub:opts.sub,scopes:opts.scopes,claims:{email:opts.email,name:opts.name,...opts.claims},exp:opts.expiresIn}),createExpiredToken:opts=>factory.createExpiredToken(opts),createInvalidToken:opts=>factory.createTokenWithInvalidSignature(opts),users:{admin:users["admin"],user:users["user"],readOnly:users["readOnly"]},getJwks:()=>factory.getPublicJwks(),getIssuer:()=>factory.getIssuer(),getAudience:()=>factory.getAudience()}}function createServerFixture(server,config,mcp,context){return{get info(){return server.info},createClient:async opts=>{const client=await McpTestClient.create({baseUrl:resolveClientBaseUrl(server,config),entryPath:opts?.entryPath??config.entryPath,transport:opts?.transport??"streamable-http",auth:opts?.token?{token:opts.token}:void 0,clientInfo:opts?.clientInfo,publicMode:config.publicMode}).buildAndConnect();context.extraClients.push(client);return client},createClientBuilder:()=>{const builder=new McpTestClientBuilder({baseUrl:resolveClientBaseUrl(server,config),entryPath:config.entryPath,publicMode:config.publicMode});return builder},restart:async()=>{const reconnect=[mcp,...context.extraClients].filter(client=>client.isConnected());await server.restart();for(const client of reconnect){await client.reconnect()}},getLogs:()=>server.getLogs(),clearLogs:()=>server.clearLogs()}}function resolveServerCommand(server){if(server.includes(" ")){return server}return`npx tsx ${server}`}function runWithFixtures(fn,chain){return async(...extra)=>{const fixtures=await buildFixtures(chain);let failure;try{for(const scope of chain){for(const hook of scope.beforeEachHooks)await hook(fixtures)}await fn(fixtures,...extra)}catch(error){failure={error}}try{await runAfterEachHooks(chain,fixtures)}catch(error){failure??={error}}await cleanupTestFixtures(fixtures,failure!==void 0);if(failure)throw failure.error}}async function runAfterEachHooks(chain,fixtures){let firstError;let failed=false;for(let i=chain.length-1;i>=0;i--){for(const hook of chain[i].afterEachHooks){try{await hook(fixtures)}catch(error){if(!failed)firstError=error;failed=true}}}if(failed)throw firstError}function skipTitle(name,scope){return scope.reason?`${name} (skipped: ${scope.reason})`:name}function testWithFixtures(name,fn){const chain=scopes.slice();const scope=currentScope();if(scope.skipped){jestGlobals().it.skip(skipTitle(name,scope),runWithFixtures(fn,chain));return}jestGlobals().it(name,runWithFixtures(fn,chain))}function use(config){const scope=currentScope();const{env,...rest}=config;scope.config={...scope.config,...rest};if(env)scope.envs.push(env);scope.configured=true;if(!scope.cleanupRegistered){scope.cleanupRegistered=true;jestGlobals().afterAll(async()=>{await stopServers(scope===scopes[0]?void 0:scope)})}}function skip(nameOrCondition,fnOrReason){if(typeof nameOrCondition==="boolean"){if(nameOrCondition){const scope=currentScope();scope.skipped=true;scope.reason=typeof fnOrReason==="string"?fnOrReason:void 0}return}if(typeof fnOrReason!=="function"){throw new TypeError(`test.skip expects either (name: string, fn) or (condition: boolean, reason?: string); received (${typeof nameOrCondition}, ${typeof fnOrReason}).`)}jestGlobals().it.skip(nameOrCondition,runWithFixtures(fnOrReason,scopes.slice()))}function only(name,fn){const scope=currentScope();if(scope.skipped){jestGlobals().it.skip(skipTitle(name,scope),runWithFixtures(fn,scopes.slice()));return}jestGlobals().it.only(name,runWithFixtures(fn,scopes.slice()))}function todo(name){jestGlobals().it.todo(name)}function each(table,...tagged){const chain=scopes.slice();const register=jestGlobals().it.each(table,...tagged);return(name,fn)=>{const scope=currentScope();if(scope.skipped){const skipRegister=jestGlobals().it.skip.each(table,...tagged);skipRegister(skipTitle(name,scope),runWithFixtures(fn,chain));return}register(name,runWithFixtures(fn,chain))}}function withScope(fn){return(...args)=>{scopes.push(newScope(currentScope()));try{fn(...args)}finally{scopes.pop()}}}function scopedRegister(pick){return(name,fn,timeout)=>{pick()(name,withScope(fn),timeout)}}function scopedEach(pick){return(...eachArgs)=>(name,fn,timeout)=>{const register=pick()(...eachArgs);register(name,withScope(fn),timeout)}}var describeWithScope=Object.assign(scopedRegister(()=>jestGlobals().describe),{only:Object.assign(scopedRegister(()=>jestGlobals().describe.only),{each:scopedEach(()=>jestGlobals().describe.only.each)}),skip:Object.assign(scopedRegister(()=>jestGlobals().describe.skip),{each:scopedEach(()=>jestGlobals().describe.skip.each)}),each:scopedEach(()=>jestGlobals().describe.each)});function eachHook(kind){return(fn,timeout)=>{if(typeof fn==="function"&&fn.length>0){const scope=currentScope();(kind==="beforeEach"?scope.beforeEachHooks:scope.afterEachHooks).push(fn);return}jestGlobals()[kind](fn,timeout)}}var test=testWithFixtures;test.use=use;test.describe=describeWithScope;test.beforeAll=((...args)=>jestGlobals().beforeAll(...args));test.beforeEach=eachHook("beforeEach");test.afterEach=eachHook("afterEach");test.afterAll=((...args)=>jestGlobals().afterAll(...args));test.skip=skip;test.only=only;test.todo=todo;test.each=each;export{cleanupSharedResources,cleanupTestFixtures,createTestFixtures,initializeSharedResources,test};