@frontmcp/sdk 1.8.7 → 1.9.1-rc.1

package/ext-apps/ext-apps.handler.d.ts

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import type { FrontMcpLogger } from '../common';
-import type { ExtAppsJsonRpcRequest, ExtAppsJsonRpcResponse, ExtAppsHostCapabilities } from './ext-apps.types';
+import { type ExtAppsHostCapabilities, type ExtAppsJsonRpcRequest, type ExtAppsJsonRpcResponse } from './ext-apps.types';
 /**
  * Context for handling ext-apps messages.
  * Provides access to scope services for routing requests.

package/ext-apps/ext-apps.handler.d.ts.map

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

package/flows/flow.instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAEL,SAAS,EAGT,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EAMf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAKnB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AA4BlE,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAW1F,UAAU;IA8FpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBzD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;;OASG;YACW,cAAc;IAoBtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAiUrG"}
+{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAEL,SAAS,EAGT,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EAMf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AA4BlE,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAW1F,UAAU;IA8FpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBzD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;;OASG;YACW,cAAc;IAoBtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAoUrG"}

package/front-mcp/front-mcp.d.ts

@@ -18,6 +18,8 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
     constructor(config: FrontMcpConfigType);
     initialize(): Promise<void>;
     start(): Promise<void>;
+    /** Where this server serves MCP, as reported to the `frontmcp dev --stdio` bridge. */
+    private devListenerInfo;
     /**
      * Get the configuration used to create this FrontMCP instance.
      */
@@ -47,6 +49,12 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * stats are process-global.
      */
     private wireMetricsService;
+    /**
+     * The `/metrics` service when `metrics.enabled: true`, `undefined` otherwise.
+     * Shared by the Express host (`wireMetricsService`) and `createFetchHandler()`,
+     * so both transports serve the endpoint from the same config.
+     */
+    private createMetricsService;
     static bootstrap(options: FrontMcpConfigInput | FrontMcpConfigType): Promise<void>;
     /**
      * Creates and initializes a FrontMCP instance without starting the HTTP server.

package/front-mcp/front-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAatE,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAIxC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;AAiCrG,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAiB;gBAEjB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,KAAK;IA8BX;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;;;OAIG;IACH,eAAe,IAAI,UAAU,GAAG,SAAS;IAIzC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;WAoBN,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IA4B/E;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBtG;;;;;;;;;;;;;;;;OAgBG;WACiB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6DnH;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;OAQG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBxF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,aAAa,CAC/B,OAAO,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,GAAG;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,GACA,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAmD1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;WACiB,QAAQ,CAAC,cAAc,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwOjF"}
+{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAatE,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAKxC;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;AAiCrG,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAiB;gBAEjB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,KAAK;IAgCX,sFAAsF;IACtF,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;;;OAIG;IACH,eAAe,IAAI,UAAU,GAAG,SAAS;IAIzC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;WAYR,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IA4B/E;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBtG;;;;;;;;;;;;;;;;OAgBG;WACiB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoEnH;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;OAQG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBxF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,aAAa,CAC/B,OAAO,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,GAAG;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,GACA,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAmD1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;WACiB,QAAQ,CAAC,cAAc,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2OjF"}

package/front-mcp/front-mcp.providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.providers.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAElB,MAAM,WAAW,CAAC;AAuCnB,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAKrF"}
+{"version":3,"file":"front-mcp.providers.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.providers.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAElB,MAAM,WAAW,CAAC;AAyCnB,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAKrF"}

package/front-mcp/static-startup.check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-startup.check.d.ts","sourceRoot":"","sources":["../../src/front-mcp/static-startup.check.ts"],"names":[],"mappings":"AA+BA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAGxB,MAAM,WAAW,CAAC;AA0LnB;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,IAAI,CA6BhG"}
+{"version":3,"file":"static-startup.check.d.ts","sourceRoot":"","sources":["../../src/front-mcp/static-startup.check.ts"],"names":[],"mappings":"AA+BA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAGxB,MAAM,WAAW,CAAC;AA+LnB;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,IAAI,CA6BhG"}

package/ha/ha-config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HA configuration from the environment.
+ *
+ * `frontmcp build --target distributed` writes the `ha` block of the
+ * deployment in `frontmcp.config` to these variables in the generated setup
+ * file; they can also be set directly on the pod.
+ */
+import type { HaConfig } from './ha.types';
+/** Environment variables read by {@link resolveHaConfigFromEnv}. */
+export declare const HA_ENV: {
+    readonly heartbeatIntervalMs: "FRONTMCP_HA_HEARTBEAT_INTERVAL_MS";
+    readonly heartbeatTtlMs: "FRONTMCP_HA_HEARTBEAT_TTL_MS";
+    readonly takeoverGracePeriodMs: "FRONTMCP_HA_TAKEOVER_GRACE_MS";
+    readonly redisKeyPrefix: "FRONTMCP_HA_KEY_PREFIX";
+};
+/**
+ * HA overrides set in the environment. Missing or invalid values are left out,
+ * so the defaults apply to them.
+ */
+export declare function resolveHaConfigFromEnv(): Partial<HaConfig>;
+//# sourceMappingURL=ha-config.d.ts.map

package/ha/ha-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ha-config.d.ts","sourceRoot":"","sources":["../../src/ha/ha-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,oEAAoE;AACpE,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AASX;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAW1D"}

package/ha/ha-headers.d.ts

@@ -1,15 +1,31 @@
 /**
  * Load-balancer affinity headers for distributed deployments.
  *
- * Applied from flow stages so plugins can hook or replace them.
+ * `X-FrontMCP-Machine-Id` goes on every response a distributed instance sends — the host
+ * adapters (Express, web-fetch) add it where their security headers are added, so MCP responses
+ * of every protocol revision, health probes, metrics and 404s all carry it. The session flows'
+ * hookable `applyNodeHeaders` stage sets it as well, and adds the affinity cookie.
  */
 import { buildSetCookie } from '@frontmcp/utils';
 interface HeaderResponse {
     setHeader(name: string, value: string | string[]): unknown;
     getHeader(name: string): unknown;
 }
+/** The `X-FrontMCP-Machine-Id` header for this instance, or `undefined` outside distributed deployments. */
+export declare function machineIdHeader(): readonly [name: string, value: string] | undefined;
 /** Set `X-FrontMCP-Machine-Id` on the response. No-op outside distributed deployments. */
-export declare function applyMachineIdHeader(response: HeaderResponse): boolean;
+export declare function applyMachineIdHeader(response: Pick<HeaderResponse, 'setHeader'>): boolean;
+type SameSite = 'Strict' | 'Lax' | 'None';
+/**
+ * The affinity cookie's name and attributes. `frontmcp build` turns a deployment's
+ * `server.cookies` block (`affinity`, `domain`, `sameSite`) into these variables:
+ * FRONTMCP_AFFINITY_COOKIE, FRONTMCP_AFFINITY_COOKIE_DOMAIN, FRONTMCP_AFFINITY_COOKIE_SAMESITE.
+ */
+export declare function affinityCookieOptions(): {
+    name: string;
+    domain?: string;
+    sameSite?: SameSite;
+};
 /** Set the machine-id header plus the node affinity cookie. */
 export declare function applyNodeAffinity(response: HeaderResponse, request: Parameters<typeof buildSetCookie>[1]): void;
 export {};

package/ha/ha-headers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ha-headers.d.ts","sourceRoot":"","sources":["../../src/ha/ha-headers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAmC,MAAM,iBAAiB,CAAC;AAIlF,UAAU,cAAc;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAItE;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAO/G"}
+{"version":3,"file":"ha-headers.d.ts","sourceRoot":"","sources":["../../src/ha/ha-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA2C,MAAM,iBAAiB,CAAC;AAI1F,UAAU,cAAc;IACtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,4GAA4G;AAC5G,wBAAgB,eAAe,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAGpF;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,OAAO,CAKzF;AAED,KAAK,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAO9F;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAO/G"}

package/ha/ha-manager.d.ts

@@ -8,11 +8,21 @@
 import { type HaConfig, type TakeoverResult } from './ha.types';
 import { type HeartbeatRedisClient } from './heartbeat.service';
 import { NotificationRelay, type RelayHandler, type RelayRedisClient } from './notification-relay';
+import type { HaRelayMessage } from './relay-messages';
 import { type TakeoverRedisClient } from './session-takeover';
+/**
+ * What the orphan scanner read from a session record it claimed.
+ */
+export interface ClaimedSessionInfo {
+    /** Transport protocol of the session (e.g. `streamable-http`). */
+    protocol?: string;
+    /** Token hash the session is bound to. */
+    authorizationId?: string;
+}
 /**
  * Callback invoked when an orphaned session is successfully claimed.
  */
-export type OrphanHandler = (sessionId: string, previousNodeId: string) => void | Promise<void>;
+export type OrphanHandler = (sessionId: string, previousNodeId: string, session: ClaimedSessionInfo) => void | Promise<void>;
 /**
  * Options for the orphan session scanner.
  */
@@ -93,12 +103,24 @@ export declare class HaManager {
     attemptTakeover(sessionKey: string, expectedOldNodeId: string): Promise<TakeoverResult>;
     /** Check if a specific node is alive. */
     isNodeAlive(nodeId: string): Promise<boolean>;
+    /** This node's liveness generation (see {@link HeartbeatService.livenessGeneration}). */
+    livenessGeneration(): number | undefined;
     /** Get all alive node IDs. */
     getAliveNodes(): Promise<string[]>;
     /** Get the notification relay (undefined if pub/sub not configured). */
     getRelay(): NotificationRelay | undefined;
-    /** Subscribe to relay messages (for cross-pod notification delivery). */
+    /** Subscribe to this pod's relay channel (notifications, session destroys, relayed requests). */
     subscribeRelay(handler: RelayHandler): Promise<void>;
+    /**
+     * Publish a message to another pod's relay channel.
+     * @returns How many subscribers received it — 0 when that pod does not listen, or when
+     *   pub/sub is not configured on this pod.
+     */
+    publishToNode(nodeId: string, message: HaRelayMessage): Promise<number>;
+    /** The relay channel name of a pod. */
+    relayChannelOf(nodeId: string): string;
+    /** The effective HA configuration (defaults merged with overrides). */
+    getConfig(): Readonly<HaConfig>;
     /** Update the heartbeat with current session count. */
     setSessionCount(count: number): void;
     /** Whether HA services are running. */

package/ha/ha-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ha-manager.d.ts","sourceRoot":"","sources":["../../src/ha/ha-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,aAAa,CAAC;IACxB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IAClD,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,wBAAwB;IACxB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACrG;AAED,qBAAa,SAAS;IAalB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,qBAAqB,CAA4C;IACzE,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO;IAeP;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS;IAUnD,8CAA8C;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;;;;;;;OAQG;IACH,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAoBvD,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAY7F,yCAAyC;IACnC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,8BAA8B;IACxB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC,wEAAwE;IACxE,QAAQ,IAAI,iBAAiB,GAAG,SAAS;IAIzC,yEAAyE;IACnE,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,uDAAuD;IACvD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,uCAAuC;IACvC,SAAS,IAAI,OAAO;IAIpB,+CAA+C;IAC/C,SAAS,IAAI,MAAM;IAInB;;;;;;;;OAQG;YACW,aAAa;CAiE5B"}
+{"version":3,"file":"ha-manager.d.ts","sourceRoot":"","sources":["../../src/ha/ha-manager.ts"],"names":[],"mappings":"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"}

package/ha/ha.types.d.ts

@@ -38,5 +38,7 @@ export interface TakeoverResult {
     claimed: boolean;
     sessionId: string;
     previousNodeId?: string;
+    /** When the session was claimed (epoch ms), as recorded in its `reassignedAt`. */
+    reassignedAt?: number;
 }
 //# sourceMappingURL=ha.types.d.ts.map

package/ha/ha.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ha.types.d.ts","sourceRoot":"","sources":["../../src/ha/ha.types.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,yGAAyG;IACzG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0GAA0G;IAC1G,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,CAOhD,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAErF,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"ha.types.d.ts","sourceRoot":"","sources":["../../src/ha/ha.types.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,yGAAyG;IACzG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0GAA0G;IAC1G,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,CAOhD,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAErF,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/ha/heartbeat.service.d.ts

@@ -25,6 +25,8 @@ export declare class HeartbeatService {
     private readonly intervalMs;
     private readonly ttlMs;
     private sessionCount;
+    private lastBeatAt;
+    private lapses;
     constructor(redis: HeartbeatRedisClient, nodeId: string, config?: Partial<HaConfig>);
     /** Start the heartbeat interval. */
     start(): void;
@@ -36,9 +38,16 @@ export declare class HeartbeatService {
     isAlive(nodeId: string): Promise<boolean>;
     /** Get the heartbeat value for a specific node. */
     getHeartbeat(nodeId: string): Promise<HeartbeatValue | null>;
+    /**
+     * The span of uninterrupted liveness this node is in: it changes after every gap in which
+     * this node's heartbeat may have expired (another node could then take its sessions over),
+     * and is `undefined` while the heartbeat may be expired.
+     */
+    livenessGeneration(): number | undefined;
     /** Get all alive node IDs by scanning heartbeat keys. */
     getAliveNodes(): Promise<string[]>;
     private heartbeatKey;
     private writeHeartbeat;
+    private recordBeat;
 }
 //# sourceMappingURL=heartbeat.service.d.ts.map

package/ha/heartbeat.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.service.d.ts","sourceRoot":"","sources":["../../src/ha/heartbeat.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,qBAAa,gBAAgB;IASzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAK;gBAGN,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,MAAM,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;IAQ5B,oCAAoC;IACpC,KAAK,IAAI,IAAI;IAQb,6CAA6C;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,yDAAyD;IACzD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,qDAAqD;IAC/C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C,mDAAmD;IAC7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUlE,yDAAyD;IACnD,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;CAUvB"}
+{"version":3,"file":"heartbeat.service.d.ts","sourceRoot":"","sources":["../../src/ha/heartbeat.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,qBAAa,gBAAgB;IAWzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAK;gBAGA,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,MAAM,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;IAS5B,oCAAoC;IACpC,KAAK,IAAI,IAAI;IAQb,6CAA6C;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,yDAAyD;IACzD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,qDAAqD;IAC/C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C,mDAAmD;IAC7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUlE;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIxC,yDAAyD;IACnD,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,UAAU;CAInB"}

package/ha/index.d.ts

@@ -1,7 +1,9 @@
-export { HaManager, type HaManagerOptions } from './ha-manager';
+export { HaManager, type HaManagerOptions, type ClaimedSessionInfo, type OrphanHandler, type OrphanScannerOptions, } from './ha-manager';
 export { HeartbeatService, type HeartbeatRedisClient } from './heartbeat.service';
 export { attemptSessionTakeover, type TakeoverRedisClient } from './session-takeover';
 export { NotificationRelay, type RelayRedisClient, type RelayHandler, type RelayMessage } from './notification-relay';
+export { isRequestRelayMessage, type CancelRelayMessage, type DestroySessionRelayMessage, type HaRelayMessage, type NotificationRelayMessage, type RelayedHttpRequest, type RelayResponseEvent, type RequestRelayMessage, type ResponseRelayMessage, } from './relay-messages';
+export { resolveHaConfigFromEnv, HA_ENV } from './ha-config';
 export { DEFAULT_FRONTMCP_NODE_COOKIE, DEFAULT_FRONTMCP_MACHINE_ID_HEADER } from './ha.constants';
 export type { HaConfig, DeploymentMode, HeartbeatValue, TakeoverResult } from './ha.types';
 export { DEFAULT_HA_CONFIG } from './ha.types';

package/ha/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ha/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtH,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAClG,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ha/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtH,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAClG,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/ha/notification-relay.d.ts

@@ -2,30 +2,20 @@
  * Notification Relay — Redis Pub/Sub Cross-Pod Messaging
  *
  * Each pod subscribes to its own channel (`mcp:ha:notify:{nodeId}`).
- * When a notification targets a session on a different pod,
- * it's published to that pod's channel for local delivery.
+ * Other pods publish to it to deliver a notification to a session it owns,
+ * ask it to destroy a session, or relay an HTTP request for one of its
+ * sessions (see {@link HaRelayMessage}).
  */
 import { type HaConfig } from './ha.types';
+import type { HaRelayMessage, NotificationRelayMessage } from './relay-messages';
 /**
  * Notification message relayed between pods.
  */
-export interface RelayMessage {
-    /** Target session ID */
-    sessionId: string;
-    /** MCP notification to deliver */
-    notification: {
-        method: string;
-        params?: Record<string, unknown>;
-    };
-    /** Source pod that originated the notification */
-    sourceNodeId: string;
-    /** Timestamp of relay */
-    timestamp: number;
-}
+export type RelayMessage = NotificationRelayMessage;
 /**
- * Handler invoked when a relay message arrives for this pod.
+ * Handler invoked when a message arrives on this pod's relay channel.
  */
-export type RelayHandler = (message: RelayMessage) => void | Promise<void>;
+export type RelayHandler = (message: HaRelayMessage) => void | Promise<void>;
 /**
  * Minimal Redis pub/sub client interface.
  * Requires a dedicated connection for subscribing (ioredis pattern).
@@ -46,6 +36,8 @@ export declare class NotificationRelay {
     private readonly channel;
     private readonly keyPrefix;
     constructor(subscriber: RelayRedisClient, publisher: RelayRedisClient, nodeId: string, config?: Partial<HaConfig>);
+    /** The relay channel of a node. */
+    channelOf(nodeId: string): string;
     /** Start listening for relay messages on this pod's channel. */
     subscribe(handler: RelayHandler): Promise<void>;
     /** Stop listening and clean up. */
@@ -54,7 +46,12 @@ export declare class NotificationRelay {
      * Publish a notification to a target pod's channel.
      * Used when a notification targets a session not owned by this pod.
      */
-    publish(targetNodeId: string, sessionId: string, notification: RelayMessage['notification']): Promise<void>;
+    publish(targetNodeId: string, sessionId: string, notification: NotificationRelayMessage['notification']): Promise<void>;
+    /**
+     * Publish any relay message to a target pod's channel.
+     * @returns How many subscribers received it — 0 when nothing listens on that pod's channel.
+     */
+    send(targetNodeId: string, message: HaRelayMessage): Promise<number>;
     private onMessage;
 }
 //# sourceMappingURL=notification-relay.d.ts.map

package/ha/notification-relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-relay.d.ts","sourceRoot":"","sources":["../../src/ha/notification-relay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAChF,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7F;AAED,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;IAM5B,gEAAgE;IAC1D,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC;;;OAGG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjH,OAAO,CAAC,SAAS,CASf;CACH"}
+{"version":3,"file":"notification-relay.d.ts","sourceRoot":"","sources":["../../src/ha/notification-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAChF,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7F;AAED,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;IAM5B,mCAAmC;IACnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIjC,gEAAgE;IAC1D,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC;;;OAGG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1E,OAAO,CAAC,SAAS,CAef;CACH"}

package/ha/relay-messages.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Messages carried on a node's HA relay channel (`{redisKeyPrefix}notify:{nodeId}`).
+ *
+ * Every node subscribes to its own channel. Other nodes publish to it to deliver
+ * a notification to a session it owns, ask it to destroy one, or relay an HTTP
+ * request for one of its sessions and receive the response back on their own
+ * channel.
+ */
+/** A notification for a session owned by the receiving node. */
+export interface NotificationRelayMessage {
+    /** Absent on messages published before relay kinds existed. */
+    kind?: 'notification';
+    /** Target session ID */
+    sessionId: string;
+    /** MCP notification to deliver */
+    notification: {
+        method: string;
+        params?: Record<string, unknown>;
+    };
+    /** Source pod that originated the notification */
+    sourceNodeId: string;
+    /** Timestamp of relay */
+    timestamp: number;
+}
+/** Ask the receiving node to destroy its transport for a session. */
+export interface DestroySessionRelayMessage {
+    kind: 'destroy-session';
+    sessionId: string;
+    reason?: string;
+    sourceNodeId: string;
+    timestamp: number;
+}
+/** The parts of an HTTP request a relayed request carries to the session owner. */
+export interface RelayedHttpRequest {
+    method: string;
+    /** Path and query, as received (`/mcp?x=1`). */
+    url: string;
+    /** Path without the query (`/mcp`). */
+    path: string;
+    headers: Record<string, string | string[]>;
+    query: Record<string, unknown>;
+    /** The parsed body (JSON), when the request had one. */
+    body?: unknown;
+    /** `http` or `https`, as the receiving node saw it. */
+    protocol?: string;
+    /** Whether the client connection to the receiving node was TLS. */
+    encrypted?: boolean;
+    /** Socket peer address of the client on the receiving node. */
+    peerAddress?: string;
+}
+/** An HTTP request for a session the receiving node owns. */
+export interface RequestRelayMessage {
+    kind: 'relay-request';
+    /** Correlates the response frames with this request. */
+    requestId: string;
+    /** Node that received the request; the response frames are published to it. */
+    sourceNodeId: string;
+    sessionId: string;
+    request: RelayedHttpRequest;
+    timestamp: number;
+    /** How often the owner sends a `keepalive` frame while it serves the request (ms). */
+    keepaliveMs?: number;
+}
+/** One step of a relayed response, in the order the owner produced it. */
+export type RelayResponseEvent = 
+/** The owner received the request and is serving it. */
+{
+    event: 'ack';
+}
+/** The owner is still serving the request (sent while the response is quiet). */
+ | {
+    event: 'keepalive';
+}
+/** Status line and headers. */
+ | {
+    event: 'head';
+    status: number;
+    headers: Record<string, string | string[]>;
+}
+/** A body chunk (`base64` for bytes, `utf8` for text). */
+ | {
+    event: 'data';
+    data: string;
+    encoding: 'utf8' | 'base64';
+}
+/** The response is complete. */
+ | {
+    event: 'end';
+}
+/** The owner could not finish the response. */
+ | {
+    event: 'error';
+    message: string;
+};
+/** A response frame for a relayed request, published back to the node that relayed it. */
+export type ResponseRelayMessage = {
+    kind: 'relay-response';
+    requestId: string;
+    /** The owner that served the request. */
+    sourceNodeId: string;
+} & RelayResponseEvent;
+/** The relaying node's client went away: stop serving the request. */
+export interface CancelRelayMessage {
+    kind: 'relay-cancel';
+    requestId: string;
+    sourceNodeId: string;
+}
+/** Any message on a node's relay channel. */
+export type HaRelayMessage = NotificationRelayMessage | DestroySessionRelayMessage | RequestRelayMessage | ResponseRelayMessage | CancelRelayMessage;
+/** Kinds of the request-relay messages. */
+export type RequestRelayKind = 'relay-request' | 'relay-response' | 'relay-cancel';
+/** Whether a relay channel message belongs to a relayed HTTP request. */
+export declare function isRequestRelayMessage(message: HaRelayMessage): message is RequestRelayMessage | ResponseRelayMessage | CancelRelayMessage;
+//# sourceMappingURL=relay-messages.d.ts.map

package/ha/relay-messages.d.ts.map

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

package/ha/session-takeover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-takeover.d.ts","sourceRoot":"","sources":["../../src/ha/session-takeover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,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;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAQzB"}
+{"version":3,"file":"session-takeover.d.ts","sourceRoot":"","sources":["../../src/ha/session-takeover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,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;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAWzB"}

package/hooks/entry-class-hooks.d.ts

@@ -0,0 +1,27 @@
+import { type FlowName, type FlowPhase, type HookRecord } from '../common';
+/** A flow's plan: its stages by phase. */
+type EntryFlowPlan = Partial<Record<FlowPhase, readonly string[]>>;
+/**
+ * Where the hooks an entry class (`@Tool`, `@Resource`, `@Prompt`, `@Agent`) declares join a run of
+ * the flow that serves the entry. They run on the instance built for the call, so they join while
+ * the stage that builds it runs.
+ */
+export interface EntryClassHooksJoin {
+    /** The flow that serves the entry (`tools:call-tool`, ...). */
+    flow: FlowName;
+    /** That flow's plan. */
+    plan: EntryFlowPlan;
+    /** The stage that builds the entry's instance. */
+    contextStage: string;
+}
+/**
+ * The hooks an entry class declares that can never run, each described for a startup error:
+ * - on its own flow, a stage the run passes before the entry's instance exists (and `Will` or
+ *   `Around` on the stage that builds it);
+ * - on a list flow, which lists entries without building any instance.
+ */
+export declare function describeUnreachableEntryClassHooks(hooks: readonly HookRecord[], join: EntryClassHooksJoin, listFlows: readonly string[]): string[];
+/** The startup error for an entry class whose hooks would never run. */
+export declare function unreachableHooksMessage(kind: string, className: string, problems: readonly string[]): string;
+export {};
+//# sourceMappingURL=entry-class-hooks.d.ts.map

package/hooks/entry-class-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-class-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/entry-class-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE3E,0CAA0C;AAC1C,KAAK,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,QAAQ,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,EAAE,CAoBV;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAM5G"}

package/hooks/hook.registry.d.ts

@@ -11,6 +11,8 @@ export default class HookRegistry extends RegistryAbstract<HookEntry, HookRecord
     private entriesByCls;
     private hooksByFlow;
     private hooksByFlowStage;
+    /** The registry whose flow hooks this one serves too (see {@link inheritFrom}). */
+    private inherited?;
     constructor(providers: ProviderRegistry, list: HookType[]);
     protected buildMap(): RegistryBuildMapResult<HookRecord>;
     protected buildGraph(): void;
@@ -25,8 +27,17 @@ export default class HookRegistry extends RegistryAbstract<HookEntry, HookRecord
     private indexByFlowStage;
     private initializeOne;
     registerHooks(embedded: boolean, ...records: HookRecord[]): Promise<void[]>;
+    /**
+     * Also serve the flow hooks `parent` runs for entries of `ownerId`, after this registry's own hooks
+     * of the same priority. An `@Agent` with `execution.inheritPlugins` uses it: its tools run in the
+     * agent's private scope, and then get the hooks of the plugins installed on the agent's app and on
+     * the server too. A hook of a plugin class installed both here and there runs once, as installed here.
+     */
+    inheritFrom(parent: HookRegistry, ownerId: string): void;
     /** Hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */
     getFlowHooksForOwner<Name extends FlowName>(flow: Name, ownerId?: string): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];
+    /** This registry's own hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */
+    private getOwnFlowHooksForOwner;
     /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */
     getClsHooks(token: Token): HookEntry[];
     /** All hooks (instances, unordered) */

package/hooks/hook.registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.registry.d.ts","sourceRoot":"","sources":["../../src/hooks/hook.registry.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AA0B5E,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAKpD;AAaD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,gBAAgB,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC3F,KAAK,EAAE,UAAU,CAAC;IAElB,iFAAiF;IACjF,YAAY,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAa;IAEnD,kEAAkE;IAClE,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,gBAAgB,CAAsD;gBAElE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;cAKtC,QAAQ,IAAI,sBAAsB,CAAC,UAAU,CAAC;IAWjE,SAAS,CAAC,UAAU;IASd,UAAU;IAOhB,kCAAkC;IAClC,OAAO,CAAC,WAAW;IAInB,qEAAqE;IACrE,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IA4BrB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;IAWzD,0FAA0F;IAC1F,oBAAoB,CAAC,IAAI,SAAS,QAAQ,EACxC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;IAsB5E,qFAAqF;IACrF,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE;IAItC,uCAAuC;IACvC,QAAQ,IAAI,SAAS,EAAE;IAIvB,2DAA2D;IAC3D,YAAY,CAAC,IAAI,SAAS,QAAQ,EAChC,IAAI,EAAE,IAAI,GACT,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;IAS5E,sEAAsE;IACtE,iBAAiB,CAAC,IAAI,SAAS,QAAQ,EACrC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,GACjC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;CAS7E"}
+{"version":3,"file":"hook.registry.d.ts","sourceRoot":"","sources":["../../src/hooks/hook.registry.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACX,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AA0B5E,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAKpD;AAaD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,gBAAgB,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC3F,KAAK,EAAE,UAAU,CAAC;IAElB,iFAAiF;IACjF,YAAY,EAAE,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAa;IAEnD,kEAAkE;IAClE,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,gBAAgB,CAAsD;IAE9E,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAC,CAA8C;gBAEpD,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;cAKtC,QAAQ,IAAI,sBAAsB,CAAC,UAAU,CAAC;IAWjE,SAAS,CAAC,UAAU;IASd,UAAU;IAOhB,kCAAkC;IAClC,OAAO,CAAC,WAAW;IAInB,qEAAqE;IACrE,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;IA4BrB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;IAWzD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxD,0FAA0F;IAC1F,oBAAoB,CAAC,IAAI,SAAS,QAAQ,EACxC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;IAc5E,8GAA8G;IAC9G,OAAO,CAAC,uBAAuB;IAyB/B,qFAAqF;IACrF,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE;IAItC,uCAAuC;IACvC,QAAQ,IAAI,SAAS,EAAE;IAIvB,2DAA2D;IAC3D,YAAY,CAAC,IAAI,SAAS,QAAQ,EAChC,IAAI,EAAE,IAAI,GACT,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;IAS5E,sEAAsE;IACtE,iBAAiB,CAAC,IAAI,SAAS,QAAQ,EACrC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,GACjC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;CAS7E"}

package/hooks/hooks.utils.d.ts

@@ -1,15 +1,29 @@
 import { type Token } from '@frontmcp/di';
-import { type HookEntry, type HookMetadata, type HookRecord } from '../common';
+import { type EntryOwnerRef, type HookContextRun, type HookEntry, type HookMetadata, type HookRecord, type ProviderType } from '../common';
+import type ProviderRegistry from '../provider/provider.registry';
 export declare function collectHook(cls: Token): HookMetadata[];
 /**
  * Hook records declared on a class, from either the class itself (an entry class such as a
  * `@Tool`, whose methods run on each call's instance) or an instance of it (a plugin or provider).
  */
 export declare function normalizeHooksFromCls(source: any): HookRecord[];
-/** Hook records declared on the instances a provider registry holds. */
-export declare function normalizeHooksFromProviders(providers: {
-    getAllSingletons(): ReadonlyMap<Token, unknown>;
-}): HookRecord[];
+/**
+ * Hook records declared on the providers a registry defines: on its singletons, and on the class of
+ * each CONTEXT-scoped provider, whose hooks run on the instance built for each flow run.
+ *
+ * @param only - When given, only the providers with these tokens.
+ */
+export declare function normalizeHooksFromProviders(providers: ProviderRegistry, only?: ReadonlySet<Token>): HookRecord[];
+/**
+ * Hook records of the providers a server declares (`@FrontMcp({ providers })`), owned by its scope so
+ * they run for every app's entries. The framework's own scope providers are left out.
+ */
+export declare function serverProviderHooks(providers: ProviderRegistry, declared: readonly ProviderType[] | undefined, owner: EntryOwnerRef): HookRecord[];
+/**
+ * Give each hook declared on a CONTEXT-scoped provider the instance of that provider for this flow run;
+ * other hooks are returned as they are.
+ */
+export declare function bindContextHookTargets<T extends Pick<HookEntry, 'metadata'>>(hooks: readonly T[], run: HookContextRun): Promise<Array<T | Pick<HookEntry, 'metadata'>>>;
 /** An entry class's hooks aimed at one call's instance, so each call runs them on its own instance. */
 export declare function hooksBoundTo(entries: readonly HookEntry[], instance: object): Array<Pick<HookEntry, 'metadata'>>;
 //# sourceMappingURL=hooks.utils.d.ts.map

package/hooks/hooks.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.utils.d.ts","sourceRoot":"","sources":["../../src/hooks/hooks.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAoC,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAGjH,wBAAgB,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,YAAY,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,UAAU,EAAE,CAkB/D;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,SAAS,EAAE;IACrD,gBAAgB,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CACjD,GAAG,UAAU,EAAE,CAIf;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAKhH"}
+{"version":3,"file":"hooks.utils.d.ts","sourceRoot":"","sources":["../../src/hooks/hooks.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAGlE,wBAAgB,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,YAAY,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,UAAU,EAAE,CAkB/D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,UAAU,EAAE,CAkBhH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAC7C,KAAK,EAAE,aAAa,GACnB,UAAU,EAAE,CAOd;AAWD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAChF,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAiBjD;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAKhH"}