@frontmcp/sdk 1.8.7 → 1.9.0

package/transport/transport.registry.d.ts

@@ -1,7 +1,8 @@
 import type { StoredSession } from '@frontmcp/auth';
-import type { ServerResponse, TransportPersistenceConfigInput } from '../common';
+import type { ServerRequest, ServerResponse, TransportPersistenceConfigInput } from '../common';
+import type { ClaimedSessionInfo } from '../ha';
 import type { Scope } from '../scope';
-import { type TransportBus, type Transporter, type TransportType } from './transport.types';
+import { type RemoteLocation, type TransportBus, type Transporter, type TransportType } from './transport.types';
 export declare class TransportService {
     readonly ready: Promise<void>;
     private readonly byType;
@@ -70,6 +71,14 @@ export declare class TransportService {
     private destroyed;
     /** Last time a request refreshed the stored session's TTL, by session id. */
     private readonly lastTtlRefreshAt;
+    /** Last time a request re-advertised a served session on the transport bus, by session id. */
+    private readonly lastBusRefreshAt;
+    /** Session ids with a transport on this node (any type / token), with their transport count. */
+    private readonly localSessionIds;
+    /** The HA liveness generation in which this node last confirmed it owns a local session, by session id. */
+    private readonly ownershipGeneration;
+    /** Sessions whose local transports are being dropped because another node owns them now. */
+    private readonly relinquishing;
     /**
      * Redis key prefix under which session records are stored.
      * The session store appends `session:` to the transport key prefix.
@@ -116,6 +125,8 @@ export declare class TransportService {
     /** The backend kind selected at construction (`undefined` if none). Used by
      *  the orphan-sqlite WARN guard in scope.instance.ts and by error telemetry. */
     getBackendKind(): 'redis' | 'vercel-kv' | 'sqlite' | undefined;
+    /** The configured backend as an operator reads it in a log line. */
+    private sessionStoreLabel;
     /**
      * Slide the stored session's TTL while this instance is serving it. Redis and Vercel KV
      * session stores extend the TTL on read, so a plain `get` is enough. Throttled per session
@@ -123,6 +134,47 @@ export declare class TransportService {
      */
     private refreshStoredSessionTtl;
     getTransporter(type: TransportType, token: string, sessionId: string): Promise<Transporter | undefined>;
+    /**
+     * Distributed routing: the node a request must be relayed to, because another live node
+     * owns the session it presents. `undefined` means "serve it here": the session is local,
+     * unknown, owned by this node, or owned by a node that stopped (this node takes it over).
+     *
+     * Runs before authentication — it only decides where the request is served; the owner
+     * authenticates it. Only session ids this deployment minted cost a Redis lookup.
+     */
+    findRemoteSessionOwner(request: ServerRequest): Promise<RemoteLocation | undefined>;
+    /**
+     * The node that owns a session: the transport bus entry, else the persisted session record.
+     * `undefined` when neither knows the session.
+     */
+    lookupSessionOwner(sessionId: string): Promise<RemoteLocation | undefined>;
+    /**
+     * Relay a request to the node that owns its session and write that node's response.
+     * @throws SessionOwnerUnreachableError when the owner could not serve it (nothing written yet).
+     */
+    relayToSessionOwner(location: RemoteLocation, request: ServerRequest, response: ServerResponse): Promise<void>;
+    /**
+     * The orphan scanner claimed a session of a stopped node for this node: point the
+     * transport bus at this node, so every node relays the session's requests here. The
+     * transport itself is recreated from the session store by the first request.
+     */
+    adoptClaimedSession(sessionId: string, previousNodeId: string, info: ClaimedSessionInfo): Promise<void>;
+    /**
+     * Destroy this node's transports for a session (asked by another node through the relay).
+     * @returns Whether a transport was found.
+     */
+    destroyLocalSession(sessionId: string, reason?: string): Promise<boolean>;
+    /**
+     * Whether this node still owns a session it holds a transport for. After a gap in this node's
+     * heartbeat another node may have taken the session over: the persisted record decides, once per
+     * liveness generation, and a session that moved is dropped here (its record is left to the new owner).
+     * When the record cannot be read the session is served here, and checked again on its next request.
+     */
+    private holdsLocalSession;
+    /** Whether a node's heartbeat is present (`true` when liveness cannot be determined). */
+    private isNodeAlive;
+    /** Re-advertise a session this node serves, so its bus entry does not expire under it. */
+    private refreshBusAdvertisement;
     /**
      * Get stored session from Redis (without creating a transport).
      * Used by flows to check if session exists and can be recreated.
@@ -151,6 +203,11 @@ export declare class TransportService {
      * @returns The recreated transport
      */
     recreateTransporter(type: TransportType, token: string, sessionId: string, storedSession: StoredSession, res: ServerResponse): Promise<Transporter>;
+    /**
+     * A transporter that relays to `ownerNodeId` when that node is alive and the transport bus
+     * is available; `undefined` when the owner stopped (its session can be taken over).
+     */
+    private remoteOwnerTransporter;
     /**
      * Internal method to actually recreate the transport (called with mutex protection)
      */
@@ -160,6 +217,8 @@ export declare class TransportService {
      * Internal method to actually create the transport (called with mutex protection)
      */
     private doCreateTransporter;
+    /** A session transport went away: forget it, and its bus entry and stored record unless another node owns them now. */
+    private onSessionTransportDisposed;
     destroyTransporter(type: TransportType, token: string, sessionId: string, reason?: string): Promise<void>;
     /**
      * Update the stored session in Redis with client capabilities from the initialize handshake.

package/transport/transport.registry.d.ts.map

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

package/transport/transport.remote.d.ts

@@ -1,20 +1,31 @@
 import { type ServerResponse } from '../common';
 import { type AuthenticatedServerRequest } from '../server/server.types';
-import { type TransportBus, type Transporter, type TransportKey, type TransportType } from './transport.types';
+import { type RemoteLocation, type TransportBus, type Transporter, type TransportKey, type TransportType } from './transport.types';
+/**
+ * Transporter for a session owned by another live node of a distributed deployment.
+ *
+ * Requests are relayed to the owning node, which serves them on its own transport;
+ * its response is streamed back to this node's client. When the owner cannot be
+ * reached the client gets a retryable `503` instead.
+ */
 export declare class RemoteTransporter implements Transporter {
     private readonly key;
     private readonly bus;
+    private readonly location;
     readonly type: TransportType;
     readonly tokenHash: string;
     readonly sessionId: string;
-    constructor(key: TransportKey, bus: TransportBus);
-    ping(timeoutMs?: number): Promise<boolean>;
+    constructor(key: TransportKey, bus: TransportBus, location: RemoteLocation);
+    /** The node that owns the session. */
+    get ownerNodeId(): string;
+    ping(_timeoutMs?: number): Promise<boolean>;
     initialize(req: AuthenticatedServerRequest, res: ServerResponse): Promise<void>;
-    handleRequest(_req: AuthenticatedServerRequest, _res: ServerResponse): Promise<void>;
-    destroy(_reason?: string): Promise<void>;
+    handleRequest(req: AuthenticatedServerRequest, res: ServerResponse): Promise<void>;
+    destroy(reason?: string): Promise<void>;
     get isInitialized(): boolean;
     markAsInitialized(): void;
     resetForReinitialization(): void;
     reregisterServer(): void;
+    private relay;
 }
 //# sourceMappingURL=transport.remote.d.ts.map

package/transport/transport.remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.remote.d.ts","sourceRoot":"","sources":["../../src/transport/transport.remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE/G,qBAAa,iBAAkB,YAAW,WAAW;IAMjD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGR,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,YAAY;IAMpC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,UAAU,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,aAAa,CAAC,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpF,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,iBAAiB,IAAI,IAAI;IAIzB,wBAAwB,IAAI,IAAI;IAIhC,gBAAgB,IAAI,IAAI;CAGzB"}
+{"version":3,"file":"transport.remote.d.ts","sourceRoot":"","sources":["../../src/transport/transport.remote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IAMjD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGR,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,cAAc;IAO3C,sCAAsC;IACtC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C,UAAU,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,aAAa,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,iBAAiB,IAAI,IAAI;IAIzB,wBAAwB,IAAI,IAAI;IAIhC,gBAAgB,IAAI,IAAI;YAIV,KAAK;CAUpB"}

package/transport/transport.types.d.ts

@@ -1,4 +1,4 @@
-import { type ServerResponse } from '../common';
+import { type ServerRequest, type ServerResponse } from '../common';
 import { type AuthenticatedServerRequest } from '../server/server.types';
 export type TransportType = 'sse' | 'streamable-http' | 'http' | 'stateless-http' | 'in-memory' | 'stdio';
 /** Session id the stateless HTTP transport gives every request; it identifies no client. */
@@ -14,21 +14,30 @@ export interface RemoteLocation {
     nodeId: string;
     channel: string;
 }
+/**
+ * Distributed session registry: which node owns which session, and the relay that
+ * serves a request on the owning node.
+ */
 export interface TransportBus {
     nodeId(): string;
+    /** Record that this node owns the session. */
     advertise(key: TransportKey): Promise<void>;
+    /** Drop this node's ownership record (only when it still owns the session). */
     revoke(key: TransportKey): Promise<void>;
+    /** The node owning this exact session (same type and token), unless it is this node. */
     lookup(key: TransportKey): Promise<RemoteLocation | null>;
-    proxyRequest(key: TransportKey, payload: {
-        method?: string;
-        url?: string;
-        headers?: Record<string, string | string[] | undefined>;
-    }, io: {
-        onResponseStart(statusCode: number, headers: Record<string, string>): void;
-        onResponseChunk(chunk: Uint8Array | string): void;
-        onResponseEnd(finalChunk?: Uint8Array | string): void;
-        onError?(err: Error | string): void;
-    }): Promise<void>;
+    /** The node owning a session id, whatever its type or token — this node included. */
+    lookupOwner(sessionId: string): Promise<RemoteLocation | null>;
+    /** Relay channel of a node. */
+    channelOf(nodeId: string): string;
+    /** Whether requests can be relayed to another node from here. */
+    canRelay(): boolean;
+    /**
+     * Serve a request on the node that owns its session and write that node's response.
+     * @throws SessionOwnerUnreachableError when the owner could not serve it (nothing written yet).
+     */
+    proxyRequest(location: RemoteLocation, sessionId: string, request: ServerRequest, response: ServerResponse): Promise<void>;
+    /** Ask the owning node to destroy its transport for the session. */
     destroyRemote(key: TransportKey, reason?: string): Promise<void>;
 }
 export interface Transporter {

package/transport/transport.types.d.ts.map

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

package/transport/web-fetch-handler.d.ts

@@ -1,3 +1,5 @@
+import { type MetricsOptionsInterface } from '../common/types/options/metrics';
+import { type MetricsService } from '../metrics/metrics.service';
 import { type Scope } from '../scope/scope.instance';
 import { type WebStandardMcpPair } from './web-standard-mcp';
 /**
@@ -81,6 +83,15 @@ export interface CreateWebFetchHandlerOptions {
      * in the adapter regardless.
      */
     sessionRouter?: WebFetchSessionRouter;
+    /**
+     * The `/metrics` endpoint (`@FrontMcp({ metrics: { enabled: true } })`).
+     * `createFetchHandler()` passes the server's service here, as the Express
+     * host registers it as a route, so both answer the same scrape.
+     */
+    metrics?: {
+        service: MetricsService;
+        config: MetricsOptionsInterface;
+    };
 }
 /**
  * Build a Web-standard fetch handler for a Scope.

package/transport/web-fetch-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-fetch-handler.d.ts","sourceRoot":"","sources":["../../src/transport/web-fetch-handler.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAIrD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,0CAA0C;IAC1C,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,8BAA8B;IAC9B,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3D;AA2BD,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5G;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,OAAO,EACZ,GAAG,CAAC,EAAE,eAAe,KAClB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,2GAA2G;IAC3G,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACrC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2GAA2G;IAC3G,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAwL/G;AAkED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,eAAe,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAAO,GACnF,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAgB/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,eAAe,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAiB/B;AAqFD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAI7E;AAOD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;IAC9C;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,gGAAgG;IAChG,iBAAiB,IAAI,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EACnD,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACzE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAkC3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,SAAI,GAAG,QAAQ,CAatF"}
+{"version":3,"file":"web-fetch-handler.d.ts","sourceRoot":"","sources":["../../src/transport/web-fetch-handler.ts"],"names":[],"mappings":"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"}

package/transport/web-standard-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-standard-mcp.d.ts","sourceRoot":"","sources":["../../src/transport/web-standard-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACnG,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtC,SAAS,EAAE;QACT,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;SAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC;IACF,gGAAgG;IAChG,KAAK,CAAC,EAAE,2BAA2B,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,aAAa,EAAE,mBAAmB,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,0GAA0G;IAC1G,GAAG,EAAE,OAAO,CAAC;IACb,yGAAyG;IACzG,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD;;;;OAIG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AA+BD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,2BAA2B,CAAA;CAAE,GAClE,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAsCnB"}
+{"version":3,"file":"web-standard-mcp.d.ts","sourceRoot":"","sources":["../../src/transport/web-standard-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACnG,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE;QAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtC,SAAS,EAAE;QACT,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;SAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC;IACF,gGAAgG;IAChG,KAAK,CAAC,EAAE,2BAA2B,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,aAAa,EAAE,mBAAmB,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,0GAA0G;IAC1G,GAAG,EAAE,OAAO,CAAC;IACb,yGAAyG;IACzG,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IACtD;;;;OAIG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAkCD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,2BAA2B,CAAA;CAAE,GAClE,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAsCnB"}

package/utils/dynamic-import.utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Load a module lazily with a dynamic `import()`, falling back to `require` when the runtime
+ * cannot run the dynamic import.
+ *
+ * The SDK's CommonJS build keeps `import()` for lazily loaded packages. Jest runs CommonJS
+ * modules in a `vm` context, where a dynamic `import()` throws
+ * `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING_FLAG` unless the whole run uses
+ * `--experimental-vm-modules` — and with that flag on, Jest's ESM loader can fail on a CommonJS
+ * package instead. Either way a FrontMCP server started inside a test (`createHandler()`,
+ * `createDirect()`, `connect()`) died on the first lazy import (#680).
+ *
+ * The dynamic import is tried first, so bundlers (browser, worker) and native ESM keep their
+ * behaviour; `require` is only used after it failed and where one exists. When the fallback fails
+ * too, the ORIGINAL error is rethrown, so a genuinely missing package is still reported as such.
+ *
+ * Pass literal specifiers in both callbacks (`() => import('pkg')`, `() => require('pkg')`) so
+ * bundlers can see them.
+ */
+export declare function importWithRequireFallback<T>(dynamicImport: () => Promise<T>, requireFallback: () => T): Promise<T>;
+//# sourceMappingURL=dynamic-import.utils.d.ts.map

package/utils/dynamic-import.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-import.utils.d.ts","sourceRoot":"","sources":["../../src/utils/dynamic-import.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC/B,eAAe,EAAE,MAAM,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/workflow/engine/workflow-step.executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-step.executor.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine/workflow-step.executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAMrG,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAEtC,WAAW,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,yBAAyB;IAMjG,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAwDpF,kBAAkB;CAyBjC"}
+{"version":3,"file":"workflow-step.executor.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine/workflow-step.executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAMrG,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAEtC,WAAW,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,yBAAyB;IAMjG,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAwDpF,kBAAkB;CAkCjC"}