@frontmcp/sdk 0.2.1 → 0.2.2

package/src/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,gEAAsC;AACtC,6DAAmC;AACnC,4DAAkC;AAClC,2DAAiC;AACjC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC;AAEnC,qDAA0B","sourcesContent":["export * from './base.interface';\nexport * from './front-mcp.interface';\nexport * from './server.interface';\nexport * from './scope.interface';\nexport * from './flow.interface';\nexport * from './app.interface';\nexport * from './provider.interface';\nexport * from './auth-provider.interface';\nexport * from './adapter.interface';\nexport * from './plugin.interface';\nexport * from './tool.interface';\nexport * from './resource.interface';\nexport * from './prompt.interface';\nexport * from './logger.interface';\n\nexport * from './internal'"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,gEAAsC;AACtC,6DAAmC;AACnC,4DAAkC;AAClC,2DAAiC;AACjC,2DAAiC;AACjC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC;AAEnC,qDAA0B","sourcesContent":["export * from './base.interface';\nexport * from './front-mcp.interface';\nexport * from './server.interface';\nexport * from './scope.interface';\nexport * from './flow.interface';\nexport * from './hook.interface';\nexport * from './app.interface';\nexport * from './provider.interface';\nexport * from './auth-provider.interface';\nexport * from './adapter.interface';\nexport * from './plugin.interface';\nexport * from './tool.interface';\nexport * from './resource.interface';\nexport * from './prompt.interface';\nexport * from './logger.interface';\n\nexport * from './internal'"]}

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

@@ -1,16 +1,41 @@
 import { ScopeEntry, FlowEntry, AuthProviderEntry, AppEntry, ProviderEntry, PluginEntry, AdapterEntry, PromptEntry, ResourceEntry, ToolEntry, LoggerEntry } from '../../entries';
 import { Token } from '../base.interface';
-import { EntryOwnerRef } from '../../entries/base.entry';
+import { EntryOwnerRef } from '../../entries';
 import { FrontMcpAuth } from './primary-auth-provider.interface';
 import { FlowName } from '../../metadata';
+import { HookEntry } from "../../entries/hook.entry";
+import { FlowCtxOf, FlowInputOf, FlowStagesOf } from "../flow.interface";
+import { HookRecord } from "../../records";
 export interface ScopeRegistryInterface {
     getScopes(): ScopeEntry[];
 }
 export interface FlowRegistryInterface {
     getFlows(): FlowEntry<FlowName>[];
 }
+export interface HookRegistryInterface {
+    /**
+     * used to pull hooks registered by a class and related to that class only,
+     * like registering hooks on specific tool execution
+     * @param token
+     */
+    getClsHooks(token: Token): HookEntry[];
+    /**
+     * Used to pull all hooks registered to specific flow by name,
+     * this is used to construct the flow graph and execute hooks in order
+     * @param flow
+     */
+    getFlowHooks<Name extends FlowName>(flow: Name): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];
+    /**
+     * Used to pull all hooks registered to specific flow and stage by name,
+     * this is used to construct the flow graph and execute hooks in order
+     * @param flow
+     * @param stage
+     */
+    getFlowStageHooks<Name extends FlowName>(flow: Name, stage: FlowStagesOf<Name> | string): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];
+    registerHooks(embedded: boolean, ...records: HookRecord[]): Promise<void[]>;
+}
 export interface ProviderViews {
-    /** App-wide singletons, created at boot. Immutable from invoke’s POV. */
+    /** App-wide singletons, created at boot. Immutable from invokes POV. */
     global: ReadonlyMap<Token, unknown>;
     /** Session-scoped cache for this sessionId. Mutable. */
     session: Map<Token, unknown>;
@@ -38,7 +63,7 @@ export interface AdapterRegistryInterface {
 }
 export interface ToolRegistryInterface {
     owner: EntryOwnerRef;
-    getTools(includeHidden?: boolean): ToolEntry<any, any>[];
+    getTools(includeHidden?: boolean): ToolEntry[];
     getInlineTools(): ToolEntry<any, any>[];
 }
 export interface ResourceRegistryInterface {
@@ -53,13 +78,14 @@ export interface LoggerRegistryInterface {
     getLoggers(): LoggerEntry[];
 }
 export type GlobalRegistryKind = 'LoggerRegistry' | 'ScopeRegistry';
-export type ScopedRegistryKind = 'AppRegistry' | 'AuthRegistry' | 'FlowRegistry';
+export type ScopedRegistryKind = 'AppRegistry' | 'AuthRegistry' | 'FlowRegistry' | 'HookRegistry';
 export type AppRegistryKind = 'ProviderRegistry' | 'PluginRegistry' | 'AdapterRegistry' | 'ToolRegistry' | 'PromptRegistry' | 'ResourceRegistry';
 export type RegistryKind = GlobalRegistryKind | ScopedRegistryKind | AppRegistryKind;
 export type RegistryType = {
     LoggerRegistry: LoggerRegistryInterface;
     ScopeRegistry: ScopeRegistryInterface;
     FlowRegistry: FlowRegistryInterface;
+    HookRegistry: HookRegistryInterface;
     AppRegistry: AppRegistryInterface;
     AuthRegistry: AuthRegistryInterface;
     ProviderRegistry: ProviderRegistryInterface;

package/src/interfaces/internal/registry.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/internal/registry.interface.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  ScopeEntry,\n  FlowEntry,\n  AuthProviderEntry,\n  AppEntry,\n  ProviderEntry,\n  PluginEntry,\n  AdapterEntry,\n  PromptEntry,\n  ResourceEntry,\n  ToolEntry, LoggerEntry,\n} from '../../entries';\nimport { Token } from '../base.interface';\nimport { EntryOwnerRef } from '../../entries/base.entry';\nimport { FrontMcpAuth } from './primary-auth-provider.interface';\nimport { FlowName } from '../../metadata';\n\nexport interface ScopeRegistryInterface {\n  getScopes(): ScopeEntry[];\n}\n\nexport interface FlowRegistryInterface {\n  getFlows(): FlowEntry<FlowName>[];\n}\n\n\nexport interface ProviderViews {\n  /** App-wide singletons, created at boot. Immutable from invoke’s POV. */\n  global: ReadonlyMap<Token, unknown>;\n  /** Session-scoped cache for this sessionId. Mutable. */\n  session: Map<Token, unknown>;\n  /** Request-scoped providers for this single invocation. Mutable. */\n  request: Map<Token, unknown>;\n}\n\n\nexport interface ProviderRegistryInterface {\n  get<T>(token: Token<T>): T;\n\n  getProviders(): ProviderEntry[];\n\n  getRegistries<T extends RegistryKind>(type: T): RegistryType[T][];\n\n  // TODO: fix session type\n  buildViews(session: any): Promise<ProviderViews>;\n}\n\nexport interface AuthRegistryInterface {\n  getPrimary(): FrontMcpAuth;\n\n  getAuthProviders(): AuthProviderEntry[];\n}\n\nexport interface AppRegistryInterface {\n  getApps(): AppEntry[];\n}\n\nexport interface PluginRegistryInterface {\n  getPlugins(): PluginEntry[];\n\n  //\n  // // nested adapters\n  // getAdapters(): AdapterEntry[];\n  //\n  // // plugin tools plus nested adapter's tools\n  // getTools(): ToolEntry<any, any>[];\n  //\n  // // plugin resources plus nested adapter's tools\n  // getResources(): ResourceEntry[];\n  //\n  // // plugin prompts plus nested adapter's tools\n  // getPrompts(): PromptEntry[];\n}\n\nexport interface AdapterRegistryInterface {\n  getAdapters(): AdapterEntry[];\n\n  //\n  // // nested tools\n  // getTools(): ToolEntry<any, any>[];\n  //\n  // getResources(): ResourceEntry[];\n  //\n  // getPrompts(): PromptEntry[];\n}\n\nexport interface ToolRegistryInterface {\n  owner: EntryOwnerRef;\n\n  // inline tools plus discovered by nested tool registries\n  getTools(includeHidden?:boolean): ToolEntry<any, any>[];\n\n  // inline tools only\n  getInlineTools(): ToolEntry<any, any>[];\n}\n\n\nexport interface ResourceRegistryInterface {\n  // inline resources plus discovered by nested tool registries\n  getResources(): ResourceEntry<any, any>[];\n\n  // inline resources only\n  getInlineResources(): ResourceEntry<any, any>[];\n}\n\n\nexport interface PromptRegistryInterface {\n  // inline prompts plus discovered by nested tool registries\n  getPrompts(): PromptEntry[];\n\n  // inline prompts only\n  getInlinePrompts(): PromptEntry[];\n}\n\n\nexport interface LoggerRegistryInterface {\n  getLoggers(): LoggerEntry[];\n\n}\n\n\nexport type GlobalRegistryKind =\n  | 'LoggerRegistry'\n  | 'ScopeRegistry'\n\nexport type ScopedRegistryKind =\n  | 'AppRegistry'\n  | 'AuthRegistry'\n  | 'FlowRegistry'\n\nexport type AppRegistryKind =\n  | 'ProviderRegistry'\n  | 'PluginRegistry'\n  | 'AdapterRegistry'\n  | 'ToolRegistry'\n  | 'PromptRegistry'\n  | 'ResourceRegistry'\n\n\nexport type RegistryKind = GlobalRegistryKind | ScopedRegistryKind | AppRegistryKind;\n\nexport type RegistryType = {\n  LoggerRegistry: LoggerRegistryInterface;\n  ScopeRegistry: ScopeRegistryInterface;\n  FlowRegistry: FlowRegistryInterface;\n  AppRegistry: AppRegistryInterface;\n  AuthRegistry: AuthRegistryInterface,\n  ProviderRegistry: ProviderRegistryInterface;\n  PluginRegistry: PluginRegistryInterface;\n  AdapterRegistry: AdapterRegistryInterface;\n  ToolRegistry: ToolRegistryInterface;\n  ResourceRegistry: ResourceRegistryInterface;\n  PromptRegistry: PromptRegistryInterface;\n}"]}
+{"version":3,"file":"registry.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/internal/registry.interface.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  ScopeEntry,\n  FlowEntry,\n  AuthProviderEntry,\n  AppEntry,\n  ProviderEntry,\n  PluginEntry,\n  AdapterEntry,\n  PromptEntry,\n  ResourceEntry,\n  ToolEntry, LoggerEntry,\n} from '../../entries';\nimport {Token} from '../base.interface';\nimport {EntryOwnerRef} from '../../entries';\nimport {FrontMcpAuth} from './primary-auth-provider.interface';\nimport {FlowName} from '../../metadata';\nimport {HookEntry} from \"../../entries/hook.entry\";\nimport {FlowCtxOf, FlowInputOf, FlowStagesOf} from \"../flow.interface\";\nimport {HookRecord} from \"../../records\";\n\nexport interface ScopeRegistryInterface {\n  getScopes(): ScopeEntry[];\n}\n\nexport interface FlowRegistryInterface {\n  getFlows(): FlowEntry<FlowName>[];\n}\n\nexport interface HookRegistryInterface {\n  /**\n   * used to pull hooks registered by a class and related to that class only,\n   * like registering hooks on specific tool execution\n   * @param token\n   */\n  getClsHooks(token: Token): HookEntry[];\n\n  /**\n   * Used to pull all hooks registered to specific flow by name,\n   * this is used to construct the flow graph and execute hooks in order\n   * @param flow\n   */\n  getFlowHooks<Name extends FlowName>(flow: Name): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n\n\n  /**\n   * Used to pull all hooks registered to specific flow and stage by name,\n   * this is used to construct the flow graph and execute hooks in order\n   * @param flow\n   * @param stage\n   */\n  getFlowStageHooks<Name extends FlowName>(\n    flow: Name,\n    stage: FlowStagesOf<Name> | string\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[]\n  registerHooks(embedded:boolean,...records: HookRecord[]): Promise<void[]>;\n}\n\n\nexport interface ProviderViews {\n  /** App-wide singletons, created at boot. Immutable from invokes POV. */\n  global: ReadonlyMap<Token, unknown>;\n  /** Session-scoped cache for this sessionId. Mutable. */\n  session: Map<Token, unknown>;\n  /** Request-scoped providers for this single invocation. Mutable. */\n  request: Map<Token, unknown>;\n}\n\n\nexport interface ProviderRegistryInterface {\n  get<T>(token: Token<T>): T;\n\n  getProviders(): ProviderEntry[];\n\n  getRegistries<T extends RegistryKind>(type: T): RegistryType[T][];\n\n  // TODO: fix session type\n  buildViews(session: any): Promise<ProviderViews>;\n}\n\nexport interface AuthRegistryInterface {\n  getPrimary(): FrontMcpAuth;\n\n  getAuthProviders(): AuthProviderEntry[];\n}\n\nexport interface AppRegistryInterface {\n  getApps(): AppEntry[];\n}\n\nexport interface PluginRegistryInterface {\n  getPlugins(): PluginEntry[];\n}\n\nexport interface AdapterRegistryInterface {\n  getAdapters(): AdapterEntry[];\n}\n\nexport interface ToolRegistryInterface {\n  owner: EntryOwnerRef;\n\n  // inline tools plus discovered by nested tool registries\n  getTools(includeHidden?: boolean): ToolEntry[];\n\n  // inline tools only\n  getInlineTools(): ToolEntry<any, any>[];\n}\n\n\nexport interface ResourceRegistryInterface {\n  // inline resources plus discovered by nested tool registries\n  getResources(): ResourceEntry<any, any>[];\n\n  // inline resources only\n  getInlineResources(): ResourceEntry<any, any>[];\n}\n\n\nexport interface PromptRegistryInterface {\n  // inline prompts plus discovered by nested tool registries\n  getPrompts(): PromptEntry[];\n\n  // inline prompts only\n  getInlinePrompts(): PromptEntry[];\n}\n\n\nexport interface LoggerRegistryInterface {\n  getLoggers(): LoggerEntry[];\n\n}\n\n\nexport type GlobalRegistryKind =\n  | 'LoggerRegistry'\n  | 'ScopeRegistry'\n\nexport type ScopedRegistryKind =\n  | 'AppRegistry'\n  | 'AuthRegistry'\n  | 'FlowRegistry'\n  | 'HookRegistry'\n\nexport type AppRegistryKind =\n  | 'ProviderRegistry'\n  | 'PluginRegistry'\n  | 'AdapterRegistry'\n  | 'ToolRegistry'\n  | 'PromptRegistry'\n  | 'ResourceRegistry'\n\n\nexport type RegistryKind = GlobalRegistryKind | ScopedRegistryKind | AppRegistryKind;\n\nexport type RegistryType = {\n  LoggerRegistry: LoggerRegistryInterface;\n  ScopeRegistry: ScopeRegistryInterface;\n  FlowRegistry: FlowRegistryInterface;\n  HookRegistry: HookRegistryInterface;\n  AppRegistry: AppRegistryInterface;\n  AuthRegistry: AuthRegistryInterface,\n  ProviderRegistry: ProviderRegistryInterface;\n  PluginRegistry: PluginRegistryInterface;\n  AdapterRegistry: AdapterRegistryInterface;\n  ToolRegistry: ToolRegistryInterface;\n  ResourceRegistry: ResourceRegistryInterface;\n  PromptRegistry: PromptRegistryInterface;\n}"]}

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

@@ -11,13 +11,20 @@ type HistoryEntry<T> = {
     value: T | undefined;
     note?: string;
 };
-export declare abstract class ToolContext<In, Out> {
+export type ToolCtorArgs<In> = {
+    metadata: ToolMetadata;
+    input: In;
+    providers: ProviderRegistryInterface;
+    logger: FrontMcpLogger;
+    authInfo: AuthInfo;
+};
+export declare abstract class ToolContext<In = any, Out = any> {
     private providers;
     readonly authInfo: AuthInfo;
     protected readonly runId: string;
     protected readonly toolId: string;
     protected readonly toolName: string;
-    protected readonly metadata: ToolMetadata;
+    readonly metadata: ToolMetadata;
     protected readonly logger: FrontMcpLogger;
     protected activeStage: string;
     private _rawInput?;
@@ -27,7 +34,7 @@ export declare abstract class ToolContext<In, Out> {
     private _error?;
     private readonly _inputHistory;
     private readonly _outputHistory;
-    constructor(metadata: ToolMetadata, input: In, providers: ProviderRegistryInterface, logger: FrontMcpLogger, authInfo: any);
+    constructor(args: ToolCtorArgs<In>);
     abstract execute(input: In): Promise<Out>;
     get<T>(token: Token<T>): T;
     tryGet<T>(token: Token<T>): T | undefined;
@@ -37,7 +44,7 @@ export declare abstract class ToolContext<In, Out> {
     get output(): Out | undefined;
     set output(v: Out | undefined);
     get outputHistory(): ReadonlyArray<HistoryEntry<Out>>;
-    protected respond(value: Out): never;
+    respond(value: Out): never;
     /** Fail the run (invoker will run error/finalize). */
     protected fail(err: Error): never;
     mark(stage: string): void;

package/src/interfaces/tool.interface.js

@@ -22,7 +22,8 @@ class ToolContext {
     // ---- histories
     _inputHistory = [];
     _outputHistory = [];
-    constructor(metadata, input, providers, logger, authInfo) {
+    constructor(args) {
+        const { metadata, input, providers, logger, authInfo } = args;
         this.runId = (0, crypto_1.randomUUID)();
         this.toolName = metadata.name;
         this.toolId = metadata.id ?? metadata.name;

package/src/interfaces/tool.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../src/interfaces/tool.interface.ts"],"names":[],"mappings":"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","sourcesContent":["import {randomUUID} from \"crypto\";\nimport {FuncType, Token, Type} from \"./base.interface\";\nimport {ProviderRegistryInterface} from \"./internal\";\nimport {ToolMetadata} from \"../metadata\";\nimport {FrontMcpLogger} from \"./logger.interface\";\nimport {FlowControl} from \"./flow.interface\";\nimport {URL} from \"url\";\nimport {AuthInfo} from \"@modelcontextprotocol/sdk/server/auth/types.js\";\n\nexport type ToolType<T = any> =\n  | Type<T>\n  | FuncType<T>\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport abstract class ToolContext<In, Out> {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  protected readonly runId: string;\n  protected readonly toolId: string;\n  protected readonly toolName: string;\n  protected readonly metadata: ToolMetadata;\n  protected readonly logger: FrontMcpLogger;\n\n  protected activeStage: string;\n\n  // ---- INPUT storages (backing fields)\n  private _rawInput?: Partial<In> | any;\n  private _input?: In;\n\n  // ---- OUTPUT storages (backing fields)\n  private _outputDraft?: Partial<Out> | any;\n  private _output?: Out;\n\n  private _error?: Error;\n\n  // ---- histories\n  private readonly _inputHistory: HistoryEntry<In>[] = [];\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n\n  constructor(metadata: ToolMetadata, input: In, providers: ProviderRegistryInterface, logger: FrontMcpLogger, authInfo: any) {\n    this.runId = randomUUID();\n    this.toolName = metadata.name;\n    this.toolId = metadata.id ?? metadata.name;\n    this.metadata = metadata;\n    this._input = input;\n    this.providers = providers;\n    this.logger = logger.child(`tool:${this.toolId}`);\n    this.authInfo = authInfo;\n  }\n\n  abstract execute(input: In): Promise<Out>;\n\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      this.logger.warn(\"Requesting provider that doesn't exist: \", token);\n      return undefined;\n    }\n  }\n\n  public get input(): In {\n    return this._input as In;\n  }\n\n  public set input(v: In | undefined) {\n    this._input = v;\n    this._inputHistory.push({\n      at: Date.now(),\n      stage: this.activeStage,\n      value: v,\n    });\n  }\n\n  public get inputHistory(): ReadonlyArray<HistoryEntry<In>> {\n    return this._inputHistory;\n  }\n\n  public get output(): Out | undefined {\n    return this._output;\n  }\n\n  public set output(v: Out | undefined) {\n    this._output = v;\n    this._outputHistory.push({at: Date.now(), stage: this.activeStage, value: v,});\n  }\n\n  public get outputHistory(): ReadonlyArray<HistoryEntry<Out>> {\n    return this._outputHistory;\n  }\n\n  protected respond(value: Out): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<Out>(value);\n  }\n\n  /** Fail the run (invoker will run error/finalize). */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n}\n\n"]}
+{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../src/interfaces/tool.interface.ts"],"names":[],"mappings":"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","sourcesContent":["import {randomUUID} from \"crypto\";\nimport {FuncType, Token, Type} from \"./base.interface\";\nimport {ProviderRegistryInterface} from \"./internal\";\nimport {ToolMetadata} from \"../metadata\";\nimport {FrontMcpLogger} from \"./logger.interface\";\nimport {FlowControl} from \"./flow.interface\";\nimport {URL} from \"url\";\nimport {AuthInfo} from \"@modelcontextprotocol/sdk/server/auth/types.js\";\n\nexport type ToolType<T = any> =\n  | Type<T>\n  | FuncType<T>\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type ToolCtorArgs<In> = {\n  metadata: ToolMetadata;\n  input: In;\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger\n  authInfo: AuthInfo;\n}\n\nexport abstract class ToolContext<In = any, Out= any> {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  protected readonly runId: string;\n  protected readonly toolId: string;\n  protected readonly toolName: string;\n  readonly metadata: ToolMetadata;\n  protected readonly logger: FrontMcpLogger;\n\n  protected activeStage: string;\n\n  // ---- INPUT storages (backing fields)\n  private _rawInput?: Partial<In> | any;\n  private _input?: In;\n\n  // ---- OUTPUT storages (backing fields)\n  private _outputDraft?: Partial<Out> | any;\n  private _output?: Out;\n\n  private _error?: Error;\n\n  // ---- histories\n  private readonly _inputHistory: HistoryEntry<In>[] = [];\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n\n  constructor(args: ToolCtorArgs<In>) {\n    const {metadata, input, providers, logger, authInfo} = args;\n    this.runId = randomUUID();\n    this.toolName = metadata.name;\n    this.toolId = metadata.id ?? metadata.name;\n    this.metadata = metadata;\n    this._input = input;\n    this.providers = providers;\n    this.logger = logger.child(`tool:${this.toolId}`);\n    this.authInfo = authInfo;\n  }\n\n  abstract execute(input: In): Promise<Out>;\n\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      this.logger.warn(\"Requesting provider that doesn't exist: \", token);\n      return undefined;\n    }\n  }\n\n  public get input(): In {\n    return this._input as In;\n  }\n\n  public set input(v: In | undefined) {\n    this._input = v;\n    this._inputHistory.push({\n      at: Date.now(),\n      stage: this.activeStage,\n      value: v,\n    });\n  }\n\n  public get inputHistory(): ReadonlyArray<HistoryEntry<In>> {\n    return this._inputHistory;\n  }\n\n  public get output(): Out | undefined {\n    return this._output;\n  }\n\n  public set output(v: Out | undefined) {\n    this._output = v;\n    this._outputHistory.push({at: Date.now(), stage: this.activeStage, value: v,});\n  }\n\n  public get outputHistory(): ReadonlyArray<HistoryEntry<Out>> {\n    return this._outputHistory;\n  }\n\n  respond(value: Out): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<Out>(value);\n  }\n\n  /** Fail the run (invoker will run error/finalize). */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n}\n\n"]}

package/src/metadata/flow.metadata.d.ts

@@ -19,6 +19,7 @@ export type FlowRunOptions<Ctx, Plan extends FlowPlan<string>, Input, Output ext
     output: Output;
     state: State;
     stage: StagesFromPlan<Plan>;
+    executeStage: ExecuteStagesFromPlan<Plan>;
 };
 /**
  * Declarative metadata describing what a FrontMcpFlow contributes at app scope.
@@ -41,6 +42,7 @@ export type FlowPhase = 'pre' | 'execute' | 'post' | 'finalize' | 'error';
 type Values<T> = T[keyof T];
 type ArrayElem<T> = T extends ReadonlyArray<infer U> ? U : never;
 export type StagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Values<Required<P>>>;
+export type ExecuteStagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Required<P['execute']>>;
 export type FlowPlan<Base extends string> = {
     steps?: Record<Base, StepInfo>;
 } & Partial<Record<FlowPhase, Base[]>>;

package/src/metadata/flow.metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.metadata.js","sourceRoot":"","sources":["../../../src/metadata/flow.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AA0DT,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACrE,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,YAAY,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;CACD,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import {z} from 'zod';\nimport {RawZodShape} from '../types';\nimport {HttpMethod, ServerRequest, Token} from '../interfaces';\nimport {ScopeEntry} from '../entries';\n\ndeclare global {\n  // eslint-disable-next-line\n  export interface ExtendFlows {\n\n  }\n}\n\nexport type FlowName = keyof ExtendFlows;\n\nexport type CanActivateFlow = (request: ServerRequest, scope: ScopeEntry) => Promise<boolean>;\n\nexport interface FlowMiddlewareOptions {\n  path?: RegExp | string; // string can be \"/test/**\" or \"/test/*/asds\", default to all paths\n  method?: HttpMethod; // default to all methods\n  canActivate?: CanActivateFlow[];\n}\n\nexport type FlowRunOptions<Ctx, Plan extends FlowPlan<string>, Input, Output extends (z.ZodObject<any> | z.ZodUnion<any> | z.ZodDiscriminatedUnion<any, any>), State extends z.ZodObject<any>> = {\n  ctx: Ctx;\n  plan: Plan;\n  input: Input;\n  output: Output;\n  state: State;\n  stage: StagesFromPlan<Plan>;\n}\n\n/**\n * Declarative metadata describing what a FrontMcpFlow contributes at app scope.\n */\nexport interface FlowMetadata<Name extends FlowName> {\n  name: Name;\n  description?: string;\n  plan: FlowPlan<ExtendFlows[Name]['stage']>;\n  inputSchema: ExtendFlows[Name]['input'];\n  outputSchema: ExtendFlows[Name]['output'];\n  access: 'public' | 'authorized';\n  dependsOn?: Token[];\n  middleware?: FlowMiddlewareOptions;\n}\n\n\nexport type StepInfo = string | { title?: string; description?: string; };\nexport type FlowPhase = 'pre' | 'execute' | 'post' | 'finalize' | 'error';\ntype Values<T> = T[keyof T];\ntype ArrayElem<T> = T extends ReadonlyArray<infer U> ? U : never;\n\nexport type StagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Values<Required<P>>>;\n\nexport type FlowPlan<Base extends string> = {\n  steps?: Record<Base, StepInfo>;\n} & Partial<Record<FlowPhase, Base[]>>;\n\n\nexport const frontMcpFlowMetadataSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().optional(),\n  access: z.enum(['public', 'authorized']).optional().default('public'),\n  inputSchema: z.instanceof(Object),\n  outputSchema: z.instanceof(Object).optional(),\n  plan: z.instanceof(Object),\n  dependsOn: z.array(z.any()).optional(),\n  middleware: z.instanceof(Object).optional(),\n} satisfies RawZodShape<FlowMetadata<never>>).passthrough();\n"]}
+{"version":3,"file":"flow.metadata.js","sourceRoot":"","sources":["../../../src/metadata/flow.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AA4DT,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACrE,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,YAAY,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;CACD,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import {z} from 'zod';\nimport {RawZodShape} from '../types';\nimport {HttpMethod, ServerRequest, Token} from '../interfaces';\nimport {ScopeEntry} from '../entries';\n\ndeclare global {\n  // eslint-disable-next-line\n  export interface ExtendFlows {\n\n  }\n}\n\nexport type FlowName = keyof ExtendFlows;\n\nexport type CanActivateFlow = (request: ServerRequest, scope: ScopeEntry) => Promise<boolean>;\n\nexport interface FlowMiddlewareOptions {\n  path?: RegExp | string; // string can be \"/test/**\" or \"/test/*/asds\", default to all paths\n  method?: HttpMethod; // default to all methods\n  canActivate?: CanActivateFlow[];\n}\n\nexport type FlowRunOptions<Ctx, Plan extends FlowPlan<string>, Input, Output extends (z.ZodObject<any> | z.ZodUnion<any> | z.ZodDiscriminatedUnion<any, any>), State extends z.ZodObject<any>> = {\n  ctx: Ctx;\n  plan: Plan;\n  input: Input;\n  output: Output;\n  state: State;\n  stage: StagesFromPlan<Plan>;\n  executeStage: ExecuteStagesFromPlan<Plan>;\n}\n\n/**\n * Declarative metadata describing what a FrontMcpFlow contributes at app scope.\n */\nexport interface FlowMetadata<Name extends FlowName> {\n  name: Name;\n  description?: string;\n  plan: FlowPlan<ExtendFlows[Name]['stage']>;\n  inputSchema: ExtendFlows[Name]['input'];\n  outputSchema: ExtendFlows[Name]['output'];\n  access: 'public' | 'authorized';\n  dependsOn?: Token[];\n  middleware?: FlowMiddlewareOptions;\n}\n\n\nexport type StepInfo = string | { title?: string; description?: string; };\nexport type FlowPhase = 'pre' | 'execute' | 'post' | 'finalize' | 'error';\ntype Values<T> = T[keyof T];\ntype ArrayElem<T> = T extends ReadonlyArray<infer U> ? U : never;\n\nexport type StagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Values<Required<P>>>;\nexport type ExecuteStagesFromPlan<P extends FlowPlan<string>> = ArrayElem<Required<P['execute']>>;\n\nexport type FlowPlan<Base extends string> = {\n  steps?: Record<Base, StepInfo>;\n} & Partial<Record<FlowPhase, Base[]>>;\n\n\nexport const frontMcpFlowMetadataSchema = z.object({\n  name: z.string().min(1),\n  description: z.string().optional(),\n  access: z.enum(['public', 'authorized']).optional().default('public'),\n  inputSchema: z.instanceof(Object),\n  outputSchema: z.instanceof(Object).optional(),\n  plan: z.instanceof(Object),\n  dependsOn: z.array(z.any()).optional(),\n  middleware: z.instanceof(Object).optional(),\n} satisfies RawZodShape<FlowMetadata<never>>).passthrough();\n"]}

package/src/metadata/hook.metadata.d.ts

@@ -0,0 +1,19 @@
+import { Token } from "../interfaces";
+import { FlowName } from "./flow.metadata";
+export type HookStageType = 'stage' | 'will' | 'did' | 'around';
+export type HookPriority = number;
+export interface HookOptions<Ctx> {
+    priority?: HookPriority;
+    filter?: (ctx: Ctx) => boolean | Promise<boolean>;
+}
+export interface TokenHookMetadata {
+    hooks: HookMetadata[];
+}
+export interface HookMetadata<Name extends FlowName = FlowName, Stage = string, Ctx = any> extends HookOptions<Ctx> {
+    type: HookStageType;
+    flow: Name;
+    stage: Stage;
+    target: Token;
+    method: string;
+    static?: boolean;
+}

package/src/metadata/hook.metadata.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=hook.metadata.js.map

package/src/metadata/hook.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.metadata.js","sourceRoot":"","sources":["../../../src/metadata/hook.metadata.ts"],"names":[],"mappings":"","sourcesContent":["import {Token} from \"../interfaces\";\nimport {FlowName} from \"./flow.metadata\";\n\nexport type HookStageType = 'stage' | 'will' | 'did' | 'around';\nexport type HookPriority = number;\n\n\nexport interface HookOptions<Ctx> {\n  priority?: HookPriority;\n  filter?: (ctx: Ctx) => boolean | Promise<boolean>;\n}\n\nexport interface TokenHookMetadata {\n  hooks: HookMetadata[];\n}\n\nexport interface HookMetadata<Name extends FlowName = FlowName, Stage = string, Ctx = any> extends HookOptions<Ctx> {\n  type: HookStageType;\n  flow: Name,\n  stage: Stage;\n  target: Token;\n  method: string;\n  static?: boolean;\n}"]}

package/src/metadata/index.d.ts

@@ -1,6 +1,6 @@
 export * from './front-mcp.metadata';
 export * from './flow.metadata';
-export * from './flow-hooks.metadata';
+export * from './hook.metadata';
 export * from './app.metadata';
 export * from './provider.metadata';
 export * from './auth-provider.metadata';

package/src/metadata/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./front-mcp.metadata"), exports);
 tslib_1.__exportStar(require("./flow.metadata"), exports);
-tslib_1.__exportStar(require("./flow-hooks.metadata"), exports);
+tslib_1.__exportStar(require("./hook.metadata"), exports);
 tslib_1.__exportStar(require("./app.metadata"), exports);
 tslib_1.__exportStar(require("./provider.metadata"), exports);
 tslib_1.__exportStar(require("./auth-provider.metadata"), exports);

package/src/metadata/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metadata/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,0DAAgC;AAChC,gEAAsC;AACtC,yDAA+B;AAC/B,8DAAoC;AACpC,mEAAyC;AACzC,6DAAmC;AACnC,4DAAkC;AAClC,0DAAgC;AAChC,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC","sourcesContent":["export * from './front-mcp.metadata';\nexport * from './flow.metadata';\nexport * from './flow-hooks.metadata';\nexport * from './app.metadata';\nexport * from './provider.metadata';\nexport * from './auth-provider.metadata';\nexport * from './adapter.metadata';\nexport * from './plugin.metadata';\nexport * from './tool.metadata';\nexport * from './resource.metadata';\nexport * from './prompt.metadata';\nexport * from './logger.metadata';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metadata/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,0DAAgC;AAChC,0DAAgC;AAChC,yDAA+B;AAC/B,8DAAoC;AACpC,mEAAyC;AACzC,6DAAmC;AACnC,4DAAkC;AAClC,0DAAgC;AAChC,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC","sourcesContent":["export * from './front-mcp.metadata';\nexport * from './flow.metadata';\nexport * from './hook.metadata';\nexport * from './app.metadata';\nexport * from './provider.metadata';\nexport * from './auth-provider.metadata';\nexport * from './adapter.metadata';\nexport * from './plugin.metadata';\nexport * from './tool.metadata';\nexport * from './resource.metadata';\nexport * from './prompt.metadata';\nexport * from './logger.metadata';\n"]}

package/src/metadata/tool.metadata.d.ts

@@ -1,6 +1,4 @@
 import { z } from 'zod';
-import { ToolContext } from '../interfaces';
-import { ToolHookStage } from '../interfaces/tool-hook.interface';
 import type { JSONSchema7 } from 'json-schema';
 declare global {
     /**
@@ -178,101 +176,3 @@ export declare const frontMcpToolMetadataSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
     hideFromDiscovery: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.ZodTypeAny, "passthrough">>;
-export interface ToolInlineMetadata<In = any, Out = any> extends ToolMetadata<In, Out> {
-    execute(input: In, ctx: ToolContext<In, Out>): Promise<Out> | Out;
-    hooks?: [ToolHookStage, ((ctx: ToolContext<In, Out>) => Promise<void> | void)][];
-}
-export declare const frontMcpToolInlineMetadataSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
-    rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    annotations: z.ZodOptional<z.ZodObject<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">>>;
-    hideFromDiscovery: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-} & {
-    execute: z.ZodFunction<z.ZodTuple<[z.ZodAny, z.ZodAny], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodAny>, z.ZodAny]>>;
-    hooks: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNativeEnum<typeof ToolHookStage>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodVoid>, z.ZodVoid]>>], null>, "many">>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
-    rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    annotations: z.ZodOptional<z.ZodObject<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">>>;
-    hideFromDiscovery: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-} & {
-    execute: z.ZodFunction<z.ZodTuple<[z.ZodAny, z.ZodAny], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodAny>, z.ZodAny]>>;
-    hooks: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNativeEnum<typeof ToolHookStage>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodVoid>, z.ZodVoid]>>], null>, "many">>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    inputSchema: z.ZodType<Object, z.ZodTypeDef, Object>;
-    rawInputSchema: z.ZodOptional<z.ZodAny>;
-    outputSchema: z.ZodOptional<z.ZodType<Object, z.ZodTypeDef, Object>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    annotations: z.ZodOptional<z.ZodObject<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        title: z.ZodOptional<z.ZodString>;
-        readOnlyHint: z.ZodOptional<z.ZodBoolean>;
-        destructiveHint: z.ZodOptional<z.ZodBoolean>;
-        idempotentHint: z.ZodOptional<z.ZodBoolean>;
-        openWorldHint: z.ZodOptional<z.ZodBoolean>;
-    }, z.ZodTypeAny, "passthrough">>>;
-    hideFromDiscovery: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-} & {
-    execute: z.ZodFunction<z.ZodTuple<[z.ZodAny, z.ZodAny], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodAny>, z.ZodAny]>>;
-    hooks: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNativeEnum<typeof ToolHookStage>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnion<[z.ZodPromise<z.ZodVoid>, z.ZodVoid]>>], null>, "many">>;
-}, z.ZodTypeAny, "passthrough">>;

package/src/metadata/tool.metadata.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpToolInlineMetadataSchema = exports.frontMcpToolMetadataSchema = void 0;
+exports.frontMcpToolMetadataSchema = void 0;
 const zod_1 = require("zod");
-const tool_hook_interface_1 = require("../interfaces/tool-hook.interface");
 const mcpToolAnnotationsSchema = zod_1.z.object({
     title: zod_1.z.string().optional(),
     readOnlyHint: zod_1.z.boolean().optional(),
@@ -21,8 +20,4 @@ exports.frontMcpToolMetadataSchema = zod_1.z.object({
     annotations: mcpToolAnnotationsSchema.optional(),
     hideFromDiscovery: zod_1.z.boolean().optional().default(false),
 }).passthrough();
-exports.frontMcpToolInlineMetadataSchema = exports.frontMcpToolMetadataSchema.extend({
-    execute: zod_1.z.function().args(zod_1.z.any(), zod_1.z.any()).returns(zod_1.z.promise(zod_1.z.any()).or(zod_1.z.any())),
-    hooks: zod_1.z.array(zod_1.z.tuple([zod_1.z.nativeEnum(tool_hook_interface_1.ToolHookStage), zod_1.z.function().returns(zod_1.z.promise(zod_1.z.void()).or(zod_1.z.void()))])).optional(),
-});
 //# sourceMappingURL=tool.metadata.js.map

package/src/metadata/tool.metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.metadata.js","sourceRoot":"","sources":["../../../src/metadata/tool.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGxB,2EAAkE;AAsDlE,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACC,CAAC,CAAC,WAAW,EAAE,CAAC;AAwD3C,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACO,CAAC,CAAC,WAAW,EAAE,CAAC;AAUpE,QAAA,gCAAgC,GAAG,kCAA0B,CAAC,MAAM,CAAC;IAChF,OAAO,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAC,CAAC,GAAG,EAAE,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,OAAC,CAAC,OAAO,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,OAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACpF,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,UAAU,CAAC,mCAAa,CAAC,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAC,CAAC,OAAO,CAAC,OAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,OAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1H,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\nimport { ToolContext } from '../interfaces';\nimport { ToolHookStage } from '../interfaces/tool-hook.interface';\nimport type { JSONSchema7 } from 'json-schema';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to the an McpTool decorator.\n   */\n  export interface ExtendFrontMcpToolMetadata {\n  }\n}\n\n\nexport interface ToolAnnotations {\n  [x: string]: unknown;\n  /**\n   * A human-readable title for the tool.\n   */\n  title?: string;\n  /**\n   * If true, the tool does not modify its environment.\n   *\n   * Default: false\n   */\n  readOnlyHint?: boolean;\n  /**\n   * If true, the tool may perform destructive updates to its environment.\n   * If false, the tool performs only additive updates.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: true\n   */\n  destructiveHint?: boolean;\n  /**\n   * If true, calling the tool repeatedly with the same arguments\n   * will have no additional effect on the its environment.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: false\n   */\n  idempotentHint?: boolean;\n  /**\n   * If true, this tool may interact with an \"open world\" of external\n   * entities. If false, the tool's domain of interaction is closed.\n   * For example, the world of a web search tool is open, whereas that\n   * of a memory tool is not.\n   *\n   * Default: true\n   */\n  openWorldHint?: boolean;\n}\n\n\nconst mcpToolAnnotationsSchema = z.object({\n  title: z.string().optional(),\n  readOnlyHint: z.boolean().optional(),\n  destructiveHint: z.boolean().optional(),\n  idempotentHint: z.boolean().optional(),\n  openWorldHint: z.boolean().optional(),\n} satisfies RawZodShape<ToolAnnotations>).passthrough();\n\n\n/**\n * Declarative metadata describing what an McpTool contributes.\n */\nexport interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends ExtendFrontMcpToolMetadata {\n  /**\n   * Optional unique identifier for the tool.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the tool, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the tool does and when to use it.\n   */\n  description?: string;\n\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  inputSchema: In;\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  rawInputSchema?: JSONSchema7;\n\n  /**\n   * Zod schema describing the structure of the tool's successful output.\n   */\n  outputSchema?: Out;\n\n  /**\n   * Optional list of tags/labels that categorize the tool for discovery and filtering.\n   */\n  tags?: string[];\n\n  annotations?: ToolAnnotations;\n\n  /**\n   * If true, the tool will not be shown in the tool/list action results.\n   * this method can still be called directly with tool/call even if hidden.\n   * use case: tools that are intended to be private or internal. (usually for testing / private apis)\n   * Default: false\n   */\n  hideFromDiscovery?: boolean;\n}\n\n\nexport const frontMcpToolMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  inputSchema: z.instanceof(Object),\n  rawInputSchema: z.any().optional(),\n  outputSchema: z.instanceof(Object).optional(),\n  tags: z.array(z.string().min(1)).optional(),\n  annotations: mcpToolAnnotationsSchema.optional(),\n  hideFromDiscovery: z.boolean().optional().default(false),\n} satisfies RawZodShape<ToolMetadata, ExtendFrontMcpToolMetadata>).passthrough();\n\n\nexport interface ToolInlineMetadata<In = any, Out = any> extends ToolMetadata<In, Out> {\n  execute(input: In, ctx: ToolContext<In, Out>): Promise<Out> | Out;\n\n  hooks?: [ToolHookStage, ((ctx: ToolContext<In, Out>) => Promise<void> | void)][];\n}\n\n\nexport const frontMcpToolInlineMetadataSchema = frontMcpToolMetadataSchema.extend({\n  execute: z.function().args(z.any(), z.any()).returns(z.promise(z.any()).or(z.any())),\n  hooks: z.array(z.tuple([z.nativeEnum(ToolHookStage), z.function().returns(z.promise(z.void()).or(z.void()))])).optional(),\n});\n"]}
+{"version":3,"file":"tool.metadata.js","sourceRoot":"","sources":["../../../src/metadata/tool.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AA0DtB,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACC,CAAC,CAAC,WAAW,EAAE,CAAC;AAwD3C,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACO,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import {z} from 'zod';\nimport {RawZodShape} from '../types';\nimport {ToolContext} from '../interfaces';\nimport {ToolHookStage} from '../interfaces/tool-hook.interface';\nimport type {JSONSchema7} from 'json-schema';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to the an McpTool decorator.\n   */\n  export interface ExtendFrontMcpToolMetadata {\n  }\n}\n\n\nexport interface ToolAnnotations {\n  [x: string]: unknown;\n\n  /**\n   * A human-readable title for the tool.\n   */\n  title?: string;\n  /**\n   * If true, the tool does not modify its environment.\n   *\n   * Default: false\n   */\n  readOnlyHint?: boolean;\n  /**\n   * If true, the tool may perform destructive updates to its environment.\n   * If false, the tool performs only additive updates.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: true\n   */\n  destructiveHint?: boolean;\n  /**\n   * If true, calling the tool repeatedly with the same arguments\n   * will have no additional effect on the its environment.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: false\n   */\n  idempotentHint?: boolean;\n  /**\n   * If true, this tool may interact with an \"open world\" of external\n   * entities. If false, the tool's domain of interaction is closed.\n   * For example, the world of a web search tool is open, whereas that\n   * of a memory tool is not.\n   *\n   * Default: true\n   */\n  openWorldHint?: boolean;\n}\n\n\nconst mcpToolAnnotationsSchema = z.object({\n  title: z.string().optional(),\n  readOnlyHint: z.boolean().optional(),\n  destructiveHint: z.boolean().optional(),\n  idempotentHint: z.boolean().optional(),\n  openWorldHint: z.boolean().optional(),\n} satisfies RawZodShape<ToolAnnotations>).passthrough();\n\n\n/**\n * Declarative metadata describing what an McpTool contributes.\n */\nexport interface ToolMetadata<In = z.ZodRawShape, Out = z.ZodRawShape> extends ExtendFrontMcpToolMetadata {\n  /**\n   * Optional unique identifier for the tool.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the tool, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the tool does and when to use it.\n   */\n  description?: string;\n\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  inputSchema: In;\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  rawInputSchema?: JSONSchema7;\n\n  /**\n   * Zod schema describing the structure of the tool's successful output.\n   */\n  outputSchema?: Out;\n\n  /**\n   * Optional list of tags/labels that categorize the tool for discovery and filtering.\n   */\n  tags?: string[];\n\n  annotations?: ToolAnnotations;\n\n  /**\n   * If true, the tool will not be shown in the tool/list action results.\n   * this method can still be called directly with tool/call even if hidden.\n   * use case: tools that are intended to be private or internal. (usually for testing / private apis)\n   * Default: false\n   */\n  hideFromDiscovery?: boolean;\n}\n\n\nexport const frontMcpToolMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  inputSchema: z.instanceof(Object),\n  rawInputSchema: z.any().optional(),\n  outputSchema: z.instanceof(Object).optional(),\n  tags: z.array(z.string().min(1)).optional(),\n  annotations: mcpToolAnnotationsSchema.optional(),\n  hideFromDiscovery: z.boolean().optional().default(false),\n} satisfies RawZodShape<ToolMetadata, ExtendFrontMcpToolMetadata>).passthrough();\n"]}

package/src/records/hook.record.d.ts

@@ -0,0 +1,11 @@
+import { HookType } from '../interfaces';
+import { HookMetadata } from '../metadata';
+export declare enum HookKind {
+    METHOD_TOKEN = "METHOD_TOKEN"
+}
+export type HooksMethodToken = {
+    kind: HookKind.METHOD_TOKEN;
+    provide: HookType;
+    metadata: HookMetadata;
+};
+export type HookRecord = HooksMethodToken;

package/src/records/hook.record.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookKind = void 0;
+var HookKind;
+(function (HookKind) {
+    HookKind["METHOD_TOKEN"] = "METHOD_TOKEN";
+})(HookKind || (exports.HookKind = HookKind = {}));
+//# sourceMappingURL=hook.record.js.map

package/src/records/hook.record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.record.js","sourceRoot":"","sources":["../../../src/records/hook.record.ts"],"names":[],"mappings":";;;AAGA,IAAY,QAEX;AAFD,WAAY,QAAQ;IAClB,yCAA6B,CAAA;AAC/B,CAAC,EAFW,QAAQ,wBAAR,QAAQ,QAEnB","sourcesContent":["import {HookType} from '../interfaces';\nimport {HookMetadata} from '../metadata';\n\nexport enum HookKind {\n  METHOD_TOKEN = 'METHOD_TOKEN',\n}\n\nexport type HooksMethodToken = {\n  kind: HookKind.METHOD_TOKEN;\n  provide: HookType;\n  metadata: HookMetadata\n};\n\nexport type HookRecord =\n  | HooksMethodToken\n"]}

package/src/records/index.d.ts

@@ -1,5 +1,6 @@
 export * from './scope.record';
 export * from './flow.record';
+export * from './hook.record';
 export * from './app.record';
 export * from './provider.record';
 export * from './auth-provider.record';

package/src/records/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./scope.record"), exports);
 tslib_1.__exportStar(require("./flow.record"), exports);
+tslib_1.__exportStar(require("./hook.record"), exports);
 tslib_1.__exportStar(require("./app.record"), exports);
 tslib_1.__exportStar(require("./provider.record"), exports);
 tslib_1.__exportStar(require("./auth-provider.record"), exports);

package/src/records/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/records/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,wDAA8B;AAC9B,uDAA6B;AAC7B,4DAAkC;AAClC,iEAAuC;AACvC,0DAAgC;AAChC,2DAAiC;AAEjC,wDAA8B;AAC9B,4DAAkC;AAClC,0DAAgC;AAChC,0DAAgC","sourcesContent":["export * from './scope.record';\nexport * from './flow.record';\nexport * from './app.record';\nexport * from './provider.record';\nexport * from './auth-provider.record';\nexport * from './plugin.record';\nexport * from './adapter.record';\n\nexport * from './tool.record';\nexport * from './resource.record';\nexport * from './prompt.record';\nexport * from './logger.record';"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/records/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,wDAA8B;AAC9B,wDAA8B;AAC9B,uDAA6B;AAC7B,4DAAkC;AAClC,iEAAuC;AACvC,0DAAgC;AAChC,2DAAiC;AAEjC,wDAA8B;AAC9B,4DAAkC;AAClC,0DAAgC;AAChC,0DAAgC","sourcesContent":["export * from './scope.record';\nexport * from './flow.record';\nexport * from './hook.record';\nexport * from './app.record';\nexport * from './provider.record';\nexport * from './auth-provider.record';\nexport * from './plugin.record';\nexport * from './adapter.record';\n\nexport * from './tool.record';\nexport * from './resource.record';\nexport * from './prompt.record';\nexport * from './logger.record';"]}

package/src/records/plugin.record.d.ts

@@ -1,21 +1,31 @@
-import { ClassType, FactoryType, Type } from '../interfaces';
+import { ClassType, FactoryType, Type, ValueType } from '../interfaces';
 import { PluginMetadata } from '../metadata';
+import { ProviderRecord } from "./provider.record";
 export declare enum PluginKind {
     CLASS_TOKEN = "CLASS_TOKEN",
     CLASS = "CLASS",
-    FACTORY = "FACTORY"
+    FACTORY = "FACTORY",
+    VALUE = "VALUE"
 }
 export interface PluginClassTokenRecord {
     kind: PluginKind.CLASS_TOKEN;
     provide: Type;
     metadata: PluginMetadata;
+    providers?: ProviderRecord[];
 }
 export interface PluginClassRecord extends ClassType<any> {
     kind: PluginKind.CLASS;
     metadata: PluginMetadata;
+    providers?: ProviderRecord[];
 }
 export interface PluginFactoryRecord extends FactoryType<any, any[]> {
     kind: PluginKind.FACTORY;
     metadata: PluginMetadata;
+    providers?: ProviderRecord[];
 }
-export type PluginRecord = PluginClassTokenRecord | PluginClassRecord | PluginFactoryRecord;
+export interface PluginValueRecord extends ValueType<any> {
+    kind: PluginKind.VALUE;
+    metadata: PluginMetadata;
+    providers?: ProviderRecord[];
+}
+export type PluginRecord = PluginClassTokenRecord | PluginClassRecord | PluginFactoryRecord | PluginValueRecord;

package/src/records/plugin.record.js

@@ -6,6 +6,6 @@ var PluginKind;
     PluginKind["CLASS_TOKEN"] = "CLASS_TOKEN";
     PluginKind["CLASS"] = "CLASS";
     PluginKind["FACTORY"] = "FACTORY";
+    PluginKind["VALUE"] = "VALUE";
 })(PluginKind || (exports.PluginKind = PluginKind = {}));
-;
 //# sourceMappingURL=plugin.record.js.map

package/src/records/plugin.record.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.record.js","sourceRoot":"","sources":["../../../src/records/plugin.record.ts"],"names":[],"mappings":";;;AAGA,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,yCAA2B,CAAA;IAC3B,6BAAe,CAAA;IACf,iCAAmB,CAAA;AACrB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAgBA,CAAC","sourcesContent":["import { ClassType, FactoryType, Type } from '../interfaces';\nimport { PluginMetadata } from '../metadata';\n\nexport enum PluginKind {\n  CLASS_TOKEN = 'CLASS_TOKEN',\n  CLASS = 'CLASS',\n  FACTORY = 'FACTORY',\n}\n\nexport interface PluginClassTokenRecord {\n  kind: PluginKind.CLASS_TOKEN;\n  provide: Type,\n  metadata: PluginMetadata;\n}\n\nexport interface PluginClassRecord extends ClassType<any> {\n  kind: PluginKind.CLASS;\n  metadata: PluginMetadata;\n}\n\nexport interface PluginFactoryRecord extends FactoryType<any, any[]> {\n  kind: PluginKind.FACTORY;\n  metadata: PluginMetadata;\n};\n\nexport type PluginRecord =\n  | PluginClassTokenRecord\n  | PluginClassRecord\n  | PluginFactoryRecord\n\n\n"]}
+{"version":3,"file":"plugin.record.js","sourceRoot":"","sources":["../../../src/records/plugin.record.ts"],"names":[],"mappings":";;;AAIA,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,yCAA2B,CAAA;IAC3B,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,6BAAe,CAAA;AACjB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB","sourcesContent":["import {ClassType, FactoryType, Type, ValueType} from '../interfaces';\nimport {PluginMetadata} from '../metadata';\nimport {ProviderRecord} from \"./provider.record\";\n\nexport enum PluginKind {\n  CLASS_TOKEN = 'CLASS_TOKEN',\n  CLASS = 'CLASS',\n  FACTORY = 'FACTORY',\n  VALUE = 'VALUE',\n}\n\nexport interface PluginClassTokenRecord {\n  kind: PluginKind.CLASS_TOKEN;\n  provide: Type,\n  metadata: PluginMetadata;\n  providers?: ProviderRecord[];\n}\n\nexport interface PluginClassRecord extends ClassType<any> {\n  kind: PluginKind.CLASS;\n  metadata: PluginMetadata;\n  providers?: ProviderRecord[];\n}\n\nexport interface PluginFactoryRecord extends FactoryType<any, any[]> {\n  kind: PluginKind.FACTORY;\n  metadata: PluginMetadata;\n  providers?: ProviderRecord[];\n}\n\nexport interface PluginValueRecord extends ValueType<any> {\n  kind: PluginKind.VALUE;\n  metadata: PluginMetadata;\n  providers?: ProviderRecord[];\n}\n\nexport type PluginRecord =\n  | PluginClassTokenRecord\n  | PluginClassRecord\n  | PluginFactoryRecord\n  | PluginValueRecord\n\n\n"]}

package/src/records/tool.record.d.ts

@@ -6,7 +6,7 @@ export declare enum ToolKind {
 }
 export type ToolClassTokenRecord = {
     kind: ToolKind.CLASS_TOKEN;
-    provide: Type<ToolContext<any, any>>;
+    provide: Type<ToolContext>;
     metadata: ToolMetadata;
 };
 export type ToolFunctionTokenRecord = {

package/src/records/tool.record.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.record.js","sourceRoot":"","sources":["../../../src/records/tool.record.ts"],"names":[],"mappings":";;;AAIA,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,uCAA2B,CAAA;IAC3B,iCAAqB,CAAA;AACvB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB","sourcesContent":["import {ToolContext, Type} from '../interfaces';\nimport {ToolMetadata} from '../metadata';\n\n\nexport enum ToolKind {\n  CLASS_TOKEN = 'CLASS_TOKEN',\n  FUNCTION = 'FUNCTION',\n}\n\nexport type ToolClassTokenRecord = {\n  kind: ToolKind.CLASS_TOKEN;\n  provide: Type<ToolContext<any, any>>;\n  metadata: ToolMetadata\n};\n\nexport type ToolFunctionTokenRecord = {\n  kind: ToolKind.FUNCTION;\n  provide: (...args: any[]) => any | Promise<any>;\n  metadata: ToolMetadata\n};\n\nexport type ToolRecord =\n  | ToolClassTokenRecord\n  | ToolFunctionTokenRecord;\n"]}
+{"version":3,"file":"tool.record.js","sourceRoot":"","sources":["../../../src/records/tool.record.ts"],"names":[],"mappings":";;;AAIA,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,uCAA2B,CAAA;IAC3B,iCAAqB,CAAA;AACvB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB","sourcesContent":["import {ToolContext, Type} from '../interfaces';\nimport {ToolMetadata} from '../metadata';\n\n\nexport enum ToolKind {\n  CLASS_TOKEN = 'CLASS_TOKEN',\n  FUNCTION = 'FUNCTION',\n}\n\nexport type ToolClassTokenRecord = {\n  kind: ToolKind.CLASS_TOKEN;\n  provide: Type<ToolContext>;\n  metadata: ToolMetadata\n};\n\nexport type ToolFunctionTokenRecord = {\n  kind: ToolKind.FUNCTION;\n  provide: (...args: any[]) => any | Promise<any>;\n  metadata: ToolMetadata\n};\n\nexport type ToolRecord =\n  | ToolClassTokenRecord\n  | ToolFunctionTokenRecord;\n"]}

package/src/schemas/annotated-class.schema.js

@@ -20,7 +20,11 @@ exports.annotatedFrontMcpAuthProvidersSchema = zod_1.z.custom((v) => {
             (v['useFactory'] && metadata_1.frontMcpAuthProviderMetadataSchema.passthrough().safeParse(v).success);
 }, { message: 'plugins items must be annotated with @AuthProvider() | @FrontMcpAuthProvider().' });
 exports.annotatedFrontMcpPluginsSchema = zod_1.z.custom((v) => {
-    return (typeof v === 'function' && Reflect.hasMetadata(tokens_1.FrontMcpPluginTokens.type, v));
+    return (typeof v === 'function' && Reflect.hasMetadata(tokens_1.FrontMcpPluginTokens.type, v))
+        ||
+            (v['useValue'] && Reflect.hasMetadata(tokens_1.FrontMcpPluginTokens.type, v.useValue.constructor))
+        ||
+            (v['useFactory'] && metadata_1.frontMcpPluginMetadataSchema.passthrough().safeParse(v).success);
 }, { message: 'plugins items must be annotated with @Plugin() | @FrontMcpPlugin().' });
 exports.annotatedFrontMcpAdaptersSchema = zod_1.z.custom((v) => {
     return typeof v === 'function' && Reflect.hasMetadata(tokens_1.FrontMcpAdapterTokens.type, v)