@frontmcp/sdk 1.8.7 → 1.9.0

package/transport/bus/redis-transport-bus.d.ts

@@ -1,20 +1,19 @@
 /**
  * Redis Transport Bus — Distributed Session Location Registry
  *
- * Maps sessions to the pods that own them using Redis Hash keys.
- * Used by TransportService in distributed mode to discover which
- * pod owns a given session and (optionally) relay operations to it.
+ * Maps sessions to the pods that own them using one Redis Hash per session id.
+ * Used by TransportService in distributed mode to discover which pod owns a
+ * given session, and to relay a request for it to that pod.
  */
+import type { ServerRequest, ServerResponse } from '../../common';
+import type { SessionRelay } from '../relay/session-relay';
 import type { RemoteLocation, TransportBus, TransportKey } from '../transport.types';
 /**
  * Minimal Redis client interface for the transport bus.
  * Subset of ioredis — allows plugging any compatible client.
  */
 export interface BusRedisClient {
-    hset(key: string, field: string, value: string): Promise<number>;
-    hdel(key: string, ...fields: string[]): Promise<number>;
-    hget(key: string, field: string): Promise<string | null>;
-    expire(key: string, seconds: number): Promise<number>;
+    hgetall(key: string): Promise<Record<string, string>>;
     del(key: string): Promise<number>;
     publish(channel: string, message: string): Promise<number>;
     eval(script: string, numkeys: number, ...args: (string | number)[]): Promise<unknown>;
@@ -29,6 +28,8 @@ export interface RedisTransportBusOptions {
     ttlSeconds?: number;
     /** HA relay key prefix for destroy commands. @default 'mcp:ha:' */
     haKeyPrefix?: string;
+    /** `Retry-After` (seconds) given when a request cannot be relayed. @default 30 */
+    retryAfterSeconds?: number;
     /** Logger (optional) */
     logger?: {
         info: (msg: string, meta?: Record<string, unknown>) => void;
@@ -39,12 +40,9 @@ export interface RedisTransportBusOptions {
 /**
  * Redis-backed TransportBus implementation.
  *
- * For each session, stores a Hash with nodeId and channel fields.
- * The bus provides session-to-node mapping for distributed lookups
- * and destroy-remote via pub/sub relay.
- *
- * Note: `proxyRequest()` is deferred — session recreation via
- * TransportService.recreateTransporter() handles cross-pod requests.
+ * For each session id, stores a Hash with the owning node, its relay channel,
+ * and the session's transport type and token hash. Requests are relayed to the
+ * owner through the {@link SessionRelay} attached with {@link attachRelay}.
  */
 export declare class RedisTransportBus implements TransportBus {
     private readonly redis;
@@ -52,12 +50,18 @@ export declare class RedisTransportBus implements TransportBus {
     private readonly keyPrefix;
     private readonly ttlSeconds;
     private readonly haKeyPrefix;
+    private readonly retryAfterSeconds;
     private readonly logger?;
+    private relay?;
     constructor(redis: BusRedisClient, machineId: string, options?: RedisTransportBusOptions);
     nodeId(): string;
+    /** Attach the relay that serves requests on their session's owner. */
+    attachRelay(relay: SessionRelay | undefined): void;
+    canRelay(): boolean;
+    channelOf(nodeId: string): string;
     /**
      * Advertise that this node owns a session.
-     * Stores the nodeId and relay channel in a Redis Hash.
+     * Stores the nodeId, relay channel, type and token hash in a Redis Hash, with its TTL, atomically.
      */
     advertise(key: TransportKey): Promise<void>;
     /**
@@ -66,24 +70,27 @@ export declare class RedisTransportBus implements TransportBus {
      */
     revoke(key: TransportKey): Promise<void>;
     /**
-     * Look up which node owns a session.
-     * Returns null if the session is not registered in the bus.
+     * Look up which other node owns this exact session (same transport type and token).
+     * Returns null if the session is not registered, belongs to another token, or is ours.
      */
     lookup(key: TransportKey): Promise<RemoteLocation | null>;
+    /** The node owning a session id (this node included), whatever its type or token. */
+    lookupOwner(sessionId: string): Promise<RemoteLocation | null>;
     /**
-     * Proxy a request to the owning node.
+     * Relay a request to the node owning its session and write that node's response.
      *
-     * Phase 1: Not implemented — TransportService.recreateTransporter()
-     * handles cross-pod session access via Redis session store.
+     * A request that was itself relayed here is never relayed again (one hop at most).
+     * @throws SessionOwnerUnreachableError when the request cannot be served by the owner.
      */
-    proxyRequest(): Promise<void>;
+    proxyRequest(location: RemoteLocation, sessionId: string, request: ServerRequest, response: ServerResponse): Promise<void>;
     /**
      * Destroy a session on a remote node via pub/sub relay.
      */
     destroyRemote(key: TransportKey, reason?: string): Promise<void>;
+    private readEntry;
     /**
      * Build the Redis key for a session in the bus.
-     * Format: {prefix}{type}:{tokenHash}:{sessionId}
+     * Format: {prefix}session:{sessionId}
      */
     private busKey;
 }

package/transport/bus/redis-transport-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-transport-bus.d.ts","sourceRoot":"","sources":["../../../src/transport/bus/redis-transport-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAsBD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAOlD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAqC;gBAG1C,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EAClC,OAAO,CAAC,EAAE,wBAAwB;IAQpC,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9C;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAe/D;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtE;;;OAGG;IACH,OAAO,CAAC,MAAM;CAGf"}
+{"version":3,"file":"redis-transport-bus.d.ts","sourceRoot":"","sources":["../../../src/transport/bus/redis-transport-bus.ts"],"names":[],"mappings":"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"}

package/transport/event-stores/event-store.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-store.factory.d.ts","sourceRoot":"","sources":["../../../src/transport/event-stores/event-store.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAG1F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAwFhH"}
+{"version":3,"file":"event-store.factory.d.ts","sourceRoot":"","sources":["../../../src/transport/event-stores/event-store.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAG1F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAyFhH"}

package/transport/flow-error-output.d.ts

@@ -0,0 +1,8 @@
+import { type HttpOutput } from '../common/schemas/http-output.schema';
+/**
+ * Map an error thrown out of `runFlow('http:request', …)` to a normalized
+ * `HttpOutput`, mirroring the Express middleware's FlowControl handling. Returns
+ * `undefined` for `next`/`handled` (no response → the caller 404s).
+ */
+export declare function flowErrorToHttpOutput(error: unknown): HttpOutput | undefined;
+//# sourceMappingURL=flow-error-output.d.ts.map

package/transport/flow-error-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-error-output.d.ts","sourceRoot":"","sources":["../../src/transport/flow-error-output.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAIvE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAoC5E"}

package/transport/flows/handle.mcp-20260728.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.mcp-20260728.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.mcp-20260728.flow.ts"],"names":[],"mappings":"AAmBA,OAAO,EAGL,QAAQ,EAER,eAAe,EACf,gBAAgB,EAKhB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAStB,OAAO,EAIL,yBAAyB,EACzB,WAAW,EACX,UAAU,EAKX,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,IAAI;;;;;CAKoB,CAAC;AAwBtC,eAAO,MAAM,WAAW;;;;;;;;;gCAOtB,CAAC;AAEH,QAAA,MAAM,IAAI,EAAG,yBAAkC,CAAC;AAGhD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,yBAAyB,EAAE,cAAc,CACvC,qBAAqB,EACrB,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAuBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAMrG;AA2FD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACtE,IAAI,4BAAQ;IAEZ,OAAO,KAAK,GAAG,GAEd;IAGK,UAAU;IAOhB;;;;;;;OAOG;IAEG,QAAQ;IA8Cd;;;;;;;;OAQG;IACH;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,cAAc;IAQhB,MAAM;IAYZ;;;;OAIG;IAIG,kBAAkB;IAIxB;;;;;OAKG;IAIG,mBAAmB;IA4DnB,aAAa;IAkGb,OAAO;CAKd;AAED,mGAAmG;AACnG,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"handle.mcp-20260728.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.mcp-20260728.flow.ts"],"names":[],"mappings":"AAmBA,OAAO,EAGL,QAAQ,EAER,eAAe,EACf,gBAAgB,EAKhB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAItB,OAAO,EAIL,yBAAyB,EACzB,WAAW,EACX,UAAU,EAKX,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,IAAI;;;;;CAKoB,CAAC;AAwBtC,eAAO,MAAM,WAAW;;;;;;;;;gCAOtB,CAAC;AAEH,QAAA,MAAM,IAAI,EAAG,yBAAkC,CAAC;AAGhD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,yBAAyB,EAAE,cAAc,CACvC,qBAAqB,EACrB,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAuBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAMrG;AA2FD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACtE,IAAI,4BAAQ;IAEZ,OAAO,KAAK,GAAG,GAEd;IAGK,UAAU;IAOhB;;;;;;;OAOG;IAEG,QAAQ;IA8Cd;;;;;;;;OAQG;IACH;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,cAAc;IAQhB,MAAM;IAYZ;;;;OAIG;IAIG,kBAAkB;IAIxB;;;;;OAKG;IAIG,mBAAmB;IA4DnB,aAAa;IAoGb,OAAO;CAKd;AAED,mGAAmG;AACnG,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/transport/flows/handle.sse.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.sse.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.sse.flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAIvC,OAAO,EAEL,QAAQ,EAER,eAAe,EACf,gBAAgB,EAQhB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAKtB,eAAO,MAAM,IAAI;;;;;CAKoB,CAAC;AAoBtC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAItB,CAAC;AAEH,QAAA,MAAM,IAAI,EAAG,mBAA4B,CAAC;AAG1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,mBAAmB,EAAE,cAAc,CACjC,aAAa,EACb,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQtE;AAED,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC;IACxC,aAAa,EAAE,MAAM,gBAAgB,CAAC;CACvC,GAAG;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAkC7E;AASD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAExD,UAAU;IAsCV,MAAM;IAiBN,YAAY;IAoBZ,cAAc;IAad,SAAS;CA+EhB"}
+{"version":3,"file":"handle.sse.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.sse.flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAGvC,OAAO,EAEL,QAAQ,EAER,eAAe,EACf,gBAAgB,EAQhB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAKtB,eAAO,MAAM,IAAI;;;;;CAKoB,CAAC;AAoBtC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAItB,CAAC;AAEH,QAAA,MAAM,IAAI,EAAG,mBAA4B,CAAC;AAG1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,mBAAmB,EAAE,cAAc,CACjC,aAAa,EACb,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQtE;AAED,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC;IACxC,aAAa,EAAE,MAAM,gBAAgB,CAAC;CACvC,GAAG;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAkC7E;AASD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAExD,UAAU;IAsCV,MAAM;IAiBN,YAAY;IAoBZ,cAAc;IAad,SAAS;CA6ChB"}

package/transport/flows/handle.streamable-http.flow.d.ts

@@ -129,7 +129,7 @@ export declare function buildReinitFailedResponse(sessionId: string, requestId:
         httpOnly: boolean;
         domain?: string | undefined;
         secure?: boolean | undefined;
-        sameSite?: "strict" | "none" | "lax" | undefined;
+        sameSite?: "strict" | "lax" | "none" | undefined;
         maxAge?: number | undefined;
         expires?: Date | undefined;
     }[] | undefined;

package/transport/flows/handle.streamable-http.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.streamable-http.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.streamable-http.flow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handle.streamable-http.flow.d.ts","sourceRoot":"","sources":["../../../src/transport/flows/handle.streamable-http.flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AACvC,OAAO,EAA2D,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG7G,OAAO,EAEL,QAAQ,EAGR,eAAe,EACf,gBAAgB,EAMhB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAOtB,eAAO,MAAM,IAAI;;;;;CAKoB,CAAC;AAoBtC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAItB,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;AACpE,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;AAEhG;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;IAC7C,aAAa,EAAE,MAAM,qBAAqB,CAAC;CAC5C,GAAG;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;CACrB,CAsBA;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,GAAG;IAAE,WAAW,EAAE,yBAAyB,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,CA0B5E;AAED,wBAAgB,sCAAsC,CACpD,aAAa,EAAE;IAAE,OAAO,CAAC,EAAE,qBAAqB,CAAA;CAAE,EAClD,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAIN;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,wBAAwB,IAAI,IAAI,CAAC;IACjC,gBAAgB,IAAI,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,wBAAwB,GAAG,OAAO,CAO/F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;;;;;;;;;;;;;;;;;;;EAOvF;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,oCAAoC;IACnD,cAAc,CACZ,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAChH,mBAAmB,CACjB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;IAChD,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrG;AAED,MAAM,MAAM,mCAAmC,GAC3C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,SAAS,EAAE,uBAAuB,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,gBAAgB,EAAE,oCAAoC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAkC/C;AAED,QAAA,MAAM,IAAI,EAAG,wBAAiC,CAAC;AAG/C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,wBAAwB,EAAE,cAAc,CACtC,wBAAwB,EACxB,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AASD,MAAM,CAAC,OAAO,OAAO,wBAAyB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACzE,IAAI,2BAAQ;IAGN,gBAAgB;IAKhB,UAAU;IAsEV,MAAM;IAmCN,YAAY;IAqFZ,cAAc;IAwEd,SAAS;IAoFT,aAAa;IAqDb,SAAS;CA6IhB"}

package/transport/in-memory-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-server.d.ts","sourceRoot":"","sources":["../../src/transport/in-memory-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGnE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,eAAe,EAAE,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IACnD,sCAAsC;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CA4D/B"}
+{"version":3,"file":"in-memory-server.d.ts","sourceRoot":"","sources":["../../src/transport/in-memory-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGnE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAIrD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,eAAe,EAAE,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IACnD,sCAAsC;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CA+D/B"}

package/transport/mcp-handlers/initialize-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/initialize-request.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAkC/E,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,aAAa,EACb,KAAK,EACL,mBAAmB,GACpB,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAqKrE"}
+{"version":3,"file":"initialize-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/initialize-request.handler.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAW5B,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAkC/E,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,aAAa,EACb,KAAK,EACL,mBAAmB,GACpB,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAyKrE"}

package/transport/relay/index.d.ts

@@ -0,0 +1,5 @@
+export { createRelayedServerRequest, decodeRelayChunk, encodeRelayChunk, isRelayedRequest, relayedFrom, RelayServerResponse, serializeRelayRequest, type RelayChunk, type RelayResponseSink, } from './relay-http';
+export { SessionRelay, type RelayResponseTarget, type SessionRelayOptions } from './session-relay';
+export { serveRelayedHttpRequest, type RelayFlowRunner } from './relay-flow';
+export { wireSessionRelay, type SessionRelayHandle, type WireSessionRelayOptions } from './relay-scope.helper';
+//# sourceMappingURL=index.d.ts.map

package/transport/relay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/relay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/transport/relay/relay-flow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Owner-side adapter for relayed requests.
+ *
+ * Like every other adapter, it only translates: the relayed request arrives as a
+ * normalized `ServerRequest` + `ServerResponse` pair and runs through the SAME
+ * `http:request` flow a request received directly runs through (IP filter, quota,
+ * session verification, routing, the MCP transport, audit and every hook), so the
+ * owner serves it exactly as if the client had reached it.
+ */
+import type { ServerRequest, ServerResponse } from '../../common';
+/** The part of the scope the adapter needs. */
+export interface RelayFlowRunner {
+    runFlow(name: 'http:request', input: never): Promise<unknown>;
+}
+/** Run a relayed request through the `http:request` flow and render its output to `response`. */
+export declare function serveRelayedHttpRequest(scope: RelayFlowRunner, request: ServerRequest, response: ServerResponse): Promise<void>;
+//# sourceMappingURL=relay-flow.d.ts.map

package/transport/relay/relay-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-flow.d.ts","sourceRoot":"","sources":["../../../src/transport/relay/relay-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKlE,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED,iGAAiG;AACjG,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

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

@@ -0,0 +1,109 @@
+/**
+ * Request and response objects for an HTTP request relayed between the nodes of a
+ * distributed deployment.
+ *
+ * The node that receives a request for a session another node owns serializes it
+ * ({@link serializeRelayRequest}). The owner rebuilds a `ServerRequest` from it
+ * ({@link createRelayedServerRequest}) and runs it through its own `http:request`
+ * flow with a {@link RelayServerResponse}, whose output is streamed back.
+ *
+ * Both objects implement the subset of Node's `IncomingMessage` / `ServerResponse`
+ * (and Express' `status` / `json` / `send`) that the flows, the transport adapters
+ * and the MCP SDK's Streamable HTTP and SSE transports use. They depend on no Node
+ * built-in module, so importing them is safe in every runtime.
+ */
+import { type ServerRequest, type ServerResponse } from '../../common';
+import type { RelayedHttpRequest } from '../../ha/relay-messages';
+type Listener = (...args: unknown[]) => void;
+/** Minimal event emitter (no dependency on Node's `events`). */
+declare class RelayEmitter {
+    private readonly listeners;
+    on(event: string | symbol, listener: Listener): this;
+    addListener(event: string | symbol, listener: Listener): this;
+    once(event: string | symbol, listener: Listener): this;
+    off(event: string | symbol, listener: Listener): this;
+    removeListener(event: string | symbol, listener: Listener): this;
+    removeAllListeners(event?: string | symbol): this;
+    listenerCount(event: string | symbol): number;
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+}
+/** Serialize a request this node received so its session owner can serve it. */
+export declare function serializeRelayRequest(request: ServerRequest): RelayedHttpRequest;
+/** The node that relayed this request, when it was relayed. */
+export declare function relayedFrom(request: ServerRequest): string | undefined;
+/** Whether a request was relayed here from another node. */
+export declare function isRelayedRequest(request: ServerRequest): boolean;
+/**
+ * Rebuild the `ServerRequest` of a relayed request on the session owner.
+ * Its socket peer is the client's address on the node that received the request,
+ * so client-IP rules see the same client they would have seen there.
+ */
+export declare function createRelayedServerRequest(relayed: RelayedHttpRequest, sourceNodeId: string): ServerRequest;
+/** A body chunk as carried in a relay frame. */
+export interface RelayChunk {
+    data: string;
+    encoding: 'utf8' | 'base64';
+}
+/** Encode a body chunk for a relay frame. Returns `undefined` for an empty chunk. */
+export declare function encodeRelayChunk(chunk: unknown, encoding?: string): RelayChunk | undefined;
+/** Decode a relay frame body chunk. */
+export declare function decodeRelayChunk(chunk: RelayChunk): Uint8Array | string;
+/** Receives what the owner writes to a relayed response, in order. */
+export interface RelayResponseSink {
+    head(status: number, headers: Record<string, string | string[]>): void;
+    data(chunk: RelayChunk): void;
+    end(): void;
+}
+type OutgoingHeaderValue = number | string | readonly string[];
+type OutgoingHeaders = Record<string, OutgoingHeaderValue | undefined> | readonly string[];
+/**
+ * The response of a relayed request on the session owner. Whatever the flow writes
+ * is handed to the {@link RelayResponseSink} (and from there published back to the
+ * node that relayed the request). `destroy()` — called when that node's client goes
+ * away — emits `close` before `finish`, which aborts a streaming MCP response.
+ */
+export declare class RelayServerResponse extends RelayEmitter {
+    private readonly sink;
+    statusCode: number;
+    statusMessage: string;
+    headersSent: boolean;
+    writableEnded: boolean;
+    writableFinished: boolean;
+    destroyed: boolean;
+    private readonly headerMap;
+    constructor(sink: RelayResponseSink);
+    get writable(): boolean;
+    get finished(): boolean;
+    setHeader(name: string, value: OutgoingHeaderValue): this;
+    getHeader(name: string): string | string[] | undefined;
+    getHeaders(): Record<string, string | string[]>;
+    getHeaderNames(): string[];
+    hasHeader(name: string): boolean;
+    removeHeader(name: string): void;
+    writeHead(statusCode: number, reasonOrHeaders?: string | OutgoingHeaders, maybeHeaders?: OutgoingHeaders): this;
+    flushHeaders(): void;
+    /** Express `res.status()`. */
+    status(code: number): this;
+    /** Express `res.json()`. */
+    json(body: unknown): this;
+    /** Express `res.send()`. */
+    send(body?: unknown): this;
+    /** Express `res.redirect()`. */
+    redirect(statusOrUrl: number | string, maybeUrl?: string): this;
+    write(chunk: unknown, encodingOrCallback?: unknown, callback?: unknown): boolean;
+    end(chunk?: unknown, encodingOrCallback?: unknown, callback?: unknown): this;
+    /**
+     * Abort the response: nothing more reaches the sink. `close` fires with the response
+     * unfinished, which is how the MCP transports learn the client went away.
+     */
+    destroy(error?: Error): this;
+    /** Node `ServerResponse` no-ops. */
+    cork(): void;
+    uncork(): void;
+    setTimeout(): this;
+    /** The response, typed as the `ServerResponse` the flows expect. */
+    asServerResponse(): ServerResponse;
+    private sendHead;
+}
+export {};
+//# sourceMappingURL=relay-http.d.ts.map

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

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

package/transport/relay/relay-scope.helper.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Wire a scope's HA relay channel: request relay, remote session destroys and
+ * relayed notifications. Kept out of `scope.instance.ts` so the scope stays lean.
+ */
+import type { HaManager } from '../../ha';
+import type { RedisTransportBus } from '../bus/redis-transport-bus';
+import type { TransportService } from '../transport.registry';
+import { type RelayFlowRunner } from './relay-flow';
+import { SessionRelay } from './session-relay';
+interface RelayScopeLogger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    verbose?(message: string, meta?: Record<string, unknown>): void;
+}
+export interface WireSessionRelayOptions {
+    nodeId: string;
+    haManager: HaManager;
+    bus: RedisTransportBus;
+    transportService: TransportService;
+    notifications: {
+        deliverRelayedNotification(sessionId: string, method: string, params?: Record<string, unknown>): boolean;
+    };
+    /** Runs relayed requests through the `http:request` flow (the scope). */
+    flows: RelayFlowRunner;
+    logger: RelayScopeLogger;
+    /** Override the relay's acknowledgement timeout (ms). */
+    ackTimeoutMs?: number;
+}
+export interface SessionRelayHandle {
+    relay: SessionRelay;
+    /** Resolves once this node listens on its relay channel (or the handle was closed). */
+    ready: Promise<void>;
+    /** Stop relaying and stop retrying the subscription. */
+    close(): Promise<void>;
+}
+/**
+ * Subscribe this node to its relay channel and attach a {@link SessionRelay} to the
+ * transport bus. Returns `undefined` when the HA manager has no pub/sub connections.
+ *
+ * The subscription is retried with backoff (1s doubling to 30s) while Redis is
+ * unreachable; until it succeeds the bus cannot relay, and a request for a session
+ * another live node owns is answered with a retryable 503.
+ */
+export declare function wireSessionRelay(options: WireSessionRelayOptions): SessionRelayHandle | undefined;
+export {};
+//# sourceMappingURL=relay-scope.helper.d.ts.map

package/transport/relay/relay-scope.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-scope.helper.d.ts","sourceRoot":"","sources":["../../../src/transport/relay/relay-scope.helper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,UAAU,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,UAAU,gBAAgB;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,iBAAiB,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE;QACb,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;KAC1G,CAAC;IACF,yEAAyE;IACzE,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAKD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,kBAAkB,GAAG,SAAS,CAoFjG"}

package/transport/relay/session-relay.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Session Relay — serve a request on the node that owns its MCP session.
+ *
+ * In a distributed deployment the node that receives a request may not be the one
+ * holding the session's transport. That node ({@link SessionRelay.forward}) publishes
+ * the request to the owner's relay channel and streams the owner's response back to
+ * its client. The owner ({@link SessionRelay.handleMessage} → `relay-request`) runs
+ * the request through its own `http:request` flow — auth, quota, routing, the MCP
+ * transport and every hook run there, exactly as for a request it received itself —
+ * and publishes what it writes, frame by frame, to the relaying node's channel.
+ *
+ * Redis Pub/Sub delivers the messages one connection publishes in order, so the
+ * frames of a response (`ack`, `head`, `data`…, `end`) arrive in the order written.
+ *
+ * Failure handling on the relaying node:
+ * - the owner does not listen on its channel (publish reached no subscriber) or does
+ *   not acknowledge within `ackTimeoutMs`, its heartbeat expires while it serves, or no
+ *   frame (a `keepalive` included) arrives for three owner-check intervals: before any
+ *   byte reached the client the request fails with {@link SessionOwnerUnreachableError}
+ *   (503, retryable); after, the response is ended;
+ * - the client goes away: the owner is told to cancel, which aborts the response there.
+ *
+ * On the owner, a response frame that cannot be published (Redis error, or the relaying
+ * node no longer listens) aborts the response and reports an `error` frame: a response
+ * with a lost frame is never completed.
+ */
+import type { ServerRequest, ServerResponse } from '../../common';
+import { SessionOwnerUnreachableError } from '../../errors/transport.errors';
+import type { HaRelayMessage, RelayedHttpRequest } from '../../ha/relay-messages';
+/** Where the relaying node writes the owner's response (a Node / Express `ServerResponse`). */
+export interface RelayResponseTarget {
+    readonly headersSent: boolean;
+    readonly writableEnded: boolean;
+    readonly writableFinished?: boolean;
+    writeHead(status: number, headers: Record<string, string | string[]>): unknown;
+    flushHeaders?(): void;
+    write(chunk: Uint8Array | string): unknown;
+    end(): unknown;
+    once(event: 'close', listener: () => void): unknown;
+    removeListener(event: 'close', listener: () => void): unknown;
+}
+interface RelayLogger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    verbose?(message: string, meta?: Record<string, unknown>): void;
+}
+export interface SessionRelayOptions {
+    /** This node's machine ID. */
+    nodeId: string;
+    /** Publish a message to a node's relay channel; resolves to the number of receivers. */
+    publish(nodeId: string, message: HaRelayMessage): Promise<number>;
+    /** Whether a node's heartbeat is present. */
+    isNodeAlive(nodeId: string): Promise<boolean>;
+    /** Serve a request relayed to this node (runs it through the `http:request` flow). */
+    serve(request: ServerRequest, response: ServerResponse): Promise<void>;
+    /** How long the relaying node waits for the owner to acknowledge a request. @default 5000 */
+    ackTimeoutMs?: number;
+    /**
+     * How often the relaying node checks the owner's heartbeat while it serves, and how often
+     * the owner sends a `keepalive` frame. @default 10000
+     */
+    ownerCheckIntervalMs?: number;
+    /** `Retry-After` given to a client whose request could not be relayed. @default 30 */
+    retryAfterSeconds?: number;
+    logger?: RelayLogger;
+}
+export declare class SessionRelay {
+    private readonly options;
+    private readonly nodeId;
+    private readonly ackTimeoutMs;
+    private readonly ownerCheckIntervalMs;
+    private readonly retryAfterSeconds;
+    private readonly logger?;
+    /** Requests this node relayed, awaiting the owner's response frames. */
+    private readonly pending;
+    /** Requests this node is serving for other nodes. */
+    private readonly serving;
+    private closed;
+    constructor(options: SessionRelayOptions);
+    /** Requests relayed from this node that are still in flight. */
+    get pendingCount(): number;
+    /** Requests this node is serving for other nodes. */
+    get servingCount(): number;
+    /** The error a request gets when its session owner cannot serve it. */
+    unreachable(ownerNodeId: string, reason: string): SessionOwnerUnreachableError;
+    /**
+     * Relay a request to the node that owns its session and write that node's response
+     * to `response`. Resolves once the response is complete (or the client went away).
+     *
+     * @throws SessionOwnerUnreachableError when the owner could not serve the request and
+     *   nothing has been written to `response` yet.
+     */
+    forward(ownerNodeId: string, sessionId: string, request: RelayedHttpRequest, response: RelayResponseTarget): Promise<void>;
+    /** Dispatch a request-relay message that arrived on this node's channel. */
+    handleMessage(message: HaRelayMessage): void;
+    /**
+     * Stop relaying: requests relayed from this node fail (or end), and requests this
+     * node serves for others are aborted after telling their node.
+     */
+    close(): Promise<void>;
+    /** Owner side: serve a request another node relayed here, streaming the response back. */
+    private serveRelayed;
+}
+export {};
+//# sourceMappingURL=session-relay.d.ts.map

package/transport/relay/session-relay.d.ts.map

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

package/transport/session-mode.check.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Warn at startup when `transport.sessionMode` asks for something the server does not do.
+ *
+ * Nothing reads `sessionMode` since v1.0: whether the server keeps sessions follows
+ * `transport.protocol` (`'stateless-api'` serves without sessions). The option is still accepted, so
+ * `sessionMode: 'stateless'` (or a function) used to be silently ignored (#678). `'stateful'`, the
+ * default, matches what the session-based protocols do and is left alone.
+ */
+export declare function warnIfSessionModeIgnored(options: {
+    logger: {
+        warn(message: string): void;
+    };
+    transport?: {
+        sessionMode?: unknown;
+        protocol?: unknown;
+    };
+}): void;
+//# sourceMappingURL=session-mode.check.d.ts.map

package/transport/session-mode.check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-mode.check.d.ts","sourceRoot":"","sources":["../../src/transport/session-mode.check.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,MAAM,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxC,SAAS,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D,GAAG,IAAI,CAYP"}