@frontmcp/sdk 0.6.0 → 0.6.2

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

@@ -1 +0,0 @@
-{"version":3,"file":"execution-context.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/execution-context.interface.ts"],"names":[],"mappings":"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","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';\nimport { FrontMcpContext, FRONTMCP_CONTEXT } from '../../context';\nimport { RequestContextNotAvailableError } from '../../errors/mcp.error';\n\n/**\n * Base constructor arguments for all execution contexts.\n */\nexport type ExecutionContextBaseArgs = {\n  providers: ProviderRegistryInterface;\n  logger: FrontMcpLogger;\n  authInfo: Partial<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\n  /**\n   * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.\n   */\n  private readonly _authInfo: Partial<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 the current FrontMcpContext.\n   *\n   * Provides access to requestId, traceId, sessionId, authInfo,\n   * timing marks, request metadata, transport, and context-aware fetch.\n   *\n   * @throws RequestContextNotAvailableError if called outside of a context scope\n   */\n  get context(): FrontMcpContext {\n    try {\n      return this.providers.get(FRONTMCP_CONTEXT as Token<FrontMcpContext>);\n    } catch {\n      // Context not available (likely called during initialization or outside request scope)\n      throw new RequestContextNotAvailableError();\n    }\n  }\n\n  /**\n   * Try to get the context, returning undefined if not available.\n   *\n   * Use this when context may not be available (e.g., during initialization).\n   */\n  tryGetContext(): FrontMcpContext | undefined {\n    try {\n      return this.providers.get(FRONTMCP_CONTEXT as Token<FrontMcpContext>);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * @deprecated Use `context.authInfo` instead. Will be removed in v2.0.\n   *\n   * Get authentication information for the current request.\n   */\n  get authInfo(): Partial<AuthInfo> {\n    return this._authInfo;\n  }\n\n  /**\n   * Get authentication information for the current request.\n   *\n   * Prefers context.authInfo when available (the recommended source),\n   * falls back to the legacy authInfo property for backward compatibility.\n   *\n   * Returns Partial<AuthInfo> because auth info is progressively populated\n   * during the request lifecycle. Callers should check for required fields.\n   */\n  getAuthInfo(): Partial<AuthInfo> {\n    const ctx = this.tryGetContext();\n    if (ctx) {\n      return ctx.authInfo;\n    }\n    return this._authInfo;\n  }\n\n  /**\n   * Get a child logger with request context attached.\n   *\n   * The logger includes requestId, traceId, and sessionId in its context.\n   */\n  protected get contextLogger(): FrontMcpLogger {\n    try {\n      return this.context.getLogger(this.logger);\n    } catch {\n      // Fallback if context not available\n      return this.logger;\n    }\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 with context-aware header injection.\n   *\n   * When FrontMcpContext is available, delegates to ctx.fetch() which:\n   * - Auto-injects Authorization header (if authInfo.token is available)\n   * - Auto-injects W3C traceparent header for distributed tracing\n   * - Auto-injects x-request-id header\n   * - Auto-injects custom headers from request metadata\n   *\n   * Falls back to standard fetch if context is not available.\n   */\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    const ctx = this.tryGetContext();\n    if (ctx) {\n      return ctx.fetch(input, init);\n    }\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.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowBase = exports.FlowControl = void 0;
-const flow_utils_1 = require("./internal/flow.utils");
-const frontmcp_context_storage_1 = require("../../context/frontmcp-context-storage");
-class FlowControl extends Error {
-    type;
-    output;
-    constructor(type, output) {
-        super();
-        this.type = type;
-        this.output = output;
-    }
-    static respond(output) {
-        throw new FlowControl('respond', output);
-    }
-    static next() {
-        throw new FlowControl('next', null);
-    }
-    static handled() {
-        throw new FlowControl('handled', null);
-    }
-    static fail(error) {
-        throw new FlowControl('fail', { error: error.message });
-    }
-    static abort(reason) {
-        throw new FlowControl('abort', reason);
-    }
-}
-exports.FlowControl = FlowControl;
-// 1) The actual abstract class (value)
-class FlowBase {
-    metadata;
-    rawInput;
-    scope;
-    appendContextHooks;
-    deps;
-    input;
-    state = flow_utils_1.FlowState.create({});
-    scopeLogger;
-    constructor(metadata, rawInput, scope, appendContextHooks, deps = new Map()) {
-        this.metadata = metadata;
-        this.rawInput = rawInput;
-        this.scope = scope;
-        this.appendContextHooks = appendContextHooks;
-        this.deps = deps;
-        this.input = metadata.inputSchema?.parse?.(rawInput);
-        this.scopeLogger = scope.logger;
-    }
-    get(token) {
-        if (this.deps.has(token))
-            return this.deps.get(token);
-        return this.scope.providers.get(token);
-    }
-    respond(output) {
-        throw FlowControl.respond(this.metadata.outputSchema.parse(output));
-    }
-    fail(error) {
-        throw FlowControl.fail(error);
-    }
-    abort(message) {
-        throw FlowControl.abort(message);
-    }
-    next() {
-        throw FlowControl.next();
-    }
-    handled() {
-        throw FlowControl.handled();
-    }
-    /**
-     * Get the current FrontMcpContext from AsyncLocalStorage.
-     * Available in all stages after context initialization.
-     *
-     * @throws Error if not in a context scope
-     */
-    get context() {
-        const storage = this.scope.providers.get(frontmcp_context_storage_1.FrontMcpContextStorage);
-        return storage.getStoreOrThrow();
-    }
-    /**
-     * Safely try to get FrontMcpContext (returns undefined if not available).
-     * Use this when context might not be available (e.g., non-HTTP flows).
-     */
-    tryGetContext() {
-        try {
-            const storage = this.scope.providers.get(frontmcp_context_storage_1.FrontMcpContextStorage);
-            return storage.getStore();
-        }
-        catch {
-            return undefined;
-        }
-    }
-}
-exports.FlowBase = FlowBase;
-//# sourceMappingURL=flow.interface.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/flow.interface.ts"],"names":[],"mappings":"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","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';\nimport type { FrontMcpContext } from '../../context/frontmcp-context';\nimport { FrontMcpContextStorage } from '../../context/frontmcp-context-storage';\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  /**\n   * Get the current FrontMcpContext from AsyncLocalStorage.\n   * Available in all stages after context initialization.\n   *\n   * @throws Error if not in a context scope\n   */\n  protected get context(): FrontMcpContext {\n    const storage = this.scope.providers.get(FrontMcpContextStorage);\n    return storage.getStoreOrThrow();\n  }\n\n  /**\n   * Safely try to get FrontMcpContext (returns undefined if not available).\n   * Use this when context might not be available (e.g., non-HTTP flows).\n   */\n  protected tryGetContext(): FrontMcpContext | undefined {\n    try {\n      const storage = this.scope.providers.get(FrontMcpContextStorage);\n      return storage.getStore();\n    } catch {\n      return undefined;\n    }\n  }\n}\n\nexport type FlowType<Provide = FlowBase<any>> = Type<Provide>;\n"]}

package/src/common/interfaces/front-mcp.interface.js

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

package/src/common/interfaces/front-mcp.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/front-mcp.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { FrontMcpConfigType } from '../metadata';\n\n\nexport interface FrontMcpInterface {\n  readonly config: FrontMcpConfigType;\n  readonly ready: Promise<void>;\n\n}"]}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"hook.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/hook.interface.ts"],"names":[],"mappings":"","sourcesContent":["import {Type} from './base.interface';\n\nexport type HookBase<In, Ctx> = (input: In, ctx?: Ctx) => Promise<void>;\n\nexport type HookType = Type<HookBase<any, any>>\n\n"]}

package/src/common/interfaces/index.js

@@ -1,21 +0,0 @@
-"use strict";
-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);
-tslib_1.__exportStar(require("./flow.interface"), exports);
-tslib_1.__exportStar(require("./hook.interface"), exports);
-tslib_1.__exportStar(require("./app.interface"), exports);
-tslib_1.__exportStar(require("./provider.interface"), exports);
-tslib_1.__exportStar(require("./auth-provider.interface"), exports);
-tslib_1.__exportStar(require("./adapter.interface"), exports);
-tslib_1.__exportStar(require("./plugin.interface"), exports);
-tslib_1.__exportStar(require("./tool.interface"), exports);
-tslib_1.__exportStar(require("./resource.interface"), exports);
-tslib_1.__exportStar(require("./prompt.interface"), exports);
-tslib_1.__exportStar(require("./logger.interface"), exports);
-tslib_1.__exportStar(require("./internal"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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/flow.utils.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowState = void 0;
-class FlowState {
-    constructor() {
-        /* empty */
-    }
-    static create(initial) {
-        const data = initial ? { ...initial } : {};
-        const api = {
-            get(key) {
-                return data[key];
-            },
-            getOrThrow(key, message) {
-                const val = data[key];
-                if (val === undefined || val === null) {
-                    throw new Error(message ?? `InvokeState: missing required key "${String(key)}"`);
-                }
-                return val;
-            },
-            set(...args) {
-                if (args.length === 1)
-                    Object.assign(data, args[0]);
-                else {
-                    const [k, v] = args;
-                    data[k] = v;
-                }
-                return proxy;
-            },
-            snapshot() {
-                return { ...data };
-            },
-        };
-        const requiredProxy = new Proxy({}, {
-            get(_t, prop) {
-                const val = data[prop];
-                if (val === undefined || val === null) {
-                    throw new Error(`InvokeState: missing required key "${String(prop)}"`);
-                }
-                return val;
-            },
-            has(_t, prop) {
-                const val = data[prop];
-                return val !== undefined && val !== null;
-            },
-            ownKeys() {
-                return Reflect.ownKeys(data);
-            },
-            getOwnPropertyDescriptor() {
-                return { enumerable: true, configurable: true };
-            },
-        });
-        const methodKeys = new Set(['get', 'getOrThrow', 'set', 'snapshot']);
-        const proxy = new Proxy(api, {
-            get(_t, prop, receiver) {
-                if (prop === 'required')
-                    return requiredProxy;
-                if (methodKeys.has(prop))
-                    return Reflect.get(api, prop, receiver);
-                return data[prop];
-            },
-            set(_t, prop, value) {
-                data[prop] = value;
-                return true;
-            },
-            has(_t, prop) {
-                return prop === 'required' || methodKeys.has(prop) || prop in data;
-            },
-            ownKeys() {
-                return [...Reflect.ownKeys(data), 'required', ...methodKeys];
-            },
-            getOwnPropertyDescriptor(_t, prop) {
-                if (prop === 'required' || methodKeys.has(prop)) {
-                    return { enumerable: false, configurable: true };
-                }
-                return { enumerable: true, configurable: true };
-            },
-        });
-        return proxy;
-    }
-}
-exports.FlowState = FlowState;
-//# sourceMappingURL=flow.utils.js.map

package/src/common/interfaces/internal/flow.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow.utils.js","sourceRoot":"","sources":["../../../../../src/common/interfaces/internal/flow.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {z} from 'zod';\nimport {FlowName} from '../../metadata';\n\ntype RequiredView<T> = { [K in keyof T]-?: Exclude<T[K], undefined> };\ntype StateAccess<T> = { [K in keyof T]: T[K] | undefined } & { required: RequiredView<T> };\n\ntype StateType<Name extends FlowName> = z.infer<ExtendFlows[Name]['state']>\n\nexport type FlowStateOf<Name extends FlowName, T = StateType<Name>> = StateAccess<T> & {\n  get<K extends keyof T>(key: K): T[K] | undefined;\n  getOrThrow<K extends keyof T>(key: K, message?: string): Exclude<T[K], undefined>;\n  set<K extends keyof T>(key: K, value: T[K]): FlowStateOf<Name, T>;\n  set(patch: Partial<T>): FlowStateOf<Name, T>;\n  snapshot(): Readonly<Partial<T>>;\n};\n\nexport class FlowState {\n  private constructor() {\n    /* empty */\n  }\n\n  static create<Name extends FlowName, T = StateType<Name>>(initial?: Partial<T>): FlowStateOf<Name> {\n    const data: Partial<T> = initial ? {...initial} : {};\n\n    const api = {\n      get<K extends keyof T>(key: K) {\n        return data[key] as T[K] | undefined;\n      },\n      getOrThrow<K extends keyof T>(key: K, message?: string) {\n        const val = data[key];\n        if (val === undefined || val === null) {\n          throw new Error(message ?? `InvokeState: missing required key \"${String(key)}\"`);\n        }\n        return val as Exclude<T[K], undefined>;\n      },\n      set<K extends keyof T>(...args: [K, T[K]] | [Partial<T>]) {\n        if (args.length === 1) Object.assign(data, args[0]);\n        else {\n          const [k, v] = args as [K, T[K]];\n          (data as any)[k] = v;\n        }\n        return proxy as FlowStateOf<Name>;\n      },\n      snapshot() {\n        return {...data} as Readonly<Partial<T>>;\n      },\n    };\n\n    const requiredProxy = new Proxy({} as RequiredView<T>, {\n      get(_t, prop: PropertyKey) {\n        const val = (data as any)[prop];\n        if (val === undefined || val === null) {\n          throw new Error(`InvokeState: missing required key \"${String(prop)}\"`);\n        }\n        return val;\n      },\n      has(_t, prop) {\n        const val = (data as any)[prop];\n        return val !== undefined && val !== null;\n      },\n      ownKeys() {\n        return Reflect.ownKeys(data as object);\n      },\n      getOwnPropertyDescriptor() {\n        return {enumerable: true, configurable: true};\n      },\n    });\n\n    const methodKeys = new Set<PropertyKey>(['get', 'getOrThrow', 'set', 'snapshot']);\n\n    const proxy = new Proxy(api as any, {\n      get(_t, prop: PropertyKey, receiver) {\n        if (prop === 'required') return requiredProxy;\n        if (methodKeys.has(prop)) return Reflect.get(api as any, prop, receiver);\n        return (data as any)[prop];\n      },\n      set(_t, prop: PropertyKey, value) {\n        (data as any)[prop] = value;\n        return true;\n      },\n      has(_t, prop) {\n        return prop === 'required' || methodKeys.has(prop) || prop in (data as object);\n      },\n      ownKeys() {\n        return [...Reflect.ownKeys(data as object), 'required', ...methodKeys] as ArrayLike<string | symbol>;\n      },\n      getOwnPropertyDescriptor(_t, prop) {\n        if (prop === 'required' || methodKeys.has(prop)) {\n          return {enumerable: false, configurable: true};\n        }\n        return {enumerable: true, configurable: true};\n      },\n    });\n\n    return proxy as FlowStateOf<Name>;\n  }\n}\n"]}

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

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-// core interfaces
-tslib_1.__exportStar(require("./primary-auth-provider.interface"), exports);
-tslib_1.__exportStar(require("./registry.interface"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/common/interfaces/internal/index.ts"],"names":[],"mappings":";;;AAAA,kBAAkB;AAClB,4EAAkD;AAClD,+DAAqC","sourcesContent":["// core interfaces\nexport * from './primary-auth-provider.interface';\nexport * from './registry.interface';\n"]}

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

@@ -1,81 +0,0 @@
-"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.
- *
- * In tool context, you can access current auth context by calling:
- *  this.get(FrontMcpAuth) | this.get(Auth)
- *
- * Or in session scoped Providers in constructor arguments:
- *  constructor(private readonly auth: FrontMcpAuth) {
- *  // auth.fetch('MY endpoint ')
- *  }
- */
-class FrontMcpAuth {
-    ready;
-    options;
-    id;
-    constructor(options) {
-        this.options = options;
-        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';
-        }
-        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;
-exports.Auth = FrontMcpAuth;
-//# sourceMappingURL=primary-auth-provider.interface.js.map

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

@@ -1 +0,0 @@
-{"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.js

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

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

@@ -1 +0,0 @@
-{"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/logger.interface.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpLogger = exports.LogTransportInterface = void 0;
-class LogTransportInterface {
-}
-exports.LogTransportInterface = LogTransportInterface;
-class FrontMcpLogger {
-}
-exports.FrontMcpLogger = FrontMcpLogger;
-//# sourceMappingURL=logger.interface.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/logger.interface.ts"],"names":[],"mappings":";;;AAeA,MAAsB,qBAAqB;CAE1C;AAFD,sDAEC;AAOD,MAAsB,cAAc;CAgCnC;AAhCD,wCAgCC","sourcesContent":["import { Type } from './base.interface';\nimport { LogLevel } from '../types';\n\n\nexport interface LogRecord {\n  level: LogLevel;\n  levelName: string;\n  message: string;\n  args: unknown[];\n  timestamp: Date;\n  prefix: string;\n}\n\nexport type LogFn = (msg?: any, ...args: any[]) => void;\n\nexport abstract class LogTransportInterface {\n  abstract log(rec: LogRecord): void\n}\n\n\nexport type LogTransportType<T = any> =\n  | Type<T>\n\n\nexport abstract class FrontMcpLogger {\n  abstract child(prefix: string): FrontMcpLogger;\n\n  /**\n   * Verbose — extremely granular, high-volume logs useful when diagnosing tricky bugs\n   * (function entry/exit, detailed branches, low-level I/O). Disable in most environments.\n   */\n  abstract get verbose(): ((...args: any[]) => void);\n\n  /**\n   * Debug — development-focused diagnostics (state changes, computed values, API request params),\n   * still fairly verbose but less noisy than TRACE. Typically disabled in production.\n   */\n  abstract get debug(): ((...args: any[]) => void);\n\n  /**\n   * Info — key milestones in normal operation (server start, feature toggles, user actions,\n   * successful requests). Safe to keep enabled in production.\n   */\n  abstract get info(): ((...args: any[]) => void);\n\n  /**\n   * Warn — unexpected or suboptimal situations that the system handled and continued\n   * (fallbacks, retries, partial failures). Worth investigating but not service-breaking.\n   */\n  abstract get warn(): ((...args: any[]) => void);\n\n  /**\n   * Error — failures where an operation could not complete or data is invalid,\n   */\n  abstract get error(): ((...args: any[]) => void);\n\n}\n"]}

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

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

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

@@ -1 +0,0 @@
-{"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.js

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

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

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncProvider = AsyncProvider;
-/**
- * Helper to define factory providers without tuple widening.
- * Enforces that `useFactory` params follow the `inject()` tokens (order + arity).
- *
- * Usage:
- *   const p = AsyncMcpProvider({
- *     provide: RedisProviderRef,
- *     inject: () => [ExpenseConfigRef, RedisType] as const,
- *     useFactory: async (config, redis) => new RedisProvider(redis),
- *   });
- */
-function AsyncProvider(cfg) {
-    return cfg;
-}
-//# sourceMappingURL=provider.interface.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"provider.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/provider.interface.ts"],"names":[],"mappings":";;AAgCA,sCAIC;AAfD;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAC3B,GAAyC;IAEzC,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import { Type, Token, ValueType, ClassType, FactoryType, ClassToken } from './base.interface';\nimport { ProviderMetadata } from '../metadata';\n\nexport interface ProviderInterface {\n}\n\nexport type ProviderClassType<Provide> = ClassType<Provide> & ProviderMetadata;\nexport type ProviderValueType<Provide> = ValueType<Provide> & ProviderMetadata;\nexport type ProviderFactoryType<Provide, Tokens extends readonly (ClassToken | Token)[]> = FactoryType<Provide, Tokens> & ProviderMetadata;\n\n\nexport type ProviderType<\n  Provide extends ProviderInterface = any,\n  Tokens extends readonly (ClassToken | Token)[] = readonly (ClassToken | Token)[]\n> =\n  | Type<Provide>\n  | ProviderClassType<Provide>\n  | ProviderValueType<Provide>\n  | ProviderFactoryType<Provide, Tokens>\n\n\n/**\n * Helper to define factory providers without tuple widening.\n * Enforces that `useFactory` params follow the `inject()` tokens (order + arity).\n *\n * Usage:\n *   const p = AsyncMcpProvider({\n *     provide: RedisProviderRef,\n *     inject: () => [ExpenseConfigRef, RedisType] as const,\n *     useFactory: async (config, redis) => new RedisProvider(redis),\n *   });\n */\nexport function AsyncProvider<Provide, const Tokens extends readonly (ClassToken | Token)[]>(\n  cfg: ProviderFactoryType<Provide, Tokens>,\n): ProviderFactoryType<Provide, Tokens> {\n  return cfg;\n}\n"]}

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

@@ -1,56 +0,0 @@
-"use strict";
-// file: libs/sdk/src/common/interfaces/resource.interface.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceContext = void 0;
-const flow_interface_1 = require("./flow.interface");
-const execution_context_interface_1 = require("./execution-context.interface");
-/**
- * Abstract base class for resource execution contexts.
- * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)
- * @template Out - Type for the resource output
- */
-class ResourceContext extends execution_context_interface_1.ExecutionContextBase {
-    resourceId;
-    resourceName;
-    metadata;
-    /** The actual URI being read */
-    uri;
-    /** Extracted URI template parameters (empty for static resources) */
-    params;
-    // ---- OUTPUT storages (backing fields)
-    _output;
-    // ---- histories
-    _outputHistory = [];
-    constructor(args) {
-        const { metadata, uri, params, providers, logger } = args;
-        super({
-            providers,
-            logger: logger.child(`resource:${metadata.name}`),
-            authInfo: args.authInfo,
-        });
-        this.resourceName = metadata.name;
-        // resourceId uses the metadata name as the stable identifier for the resource type
-        // (runId is the unique instance identifier for this specific execution)
-        this.resourceId = metadata.name;
-        this.metadata = metadata;
-        this.uri = uri;
-        this.params = params;
-    }
-    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);
-    }
-}
-exports.ResourceContext = ResourceContext;
-//# sourceMappingURL=resource.interface.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resource.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/resource.interface.ts"],"names":[],"mappings":";AAAA,6DAA6D;;;AAM7D,qDAA+C;AAE/C,+EAA+F;AAkC/F;;;;GAIG;AACH,MAAsB,eAGpB,SAAQ,kDAAyB;IACd,UAAU,CAAS;IACnB,YAAY,CAAS;IAC/B,QAAQ,CAA8C;IAE/D,gCAAgC;IACvB,GAAG,CAAS;IACrB,qEAAqE;IAC5D,MAAM,CAAS;IAExB,wCAAwC;IAChC,OAAO,CAAO;IAEtB,iBAAiB;IACA,cAAc,GAAwB,EAAE,CAAC;IAE1D,YAAY,IAA8B;QACxC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC1D,KAAK,CAAC;YACJ,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjD,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;QAClC,mFAAmF;QACnF,wEAAwE;QACxE,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAID,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,MAAM,CAAC,CAAkB;QAClC,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,KAAU;QAChB,iEAAiE;QACjE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,4BAAW,CAAC,OAAO,CAAM,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAvDD,0CAuDC","sourcesContent":["// file: libs/sdk/src/common/interfaces/resource.interface.ts\n\nimport { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';\nimport { FuncType, 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 { ExecutionContextBase, ExecutionContextBaseArgs } from './execution-context.interface';\n\n/**\n * Base interface for resource implementations.\n * @template Params - Type for URI template parameters (defaults to generic string record)\n * @template Out - Type for the resource output\n */\nexport interface ResourceInterface<Params extends Record<string, string> = Record<string, string>, Out = unknown> {\n  execute(uri: string, params: Params): Promise<Out>;\n}\n\n/**\n * Type for resource class or function.\n * @template Params - Type for URI template parameters\n * @template Out - Type for the resource output\n */\nexport type ResourceType<Params extends Record<string, string> = Record<string, string>, Out = unknown> =\n  | Type<ResourceInterface<Params, Out>>\n  | FuncType<ResourceInterface<Params, Out>>;\n\ntype HistoryEntry<T> = {\n  at: number;\n  stage?: string;\n  value: T | undefined;\n  note?: string;\n};\n\nexport type ResourceCtorArgs<Params extends Record<string, string> = Record<string, string>> =\n  ExecutionContextBaseArgs & {\n    metadata: ResourceMetadata | ResourceTemplateMetadata;\n    uri: string;\n    params: Params;\n  };\n\n/**\n * Abstract base class for resource execution contexts.\n * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)\n * @template Out - Type for the resource output\n */\nexport abstract class ResourceContext<\n  Params extends Record<string, string> = Record<string, string>,\n  Out = unknown,\n> extends ExecutionContextBase<Out> {\n  protected readonly resourceId: string;\n  protected readonly resourceName: string;\n  readonly metadata: ResourceMetadata | ResourceTemplateMetadata;\n\n  /** The actual URI being read */\n  readonly uri: string;\n  /** Extracted URI template parameters (empty for static resources) */\n  readonly params: Params;\n\n  // ---- OUTPUT storages (backing fields)\n  private _output?: Out;\n\n  // ---- histories\n  private readonly _outputHistory: HistoryEntry<Out>[] = [];\n\n  constructor(args: ResourceCtorArgs<Params>) {\n    const { metadata, uri, params, providers, logger } = args;\n    super({\n      providers,\n      logger: logger.child(`resource:${metadata.name}`),\n      authInfo: args.authInfo,\n    });\n    this.resourceName = metadata.name;\n    // resourceId uses the metadata name as the stable identifier for the resource type\n    // (runId is the unique instance identifier for this specific execution)\n    this.resourceId = metadata.name;\n    this.metadata = metadata;\n    this.uri = uri;\n    this.params = params;\n  }\n\n  abstract execute(uri: string, params: Params): Promise<Out>;\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"]}

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

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