@frontmcp/sdk 0.2.3 → 0.3.0

package/src/interfaces/auth-hook.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-hook.interface.js","sourceRoot":"","sources":["../../../src/interfaces/auth-hook.interface.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,IAAY,aAwIX;AAxID,WAAY,aAAa;IACvB;;;;;;OAMG;IACH,wDAAuC,CAAA;IAGvC;;;;OAIG;IACH,sDAAqC,CAAA;IAErC;;;;OAIG;IACH,wDAAuC,CAAA;IAEvC,gDAAgD;IAEhD;;;;OAIG;IACH,gDAA+B,CAAA;IAE/B;;;;OAIG;IACH,gDAA+B,CAAA;IAE/B;;;;;;OAMG;IACH,wDAAuC,CAAA;IAEvC;;;;;OAKG;IACH,wDAAuC,CAAA;IAEvC;;;;OAIG;IACH,oDAAmC,CAAA;IAEnC,2CAA2C;IAE3C;;;;OAIG;IACH,kDAAiC,CAAA;IAEjC;;;;OAIG;IACH,gDAA+B,CAAA;IAE/B,iCAAiC;IAEjC;;;OAGG;IACH,0DAAyC,CAAA;IAEzC;;;OAGG;IACH,wDAAuC,CAAA;IAEvC,4DAA4D;IAE5D;;;;;OAKG;IACH,8CAA6B,CAAA;IAE7B;;;;;;OAMG;IACH,oCAAmB,CAAA;IAEnB;;;;OAIG;IACH,wCAAuB,CAAA;IAEvB;;;;OAIG;IACH,sCAAqB,CAAA;IAErB;;;;;;OAMG;IACH,wCAAuB,CAAA;AACzB,CAAC,EAxIW,aAAa,6BAAb,aAAa,QAwIxB","sourcesContent":["/**\n * Lifecycle stages for auth invocation.\n *\n * Ordering notes:\n * - \"will*\" stages run before the action; \"did*\" stages run after.\n * - Higher `priority()` runs earlier for \"will*\" (outermost), and later for \"did*\".\n * - Finalization stages (`willFinalize`, `willAudit`, `didAudit`, `onMetrics`) should be placed\n *   in your plan’s `finalize` array to run on both success and error paths.\n *\n * Control flow:\n * - Hooks may call `ctx.respond(value)` to short-circuit with a return value.\n * - Hooks may call `ctx.abort(reason, code?, httpStatus?)` to stop with an error.\n *\n */\n\nexport enum AuthHookStage {\n  /** Prepare a new session (or re-register an incoming secureJwt).\n   * Responsibilities:\n   * - Validate incoming token (if any); compute defaults; attach user hints.\n   * - Initialize per-session resources and attach to `ctx.data`.\n   * Failure modes:\n   * - `ctx.abort('invalid jwt', 'INVALID_SESSION', 401)`.\n   */\n  willCreateSession = 'willCreateSession',\n\n\n  /** Session created and registered.\n   * Responsibilities:\n   * - Announce readiness (mount handlers/streams), emit side-effects if needed.\n   * - Optionally shape `ctx.output` with a `SessionContextView`.\n   */\n  didCreateSession = 'didCreateSession',\n\n  /** Bind DI providers needed for this session/request.\n   * Responsibilities:\n   * - Resolve and bind providers so later hooks can `ctx.get(...)`.\n   * - May set `ctx.bindProvider/bindProviders` helpers.\n   */\n  willBindProviders = 'willBindProviders',\n\n  // ---------- Auth (within a session) ----------\n\n  /** Signal the beginning of an auth sequence in the scope of this session.\n   * Responsibilities:\n   * - Initialize auth-related state (PKCE/state, CSRF, telemetry).\n   * - Decide transport (SSE/StreamableHTTP) for status/URL events if applicable.\n   */\n  willBeginAuth = 'willBeginAuth',\n\n  /** Streamable authorization progress within the session.\n   * Responsibilities:\n   * - Emit URL/status events (e.g., “authorize_url”, “awaiting_callback”).\n   * - Optionally `ctx.respond({event: ...})` for push-style transports.\n   */\n  willAuthorize = 'willAuthorize', // stream-able events (URL/status)\n\n  /** Prepare and gate the token exchange with the provider.\n   * Responsibilities:\n   * - Verify callback params; ensure prerequisites (sessionId present).\n   * - Compute exchange request; rate-limit/anti-replay checks.\n   * Failure modes:\n   * - `ctx.abort('invalid state/pkce', 'OAUTH_CALLBACK_ERROR', 400)`.\n   */\n  willExchangeToken = 'willExchangeToken',\n\n  /** SecureMcp JWT has been minted/confirmed for this session.\n   * Responsibilities:\n   * - React to issuance (e.g., persist session claims, notify listeners).\n   * Notes:\n   * - Fired once the session’s secureJwt is known; avoid logging secrets.\n   */\n  didIssueSecureJwt = 'didIssueSecureJwt',\n\n  /** Encrypt and store provider tokens for this session.\n   * Responsibilities:\n   * - Write encrypted blobs to the session record (per provider).\n   * - Derive minimal metadata (scopes/expiry) for later claims-only exposure.\n   */\n  willStoreTokens = 'willStoreTokens',\n\n  // ---------- Access (read path) ----------\n\n  /** Authorize and prepare a session read.\n   * Responsibilities:\n   * - Validate access to the session; attach read-scoped providers if required.\n   * - Optionally shape a partial view before execute.\n   */\n  willGetSession = 'willGetSession',\n\n  /** Post-process the session view.\n   * Responsibilities:\n   * - Redact/transform/derive fields for the final response.\n   * - Set `ctx.output` to a `SessionContextView`.\n   */\n  didGetSession = 'didGetSession',\n\n  // ---------- Disposal ----------\n\n  /** Announce shutdown and allow flush/cleanup.\n   * Responsibilities:\n   * - Close streams, unsubscribe listeners, schedule disposers.\n   */\n  willDisposeSession = 'willDisposeSession',\n\n  /** Confirm teardown and emit metrics.\n   * Responsibilities:\n   * - Final confirmation of resource release; summarize outcome.\n   */\n  didDisposeSession = 'didDisposeSession',\n\n  // ---------- Finalize / audit / metrics / errors ----------\n\n  /** Optional “late finally” hook if you need a single place before audit/metrics.\n   * Responsibilities:\n   * - Last-chance cleanup across success/error paths (idempotent, non-throwing).\n   * Notes:\n   * - Include this stage in your plan’s `finalize` array to activate.\n   */\n  willFinalize = 'willFinalize',\n\n  /** Centralized error handler.\n   * Responsibilities:\n   * - Redact sensitive data; map internal errors to public codes.\n   * - Optionally `ctx.respond({ error })` or `ctx.abort(...)`.\n   * Notes:\n   * - Should not throw; runs before audit/metrics finalize.\n   */\n  onError = 'onError',\n\n  /** Pre-audit collection on both success and error paths.\n   * Responsibilities:\n   * - Build audit envelope (actor, sessionId, providers touched).\n   * - Normalize and strip secrets (no raw tokens).\n   */\n  willAudit = 'willAudit',\n\n  /** Persist/emit the audit record.\n   * Responsibilities:\n   * - Write to audit sink(s) with outcome and timings.\n   * - Correlate via `ctx.requestId`/`ctx.sessionId`.\n   */\n  didAudit = 'didAudit',\n\n  /** Telemetry/metrics emission for both success and errors.\n   * Responsibilities:\n   * - Counters & timings (create/get/dispose/auth/exchange/store).\n   * - Error code/tag cardinality kept small for SLOs/alerts.\n   * Constraints:\n   * - Non-throwing; must not alter control flow.\n   */\n  onMetrics = 'onMetrics',\n}\n"]}

package/src/interfaces/auth-provider.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-provider.interface.js","sourceRoot":"","sources":["../../../src/interfaces/auth-provider.interface.ts"],"names":[],"mappings":";;AAuCA,8CAIC;AAfD;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAC/B,GAA6C;IAE7C,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["import { Type, Token, ClassType, ValueType, FactoryType, ClassToken } from './base.interface';\nimport { AuthProviderMetadata } from '../metadata';\n\n\nexport interface AuthProviderInterface {\n  headers(): Record<string, string>;\n\n  refreshToken?(): Promise<string | undefined>;\n}\n\n\nexport type AuthProviderClassType<Provide> = ClassType<Provide> & AuthProviderMetadata;\nexport type AuthProviderValueType<Provide> = ValueType<Provide> & AuthProviderMetadata;\nexport type AuthProviderFactoryType<Provide, Tokens extends readonly (ClassToken | Token)[]> =\n  FactoryType<Provide, Tokens>\n  & AuthProviderMetadata;\n\n\nexport type AuthProviderType<\n  Provide extends AuthProviderInterface = any,\n  Tokens extends readonly (ClassToken | Token)[] = readonly (ClassToken | Token)[]\n> =\n  | Type<Provide>\n  | AuthProviderClassType<Provide>\n  | AuthProviderValueType<Provide>\n  | AuthProviderFactoryType<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 AsyncAuthProvider<Provide, const Tokens extends readonly (ClassToken | Token)[]>(\n  cfg: AuthProviderFactoryType<Provide, Tokens>,\n): AuthProviderFactoryType<Provide, Tokens> {\n  return cfg;\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"base.interface.js","sourceRoot":"","sources":["../../../src/interfaces/base.interface.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Constructor type for a concrete class that produces instances of T.\n *\n * Useful anywhere a factory/DI container expects a class reference that can be\n * `new`-ed. For example: `getProvider(UserRepo as Type<UserRepo>)`.\n */\nexport interface Type<T = unknown> extends Function {\n  new(...args: any[]): T;\n}\n\n/**\n * Constructor type for a concrete class that produces instances of T.\n *\n * Useful anywhere a factory/DI container expects a class reference that can be\n * `new`-ed. For example: `getProvider(UserRepo as Type<UserRepo>)`.\n */\nexport type FuncType<T> = (...args: any[]) => any | Promise<any>;\n\n\nexport type PartialStagesType<T extends string> = Partial<Record<T, Type[]>>;\n\n/**\n * Empty Constructor type for a concrete class that produces instances of T.\n *\n * Useful anywhere a factory/DI container expects a class reference that can be\n * `new`-ed. For example: `getProvider(UserRepo as Type<UserRepo>)`.\n */\nexport interface CtorType<T = unknown> extends Function {\n  new(): T;\n}\n\nexport type Ctor<T> = new (...args: any[]) => T;\n\n/**\n * Shape of an abstract class (or interface-like constructor) whose instances\n * cannot be created directly but still expose a prototype of T.\n *\n * This is handy when accepting references that may point at abstract bases\n * instead of concrete implementors.\n */\nexport interface Abstract<T> extends Function {\n  prototype: T;\n}\n\n/**\n * A reference token that may be used to look up or identify a dependency.\n *\n * Typical usages:\n * - string | symbol: named tokens (e.g., provider IDs like \"provider:redis\").\n * - Type<T>: a concrete class constructor (can be instantiated).\n * - Abstract<T>: an abstract base reference (resolved to a concrete impl).\n * - Function: generic function references when needed.\n */\nexport type Reference<T = unknown> = string | symbol | Type<T> | Abstract<T> | Function;\n\n/** A DI token that can be either a class constructor or a logical reference. */\nexport type Token<T = any> = Type<T> | Reference<T>;\n\n\nexport interface ClassType<Provide> {\n  provide: Reference<Provide>;\n  useClass: Type<Provide>;\n}\n\nexport interface ValueType<Provide> {\n  provide: Reference<Provide>;\n  useValue: Provide;\n}\n\n/** Map a tuple of tokens to a tuple of their instance types (order preserved). */\n\nexport type ClassToken<T = any> = abstract new (...a: any) => T;\n// Branded symbol token that carries the payload type T\n\n// export type Resolve<Tokens extends readonly Token[]> = {\n//   [K in keyof Tokens]: Tokens[K] extends Token<infer R> ? R : never;\n// };\n\n/** 2) Map tokens -> runtime parameter types **/\ntype ResolveToken<T> =\n  T extends ClassToken<infer R> ? R\n  : T extends symbol & { readonly __di_type?: infer R } ? R\n  : never;\n\ntype ResolveTokens<Tokens extends readonly unknown[]> = {\n  [K in keyof Tokens]: Tokens[K] extends Token<infer R> ? R : ResolveToken<Tokens[K]>;\n};\n\n// Rest parameters can't be readonly tuples; strip readonly.\ntype Mutable<T extends readonly unknown[]> = { -readonly [K in keyof T]: T[K] };\n\n/** 3) FactoryType with correct useFactory shape **/\nexport interface FactoryType<Provide, Tokens extends readonly (ClassToken | Token)[]> {\n  provide: Reference<Provide>;\n  inject: () => Tokens;\n  useFactory: (...args: Mutable<ResolveTokens<Tokens>>) => Provide | Promise<Provide>;\n}\n\n\n\nexport type RequiredByKey<T, K extends keyof T> = T & Required<Omit<T, K>>;\n"]}

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

@@ -1,41 +0,0 @@
-import { Token, Type } from './base.interface';
-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";
-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'];
-export type FlowCtxOf<N extends FlowName> = ExtendFlows[N]['ctx'];
-export type FlowStagesOf<N extends FlowName> = ExtendFlows[N]['stage'];
-export type FlowExecuteStagesOf<N extends FlowName> = ExtendFlows[N]['executeStage'];
-export type FlowControlType = 'respond' | 'fail' | 'abort' | 'next' | 'handled';
-export declare class FlowControl extends Error {
-    readonly type: FlowControlType;
-    readonly output: any;
-    constructor(type: FlowControlType, output: any);
-    static respond<T>(output: T): never;
-    static next(): never;
-    static handled(): never;
-    static fail(error: Error): never;
-    static abort(reason: string): never;
-}
-export declare abstract class FlowBase<N extends FlowName = FlowName> {
-    protected readonly metadata: FlowMetadata<N>;
-    readonly rawInput: Partial<FlowInputOf<N>> | any;
-    protected readonly scope: ScopeEntry;
-    protected readonly appendContextHooks: (hooks: HookEntry[]) => void;
-    protected readonly deps: ReadonlyMap<Token, unknown>;
-    protected input: FlowInputOf<N>;
-    state: FlowStateOf<N>;
-    scopeLogger: FrontMcpLogger;
-    constructor(metadata: FlowMetadata<N>, rawInput: Partial<FlowInputOf<N>> | any, scope: ScopeEntry, appendContextHooks: (hooks: HookEntry[]) => void, deps?: ReadonlyMap<Token, unknown>);
-    get<T>(token: Token<T>): T;
-    respond(output: FlowOutputOf<N>): void;
-    fail(error: Error): void;
-    protected abort(message: string): void;
-    protected next(): void;
-    protected handled(): void;
-}
-export type FlowType<Provide = FlowBase> = Type<Provide>;

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

@@ -1 +0,0 @@
-{"version":3,"file":"flow.interface.js","sourceRoot":"","sources":["../../../src/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> =\n  | Type<Provide>\n\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.interface.js","sourceRoot":"","sources":["../../../src/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/interfaces/hook.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.interface.js","sourceRoot":"","sources":["../../../src/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/interfaces/index.js.map

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

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

@@ -1,24 +0,0 @@
-import { z } from 'zod';
-import { FlowName } from '../../metadata';
-export type Dict = Record<PropertyKey, unknown>;
-type RequiredView<T> = {
-    [K in keyof T]-?: Exclude<T[K], undefined>;
-};
-type StateAccess<T> = {
-    [K in keyof T]: T[K] | undefined;
-} & {
-    required: RequiredView<T>;
-};
-type StateType<Name extends FlowName> = z.infer<ExtendFlows[Name]['state']>;
-export type FlowStateOf<Name extends FlowName, T = StateType<Name>> = StateAccess<T> & {
-    get<K extends keyof T>(key: K): T[K] | undefined;
-    getOrThrow<K extends keyof T>(key: K, message?: string): Exclude<T[K], undefined>;
-    set<K extends keyof T>(key: K, value: T[K]): FlowStateOf<Name, T>;
-    set(patch: Partial<T>): FlowStateOf<Name, T>;
-    snapshot(): Readonly<Partial<T>>;
-};
-export declare class FlowState {
-    private constructor();
-    static create<Name extends FlowName, T = StateType<Name>>(initial?: Partial<T>): FlowStateOf<Name>;
-}
-export {};

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

@@ -1 +0,0 @@
-{"version":3,"file":"flow.utils.js","sourceRoot":"","sources":["../../../../src/interfaces/internal/flow.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { FlowName } from '../../metadata';\n\nexport type Dict = Record<PropertyKey, unknown>;\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/interfaces/internal/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/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/interfaces/internal/primary-auth-provider.interface.d.ts

@@ -1,24 +0,0 @@
-import { ServerRequest } from '../server.interface';
-import { AuthOptions } from '../../types';
-/**
- * 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 ')
- *  }
- */
-export declare abstract class FrontMcpAuth {
-    ready: Promise<void>;
-    readonly options: AuthOptions;
-    readonly id: string;
-    constructor(options: AuthOptions);
-    abstract fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
-    abstract validate(request: ServerRequest): Promise<void>;
-    abstract get issuer(): string;
-}
-export { FrontMcpAuth as Auth, };

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

@@ -1 +0,0 @@
-{"version":3,"file":"primary-auth-provider.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/internal/primary-auth-provider.interface.ts"],"names":[],"mappings":";;;AAEA,uCAA0C;AAG1C;;;;;;;;;;;GAWG;AACH,MAAsB,YAAY;IAChC,KAAK,CAAgB;IACZ,OAAO,CAAc;IACrB,EAAE,CAAS;IAEpB,YAAY,OAAoB;QAC9B,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 {\n  ready: Promise<void>;\n  readonly options: AuthOptions;\n  readonly id: string;\n\n  constructor(options: AuthOptions) {\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};"]}

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.interface.js","sourceRoot":"","sources":["../../../src/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/interfaces/plugin.interface.js.map

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"provider.interface.js","sourceRoot":"","sources":["../../../src/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/interfaces/resource.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource.interface.js","sourceRoot":"","sources":["../../../src/interfaces/resource.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { ResourceMetadata } from '../metadata';\nimport { FuncType, Token, Type } from './base.interface';\n\n\nexport interface ResourceInterface<In = any, Out = any> {\n  execute(input: In, context: ResourceContext<In, Out>): Promise<Out>;\n}\n\nexport type ResourceType<In = any, Out = any> =\n  | Type<ResourceInterface<In, Out>>\n  | FuncType<ResourceInterface<In, Out>>\n\n\nexport interface ResourceContext<In, Out> {\n  readonly resourceId: string;\n  readonly resourceName: string;\n  readonly metadata: ResourceMetadata;\n\n\n  get<T>(token: Token<T>): T;\n\n  tryGet<T>(token: Token<T>): T | undefined;\n\n  get inputHistory(): In[];\n\n  get outputHistory(): Out[];\n\n  set input(value: In);\n\n  get input(): In;\n\n  set output(value: Out);\n\n  get output(): Out | undefined;\n\n  respond(value: Out): never;\n\n  fail(reason: string, error: any): never;\n}"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"scope.interface.js","sourceRoot":"","sources":["../../../src/interfaces/scope.interface.ts"],"names":[],"mappings":"","sourcesContent":["import { Type } from './base.interface';\n\nexport interface ScopeInterface {\n\n}\n\nexport type ScopeType = Type<ScopeInterface>\n\n\nexport {\n  ScopeInterface as FrontMcpScopeInterface,\n  ScopeType as FrontMcpScopeType,\n}"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"server.interface.js","sourceRoot":"","sources":["../../../src/interfaces/server.interface.ts"],"names":[],"mappings":";;;AAAA,+BAA6E;AAK7E,MAAa,aAAc,SAAQ,sBAAe;IAEhD,IAAI,CAAS;IAGb,KAAK,CAAoC;IACzC,IAAI,CAAO;IACX,WAAW,CAAiB;CAC7B;AARD,sCAQC;AAED,MAAsB,cAAe,SAAQ,qBAAkB;CAU9D;AAVD,wCAUC;AAMD,MAAsB,cAAc;CA+BnC;AA/BD,wCA+BC","sourcesContent":["import { IncomingMessage, ServerResponse as HttpServerResponse } from 'http';\nimport { Authorization } from '../types'; // TODO: move to internal\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport class ServerRequest extends IncomingMessage {\n  declare method: HttpMethod;\n  path: string;\n  declare url: string;\n  declare headers: Record<string, string>;\n  query: Record<string, string | string[]>;\n  body?: any;\n  authSession?: Authorization;\n}\n\nexport abstract class ServerResponse extends HttpServerResponse {\n  abstract status(code: number): ServerResponse;\n\n  abstract json(payload: any): void;\n\n  abstract send(payload: any): void;\n\n  abstract redirect(url: string): void;\n\n  abstract redirect(status: number, url: string): void;\n}\n\nexport type NextFn = () => Promise<void> | void;\n\nexport type ServerRequestHandler = (req: ServerRequest, res: ServerResponse, next: NextFn) => Promise<void> | void;\n\nexport abstract class FrontMcpServer {\n\n  /**\n   * Register a middleware handler for a specific entry path.\n   * @param entryPath - e.g. '' or '/mcp'\n   * @param handler - (req, res, next) => {// middleware // next()}\n   */\n  abstract registerMiddleware(entryPath: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Register a route handler for a specific path.\n   * @param method - e.g. 'GET' or 'POST'\n   * @param path - e.g. '/mcp/invoke'\n   * @param handler - (req, res) => {// route handler // res.end() }\n   */\n  abstract registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Enhance a request handler with request/response processing and error handling.\n   * This handle will be stored as the first middleware in the chain to align adapter handler\n   * with the gateway's request/response processing.\n   */\n  abstract enhancedHandler(\n    handler: ServerRequestHandler,\n  ): (req: any, res: any, next: () => any) => Promise<void> | void;\n\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract start(port?: number): Promise<void> | void;\n}"]}

package/src/interfaces/session-hook.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-hook.interface.js","sourceRoot":"","sources":["../../../src/interfaces/session-hook.interface.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,IAAY,gBAuIX;AAvID,WAAY,gBAAgB;IAC1B;;;;;;OAMG;IACH,2DAAuC,CAAA;IAEvC;;;;OAIG;IACH,yDAAqC,CAAA;IAErC;;;;OAIG;IACH,2DAAuC,CAAA;IAEvC,gDAAgD;IAEhD;;;;OAIG;IACH,mDAA+B,CAAA;IAE/B;;;;OAIG;IACH,mDAA+B,CAAA;IAE/B;;;;;;OAMG;IACH,2DAAuC,CAAA;IAEvC;;;;;OAKG;IACH,2DAAuC,CAAA;IAEvC;;;;OAIG;IACH,uDAAmC,CAAA;IAEnC,2CAA2C;IAE3C;;;;OAIG;IACH,qDAAiC,CAAA;IAEjC;;;;OAIG;IACH,mDAA+B,CAAA;IAE/B,iCAAiC;IAEjC;;;OAGG;IACH,6DAAyC,CAAA;IAEzC;;;OAGG;IACH,2DAAuC,CAAA;IAEvC,4DAA4D;IAE5D;;;;;OAKG;IACH,iDAA6B,CAAA;IAE7B;;;;;;OAMG;IACH,uCAAmB,CAAA;IAEnB;;;;OAIG;IACH,2CAAuB,CAAA;IAEvB;;;;OAIG;IACH,yCAAqB,CAAA;IAErB;;;;;;OAMG;IACH,2CAAuB,CAAA;AACzB,CAAC,EAvIW,gBAAgB,gCAAhB,gBAAgB,QAuI3B","sourcesContent":["/**\n * Lifecycle stages for session invocation.\n *\n * Ordering notes:\n * - \"will*\" stages run before the action; \"did*\" stages run after.\n * - Higher `priority()` runs earlier for \"will*\" (outermost), and later for \"did*\".\n * - Finalization stages (`willFinalize`, `willAudit`, `didAudit`, `onMetrics`) should be placed\n *   in your plan’s `finalize` array to run on both success and error paths.\n *\n * Control flow:\n * - Hooks may call `ctx.respond(value)` to short-circuit with a return value.\n * - Hooks may call `ctx.abort(reason, code?, httpStatus?)` to stop with an error.\n *\n * Common context fields:\n * - `ctx.sessionId` SecureMcp session id (== secureJwt) once created/validated.\n * - `ctx.input`/`output` Arbitrary payloads for the current flow.\n * - `ctx.data` Shared bag for cross-hook state.\n * - `ctx.providers` Optional provider views if needed for UI/selection.\n */\nexport enum SessionHookStage {\n  /** Prepare a new session (or re-register an incoming secureJwt).\n   * Responsibilities:\n   * - Validate incoming token (if any); compute defaults; attach user hints.\n   * - Initialize per-session resources and attach to `ctx.data`.\n   * Failure modes:\n   * - `ctx.abort('invalid jwt', 'INVALID_SESSION', 401)`.\n   */\n  willCreateSession = 'willCreateSession',\n\n  /** Session created and registered.\n   * Responsibilities:\n   * - Announce readiness (mount handlers/streams), emit side-effects if needed.\n   * - Optionally shape `ctx.output` with a `SessionContextView`.\n   */\n  didCreateSession = 'didCreateSession',\n\n  /** Bind DI providers needed for this session/request.\n   * Responsibilities:\n   * - Resolve and bind providers so later hooks can `ctx.get(...)`.\n   * - May set `ctx.bindProvider/bindProviders` helpers.\n   */\n  willBindProviders = 'willBindProviders',\n\n  // ---------- Auth (within a session) ----------\n\n  /** Signal the beginning of an auth sequence in the scope of this session.\n   * Responsibilities:\n   * - Initialize auth-related state (PKCE/state, CSRF, telemetry).\n   * - Decide transport (SSE/StreamableHTTP) for status/URL events if applicable.\n   */\n  willBeginAuth = 'willBeginAuth',\n\n  /** Streamable authorization progress within the session.\n   * Responsibilities:\n   * - Emit URL/status events (e.g., “authorize_url”, “awaiting_callback”).\n   * - Optionally `ctx.respond({event: ...})` for push-style transports.\n   */\n  willAuthorize = 'willAuthorize', // stream-able events (URL/status)\n\n  /** Prepare and gate the token exchange with the provider.\n   * Responsibilities:\n   * - Verify callback params; ensure prerequisites (sessionId present).\n   * - Compute exchange request; rate-limit/anti-replay checks.\n   * Failure modes:\n   * - `ctx.abort('invalid state/pkce', 'OAUTH_CALLBACK_ERROR', 400)`.\n   */\n  willExchangeToken = 'willExchangeToken',\n\n  /** SecureMcp JWT has been minted/confirmed for this session.\n   * Responsibilities:\n   * - React to issuance (e.g., persist session claims, notify listeners).\n   * Notes:\n   * - Fired once the session’s secureJwt is known; avoid logging secrets.\n   */\n  didIssueSecureJwt = 'didIssueSecureJwt',\n\n  /** Encrypt and store provider tokens for this session.\n   * Responsibilities:\n   * - Write encrypted blobs to the session record (per provider).\n   * - Derive minimal metadata (scopes/expiry) for later claims-only exposure.\n   */\n  willStoreTokens = 'willStoreTokens',\n\n  // ---------- Access (read path) ----------\n\n  /** Authorize and prepare a session read.\n   * Responsibilities:\n   * - Validate access to the session; attach read-scoped providers if required.\n   * - Optionally shape a partial view before execute.\n   */\n  willGetSession = 'willGetSession',\n\n  /** Post-process the session view.\n   * Responsibilities:\n   * - Redact/transform/derive fields for the final response.\n   * - Set `ctx.output` to a `SessionContextView`.\n   */\n  didGetSession = 'didGetSession',\n\n  // ---------- Disposal ----------\n\n  /** Announce shutdown and allow flush/cleanup.\n   * Responsibilities:\n   * - Close streams, unsubscribe listeners, schedule disposers.\n   */\n  willDisposeSession = 'willDisposeSession',\n\n  /** Confirm teardown and emit metrics.\n   * Responsibilities:\n   * - Final confirmation of resource release; summarize outcome.\n   */\n  didDisposeSession = 'didDisposeSession',\n\n  // ---------- Finalize / audit / metrics / errors ----------\n\n  /** Optional “late finally” hook if you need a single place before audit/metrics.\n   * Responsibilities:\n   * - Last-chance cleanup across success/error paths (idempotent, non-throwing).\n   * Notes:\n   * - Include this stage in your plan’s `finalize` array to activate.\n   */\n  willFinalize = 'willFinalize',\n\n  /** Centralized error handler.\n   * Responsibilities:\n   * - Redact sensitive data; map internal errors to public codes.\n   * - Optionally `ctx.respond({ error })` or `ctx.abort(...)`.\n   * Notes:\n   * - Should not throw; runs before audit/metrics finalize.\n   */\n  onError = 'onError',\n\n  /** Pre-audit collection on both success and error paths.\n   * Responsibilities:\n   * - Build audit envelope (actor, sessionId, providers touched).\n   * - Normalize and strip secrets (no raw tokens).\n   */\n  willAudit = 'willAudit',\n\n  /** Persist/emit the audit record.\n   * Responsibilities:\n   * - Write to audit sink(s) with outcome and timings.\n   * - Correlate via `ctx.requestId`/`ctx.sessionId`.\n   */\n  didAudit = 'didAudit',\n\n  /** Telemetry/metrics emission for both success and errors.\n   * Responsibilities:\n   * - Counters & timings (create/get/dispose/auth/exchange/store).\n   * - Error code/tag cardinality kept small for SLOs/alerts.\n   * Constraints:\n   * - Non-throwing; must not alter control flow.\n   */\n  onMetrics = 'onMetrics',\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool-hook.interface.js","sourceRoot":"","sources":["../../../src/interfaces/tool-hook.interface.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,IAAY,aA+GX;AA/GD,WAAY,aAAa;IACvB;gEAC4D;IAC5D,wDAAuC,CAAA;IAEvC,uFAAuF;IACvF,oEAAmD,CAAA;IAEnD,0EAA0E;IAC1E,kEAAiD,CAAA;IAEjD,kFAAkF;IAClF,gDAA+B,CAAA;IAE/B,8FAA8F;IAC9F,sDAAqC,CAAA;IAErC,oFAAoF;IACpF,gEAA+C,CAAA;IAE/C,0DAA0D;IAE1D,+EAA+E;IAC/E,sDAAqC,CAAA;IAErC,0EAA0E;IAC1E,oDAAmC,CAAA;IAEnC,2EAA2E;IAC3E,8DAA6C,CAAA;IAE7C,wDAAwD;IACxD,4DAA2C,CAAA;IAE3C,kDAAkD;IAElD,8EAA8E;IAC9E,kDAAiC,CAAA;IAEjC,sEAAsE;IACtE,wDAAuC,CAAA;IAEvC,2EAA2E;IAC3E,0DAAyC,CAAA;IAEzC,+DAA+D;IAC/D,oDAAmC,CAAA;IAEnC,2EAA2E;IAC3E,wDAAuC,CAAA;IAEvC,4CAA4C;IAE5C,gFAAgF;IAChF,gDAA+B,CAAA;IAE/B,0EAA0E;IAC1E,4CAA2B,CAAA;IAE3B,2EAA2E;IAC3E,8CAA6B,CAAA;IAE7B,wDAAwD;IACxD,kDAAiC,CAAA;IAEjC,8CAA8C;IAE9C,mHAAmH;IACnH,gDAA+B,CAAA;IAE/B,4EAA4E;IAC5E,4CAA2B,CAAA;IAE3B,gFAAgF;IAChF,0CAAyB,CAAA;IAEzB,mDAAmD;IAEnD,8EAA8E;IAC9E,sDAAqC,CAAA;IAErC,2EAA2E;IAC3E,0DAAyC,CAAA;IAEzC,mFAAmF;IACnF,4DAA2C,CAAA;IAE3C,0DAA0D;IAE1D,oFAAoF;IACpF,oCAAmB,CAAA;IAEnB,gEAAgE;IAChE,sCAAqB,CAAA;IAErB,uEAAuE;IACvE,wCAAuB,CAAA;IAEvB,+DAA+D;IAC/D,sCAAqB,CAAA;IAErB,mDAAmD;IACnD,wCAAuB,CAAA;IAEvB,yDAAyD;IAEzD,yFAAyF;IACzF,oCAAmB,CAAA;IAEnB,6EAA6E;IAC7E,0DAAyC,CAAA;AAC3C,CAAC,EA/GW,aAAa,6BAAb,aAAa,QA+GxB","sourcesContent":["/**\n * Lifecycle stages for tool invocation.\n *\n * Ordering notes:\n * - \"will*\" stages run before the action; \"did*\" run after.\n * - Higher `priority()` runs earlier for \"will*\" (outermost for wrappers), and later for \"did*\".\n * - `aroundExecute` wraps the actual execution block (including will/didExecute inside).\n *\n * Control flow:\n * - Hooks may call `ctx.respond(value)` to short-circuit with a value.\n * - Hooks may call `ctx.abort(reason, code?, httpStatus?)` to deny/stop.\n * - Hooks may call `ctx.retryAfter(ms, reason?)` to signal backoff.\n */\nexport enum ToolHookStage {\n  /** Bind DI providers needed for this invocation (from ctor tokens + hook/tool `provide()`).\n   * Runs very early so later hooks can use `ctx.get(...)`. */\n  willBindProviders = 'willBindProviders',\n\n  /** Last chance to populate/shape the invocation context (user, tenant, attrs, ids). */\n  willCreateInvokeContext = 'willCreateInvokeContext',\n\n  /** Post-context creation; good for sanity checks, tracing decorations. */\n  didCreateInvokeContext = 'didCreateInvokeContext',\n\n  /** Authorization gate (roles/scopes/RBAC/ABAC). May `abort()` if unauthorized. */\n  willAuthorize = 'willAuthorize',\n\n  /** Consent gate. May `respond()` with a consent challenge or `abort()` if missing consent. */\n  willCheckConsent = 'willCheckConsent',\n\n  /** Feature-flag gate (enable/disable per user/tenant/experiment). May `abort()`. */\n  willCheckFeatureFlags = 'willCheckFeatureFlags',\n\n  // ---------------- Capacity & Resilience ----------------\n\n  /** Acquire rate-limit quota. May `retryAfter()` or `abort()` on exhaustion. */\n  willAcquireQuota = 'willAcquireQuota',\n\n  /** Release rate-limit quota (best-effort; typically run in `finally`). */\n  didReleaseQuota = 'didReleaseQuota',\n\n  /** Acquire concurrency slot/semaphore. May `retryAfter()` or `abort()`. */\n  willAcquireSemaphore = 'willAcquireSemaphore',\n\n  /** Release concurrency slot/semaphore (best-effort). */\n  didReleaseSemaphore = 'didReleaseSemaphore',\n\n  // ---------------- Input shaping ----------------\n\n  /** Parse/coerce raw input (types, defaults). Mutate `ctx.input` as needed. */\n  willParseInput = 'willParseInput',\n\n  /** Validate business rules for input. May `abort()` on violations. */\n  willValidateInput = 'willValidateInput',\n\n  /** Normalize/canonicalize input (ids → uuids, trim, sort fields, etc.). */\n  willNormalizeInput = 'willNormalizeInput',\n\n  /** Apply DLP/minimization to input (mask/drop/hash fields). */\n  willRedactInput = 'willRedactInput',\n\n  /** Inject credentials/secrets (tokens, API keys) into context or input. */\n  willInjectSecrets = 'willInjectSecrets',\n\n  // ---------------- Caching ----------------\n\n  /** Attempt to serve from cache. May `respond(cachedValue)` to short-circuit. */\n  willReadCache = 'willReadCache',\n\n  /** Metrics/telemetry for cache hit; typically emitted by cache plugin. */\n  didCacheHit = 'didCacheHit',\n\n  /** Metrics/telemetry for cache miss; typically emitted by cache plugin. */\n  didCacheMiss = 'didCacheMiss',\n\n  /** Write result to cache after successful execution. */\n  willWriteCache = 'willWriteCache',\n\n  // ---------------- Execution ----------------\n\n  /** Around wrapper for execution (timeouts/retries/circuit/tracing). Must call `next()` unless short-circuiting. */\n  aroundExecute = 'aroundExecute',\n\n  /** Right before calling the tool implementation; may mutate `ctx.input`. */\n  willExecute = 'willExecute',\n\n  /** Right after tool returns; `ctx.output` is available for downstream hooks. */\n  didExecute = 'didExecute',\n\n  // ---------------- Output shaping ----------------\n\n  /** Apply DLP/minimization to output (mask/drop/truncate sensitive fields). */\n  willRedactOutput = 'willRedactOutput',\n\n  /** Validate output against business/schema rules. May `abort()` or fix. */\n  willValidateOutput = 'willValidateOutput',\n\n  /** Transform output shape (projection/mapping/pagination). Mutate `ctx.output`. */\n  willTransformOutput = 'willTransformOutput',\n\n  // ---------------- Retry & Observability ----------------\n\n  /** Called on each retry attempt by a retry wrapper (emit metrics/backoff hints). */\n  onRetry = 'onRetry',\n\n  /** Called when retries are exhausted and execution gives up. */\n  onGiveUp = 'onGiveUp',\n\n  /** Prepare audit payload (apply redaction) and/or write audit logs. */\n  willAudit = 'willAudit',\n\n  /** Post-audit hook (confirm persistence, forward to sinks). */\n  didAudit = 'didAudit',\n\n  /** Emit metrics (counters, histograms, traces). */\n  onMetrics = 'onMetrics',\n\n  // ---------------- Error & Finalization ----------------\n\n  /** Error handler for unexpected failures or control errors. Can map/normalize errors. */\n  onError = 'onError',\n\n  /** Always runs at the very end (success or error). Cleanup/releases here. */\n  willFinalizeInvoke = 'willFinalizeInvoke',\n}\n"]}

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

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

package/src/metadata/adapter.metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.metadata.js","sourceRoot":"","sources":["../../../src/metadata/adapter.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAcX,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACI,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\n\n\n/**\n * Declarative metadata describing what a FrontMcpAdapter contributes at app scope.\n */\nexport interface AdapterMetadata {\n  id?: string;\n  name: string;\n  description?: string;\n}\n\n\nexport const frontMcpAdapterMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n} satisfies RawZodShape<AdapterMetadata>).passthrough();\n"]}