@frontmcp/sdk 0.4.0 → 0.5.0

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

@@ -0,0 +1,59 @@
+import { Token } from './base.interface';
+import { ProviderRegistryInterface } from './internal';
+import { FrontMcpLogger } from './logger.interface';
+import { URL } from 'url';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { ScopeEntry } from '../entries';
+/**
+ * Base constructor arguments for all execution contexts.
+ */
+export type ExecutionContextBaseArgs = {
+    providers: ProviderRegistryInterface;
+    logger: FrontMcpLogger;
+    authInfo: AuthInfo;
+};
+/**
+ * Abstract base class for execution contexts (tools, resources, prompts, etc.).
+ * Provides common functionality for dependency injection, logging, and flow control.
+ */
+export declare abstract class ExecutionContextBase<Out = unknown> {
+    private providers;
+    readonly authInfo: AuthInfo;
+    /** Unique identifier for this execution run */
+    protected readonly runId: string;
+    protected readonly logger: FrontMcpLogger;
+    /** Current stage name for tracking/debugging */
+    protected activeStage: string;
+    /** Error if execution failed */
+    private _error?;
+    constructor(args: ExecutionContextBaseArgs);
+    /**
+     * Get a dependency from the provider registry.
+     * @throws Error if the dependency is not found
+     */
+    get<T>(token: Token<T>): T;
+    /**
+     * Get the current scope.
+     */
+    get scope(): ScopeEntry;
+    /**
+     * Try to get a dependency, returning undefined if not found.
+     */
+    tryGet<T>(token: Token<T>): T | undefined;
+    /**
+     * Fail the execution and trigger error handling.
+     */
+    protected fail(err: Error): never;
+    /**
+     * Mark the current execution stage (for debugging/tracking).
+     */
+    mark(stage: string): void;
+    /**
+     * Fetch a URL using the standard fetch API.
+     */
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+    /**
+     * Get the current error, if any.
+     */
+    protected get error(): Error | undefined;
+}

package/src/common/interfaces/execution-context.interface.js

@@ -0,0 +1,81 @@
+"use strict";
+// file: libs/sdk/src/common/interfaces/execution-context.interface.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionContextBase = void 0;
+const crypto_1 = require("crypto");
+const flow_interface_1 = require("./flow.interface");
+/**
+ * Abstract base class for execution contexts (tools, resources, prompts, etc.).
+ * Provides common functionality for dependency injection, logging, and flow control.
+ */
+class ExecutionContextBase {
+    providers;
+    authInfo;
+    /** Unique identifier for this execution run */
+    runId;
+    logger;
+    /** Current stage name for tracking/debugging */
+    activeStage = 'init';
+    /** Error if execution failed */
+    _error;
+    constructor(args) {
+        const { providers, logger, authInfo } = args;
+        this.runId = (0, crypto_1.randomUUID)();
+        this.providers = providers;
+        this.logger = logger;
+        this.authInfo = authInfo;
+    }
+    /**
+     * Get a dependency from the provider registry.
+     * @throws Error if the dependency is not found
+     */
+    get(token) {
+        return this.providers.get(token);
+    }
+    /**
+     * Get the current scope.
+     */
+    get scope() {
+        return this.providers.getScope();
+    }
+    /**
+     * Try to get a dependency, returning undefined if not found.
+     */
+    tryGet(token) {
+        try {
+            return this.providers.get(token);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);
+            return undefined;
+        }
+    }
+    /**
+     * Fail the execution and trigger error handling.
+     */
+    fail(err) {
+        this._error = err;
+        flow_interface_1.FlowControl.fail(err);
+    }
+    /**
+     * Mark the current execution stage (for debugging/tracking).
+     */
+    mark(stage) {
+        this.activeStage = stage;
+    }
+    /**
+     * Fetch a URL using the standard fetch API.
+     */
+    fetch(input, init) {
+        return fetch(input, init);
+    }
+    /**
+     * Get the current error, if any.
+     */
+    get error() {
+        return this._error;
+    }
+}
+exports.ExecutionContextBase = ExecutionContextBase;
+//# sourceMappingURL=execution-context.interface.js.map

package/src/common/interfaces/execution-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/execution-context.interface.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE,mCAAoC;AAIpC,qDAA+C;AAc/C;;;GAGG;AACH,MAAsB,oBAAoB;IAChC,SAAS,CAA4B;IACpC,QAAQ,CAAW;IAE5B,+CAA+C;IAC5B,KAAK,CAAS;IACd,MAAM,CAAiB;IAE1C,gDAAgD;IACtC,WAAW,GAAG,MAAM,CAAC;IAE/B,gCAAgC;IACxB,MAAM,CAAS;IAEvB,YAAY,IAA8B;QACxC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,KAAe;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAI,KAAe;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACO,IAAI,CAAC,GAAU;QACvB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,4BAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAwB,EAAE,IAAkB;QAChD,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAc,KAAK;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AA9ED,oDA8EC","sourcesContent":["// file: libs/sdk/src/common/interfaces/execution-context.interface.ts\n\nimport { randomUUID } from 'crypto';\nimport { Token } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { URL } from 'url';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ScopeEntry } from '../entries';\n\n/**\n * Base constructor arguments for all execution contexts.\n */\nexport type ExecutionContextBaseArgs = {\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: AuthInfo;\n};\n\n/**\n * Abstract base class for execution contexts (tools, resources, prompts, etc.).\n * Provides common functionality for dependency injection, logging, and flow control.\n */\nexport abstract class ExecutionContextBase<Out = unknown> {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  /** Unique identifier for this execution run */\n  protected readonly runId: string;\n  protected readonly logger: FrontMcpLogger;\n\n  /** Current stage name for tracking/debugging */\n  protected activeStage = 'init';\n\n  /** Error if execution failed */\n  private _error?: Error;\n\n  constructor(args: ExecutionContextBaseArgs) {\n    const { providers, logger, authInfo } = args;\n    this.runId = randomUUID();\n    this.providers = providers;\n    this.logger = logger;\n    this.authInfo = authInfo;\n  }\n\n  /**\n   * Get a dependency from the provider registry.\n   * @throws Error if the dependency is not found\n   */\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  /**\n   * Get the current scope.\n   */\n  get scope(): ScopeEntry {\n    return this.providers.getScope();\n  }\n\n  /**\n   * Try to get a dependency, returning undefined if not found.\n   */\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : String(e);\n      this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);\n      return undefined;\n    }\n  }\n\n  /**\n   * Fail the execution and trigger error handling.\n   */\n  protected fail(err: Error): never {\n    this._error = err;\n    FlowControl.fail(err);\n  }\n\n  /**\n   * Mark the current execution stage (for debugging/tracking).\n   */\n  mark(stage: string): void {\n    this.activeStage = stage;\n  }\n\n  /**\n   * Fetch a URL using the standard fetch API.\n   */\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n\n  /**\n   * Get the current error, if any.\n   */\n  protected get error(): Error | undefined {\n    return this._error;\n  }\n}\n"]}

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

@@ -3,7 +3,7 @@ import { FlowMetadata, FlowName } from '../metadata';
 import { z } from 'zod';
 import { HookEntry, ScopeEntry } from '../entries';
 import { FlowStateOf } from './internal/flow.utils';
-import { FrontMcpLogger } from "./logger.interface";
+import { FrontMcpLogger } from './logger.interface';
 export type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;
 export type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;
 export type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];

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

@@ -1 +1 @@
-{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/flow.interface.ts"],"names":[],"mappings":";;;AAIA,sDAA6D;AAa7D,MAAa,WAAY,SAAQ,KAAK;IACR;IAAuC;IAAnE,YAA4B,IAAqB,EAAkB,MAAW;QAC5E,KAAK,EAAE,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAiB;QAAkB,WAAM,GAAN,MAAM,CAAK;IAE9E,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,MAAS;QACzB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAY;QACtB,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CAEF;AAzBD,kCAyBC;AAGD,uCAAuC;AACvC,MAAsB,QAAQ;IAMP;IACV;IACU;IACA;IACA;IATX,KAAK,CAAiB;IAChC,KAAK,GAAmB,sBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAiB;IAE5B,YACqB,QAAyB,EACnC,QAAuC,EAC7B,KAAiB,EACjB,kBAAgD,EAChD,OAAoC,IAAI,GAAG,EAAE;QAJ7C,aAAQ,GAAR,QAAQ,CAAiB;QACnC,aAAQ,GAAR,QAAQ,CAA+B;QAC7B,UAAK,GAAL,KAAK,CAAY;QACjB,uBAAkB,GAAlB,kBAAkB,CAA8B;QAChD,SAAI,GAAJ,IAAI,CAAyC;QAEhE,IAAI,CAAC,KAAK,GAAI,QAAQ,CAAC,WAAmB,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,KAAe;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,MAAuB;QAC7B,MAAM,WAAW,CAAC,OAAO,CAAE,IAAI,CAAC,QAAQ,CAAC,YAAiC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,KAAY;QACf,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,OAAe;QAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI;QACZ,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAES,OAAO;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CAEF;AAzCD,4BAyCC","sourcesContent":["import {Token, Type} from './base.interface';\nimport {FlowMetadata, FlowName} from '../metadata';\nimport {z} from 'zod';\nimport {HookEntry, ScopeEntry} from '../entries';\nimport {FlowState, FlowStateOf} from './internal/flow.utils';\nimport {FrontMcpLogger} from \"./logger.interface\";\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\nexport type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];\nexport type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];\n\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', {error: error.message});\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n\n}\n\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly appendContextHooks: (hooks: HookEntry[]) => void,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n\n}\n\nexport type FlowType<Provide = FlowBase<any>> =\n  | Type<Provide>\n\n"]}
+{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/flow.interface.ts"],"names":[],"mappings":";;;AAIA,sDAA+D;AAY/D,MAAa,WAAY,SAAQ,KAAK;IACR;IAAuC;IAAnE,YAA4B,IAAqB,EAAkB,MAAW;QAC5E,KAAK,EAAE,CAAC;QADkB,SAAI,GAAJ,IAAI,CAAiB;QAAkB,WAAM,GAAN,MAAM,CAAK;IAE9E,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,MAAS;QACzB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAY;QACtB,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF;AAxBD,kCAwBC;AAED,uCAAuC;AACvC,MAAsB,QAAQ;IAMP;IACV;IACU;IACA;IACA;IATX,KAAK,CAAiB;IAChC,KAAK,GAAmB,sBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAiB;IAE5B,YACqB,QAAyB,EACnC,QAAuC,EAC7B,KAAiB,EACjB,kBAAgD,EAChD,OAAoC,IAAI,GAAG,EAAE;QAJ7C,aAAQ,GAAR,QAAQ,CAAiB;QACnC,aAAQ,GAAR,QAAQ,CAA+B;QAC7B,UAAK,GAAL,KAAK,CAAY;QACjB,uBAAkB,GAAlB,kBAAkB,CAA8B;QAChD,SAAI,GAAJ,IAAI,CAAyC;QAEhE,IAAI,CAAC,KAAK,GAAI,QAAQ,CAAC,WAAmB,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,KAAe;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,MAAuB;QAC7B,MAAM,WAAW,CAAC,OAAO,CAAE,IAAI,CAAC,QAAQ,CAAC,YAAiC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,KAAY;QACf,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,OAAe;QAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI;QACZ,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAES,OAAO;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAxCD,4BAwCC","sourcesContent":["import { Token, Type } from './base.interface';\nimport { FlowMetadata, FlowName } from '../metadata';\nimport { z } from 'zod';\nimport { HookEntry, ScopeEntry } from '../entries';\nimport { FlowState, FlowStateOf } from './internal/flow.utils';\nimport { FrontMcpLogger } from './logger.interface';\n\nexport type FlowInputOf<N extends FlowName> = z.infer<ExtendFlows[N]['input']>;\nexport type FlowOutputOf<N extends FlowName> = z.infer<ExtendFlows[N]['output']>;\nexport type FlowPlanOf<N extends FlowName> = ExtendFlows[N]['plan'];\nexport type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];\nexport type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];\nexport type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];\n\nexport type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';\n\nexport class FlowControl extends Error {\n  constructor(public readonly type: FlowControlType, public readonly output: any) {\n    super();\n  }\n\n  static respond<T>(output: T): never {\n    throw new FlowControl('respond', output);\n  }\n\n  static next(): never {\n    throw new FlowControl('next', null);\n  }\n\n  static handled(): never {\n    throw new FlowControl('handled', null);\n  }\n\n  static fail(error: Error): never {\n    throw new FlowControl('fail', { error: error.message });\n  }\n\n  static abort(reason: string): never {\n    throw new FlowControl('abort', reason);\n  }\n}\n\n// 1) The actual abstract class (value)\nexport abstract class FlowBase<N extends FlowName = FlowName> {\n  protected input: FlowInputOf<N>;\n  state: FlowStateOf<N> = FlowState.create({});\n  scopeLogger: FrontMcpLogger;\n\n  constructor(\n    protected readonly metadata: FlowMetadata<N>,\n    readonly rawInput: Partial<FlowInputOf<N>> | any,\n    protected readonly scope: ScopeEntry,\n    protected readonly appendContextHooks: (hooks: HookEntry[]) => void,\n    protected readonly deps: ReadonlyMap<Token, unknown> = new Map(),\n  ) {\n    this.input = (metadata.inputSchema as any)?.parse?.(rawInput);\n    this.scopeLogger = scope.logger;\n  }\n\n  get<T>(token: Token<T>): T {\n    if (this.deps.has(token)) return this.deps.get(token) as T;\n    return this.scope.providers.get(token);\n  }\n\n  respond(output: FlowOutputOf<N>) {\n    throw FlowControl.respond((this.metadata.outputSchema as z.ZodObject<any>).parse(output));\n  }\n\n  fail(error: Error) {\n    throw FlowControl.fail(error);\n  }\n\n  protected abort(message: string) {\n    throw FlowControl.abort(message);\n  }\n\n  protected next() {\n    throw FlowControl.next();\n  }\n\n  protected handled() {\n    throw FlowControl.handled();\n  }\n}\n\nexport type FlowType<Provide = FlowBase<any>> = Type<Provide>;\n"]}

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

@@ -1,4 +1,5 @@
 export * from './base.interface';
+export * from './execution-context.interface';
 export * from './front-mcp.interface';
 export * from './server.interface';
 export * from './scope.interface';

package/src/common/interfaces/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./base.interface"), exports);
+tslib_1.__exportStar(require("./execution-context.interface"), exports);
 tslib_1.__exportStar(require("./front-mcp.interface"), exports);
 tslib_1.__exportStar(require("./server.interface"), exports);
 tslib_1.__exportStar(require("./scope.interface"), exports);

package/src/common/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/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'"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,wEAA8C;AAC9C,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,qDAA2B","sourcesContent":["export * from './base.interface';\nexport * from './execution-context.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';\n"]}

package/src/common/interfaces/internal/primary-auth-provider.interface.d.ts

@@ -1,5 +1,5 @@
 import { ServerRequest } from '../server.interface';
-import { AuthOptions } from '../../types';
+import { AuthOptions, TransportConfig } from '../../types';
 /**
  * Base class for primary auth provider.
  * Used for easy access current auth context by dependency injection.
@@ -17,8 +17,23 @@ export declare abstract class FrontMcpAuth<Options extends AuthOptions = AuthOpt
     readonly options: Options;
     readonly id: string;
     constructor(options: Options);
+    /**
+     * Derive the provider ID from options.
+     * This logic MUST match deriveProviderId in auth-provider-detection.ts
+     * to ensure consistent provider IDs across the system.
+     */
+    private deriveId;
     abstract fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
     abstract validate(request: ServerRequest): Promise<void>;
     abstract get issuer(): string;
+    /**
+     * Default transport configuration when not specified
+     */
+    private static readonly DEFAULT_TRANSPORT;
+    /**
+     * Get transport configuration with all defaults applied.
+     * Returns default values when transport is not configured.
+     */
+    get transport(): TransportConfig;
 }
-export { FrontMcpAuth as Auth, };
+export { FrontMcpAuth as Auth };

package/src/common/interfaces/internal/primary-auth-provider.interface.js

@@ -1,7 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Auth = exports.FrontMcpAuth = void 0;
+const types_1 = require("../../types");
 const utils_1 = require("../../utils");
+/**
+ * Convert URL to a safe provider ID (hostname with dots replaced)
+ * Matches the logic in auth-provider-detection.ts for consistency
+ */
+function urlToProviderId(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.hostname.replace(/\./g, '_');
+    }
+    catch {
+        return url.replace(/[^a-zA-Z0-9]/g, '_');
+    }
+}
 /**
  * Base class for primary auth provider.
  * Used for easy access current auth context by dependency injection.
@@ -20,12 +34,46 @@ class FrontMcpAuth {
     id;
     constructor(options) {
         this.options = options;
-        if (options.type === 'local') {
-            this.id = options.id;
+        this.id = this.deriveId(options);
+    }
+    /**
+     * Derive the provider ID from options.
+     * This logic MUST match deriveProviderId in auth-provider-detection.ts
+     * to ensure consistent provider IDs across the system.
+     */
+    deriveId(options) {
+        if ((0, types_1.isPublicMode)(options)) {
+            return options.issuer ?? 'public';
         }
-        else {
-            this.id = options.id ?? (0, utils_1.urlToSafeId)(options.baseUrl);
+        if ((0, types_1.isTransparentMode)(options)) {
+            return options.remote.id ?? (0, utils_1.urlToSafeId)(options.remote.provider);
         }
+        if ((0, types_1.isOrchestratedMode)(options)) {
+            if ((0, types_1.isOrchestratedRemote)(options)) {
+                return options.remote.id ?? (0, utils_1.urlToSafeId)(options.remote.provider);
+            }
+            // Local orchestrated – match detection defaults
+            return options.local?.issuer ?? 'local';
+        }
+        return 'unknown';
+    }
+    /**
+     * Default transport configuration when not specified
+     */
+    static DEFAULT_TRANSPORT = {
+        enableLegacySSE: false,
+        enableSseListener: true,
+        enableStreamableHttp: true,
+        enableStatelessHttp: false,
+        enableStatefulHttp: false,
+        requireSessionForStreamable: true,
+    };
+    /**
+     * Get transport configuration with all defaults applied.
+     * Returns default values when transport is not configured.
+     */
+    get transport() {
+        return this.options.transport ?? FrontMcpAuth.DEFAULT_TRANSPORT;
     }
 }
 exports.FrontMcpAuth = FrontMcpAuth;

package/src/common/interfaces/internal/primary-auth-provider.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"primary-auth-provider.interface.js","sourceRoot":"","sources":["../../../../../src/common/interfaces/internal/primary-auth-provider.interface.ts"],"names":[],"mappings":";;;AAEA,uCAA0C;AAG1C;;;;;;;;;;;GAWG;AACH,MAAsB,YAAY;IAChC,KAAK,CAAgB;IACZ,OAAO,CAAU;IACjB,EAAE,CAAS;IAEpB,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAA,mBAAW,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;IAEH,CAAC;CAOF;AApBD,oCAoBC;AAGiB,4BAAI","sourcesContent":["import { ServerRequest } from '../server.interface';\nimport { AuthOptions } from '../../types';\nimport { urlToSafeId } from '../../utils';\n\n\n/**\n * Base class for primary auth provider.\n * Used for easy access current auth context by dependency injection.\n *\n * In tool context, you can access current auth context by calling:\n *  this.get(FrontMcpAuth) | this.get(Auth)\n *\n * Or in session scoped Providers in constructor arguments:\n *  constructor(private readonly auth: FrontMcpAuth) {\n *  // auth.fetch('MY endpoint ')\n *  }\n */\nexport abstract class FrontMcpAuth<Options extends AuthOptions = AuthOptions> {\n  ready: Promise<void>;\n  readonly options: Options;\n  readonly id: string;\n\n  constructor(options: Options) {\n    this.options = options;\n    if (options.type === 'local') {\n      this.id = options.id;\n    } else {\n      this.id = options.id ?? urlToSafeId(options.baseUrl);\n    }\n\n  }\n\n  abstract fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;\n\n  abstract validate(request: ServerRequest): Promise<void>\n\n  abstract get issuer(): string\n}\n\nexport {\n  FrontMcpAuth as Auth,\n};"]}
+{"version":3,"file":"primary-auth-provider.interface.js","sourceRoot":"","sources":["../../../../../src/common/interfaces/internal/primary-auth-provider.interface.ts"],"names":[],"mappings":";;;AACA,uCAOqB;AACrB,uCAA0C;AAE1C;;;GAGG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAsB,YAAY;IAChC,KAAK,CAAgB;IACZ,OAAO,CAAU;IACjB,EAAE,CAAS;IAEpB,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACK,QAAQ,CAAC,OAAoB;QACnC,IAAI,IAAA,oBAAY,EAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;QACpC,CAAC;QAED,IAAI,IAAA,yBAAiB,EAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAA,mBAAW,EAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,IAAA,0BAAkB,EAAC,OAAO,CAAC,EAAE,CAAC;YAChC,IAAI,IAAA,4BAAoB,EAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAA,mBAAW,EAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnE,CAAC;YACD,gDAAgD;YAChD,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,CAAC;QAC1C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAQD;;OAEG;IACK,MAAM,CAAU,iBAAiB,GAAoB;QAC3D,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,IAAI;QAC1B,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,KAAK;QACzB,2BAA2B,EAAE,IAAI;KAClC,CAAC;IAEF;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,YAAY,CAAC,iBAAiB,CAAC;IAClE,CAAC;;AA3DH,oCA4DC;AAEwB,4BAAI","sourcesContent":["import { ServerRequest } from '../server.interface';\nimport {\n  AuthOptions,\n  TransportConfig,\n  isPublicMode,\n  isTransparentMode,\n  isOrchestratedMode,\n  isOrchestratedRemote,\n} from '../../types';\nimport { urlToSafeId } from '../../utils';\n\n/**\n * Convert URL to a safe provider ID (hostname with dots replaced)\n * Matches the logic in auth-provider-detection.ts for consistency\n */\nfunction urlToProviderId(url: string): string {\n  try {\n    const parsed = new URL(url);\n    return parsed.hostname.replace(/\\./g, '_');\n  } catch {\n    return url.replace(/[^a-zA-Z0-9]/g, '_');\n  }\n}\n\n/**\n * Base class for primary auth provider.\n * Used for easy access current auth context by dependency injection.\n *\n * In tool context, you can access current auth context by calling:\n *  this.get(FrontMcpAuth) | this.get(Auth)\n *\n * Or in session scoped Providers in constructor arguments:\n *  constructor(private readonly auth: FrontMcpAuth) {\n *  // auth.fetch('MY endpoint ')\n *  }\n */\nexport abstract class FrontMcpAuth<Options extends AuthOptions = AuthOptions> {\n  ready: Promise<void>;\n  readonly options: Options;\n  readonly id: string;\n\n  constructor(options: Options) {\n    this.options = options;\n    this.id = this.deriveId(options);\n  }\n\n  /**\n   * Derive the provider ID from options.\n   * This logic MUST match deriveProviderId in auth-provider-detection.ts\n   * to ensure consistent provider IDs across the system.\n   */\n  private deriveId(options: AuthOptions): string {\n    if (isPublicMode(options)) {\n      return options.issuer ?? 'public';\n    }\n\n    if (isTransparentMode(options)) {\n      return options.remote.id ?? urlToSafeId(options.remote.provider);\n    }\n\n    if (isOrchestratedMode(options)) {\n      if (isOrchestratedRemote(options)) {\n        return options.remote.id ?? urlToSafeId(options.remote.provider);\n      }\n      // Local orchestrated – match detection defaults\n      return options.local?.issuer ?? 'local';\n    }\n\n    return 'unknown';\n  }\n\n  abstract fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;\n\n  abstract validate(request: ServerRequest): Promise<void>;\n\n  abstract get issuer(): string;\n\n  /**\n   * Default transport configuration when not specified\n   */\n  private static readonly DEFAULT_TRANSPORT: TransportConfig = {\n    enableLegacySSE: false,\n    enableSseListener: true,\n    enableStreamableHttp: true,\n    enableStatelessHttp: false,\n    enableStatefulHttp: false,\n    requireSessionForStreamable: true,\n  };\n\n  /**\n   * Get transport configuration with all defaults applied.\n   * Returns default values when transport is not configured.\n   */\n  get transport(): TransportConfig {\n    return this.options.transport ?? FrontMcpAuth.DEFAULT_TRANSPORT;\n  }\n}\n\nexport { FrontMcpAuth as Auth };\n"]}

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

@@ -4,6 +4,7 @@ import { FrontMcpAuth } from './primary-auth-provider.interface';
 import { FlowName } from '../../metadata';
 import { FlowCtxOf, FlowInputOf, FlowStagesOf } from '../flow.interface';
 import { HookRecord } from '../../records';
+import { ToolChangeEvent } from '../../../tool/tool.events';
 export interface ScopeRegistryInterface {
     getScopes(): ScopeEntry[];
 }
@@ -50,6 +51,7 @@ export interface ProviderViews {
 }
 export interface ProviderRegistryInterface {
     get<T>(token: Token<T>): T;
+    getScope(): ScopeEntry;
     getProviders(): ProviderEntry[];
     getRegistries<T extends RegistryKind>(type: T): RegistryType[T][];
     buildViews(session: any): Promise<ProviderViews>;
@@ -71,14 +73,26 @@ export interface ToolRegistryInterface {
     owner: EntryOwnerRef;
     getTools(includeHidden?: boolean): ToolEntry[];
     getInlineTools(): ToolEntry<any, any>[];
+    subscribe(opts: {
+        immediate?: boolean;
+        filter?: (i: ToolEntry) => boolean;
+    }, cb: (evt: ToolChangeEvent) => void): () => void;
 }
 export interface ResourceRegistryInterface {
-    getResources(): ResourceEntry<any, any>[];
+    owner: EntryOwnerRef;
+    getResources(includeHidden?: boolean): ResourceEntry<any, any>[];
+    getResourceTemplates(): ResourceEntry<any, any>[];
     getInlineResources(): ResourceEntry<any, any>[];
+    findResourceForUri(uri: string): {
+        instance: ResourceEntry<any, any>;
+        params: Record<string, string>;
+    } | undefined;
 }
 export interface PromptRegistryInterface {
-    getPrompts(): PromptEntry[];
+    owner: EntryOwnerRef;
+    getPrompts(includeHidden?: boolean): PromptEntry[];
     getInlinePrompts(): PromptEntry[];
+    findByName(name: string): PromptEntry | undefined;
 }
 export interface LoggerRegistryInterface {
     getLoggers(): LoggerEntry[];

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>(\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"]}
+{"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';\nimport { ToolChangeEvent } from '../../../tool/tool.events';\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  getScope(): ScopeEntry;\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  // subscribe to tool change events\n  subscribe(\n    opts: { immediate?: boolean; filter?: (i: ToolEntry) => boolean },\n    cb: (evt: ToolChangeEvent) => void,\n  ): () => void;\n}\n\nexport interface ResourceRegistryInterface {\n  // owner of this registry\n  owner: EntryOwnerRef;\n\n  // inline resources plus discovered by nested resource registries\n  getResources(includeHidden?: boolean): ResourceEntry<any, any>[];\n\n  // resource templates\n  getResourceTemplates(): ResourceEntry<any, any>[];\n\n  // inline resources only\n  getInlineResources(): ResourceEntry<any, any>[];\n\n  // find a resource by URI (exact match first, then template matching)\n  findResourceForUri(uri: string): { instance: ResourceEntry<any, any>; params: Record<string, string> } | undefined;\n}\n\nexport interface PromptRegistryInterface {\n  // owner reference for the registry\n  owner: EntryOwnerRef;\n\n  // inline prompts plus discovered by nested prompt registries\n  getPrompts(includeHidden?: boolean): PromptEntry[];\n\n  // inline prompts only\n  getInlinePrompts(): PromptEntry[];\n\n  // find a prompt by name\n  findByName(name: string): PromptEntry | undefined;\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.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, readonly 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\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\nexport type PluginType<Provide extends PluginInterface = PluginInterface> =\n  | Type<Provide>\n  | PluginClassType<Provide>\n  | PluginValueType<Provide>\n  | PluginFactoryType<Provide, readonly any[]>;\n"]}

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

@@ -1,5 +1,54 @@
-import { FuncType, Type } from './base.interface';
-interface PromptInterface {
+import { PromptMetadata } from '../metadata';
+import { FuncType, Token, Type } from './base.interface';
+import { ProviderRegistryInterface } from './internal';
+import { FrontMcpLogger } from './logger.interface';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { ScopeEntry } from '../entries';
+import { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+export interface PromptInterface {
+    execute(args: Record<string, string>): Promise<GetPromptResult>;
 }
-type PromptType = Type<PromptInterface> | FuncType<PromptInterface>;
-export { PromptInterface, PromptInterface as FrontMcpPromptInterface, PromptType, PromptType as FrontMcpPromptType, };
+export type PromptType = Type<PromptInterface> | FuncType<PromptInterface>;
+type HistoryEntry<T> = {
+    at: number;
+    stage?: string;
+    value: T | undefined;
+    note?: string;
+};
+export type PromptCtorArgs = {
+    metadata: PromptMetadata;
+    args: Record<string, string>;
+    providers: ProviderRegistryInterface;
+    logger: FrontMcpLogger;
+    authInfo: AuthInfo;
+};
+export declare abstract class PromptContext {
+    private providers;
+    readonly authInfo: AuthInfo;
+    protected readonly runId: string;
+    protected readonly promptId: string;
+    protected readonly promptName: string;
+    readonly metadata: PromptMetadata;
+    protected readonly logger: FrontMcpLogger;
+    /** The arguments passed to the prompt */
+    readonly args: Record<string, string>;
+    protected activeStage: string;
+    private _output?;
+    private _error?;
+    private readonly _outputHistory;
+    constructor(ctorArgs: PromptCtorArgs);
+    abstract execute(args: Record<string, string>): Promise<GetPromptResult>;
+    get<T>(token: Token<T>): T;
+    get scope(): ScopeEntry;
+    tryGet<T>(token: Token<T>): T | undefined;
+    get output(): GetPromptResult | undefined;
+    set output(v: GetPromptResult | undefined);
+    get outputHistory(): ReadonlyArray<HistoryEntry<GetPromptResult>>;
+    respond(value: GetPromptResult): never;
+    /** Get the error that caused the prompt to fail, if any. */
+    get error(): Error | undefined;
+    /** Fail the run (invoker will run error/finalize). */
+    protected fail(err: Error): never;
+    mark(stage: string): void;
+}
+export {};

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

@@ -1,3 +1,81 @@
 "use strict";
+// file: libs/sdk/src/common/interfaces/prompt.interface.ts
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptContext = void 0;
+const crypto_1 = require("crypto");
+const flow_interface_1 = require("./flow.interface");
+class PromptContext {
+    providers;
+    authInfo;
+    runId;
+    promptId;
+    promptName;
+    metadata;
+    logger;
+    /** The arguments passed to the prompt */
+    args;
+    activeStage = 'init';
+    // ---- OUTPUT storages (backing fields)
+    _output;
+    _error;
+    // ---- histories
+    _outputHistory = [];
+    constructor(ctorArgs) {
+        const { metadata, args, providers, logger, authInfo } = ctorArgs;
+        this.runId = (0, crypto_1.randomUUID)();
+        this.promptName = metadata.name;
+        // promptId uses the metadata name as the stable identifier for the prompt type
+        // (runId is the unique instance identifier for this specific execution)
+        this.promptId = metadata.name;
+        this.metadata = metadata;
+        this.args = args;
+        this.providers = providers;
+        this.logger = logger.child(`prompt:${this.promptId}`);
+        this.authInfo = authInfo;
+    }
+    get(token) {
+        return this.providers.get(token);
+    }
+    get scope() {
+        return this.providers.getScope();
+    }
+    tryGet(token) {
+        try {
+            return this.providers.get(token);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);
+            return undefined;
+        }
+    }
+    get output() {
+        return this._output;
+    }
+    set output(v) {
+        this._output = v;
+        this._outputHistory.push({ at: Date.now(), stage: this.activeStage, value: v });
+    }
+    get outputHistory() {
+        return this._outputHistory;
+    }
+    respond(value) {
+        // record validated output and surface the value via control flow
+        this.output = value;
+        flow_interface_1.FlowControl.respond(value);
+    }
+    /** Get the error that caused the prompt to fail, if any. */
+    get error() {
+        return this._error;
+    }
+    /** Fail the run (invoker will run error/finalize). */
+    fail(err) {
+        this._error = err;
+        flow_interface_1.FlowControl.fail(err);
+    }
+    mark(stage) {
+        this.activeStage = stage;
+    }
+}
+exports.PromptContext = PromptContext;
 //# sourceMappingURL=prompt.interface.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/prompt.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { FuncType, Type } from './base.interface';\n\n\ninterface PromptInterface {\n\n}\n\ntype PromptType =\n  | Type<PromptInterface>\n  | FuncType<PromptInterface>;\n\n\nexport {\n  PromptInterface,\n  PromptInterface as FrontMcpPromptInterface,\n  PromptType,\n  PromptType as FrontMcpPromptType,\n};\n\n"]}
+{"version":3,"file":"prompt.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/prompt.interface.ts"],"names":[],"mappings":";AAAA,2DAA2D;;;AAE3D,mCAAoC;AAKpC,qDAA+C;AA0B/C,MAAsB,aAAa;IACzB,SAAS,CAA4B;IACpC,QAAQ,CAAW;IAET,KAAK,CAAS;IACd,QAAQ,CAAS;IACjB,UAAU,CAAS;IAC7B,QAAQ,CAAiB;IACf,MAAM,CAAiB;IAE1C,yCAAyC;IAChC,IAAI,CAAyB;IAE5B,WAAW,GAAG,MAAM,CAAC;IAE/B,wCAAwC;IAChC,OAAO,CAAmB;IAE1B,MAAM,CAAS;IAEvB,iBAAiB;IACA,cAAc,GAAoC,EAAE,CAAC;IAEtE,YAAY,QAAwB;QAClC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;QACjE,IAAI,CAAC,KAAK,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;QAChC,+EAA+E;QAC/E,wEAAwE;QACxE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAID,GAAG,CAAI,KAAe;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,CAAI,KAAe;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,MAAM,CAAC,CAA8B;QAC9C,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,KAAsB;QAC5B,iEAAiE;QACjE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,4BAAW,CAAC,OAAO,CAAkB,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,4DAA4D;IAC5D,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,sDAAsD;IAC5C,IAAI,CAAC,GAAU;QACvB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,4BAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF;AA1FD,sCA0FC","sourcesContent":["// file: libs/sdk/src/common/interfaces/prompt.interface.ts\n\nimport { randomUUID } from 'crypto';\nimport { PromptMetadata } from '../metadata';\nimport { FuncType, Token, Type } from './base.interface';\nimport { ProviderRegistryInterface } from './internal';\nimport { FrontMcpLogger } from './logger.interface';\nimport { FlowControl } from './flow.interface';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { ScopeEntry } from '../entries';\nimport { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';\n\nexport interface PromptInterface {\n  execute(args: Record<string, string>): Promise<GetPromptResult>;\n}\n\nexport type PromptType = Type<PromptInterface> | FuncType<PromptInterface>;\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type PromptCtorArgs = {\n  metadata: PromptMetadata;\n  args: Record<string, string>;\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: AuthInfo;\n};\n\nexport abstract class PromptContext {\n  private providers: ProviderRegistryInterface;\n  readonly authInfo: AuthInfo;\n\n  protected readonly runId: string;\n  protected readonly promptId: string;\n  protected readonly promptName: string;\n  readonly metadata: PromptMetadata;\n  protected readonly logger: FrontMcpLogger;\n\n  /** The arguments passed to the prompt */\n  readonly args: Record<string, string>;\n\n  protected activeStage = 'init';\n\n  // ---- OUTPUT storages (backing fields)\n  private _output?: GetPromptResult;\n\n  private _error?: Error;\n\n  // ---- histories\n  private readonly _outputHistory: HistoryEntry<GetPromptResult>[] = [];\n\n  constructor(ctorArgs: PromptCtorArgs) {\n    const { metadata, args, providers, logger, authInfo } = ctorArgs;\n    this.runId = randomUUID();\n    this.promptName = metadata.name;\n    // promptId uses the metadata name as the stable identifier for the prompt type\n    // (runId is the unique instance identifier for this specific execution)\n    this.promptId = metadata.name;\n    this.metadata = metadata;\n    this.args = args;\n    this.providers = providers;\n    this.logger = logger.child(`prompt:${this.promptId}`);\n    this.authInfo = authInfo;\n  }\n\n  abstract execute(args: Record<string, string>): Promise<GetPromptResult>;\n\n  get<T>(token: Token<T>): T {\n    return this.providers.get(token);\n  }\n\n  get scope(): ScopeEntry {\n    return this.providers.getScope();\n  }\n\n  tryGet<T>(token: Token<T>): T | undefined {\n    try {\n      return this.providers.get(token);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : String(e);\n      this.logger.warn(`Failed to get provider ${String(token)}: ${msg}`);\n      return undefined;\n    }\n  }\n\n  public get output(): GetPromptResult | undefined {\n    return this._output;\n  }\n\n  public set output(v: GetPromptResult | 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<GetPromptResult>> {\n    return this._outputHistory;\n  }\n\n  respond(value: GetPromptResult): never {\n    // record validated output and surface the value via control flow\n    this.output = value;\n    FlowControl.respond<GetPromptResult>(value);\n  }\n\n  /** Get the error that caused the prompt to fail, if any. */\n  public get error(): Error | undefined {\n    return this._error;\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"]}