@frontmcp/sdk 0.6.0 → 0.6.1

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

@@ -13,6 +13,7 @@ exports.frontMcpBaseSchema = zod_1.z.object({
     serve: zod_1.z.boolean().optional().default(true),
     http: types_1.httpOptionsSchema.optional(),
     redis: types_1.redisOptionsSchema.optional(),
+    pubsub: types_1.pubsubOptionsSchema.optional(),
     transport: types_1.transportOptionsSchema.optional().transform((val) => val ?? types_1.transportOptionsSchema.parse({})),
     session: types_1.sessionOptionsSchema.optional(), // @deprecated - kept for backward compatibility
     logging: types_1.loggingOptionsSchema.optional(),

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

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/front-mcp.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oCAiBkB;AAClB,wCAKoB;AA+CP,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,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sCAA4B,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,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;IAClC,KAAK,EAAE,0BAAkB,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,8BAAsB,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,8BAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE,EAAE,gDAAgD;IAC1F,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE;CACG,CAAC,CAAC;AAO/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,0DAA0D,CAAC;CAClC,CAAC,CAAC;AAOzE,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;AAI9D,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  AuthOptionsInput,\n  RedisOptionsInput,\n  redisOptionsSchema,\n  TransportOptionsInput,\n  transportOptionsSchema,\n} from '../types';\nimport {\n  annotatedFrontMcpAppSchema,\n  annotatedFrontMcpProvidersSchema,\n  annotatedFrontMcpResourcesSchema,\n  annotatedFrontMcpToolsSchema,\n} from '../schemas';\nimport { AppType, ProviderType, ResourceType, ToolType } from '../interfaces';\n\nexport interface FrontMcpBaseMetadata {\n  info: ServerInfoOptions;\n  apps: AppType[];\n  http?: HttpOptions;\n  logging?: LoggingOptions;\n\n  serve?: boolean; // default to true\n\n  /**\n   * Shared Redis configuration\n   * Used by transport persistence and auth token storage\n   */\n  redis?: RedisOptionsInput;\n\n  /**\n   * Transport and session lifecycle configuration\n   * Controls transport protocols, session management, and persistence\n   * @default {} (all transport options use their schema defaults)\n   */\n  transport?: TransportOptionsInput; // Optional in input, but always defined in output\n\n  /**\n   * @deprecated Use `transport` instead. Session config has been merged into transport.\n   */\n  session?: SessionOptions;\n\n  /**\n   * Additional providers that are available to all apps.\n   */\n  providers?: ProviderType[];\n\n  /**\n   * Shared tools that are available to all apps.\n   * These are merged (additively) with app-specific tools.\n   */\n  tools?: ToolType[];\n\n  /**\n   * Shared resources that are available to all apps.\n   * These are merged (additively) with app-specific resources.\n   */\n  resources?: ResourceType[];\n}\n\nexport const frontMcpBaseSchema = z.object({\n  info: serverInfoOptionsSchema,\n  providers: z.array(annotatedFrontMcpProvidersSchema).optional().default([]),\n  tools: z.array(annotatedFrontMcpToolsSchema).optional().default([]),\n  resources: z.array(annotatedFrontMcpResourcesSchema).optional().default([]),\n  apps: z.array(annotatedFrontMcpAppSchema),\n  serve: z.boolean().optional().default(true),\n  http: httpOptionsSchema.optional(),\n  redis: redisOptionsSchema.optional(),\n  transport: transportOptionsSchema.optional().transform((val) => val ?? transportOptionsSchema.parse({})),\n  session: sessionOptionsSchema.optional(), // @deprecated - kept for backward compatibility\n  logging: loggingOptionsSchema.optional(),\n} satisfies RawZodShape<FrontMcpBaseMetadata>);\n\nexport interface FrontMcpMultiAppMetadata extends FrontMcpBaseMetadata {\n  splitByApp?: false;\n  auth?: AuthOptionsInput;\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\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\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\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"]}
+{"version":3,"file":"front-mcp.metadata.js","sourceRoot":"","sources":["../../../../src/common/metadata/front-mcp.metadata.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oCAmBkB;AAClB,wCAKoB;AAuDP,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,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sCAA4B,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,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;IAClC,KAAK,EAAE,0BAAkB,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,2BAAmB,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,8BAAsB,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,8BAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE,EAAE,gDAAgD;IAC1F,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE;CACG,CAAC,CAAC;AAO/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,0DAA0D,CAAC;CAClC,CAAC,CAAC;AAOzE,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;AAI9D,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  AuthOptionsInput,\n  RedisOptionsInput,\n  redisOptionsSchema,\n  PubsubOptionsInput,\n  pubsubOptionsSchema,\n  TransportOptionsInput,\n  transportOptionsSchema,\n} from '../types';\nimport {\n  annotatedFrontMcpAppSchema,\n  annotatedFrontMcpProvidersSchema,\n  annotatedFrontMcpResourcesSchema,\n  annotatedFrontMcpToolsSchema,\n} from '../schemas';\nimport { AppType, ProviderType, ResourceType, ToolType } from '../interfaces';\n\nexport interface FrontMcpBaseMetadata {\n  info: ServerInfoOptions;\n  apps: AppType[];\n  http?: HttpOptions;\n  logging?: LoggingOptions;\n\n  serve?: boolean; // default to true\n\n  /**\n   * Shared storage configuration\n   * Used by transport persistence and auth token storage.\n   * Supports both Redis and Vercel KV providers.\n   */\n  redis?: RedisOptionsInput;\n\n  /**\n   * Pub/Sub configuration (Redis-only)\n   * Required for resource subscriptions when using Vercel KV for sessions.\n   * Falls back to `redis` config if not specified and redis is configured with Redis provider.\n   */\n  pubsub?: PubsubOptionsInput;\n\n  /**\n   * Transport and session lifecycle configuration\n   * Controls transport protocols, session management, and persistence\n   * @default {} (all transport options use their schema defaults)\n   */\n  transport?: TransportOptionsInput; // Optional in input, but always defined in output\n\n  /**\n   * @deprecated Use `transport` instead. Session config has been merged into transport.\n   */\n  session?: SessionOptions;\n\n  /**\n   * Additional providers that are available to all apps.\n   */\n  providers?: ProviderType[];\n\n  /**\n   * Shared tools that are available to all apps.\n   * These are merged (additively) with app-specific tools.\n   */\n  tools?: ToolType[];\n\n  /**\n   * Shared resources that are available to all apps.\n   * These are merged (additively) with app-specific resources.\n   */\n  resources?: ResourceType[];\n}\n\nexport const frontMcpBaseSchema = z.object({\n  info: serverInfoOptionsSchema,\n  providers: z.array(annotatedFrontMcpProvidersSchema).optional().default([]),\n  tools: z.array(annotatedFrontMcpToolsSchema).optional().default([]),\n  resources: z.array(annotatedFrontMcpResourcesSchema).optional().default([]),\n  apps: z.array(annotatedFrontMcpAppSchema),\n  serve: z.boolean().optional().default(true),\n  http: httpOptionsSchema.optional(),\n  redis: redisOptionsSchema.optional(),\n  pubsub: pubsubOptionsSchema.optional(),\n  transport: transportOptionsSchema.optional().transform((val) => val ?? transportOptionsSchema.parse({})),\n  session: sessionOptionsSchema.optional(), // @deprecated - kept for backward compatibility\n  logging: loggingOptionsSchema.optional(),\n} satisfies RawZodShape<FrontMcpBaseMetadata>);\n\nexport interface FrontMcpMultiAppMetadata extends FrontMcpBaseMetadata {\n  splitByApp?: false;\n  auth?: AuthOptionsInput;\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\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\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\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/common/metadata/prompt.metadata.d.ts

@@ -64,6 +64,10 @@ export declare const frontMcpPromptMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
     }, z.core.$strip>>>;
 }, z.core.$loose>;
 export { FrontMcpPromptMetadata as PromptMetadata, };

package/src/common/metadata/resource.metadata.d.ts

@@ -56,6 +56,10 @@ export declare const frontMcpResourceMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
     }, z.core.$strip>>>;
 }, z.core.$loose>;
 /**
@@ -102,6 +106,10 @@ export declare const frontMcpResourceTemplateMetadataSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
     }, z.core.$strip>>>;
 }, z.core.$loose>;
 export { ResourceMetadata, ResourceMetadata as FrontMcpResourceMetadata, ResourceTemplateMetadata, ResourceTemplateMetadata as FrontMcpResourceTemplateMetadata, };

package/src/common/metadata/tool-ui.metadata.d.ts

@@ -1,10 +1,10 @@
 /**
  * Tool UI Configuration Types
  *
- * Re-exports types from @frontmcp/ui/types for SDK consumers.
+ * 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}
  */
-export { type UIContentSecurityPolicy, type TemplateHelpers, type TemplateContext, type TemplateBuilderFn, type WidgetServingMode, type WidgetDisplayMode, type UITemplateConfig as ToolUIConfig, type UIType, type BundlingMode, type DisplayMode, type ResourceMode, type CSPDirectives, type RendererAssets, type WidgetManifest, type RuntimePayload, type WidgetConfig, type WidgetTemplate, type WidgetRuntimeOptions, type BuildManifestResult, type BuildManifestOptions, } from '@frontmcp/ui/types';
+export { type UIContentSecurityPolicy, type TemplateHelpers, type TemplateContext, type TemplateBuilderFn, type WidgetServingMode, type WidgetDisplayMode, type UITemplateConfig as ToolUIConfig, type UIType, type BundlingMode, type DisplayMode, type ResourceMode, type CSPDirectives, type RendererAssets, type WidgetManifest, type RuntimePayload, type WidgetConfig, type WidgetTemplate, type WidgetRuntimeOptions, type BuildManifestResult, type BuildManifestOptions, } from '@frontmcp/uipack/types';

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

@@ -2,7 +2,7 @@
 /**
  * Tool UI Configuration Types
  *
- * Re-exports types from @frontmcp/ui/types for SDK consumers.
+ * 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.
  *

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

@@ -1 +1 @@
-{"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/ui/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/ui\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/ui/types';\n"]}
+{"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.d.ts

@@ -159,6 +159,10 @@ export declare const ResourceLinkOutputSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
     }, z.core.$strip>>>;
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;

package/src/common/schemas/http-output.schema.d.ts

@@ -298,19 +298,28 @@ export declare const HttpJsonRpcSchema: z.ZodObject<{
     kind: z.ZodLiteral<"jsonrpc">;
     status: z.ZodNumber;
     contentType: z.ZodDefault<z.ZodString>;
-    body: z.ZodUnion<readonly [z.ZodObject<{
+    body: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
         jsonrpc: z.ZodLiteral<"2.0">;
         id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         result: z.ZodObject<{
             _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                     taskId: z.ZodString;
-                }, z.core.$loose>>;
+                }, z.core.$strip>>;
             }, z.core.$loose>>;
         }, z.core.$loose>;
     }, z.core.$strict>, z.ZodObject<{
         jsonrpc: z.ZodLiteral<"2.0">;
-        id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        error: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    }, z.core.$strict>]>, z.ZodObject<{
+        jsonrpc: z.ZodLiteral<"2.0">;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         error: z.ZodObject<{
             code: z.ZodNumber;
             message: z.ZodString;
@@ -596,19 +605,28 @@ export declare const httpOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"jsonrpc">;
     status: z.ZodNumber;
     contentType: z.ZodDefault<z.ZodString>;
-    body: z.ZodUnion<readonly [z.ZodObject<{
+    body: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
         jsonrpc: z.ZodLiteral<"2.0">;
         id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         result: z.ZodObject<{
             _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                     taskId: z.ZodString;
-                }, z.core.$loose>>;
+                }, z.core.$strip>>;
             }, z.core.$loose>>;
         }, z.core.$loose>;
     }, z.core.$strict>, z.ZodObject<{
         jsonrpc: z.ZodLiteral<"2.0">;
-        id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        error: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            data: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>;
+    }, z.core.$strict>]>, z.ZodObject<{
+        jsonrpc: z.ZodLiteral<"2.0">;
+        id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         error: z.ZodObject<{
             code: z.ZodNumber;
             message: z.ZodString;

package/src/common/tokens/front-mcp.tokens.js

@@ -8,6 +8,7 @@ exports.FrontMcpTokens = {
     apps: base_tokens_1.tokenFactory.meta('apps'),
     http: base_tokens_1.tokenFactory.meta('http'),
     redis: base_tokens_1.tokenFactory.meta('redis'),
+    pubsub: base_tokens_1.tokenFactory.meta('pubsub'),
     transport: base_tokens_1.tokenFactory.meta('transport'),
     session: base_tokens_1.tokenFactory.meta('session'), // @deprecated - kept for backward compatibility
     serve: base_tokens_1.tokenFactory.meta('serve'),

package/src/common/tokens/front-mcp.tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.tokens.js","sourceRoot":"","sources":["../../../../src/common/tokens/front-mcp.tokens.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAIhC,QAAA,cAAc,GAAuC;IAChE,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,OAAO,EAAE,0BAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,gDAAgD;IACvF,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,UAAU,EAAE,0BAAY,CAAC,IAAI,CAAC,YAAY,CAAC;IAC3C,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,0BAAY,CAAC,IAAI,CAAC,SAAS,CAAC;IAErC,0BAA0B;IAC1B,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,2CAA2C;IAC3C,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,+CAA+C;IAC/C,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;CAC1C,CAAC","sourcesContent":["import { tokenFactory } from './base.tokens';\nimport { RawMetadataShape } from '../types';\nimport { FrontMcpMetadata } from '../metadata';\n\nexport const FrontMcpTokens: RawMetadataShape<FrontMcpMetadata> = {\n  type: tokenFactory.type('root'),\n  info: tokenFactory.meta('info'),\n  apps: tokenFactory.meta('apps'),\n  http: tokenFactory.meta('http'),\n  redis: tokenFactory.meta('redis'),\n  transport: tokenFactory.meta('transport'),\n  session: tokenFactory.meta('session'), // @deprecated - kept for backward compatibility\n  serve: tokenFactory.meta('serve'),\n  splitByApp: tokenFactory.meta('splitByApp'),\n  auth: tokenFactory.meta('auth'),\n  logging: tokenFactory.meta('logging'),\n\n  // global scoped providers\n  providers: tokenFactory.meta('providers'),\n  // global scoped tools (shared across apps)\n  tools: tokenFactory.meta('tools'),\n  // global scoped resources (shared across apps)\n  resources: tokenFactory.meta('resources'),\n};\n"]}
+{"version":3,"file":"front-mcp.tokens.js","sourceRoot":"","sources":["../../../../src/common/tokens/front-mcp.tokens.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAIhC,QAAA,cAAc,GAAuC;IAChE,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,MAAM,EAAE,0BAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;IACnC,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,OAAO,EAAE,0BAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,gDAAgD;IACvF,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,UAAU,EAAE,0BAAY,CAAC,IAAI,CAAC,YAAY,CAAC;IAC3C,IAAI,EAAE,0BAAY,CAAC,IAAI,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,0BAAY,CAAC,IAAI,CAAC,SAAS,CAAC;IAErC,0BAA0B;IAC1B,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,2CAA2C;IAC3C,KAAK,EAAE,0BAAY,CAAC,IAAI,CAAC,OAAO,CAAC;IACjC,+CAA+C;IAC/C,SAAS,EAAE,0BAAY,CAAC,IAAI,CAAC,WAAW,CAAC;CAC1C,CAAC","sourcesContent":["import { tokenFactory } from './base.tokens';\nimport { RawMetadataShape } from '../types';\nimport { FrontMcpMetadata } from '../metadata';\n\nexport const FrontMcpTokens: RawMetadataShape<FrontMcpMetadata> = {\n  type: tokenFactory.type('root'),\n  info: tokenFactory.meta('info'),\n  apps: tokenFactory.meta('apps'),\n  http: tokenFactory.meta('http'),\n  redis: tokenFactory.meta('redis'),\n  pubsub: tokenFactory.meta('pubsub'),\n  transport: tokenFactory.meta('transport'),\n  session: tokenFactory.meta('session'), // @deprecated - kept for backward compatibility\n  serve: tokenFactory.meta('serve'),\n  splitByApp: tokenFactory.meta('splitByApp'),\n  auth: tokenFactory.meta('auth'),\n  logging: tokenFactory.meta('logging'),\n\n  // global scoped providers\n  providers: tokenFactory.meta('providers'),\n  // global scoped tools (shared across apps)\n  tools: tokenFactory.meta('tools'),\n  // global scoped resources (shared across apps)\n  resources: tokenFactory.meta('resources'),\n};\n"]}

package/src/common/types/options/redis.options.d.ts

@@ -1,9 +1,17 @@
 import { z } from 'zod';
 /**
- * Shared Redis configuration
- * Used by transport persistence and auth token storage
+ * Supported storage providers
  */
-export declare const redisOptionsSchema: z.ZodObject<{
+export declare const storageProviderSchema: z.ZodEnum<{
+    redis: "redis";
+    "vercel-kv": "vercel-kv";
+}>;
+export type StorageProvider = z.infer<typeof storageProviderSchema>;
+/**
+ * Full Redis provider configuration
+ */
+export declare const redisProviderSchema: z.ZodObject<{
+    provider: z.ZodLiteral<"redis">;
     host: z.ZodString;
     port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     password: z.ZodOptional<z.ZodString>;
@@ -12,11 +20,171 @@ export declare const redisOptionsSchema: z.ZodObject<{
     keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
+export type RedisProviderOptions = z.infer<typeof redisProviderSchema>;
+/**
+ * Vercel KV provider configuration
+ * Uses environment variables by default (KV_REST_API_URL, KV_REST_API_TOKEN)
+ */
+export declare const vercelKvProviderSchema: z.ZodObject<{
+    provider: z.ZodLiteral<"vercel-kv">;
+    url: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type VercelKvProviderOptions = z.infer<typeof vercelKvProviderSchema>;
+/**
+ * Shared storage configuration
+ * Supports both Redis and Vercel KV providers.
+ *
+ * @example Redis (explicit provider)
+ * ```typescript
+ * {
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * }
+ * ```
+ *
+ * @example Redis (legacy format - backwards compatible)
+ * ```typescript
+ * {
+ *   host: 'localhost',
+ *   port: 6379,
+ * }
+ * ```
+ *
+ * @example Vercel KV (uses env vars by default)
+ * ```typescript
+ * {
+ *   provider: 'vercel-kv',
+ * }
+ * ```
+ *
+ * @example Vercel KV (explicit config)
+ * ```typescript
+ * {
+ *   provider: 'vercel-kv',
+ *   url: 'https://my-kv.vercel-storage.com',
+ *   token: 'my-token',
+ * }
+ * ```
+ */
+export declare const redisOptionsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    provider: z.ZodLiteral<"redis">;
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    provider: z.ZodLiteral<"vercel-kv">;
+    url: z.ZodOptional<z.ZodString>;
+    token: z.ZodOptional<z.ZodString>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodPipe<z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodTransform<{
+    provider: "redis";
+    host: string;
+    port: number;
+    db: number;
+    tls: boolean;
+    keyPrefix: string;
+    defaultTtlMs: number;
+    password?: string | undefined;
+}, {
+    host: string;
+    port: number;
+    db: number;
+    tls: boolean;
+    keyPrefix: string;
+    defaultTtlMs: number;
+    password?: string | undefined;
+}>>]>;
 /**
- * Redis configuration type (with defaults applied)
+ * Storage configuration type (with defaults applied)
  */
 export type RedisOptions = z.infer<typeof redisOptionsSchema>;
 /**
- * Redis configuration input type (for user configuration)
+ * Storage configuration input type (for user configuration)
  */
 export type RedisOptionsInput = z.input<typeof redisOptionsSchema>;
+/**
+ * Pub/Sub configuration (requires Redis, not compatible with Vercel KV)
+ *
+ * Use this when you need pub/sub features like resource subscriptions
+ * but want to use Vercel KV for sessions/cache.
+ *
+ * @example Hybrid config
+ * ```typescript
+ * {
+ *   redis: { provider: 'vercel-kv' },  // sessions/cache
+ *   pubsub: { host: 'localhost' },      // pub/sub
+ * }
+ * ```
+ */
+export declare const pubsubOptionsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    provider: z.ZodLiteral<"redis">;
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodPipe<z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    password: z.ZodOptional<z.ZodString>;
+    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodTransform<{
+    provider: "redis";
+    host: string;
+    port: number;
+    db: number;
+    tls: boolean;
+    keyPrefix: string;
+    defaultTtlMs: number;
+    password?: string | undefined;
+}, {
+    host: string;
+    port: number;
+    db: number;
+    tls: boolean;
+    keyPrefix: string;
+    defaultTtlMs: number;
+    password?: string | undefined;
+}>>]>;
+/**
+ * Pub/Sub configuration type (Redis-only)
+ */
+export type PubsubOptions = z.infer<typeof pubsubOptionsSchema>;
+/**
+ * Pub/Sub configuration input type
+ */
+export type PubsubOptionsInput = z.input<typeof pubsubOptionsSchema>;
+/**
+ * Check if options are for Redis provider
+ */
+export declare function isRedisProvider(options: RedisOptions): options is RedisProviderOptions;
+/**
+ * Check if options are for Vercel KV provider
+ */
+export declare function isVercelKvProvider(options: RedisOptions): options is VercelKvProviderOptions;
+/**
+ * Check if pub/sub options are valid Redis config
+ */
+export declare function isPubsubConfigured(options: PubsubOptions): options is RedisProviderOptions;

package/src/common/types/options/redis.options.js

@@ -1,13 +1,40 @@
 "use strict";
 // common/types/options/redis.options.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.redisOptionsSchema = void 0;
+exports.pubsubOptionsSchema = exports.redisOptionsSchema = exports.vercelKvProviderSchema = exports.redisProviderSchema = exports.storageProviderSchema = void 0;
+exports.isRedisProvider = isRedisProvider;
+exports.isVercelKvProvider = isVercelKvProvider;
+exports.isPubsubConfigured = isPubsubConfigured;
 const zod_1 = require("zod");
+// ============================================
+// Storage Provider Types
+// ============================================
 /**
- * Shared Redis configuration
- * Used by transport persistence and auth token storage
+ * Supported storage providers
  */
-exports.redisOptionsSchema = zod_1.z.object({
+exports.storageProviderSchema = zod_1.z.enum(['redis', 'vercel-kv']);
+// ============================================
+// Common Options (shared between providers)
+// ============================================
+const commonOptionsSchema = zod_1.z.object({
+    /**
+     * Key prefix for all keys
+     * @default 'mcp:'
+     */
+    keyPrefix: zod_1.z.string().optional().default('mcp:'),
+    /**
+     * Default TTL in milliseconds for stored data
+     * @default 3600000 (1 hour)
+     */
+    defaultTtlMs: zod_1.z.number().int().positive().optional().default(3600000),
+});
+// ============================================
+// Redis Provider Configuration
+// ============================================
+/**
+ * Redis-specific connection options
+ */
+const redisConnectionSchema = zod_1.z.object({
     /**
      * Redis host
      */
@@ -31,15 +58,134 @@ exports.redisOptionsSchema = zod_1.z.object({
      * @default false
      */
     tls: zod_1.z.boolean().optional().default(false),
+});
+/**
+ * Full Redis provider configuration
+ */
+exports.redisProviderSchema = zod_1.z
+    .object({
     /**
-     * Key prefix for all Redis keys
-     * @default 'mcp:'
+     * Storage provider type
+     * @default 'redis'
      */
-    keyPrefix: zod_1.z.string().optional().default('mcp:'),
+    provider: zod_1.z.literal('redis'),
+})
+    .merge(redisConnectionSchema)
+    .merge(commonOptionsSchema);
+// ============================================
+// Vercel KV Provider Configuration
+// ============================================
+/**
+ * Vercel KV provider configuration
+ * Uses environment variables by default (KV_REST_API_URL, KV_REST_API_TOKEN)
+ */
+exports.vercelKvProviderSchema = zod_1.z
+    .object({
     /**
-     * Default TTL in milliseconds for stored data
-     * @default 3600000 (1 hour)
+     * Storage provider type
      */
-    defaultTtlMs: zod_1.z.number().int().positive().optional().default(3600000),
-});
+    provider: zod_1.z.literal('vercel-kv'),
+    /**
+     * KV REST API URL
+     * @default process.env.KV_REST_API_URL
+     */
+    url: zod_1.z.string().url().optional(),
+    /**
+     * KV REST API Token
+     * @default process.env.KV_REST_API_TOKEN
+     */
+    token: zod_1.z.string().optional(),
+})
+    .merge(commonOptionsSchema);
+// ============================================
+// Legacy Redis Schema (backwards compatibility)
+// ============================================
+/**
+ * Legacy Redis configuration without provider field
+ * Automatically transforms to redis provider
+ */
+const legacyRedisSchema = redisConnectionSchema.merge(commonOptionsSchema).transform((val) => ({
+    ...val,
+    provider: 'redis',
+}));
+// ============================================
+// Combined Redis Options Schema
+// ============================================
+/**
+ * Shared storage configuration
+ * Supports both Redis and Vercel KV providers.
+ *
+ * @example Redis (explicit provider)
+ * ```typescript
+ * {
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * }
+ * ```
+ *
+ * @example Redis (legacy format - backwards compatible)
+ * ```typescript
+ * {
+ *   host: 'localhost',
+ *   port: 6379,
+ * }
+ * ```
+ *
+ * @example Vercel KV (uses env vars by default)
+ * ```typescript
+ * {
+ *   provider: 'vercel-kv',
+ * }
+ * ```
+ *
+ * @example Vercel KV (explicit config)
+ * ```typescript
+ * {
+ *   provider: 'vercel-kv',
+ *   url: 'https://my-kv.vercel-storage.com',
+ *   token: 'my-token',
+ * }
+ * ```
+ */
+exports.redisOptionsSchema = zod_1.z.union([exports.redisProviderSchema, exports.vercelKvProviderSchema, legacyRedisSchema]);
+// ============================================
+// Pub/Sub Options Schema (Redis-only)
+// ============================================
+/**
+ * Pub/Sub configuration (requires Redis, not compatible with Vercel KV)
+ *
+ * Use this when you need pub/sub features like resource subscriptions
+ * but want to use Vercel KV for sessions/cache.
+ *
+ * @example Hybrid config
+ * ```typescript
+ * {
+ *   redis: { provider: 'vercel-kv' },  // sessions/cache
+ *   pubsub: { host: 'localhost' },      // pub/sub
+ * }
+ * ```
+ */
+exports.pubsubOptionsSchema = zod_1.z.union([exports.redisProviderSchema, legacyRedisSchema]);
+// ============================================
+// Type Guards
+// ============================================
+/**
+ * Check if options are for Redis provider
+ */
+function isRedisProvider(options) {
+    return options.provider === 'redis';
+}
+/**
+ * Check if options are for Vercel KV provider
+ */
+function isVercelKvProvider(options) {
+    return options.provider === 'vercel-kv';
+}
+/**
+ * Check if pub/sub options are valid Redis config
+ */
+function isPubsubConfigured(options) {
+    return options.provider === 'redis';
+}
 //# sourceMappingURL=redis.options.js.map

package/src/common/types/options/redis.options.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/redis.options.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,6BAAwB;AAExB;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC;;OAEG;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9B;;;OAGG;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAErE;;OAEG;IACH,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B;;;OAGG;IACH,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAExD;;;OAGG;IACH,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE1C;;;OAGG;IACH,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAEhD;;;OAGG;IACH,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CACtE,CAAC,CAAC","sourcesContent":["// common/types/options/redis.options.ts\n\nimport { z } from 'zod';\n\n/**\n * Shared Redis configuration\n * Used by transport persistence and auth token storage\n */\nexport const redisOptionsSchema = z.object({\n  /**\n   * Redis host\n   */\n  host: z.string().trim().min(1),\n\n  /**\n   * Redis port\n   * @default 6379\n   */\n  port: z.number().int().positive().max(65535).optional().default(6379),\n\n  /**\n   * Redis password (optional)\n   */\n  password: z.string().optional(),\n\n  /**\n   * Redis database number\n   * @default 0\n   */\n  db: z.number().int().nonnegative().optional().default(0),\n\n  /**\n   * Enable TLS connection\n   * @default false\n   */\n  tls: z.boolean().optional().default(false),\n\n  /**\n   * Key prefix for all Redis keys\n   * @default 'mcp:'\n   */\n  keyPrefix: z.string().optional().default('mcp:'),\n\n  /**\n   * Default TTL in milliseconds for stored data\n   * @default 3600000 (1 hour)\n   */\n  defaultTtlMs: z.number().int().positive().optional().default(3600000),\n});\n\n/**\n * Redis configuration type (with defaults applied)\n */\nexport type RedisOptions = z.infer<typeof redisOptionsSchema>;\n\n/**\n * Redis configuration input type (for user configuration)\n */\nexport type RedisOptionsInput = z.input<typeof redisOptionsSchema>;\n"]}
+{"version":3,"file":"redis.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/redis.options.ts"],"names":[],"mappings":"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","sourcesContent":["// common/types/options/redis.options.ts\n\nimport { z } from 'zod';\n\n// ============================================\n// Storage Provider Types\n// ============================================\n\n/**\n * Supported storage providers\n */\nexport const storageProviderSchema = z.enum(['redis', 'vercel-kv']);\nexport type StorageProvider = z.infer<typeof storageProviderSchema>;\n\n// ============================================\n// Common Options (shared between providers)\n// ============================================\n\nconst commonOptionsSchema = z.object({\n  /**\n   * Key prefix for all keys\n   * @default 'mcp:'\n   */\n  keyPrefix: z.string().optional().default('mcp:'),\n\n  /**\n   * Default TTL in milliseconds for stored data\n   * @default 3600000 (1 hour)\n   */\n  defaultTtlMs: z.number().int().positive().optional().default(3600000),\n});\n\n// ============================================\n// Redis Provider Configuration\n// ============================================\n\n/**\n * Redis-specific connection options\n */\nconst redisConnectionSchema = z.object({\n  /**\n   * Redis host\n   */\n  host: z.string().trim().min(1),\n\n  /**\n   * Redis port\n   * @default 6379\n   */\n  port: z.number().int().positive().max(65535).optional().default(6379),\n\n  /**\n   * Redis password (optional)\n   */\n  password: z.string().optional(),\n\n  /**\n   * Redis database number\n   * @default 0\n   */\n  db: z.number().int().nonnegative().optional().default(0),\n\n  /**\n   * Enable TLS connection\n   * @default false\n   */\n  tls: z.boolean().optional().default(false),\n});\n\n/**\n * Full Redis provider configuration\n */\nexport const redisProviderSchema = z\n  .object({\n    /**\n     * Storage provider type\n     * @default 'redis'\n     */\n    provider: z.literal('redis'),\n  })\n  .merge(redisConnectionSchema)\n  .merge(commonOptionsSchema);\n\nexport type RedisProviderOptions = z.infer<typeof redisProviderSchema>;\n\n// ============================================\n// Vercel KV Provider Configuration\n// ============================================\n\n/**\n * Vercel KV provider configuration\n * Uses environment variables by default (KV_REST_API_URL, KV_REST_API_TOKEN)\n */\nexport const vercelKvProviderSchema = z\n  .object({\n    /**\n     * Storage provider type\n     */\n    provider: z.literal('vercel-kv'),\n\n    /**\n     * KV REST API URL\n     * @default process.env.KV_REST_API_URL\n     */\n    url: z.string().url().optional(),\n\n    /**\n     * KV REST API Token\n     * @default process.env.KV_REST_API_TOKEN\n     */\n    token: z.string().optional(),\n  })\n  .merge(commonOptionsSchema);\n\nexport type VercelKvProviderOptions = z.infer<typeof vercelKvProviderSchema>;\n\n// ============================================\n// Legacy Redis Schema (backwards compatibility)\n// ============================================\n\n/**\n * Legacy Redis configuration without provider field\n * Automatically transforms to redis provider\n */\nconst legacyRedisSchema = redisConnectionSchema.merge(commonOptionsSchema).transform((val) => ({\n  ...val,\n  provider: 'redis' as const,\n}));\n\n// ============================================\n// Combined Redis Options Schema\n// ============================================\n\n/**\n * Shared storage configuration\n * Supports both Redis and Vercel KV providers.\n *\n * @example Redis (explicit provider)\n * ```typescript\n * {\n *   provider: 'redis',\n *   host: 'localhost',\n *   port: 6379,\n * }\n * ```\n *\n * @example Redis (legacy format - backwards compatible)\n * ```typescript\n * {\n *   host: 'localhost',\n *   port: 6379,\n * }\n * ```\n *\n * @example Vercel KV (uses env vars by default)\n * ```typescript\n * {\n *   provider: 'vercel-kv',\n * }\n * ```\n *\n * @example Vercel KV (explicit config)\n * ```typescript\n * {\n *   provider: 'vercel-kv',\n *   url: 'https://my-kv.vercel-storage.com',\n *   token: 'my-token',\n * }\n * ```\n */\nexport const redisOptionsSchema = z.union([redisProviderSchema, vercelKvProviderSchema, legacyRedisSchema]);\n\n/**\n * Storage configuration type (with defaults applied)\n */\nexport type RedisOptions = z.infer<typeof redisOptionsSchema>;\n\n/**\n * Storage configuration input type (for user configuration)\n */\nexport type RedisOptionsInput = z.input<typeof redisOptionsSchema>;\n\n// ============================================\n// Pub/Sub Options Schema (Redis-only)\n// ============================================\n\n/**\n * Pub/Sub configuration (requires Redis, not compatible with Vercel KV)\n *\n * Use this when you need pub/sub features like resource subscriptions\n * but want to use Vercel KV for sessions/cache.\n *\n * @example Hybrid config\n * ```typescript\n * {\n *   redis: { provider: 'vercel-kv' },  // sessions/cache\n *   pubsub: { host: 'localhost' },      // pub/sub\n * }\n * ```\n */\nexport const pubsubOptionsSchema = z.union([redisProviderSchema, legacyRedisSchema]);\n\n/**\n * Pub/Sub configuration type (Redis-only)\n */\nexport type PubsubOptions = z.infer<typeof pubsubOptionsSchema>;\n\n/**\n * Pub/Sub configuration input type\n */\nexport type PubsubOptionsInput = z.input<typeof pubsubOptionsSchema>;\n\n// ============================================\n// Type Guards\n// ============================================\n\n/**\n * Check if options are for Redis provider\n */\nexport function isRedisProvider(options: RedisOptions): options is RedisProviderOptions {\n  return options.provider === 'redis';\n}\n\n/**\n * Check if options are for Vercel KV provider\n */\nexport function isVercelKvProvider(options: RedisOptions): options is VercelKvProviderOptions {\n  return options.provider === 'vercel-kv';\n}\n\n/**\n * Check if pub/sub options are valid Redis config\n */\nexport function isPubsubConfigured(options: PubsubOptions): options is RedisProviderOptions {\n  return options.provider === 'redis';\n}\n"]}

package/src/common/types/options/server-info.options.d.ts

@@ -16,5 +16,9 @@ export declare const serverInfoOptionsSchema: z.ZodObject<{
         src: z.ZodString;
         mimeType: z.ZodOptional<z.ZodString>;
         sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;