@frontmcp/sdk 1.8.7 → 1.9.1-rc.1

package/channel/channel-notification.service.d.ts

@@ -12,6 +12,14 @@ export interface ChannelNotificationMeta {
     source: string;
     [key: string]: string;
 }
+/** What the `channels:send-notification` flow takes. */
+export interface ChannelSendInput {
+    channelName: string;
+    content: string;
+    meta?: Record<string, string>;
+    /** Deliver to this session only. */
+    targetSessionId?: string;
+}
 /**
  * Service responsible for sending channel notifications to subscribed Claude Code sessions.
  *
@@ -24,9 +32,17 @@ export interface ChannelNotificationMeta {
  */
 export declare class ChannelNotificationService {
     private readonly notificationService;
+    private readonly sendThroughFlow?;
     private readonly logger;
-    private readonly defaultMeta;
-    constructor(notificationService: NotificationService, logger: FrontMcpLogger, defaultMeta?: Record<string, string>);
+    private readonly serverMeta;
+    /**
+     * @param defaultMeta - The server's `channels.defaultMeta`, added under every notification's own meta.
+     * @param sendThroughFlow - Runs the `channels:send-notification` flow; the scope passes it so that
+     *   `send()` is hookable like every other channel notification.
+     */
+    constructor(notificationService: NotificationService, logger: FrontMcpLogger, defaultMeta?: Record<string, string>, sendThroughFlow?: ((input: ChannelSendInput) => Promise<unknown>) | undefined);
+    /** The server's `channels.defaultMeta`, added under every notification's own meta. */
+    get defaultMeta(): Readonly<Record<string, string>>;
     /**
      * Send a channel notification to all sessions subscribed to this channel.
      * Only sends to sessions that both support channels AND are subscribed to
@@ -52,13 +68,16 @@ export declare class ChannelNotificationService {
      */
     sendToSession(sessionId: string, content: string, meta: ChannelNotificationMeta): boolean;
     /**
-     * Send a channel notification with the given channel name as source.
-     * Only sends to sessions subscribed to this specific channel.
+     * Send a channel notification with the given channel name as source, to the sessions subscribed to
+     * that channel. It runs the hookable `channels:send-notification` flow, which adds
+     * `channels.defaultMeta` and the channel's own `meta` and delivers it. A failure is logged, not thrown.
+     *
+     * `sendToSubscribedSessions()` and `sendToSession()` deliver directly, without the flow.
      *
      * @param channelName - The channel name (becomes the `source` attribute)
      * @param content - The notification content
      * @param additionalMeta - Additional metadata to include
      */
-    send(channelName: string, content: string, additionalMeta?: Record<string, string>): void;
+    send(channelName: string, content: string, additionalMeta?: Record<string, string>): Promise<void>;
 }
 //# sourceMappingURL=channel-notification.service.d.ts.map

package/channel/channel-notification.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-notification.service.d.ts","sourceRoot":"","sources":["../../src/channel/channel-notification.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAQlG;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IAKnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAJtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;gBAGlC,mBAAmB,EAAE,mBAAmB,EACzD,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMtC;;;;;;;OAOG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IA2B9E;;;OAGG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IAI9E;;;;;;;;OAQG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO;IAoCzF;;;;;;;OAOG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAQ1F"}
+{"version":3,"file":"channel-notification.service.d.ts","sourceRoot":"","sources":["../../src/channel/channel-notification.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAQlG;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IAUnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAGpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAZnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAE9D;;;;OAIG;gBAEgB,mBAAmB,EAAE,mBAAmB,EACzD,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnB,eAAe,CAAC,GAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,aAAA;IAMlF,sFAAsF;IACtF,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAElD;IAED;;;;;;;OAOG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IA2B9E;;;OAGG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IAI9E;;;;;;;;OAQG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO;IAoCzF;;;;;;;;;;OAUG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAYzG"}

package/channel/channel-scope.helper.d.ts

@@ -38,6 +38,8 @@ export interface ChannelCapabilitiesResult {
     channelRegistry: ChannelRegistry;
     channelNotificationService: ChannelNotificationService;
     channelEventBus: ChannelEventBus;
+    /** Runs each service channel's `onConnect()`: call it once the scope serves the registry and notification service. */
+    connectServices: () => Promise<void>;
     /** Teardown function: disconnects services and cleans up subscriptions */
     teardown: () => Promise<void>;
 }

package/channel/channel-scope.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-scope.helper.d.ts","sourceRoot":"","sources":["../../src/channel/channel-scope.helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAA6B,MAAM,WAAW,CAAC;AACpH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAGL,KAAK,qBAAqB,EAE3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,eAAe,MAAM,oBAAoB,CAAC;AAKjD,OAAO,EAAE,eAAe,EAAsB,MAAM,4BAA4B,CAAC;AAQjF,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,qBAAqB,CAAC;IACtC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACrE,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACnE;;;;OAIG;IACH,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,cAAc,CAAC;QACvB,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,0BAA0B,EAAE,0BAA0B,CAAC;IACvD,eAAe,EAAE,eAAe,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CAgMpC"}
+{"version":3,"file":"channel-scope.helper.d.ts","sourceRoot":"","sources":["../../src/channel/channel-scope.helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAA6B,MAAM,WAAW,CAAC;AACpH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAGL,KAAK,qBAAqB,EAE3B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,eAAe,MAAM,oBAAoB,CAAC;AAKjD,OAAO,EAAE,eAAe,EAAsB,MAAM,4BAA4B,CAAC;AAQjF,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,qBAAqB,CAAC;IACtC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACrE,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACnE;;;;OAIG;IACH,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,cAAc,CAAC;QACvB,aAAa,EAAE,eAAe,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,0BAA0B,EAAE,0BAA0B,CAAC;IACvD,eAAe,EAAE,eAAe,CAAC;IACjC,sHAAsH;IACtH,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CAwLpC"}

package/channel/channel.instance.d.ts

@@ -61,7 +61,10 @@ export declare class ChannelInstance extends ChannelEntry {
      */
     get replayBuffer(): readonly ChannelNotification[];
     /**
-     * Push a notification to subscribed Claude Code sessions.
+     * Push a notification to subscribed Claude Code sessions, through the hookable
+     * `channels:send-notification` flow. The flow adds the server's `channels.defaultMeta` and this
+     * channel's `meta` under the notification's own, buffers it for replay, and delivers it. A failure
+     * is logged, not thrown.
      *
      * **Session isolation:** If `targetSessionId` is provided, the notification is sent
      * ONLY to that specific session. This prevents session-scoped data (job results,
@@ -74,7 +77,7 @@ export declare class ChannelInstance extends ChannelEntry {
      * @param meta - Additional metadata
      * @param targetSessionId - If set, deliver ONLY to this session
      */
-    pushNotification(content: string, meta?: Record<string, string>, targetSessionId?: string): void;
+    pushNotification(content: string, meta?: Record<string, string>, targetSessionId?: string): Promise<void>;
     /**
      * Replay buffered events to a specific session.
      * Called when a new Claude Code session connects and the channel has buffered events.
@@ -99,6 +102,8 @@ export declare class ChannelInstance extends ChannelEntry {
     handleEvent(payload: unknown, targetSessionId?: string): Promise<ChannelNotification | null>;
     /**
      * Handle a reply from Claude Code (for two-way channels).
+     *
+     * @throws What `onReply()` throws, so the `channel-reply` tool reports the failure to the caller.
      */
     handleReply(reply: string, meta?: Record<string, string>): Promise<void>;
 }

package/channel/channel.instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.instance.d.ts","sourceRoot":"","sources":["../../src/channel/channel.instance.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,YAAY,EAKZ,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAA2B,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE1G;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,mEAAmE;IACnE,OAAO,CAAC,2BAA2B,CAAC,CAA6B;IACjE,2FAA2F;IAC3F,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,0EAA0E;IAC1E,OAAO,CAAC,aAAa,CAA6B;IAClD,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa;IAWpF;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAIjE,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;cAEe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BrC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc;IAwBlE;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,SAAS,mBAAmB,EAAE,CAEjD;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAgChG;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAsB/C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAelG;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAY/E"}
+{"version":3,"file":"channel.instance.d.ts","sourceRoot":"","sources":["../../src/channel/channel.instance.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,YAAY,EAKZ,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAA2B,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE1G;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,mEAAmE;IACnE,OAAO,CAAC,2BAA2B,CAAC,CAA6B;IACjE,2FAA2F;IAC3F,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,0EAA0E;IAC1E,OAAO,CAAC,aAAa,CAA6B;IAClD,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa;IAWpF;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAIjE,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;cAEe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BrC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxC;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc;IAwBlE;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,SAAS,mBAAmB,EAAE,CAEjD;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/G;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAsB/C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAelG;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAa/E"}

package/channel/flows/list-channels.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-channels.flow.d.ts","sourceRoot":"","sources":["../../../src/channel/flows/list-channels.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG/F,QAAA,MAAM,WAAW,oHAA0B,CAAC;AAU5C,QAAA,MAAM,YAAY;;;;;;;;;gCAGhB,CAAC;AAEH,QAAA,MAAM,WAAW;;;;;;;;;;;gCAEf,CAAC;AAEH,QAAA,MAAM,IAAI;;;CAG2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,eAAe,EAAE,cAAc,CAC7B,gBAAgB,EAChB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,eAAwB,CAAC;AAUtC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACjE,MAAM,wCAA8C;IAG9C,YAAY;IAuBZ,QAAQ;CAKf"}
+{"version":3,"file":"list-channels.flow.d.ts","sourceRoot":"","sources":["../../../src/channel/flows/list-channels.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/F,QAAA,MAAM,WAAW,oHAA0B,CAAC;AAU5C,QAAA,MAAM,YAAY;;;;;;;;;gCAGhB,CAAC;AAEH,QAAA,MAAM,WAAW;;;;;;;;;;;gCAEf,CAAC;AAEH,QAAA,MAAM,IAAI;;;CAG2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,eAAe,EAAE,cAAc,CAC7B,gBAAgB,EAChB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,eAAwB,CAAC;AAUtC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACjE,MAAM,wCAA8C;IAG9C,YAAY;IAsBZ,QAAQ;CAKf"}

package/channel/flows/send-channel-notification.flow.d.ts

@@ -3,6 +3,7 @@ declare const inputSchema: import("@frontmcp/lazy-zod").ZodObject<{
     channelName: import("@frontmcp/lazy-zod").ZodString;
     content: import("@frontmcp/lazy-zod").ZodString;
     meta: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodString>>;
+    targetSessionId: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 declare const outputSchema: import("@frontmcp/lazy-zod").ZodObject<{
     sent: import("@frontmcp/lazy-zod").ZodBoolean;
@@ -12,13 +13,14 @@ declare const stateSchema: import("@frontmcp/lazy-zod").ZodObject<{
     channelName: import("@frontmcp/lazy-zod").ZodString;
     content: import("@frontmcp/lazy-zod").ZodString;
     meta: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodRecord<import("@frontmcp/lazy-zod").ZodString, import("@frontmcp/lazy-zod").ZodString>>;
+    targetSessionId: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
     output: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodObject<{
         sent: import("@frontmcp/lazy-zod").ZodBoolean;
         channelName: import("@frontmcp/lazy-zod").ZodString;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>;
 declare const plan: {
-    readonly pre: ["parseInput"];
+    readonly pre: ["parseInput", "resolveMeta"];
     readonly execute: ["send"];
     readonly finalize: ["finalize"];
 };
@@ -28,11 +30,22 @@ declare global {
     }
 }
 declare const name: "channels:send-notification";
+/**
+ * Every channel notification runs this flow: the ones a channel pushes (`channel.pushNotification()`,
+ * which every source uses) and manual pushes through `scope.channelNotifications.send()`. Hooks see
+ * the final metadata from `Will('send')` on, and can stop a notification there.
+ */
 export default class SendChannelNotificationFlow extends FlowBase<typeof name> {
     logger: import("../../common").FrontMcpLogger;
     parseInput(): Promise<void>;
+    /**
+     * The notification's metadata: the server's `channels.defaultMeta`, then the channel's own `meta`,
+     * then the notification's, with `source` always the channel name.
+     */
+    resolveMeta(): Promise<void>;
     send(): Promise<void>;
     finalize(): Promise<void>;
+    private findChannel;
 }
 export {};
 //# sourceMappingURL=send-channel-notification.flow.d.ts.map

package/channel/flows/send-channel-notification.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-channel-notification.flow.d.ts","sourceRoot":"","sources":["../../../src/channel/flows/send-channel-notification.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI/F,QAAA,MAAM,WAAW;;;;gCAIf,CAAC;AAEH,QAAA,MAAM,YAAY;;;gCAGhB,CAAC;AAEH,QAAA,MAAM,WAAW;;;;;;;;gCAKf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,4BAA4B,EAAE,cAAc,CAC1C,2BAA2B,EAC3B,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,4BAAqC,CAAC;AAUnD,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAC5E,MAAM,wCAAyD;IAGzD,UAAU;IAmBV,IAAI;IAoBJ,QAAQ;CAMf"}
+{"version":3,"file":"send-channel-notification.flow.d.ts","sourceRoot":"","sources":["../../../src/channel/flows/send-channel-notification.flow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,QAAQ,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAK/F,QAAA,MAAM,WAAW;;;;;gCAMf,CAAC;AAEH,QAAA,MAAM,YAAY;;;gCAGhB,CAAC;AAEH,QAAA,MAAM,WAAW;;;;;;;;;gCAMf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,4BAA4B,EAAE,cAAc,CAC1C,2BAA2B,EAC3B,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,4BAAqC,CAAC;AAGnD;;;;GAIG;AAQH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAC5E,MAAM,wCAAyD;IAGzD,UAAU;IAmBhB;;;OAGG;IAEG,WAAW;IAcX,IAAI;IA2BJ,QAAQ;IAOd,OAAO,CAAC,WAAW;CAGpB"}

package/channel/reply/channel-reply.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-reply.tool.d.ts","sourceRoot":"","sources":["../../../src/channel/reply/channel-reply.tool.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAQ,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,qBAWa,gBAAiB,SAAQ,WAAW;IACzC,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CA8DjE"}
+{"version":3,"file":"channel-reply.tool.d.ts","sourceRoot":"","sources":["../../../src/channel/reply/channel-reply.tool.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAQ,WAAW,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,qBAWa,gBAAiB,SAAQ,WAAW;IACzC,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CA4DjE"}

package/common/availability/availability.utils.d.ts

@@ -23,9 +23,10 @@ export type CallSurface = NonNullable<EntryAvailability['surface']>[number];
 /**
  * The surface a flow was called from, when its caller tagged one. The MCP request handlers tag
  * every call (`'mcp'`, or `'cli'` for the in-process client of a CLI build), an agent its model's
- * tool calls (`'agent'`), and `this.callTool()` in a job, an agent or a channel handling a webhook
- * tags `'job'`, `'agent'` or `'http-trigger'`. A tool's own `this.callTool()` is in-process dispatch
- * and tags none.
+ * tool calls (`'agent'`), the WebMCP plugin the calls an in-browser agent makes through
+ * `document.modelContext` (`'webmcp'`), and `this.callTool()` in a job, an agent or a channel
+ * handling a webhook tags `'job'`, `'agent'` or `'http-trigger'`. A tool's own `this.callTool()` is
+ * in-process dispatch and tags none.
  */
 export declare function callSurfaceOf(ctx: unknown): CallSurface | undefined;
 /**

package/common/availability/availability.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"availability.utils.d.ts","sourceRoot":"","sources":["../../../src/common/availability/availability.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAI5E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAGnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,WAAW,GAAG,aAAa,GAAG,aAAa,CAG7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,qBAAqB,CAIvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,aAAa,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAA;CAAE,EAClH,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2DN"}
+{"version":3,"file":"availability.utils.d.ts","sourceRoot":"","sources":["../../../src/common/availability/availability.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAW5E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAGnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,WAAW,GAAG,aAAa,GAAG,aAAa,CAG7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,iBAAiB,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,qBAAqB,CAIvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,aAAa,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAA;CAAE,EAClH,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,MAAM,EAAE,cAAc,GACrB,IAAI,CA2DN"}

package/common/dynamic/dynamic.adapter.d.ts

@@ -1,11 +1,15 @@
 import { type AdapterInterface, type AdapterType, type FrontMcpAdapterResponse, type Reference } from '../interfaces';
-type InitOptions<T> = (T & {
+type InitOptions<T, TAdapter> = (T & {
     useFactory?: never;
     inject?: never;
     name: string;
 }) | {
     inject: () => readonly Reference<any>[];
-    useFactory: (...args: any[]) => T;
+    /**
+     * Returns the adapter's options (or a promise of them), from which the adapter is built, or
+     * an adapter the factory built itself, named by the `name` given to `init()`.
+     */
+    useFactory: (...args: any[]) => T | TAdapter | Promise<T | TAdapter>;
     name: string;
 };
 type AdapterClassWithOptions<T> = {
@@ -14,7 +18,13 @@ type AdapterClassWithOptions<T> = {
         __options_brand?: T;
     };
 };
+/** The options type a `DynamicAdapter` subclass is declared with. */
+type AdapterOptionsOf<TThis extends AdapterClassWithOptions<unknown>> = TThis['prototype'] extends {
+    __options_brand?: infer O;
+} ? O : never;
 type AdapterReturn<T> = AdapterType;
+/** The options `SomeAdapter.init(options)` built `adapter` with, or `undefined` for an adapter `init` did not build. */
+export declare function adapterInitOptionsOf(adapter: object): object | undefined;
 export declare abstract class DynamicAdapter<TOptions extends object> implements AdapterInterface {
     abstract options: {
         name: string;
@@ -37,11 +47,7 @@ export declare abstract class DynamicAdapter<TOptions extends object> implements
      * @param options - Adapter options including required `name` field
      * @throws Error if `name` is missing/empty or if a duplicate name is detected
      */
-    static init<TThis extends AdapterClassWithOptions<any>>(this: TThis, options?: InitOptions<TThis['prototype'] extends {
-        __options_brand?: infer O;
-    } ? O : never>): AdapterReturn<TThis['prototype'] extends {
-        __options_brand?: infer O;
-    } ? O : never>;
+    static init<TThis extends AdapterClassWithOptions<any>>(this: TThis, options?: InitOptions<AdapterOptionsOf<TThis>, InstanceType<TThis>>): AdapterReturn<AdapterOptionsOf<TThis>>;
     /**
      * Abstract fetch method to be implemented by subclasses.
      * @returns A promise resolving to any type the will be used

package/common/dynamic/dynamic.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.adapter.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAGtH,KAAK,WAAW,CAAC,CAAC,IACd,CAAC,CAAC,GAAG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,GACF;IACE,MAAM,EAAE,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,KAAK,uBAAuB,CAAC,CAAC,IAAI;IAChC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC1B,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,IAAI,WAAW,CAAC;AAKpC,8BAAsB,cAAc,CAAC,QAAQ,SAAS,MAAM,CAAE,YAAW,gBAAgB;IACvF,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC;IAC9C;;OAEG;IACK,eAAe,EAAE,QAAQ,CAAC;IAElC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,uBAAuB,CAAC,GAAG,CAAC,EACpD,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAExF,GACA,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IAiDtF;;;;OAIG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB;CAC7E"}
+{"version":3,"file":"dynamic.adapter.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAItH,KAAK,WAAW,CAAC,CAAC,EAAE,QAAQ,IACxB,CAAC,CAAC,GAAG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,GACF;IACE,MAAM,EAAE,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACxC;;;OAGG;IACH,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,KAAK,uBAAuB,CAAC,CAAC,IAAI;IAChC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC1B,SAAS,EAAE;QAAE,eAAe,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,qEAAqE;AACrE,KAAK,gBAAgB,CAAC,KAAK,SAAS,uBAAuB,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,SAAS;IACjG,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;CAC3B,GACG,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,aAAa,CAAC,CAAC,IAAI,WAAW,CAAC;AAQpC,wHAAwH;AACxH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAwCD,8BAAsB,cAAc,CAAC,QAAQ,SAAS,MAAM,CAAE,YAAW,gBAAgB;IACvF,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC;IAC9C;;OAEG;IACK,eAAe,EAAE,QAAQ,CAAC;IAElC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,uBAAuB,CAAC,GAAG,CAAC,EACpD,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAGhE,GACA,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAuDzC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB;CAC7E"}

package/common/dynamic/dynamic.plugin.d.ts

@@ -1,11 +1,16 @@
 import { type Reference } from '@frontmcp/di';
 import { type PluginType, type ProviderType, type ToolType } from '../interfaces';
-type InitOptions<TInput> = ((TInput & {
+/**
+ * `init({ providers })` adds providers to the plugin, unless the plugin has an option of its own
+ * named `providers`: then the key is that option (#678).
+ */
+type ExtraProvidersOption<TInput> = 'providers' extends keyof TInput ? unknown : {
+    providers?: readonly ProviderType[];
+};
+type InitOptions<TInput> = (TInput & {
     useFactory?: never;
     inject?: never;
-}) & {
-    providers?: readonly ProviderType[];
-}) | {
+} & ExtraProvidersOption<TInput>) | {
     inject: () => readonly Reference<any>[];
     useFactory: (...args: any[]) => TInput;
     providers?: readonly ProviderType[];

package/common/dynamic/dynamic.plugin.d.ts.map

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

package/common/dynamic/dynamic.utils.d.ts

@@ -1,4 +1,10 @@
-import { type ProviderType, type ToolType } from '../interfaces';
+import { type AdapterInterface, type ProviderType, type ToolType } from '../interfaces';
+/**
+ * Whether a value is an adapter the registry can start: an object with `options.name` and
+ * `fetch()`. Checked by shape rather than `instanceof`, so an adapter built from another copy of
+ * its class (a second bundle of the same package) is still recognised as one.
+ */
+export declare function isAdapterInstance(value: unknown): value is AdapterInterface;
 export declare function collectDynamicProviders<T>(klass: any, options: T): ProviderType[];
 /** Tools a plugin derives from its options, from every `static dynamicTools` on the class chain. */
 export declare function collectDynamicTools<T>(klass: any, options: T): ToolType[];

package/common/dynamic/dynamic.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.utils.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEjE,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,CAejF;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,CAazE;AAKD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,QAAQ,EAAE,GAAG,CAAC,CAQ5G;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAIxF"}
+{"version":3,"file":"dynamic.utils.d.ts","sourceRoot":"","sources":["../../../src/common/dynamic/dynamic.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAI3E;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,CAejF;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,CAazE;AAkBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,QAAQ,EAAE,GAAG,CAAC,CAQ5G;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CAIxF"}

package/common/entries/channel.entry.d.ts

@@ -53,6 +53,6 @@ export declare abstract class ChannelEntry extends BaseEntry<ChannelRecord, Chan
      * @param meta - Optional additional metadata
      * @param targetSessionId - If set, deliver ONLY to this session (session isolation)
      */
-    abstract pushNotification(content: string, meta?: Record<string, string>, targetSessionId?: string): void;
+    abstract pushNotification(content: string, meta?: Record<string, string>, targetSessionId?: string): Promise<void>;
 }
 //# sourceMappingURL=channel.entry.d.ts.map

package/common/entries/channel.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/channel.entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;GAOG;AACH,8BAAsB,YAAa,SAAQ,SAAS,CAAC,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC;IAClG;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAQnB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc;IAE3E;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;CAC1G"}
+{"version":3,"file":"channel.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/channel.entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;;;GAOG;AACH,8BAAsB,YAAa,SAAQ,SAAS,CAAC,aAAa,EAAE,cAAc,EAAE,eAAe,CAAC;IAClG;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAQnB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,cAAc;IAE3E;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACnH"}

package/common/entries/scope.entry.d.ts

@@ -5,6 +5,9 @@ import type AgentRegistry from '../../agent/agent.registry';
 import type AppRegistry from '../../app/app.registry';
 import type { AuthUiRegistry } from '../../auth/auth-ui';
 import type { AuthRegistry } from '../../auth/auth.registry';
+import type { ChannelNotificationService } from '../../channel/channel-notification.service';
+import type ChannelRegistry from '../../channel/channel.registry';
+import type { ChannelEventBus } from '../../channel/sources/app-event.source';
 import type { ElicitationStore } from '../../elicitation/store/elicitation.store';
 import type { HaManager } from '../../ha';
 import type HookRegistry from '../../hooks/hook.registry';
@@ -53,6 +56,15 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, unknown,
     abstract get taskStore(): TaskStore | undefined;
     /** Per-process task registry (AbortControllers + capability projection). */
     abstract get tasks(): TaskRegistry | undefined;
+    /** The channels the scope serves; `undefined` unless `channels.enabled`. */
+    abstract get channels(): ChannelRegistry | undefined;
+    /** Sends channel notifications to the sessions subscribed to a channel; `undefined` unless `channels.enabled`. */
+    abstract get channelNotifications(): ChannelNotificationService | undefined;
+    /**
+     * The bus `app-event` channel sources listen on: `this.scope.channelEventBus?.emit('app:error', payload)`.
+     * `undefined` unless `channels.enabled`.
+     */
+    abstract get channelEventBus(): ChannelEventBus | undefined;
     abstract get authoritiesEngine(): AuthoritiesEngine | undefined;
     abstract get authoritiesContextBuilder(): AuthoritiesContextBuilder | undefined;
     abstract get authoritiesScopeMapping(): AuthoritiesScopeMapping | undefined;
@@ -72,6 +84,20 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, unknown,
      * starting background jobs, logging readiness).
      */
     onServerStarted(callback: () => void | Promise<void>): void;
+    /** Teardown callbacks registered via onDispose(), run once when the scope is disposed. */
+    private readonly disposeCallbacks;
+    private disposeEmitted;
+    /**
+     * Register a callback to run when the scope is disposed: `Scope.dispose()`, or `dispose()` on the
+     * `DirectMcpServer` that `create()` returned. Plugins use it to release what they hold outside the
+     * scope (timers, subscriptions, browser registrations). Unlike onServerStarted(), it also fires in
+     * direct mode, where no HTTP server starts. Callbacks run in reverse order of registration; one
+     * registered after the scope was disposed runs right away.
+     *
+     * @returns A function that removes the callback.
+     */
+    onDispose(callback: () => void | Promise<void>): () => void;
+    private runDisposeCallback;
     abstract registryFlows(...flows: FlowType[]): Promise<void>;
     abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
     abstract runFlowForOutput<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name>>;

package/common/entries/scope.entry.d.ts.map

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

package/common/interfaces/agent.interface.d.ts

@@ -18,6 +18,10 @@ type HistoryEntry<T> = {
     value: T | undefined;
     note?: string;
 };
+/**
+ * Calls another agent by id and returns its output; what `AgentContext.invokeAgent()` runs.
+ */
+export type AgentInvoker = (agentId: string, input: unknown) => Promise<unknown>;
 /**
  * Constructor arguments for AgentContext.
  */
@@ -30,6 +34,8 @@ export type AgentCtorArgs<In> = ExecutionContextBaseArgs & {
     toolDefinitions?: AgentToolDefinition[];
     /** Function to execute tools - provided by AgentInstance */
     toolExecutor?: ToolExecutor;
+    /** Function to call another agent (`invokeAgent()`) - provided by AgentInstance */
+    agentInvoker?: AgentInvoker;
     /** Progress token from the request's _meta, used for progress notifications */
     progressToken?: string | number;
 };
@@ -86,6 +92,8 @@ export declare class AgentContext<InSchema extends ToolInputType = ToolInputType
     protected readonly toolDefinitions: AgentToolDefinition[];
     /** Function to execute tools - provided by AgentInstance */
     protected readonly toolExecutor?: ToolExecutor;
+    /** Function to call another agent - provided by AgentInstance */
+    private readonly agentInvoker?;
     private _rawInput?;
     private _input?;
     private _outputDraft?;
@@ -178,10 +186,18 @@ export declare class AgentContext<InSchema extends ToolInputType = ToolInputType
      */
     protected executeTool(name: string, args: Record<string, unknown>): Promise<unknown>;
     /**
-     * Invoke another agent by ID.
+     * Invoke another agent by id (or name) and return its output.
+     *
+     * The agent called must be one this agent's model could call too: one of its nested agents
+     * (`agents: [...]`), or, with `swarm.canSeeOtherAgents`, another agent of its scope that it sees
+     * (`swarm.visibleAgents`, when set, lists them; an agent with `swarm.isVisible: false` is never
+     * seen). The call runs through the called agent's `invoke_<agent>` tool, so everything that agent
+     * declares (authorities, rate limit, concurrency, timeout, hooks) applies, and counts toward
+     * `swarm.maxCallDepth`.
      *
-     * Only available if `swarm.canSeeOtherAgents` is true or the target agent
-     * is in `swarm.visibleAgents`.
+     * @throws AgentVisibilityError when the agent exists but this agent doesn't see it
+     * @throws AgentNotFoundError when no such agent exists
+     * @throws AgentToolExecutionError when the called agent fails
      */
     protected invokeAgent(agentId: string, input: unknown): Promise<unknown>;
     /** An agent calls tools on the `'agent'` surface, as its model's tool calls do. */

package/common/interfaces/agent.interface.d.ts.map

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

package/common/interfaces/execution-context.interface.d.ts

@@ -52,7 +52,8 @@ export declare abstract class ExecutionContextBase<Out = unknown> {
      * and convenience methods like `hasRole()`, `hasPermission()`, `hasScope()`.
      *
      * Custom fields from `ExtendFrontMcpAuthContext` are available if pipes
-     * are configured in `@FrontMcp({ authorities: { pipes } })`.
+     * are configured in `@FrontMcp({ authorities: { pipes } })`: tools, resources,
+     * agents and jobs run them before any hook or `execute()` reads `this.auth`.
      *
      * @example
      * ```typescript
@@ -179,9 +180,14 @@ export declare abstract class ExecutionContextBase<Out = unknown> {
     /**
      * The hosting platform's bindings for the current request — on a Cloudflare Worker, the `env`
      * object holding KV namespaces, D1 databases, R2 buckets, Durable Object namespaces, `[vars]`
-     * and secrets. `undefined` on Node/Express, where no such object exists.
-     *
-     * Only string bindings are mirrored into `process.env`; use this for the rest.
+     * and secrets. `undefined` where the request carries no such object: Node/Express, stdio, and
+     * `create()`/`connect()` direct servers.
+     *
+     * The SDK never writes `process.env`. The Worker entry that `frontmcp build --target cloudflare`
+     * generates copies string bindings into it on the first request (unless the worker sets
+     * `nodejs_compat_do_not_populate_process_env`); an entry you write yourself around
+     * `createWebFetchHandler` or `getServerlessHandlerAsync()` does not. Every binding, string or
+     * not, is here.
      *
      * @example
      * ```typescript

package/common/interfaces/execution-context.interface.d.ts.map

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

package/common/interfaces/prompt.interface.d.ts

@@ -64,6 +64,18 @@ export declare abstract class PromptContext {
     /** Fail the run (invoker will run error/finalize). */
     protected fail(err: Error): never;
     mark(stage: string): void;
+    /**
+     * The hosting platform's bindings for the current request — on a Cloudflare Worker, the `env`
+     * object holding KV namespaces, D1 databases, R2 buckets, Durable Object namespaces, `[vars]`
+     * and secrets. `undefined` where the request carries no such object: Node/Express, stdio, and
+     * `create()`/`connect()` direct servers. The same contract as a tool's `this.workerEnv`.
+     *
+     * @example
+     * ```typescript
+     * const kv = this.workerEnv?.['MY_KV'] as KVNamespace | undefined;
+     * ```
+     */
+    get workerEnv(): Readonly<Record<string, unknown>> | undefined;
     /** Get the current runtime context (platform, runtime, deployment, env). */
     get runtimeContext(): RuntimeContext;
     /** Check if running on a specific OS platform. */

package/common/interfaces/prompt.interface.d.ts.map

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