@frontmcp/sdk 0.1.0

package/src/metadata/front-mcp.metadata.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frontMcpMetadataSchema = exports.frontMcpBaseSchema = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../types");
+const schemas_1 = require("../schemas");
+exports.frontMcpBaseSchema = zod_1.z.object({
+    info: types_1.serverInfoOptionsSchema,
+    providers: zod_1.z.array(schemas_1.annotatedFrontMcpProvidersSchema).optional().default([]),
+    apps: zod_1.z.array(schemas_1.annotatedFrontMcpAppSchema),
+    serve: zod_1.z.boolean().optional().default(true),
+    http: types_1.httpOptionsSchema.optional().default({}),
+    session: types_1.sessionOptionsSchema.optional().default({}),
+    logging: types_1.loggingOptionsSchema.optional().default({}),
+});
+const frontMcpMultiAppSchema = exports.frontMcpBaseSchema.extend({
+    splitByApp: zod_1.z.literal(false).default(false).describe('If true, each app gets its own scope & basePath.'),
+    auth: types_1.authOptionsSchema.optional().describe('Configures the server\'s default authentication provider.'),
+});
+const frontMcpSplitByAppSchema = exports.frontMcpBaseSchema.extend({
+    splitByApp: zod_1.z.literal(true).describe('If false, apps are grouped under the same scope & basePath.'),
+    auth: zod_1.z.never().optional(),
+});
+exports.frontMcpMetadataSchema = frontMcpMultiAppSchema.or(frontMcpSplitByAppSchema);
+//# sourceMappingURL=front-mcp.metadata.js.map

package/src/metadata/front-mcp.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-mcp.metadata.js","sourceRoot":"","sources":["../../../src/metadata/front-mcp.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AACtB,oCAYkB;AAClB,wCAGoB;AAqBP,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,+BAAuB;IAC7B,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,0CAAgC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3E,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,oCAA0B,CAAC;IACzC,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3C,IAAI,EAAE,yBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACT,CAAC,CAAC;AAQ/C,MAAM,sBAAsB,GAAG,0BAAkB,CAAC,MAAM,CAAC;IACvD,UAAU,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACxG,IAAI,EAAE,yBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;CACnC,CAAC,CAAC;AAQzE,MAAM,wBAAwB,GAAG,0BAAkB,CAAC,MAAM,CAAC;IACzD,UAAU,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACnG,IAAI,EAAE,OAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;CAC6C,CAAC,CAAC;AAK9D,QAAA,sBAAsB,GAAG,sBAAsB,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\nimport {\n  AuthOptions,\n  authOptionsSchema,\n  SessionOptions,\n  sessionOptionsSchema,\n  ServerInfoOptions,\n  serverInfoOptionsSchema,\n  HttpOptions,\n  httpOptionsSchema,\n  LoggingOptions,\n  loggingOptionsSchema,\n  RawZodShape,\n} from '../types';\nimport {\n  annotatedFrontMcpAppSchema,\n  annotatedFrontMcpProvidersSchema,\n} from '../schemas';\nimport {AppType, ProviderType} from '../interfaces';\n\n\nexport interface FrontMcpBaseMetadata {\n  info: ServerInfoOptions;\n  apps: AppType[];\n  http?: HttpOptions;\n  session?: SessionOptions;\n  logging?: LoggingOptions;\n\n  serve?: boolean; // default to true\n\n  /**\n   * Additional providers that are available to all apps.\n   */\n  providers?: ProviderType[];\n\n\n}\n\nexport const frontMcpBaseSchema = z.object({\n  info: serverInfoOptionsSchema,\n  providers: z.array(annotatedFrontMcpProvidersSchema).optional().default([]),\n  apps: z.array(annotatedFrontMcpAppSchema),\n  serve: z.boolean().optional().default(true),\n  http: httpOptionsSchema.optional().default({}),\n  session: sessionOptionsSchema.optional().default({}),\n  logging: loggingOptionsSchema.optional().default({}),\n} satisfies RawZodShape<FrontMcpBaseMetadata>);\n\n\nexport interface FrontMcpMultiAppMetadata extends FrontMcpBaseMetadata {\n  splitByApp?: false;\n  auth?: AuthOptions;\n}\n\nconst frontMcpMultiAppSchema = frontMcpBaseSchema.extend({\n  splitByApp: z.literal(false).default(false).describe('If true, each app gets its own scope & basePath.'),\n  auth: authOptionsSchema.optional().describe('Configures the server\\'s default authentication provider.'),\n} satisfies RawZodShape<FrontMcpMultiAppMetadata, FrontMcpBaseMetadata>);\n\n\nexport interface FrontMcpSplitByAppMetadata extends FrontMcpBaseMetadata {\n  splitByApp: true;\n  auth?: never;\n}\n\nconst frontMcpSplitByAppSchema = frontMcpBaseSchema.extend({\n  splitByApp: z.literal(true).describe('If false, apps are grouped under the same scope & basePath.'),\n  auth: z.never().optional(),\n} satisfies RawZodShape<FrontMcpSplitByAppMetadata, FrontMcpBaseMetadata>);\n\n\nexport type FrontMcpMetadata = FrontMcpMultiAppMetadata | FrontMcpSplitByAppMetadata;\n\nexport const frontMcpMetadataSchema = frontMcpMultiAppSchema.or(frontMcpSplitByAppSchema);\n\nexport type FrontMcpMultiAppConfig = z.infer<typeof frontMcpMultiAppSchema>;\nexport type FrontMcpSplitByAppConfig = z.infer<typeof frontMcpSplitByAppSchema>;\n\n\nexport type FrontMcpConfigType = z.infer<typeof frontMcpMetadataSchema>;\n\nexport interface AppScopeMetadata extends Omit<FrontMcpSplitByAppMetadata, 'auth' | 'splitByApp'> {\n  id: string;\n  apps: [AppType];\n  auth?: AuthOptions;\n}\n\nexport interface MultiAppScopeMetadata extends FrontMcpMultiAppMetadata {\n  id: string;\n  apps: AppType[];\n}\n\nexport type ScopeMetadata = AppScopeMetadata | MultiAppScopeMetadata;\n"]}

package/src/metadata/index.d.ts

@@ -0,0 +1,12 @@
+export * from './front-mcp.metadata';
+export * from './flow.metadata';
+export * from './flow-hooks.metadata';
+export * from './app.metadata';
+export * from './provider.metadata';
+export * from './auth-provider.metadata';
+export * from './adapter.metadata';
+export * from './plugin.metadata';
+export * from './tool.metadata';
+export * from './resource.metadata';
+export * from './prompt.metadata';
+export * from './logger.metadata';

package/src/metadata/index.js

@@ -0,0 +1,16 @@
+"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("./flow-hooks.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("./resource.metadata"), exports);
+tslib_1.__exportStar(require("./prompt.metadata"), exports);
+tslib_1.__exportStar(require("./logger.metadata"), exports);
+//# sourceMappingURL=index.js.map

package/src/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/metadata/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,0DAAgC;AAChC,gEAAsC;AACtC,yDAA+B;AAC/B,8DAAoC;AACpC,mEAAyC;AACzC,6DAAmC;AACnC,4DAAkC;AAClC,0DAAgC;AAChC,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC","sourcesContent":["export * from './front-mcp.metadata';\nexport * from './flow.metadata';\nexport * from './flow-hooks.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 './resource.metadata';\nexport * from './prompt.metadata';\nexport * from './logger.metadata';\n"]}

package/src/metadata/logger.metadata.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+declare global {
+    /**
+     * Declarative metadata extends to an FrontMcpLogger decorator.
+     */
+    export interface ExtendFrontMcpLoggerMetadata {
+    }
+}
+/**
+ * Declarative metadata describing what a FrontMcpLogger contributes.
+ */
+export interface LogTransportMetadata extends ExtendFrontMcpLoggerMetadata {
+    /**
+     * Optional unique identifier for the logger.
+     * If omitted, a consumer may derive an ID from the class or file name.
+     */
+    id?: string;
+    /**
+     * Human‑readable name of the logger, used in UIs, logs, and discovery.
+     */
+    name: string;
+    /**
+     * Short summary describing what the logger does and when to use it.
+     */
+    description?: string;
+}
+export declare const frontMcpLogTransportMetadataSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;

package/src/metadata/logger.metadata.js

@@ -0,0 +1,10 @@
+"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/metadata/logger.metadata.js.map

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

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { ProviderType, PluginType, AdapterType, ToolType, ResourceType, PromptType } from '../interfaces';
+/**
+ * Declarative metadata describing what an McpPlugin contributes at app scope.
+ */
+export interface PluginMetadata {
+    /**
+     * Human-friendly name for this app as shown in UIs, logs, and describe reports.
+     * Keep it short, stable, and unique within a gateway (consider prefixes).
+     */
+    id?: string;
+    /**
+     * Human-friendly name for this app as shown in UIs, logs, and describe reports.
+     * Keep it short, stable, and unique within a gateway (consider prefixes).
+     */
+    name: string;
+    /**
+     * Optional longer explanation of what the app does and what it exposes.
+     * Used for documentation, describe reports, and UIs. Avoid secrets/PII.
+     */
+    description?: string;
+    /**
+     * Plugin-scoped providers Named singleton (or scoped-singleton) dependencies used by tools/plugins at runtime
+     * — e.g., config, database pools, Redis clients, queues, KMS.
+     *
+     * Resolution is hierarchical (tool → app → gateway). Providers may depend on
+     * other providers and are usually initialized lazily on first use.
+     */
+    providers?: ProviderType[];
+    /**
+     * Plugin can export providers to be used in the host app or other plugins,
+     * e.g. for AuthPlugin can export AuthSession to be used in other plugins / apps.
+     *
+     * Resolution is hierarchical (tool → app → gateway). Providers may depend on
+     * other providers and are usually initialized lazily on first use.
+     */
+    exports?: ProviderType[];
+    /**
+     * Plugin-scoped plugins that participate in lifecycle events and can contribute
+     * additional capabilities (tools, resources, prompts, providers, adapters).
+     * Use plugins to enforce policy, auth, PII reduction, tracing, etc.
+     */
+    plugins?: PluginType[];
+    /**
+     * Plugin-scoped Adapters attached to this app that convert external definitions or sources
+     * (e.g., OpenAPI, Lambda, Custom) into generated tools/resources/prompts.
+     * Common options include include/exclude filters, name prefixes, base URLs,
+     * and authentication (often provided by plugins).
+     */
+    adapters?: AdapterType[];
+    /**
+     * Plugin-scoped Inline tools authored by this app (via builder or class). These are active
+     * actions with input/output schemas that the model can call. Tools generated
+     * by adapters do not need to be listed here.
+     */
+    tools?: ToolType[];
+    resources?: ResourceType[];
+    prompts?: PromptType[];
+}
+export declare const frontMcpPluginMetadataSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    providers: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    exports: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    adapters: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    prompts: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    providers: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    exports: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    adapters: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    prompts: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    providers: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    exports: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    adapters: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+    prompts: z.ZodOptional<z.ZodArray<z.ZodType<import("../interfaces").Type<unknown>, z.ZodTypeDef, import("../interfaces").Type<unknown>>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;

package/src/metadata/plugin.metadata.js

@@ -0,0 +1,18 @@
+"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/metadata/plugin.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.metadata.js","sourceRoot":"","sources":["../../../src/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/metadata/prompt.metadata.d.ts

@@ -0,0 +1,226 @@
+import { z } from 'zod';
+import { Icon } from '@modelcontextprotocol/sdk/types.js';
+declare global {
+    /**
+     * Declarative metadata extends to McpPrompt decorator.
+     */
+    export interface ExtendFrontMcpPromptMetadata {
+    }
+}
+interface PromptArgument {
+    /**
+     * The name of the argument.
+     */
+    name: string;
+    /**
+     * A human-readable description of the argument.
+     */
+    description?: string;
+    /**
+     * Whether this argument must be provided.
+     */
+    required?: boolean;
+}
+/**
+ * A known resource that the server is capable of reading.
+ */
+export interface FrontMcpPromptMetadata extends ExtendFrontMcpPromptMetadata {
+    /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+    name: string;
+    /**
+     * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+     * even by those unfamiliar with domain-specific terminology.
+     *
+     * If not provided, the name should be used for display (except for Tool,
+     * where `annotations.title` should be given precedence over using `name`,
+     * if present).
+     */
+    title?: string;
+    /**
+     * A description of what this resource represents.
+     *
+     * 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.
+     */
+    description?: string;
+    /**
+     * A list of arguments to use for templating the prompt.
+     */
+    arguments: PromptArgument[];
+    /**
+     * A list of icons that can be used to represent this resource template.
+     */
+    icons?: Icon[];
+}
+export declare const frontMcpPromptMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /**
+         * The name of the argument.
+         */
+        name: z.ZodString;
+        /**
+         * A human-readable description of the argument.
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether this argument must be provided.
+         */
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        src: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        sizes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export { FrontMcpPromptMetadata as PromptMetadata, };

package/src/metadata/prompt.metadata.js

@@ -0,0 +1,27 @@
+"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/metadata/prompt.metadata.js.map

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

package/src/metadata/provider.metadata.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Declarative metadata describing what a FrontMcpProvider contributes at app scope.
+ */
+export interface ProviderMetadata {
+    id?: string;
+    name: string;
+    description?: string;
+    scope?: ProviderScope;
+}
+/**
+ * Provider lifetime scope semantics.
+ */
+export declare enum ProviderScope {
+    GLOBAL = "global",
+    SESSION = "session",
+    REQUEST = "request"
+}
+export declare const frontMcpProviderMetadataSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof ProviderScope>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof ProviderScope>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof ProviderScope>>>;
+}, z.ZodTypeAny, "passthrough">>;

package/src/metadata/provider.metadata.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frontMcpProviderMetadataSchema = exports.ProviderScope = void 0;
+const zod_1 = require("zod");
+/**
+ * Provider lifetime scope semantics.
+ */
+var ProviderScope;
+(function (ProviderScope) {
+    ProviderScope["GLOBAL"] = "global";
+    ProviderScope["SESSION"] = "session";
+    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/metadata/provider.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.metadata.js","sourceRoot":"","sources":["../../../src/metadata/provider.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAcxB;;GAEG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;AACrB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAEY,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,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,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { z } from 'zod';\nimport { RawZodShape } from '../types';\n\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 */\nexport enum ProviderScope {\n  GLOBAL = 'global',\n  SESSION = 'session',\n  REQUEST = 'request',\n}\n\nexport const frontMcpProviderMetadataSchema = z.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>).passthrough();\n\n"]}