@frontmcp/sdk 0.3.0 → 0.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"registry.interface.js","sourceRoot":"","sources":["../../../../../src/common/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,\n  LoggerEntry,\n  EntryOwnerRef,\n  HookEntry\n} from '../../entries';\nimport {Token} from '../base.interface';\nimport {FrontMcpAuth} from './primary-auth-provider.interface';\nimport {FlowName} from '../../metadata';\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\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}"]}
+{"version":3,"file":"registry.interface.js","sourceRoot":"","sources":["../../../../../src/common/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,\n  LoggerEntry,\n  EntryOwnerRef,\n  HookEntry,\n} from '../../entries';\nimport { Token } from '../base.interface';\nimport { FrontMcpAuth } from './primary-auth-provider.interface';\nimport { FlowName } from '../../metadata';\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>(\n    flow: Name,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\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\n  /**\n   * Used to pull hooks for a specific flow, optionally filtered by owner ID.\n   * Returns all hooks if no ownerId is provided, or only hooks belonging to\n   * the specified owner or global hooks (no owner) if ownerId is provided.\n   * @param flow\n   * @param ownerId\n   */\n  getFlowHooksForOwner<Name extends FlowName>(\n    flow: Name,\n    ownerId?: string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n\n  registerHooks(embedded: boolean, ...records: HookRecord[]): Promise<void[]>;\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\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\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\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\nexport interface LoggerRegistryInterface {\n  getLoggers(): LoggerEntry[];\n}\n\nexport type GlobalRegistryKind = 'LoggerRegistry' | 'ScopeRegistry';\n\nexport type ScopedRegistryKind = 'AppRegistry' | 'AuthRegistry' | 'FlowRegistry' | 'HookRegistry';\n\nexport type AppRegistryKind =\n  | 'ProviderRegistry'\n  | 'PluginRegistry'\n  | 'AdapterRegistry'\n  | 'ToolRegistry'\n  | 'PromptRegistry'\n  | 'ResourceRegistry';\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};\n"]}

package/src/common/interfaces/plugin.interface.d.ts

@@ -5,4 +5,4 @@ export interface PluginInterface {
 export type PluginClassType<Provide> = ClassType<Provide> & PluginMetadata;
 export type PluginValueType<Provide> = ValueType<Provide> & PluginMetadata;
 export type PluginFactoryType<Provide, Tokens extends readonly Token[]> = FactoryType<Provide, Tokens> & PluginMetadata;
-export type PluginType<Provide extends PluginInterface = PluginInterface> = Type<Provide> | PluginClassType<Provide> | PluginValueType<Provide> | PluginFactoryType<Provide, any[]>;
+export type PluginType<Provide extends PluginInterface = PluginInterface> = Type<Provide> | PluginClassType<Provide> | PluginValueType<Provide> | PluginFactoryType<Provide, readonly any[]>;

package/src/common/interfaces/plugin.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/plugin.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { Type, Token, ValueType, ClassType, FactoryType } from './base.interface';\nimport { PluginMetadata } from '../metadata';\n\nexport interface PluginInterface {\n\n}\n\n\nexport type PluginClassType<Provide> = ClassType<Provide> & PluginMetadata;\nexport type PluginValueType<Provide> = ValueType<Provide> & PluginMetadata;\nexport type PluginFactoryType<Provide, Tokens extends readonly Token[]> = FactoryType<Provide, Tokens> & PluginMetadata;\n\n\nexport type PluginType<Provide extends PluginInterface = PluginInterface> =\n  | Type<Provide>\n  | PluginClassType<Provide>\n  | PluginValueType<Provide>\n  | PluginFactoryType<Provide, any[]>\n\n"]}
+{"version":3,"file":"plugin.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/plugin.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { Type, Token, ValueType, ClassType, FactoryType } from './base.interface';\nimport { PluginMetadata } from '../metadata';\n\nexport interface PluginInterface {\n\n}\n\n\nexport type PluginClassType<Provide> = ClassType<Provide> & PluginMetadata;\nexport type PluginValueType<Provide> = ValueType<Provide> & PluginMetadata;\nexport type PluginFactoryType<Provide, Tokens extends readonly Token[]> = FactoryType<Provide, Tokens> & PluginMetadata;\n\n\nexport type PluginType<Provide extends PluginInterface = PluginInterface> =\n  | Type<Provide>\n  | PluginClassType<Provide>\n  | PluginValueType<Provide>\n  | PluginFactoryType<Provide, readonly any[]>\n\n"]}

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

@@ -1,9 +1,10 @@
-import { FuncType, Token, Type } from "./base.interface";
-import { ProviderRegistryInterface } from "./internal";
-import { ToolMetadata } from "../metadata";
-import { FrontMcpLogger } from "./logger.interface";
-import { URL } from "url";
-import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+import { FuncType, Token, Type } from './base.interface';
+import { ProviderRegistryInterface } from './internal';
+import { ToolInputType, ToolMetadata, ToolOutputType } from '../metadata';
+import { FrontMcpLogger } from './logger.interface';
+import { URL } from 'url';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { ToolInputOf, ToolOutputOf } from '../decorators';
 export type ToolType<T = any> = Type<T> | FuncType<T>;
 type HistoryEntry<T> = {
     at: number;
@@ -18,7 +19,11 @@ export type ToolCtorArgs<In> = {
     logger: FrontMcpLogger;
     authInfo: AuthInfo;
 };
-export declare abstract class ToolContext<In = any, Out = any> {
+export declare abstract class ToolContext<InSchema extends ToolInputType = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType, In = ToolInputOf<{
+    inputSchema: InSchema;
+}>, Out = ToolOutputOf<{
+    outputSchema: OutSchema;
+}>> {
     private providers;
     readonly authInfo: AuthInfo;
     protected readonly runId: string;

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

@@ -64,7 +64,7 @@ class ToolContext {
     }
     set output(v) {
         this._output = v;
-        this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v, });
+        this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });
     }
     get outputHistory() {
         return this._outputHistory;

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

@@ -1 +1 @@
-{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../../src/common/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"]}
+{"version":3,"file":"tool.interface.js","sourceRoot":"","sources":["../../../../src/common/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 { ToolInputType, ToolMetadata, ToolOutputType } 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';\nimport { ToolInputOf, ToolOutputOf } from '../decorators';\n\nexport type ToolType<T = any> = Type<T> | 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<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> {\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  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"]}

package/src/common/metadata/front-mcp.metadata.d.ts

@@ -23,34 +23,34 @@ export declare const frontMcpBaseSchema: z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }>;
     providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>>;
@@ -101,11 +101,11 @@ export declare const frontMcpBaseSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -130,11 +130,11 @@ export declare const frontMcpBaseSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -170,34 +170,34 @@ declare const frontMcpMultiAppSchema: z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }>;
     providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>>;
@@ -365,11 +365,11 @@ declare const frontMcpMultiAppSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -430,11 +430,11 @@ declare const frontMcpMultiAppSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -506,34 +506,34 @@ declare const frontMcpSplitByAppSchema: z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }>;
     providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>>;
@@ -587,11 +587,11 @@ declare const frontMcpSplitByAppSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -618,11 +618,11 @@ declare const frontMcpSplitByAppSchema: z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -657,34 +657,34 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }>;
     providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>>;
@@ -852,11 +852,11 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -917,11 +917,11 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -988,34 +988,34 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }, {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }, {
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     }>;
     providers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>>;
@@ -1069,11 +1069,11 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectOutputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];
@@ -1100,11 +1100,11 @@ export declare const frontMcpMetadataSchema: z.ZodUnion<[z.ZodObject<{
         name: string;
         version: string;
         title?: string | undefined;
-        icons?: z.objectInputType<{
-            src: z.ZodString;
-            mimeType: z.ZodOptional<z.ZodString>;
-            sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        }, z.ZodTypeAny, "passthrough">[] | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+        }[] | undefined;
         websiteUrl?: string | undefined;
     };
     apps: import("../interfaces").Type<unknown>[];

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

@@ -1,5 +1,6 @@
-import { Token } from "../interfaces";
-import { FlowName } from "./flow.metadata";
+import { Token } from '../interfaces';
+import { FlowName } from './flow.metadata';
+import { EntryOwnerRef } from '../entries/base.entry';
 export type HookStageType = 'stage' | 'will' | 'did' | 'around';
 export type HookPriority = number;
 export interface HookOptions<Ctx> {
@@ -16,4 +17,5 @@ export interface HookMetadata<Name extends FlowName = FlowName, Stage = string,
     target: Token;
     method: string;
     static?: boolean;
+    owner?: EntryOwnerRef;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"hook.metadata.js","sourceRoot":"","sources":["../../../../src/common/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}"]}
+{"version":3,"file":"hook.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/hook.metadata.ts"],"names":[],"mappings":"","sourcesContent":["import { Token } from '../interfaces';\nimport { FlowName } from './flow.metadata';\nimport { EntryOwnerRef } from '../entries/base.entry';\n\nexport type HookStageType = 'stage' | 'will' | 'did' | 'around';\nexport type HookPriority = number;\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  owner?: EntryOwnerRef;\n}\n"]}