@frontmcp/testing 1.11.2 → 1.12.0-rc.1

package/perf/perf-fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"perf-fixtures.d.ts","sourceRoot":"","sources":["../../src/perf/perf-fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAEtF;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IASjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAA6B;gBAG7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAMlC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAMvC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY;IAIrC;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoB7G;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,iBAAiB,CACrB,gBAAgB,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,EACvF,OAAO,EAAE,4BAA4B,GAAG;QAAE,aAAa,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;KAAE,GAC3F,OAAO,CAAC,2BAA2B,CAAC;IAoBvC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IA6ElD;;OAEG;IACH,eAAe,IAAI,YAAY,EAAE;IAIjC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACH,gBAAgB,IAAI,eAAe;IAuBnC;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd;AAiBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAE5E"}
+{"version":3,"file":"perf-fixtures.d.ts","sourceRoot":"","sources":["../../src/perf/perf-fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAEtF;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IASjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAA6B;gBAG7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAMlC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAMvC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY;IAIrC;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoB7G;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,iBAAiB,CACrB,gBAAgB,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,OAAO,CAAC,IAAI,CAAC,EACvF,OAAO,EAAE,4BAA4B,GAAG;QAAE,aAAa,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;KAAE,GAC3F,OAAO,CAAC,2BAA2B,CAAC;IAoBvC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IA6ElD;;OAEG;IACH,eAAe,IAAI,YAAY,EAAE;IAIjC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACH,gBAAgB,IAAI,eAAe;IAuBnC;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd;AAiBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAE5E"}

package/perf/regression-detector.d.ts

@@ -2,7 +2,7 @@
  * @file regression-detector.ts
  * @description Performance regression detection by comparing current metrics to baseline
  */
-import type { RegressionConfig, RegressionResult, MetricRegression, PerfMeasurement, TestBaseline, PerfBaseline } from './types';
+import type { MetricRegression, PerfBaseline, PerfMeasurement, RegressionConfig, RegressionResult, TestBaseline } from './types';
 /**
  * Detects performance regressions by comparing current metrics to baseline.
  */

package/perf/regression-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regression-detector.d.ts","sourceRoot":"","sources":["../../src/perf/regression-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAiBjB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,gBAAgB;IAuCxF;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAe/F;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAerB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,YAAY,GACtC,gBAAgB,EAAE,CAEpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,IAAI,CAYrF;AAQD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAKnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}
+{"version":3,"file":"regression-detector.d.ts","sourceRoot":"","sources":["../../src/perf/regression-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAgBjB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,gBAAgB;IAuCxF;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAe/F;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAerB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,YAAY,GACtC,gBAAgB,EAAE,CAEpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,IAAI,CAYrF;AAQD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAKnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/server/port-registry.d.ts

@@ -184,6 +184,22 @@ export declare const E2E_PORT_RANGES: {
         readonly start: 50500;
         readonly size: 10;
     };
+    readonly 'demo-e2e-events': {
+        readonly start: 50530;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-events-appointments': {
+        readonly start: 50540;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-events-daemon': {
+        readonly start: 50550;
+        readonly size: 10;
+    };
+    readonly 'demo-e2e-events-mail-triage': {
+        readonly start: 50560;
+        readonly size: 10;
+    };
     readonly 'mock-oauth': {
         readonly start: 50900;
         readonly size: 10;

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

@@ -1 +1 @@
-{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/server/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoElB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAC;AA2CtD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAuDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM7E;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAgE7F;AAmDD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/F"}
+{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../src/server/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ElB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,eAAe,CAAC;AA2CtD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAuDD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM7E;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAgE7F;AAmDD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/F"}

package/transport/mcp-20260728.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file mcp-20260728.ts
+ * @description The wire format of MCP protocol revision 2026-07-28: per-request `_meta` and mirrored headers
+ */
+import { type SubscriptionFilter } from '@frontmcp/protocol';
+import type { JsonRpcRequest, JsonRpcResponse } from './transport.interface';
+/** Whether a request travels as 2026-07-28: the client speaks it, or the method exists only in it. */
+export declare function isStatelessRequest(protocolVersion: string | undefined, method: string | undefined): boolean;
+/** A header value, Base64-wrapped in the `=?base64?…?=` sentinel when it isn't plain visible ASCII. */
+export declare function encodeHeaderValue(value: string): string;
+/** The request with the client's `_meta` added; keys the caller set in `_meta` win. */
+export declare function withRequestMeta(message: JsonRpcRequest, meta: Record<string, unknown>): JsonRpcRequest;
+/** The headers a 2026-07-28 request mirrors from its body. `toolInputSchema` is the called tool's, when known. */
+export declare function revisionHeaders(message: JsonRpcRequest | undefined, toolInputSchema?: unknown): Record<string, string>;
+/** The JSON-RPC error an HTTP error's body carries, if it carries one. */
+export declare function jsonRpcErrorIn(body: string): JsonRpcResponse | undefined;
+/** The filter a `notifications/subscriptions/acknowledged` event acknowledges, or undefined for any other event. */
+export declare function acknowledgedFilterIn(eventData: string): SubscriptionFilter | undefined;
+//# sourceMappingURL=mcp-20260728.d.ts.map

package/transport/mcp-20260728.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-20260728.d.ts","sourceRoot":"","sources":["../../src/transport/mcp-20260728.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAc7E,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG3G;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAItG;AAED,kHAAkH;AAClH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,eAAe,CAAC,EAAE,OAAO,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAuBD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CASxE;AAED,oHAAoH;AACpH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAQtF"}

package/transport/streamable-http.transport.d.ts

@@ -2,9 +2,10 @@
  * @file streamable-http.transport.ts
  * @description StreamableHTTP transport implementation for MCP Test Client
  */
+import { type SubscriptionFilter } from '@frontmcp/protocol';
 import type { ElicitationHandler } from '../client/mcp-test-client.types';
 import type { InterceptorChain } from '../interceptor';
-import type { JsonRpcRequest, JsonRpcResponse, McpTransport, TransportConfig, TransportState } from './transport.interface';
+import type { JsonRpcRequest, JsonRpcResponse, McpTransport, NotificationHandler, TransportConfig, TransportState } from './transport.interface';
 /**
  * StreamableHTTP transport for MCP communication
  *
@@ -26,6 +27,10 @@ export declare class StreamableHttpTransport implements McpTransport {
     private notificationStream?;
     private notificationProtocolVersion;
     private notificationStreamReopenTimer?;
+    private subscriptionStream?;
+    private readonly protocolVersion?;
+    private readonly requestMeta;
+    private readonly toolInputSchemas;
     constructor(config: TransportConfig);
     connect(): Promise<void>;
     /**
@@ -39,6 +44,9 @@ export declare class StreamableHttpTransport implements McpTransport {
     notify(message: JsonRpcRequest): Promise<void>;
     sendRaw(data: string): Promise<JsonRpcResponse>;
     openNotificationStream(protocolVersion: string): Promise<void>;
+    listen(id: string | number, notifications: SubscriptionFilter): Promise<SubscriptionFilter | undefined>;
+    /** Send a long-lived request with no timeout, handing its notifications on as they arrive. */
+    streamRequest(message: JsonRpcRequest, onNotification: NotificationHandler, signal: AbortSignal): Promise<JsonRpcResponse | undefined>;
     close(): Promise<void>;
     isConnected(): boolean;
     getState(): TransportState;
@@ -57,7 +65,12 @@ export declare class StreamableHttpTransport implements McpTransport {
     /** Opens the stream without holding up the caller past the request timeout; close() aborts it at any point. */
     private connectNotificationStream;
     private releaseNotificationStream;
+    private closeSubscriptionStream;
+    /** Posts `subscriptions/listen`, acknowledges the accepted filter, then records the notifications. */
+    private readSubscriptionStream;
     private readNotificationStream;
+    private readEventStream;
+    private rememberToolInputSchemas;
     /**
      * Handle SSE response with elicitation support.
      *
@@ -87,6 +100,7 @@ export declare class StreamableHttpTransport implements McpTransport {
      * behaviour (`${baseUrl}/`) relied on it (issue #543).
      */
     private mcpUrl;
+    /** `stateless` sends the request as 2026-07-28: no session, and the headers mirrored from `message`. */
     private buildHeaders;
     private ensureConnected;
     private log;

package/transport/streamable-http.transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamable-http.transport.d.ts","sourceRoot":"","sources":["../../src/transport/streamable-http.transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAwC,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EAEZ,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAK/B;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IACF,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;IAC3D,OAAO,CAAC,kBAAkB,CAAC,CAAkB;IAC7C,OAAO,CAAC,2BAA2B,CAAM;IACzC,OAAO,CAAC,6BAA6B,CAAC,CAAgC;gBAE1D,MAAM,EAAE,eAAe;IAmB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B9B;;;OAGG;YACW,qBAAqB;IAqC7B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;IA8HxF,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmD/C,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,WAAW,IAAI,OAAO;IAItB,QAAQ,IAAI,cAAc;IAI1B,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAIrD,eAAe,IAAI,gBAAgB,GAAG,SAAS;IAI/C,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI;IAIpE,kBAAkB,IAAI,MAAM;IAI5B,iBAAiB,IAAI,MAAM;IAI3B,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIzC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD,OAAO,CAAC,uBAAuB;IAM/B,+GAA+G;YACjG,yBAAyB;IAiCvC,OAAO,CAAC,yBAAyB;YAInB,sBAAsB;IA6BpC;;;;;OAKG;YACW,gCAAgC;IA+F9C;;OAEG;IACH,OAAO,CAAC,cAAc;IAiDtB;;OAEG;YACW,cAAc;IA+C5B;;OAEG;YACW,wBAAwB;IAqCtC;;OAEG;YACW,uBAAuB;IA8BrC;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,YAAY;IA+BpB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,GAAG;IAMX;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,2BAA2B;CAsDpC"}
+{"version":3,"file":"streamable-http.transport.d.ts","sourceRoot":"","sources":["../../src/transport/streamable-http.transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA0C,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGrG,OAAO,KAAK,EAAwC,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASvD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAK/B;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAgBrB;IACF,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;IAC3D,OAAO,CAAC,kBAAkB,CAAC,CAAkB;IAC7C,OAAO,CAAC,2BAA2B,CAAM;IACzC,OAAO,CAAC,6BAA6B,CAAC,CAAgC;IACtE,OAAO,CAAC,kBAAkB,CAAC,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;gBAEnD,MAAM,EAAE,eAAe;IA0B7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B9B;;;OAGG;YACW,qBAAqB;IAqC7B,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;IAoIxF,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmD/C,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,aAAa,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAoB7G,8FAA8F;IACxF,aAAa,CACjB,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,mBAAmB,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAmCjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,WAAW,IAAI,OAAO;IAItB,QAAQ,IAAI,cAAc;IAI1B,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI;IAIrD,eAAe,IAAI,gBAAgB,GAAG,SAAS;IAI/C,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI;IAIpE,kBAAkB,IAAI,MAAM;IAI5B,iBAAiB,IAAI,MAAM;IAI3B,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIzC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD,OAAO,CAAC,uBAAuB;IAM/B,+GAA+G;YACjG,yBAAyB;IAiCvC,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,uBAAuB;IAK/B,sGAAsG;YACxF,sBAAsB;YA6BtB,sBAAsB;YAatB,eAAe;IAuB7B,OAAO,CAAC,wBAAwB;IAQhC;;;;;OAKG;YACW,gCAAgC;IA+F9C;;OAEG;IACH,OAAO,CAAC,cAAc;IAiDtB;;OAEG;YACW,cAAc;IA+C5B;;OAEG;YACW,wBAAwB;IAqCtC;;OAEG;YACW,uBAAuB;IA8BrC;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAWd,wGAAwG;IACxG,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,GAAG;IAMX;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,2BAA2B;CAsDpC"}

package/transport/transport.interface.d.ts

@@ -2,7 +2,8 @@
  * @file transport.interface.ts
  * @description Interface for MCP transport implementations
  */
-import type { ClientInfo, ElicitationHandler } from '../client/mcp-test-client.types';
+import type { LoggingLevel, SubscriptionFilter } from '@frontmcp/protocol';
+import type { ClientInfo, ElicitationHandler, TestClientCapabilities } from '../client/mcp-test-client.types';
 export interface JsonRpcRequest {
     jsonrpc: '2.0';
     id?: string | number;
@@ -111,6 +112,17 @@ export interface McpTransport {
      * @param protocolVersion - The version negotiated at initialize, sent as `MCP-Protocol-Version`
      */
     openNotificationStream?(protocolVersion: string): Promise<void>;
+    /**
+     * Protocol 2026-07-28: open a `subscriptions/listen` stream, replacing the one open before, and
+     * hand its notifications to the notification handler.
+     * @returns The notification types the server acknowledged, or undefined when it opened no stream
+     */
+    listen?(id: string | number, notifications: SubscriptionFilter): Promise<SubscriptionFilter | undefined>;
+    /**
+     * Send a long-lived request, such as `events/stream`, without a timeout: hand each notification of its response
+     * stream to `onNotification`, and resolve with its final response, or undefined when `signal` ended it first.
+     */
+    streamRequest?(message: JsonRpcRequest, onNotification: NotificationHandler, signal: AbortSignal): Promise<JsonRpcResponse | undefined>;
 }
 /**
  * Configuration for transport implementations
@@ -144,6 +156,12 @@ export interface TransportConfig {
     interceptors?: import('../interceptor').InterceptorChain;
     /** Client info for User-Agent header (enables platform detection on server) */
     clientInfo?: ClientInfo;
+    /** The protocol revision; `'2026-07-28'` sends every request statelessly, with its `_meta` and mirrored headers */
+    protocolVersion?: string;
+    /** Protocol 2026-07-28: the capabilities each request declares in its `_meta` */
+    capabilities?: TestClientCapabilities;
+    /** Protocol 2026-07-28: the log level each request asks for in its `_meta` */
+    logLevel?: LoggingLevel;
     /** Handler for server→client elicitation requests during tool execution */
     elicitationHandler?: ElicitationHandler;
     /** Handler for server notifications streamed during a request */

package/transport/transport.interface.d.ts.map

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

package/webhook/webhook-receiver.d.ts

@@ -0,0 +1,85 @@
+import { type EventWebhookReceiver } from '@frontmcp/sdk';
+import type { WebhookSignatureCheck } from '@frontmcp/utils';
+export interface WebhookReceiverOptions {
+    /**
+     * The secrets deliveries of any subscription are signed with. A request none of them signed is answered 401. Without
+     * any, and without a secret an events client registered, nothing is checked.
+     */
+    secrets?: string[];
+    /** The path prefixes the well-known document declares. Without any, the document is a 404 and the challenge is used. */
+    receivers?: string[];
+    /** The path deliveries are sent to. @default '/hooks/mcp' */
+    path?: string;
+    /** @default an ephemeral port */
+    port?: number;
+}
+export interface WebhookReceiverInfo {
+    /** The callback URL to subscribe with. */
+    url: string;
+    origin: string;
+    port: number;
+}
+export type ReceivedWebhookKind = 'verification' | 'gap' | 'terminated' | 'event';
+export interface ReceivedWebhook {
+    kind: ReceivedWebhookKind;
+    path: string;
+    /** The body exactly as it arrived: the bytes the signature covers. */
+    body: string;
+    /** The body as JSON, or undefined when it is not JSON. */
+    json: Record<string, unknown> | undefined;
+    webhookId?: string;
+    webhookTimestamp?: string;
+    webhookSignature?: string;
+    subscriptionId?: string;
+    /** `unchecked` when the receiver has no secret for the request's subscription. */
+    signatureCheck: WebhookSignatureCheck | 'unchecked';
+    /** The status the receiver answered with. */
+    answeredStatus: number;
+    receivedAt: number;
+}
+/** An HTTP server on 127.0.0.1 that stands in for the callback of a webhook subscription. */
+export declare class WebhookReceiver {
+    private readonly options;
+    private readonly events;
+    private readonly received;
+    private server;
+    private info;
+    private failuresLeft;
+    private failureStatus;
+    private echoesChallenges;
+    /** A receiver that is not listening yet. */
+    constructor(options?: WebhookReceiverOptions);
+    /** The SDK receiver behind it, for `withEvents({ webhook: { url, receiver } })` of an events client. */
+    get eventReceiver(): EventWebhookReceiver;
+    /** Listen on 127.0.0.1 and answer with the callback URL. */
+    start(): Promise<WebhookReceiverInfo>;
+    /** Stop listening. */
+    stop(): Promise<void>;
+    /** The callback URL; the receiver must be started. */
+    get url(): string;
+    /** Every request received, oldest first. */
+    get requests(): readonly ReceivedWebhook[];
+    /** The verification challenges received. */
+    verifications(): ReceivedWebhook[];
+    /** The event deliveries received, retries included. */
+    deliveries(): ReceivedWebhook[];
+    /** Forget the requests received so far. */
+    clear(): void;
+    /** Accept deliveries signed with one more secret, as after a rotation. */
+    addSecret(secret: string): void;
+    /** Answer the next `count` deliveries with `status` instead of 200. Verification challenges are not affected. */
+    failNext(count: number, status?: number): void;
+    /** Whether a verification challenge is echoed (the default) or answered with an empty object. */
+    echoChallenges(echo: boolean): void;
+    /** Resolve once `count` event deliveries arrived, retries included; reject after `timeoutMs`. */
+    waitForDeliveries(count: number, timeoutMs?: number): Promise<ReceivedWebhook[]>;
+    /** Answer one request: the well-known document, or a webhook that is checked, recorded and answered. */
+    private handle;
+    /** The answer to a webhook: unchecked without secrets, a pending failure for a signed delivery, else the SDK's. */
+    private answer;
+    /** Serve the well-known document when the receiver declares path prefixes. */
+    private answerWellKnown;
+    /** The status of the next delivery: a pending failure, else 200. */
+    private nextDeliveryStatus;
+}
+//# sourceMappingURL=webhook-receiver.d.ts.map

package/webhook/webhook-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-receiver.d.ts","sourceRoot":"","sources":["../../src/webhook/webhook-receiver.ts"],"names":[],"mappings":"AAiBA,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM7D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wHAAwH;IACxH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,cAAc,EAAE,qBAAqB,GAAG,WAAW,CAAC;IACpD,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkCD,6FAA6F;AAC7F,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,gBAAgB,CAAQ;IAEhC,4CAA4C;gBAChC,OAAO,GAAE,sBAA2B;IAKhD,wGAAwG;IACxG,IAAI,aAAa,IAAI,oBAAoB,CAExC;IAED,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAY3C,sBAAsB;IAChB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,sDAAsD;IACtD,IAAI,GAAG,IAAI,MAAM,CAGhB;IAED,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,SAAS,eAAe,EAAE,CAEzC;IAED,4CAA4C;IAC5C,aAAa,IAAI,eAAe,EAAE;IAIlC,uDAAuD;IACvD,UAAU,IAAI,eAAe,EAAE;IAI/B,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAIb,0EAA0E;IAC1E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,iHAAiH;IACjH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAK3C,iGAAiG;IACjG,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAInC,iGAAiG;IAC3F,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAapF,wGAAwG;YAC1F,MAAM;IAgCpB,mHAAmH;YACrG,MAAM;IAqBpB,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IAUvB,oEAAoE;IACpE,OAAO,CAAC,kBAAkB;CAK3B"}