@frontmcp/sdk 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/sdk",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "FrontMCP SDK",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -23,37 +23,57 @@
   "bugs": {
     "url": "https://github.com/agentfront/frontmcp/issues"
   },
-  "main": "./src/index.js",
-  "types": "./src/index.d.ts",
+  "type": "commonjs",
+  "main": "./index.js",
+  "module": "./esm/index.mjs",
+  "types": "./index.d.ts",
+  "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "default": "./src/index.js"
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./esm/index.mjs"
+      }
     },
     "./mcp-apps": {
-      "types": "./src/mcp-apps/index.d.ts",
-      "import": "./src/mcp-apps/index.js",
-      "default": "./src/mcp-apps/index.js"
-    }
+      "require": {
+        "types": "./mcp-apps/index.d.ts",
+        "default": "./mcp-apps/index.js"
+      },
+      "import": {
+        "types": "./mcp-apps/index.d.ts",
+        "default": "./esm/mcp-apps/index.mjs"
+      }
+    },
+    "./esm": null
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "express": "^4.21.0",
+    "express": "^4.18.0 || ^5.0.0",
     "cors": "^2.8.5",
     "raw-body": "^3.0.0",
-    "content-type": "^1.0.5"
+    "content-type": "^1.0.5",
+    "@vercel/kv": "^2.0.0 || ^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vercel/kv": {
+      "optional": true
+    }
   },
   "dependencies": {
-    "@frontmcp/ui": "0.6.0",
-    "@modelcontextprotocol/sdk": "1.24.3",
+    "@frontmcp/uipack": "0.6.2",
+    "@modelcontextprotocol/sdk": "1.25.1",
     "ioredis": "^5.8.0",
-    "jose": "^6.1.0",
+    "jose": "^6.1.3",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
+    "@vercel/kv": "^3.0.0",
     "typescript": "^5.9.3"
-  },
-  "type": "commonjs"
+  }
 }

package/{src/prompt → prompt}/flows/get-prompt.flow.d.ts

@@ -5,27 +5,24 @@ declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"prompts/get">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             name: z.ZodString;
             arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodAny;
 }, z.core.$strip>;
 declare const outputSchema: 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>>;
     description: z.ZodOptional<z.ZodString>;
     messages: z.ZodArray<z.ZodObject<{
@@ -88,6 +85,10 @@ declare const outputSchema: 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>;
@@ -130,9 +131,10 @@ declare const stateSchema: z.ZodObject<{
     rawOutput: z.ZodOptional<z.ZodAny>;
     output: 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>>;
         description: z.ZodOptional<z.ZodString>;
         messages: z.ZodArray<z.ZodObject<{
@@ -195,6 +197,10 @@ declare const stateSchema: 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/prompt → prompt}/flows/prompts-list.flow.d.ts

@@ -4,27 +4,24 @@ import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         params: z.ZodOptional<z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             cursor: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>;
+        }, z.core.$strip>>;
         method: z.ZodLiteral<"prompts/list">;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: 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>>;
     nextCursor: z.ZodOptional<z.ZodString>;
     prompts: z.ZodArray<z.ZodObject<{
@@ -39,6 +36,10 @@ declare const outputSchema: 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/resource → resource}/flows/read-resource.flow.d.ts

@@ -5,26 +5,23 @@ declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"resources/read">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             uri: z.ZodString;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodAny;
 }, z.core.$strip>;
 declare const outputSchema: 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>>;
     contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         uri: z.ZodString;
@@ -49,9 +46,10 @@ declare const stateSchema: z.ZodObject<{
     rawOutput: z.ZodOptional<z.ZodAny>;
     output: 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>>;
         contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             uri: z.ZodString;
@@ -70,9 +68,10 @@ declare const stateSchema: z.ZodObject<{
     isUIResource: z.ZodDefault<z.ZodBoolean>;
     uiResourceResult: z.ZodOptional<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>>;
         contents: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             uri: z.ZodString;

package/{src/resource → resource}/flows/resource-templates-list.flow.d.ts

@@ -4,27 +4,24 @@ import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         params: z.ZodOptional<z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             cursor: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>;
+        }, z.core.$strip>>;
         method: z.ZodLiteral<"resources/templates/list">;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: 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>>;
     nextCursor: z.ZodOptional<z.ZodString>;
     resourceTemplates: z.ZodArray<z.ZodObject<{
@@ -44,6 +41,10 @@ declare const outputSchema: 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/resource → resource}/flows/resources-list.flow.d.ts

@@ -4,27 +4,24 @@ import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         params: z.ZodOptional<z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             cursor: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>;
+        }, z.core.$strip>>;
         method: z.ZodLiteral<"resources/list">;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: 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>>;
     nextCursor: z.ZodOptional<z.ZodString>;
     resources: z.ZodArray<z.ZodObject<{
@@ -44,6 +41,10 @@ declare const outputSchema: 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/resource → resource}/flows/subscribe-resource.flow.d.ts

@@ -4,26 +4,23 @@ declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"resources/subscribe">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             uri: z.ZodString;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: 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.$strict>;
 declare const stateSchema: z.ZodObject<{
@@ -33,9 +30,10 @@ declare const stateSchema: z.ZodObject<{
     sessionId: z.ZodString;
     output: 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.$strict>;
 }, z.core.$strip>;

package/{src/resource → resource}/flows/unsubscribe-resource.flow.d.ts

@@ -4,26 +4,23 @@ declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"resources/unsubscribe">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _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>>;
             uri: z.ZodString;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: 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.$strict>;
 declare const stateSchema: z.ZodObject<{
@@ -33,9 +30,10 @@ declare const stateSchema: z.ZodObject<{
     sessionId: z.ZodString;
     output: 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.$strict>;
 }, z.core.$strip>;

package/store/adapters/store.vercel-kv.adapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Vercel KV Store Adapter
+ *
+ * Store adapter implementation using Vercel KV (edge-compatible REST-based key-value store).
+ * Uses dynamic import to avoid bundling @vercel/kv for non-Vercel deployments.
+ *
+ * @see https://vercel.com/docs/storage/vercel-kv
+ */
+import { StoreBaseAdapter } from './store.base.adapter';
+import type { SetOptions } from '../store.types';
+export interface VercelKvAdapterOptions {
+    /**
+     * KV REST API URL
+     * @default process.env.KV_REST_API_URL
+     */
+    url?: string;
+    /**
+     * KV REST API Token
+     * @default process.env.KV_REST_API_TOKEN
+     */
+    token?: string;
+    /**
+     * Key prefix for all keys
+     * @default ''
+     */
+    keyPrefix?: string;
+}
+/**
+ * Vercel KV Store Adapter
+ *
+ * Implements the StoreDriver interface using Vercel KV.
+ * Note: Pub/Sub is not supported by Vercel KV (REST-based).
+ * The base class provides no-op implementations for publish/subscribe.
+ *
+ * @example
+ * ```typescript
+ * const store = new ScopedVercelKvStore({
+ *   url: process.env.KV_REST_API_URL,
+ *   token: process.env.KV_REST_API_TOKEN,
+ *   keyPrefix: 'myapp:',
+ * });
+ * await store.connect();
+ * await store.set('key', 'value', { ttlSeconds: 3600 });
+ * const value = await store.get('key');
+ * ```
+ */
+export declare class ScopedVercelKvStore extends StoreBaseAdapter {
+    private kv;
+    private readonly opts;
+    constructor(opts?: VercelKvAdapterOptions);
+    /**
+     * Connect to Vercel KV
+     * Uses dynamic import to avoid bundling @vercel/kv when not used
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Vercel KV
+     * Vercel KV uses REST API, so there's no persistent connection to close
+     */
+    disconnect(): Promise<void>;
+    private ensureConnected;
+    private prefixKey;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: SetOptions): Promise<void>;
+    del(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    /**
+     * Get multiple keys
+     * Uses Vercel KV's mget for efficiency
+     */
+    mget(keys: string[]): Promise<(string | null)[]>;
+    /**
+     * Set multiple keys
+     * Uses Vercel KV's mset for efficiency (no TTL support in bulk)
+     * Falls back to sequential sets for TTL support
+     */
+    mset(entries: Array<{
+        key: string;
+        value: string;
+        opts?: SetOptions;
+    }>): Promise<void>;
+    incr(key: string): Promise<number>;
+    decr(key: string): Promise<number>;
+    expire(key: string, ttlSeconds: number): Promise<void>;
+    ttl(key: string): Promise<number | null>;
+}

package/{src/store → store}/index.d.ts

@@ -3,6 +3,8 @@ export * from './store.tokens';
 export * from './store.utils';
 export * from './store.registry';
 export * from './store.helpers';
+export * from './store.factory';
 export * from './adapters/store.base.adapter';
 export * from './adapters/store.redis.adapter';
 export * from './adapters/store.memory.adapter';
+export * from './adapters/store.vercel-kv.adapter';

package/store/store.factory.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Storage Factory
+ *
+ * Factory functions for creating store drivers and session stores
+ * based on configuration. Supports both Redis and Vercel KV providers.
+ */
+import type { StoreDriver } from './store.types';
+import type { SessionStore } from '../auth/session/transport-session.types';
+import type { FrontMcpLogger } from '../common/interfaces/logger.interface';
+import { type RedisOptions, type PubsubOptions } from '../common/types/options/redis.options';
+/**
+ * Create a store driver based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @returns A store driver instance (not connected)
+ *
+ * @example Redis
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * await driver.connect();
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'vercel-kv',
+ *   // Uses KV_REST_API_URL and KV_REST_API_TOKEN env vars
+ * });
+ * await driver.connect();
+ * ```
+ */
+export declare function createStoreDriver(options: RedisOptions): StoreDriver;
+/**
+ * Create a session store based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ *
+ * @example Redis
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'vercel-kv',
+ * });
+ * ```
+ */
+export declare function createSessionStore(options: RedisOptions, logger?: FrontMcpLogger): Promise<SessionStore>;
+/**
+ * Create a session store synchronously (for backwards compatibility)
+ * Note: For Vercel KV, use createSessionStore() instead as it requires async connect
+ *
+ * @param options - Storage configuration (Redis only)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ */
+export declare function createSessionStoreSync(options: RedisOptions, logger?: FrontMcpLogger): SessionStore;
+/**
+ * Create a pub/sub store for resource subscriptions
+ *
+ * Pub/Sub requires Redis - Vercel KV does not support pub/sub operations.
+ * Use this when you need resource subscriptions with Vercel KV for sessions.
+ *
+ * @param options - Pub/sub configuration (Redis only)
+ * @returns A Redis store driver with pub/sub support
+ *
+ * @example Hybrid config
+ * ```typescript
+ * // Use Vercel KV for sessions, Redis for pub/sub
+ * const sessionStore = await createSessionStore({ provider: 'vercel-kv' });
+ * const pubsubStore = createPubsubStore({ host: 'localhost', port: 6379 });
+ * ```
+ */
+export declare function createPubsubStore(options: PubsubOptions): StoreDriver;