@frontmcp/plugin-remember 0.0.1 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-remember",
-  "version": "0.0.1",
+  "version": "0.7.1",
   "description": "Remember plugin for FrontMCP - encrypted session memory with approval system for secure tool authorization",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -47,8 +47,8 @@
   },
   "dependencies": {
     "ioredis": "^5.8.0",
-    "@frontmcp/sdk": "0.7.0",
-    "@frontmcp/utils": "0.7.0",
+    "@frontmcp/sdk": "0.7.1",
+    "@frontmcp/utils": "0.7.1",
     "zod": "^4.0.0"
   },
   "peerDependencies": {

package/providers/index.d.ts

@@ -0,0 +1,7 @@
+export type { RememberStoreInterface } from './remember-store.interface';
+export { default as RememberMemoryProvider } from './remember-memory.provider';
+export { default as RememberRedisProvider } from './remember-redis.provider';
+export { default as RememberVercelKvProvider } from './remember-vercel-kv.provider';
+export { RememberStorageProvider, RememberStorageProviderOptions, createRememberMemoryProvider, } from './remember-storage.provider';
+export { RememberAccessor, createRememberAccessor } from './remember-accessor.provider';
+//# sourceMappingURL=index.d.ts.map

package/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGzE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGpF,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/providers/remember-accessor.provider.d.ts

@@ -0,0 +1,124 @@
+import { FrontMcpContext } from '@frontmcp/sdk';
+import type { RememberStoreInterface } from './remember-store.interface';
+import type { RememberScope, RememberEntry, RememberPluginOptions, RememberSetOptions, RememberGetOptions, RememberForgetOptions, RememberKnowsOptions, RememberListOptions } from '../remember.types';
+/**
+ * Context-scoped accessor for remember storage.
+ * Provides a human-friendly API for storing and retrieving values.
+ *
+ * @example
+ * ```typescript
+ * const remember = this.get(RememberAccessorToken);
+ *
+ * // Store a value
+ * await remember.set('theme', 'dark');
+ *
+ * // Retrieve a value
+ * const theme = await remember.get('theme', { defaultValue: 'light' });
+ *
+ * // Store with scope and TTL
+ * await remember.set('token', 'xyz', { scope: 'session', ttl: 300 });
+ *
+ * // Check if remembered
+ * if (await remember.knows('onboarded')) { ... }
+ *
+ * // Forget something
+ * await remember.forget('token');
+ * ```
+ */
+export declare class RememberAccessor {
+    private readonly store;
+    private readonly ctx;
+    private readonly config;
+    private readonly keyPrefix;
+    private readonly encryptionEnabled;
+    constructor(store: RememberStoreInterface, ctx: FrontMcpContext, config: RememberPluginOptions);
+    /**
+     * Store a value in memory.
+     *
+     * @param key - The key to store under
+     * @param value - The value to store (any JSON-serializable data)
+     * @param options - Storage options (scope, ttl, brand, metadata)
+     */
+    set<T>(key: string, value: T, options?: RememberSetOptions): Promise<void>;
+    /**
+     * Retrieve a value from memory.
+     *
+     * @param key - The key to retrieve
+     * @param options - Retrieval options (scope, defaultValue)
+     * @returns The stored value or defaultValue if not found
+     */
+    get<T>(key: string, options?: RememberGetOptions<T>): Promise<T | undefined>;
+    /**
+     * Get the full entry including metadata.
+     *
+     * @param key - The key to retrieve
+     * @param options - Retrieval options (scope)
+     * @returns The full entry or undefined if not found
+     */
+    getEntry<T>(key: string, options?: {
+        scope?: RememberScope;
+    }): Promise<RememberEntry<T> | undefined>;
+    /**
+     * Forget (delete) a value from memory.
+     *
+     * @param key - The key to forget
+     * @param options - Options (scope)
+     */
+    forget(key: string, options?: RememberForgetOptions): Promise<void>;
+    /**
+     * Check if a key is remembered (exists and not expired).
+     *
+     * @param key - The key to check
+     * @param options - Options (scope)
+     * @returns true if the key exists
+     */
+    knows(key: string, options?: RememberKnowsOptions): Promise<boolean>;
+    /**
+     * List all remembered keys for a scope.
+     *
+     * @param options - Options (scope, pattern)
+     * @returns Array of keys (without the scope prefix)
+     */
+    list(options?: RememberListOptions): Promise<string[]>;
+    /**
+     * Update an existing entry's value while preserving metadata.
+     *
+     * @param key - The key to update
+     * @param value - The new value
+     * @param options - Options (scope, ttl)
+     */
+    update<T>(key: string, value: T, options?: {
+        scope?: RememberScope;
+        ttl?: number;
+    }): Promise<boolean>;
+    /**
+     * Get the session ID from context.
+     */
+    get sessionId(): string;
+    /**
+     * Get the user ID from context (if available).
+     */
+    get userId(): string | undefined;
+    /**
+     * Build the full storage key including scope prefix.
+     */
+    private buildStorageKey;
+    /**
+     * Build the scope-specific prefix.
+     */
+    private buildScopePrefix;
+    /**
+     * Get the encryption key source for a scope.
+     */
+    private getKeySource;
+    /**
+     * Parse a JSON entry (when encryption is disabled).
+     */
+    private parseEntry;
+}
+/**
+ * Factory function for creating RememberAccessor instances.
+ * Used by the plugin's dynamicProviders.
+ */
+export declare function createRememberAccessor(store: RememberStoreInterface, ctx: FrontMcpContext, config: RememberPluginOptions): RememberAccessor;
+//# sourceMappingURL=remember-accessor.provider.d.ts.map

package/providers/remember-accessor.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-accessor.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA6C,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAKa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;gBAEhC,KAAK,EAAE,sBAAsB,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB;IAY9F;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpF;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAsBtF;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAsB9G;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E;;;;;;OAMG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAM9E;;;;;OAKG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWhE;;;;;;OAMG;IACG,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B/G;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAS/B;IAMD;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,UAAU;CAOnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,qBAAqB,GAC5B,gBAAgB,CAElB"}

package/providers/remember-memory.provider.d.ts

@@ -0,0 +1,53 @@
+import type { RememberStoreInterface } from './remember-store.interface';
+/**
+ * In-memory storage provider for RememberPlugin.
+ * Provides fast, local storage with automatic TTL expiration.
+ */
+export default class RememberMemoryProvider implements RememberStoreInterface {
+    private readonly memory;
+    private sweeper?;
+    constructor(sweepIntervalSeconds?: number);
+    /**
+     * Store a value with optional TTL.
+     * Always JSON-serializes the value for consistent storage/retrieval.
+     */
+    setValue(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    /**
+     * Retrieve a value by key.
+     * JSON-parses the stored value to match the setValue serialization.
+     */
+    getValue<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Delete a key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists (and is not expired).
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List keys matching a glob-style pattern.
+     * Supports * and ? wildcards.
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Gracefully close the provider.
+     */
+    close(): Promise<void>;
+    private isExpired;
+    /**
+     * Periodically remove expired keys to keep memory tidy.
+     */
+    private sweep;
+    private static readonly MAX_PATTERN_LENGTH;
+    private static readonly MAX_WILDCARDS;
+    /**
+     * Convert a glob-style pattern to a RegExp.
+     * * matches any sequence of characters
+     * ? matches any single character
+     *
+     * Includes ReDoS protection: validates pattern length and wildcard count.
+     */
+    private patternToRegex;
+}
+//# sourceMappingURL=remember-memory.provider.d.ts.map

package/providers/remember-memory.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-memory.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-memory.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAgBzE;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,sBAAsB;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,OAAO,CAAC,CAAiB;gBAErB,oBAAoB,SAAK;IAMrC;;;OAGG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/E;;;OAGG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAkBlF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3C;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiC/C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAM;IAE3C;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAkBvB"}

package/providers/remember-redis.provider.d.ts

@@ -0,0 +1,62 @@
+import type { RememberStoreInterface } from './remember-store.interface';
+import type { RedisRememberPluginOptions, RedisClientRememberPluginOptions } from '../remember.types';
+/**
+ * Combined options type for Redis provider.
+ */
+export type RedisRememberOptions = RedisRememberPluginOptions | RedisClientRememberPluginOptions;
+/**
+ * Redis storage provider for RememberPlugin.
+ * Provides persistent, distributed storage with native TTL support.
+ */
+export default class RememberRedisProvider implements RememberStoreInterface {
+    private readonly client;
+    /**
+     * Prefix prepended to all Redis keys.
+     * Include any separator (e.g., "myapp:" or "user:123:") as part of the prefix.
+     */
+    private readonly keyPrefix;
+    /** True if this provider created the client (and should close it), false if externally provided */
+    private readonly ownsClient;
+    constructor(options: RedisRememberOptions);
+    /**
+     * Store a value with optional TTL.
+     *
+     * @param key - The key to store under
+     * @param value - The value to store (must not be undefined)
+     * @param ttlSeconds - Optional TTL in seconds (must be positive integer if provided)
+     * @throws Error if value is undefined or ttlSeconds is invalid
+     */
+    setValue(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    /**
+     * Retrieve a value by key.
+     *
+     * Returns the parsed JSON value if successful, or `defaultValue` if:
+     * - The key does not exist
+     * - The stored value is not valid JSON (malformed or legacy data)
+     *
+     * @param key - The key to retrieve
+     * @param defaultValue - Value to return if key doesn't exist or parsing fails
+     * @returns The parsed value as T, or defaultValue/undefined
+     */
+    getValue<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Delete a key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists.
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List keys matching a pattern.
+     * Uses Redis SCAN for efficient iteration.
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Gracefully close the Redis connection.
+     * Only closes if this provider owns the client (created it internally).
+     * Externally-provided clients are left open for the caller to manage.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=remember-redis.provider.d.ts.map

package/providers/remember-redis.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-redis.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-redis.provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,gCAAgC,CAAC;AAEjG;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,qBAAsB,YAAW,sBAAsB;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,OAAO,EAAE,oBAAoB;IA6BzC;;;;;;;OAOG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B/E;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAclF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB/C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/providers/remember-storage.provider.d.ts

@@ -0,0 +1,126 @@
+import { type RootStorage, type NamespacedStorage, type StorageConfig } from '@frontmcp/utils';
+import type { RememberStoreInterface } from './remember-store.interface';
+/**
+ * Configuration options for RememberStorageProvider.
+ */
+export interface RememberStorageProviderOptions {
+    /**
+     * Storage configuration. If not provided, uses auto-detection.
+     * @default { type: 'auto' }
+     */
+    storage?: StorageConfig;
+    /**
+     * Use an existing storage instance instead of creating a new one.
+     * Takes precedence over `storage` config.
+     */
+    storageInstance?: RootStorage | NamespacedStorage;
+    /**
+     * Namespace prefix for remember keys.
+     * @default 'remember'
+     */
+    namespace?: string;
+    /**
+     * Default TTL in seconds for values without explicit TTL.
+     * @default undefined (no default TTL)
+     */
+    defaultTTLSeconds?: number;
+}
+/**
+ * Storage-backed implementation of the RememberStoreInterface.
+ * Works with any storage backend (memory, Redis, Vercel KV, Upstash).
+ *
+ * @example Memory storage (development)
+ * ```typescript
+ * const provider = new RememberStorageProvider();
+ * await provider.initialize();
+ * await provider.setValue('key', { data: 'value' });
+ * ```
+ *
+ * @example Redis storage (production)
+ * ```typescript
+ * const provider = new RememberStorageProvider({
+ *   storage: { type: 'redis', redis: { url: 'redis://localhost:6379' } }
+ * });
+ * await provider.initialize();
+ * ```
+ *
+ * @example Auto-detection from environment
+ * ```typescript
+ * // Will use Redis if REDIS_URL is set, otherwise memory
+ * const provider = new RememberStorageProvider({ storage: { type: 'auto' } });
+ * await provider.initialize();
+ * ```
+ *
+ * @example With existing storage instance
+ * ```typescript
+ * const rootStorage = await createStorage({ type: 'redis' });
+ * const provider = new RememberStorageProvider({
+ *   storageInstance: rootStorage.namespace('myapp')
+ * });
+ * await provider.initialize();
+ * ```
+ */
+export declare class RememberStorageProvider implements RememberStoreInterface {
+    private storage;
+    private readonly options;
+    private initialized;
+    private ownedStorage;
+    constructor(options?: RememberStorageProviderOptions);
+    /**
+     * Initialize the storage connection.
+     * Must be called before using the provider.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure initialization before operations.
+     */
+    private ensureInitialized;
+    /**
+     * Store a value with optional TTL.
+     * @param key - Storage key
+     * @param value - Value to store (will be JSON serialized)
+     * @param ttlSeconds - Optional time-to-live in seconds
+     */
+    setValue(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    /**
+     * Retrieve a value by key.
+     * @param key - Storage key
+     * @param defaultValue - Value to return if key doesn't exist
+     * @returns The stored value or defaultValue
+     */
+    getValue<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Delete a value by key.
+     * @param key - Storage key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists.
+     * @param key - Storage key to check
+     * @returns true if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List keys matching a pattern.
+     * @param pattern - Glob-style pattern (e.g., "user:*")
+     * @returns Array of matching keys
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Gracefully close the storage connection.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a RememberStorageProvider with synchronous memory storage.
+ * Convenience function for simple use cases.
+ *
+ * @example
+ * ```typescript
+ * const provider = createRememberMemoryProvider();
+ * await provider.initialize(); // Required before use
+ * await provider.setValue('key', { data: 'value' });
+ * ```
+ */
+export declare function createRememberMemoryProvider(options?: Omit<RememberStorageProviderOptions, 'storage' | 'storageInstance'>): RememberStorageProvider;
+//# sourceMappingURL=remember-storage.provider.d.ts.map

package/providers/remember-storage.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-storage.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-storage.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC;IAElD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAKa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGtB;IACF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,8BAAmC;IASxD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/E;;;;;OAKG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAelF;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;;OAIG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,IAAI,CAAC,8BAA8B,EAAE,SAAS,GAAG,iBAAiB,CAAM,GAChF,uBAAuB,CAMzB"}

package/providers/remember-store.interface.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Interface for Remember storage providers.
+ * All providers must implement this interface.
+ */
+export interface RememberStoreInterface {
+    /**
+     * Store a value with optional TTL.
+     * @param key - Storage key
+     * @param value - Value to store (will be JSON serialized)
+     * @param ttlSeconds - Optional time-to-live in seconds
+     */
+    setValue(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    /**
+     * Retrieve a value by key.
+     * @param key - Storage key
+     * @param defaultValue - Value to return if key doesn't exist
+     * @returns The stored value or defaultValue
+     */
+    getValue<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Delete a value by key.
+     * @param key - Storage key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists.
+     * @param key - Storage key to check
+     * @returns true if key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List keys matching a pattern.
+     * @param pattern - Glob-style pattern (e.g., "user:*")
+     * @returns Array of matching keys
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Gracefully close the storage connection.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=remember-store.interface.d.ts.map

package/providers/remember-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-store.interface.d.ts","sourceRoot":"","sources":["../../src/providers/remember-store.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE7E;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/providers/remember-vercel-kv.provider.d.ts

@@ -0,0 +1,52 @@
+import type { RememberStoreInterface } from './remember-store.interface';
+/**
+ * Options for the Vercel KV provider.
+ */
+export interface RememberVercelKvProviderOptions {
+    /** Vercel KV URL (defaults to KV_REST_API_URL env var) */
+    url?: string;
+    /** Vercel KV token (defaults to KV_REST_API_TOKEN env var) */
+    token?: string;
+    /** Key prefix for all storage keys */
+    keyPrefix?: string;
+    /** Default TTL in seconds */
+    defaultTTL?: number;
+}
+/**
+ * Vercel KV storage provider for RememberPlugin.
+ * Provides serverless-compatible, edge-ready storage.
+ */
+export default class RememberVercelKvProvider implements RememberStoreInterface {
+    private kv;
+    private readonly keyPrefix;
+    private readonly defaultTTL?;
+    constructor(options?: RememberVercelKvProviderOptions);
+    private prefixKey;
+    /**
+     * Store a value with optional TTL.
+     */
+    setValue(key: string, value: unknown, ttlSeconds?: number): Promise<void>;
+    /**
+     * Retrieve a value by key.
+     */
+    getValue<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
+    /**
+     * Delete a key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists.
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List keys matching a pattern.
+     * Uses SCAN for efficient iteration.
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Gracefully close the provider.
+     * No-op for Vercel KV as it uses stateless REST API.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=remember-vercel-kv.provider.d.ts.map

package/providers/remember-vercel-kv.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember-vercel-kv.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-vercel-kv.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAezE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,sBAAsB;IAC7E,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,+BAAoC;IA6BzD,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAkBlF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmC/C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/remember.context-extension.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Context Extension Types for RememberPlugin
+ *
+ * Declares TypeScript types for `this.remember` property
+ * on ExecutionContextBase (ToolContext, AgentContext, etc.).
+ *
+ * The SDK handles the runtime installation via `contextExtensions` in plugin metadata.
+ * This file only provides TypeScript type augmentation.
+ *
+ * @example
+ * ```typescript
+ * // When RememberPlugin is installed, you can use:
+ * class MyTool extends ToolContext {
+ *   async execute(input) {
+ *     // Direct property access (throws if plugin not installed)
+ *     await this.remember.set('key', 'value');
+ *     const val = await this.remember.get('key');
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { RememberAccessor } from './providers/remember-accessor.provider';
+declare module '@frontmcp/sdk' {
+    interface ExecutionContextBase {
+        /**
+         * Access the remember accessor for storing/retrieving session memory.
+         * Only available when RememberPlugin is installed.
+         *
+         * @throws Error if RememberPlugin is not installed
+         *
+         * @example
+         * ```typescript
+         * await this.remember.set('theme', 'dark');
+         * const theme = await this.remember.get('theme');
+         * ```
+         */
+        readonly remember: RememberAccessor;
+    }
+    interface PromptContext {
+        /**
+         * Access the remember accessor for storing/retrieving session memory.
+         * Only available when RememberPlugin is installed.
+         */
+        readonly remember: RememberAccessor;
+    }
+}
+/**
+ * Get the RememberAccessor from an execution context.
+ * Alternative to `this.remember` for explicit function-style access.
+ *
+ * @throws Error if RememberPlugin is not installed
+ */
+export declare function getRemember<T extends {
+    get: (token: unknown) => unknown;
+}>(ctx: T): RememberAccessor;
+/**
+ * Try to get the RememberAccessor, returning undefined if not available.
+ * Use this for graceful degradation when the plugin might not be installed.
+ */
+export declare function tryGetRemember<T extends {
+    tryGet?: (token: unknown) => unknown;
+}>(ctx: T): RememberAccessor | undefined;
+//# sourceMappingURL=remember.context-extension.d.ts.map

package/remember.context-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.context-extension.d.ts","sourceRoot":"","sources":["../src/remember.context-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAO/E,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,oBAAoB;QAC5B;;;;;;;;;;;WAWG;QACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KACrC;IAGD,UAAU,aAAa;QACrB;;;WAGG;QACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KACrC;CACF;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAEpG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,EAC/E,GAAG,EAAE,CAAC,GACL,gBAAgB,GAAG,SAAS,CAK9B"}