@frontmcp/sdk 1.0.3 → 1.1.0-beta.1

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

@@ -0,0 +1,131 @@
+import { FuncType, Type } from '@frontmcp/di';
+import { ChannelMetadata, ChannelNotification } from '../metadata/channel.metadata';
+import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+/**
+ * Channel type definition (class or factory function).
+ * Used in app/plugin metadata for defining channels.
+ */
+export type ChannelType<T = unknown> = Type<T> | FuncType<T>;
+/**
+ * Constructor arguments for ChannelContext.
+ */
+export type ChannelCtorArgs = ExecutionContextBaseArgs & {
+    metadata: ChannelMetadata;
+};
+/**
+ * Abstract base class for channel execution contexts.
+ *
+ * Channel contexts handle incoming events and transform them into
+ * notifications that are pushed to Claude Code sessions.
+ *
+ * For **service connectors** (source: { type: 'service' }), channels maintain persistent
+ * connections to external services. Claude sends messages via the channel's tools and
+ * receives responses back through `onEvent()` as `notifications/claude/channel`.
+ *
+ * @example Simple webhook channel
+ * ```typescript
+ * @Channel({
+ *   name: 'deploy-alerts',
+ *   source: { type: 'webhook', path: '/hooks/deploy' },
+ * })
+ * class DeployChannel extends ChannelContext {
+ *   async onEvent(payload: unknown): Promise<ChannelNotification> {
+ *     return { content: `Deploy event received` };
+ *   }
+ * }
+ * ```
+ *
+ * @example WhatsApp service connector
+ * ```typescript
+ * @Channel({
+ *   name: 'whatsapp',
+ *   source: { type: 'service', service: 'whatsapp-business' },
+ *   tools: [SendWhatsAppTool],  // Claude calls this to send messages
+ *   twoWay: true,
+ * })
+ * class WhatsAppChannel extends ChannelContext {
+ *   private client: WhatsAppClient;
+ *
+ *   async onConnect(): Promise<void> {
+ *     this.client = new WhatsAppClient(process.env['WA_TOKEN']);
+ *     this.client.on('message', (msg) => {
+ *       // Incoming messages trigger the notification pipeline
+ *       this.pushIncoming({ sender: msg.from, text: msg.body, chatId: msg.chatId });
+ *     });
+ *     await this.client.connect();
+ *   }
+ *
+ *   async onDisconnect(): Promise<void> {
+ *     await this.client?.disconnect();
+ *   }
+ *
+ *   async onEvent(payload: unknown): Promise<ChannelNotification> {
+ *     const msg = payload as { sender: string; text: string; chatId: string };
+ *     return {
+ *       content: `${msg.sender}: ${msg.text}`,
+ *       meta: { chat_id: msg.chatId, sender: msg.sender },
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ChannelContext extends ExecutionContextBase<ChannelNotification> {
+    protected readonly channelName: string;
+    readonly metadata: ChannelMetadata;
+    constructor(args: ChannelCtorArgs);
+    /**
+     * Receive an incoming event and transform it into a notification for Claude Code.
+     *
+     * This is the **inbound** handler — called when the channel's source receives an
+     * external event (webhook POST, service message, app error, agent/job completion).
+     * The returned `ChannelNotification` is pushed to all Claude Code sessions as a
+     * `<channel>` tag.
+     *
+     * @param payload - The raw event payload from the external source
+     * @returns A notification to push to Claude Code sessions
+     */
+    abstract onEvent(payload: unknown): Promise<ChannelNotification>;
+    /**
+     * Handle a reply from Claude Code (only called when twoWay is true).
+     * Override this to forward replies to external systems (Slack, email, etc.).
+     *
+     * @param reply - The reply text from Claude
+     * @param meta - Optional metadata from the reply tool call
+     */
+    onReply(reply: string, meta?: Record<string, string>): Promise<void>;
+    /**
+     * Establish a persistent connection to an external service.
+     * Called during scope initialization for service connector channels.
+     *
+     * Override this to set up WebSocket connections, API clients, polling loops,
+     * or any persistent service connection. Use `pushIncoming()` to feed incoming
+     * messages into the notification pipeline.
+     *
+     * @example
+     * ```typescript
+     * async onConnect(): Promise<void> {
+     *   this.client = new TelegramBot(process.env['BOT_TOKEN']);
+     *   this.client.on('message', (msg) => {
+     *     this.pushIncoming({ sender: msg.from.username, text: msg.text, chatId: msg.chat.id });
+     *   });
+     * }
+     * ```
+     */
+    onConnect(): Promise<void>;
+    /**
+     * Tear down the persistent connection.
+     * Called during scope shutdown for service connector channels.
+     */
+    onDisconnect(): Promise<void>;
+    /**
+     * Push an incoming event from a service connection into the notification pipeline.
+     * This triggers `onEvent()` → notification push to all capable Claude Code sessions.
+     *
+     * Use this inside `onConnect()` when you receive events from persistent connections
+     * (WebSocket messages, polling results, etc.).
+     *
+     * @param payload - The raw event payload to process through `onEvent()`
+     */
+    protected pushIncoming(payload: unknown): void;
+}
+//# sourceMappingURL=channel.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/channel.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAG/F;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,wBAAwB,GAAG;IACvD,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,8BAAsB,cAAe,SAAQ,oBAAoB,CAAC,mBAAmB,CAAC;IACpF,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;gBASvB,IAAI,EAAE,eAAe;IAWjC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAEhE;;;;;;OAMG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;;;;OAQG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAO/C"}

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

@@ -1,11 +1,12 @@
-import type { RuntimeContext } from '@frontmcp/utils';
-import { Token } from '@frontmcp/di';
-import { ProviderRegistryInterface } from './internal';
-import { FrontMcpLogger } from './logger.interface';
-import { AuthInfo } from '@frontmcp/protocol';
-import { ScopeEntry } from '../entries';
-import { FrontMcpContext } from '../../context';
+import { type FrontMcpAuthContext, type FrontMcpFetchInit } from '@frontmcp/auth';
+import { type Token } from '@frontmcp/di';
+import { type AuthInfo } from '@frontmcp/protocol';
+import { type RuntimeContext } from '@frontmcp/utils';
 import { ConfigService } from '../../builtin/config/providers/config.service';
+import { type FrontMcpContext } from '../../context';
+import { type ScopeEntry } from '../entries';
+import { type ProviderRegistryInterface } from './internal';
+import { type FrontMcpLogger } from './logger.interface';
 /**
  * Base constructor arguments for all execution contexts.
  */
@@ -31,6 +32,8 @@ export declare abstract class ExecutionContextBase<Out = unknown> {
     protected activeStage: string;
     /** Error if execution failed */
     private _error?;
+    /** Cached auth context (built lazily on first access) */
+    private _authContext?;
     constructor(args: ExecutionContextBaseArgs);
     /**
      * Get the current FrontMcpContext.
@@ -41,6 +44,22 @@ export declare abstract class ExecutionContextBase<Out = unknown> {
      * @throws RequestContextNotAvailableError if called outside of a context scope
      */
     get context(): FrontMcpContext;
+    /**
+     * Get the FrontMcpAuthContext for the current request.
+     *
+     * Provides typed access to user identity, roles, permissions, scopes,
+     * and convenience methods like `hasRole()`, `hasPermission()`, `hasScope()`.
+     *
+     * Custom fields from `ExtendFrontMcpAuthContext` are available if pipes
+     * are configured in `@FrontMcp({ authorities: { pipes } })`.
+     *
+     * @example
+     * ```typescript
+     * if (!this.auth.hasRole('admin')) throw new Error('Admin required');
+     * const tenantId = this.auth.claims['tenantId'];
+     * ```
+     */
+    get auth(): FrontMcpAuthContext;
     /**
      * Try to get the context, returning undefined if not available.
      *
@@ -101,7 +120,7 @@ export declare abstract class ExecutionContextBase<Out = unknown> {
      *
      * Falls back to standard fetch if context is not available.
      */
-    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    fetch(input: RequestInfo | URL, init?: FrontMcpFetchInit | RequestInit): Promise<Response>;
     /**
      * Get the current error, if any.
      */

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":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,yBAAyB,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,8BAAsB,oBAAoB,CAAC,GAAG,GAAG,OAAO;IACtD,OAAO,CAAC,SAAS,CAA4B;IAE7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAE1C,gDAAgD;IAChD,SAAS,CAAC,WAAW,SAAU;IAE/B,gCAAgC;IAChC,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,IAAI,EAAE,wBAAwB;IAQ1C;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,eAAe,CAO7B;IAED;;;;OAIG;IACH,aAAa,IAAI,eAAe,GAAG,SAAS;IAQ5C;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEhC;IAED;;;;;;;;OAQG;IACH,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAQhC;;;;OAIG;IACH,SAAS,KAAK,aAAa,IAAI,cAAc,CAO5C;IAED;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAI1B;;OAEG;IACH,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAUzC;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK;IAKjC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQtE;;OAEG;IACH,SAAS,KAAK,KAAK,IAAI,KAAK,GAAG,SAAS,CAEvC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,MAAM,IAAI,aAAa,CAG1B;IAID;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO;IAIzD;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,OAAO;IAItD;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,GAAG,OAAO;IAI/D;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO;CAG3C"}
+{"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/flow.interface.d.ts

@@ -1,10 +1,10 @@
-import { Token, Type } from '@frontmcp/di';
-import { FlowMetadata, FlowName } from '../metadata';
-import { z } from 'zod';
-import { HookEntry, ScopeEntry } from '../entries';
-import { FlowStateOf } from './internal/flow.utils';
-import { FrontMcpLogger } from './logger.interface';
+import { type Token, type Type } from '@frontmcp/di';
+import { type z } from '@frontmcp/lazy-zod';
 import type { FrontMcpContext } from '../../context/frontmcp-context';
+import { type HookEntry, type ScopeEntry } from '../entries';
+import { type FlowMetadata, type FlowName } from '../metadata';
+import { type FlowStateOf } from './internal/flow.utils';
+import { type FrontMcpLogger } from './logger.interface';
 export type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;
 export type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;
 export type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];

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

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

package/common/interfaces/index.d.ts

@@ -20,5 +20,6 @@ export * from './agent.interface';
 export * from './skill.interface';
 export * from './job.interface';
 export * from './workflow.interface';
+export * from './channel.interface';
 export * from './internal';
 //# sourceMappingURL=index.d.ts.map

package/common/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,YAAY,CAAC"}

package/common/interfaces/internal/flow.utils.d.ts

@@ -1,5 +1,5 @@
-import { z } from 'zod';
-import { FlowName } from '../../metadata';
+import { type z } from '@frontmcp/lazy-zod';
+import { type FlowName } from '../../metadata';
 type RequiredView<T> = {
     [K in keyof T]-?: Exclude<T[K], undefined>;
 };

package/common/interfaces/internal/flow.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.utils.d.ts","sourceRoot":"","sources":["../../../../src/common/interfaces/internal/flow.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,KAAK,YAAY,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAAC;AACtE,KAAK,WAAW,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAAE,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAE3F,KAAK,SAAS,CAAC,IAAI,SAAS,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAE5E,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACrF,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClF,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;CA6EnG"}
+{"version":3,"file":"flow.utils.d.ts","sourceRoot":"","sources":["../../../../src/common/interfaces/internal/flow.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAG5C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,KAAK,YAAY,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAAC;AACtE,KAAK,WAAW,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAAE,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAE3F,KAAK,SAAS,CAAC,IAAI,SAAS,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAE5E,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACrF,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClF,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,qBAAa,SAAS;IACpB,OAAO;IAIP,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;CA6EnG"}

package/common/interfaces/internal/registry.interface.d.ts

@@ -39,11 +39,12 @@ export interface LoggerRegistryInterface {
 }
 export type GlobalRegistryKind = 'LoggerRegistry' | 'ScopeRegistry';
 export type ScopedRegistryKind = 'AppRegistry' | 'AuthRegistry' | 'FlowRegistry' | 'HookRegistry';
-export type AppRegistryKind = 'ProviderRegistry' | 'PluginRegistry' | 'AdapterRegistry' | 'ToolRegistry' | 'PromptRegistry' | 'ResourceRegistry' | 'AgentRegistry' | 'SkillRegistry' | 'JobRegistry' | 'WorkflowRegistry';
+export type AppRegistryKind = 'ProviderRegistry' | 'PluginRegistry' | 'AdapterRegistry' | 'ToolRegistry' | 'PromptRegistry' | 'ResourceRegistry' | 'AgentRegistry' | 'SkillRegistry' | 'JobRegistry' | 'WorkflowRegistry' | 'ChannelRegistry';
 export type RegistryKind = GlobalRegistryKind | ScopedRegistryKind | AppRegistryKind;
 import type { SkillRegistryInterface } from '../../../skill/skill.registry';
 import type { JobRegistryInterface } from '../../../job/job.registry';
 import type { WorkflowRegistryInterface } from '../../../workflow/workflow.registry';
+import type { ChannelRegistryInterface } from '../../../channel/channel.registry';
 export type RegistryType = {
     LoggerRegistry: LoggerRegistryInterface;
     ScopeRegistry: ScopeRegistryInterface;
@@ -61,5 +62,6 @@ export type RegistryType = {
     SkillRegistry: SkillRegistryInterface;
     JobRegistry: JobRegistryInterface;
     WorkflowRegistry: WorkflowRegistryInterface;
+    ChannelRegistry: ChannelRegistryInterface;
 };
 //# sourceMappingURL=registry.interface.d.ts.map

package/common/interfaces/internal/registry.interface.d.ts.map

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

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

@@ -105,6 +105,13 @@ export declare abstract class ResourceContext<Params extends Record<string, stri
     get output(): Out | undefined;
     set output(v: Out | undefined);
     get outputHistory(): ReadonlyArray<HistoryEntry<Out>>;
+    /**
+     * Notify subscribers that this resource's content has changed.
+     * Only sessions subscribed via `resources/subscribe` receive the notification.
+     *
+     * @param uri - Optional URI to notify about. Defaults to `this.uri`.
+     */
+    notifyUpdated(uri?: string): void;
     respond(value: Out): never;
 }
 export {};

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

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

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

@@ -1,5 +1,5 @@
-import { IncomingMessage, HttpServerResponse } from '@frontmcp/protocol';
-import { Authorization } from '../types';
+import { HttpServerResponse, IncomingMessage } from '@frontmcp/protocol';
+import { type Authorization } from '../types';
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
 export declare class ServerRequest extends IncomingMessage {
     method: HttpMethod;
@@ -53,6 +53,8 @@ export declare abstract class FrontMcpServer {
      * When a string is provided, the server listens on a Unix socket.
      * When a number is provided, the server listens on a TCP port.
      */
-    abstract start(portOrSocketPath?: number | string): Promise<void> | void;
+    abstract start(port: number, bindAddress?: string): Promise<void> | void;
+    abstract start(socketPath: string): Promise<void> | void;
+    abstract start(portOrSocketPath?: number | string, bindAddress?: string): Promise<void> | void;
 }
 //# sourceMappingURL=server.interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1F,qBAAa,aAAc,SAAQ,eAAe;IACxC,MAAM,EAAE,UAAU,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,8BAAsB,cAAe,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAE7C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAEjC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAEjC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAEpC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CACrD;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnH,8BAAsB,cAAc;IAClC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEnG;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAE7G;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CACtB,OAAO,EAAE,oBAAoB,GAC5B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEhE;;;OAGG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CACzE"}
+{"version":3,"file":"server.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1F,qBAAa,aAAc,SAAQ,eAAe;IACxC,MAAM,EAAE,UAAU,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,8BAAsB,cAAe,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAE7C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAEjC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAEjC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAEpC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CACrD;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEhD,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnH,8BAAsB,cAAc;IAClC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEnG;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAE7G;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CACtB,OAAO,EAAE,oBAAoB,GAC5B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEhE;;;OAGG;IACH,QAAQ,CAAC,OAAO,IAAI,IAAI;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IACxE,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IACxD,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAC/F"}

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

@@ -1,10 +1,10 @@
-import { FuncType, Type } from '@frontmcp/di';
-import { ToolInputType, ToolMetadata, ToolOutputType } from '../metadata';
-import { ToolInputOf, ToolOutputOf } from '../decorators';
-import { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';
+import { type FuncType, type Type } from '@frontmcp/di';
+import { type ZodType } from '@frontmcp/lazy-zod';
+import { type ElicitOptions, type ElicitResult } from '../../elicitation';
 import type { AIPlatformType, ClientInfo, McpLoggingLevel } from '../../notification';
-import { ElicitResult, ElicitOptions } from '../../elicitation';
-import { ZodType } from 'zod';
+import { type ToolInputOf, type ToolOutputOf } from '../decorators';
+import { type ToolInputType, type ToolMetadata, type ToolOutputType } from '../metadata';
+import { ExecutionContextBase, type ExecutionContextBaseArgs } from './execution-context.interface';
 export type ToolType<T = unknown> = Type<T> | FuncType<T> | string;
 type HistoryEntry<T> = {
     at: number;
@@ -17,6 +17,13 @@ export type ToolCtorArgs<In> = ExecutionContextBaseArgs & {
     input: In;
     /** Progress token from the request's _meta, used for progress notifications */
     progressToken?: string | number;
+    /**
+     * AbortSignal that fires when the enclosing request is cancelled.
+     * Populated for task-augmented `tools/call` invocations so long-running work
+     * can observe `tasks/cancel` promptly (MCP 2025-11-25 tasks spec).
+     * Non-task invocations leave this unset.
+     */
+    signal?: AbortSignal;
 };
 export declare abstract class ToolContext<InSchema extends ToolInputType = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType, In = ToolInputOf<{
     inputSchema: InSchema;
@@ -33,6 +40,11 @@ export declare abstract class ToolContext<InSchema extends ToolInputType = ToolI
     private readonly _inputHistory;
     private readonly _outputHistory;
     private readonly _progressToken?;
+    /**
+     * AbortSignal exposed to tool authors. Fires when a task-augmented call is
+     * cancelled via `tasks/cancel` (MCP 2025-11-25). Undefined for non-task calls.
+     */
+    readonly signal?: AbortSignal;
     constructor(args: ToolCtorArgs<In>);
     abstract execute(input: In): Promise<Out>;
     get input(): In;

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

@@ -1 +1 @@
-{"version":3,"file":"tool.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,KAAK,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGpG,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAEnE,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,EAAE,IAAI,wBAAwB,GAAG;IACxD,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,EAAE,CAAC;IACV,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC9C,SAAS,SAAS,cAAc,GAAG,cAAc,EACjD,EAAE,GAAG,WAAW,CAAC;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC3C,GAAG,GAAG,YAAY,CAAC;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,CAAC,CAC/C,SAAQ,oBAAoB,CAAC,GAAG,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAShC,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAK;IAGpB,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAC,CAAM;IAGtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAG1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAkB;IAElD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;gBAElB,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;IAelC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAEzC,IAAW,KAAK,IAAI,EAAE,CAErB;IAED,IAAW,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAOjC;IAED,IAAW,YAAY,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAEzD;IAED,IAAW,MAAM,IAAI,GAAG,GAAG,SAAS,CAEnC;IAED,IAAW,MAAM,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,EAGnC;IAED,IAAW,aAAa,IAAI,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAE3D;IAED,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAU1B;;;;;;;;;;;;;;;;;;OAkBG;cACa,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAE,eAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;cACa,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;cACa,MAAM,CAAC,CAAC,SAAS,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,CAAC,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAoBlE;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,QAAQ,IAAI,cAAc,CAa7B;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAMvC;CACF"}

package/common/metadata/adapter.metadata.d.ts

@@ -1,4 +1,3 @@
-import { z } from 'zod';
 /**
  * Declarative metadata describing what a FrontMcpAdapter contributes at app scope.
  */
@@ -7,9 +6,9 @@ export interface AdapterMetadata {
     name: string;
     description?: string;
 }
-export declare const frontMcpAdapterMetadataSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
+export declare const frontMcpAdapterMetadataSchema: import("@frontmcp/lazy-zod").ZodObject<{
+    id: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+    name: import("@frontmcp/lazy-zod").ZodString;
+    description: import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodString>;
+}, import("zod/v4/core").$loose>;
 //# sourceMappingURL=adapter.metadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.metadata.d.ts","sourceRoot":"","sources":["../../../src/common/metadata/adapter.metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,6BAA6B;;;;iBAM1B,CAAC"}
+{"version":3,"file":"adapter.metadata.d.ts","sourceRoot":"","sources":["../../../src/common/metadata/adapter.metadata.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,6BAA6B;;;;gCAM1B,CAAC"}