@frontmcp/sdk 0.6.1 → 0.6.3

package/src/common/metadata/index.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./front-mcp.metadata"), exports);
-tslib_1.__exportStar(require("./flow.metadata"), exports);
-tslib_1.__exportStar(require("./hook.metadata"), exports);
-tslib_1.__exportStar(require("./app.metadata"), exports);
-tslib_1.__exportStar(require("./provider.metadata"), exports);
-tslib_1.__exportStar(require("./auth-provider.metadata"), exports);
-tslib_1.__exportStar(require("./adapter.metadata"), exports);
-tslib_1.__exportStar(require("./plugin.metadata"), exports);
-tslib_1.__exportStar(require("./tool.metadata"), exports);
-tslib_1.__exportStar(require("./tool-ui.metadata"), exports);
-tslib_1.__exportStar(require("./resource.metadata"), exports);
-tslib_1.__exportStar(require("./prompt.metadata"), exports);
-tslib_1.__exportStar(require("./logger.metadata"), exports);
-//# sourceMappingURL=index.js.map

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

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

package/src/common/metadata/logger.metadata.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpLogTransportMetadataSchema = void 0;
-const zod_1 = require("zod");
-exports.frontMcpLogTransportMetadataSchema = zod_1.z.object({
-    id: zod_1.z.string().optional(),
-    name: zod_1.z.string().min(1),
-    description: zod_1.z.string().optional(),
-}).passthrough();
-//# sourceMappingURL=logger.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/logger.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAiCX,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,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;CACuC,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to an FrontMcpLogger decorator.\n   */\n  export interface ExtendFrontMcpLoggerMetadata {\n  }\n}\n\n/**\n * Declarative metadata describing what a FrontMcpLogger contributes.\n */\nexport interface LogTransportMetadata extends ExtendFrontMcpLoggerMetadata {\n  /**\n   * Optional unique identifier for the logger.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the logger, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the logger does and when to use it.\n   */\n  description?: string;\n}\n\n\nexport const frontMcpLogTransportMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n} satisfies RawZodShape<LogTransportMetadata, ExtendFrontMcpLoggerMetadata>).passthrough();\n\n"]}

package/src/common/metadata/plugin.metadata.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpPluginMetadataSchema = void 0;
-const zod_1 = require("zod");
-const schemas_1 = require("../schemas");
-exports.frontMcpPluginMetadataSchema = zod_1.z.object({
-    id: zod_1.z.string().optional(),
-    name: zod_1.z.string().min(1),
-    description: zod_1.z.string().optional(),
-    providers: zod_1.z.array(schemas_1.annotatedFrontMcpProvidersSchema).optional(),
-    exports: zod_1.z.array(schemas_1.annotatedFrontMcpProvidersSchema).optional(),
-    plugins: zod_1.z.array(schemas_1.annotatedFrontMcpPluginsSchema).optional(),
-    adapters: zod_1.z.array(schemas_1.annotatedFrontMcpAdaptersSchema).optional(),
-    tools: zod_1.z.array(schemas_1.annotatedFrontMcpToolsSchema).optional(),
-    resources: zod_1.z.array(schemas_1.annotatedFrontMcpResourcesSchema).optional(),
-    prompts: zod_1.z.array(schemas_1.annotatedFrontMcpPromptsSchema).optional(),
-}).passthrough();
-//# sourceMappingURL=plugin.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/plugin.metadata.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AAOxB,wCAIoB;AAqEP,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,0CAAgC,CAAC,CAAC,QAAQ,EAAE;IAC/D,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,0CAAgC,CAAC,CAAC,QAAQ,EAAE;IAC7D,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,wCAA8B,CAAC,CAAC,QAAQ,EAAE;IAC3D,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,yCAA+B,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sCAA4B,CAAC,CAAC,QAAQ,EAAE;IACvD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,0CAAgC,CAAC,CAAC,QAAQ,EAAE;IAC/D,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,wCAA8B,CAAC,CAAC,QAAQ,EAAE;CACtB,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { RawZodShape } from '../types';\nimport { z } from 'zod';\nimport {\n  ProviderType,\n  PluginType,\n  AdapterType,\n  ToolType, ResourceType, PromptType,\n} from '../interfaces';\nimport {\n  annotatedFrontMcpAdaptersSchema,\n  annotatedFrontMcpPluginsSchema, annotatedFrontMcpPromptsSchema,\n  annotatedFrontMcpProvidersSchema, annotatedFrontMcpResourcesSchema, annotatedFrontMcpToolsSchema,\n} from '../schemas';\n\n/**\n * Declarative metadata describing what an McpPlugin contributes at app scope.\n */\nexport interface PluginMetadata {\n  /**\n   * Human-friendly name for this app as shown in UIs, logs, and describe reports.\n   * Keep it short, stable, and unique within a gateway (consider prefixes).\n   */\n  id?: string;\n  /**\n   * Human-friendly name for this app as shown in UIs, logs, and describe reports.\n   * Keep it short, stable, and unique within a gateway (consider prefixes).\n   */\n  name: string;\n\n  /**\n   * Optional longer explanation of what the app does and what it exposes.\n   * Used for documentation, describe reports, and UIs. Avoid secrets/PII.\n   */\n  description?: string;\n\n  /**\n   * Plugin-scoped providers Named singleton (or scoped-singleton) dependencies used by tools/plugins at runtime\n   * — e.g., config, database pools, Redis clients, queues, KMS.\n   *\n   * Resolution is hierarchical (tool → app → gateway). Providers may depend on\n   * other providers and are usually initialized lazily on first use.\n   */\n  providers?: ProviderType[];\n\n  /**\n   * Plugin can export providers to be used in the host app or other plugins,\n   * e.g. for AuthPlugin can export AuthSession to be used in other plugins / apps.\n   *\n   * Resolution is hierarchical (tool → app → gateway). Providers may depend on\n   * other providers and are usually initialized lazily on first use.\n   */\n  exports?: ProviderType[];\n\n  /**\n   * Plugin-scoped plugins that participate in lifecycle events and can contribute\n   * additional capabilities (tools, resources, prompts, providers, adapters).\n   * Use plugins to enforce policy, auth, PII reduction, tracing, etc.\n   */\n  plugins?: PluginType[];\n\n  /**\n   * Plugin-scoped Adapters attached to this app that convert external definitions or sources\n   * (e.g., OpenAPI, Lambda, Custom) into generated tools/resources/prompts.\n   * Common options include include/exclude filters, name prefixes, base URLs,\n   * and authentication (often provided by plugins).\n   */\n  adapters?: AdapterType[];\n\n  /**\n   * Plugin-scoped Inline tools authored by this app (via builder or class). These are active\n   * actions with input/output schemas that the model can call. Tools generated\n   * by adapters do not need to be listed here.\n   */\n  tools?: ToolType[];\n\n  resources?: ResourceType[];\n\n  prompts?: PromptType[];\n\n}\n\nexport const frontMcpPluginMetadataSchema = z.object({\n  id: z.string().optional(),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  providers: z.array(annotatedFrontMcpProvidersSchema).optional(),\n  exports: z.array(annotatedFrontMcpProvidersSchema).optional(),\n  plugins: z.array(annotatedFrontMcpPluginsSchema).optional(),\n  adapters: z.array(annotatedFrontMcpAdaptersSchema).optional(),\n  tools: z.array(annotatedFrontMcpToolsSchema).optional(),\n  resources: z.array(annotatedFrontMcpResourcesSchema).optional(),\n  prompts: z.array(annotatedFrontMcpPromptsSchema).optional(),\n} satisfies RawZodShape<PluginMetadata>).passthrough();\n"]}

package/src/common/metadata/prompt.metadata.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpPromptMetadataSchema = void 0;
-const zod_1 = require("zod");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const promptArgumentSchema = zod_1.z.object({
-    /**
-     * The name of the argument.
-     */
-    name: zod_1.z.string(),
-    /**
-     * A human-readable description of the argument.
-     */
-    description: zod_1.z.optional(zod_1.z.string()),
-    /**
-     * Whether this argument must be provided.
-     */
-    required: zod_1.z.optional(zod_1.z.boolean()),
-}).passthrough();
-exports.frontMcpPromptMetadataSchema = zod_1.z.object({
-    name: zod_1.z.string().min(1),
-    title: zod_1.z.string().optional(),
-    description: zod_1.z.string().optional(),
-    arguments: zod_1.z.array(promptArgumentSchema).optional(),
-    icons: zod_1.z.array(types_js_1.IconSchema).optional(),
-}).passthrough();
-//# sourceMappingURL=prompt.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prompt.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/prompt.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,iEAAsE;AAyBtE,MAAM,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC;;OAEG;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB;;OAEG;IACH,WAAW,EAAE,OAAC,CAAC,QAAQ,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IACnC;;OAEG;IACH,QAAQ,EAAE,OAAC,CAAC,QAAQ,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;CAClC,CAAC,CAAC,WAAW,EAAE,CAAC;AAsCJ,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACnD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAU,CAAC,CAAC,QAAQ,EAAE;CACsC,CAAC,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\nimport { Icon, IconSchema } from '@modelcontextprotocol/sdk/types.js';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to McpPrompt decorator.\n   */\n  export interface ExtendFrontMcpPromptMetadata {\n  }\n}\n\ninterface PromptArgument {\n  /**\n   * The name of the argument.\n   */\n  name: string;\n  /**\n   * A human-readable description of the argument.\n   */\n  description?: string;\n  /**\n   * Whether this argument must be provided.\n   */\n  required?: boolean;\n}\n\nconst promptArgumentSchema = z.object({\n  /**\n   * The name of the argument.\n   */\n  name: z.string(),\n  /**\n   * A human-readable description of the argument.\n   */\n  description: z.optional(z.string()),\n  /**\n   * Whether this argument must be provided.\n   */\n  required: z.optional(z.boolean()),\n}).passthrough();\n\n\n/**\n * A known resource that the server is capable of reading.\n */\nexport interface FrontMcpPromptMetadata extends ExtendFrontMcpPromptMetadata {\n  /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */\n  name: string;\n  /**\n   * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,\n   * even by those unfamiliar with domain-specific terminology.\n   *\n   * If not provided, the name should be used for display (except for Tool,\n   * where `annotations.title` should be given precedence over using `name`,\n   * if present).\n   */\n  title?: string;\n\n  /**\n   * A description of what this resource represents.\n   *\n   * Clients can use this to improve the LLM's understanding of available resources. It can be thought of as a \"hint\" to the model.\n   */\n  description?: string;\n\n  /**\n   * A list of arguments to use for templating the prompt.\n   */\n  arguments: PromptArgument[],\n\n  /**\n   * A list of icons that can be used to represent this resource template.\n   */\n  icons?: Icon[];\n}\n\n\nexport const frontMcpPromptMetadataSchema = z.object({\n  name: z.string().min(1),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  arguments: z.array(promptArgumentSchema).optional(),\n  icons: z.array(IconSchema).optional(),\n} satisfies RawZodShape<FrontMcpPromptMetadata, ExtendFrontMcpPromptMetadata>).passthrough();\n\n\nexport {\n  FrontMcpPromptMetadata as PromptMetadata,\n};\n"]}

package/src/common/metadata/provider.metadata.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpProviderMetadataSchema = exports.ProviderScope = void 0;
-const zod_1 = require("zod");
-/**
- * Provider lifetime scope semantics.
- *
- * - GLOBAL: Singleton, shared across all requests
- * - CONTEXT: Per-context instance (combines session + request data)
- * - SESSION: deprecated Use CONTEXT instead
- * - REQUEST: deprecated Use CONTEXT instead
- */
-var ProviderScope;
-(function (ProviderScope) {
-    /** Singleton, shared across all requests */
-    ProviderScope["GLOBAL"] = "global";
-    /** Per-context instance (unified session + request scope) */
-    ProviderScope["CONTEXT"] = "context";
-    /**
-     * @deprecated Use CONTEXT instead. Maps to CONTEXT internally.
-     */
-    ProviderScope["SESSION"] = "session";
-    /**
-     * @deprecated Use CONTEXT instead. Maps to CONTEXT internally.
-     */
-    ProviderScope["REQUEST"] = "request";
-})(ProviderScope || (exports.ProviderScope = ProviderScope = {}));
-exports.frontMcpProviderMetadataSchema = zod_1.z
-    .object({
-    id: zod_1.z.string().optional(),
-    name: zod_1.z.string().min(1),
-    description: zod_1.z.string().optional(),
-    scope: zod_1.z.nativeEnum(ProviderScope).optional().default(ProviderScope.GLOBAL),
-})
-    .passthrough();
-//# sourceMappingURL=provider.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"provider.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/provider.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAaxB;;;;;;;GAOG;AACH,IAAY,aAaX;AAbD,WAAY,aAAa;IACvB,4CAA4C;IAC5C,kCAAiB,CAAA;IACjB,6DAA6D;IAC7D,oCAAmB,CAAA;IACnB;;OAEG;IACH,oCAAmB,CAAA;IACnB;;OAEG;IACH,oCAAmB,CAAA;AACrB,CAAC,EAbW,aAAa,6BAAb,aAAa,QAaxB;AAEY,QAAA,8BAA8B,GAAG,OAAC;KAC5C,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC;CACpC,CAAC;KACzC,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\n\n/**\n * Declarative metadata describing what a FrontMcpProvider contributes at app scope.\n */\nexport interface ProviderMetadata {\n  id?: string;\n  name: string;\n  description?: string;\n  scope?: ProviderScope;\n}\n\n/**\n * Provider lifetime scope semantics.\n *\n * - GLOBAL: Singleton, shared across all requests\n * - CONTEXT: Per-context instance (combines session + request data)\n * - SESSION: deprecated Use CONTEXT instead\n * - REQUEST: deprecated Use CONTEXT instead\n */\nexport enum ProviderScope {\n  /** Singleton, shared across all requests */\n  GLOBAL = 'global',\n  /** Per-context instance (unified session + request scope) */\n  CONTEXT = 'context',\n  /**\n   * @deprecated Use CONTEXT instead. Maps to CONTEXT internally.\n   */\n  SESSION = 'session',\n  /**\n   * @deprecated Use CONTEXT instead. Maps to CONTEXT internally.\n   */\n  REQUEST = 'request',\n}\n\nexport const frontMcpProviderMetadataSchema = z\n  .object({\n    id: z.string().optional(),\n    name: z.string().min(1),\n    description: z.string().optional(),\n    scope: z.nativeEnum(ProviderScope).optional().default(ProviderScope.GLOBAL),\n  } satisfies RawZodShape<ProviderMetadata>)\n  .passthrough();\n"]}

package/src/common/metadata/resource.metadata.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpResourceTemplateMetadataSchema = exports.frontMcpResourceMetadataSchema = void 0;
-const zod_1 = require("zod");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const uri_validation_utils_1 = require("../../utils/uri-validation.utils");
-exports.frontMcpResourceMetadataSchema = zod_1.z
-    .object({
-    name: zod_1.z.string().min(1),
-    title: zod_1.z.string().optional(),
-    uri: zod_1.z.string().min(1).refine(uri_validation_utils_1.isValidMcpUri, {
-        message: 'URI must have a valid scheme (e.g., file://, https://, custom://)',
-    }),
-    description: zod_1.z.string().optional(),
-    mimeType: zod_1.z.string().optional(),
-    icons: zod_1.z.array(types_js_1.IconSchema).optional(),
-})
-    .passthrough();
-exports.frontMcpResourceTemplateMetadataSchema = zod_1.z
-    .object({
-    name: zod_1.z.string().min(1),
-    title: zod_1.z.string().optional(),
-    uriTemplate: zod_1.z.string().min(1).refine(uri_validation_utils_1.isValidMcpUriTemplate, {
-        message: 'URI template must have a valid scheme (e.g., file://, https://, custom://)',
-    }),
-    description: zod_1.z.string().optional(),
-    mimeType: zod_1.z.string().optional(),
-    icons: zod_1.z.array(types_js_1.IconSchema).optional(),
-})
-    .passthrough();
-//# sourceMappingURL=resource.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"resource.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/resource.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,iEAAsE;AACtE,2EAAwF;AAqD3E,QAAA,8BAA8B,GAAG,OAAC;KAC5C,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,oCAAa,EAAE;QAC3C,OAAO,EAAE,mEAAmE;KAC7E,CAAC;IACF,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAU,CAAC,CAAC,QAAQ,EAAE;CACkC,CAAC;KACzE,WAAW,EAAE,CAAC;AAyCJ,QAAA,sCAAsC,GAAG,OAAC;KACpD,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,4CAAqB,EAAE;QAC3D,OAAO,EAAE,4EAA4E;KACtF,CAAC;IACF,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAU,CAAC,CAAC,QAAQ,EAAE;CACkD,CAAC;KACzF,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\nimport { Icon, IconSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { isValidMcpUri, isValidMcpUriTemplate } from '../../utils/uri-validation.utils';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to McpResource decorator.\n   */\n  export interface ExtendFrontMcpResourceMetadata {}\n\n  /**\n   * Declarative metadata extends to McpResourceTemplate decorator.\n   */\n  export interface ExtendFrontMcpResourceTemplateMetadata {}\n}\n\n/**\n * A known resource that the server is capable of reading.\n */\ninterface ResourceMetadata extends ExtendFrontMcpResourceMetadata {\n  /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */\n  name: string;\n  /**\n   * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,\n   * even by those unfamiliar with domain-specific terminology.\n   *\n   * If not provided, the name should be used for display (except for Tool,\n   * where `annotations.title` should be given precedence over using `name`,\n   * if present).\n   */\n  title?: string;\n\n  /**\n   * The URI of this resource.\n   */\n  uri: string;\n\n  /**\n   * A description of what this resource represents.\n   *\n   * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a \"hint\" to the model.\n   */\n  description?: string;\n\n  /**\n   * The MIME type of this resource, if known.\n   */\n  mimeType?: string;\n\n  /**\n   * A list of icons that can be used to represent this resource template.\n   */\n  icons?: Icon[];\n}\n\nexport const frontMcpResourceMetadataSchema = z\n  .object({\n    name: z.string().min(1),\n    title: z.string().optional(),\n    uri: z.string().min(1).refine(isValidMcpUri, {\n      message: 'URI must have a valid scheme (e.g., file://, https://, custom://)',\n    }),\n    description: z.string().optional(),\n    mimeType: z.string().optional(),\n    icons: z.array(IconSchema).optional(),\n  } satisfies RawZodShape<ResourceMetadata, ExtendFrontMcpResourceMetadata>)\n  .passthrough();\n\n/**\n * A template description for resources available on the server.\n */\ninterface ResourceTemplateMetadata extends ExtendFrontMcpResourceTemplateMetadata {\n  /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */\n  name: string;\n  /**\n   * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,\n   * even by those unfamiliar with domain-specific terminology.\n   *\n   * If not provided, the name should be used for display (except for Tool,\n   * where `annotations.title` should be given precedence over using `name`,\n   * if present).\n   */\n  title?: string;\n\n  /**\n   * A URI template (according to RFC 6570) that can be used to construct resource URIs.\n   */\n  uriTemplate: string;\n\n  /**\n   * A description of what this template is for.\n   *\n   * This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a \"hint\" to the model.\n   */\n  description?: string;\n\n  /**\n   * The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.\n   */\n  mimeType?: string;\n\n  /**\n   * A list of icons that can be used to represent this resource template.\n   */\n  icons?: Icon[];\n}\n\nexport const frontMcpResourceTemplateMetadataSchema = z\n  .object({\n    name: z.string().min(1),\n    title: z.string().optional(),\n    uriTemplate: z.string().min(1).refine(isValidMcpUriTemplate, {\n      message: 'URI template must have a valid scheme (e.g., file://, https://, custom://)',\n    }),\n    description: z.string().optional(),\n    mimeType: z.string().optional(),\n    icons: z.array(IconSchema).optional(),\n  } satisfies RawZodShape<ResourceTemplateMetadata, ExtendFrontMcpResourceTemplateMetadata>)\n  .passthrough();\n\nexport {\n  ResourceMetadata,\n  ResourceMetadata as FrontMcpResourceMetadata,\n  ResourceTemplateMetadata,\n  ResourceTemplateMetadata as FrontMcpResourceTemplateMetadata,\n};\n"]}

package/src/common/metadata/tool-ui.metadata.js

@@ -1,12 +0,0 @@
-"use strict";
-/**
- * Tool UI Configuration Types
- *
- * Re-exports types from @frontmcp/uipack/types for SDK consumers.
- * This provides a single source of truth for UI configuration types
- * while maintaining backwards compatibility.
- *
- * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=tool-ui.metadata.js.map

package/src/common/metadata/tool-ui.metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-ui.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/tool-ui.metadata.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * Tool UI Configuration Types\n *\n * Re-exports types from @frontmcp/uipack/types for SDK consumers.\n * This provides a single source of truth for UI configuration types\n * while maintaining backwards compatibility.\n *\n * @see {@link https://docs.agentfront.dev/docs/servers/tools#tool-ui | Tool UI Documentation}\n */\n\n// Re-export all UI configuration types from @frontmcp/uipack\nexport {\n  // Legacy UI Config Types\n  type UIContentSecurityPolicy,\n  type TemplateHelpers,\n  type TemplateContext,\n  type TemplateBuilderFn,\n  type WidgetServingMode,\n  type WidgetDisplayMode,\n  // Re-export UITemplateConfig as ToolUIConfig for backwards compatibility\n  type UITemplateConfig as ToolUIConfig,\n  // New Widget Runtime Types\n  type UIType,\n  type BundlingMode,\n  type DisplayMode,\n  type ResourceMode,\n  type CSPDirectives,\n  type RendererAssets,\n  type WidgetManifest,\n  type RuntimePayload,\n  type WidgetConfig,\n  type WidgetTemplate,\n  type WidgetRuntimeOptions,\n  type BuildManifestResult,\n  type BuildManifestOptions,\n} from '@frontmcp/uipack/types';\n"]}

package/src/common/metadata/tool.metadata.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontMcpToolMetadataSchema = exports.ResourceLinkOutputSchema = exports.ResourceOutputSchema = exports.AudioOutputSchema = exports.ImageOutputSchema = void 0;
-const zod_1 = require("zod");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const mcpToolAnnotationsSchema = zod_1.z
-    .object({
-    title: zod_1.z.string().optional(),
-    readOnlyHint: zod_1.z.boolean().optional(),
-    destructiveHint: zod_1.z.boolean().optional(),
-    idempotentHint: zod_1.z.boolean().optional(),
-    openWorldHint: zod_1.z.boolean().optional(),
-})
-    .passthrough();
-exports.ImageOutputSchema = types_js_1.ImageContentSchema;
-exports.AudioOutputSchema = types_js_1.AudioContentSchema;
-exports.ResourceOutputSchema = types_js_1.EmbeddedResourceSchema;
-exports.ResourceLinkOutputSchema = types_js_1.ResourceLinkSchema;
-/**
- * Runtime schema for ToolSingleOutputType:
- *  - literals ('string', 'image', ...)
- *  - any Zod schema (ZodObject, ZodArray, etc.)
- *  - raw shapes (Record<string, ZodTypeAny>)
- */
-const primitiveOutputLiteralSchema = zod_1.z.enum(['string', 'number', 'date', 'boolean']);
-const specialOutputLiteralSchema = zod_1.z.enum(['image', 'audio', 'resource', 'resource_link']);
-const outputLiteralSchema = zod_1.z.union([primitiveOutputLiteralSchema, specialOutputLiteralSchema]);
-// Any Zod schema instance (object, array, union, etc.)
-const zodSchemaInstanceSchema = zod_1.z.instanceof(zod_1.z.ZodType);
-// Raw shape: { field: z.string(), ... }
-const zodRawShapeSchema = zod_1.z.record(zod_1.z.string(), zodSchemaInstanceSchema);
-const toolSingleOutputSchema = zod_1.z.union([outputLiteralSchema, zodSchemaInstanceSchema, zodRawShapeSchema]);
-// ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[]
-const toolOutputSchema = zod_1.z.union([toolSingleOutputSchema, zod_1.z.array(toolSingleOutputSchema)]);
-const toolExampleSchema = zod_1.z.object({
-    description: zod_1.z.string(),
-    input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-    output: zod_1.z.unknown().optional(),
-});
-exports.frontMcpToolMetadataSchema = zod_1.z
-    .object({
-    id: zod_1.z.string().optional(),
-    name: zod_1.z.string().min(1),
-    description: zod_1.z.string().optional(),
-    inputSchema: zod_1.z.instanceof(Object),
-    rawInputSchema: zod_1.z.any().optional(),
-    outputSchema: toolOutputSchema.optional(),
-    tags: zod_1.z.array(zod_1.z.string().min(1)).optional(),
-    annotations: mcpToolAnnotationsSchema.optional(),
-    hideFromDiscovery: zod_1.z.boolean().optional().default(false),
-    examples: zod_1.z.array(toolExampleSchema).optional(),
-    ui: zod_1.z.looseObject({}).optional(),
-})
-    .passthrough();
-//# sourceMappingURL=tool.metadata.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/tool.metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\nimport type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\nimport {\n  ImageContentSchema,\n  AudioContentSchema,\n  ResourceLinkSchema,\n  EmbeddedResourceSchema,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { ToolUIConfig } from './tool-ui.metadata';\nimport { ToolInputOf, ToolOutputOf } from '../decorators';\n\ndeclare global {\n  /**\n   * Declarative metadata extends to the an McpTool decorator.\n   */\n  interface ExtendFrontMcpToolMetadata {}\n}\n\n/**\n * Example input/output pair for a tool, used in documentation and describe output.\n */\nexport interface ToolExample {\n  /**\n   * Description of what this example demonstrates.\n   */\n  description: string;\n\n  /**\n   * Example input values for the tool.\n   */\n  input: Record<string, unknown>;\n\n  /**\n   * Optional expected output for the example.\n   */\n  output?: unknown;\n}\n\nexport interface ToolAnnotations {\n  [x: string]: unknown;\n\n  /**\n   * A human-readable title for the tool.\n   */\n  title?: string;\n  /**\n   * If true, the tool does not modify its environment.\n   *\n   * Default: false\n   */\n  readOnlyHint?: boolean;\n  /**\n   * If true, the tool may perform destructive updates to its environment.\n   * If false, the tool performs only additive updates.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: true\n   */\n  destructiveHint?: boolean;\n  /**\n   * If true, calling the tool repeatedly with the same arguments\n   * will have no additional effect on the its environment.\n   *\n   * (This property is meaningful only when `readOnlyHint == false`)\n   *\n   * Default: false\n   */\n  idempotentHint?: boolean;\n  /**\n   * If true, this tool may interact with an \"open world\" of external\n   * entities. If false, the tool's domain of interaction is closed.\n   * For example, the world of a web search tool is open, whereas that\n   * of a memory tool is not.\n   *\n   * Default: true\n   */\n  openWorldHint?: boolean;\n}\n\nconst mcpToolAnnotationsSchema = z\n  .object({\n    title: z.string().optional(),\n    readOnlyHint: z.boolean().optional(),\n    destructiveHint: z.boolean().optional(),\n    idempotentHint: z.boolean().optional(),\n    openWorldHint: z.boolean().optional(),\n  } satisfies RawZodShape<ToolAnnotations>)\n  .passthrough();\n\n/**\n * Tool response type text: include if outputSchema is zod primitive types\n */\ntype PrimitiveOutputType =\n  | 'string'\n  | 'number'\n  | 'date'\n  | 'boolean'\n  | z.ZodString\n  | z.ZodNumber\n  | z.ZodBoolean\n  | z.ZodBigInt\n  | z.ZodDate;\n/**\n * Tool response type image, will use the ImageContentSchema from MCP types\n */\ntype ImageOutputType = 'image';\nexport const ImageOutputSchema = ImageContentSchema;\nexport type ImageOutput = z.output<typeof ImageOutputSchema>;\n\n/**\n * Tool response type audio, will use the AudioContentSchema from MCP types\n */\ntype AudioOutputType = 'audio';\nexport const AudioOutputSchema = AudioContentSchema;\nexport type AudioOutput = z.output<typeof AudioOutputSchema>;\n\n/**\n * Tool response type resource, will use the EmbeddedResourceSchema from MCP types\n */\ntype ResourceOutputType = 'resource';\nexport const ResourceOutputSchema = EmbeddedResourceSchema;\nexport type ResourceOutput = z.output<typeof ResourceOutputSchema>;\n\n/**\n * Tool response type resource_link, will use the ResourceLinkSchema from MCP types\n */\ntype ResourceLinkOutputType = 'resource_link';\nexport const ResourceLinkOutputSchema = ResourceLinkSchema;\nexport type ResourceLinkOutput = z.output<typeof ResourceLinkOutputSchema>;\n\n/**\n * Tool response type json, ZodRawShape for fast usage\n */\ntype StructuredOutputType =\n  | z.ZodRawShape\n  | z.ZodObject<any>\n  | z.ZodArray<z.ZodType>\n  | z.ZodUnion<[z.ZodObject<any>, ...z.ZodObject<any>[]]>\n  | z.ZodDiscriminatedUnion<z.ZodObject<any>[]>;\n\nexport type ToolSingleOutputType =\n  | PrimitiveOutputType\n  | ImageOutputType\n  | AudioOutputType\n  | ResourceOutputType\n  | ResourceLinkOutputType\n  | StructuredOutputType;\n\n/**\n * Default default tool schema is {}\n */\nexport type ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[] | undefined;\nexport type ToolInputType = z.ZodRawShape | z.ZodObject<any>;\n\n/**\n * Declarative metadata describing what an McpTool contributes.\n */\nexport interface ToolMetadata<InSchema = ToolInputType, OutSchema extends ToolOutputType = ToolOutputType>\n  extends ExtendFrontMcpToolMetadata {\n  /**\n   * Optional unique identifier for the tool.\n   * If omitted, a consumer may derive an ID from the class or file name.\n   */\n  id?: string;\n\n  /**\n   * Human‑readable name of the tool, used in UIs, logs, and discovery.\n   */\n  name: string;\n\n  /**\n   * Short summary describing what the tool does and when to use it.\n   */\n  description?: string;\n\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  inputSchema: InSchema;\n  /**\n   * Zod schema describing the expected input payload for the tool.\n   * Used for validation and for generating automatic docs/UX.\n   */\n  rawInputSchema?: JsonSchema;\n\n  /**\n   * Zod schema describing the structure of the tool's successful output.\n   */\n  outputSchema?: OutSchema;\n\n  /**\n   * Optional list of tags/labels that categorize the tool for discovery and filtering.\n   */\n  tags?: string[];\n\n  annotations?: ToolAnnotations;\n\n  /**\n   * If true, the tool will not be shown in the tool/list action results.\n   * this method can still be called directly with tool/call even if hidden.\n   * use case: tools that are intended to be private or internal. (usually for testing / private apis)\n   * Default: false\n   */\n  hideFromDiscovery?: boolean;\n\n  /**\n   * Optional usage examples for the tool.\n   * These are used by codecall:describe to provide accurate usage examples.\n   * If provided, these take precedence over auto-generated examples.\n   */\n  examples?: ToolExample[];\n\n  ui?: ToolUIConfig<ToolInputOf<InSchema>, ToolOutputOf<OutSchema>>;\n}\n\n/**\n * Runtime schema for ToolSingleOutputType:\n *  - literals ('string', 'image', ...)\n *  - any Zod schema (ZodObject, ZodArray, etc.)\n *  - raw shapes (Record<string, ZodTypeAny>)\n */\n\nconst primitiveOutputLiteralSchema = z.enum(['string', 'number', 'date', 'boolean']);\nconst specialOutputLiteralSchema = z.enum(['image', 'audio', 'resource', 'resource_link']);\n\nconst outputLiteralSchema = z.union([primitiveOutputLiteralSchema, specialOutputLiteralSchema]);\n\n// Any Zod schema instance (object, array, union, etc.)\nconst zodSchemaInstanceSchema = z.instanceof(z.ZodType);\n\n// Raw shape: { field: z.string(), ... }\nconst zodRawShapeSchema = z.record(z.string(), zodSchemaInstanceSchema);\n\nconst toolSingleOutputSchema = z.union([outputLiteralSchema, zodSchemaInstanceSchema, zodRawShapeSchema]);\n\n// ToolOutputType = ToolSingleOutputType | ToolSingleOutputType[]\nconst toolOutputSchema = z.union([toolSingleOutputSchema, z.array(toolSingleOutputSchema)]);\nconst toolExampleSchema = z.object({\n  description: z.string(),\n  input: z.record(z.string(), z.unknown()),\n  output: z.unknown().optional(),\n});\n\nexport const frontMcpToolMetadataSchema = z\n  .object({\n    id: z.string().optional(),\n    name: z.string().min(1),\n    description: z.string().optional(),\n    inputSchema: z.instanceof(Object),\n    rawInputSchema: z.any().optional(),\n    outputSchema: toolOutputSchema.optional(),\n    tags: z.array(z.string().min(1)).optional(),\n    annotations: mcpToolAnnotationsSchema.optional(),\n    hideFromDiscovery: z.boolean().optional().default(false),\n    examples: z.array(toolExampleSchema).optional(),\n    ui: z.looseObject({}).optional(),\n  } satisfies RawZodShape<ToolMetadata, ExtendFrontMcpToolMetadata>)\n  .passthrough();\n"]}

package/src/common/migrate/auth-transport.migrate.js

@@ -1,140 +0,0 @@
-"use strict";
-// common/migrate/auth-transport.migrate.ts
-//
-// Migration helper for auth.transport -> transport config
-//
-// This file handles backward compatibility for the old config structure.
-// DELETE THIS FILE when removing deprecated support (target: v1.0.0)
-//
-// Migration performed:
-// 1. auth.transport -> transport (top-level)
-// 2. session -> transport (merged)
-// 3. auth.transport.recreation.redis -> redis (top-level, if not already set)
-// 4. auth.tokenStorage.config -> references top-level redis
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetDeprecationWarning = resetDeprecationWarning;
-exports.needsMigration = needsMigration;
-exports.migrateAuthTransportConfig = migrateAuthTransportConfig;
-exports.applyMigration = applyMigration;
-let deprecationWarningShown = false;
-/**
- * Show deprecation warning once per process
- */
-function showDeprecationWarning(hasOldTransport, hasOldSession) {
-    if (deprecationWarningShown) {
-        return;
-    }
-    deprecationWarningShown = true;
-    const warnings = [];
-    if (hasOldTransport) {
-        warnings.push('  - auth.transport is deprecated, use top-level "transport" instead');
-    }
-    if (hasOldSession) {
-        warnings.push('  - session is deprecated, merge into top-level "transport" instead');
-    }
-    console.warn('\n[DEPRECATION WARNING] FrontMCP config structure has changed:\n' +
-        warnings.join('\n') +
-        '\n  - For Redis config, use top-level "redis" instead\n' +
-        '\nSee documentation: https://docs.agentfront.dev/docs/servers/server\n');
-}
-/**
- * Reset deprecation warning flag (for testing)
- */
-function resetDeprecationWarning() {
-    deprecationWarningShown = false;
-}
-/**
- * Check if config needs migration
- */
-function needsMigration(metadata) {
-    const hasOldTransport = !!(metadata.auth && 'transport' in metadata.auth && metadata.auth.transport);
-    const hasOldSession = !!metadata.session;
-    return hasOldTransport || hasOldSession;
-}
-/**
- * Migrate old config structure to new structure
- *
- * Returns the migrated values that should be applied to the metadata
- */
-function migrateAuthTransportConfig(metadata) {
-    const result = {};
-    const hasOldTransport = !!(metadata.auth && 'transport' in metadata.auth && metadata.auth.transport);
-    const hasOldSession = !!metadata.session;
-    if (!hasOldTransport && !hasOldSession) {
-        return result;
-    }
-    // Show deprecation warning
-    showDeprecationWarning(hasOldTransport, hasOldSession);
-    // Start with existing transport config if present
-    result.transport = { ...metadata.transport };
-    // Migrate session config
-    if (hasOldSession) {
-        const session = metadata.session;
-        result.transport = {
-            ...result.transport,
-            sessionMode: session.sessionMode,
-            transportIdMode: session.transportIdMode,
-            platformDetection: session.platformDetection,
-        };
-    }
-    // Migrate auth.transport config
-    if (hasOldTransport) {
-        const oldTransport = metadata.auth.transport;
-        // Merge transport protocol settings
-        result.transport = {
-            ...result.transport,
-            enableLegacySSE: oldTransport.enableLegacySSE ?? result.transport.enableLegacySSE,
-            enableSseListener: oldTransport.enableSseListener ?? result.transport.enableSseListener,
-            enableStreamableHttp: oldTransport.enableStreamableHttp ?? result.transport.enableStreamableHttp,
-            enableStatelessHttp: oldTransport.enableStatelessHttp ?? result.transport.enableStatelessHttp,
-            enableStatefulHttp: oldTransport.enableStatefulHttp ?? result.transport.enableStatefulHttp,
-            requireSessionForStreamable: oldTransport.requireSessionForStreamable ?? result.transport.requireSessionForStreamable,
-        };
-        // Migrate recreation -> persistence
-        if (oldTransport.recreation) {
-            result.transport.persistence = {
-                enabled: oldTransport.recreation.enabled ?? false,
-                redis: oldTransport.recreation.redis,
-                defaultTtlMs: oldTransport.recreation.defaultTtlMs,
-            };
-            // Extract Redis config to top-level if not already present
-            if (oldTransport.recreation.redis && !metadata.redis) {
-                result.redis = oldTransport.recreation.redis;
-            }
-        }
-        // Create clean auth without transport
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const { transport: _, ...cleanAuth } = metadata.auth;
-        result.auth = cleanAuth;
-    }
-    return result;
-}
-/**
- * Apply migration to metadata (mutates in place for decorator use)
- *
- * This function takes a metadata object with the old config structure
- * and transforms it to the new structure in place.
- */
-function applyMigration(metadata) {
-    if (!needsMigration(metadata)) {
-        return metadata;
-    }
-    const migrated = migrateAuthTransportConfig(metadata);
-    // Apply migrated transport config
-    if (migrated.transport) {
-        metadata['transport'] = {
-            ...metadata.transport,
-            ...migrated.transport,
-        };
-    }
-    // Apply migrated redis config
-    if (migrated.redis) {
-        metadata['redis'] = migrated.redis;
-    }
-    // Apply cleaned auth config (without transport)
-    if (migrated.auth) {
-        metadata.auth = migrated.auth;
-    }
-    return metadata;
-}
-//# sourceMappingURL=auth-transport.migrate.js.map

package/src/common/migrate/auth-transport.migrate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-transport.migrate.js","sourceRoot":"","sources":["../../../../src/common/migrate/auth-transport.migrate.ts"],"names":[],"mappings":"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","sourcesContent":["// common/migrate/auth-transport.migrate.ts\n//\n// Migration helper for auth.transport -> transport config\n//\n// This file handles backward compatibility for the old config structure.\n// DELETE THIS FILE when removing deprecated support (target: v1.0.0)\n//\n// Migration performed:\n// 1. auth.transport -> transport (top-level)\n// 2. session -> transport (merged)\n// 3. auth.transport.recreation.redis -> redis (top-level, if not already set)\n// 4. auth.tokenStorage.config -> references top-level redis\n\nimport type { TransportOptionsInput } from '../types/options/transport.options';\nimport type { RedisOptionsInput } from '../types/options/redis.options';\nimport type { SessionOptions } from '../types/options/session.options';\n\n/**\n * Old transport config structure (nested under auth)\n */\ninterface OldTransportConfig {\n  enableLegacySSE?: boolean;\n  enableSseListener?: boolean;\n  enableStreamableHttp?: boolean;\n  enableStatelessHttp?: boolean;\n  enableStatefulHttp?: boolean;\n  requireSessionForStreamable?: boolean;\n  recreation?: {\n    enabled?: boolean;\n    redis?: RedisOptionsInput;\n    defaultTtlMs?: number;\n  };\n}\n\n/**\n * Old auth config structure (with nested transport)\n */\ninterface OldAuthConfig {\n  mode: string;\n  transport?: OldTransportConfig;\n  [key: string]: unknown;\n}\n\n/**\n * Metadata structure for migration\n */\ninterface MigratableMetadata {\n  auth?: OldAuthConfig;\n  session?: SessionOptions;\n  transport?: TransportOptionsInput;\n  redis?: RedisOptionsInput;\n}\n\nlet deprecationWarningShown = false;\n\n/**\n * Show deprecation warning once per process\n */\nfunction showDeprecationWarning(hasOldTransport: boolean, hasOldSession: boolean): void {\n  if (deprecationWarningShown) {\n    return;\n  }\n  deprecationWarningShown = true;\n\n  const warnings: string[] = [];\n  if (hasOldTransport) {\n    warnings.push('  - auth.transport is deprecated, use top-level \"transport\" instead');\n  }\n  if (hasOldSession) {\n    warnings.push('  - session is deprecated, merge into top-level \"transport\" instead');\n  }\n\n  console.warn(\n    '\\n[DEPRECATION WARNING] FrontMCP config structure has changed:\\n' +\n      warnings.join('\\n') +\n      '\\n  - For Redis config, use top-level \"redis\" instead\\n' +\n      '\\nSee documentation: https://docs.agentfront.dev/docs/servers/server\\n',\n  );\n}\n\n/**\n * Reset deprecation warning flag (for testing)\n */\nexport function resetDeprecationWarning(): void {\n  deprecationWarningShown = false;\n}\n\n/**\n * Check if config needs migration\n */\nexport function needsMigration(metadata: MigratableMetadata): boolean {\n  const hasOldTransport = !!(metadata.auth && 'transport' in metadata.auth && metadata.auth.transport);\n  const hasOldSession = !!metadata.session;\n  return hasOldTransport || hasOldSession;\n}\n\n/**\n * Migrate old config structure to new structure\n *\n * Returns the migrated values that should be applied to the metadata\n */\nexport function migrateAuthTransportConfig(metadata: MigratableMetadata): {\n  transport?: TransportOptionsInput;\n  redis?: RedisOptionsInput;\n  auth?: OldAuthConfig;\n} {\n  const result: {\n    transport?: TransportOptionsInput;\n    redis?: RedisOptionsInput;\n    auth?: OldAuthConfig;\n  } = {};\n\n  const hasOldTransport = !!(metadata.auth && 'transport' in metadata.auth && metadata.auth.transport);\n  const hasOldSession = !!metadata.session;\n\n  if (!hasOldTransport && !hasOldSession) {\n    return result;\n  }\n\n  // Show deprecation warning\n  showDeprecationWarning(hasOldTransport, hasOldSession);\n\n  // Start with existing transport config if present\n  result.transport = { ...metadata.transport };\n\n  // Migrate session config\n  if (hasOldSession) {\n    const session = metadata.session!;\n    result.transport = {\n      ...result.transport,\n      sessionMode: session.sessionMode,\n      transportIdMode: session.transportIdMode,\n      platformDetection: session.platformDetection,\n    };\n  }\n\n  // Migrate auth.transport config\n  if (hasOldTransport) {\n    const oldTransport = metadata.auth!.transport!;\n\n    // Merge transport protocol settings\n    result.transport = {\n      ...result.transport,\n      enableLegacySSE: oldTransport.enableLegacySSE ?? result.transport.enableLegacySSE,\n      enableSseListener: oldTransport.enableSseListener ?? result.transport.enableSseListener,\n      enableStreamableHttp: oldTransport.enableStreamableHttp ?? result.transport.enableStreamableHttp,\n      enableStatelessHttp: oldTransport.enableStatelessHttp ?? result.transport.enableStatelessHttp,\n      enableStatefulHttp: oldTransport.enableStatefulHttp ?? result.transport.enableStatefulHttp,\n      requireSessionForStreamable:\n        oldTransport.requireSessionForStreamable ?? result.transport.requireSessionForStreamable,\n    };\n\n    // Migrate recreation -> persistence\n    if (oldTransport.recreation) {\n      result.transport.persistence = {\n        enabled: oldTransport.recreation.enabled ?? false,\n        redis: oldTransport.recreation.redis,\n        defaultTtlMs: oldTransport.recreation.defaultTtlMs,\n      };\n\n      // Extract Redis config to top-level if not already present\n      if (oldTransport.recreation.redis && !metadata.redis) {\n        result.redis = oldTransport.recreation.redis;\n      }\n    }\n\n    // Create clean auth without transport\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { transport: _, ...cleanAuth } = metadata.auth!;\n    result.auth = cleanAuth as OldAuthConfig;\n  }\n\n  return result;\n}\n\n/**\n * Apply migration to metadata (mutates in place for decorator use)\n *\n * This function takes a metadata object with the old config structure\n * and transforms it to the new structure in place.\n */\nexport function applyMigration<T extends MigratableMetadata>(metadata: T): T {\n  if (!needsMigration(metadata)) {\n    return metadata;\n  }\n\n  const migrated = migrateAuthTransportConfig(metadata);\n\n  // Apply migrated transport config\n  if (migrated.transport) {\n    (metadata as Record<string, unknown>)['transport'] = {\n      ...metadata.transport,\n      ...migrated.transport,\n    };\n  }\n\n  // Apply migrated redis config\n  if (migrated.redis) {\n    (metadata as Record<string, unknown>)['redis'] = migrated.redis;\n  }\n\n  // Apply cleaned auth config (without transport)\n  if (migrated.auth) {\n    metadata.auth = migrated.auth;\n  }\n\n  return metadata;\n}\n"]}

package/src/common/migrate/index.js

@@ -1,6 +0,0 @@
-"use strict";
-// common/migrate/index.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./auth-transport.migrate"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/migrate/index.ts"],"names":[],"mappings":";AAAA,0BAA0B;;;AAE1B,mEAAyC","sourcesContent":["// common/migrate/index.ts\n\nexport * from './auth-transport.migrate';\n"]}

package/src/common/providers/base-config.provider.js

@@ -1,128 +0,0 @@
-"use strict";
-// file: libs/sdk/src/common/providers/base-config.provider.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseConfig = void 0;
-/**
- * Base configuration provider with type-safe path lookup and convict-like API
- */
-class BaseConfig {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Get the complete configuration object
-     */
-    getAll() {
-        return this.config;
-    }
-    get(path, defaultValue) {
-        const keys = path.split('.');
-        let result = this.config;
-        for (const key of keys) {
-            if (result && typeof result === 'object' && key in result) {
-                result = result[key];
-            }
-            else {
-                return defaultValue !== undefined ? defaultValue : undefined;
-            }
-        }
-        const value = result;
-        return value !== undefined
-            ? value
-            : defaultValue !== undefined
-                ? defaultValue
-                : undefined;
-    }
-    /**
-     * Check if a path exists in the configuration
-     * @example
-     * config.has('vm.preset') // returns true
-     * config.has('nonexistent.path') // returns false
-     */
-    has(path) {
-        const keys = path.split('.');
-        let result = this.config;
-        for (const key of keys) {
-            if (result && typeof result === 'object' && key in result) {
-                result = result[key];
-            }
-            else {
-                return false;
-            }
-        }
-        return result !== undefined;
-    }
-    /**
-     * Get a value with a default fallback
-     * @example
-     * config.getOrDefault('vm.timeout', 5000)
-     */
-    getOrDefault(path, defaultValue) {
-        const value = this.get(path);
-        return value !== undefined ? value : defaultValue;
-    }
-    /**
-     * Get a required value (throws if undefined)
-     * @example
-     * config.getRequired('vm.preset')
-     * config.getOrThrow('vm.preset')
-     */
-    getRequired(path) {
-        const value = this.get(path);
-        if (value === undefined) {
-            throw new Error(`Required configuration path "${path}" is undefined`);
-        }
-        return value;
-    }
-    /**
-     * Alias for getRequired - Get a required value (throws if undefined)
-     * @example
-     * config.getOrThrow('vm.preset')
-     */
-    getOrThrow(path) {
-        return this.getRequired(path);
-    }
-    /**
-     * Get a nested object at a path
-     * @example
-     * config.getSection('vm') // returns entire vm config
-     */
-    getSection(section) {
-        return this.config[section];
-    }
-    /**
-     * Check if the configuration matches a specific value at a path
-     * @example
-     * config.matches('vm.preset', 'secure') // returns true/false
-     */
-    matches(path, value) {
-        return this.get(path) === value;
-    }
-    /**
-     * Get multiple values at once
-     * @example
-     * config.getMany(['vm.preset', 'embedding.strategy', 'topK'])
-     */
-    getMany(paths) {
-        const result = {};
-        for (const path of paths) {
-            result[path] = this.get(path);
-        }
-        return result;
-    }
-    /**
-     * Convert configuration to JSON
-     */
-    toJSON() {
-        return this.config;
-    }
-    /**
-     * Convert configuration to string
-     */
-    toString() {
-        return JSON.stringify(this.config, null, 2);
-    }
-}
-exports.BaseConfig = BaseConfig;
-//# sourceMappingURL=base-config.provider.js.map

package/src/common/providers/base-config.provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-config.provider.js","sourceRoot":"","sources":["../../../../src/common/providers/base-config.provider.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/common/providers/base-config.provider.ts\n\n/**\n * Type-safe dotted path builder for nested object access\n * Examples: 'vm.preset', 'embedding.strategy', 'directCalls.enabled'\n */\nexport type DottedPath<T, Prefix extends string = ''> = T extends object\n  ? {\n      [K in keyof T & string]: T[K] extends object\n        ? `${Prefix}${K}` | DottedPath<T[K], `${Prefix}${K}.`>\n        : `${Prefix}${K}`;\n    }[keyof T & string]\n  : never;\n\n/**\n * Get the type at a dotted path\n */\nexport type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}`\n  ? Key extends keyof T\n    ? PathValue<T[Key], Rest>\n    : never\n  : P extends keyof T\n  ? T[P]\n  : never;\n\n/**\n * Base configuration provider with type-safe path lookup and convict-like API\n */\nexport abstract class BaseConfig<TConfig extends object> {\n  protected readonly config: TConfig;\n\n  constructor(config: TConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Get the complete configuration object\n   */\n  getAll(): TConfig {\n    return this.config;\n  }\n\n  /**\n   * Get a value using dotted path notation (convict-like)\n   * @example\n   * config.get('vm.preset') // returns 'secure'\n   * config.get('embedding.strategy') // returns 'tfidf'\n   * config.get('directCalls.enabled') // returns true\n   * config.get('vm.timeout', 5000) // returns value or 5000 if undefined\n   */\n  get<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P>;\n  get<P extends DottedPath<TConfig>>(path: P, defaultValue: PathValue<TConfig, P>): PathValue<TConfig, P>;\n  get<P extends DottedPath<TConfig>>(path: P, defaultValue?: PathValue<TConfig, P>): PathValue<TConfig, P> {\n    const keys = (path as string).split('.');\n    let result: any = this.config;\n\n    for (const key of keys) {\n      if (result && typeof result === 'object' && key in result) {\n        result = result[key];\n      } else {\n        return defaultValue !== undefined ? defaultValue : (undefined as PathValue<TConfig, P>);\n      }\n    }\n\n    const value = result as PathValue<TConfig, P>;\n    return value !== undefined\n      ? value\n      : defaultValue !== undefined\n      ? defaultValue\n      : (undefined as PathValue<TConfig, P>);\n  }\n\n  /**\n   * Check if a path exists in the configuration\n   * @example\n   * config.has('vm.preset') // returns true\n   * config.has('nonexistent.path') // returns false\n   */\n  has(path: string): boolean {\n    const keys = path.split('.');\n    let result: any = this.config;\n\n    for (const key of keys) {\n      if (result && typeof result === 'object' && key in result) {\n        result = result[key];\n      } else {\n        return false;\n      }\n    }\n\n    return result !== undefined;\n  }\n\n  /**\n   * Get a value with a default fallback\n   * @example\n   * config.getOrDefault('vm.timeout', 5000)\n   */\n  getOrDefault<P extends DottedPath<TConfig>>(path: P, defaultValue: PathValue<TConfig, P>): PathValue<TConfig, P> {\n    const value = this.get(path);\n    return value !== undefined ? value : defaultValue;\n  }\n\n  /**\n   * Get a required value (throws if undefined)\n   * @example\n   * config.getRequired('vm.preset')\n   * config.getOrThrow('vm.preset')\n   */\n  getRequired<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P> {\n    const value = this.get(path);\n    if (value === undefined) {\n      throw new Error(`Required configuration path \"${path}\" is undefined`);\n    }\n    return value;\n  }\n\n  /**\n   * Alias for getRequired - Get a required value (throws if undefined)\n   * @example\n   * config.getOrThrow('vm.preset')\n   */\n  getOrThrow<P extends DottedPath<TConfig>>(path: P): PathValue<TConfig, P> {\n    return this.getRequired(path);\n  }\n\n  /**\n   * Get a nested object at a path\n   * @example\n   * config.getSection('vm') // returns entire vm config\n   */\n  getSection<K extends keyof TConfig>(section: K): TConfig[K] {\n    return this.config[section];\n  }\n\n  /**\n   * Check if the configuration matches a specific value at a path\n   * @example\n   * config.matches('vm.preset', 'secure') // returns true/false\n   */\n  matches<P extends DottedPath<TConfig>>(path: P, value: PathValue<TConfig, P>): boolean {\n    return this.get(path) === value;\n  }\n\n  /**\n   * Get multiple values at once\n   * @example\n   * config.getMany(['vm.preset', 'embedding.strategy', 'topK'])\n   */\n  getMany<P extends DottedPath<TConfig>>(paths: P[]): Record<P, PathValue<TConfig, P>> {\n    const result = {} as Record<P, PathValue<TConfig, P>>;\n    for (const path of paths) {\n      result[path] = this.get(path);\n    }\n    return result;\n  }\n\n  /**\n   * Convert configuration to JSON\n   */\n  toJSON(): TConfig {\n    return this.config;\n  }\n\n  /**\n   * Convert configuration to string\n   */\n  toString(): string {\n    return JSON.stringify(this.config, null, 2);\n  }\n}\n"]}