@frontmcp/plugin-remember 1.9.0 → 1.9.1-rc.2

package/esm/index.mjs

@@ -285,7 +285,7 @@ async function deserializeAndDecrypt(str, keySource) {
 }
 
 // plugins/plugin-remember/src/remember.errors.ts
-import { PublicMcpError } from "@frontmcp/sdk";
+import { InternalMcpError, PublicMcpError } from "@frontmcp/sdk";
 var RememberIdentityError = class extends PublicMcpError {
   name = "RememberIdentityError";
   constructor(message) {
@@ -302,6 +302,12 @@ var RememberScopeNotAllowedError = class extends PublicMcpError {
     );
   }
 };
+var RememberConfigurationError = class extends InternalMcpError {
+  name = "RememberConfigurationError";
+  constructor(message) {
+    super(message, "REMEMBER_CONFIGURATION");
+  }
+};
 
 // plugins/plugin-remember/src/remember.legacy-purge.ts
 var LEGACY_SCOPES = ["session", "tool", "user"];
@@ -320,7 +326,7 @@ function parseFirstSeenAt(raw) {
     return void 0;
   }
 }
-async function readLayoutFirstSeenAt(store, keyPrefix, logger) {
+async function readLayoutFirstSeenAt(store, keyPrefix, logger, markerTtlSeconds) {
   const key = `${keyPrefix}${LAYOUT_MARKER_KEY}`;
   const standDown = (reason, extra = {}) => {
     logger?.debug?.(`remember: ${reason}, legacy purge stood down`, { key, ...extra });
@@ -334,10 +340,10 @@ async function readLayoutFirstSeenAt(store, keyPrefix, logger) {
     const marker = { version: LAYOUT_VERSION, firstSeenAt: Date.now() };
     const serialized = JSON.stringify(marker);
     if (!store.setIfAbsent) {
-      await store.setValue(key, serialized);
+      await store.setValue(key, serialized, markerTtlSeconds);
       return marker.firstSeenAt;
     }
-    if (await store.setIfAbsent(key, serialized)) {
+    if (await store.setIfAbsent(key, serialized, markerTtlSeconds)) {
       return marker.firstSeenAt;
     }
     const winner = await store.getValue(key);
@@ -381,6 +387,7 @@ function scheduleLegacyRememberPurge(store, keyPrefix, options = {}) {
   if (scheduled.has(store)) return;
   scheduled.add(store);
   const delayMs = options.delayMs ?? DEFAULT_LEGACY_PURGE_DELAY_MS;
+  const markerTtlSeconds = options.defaultTTL ? Math.max(options.defaultTTL, Math.ceil(2 * delayMs / 1e3)) : void 0;
   const arm = (waitMs) => {
     const timer = setTimeout(
       () => {
@@ -391,7 +398,7 @@ function scheduleLegacyRememberPurge(store, keyPrefix, options = {}) {
     timer.unref?.();
   };
   const attempt = async () => {
-    const firstSeenAt = await readLayoutFirstSeenAt(store, keyPrefix, options.logger);
+    const firstSeenAt = await readLayoutFirstSeenAt(store, keyPrefix, options.logger, markerTtlSeconds);
     if (firstSeenAt === void 0) return;
     const remainingMs = firstSeenAt + delayMs - Date.now();
     if (remainingMs > 0) {
@@ -411,6 +418,9 @@ function encodeKeyPart(value) {
 function remainingSeconds(expiresAt, now) {
   return Math.max(1, Math.ceil((expiresAt - now) / 1e3));
 }
+function expiryAfter(ttlSeconds, now) {
+  return ttlSeconds ? now + ttlSeconds * 1e3 : void 0;
+}
 var RememberAccessor = class {
   store;
   ctx;
@@ -424,7 +434,11 @@ var RememberAccessor = class {
     this.keyPrefix = config.keyPrefix ?? "remember:";
     this.encryptionEnabled = config.encryption?.enabled !== false;
     if (!config.skipLegacyPurge) {
-      scheduleLegacyRememberPurge(store, this.keyPrefix, { delayMs: config.legacyPurgeDelayMs, logger });
+      scheduleLegacyRememberPurge(store, this.keyPrefix, {
+        delayMs: config.legacyPurgeDelayMs,
+        defaultTTL: config.defaultTTL,
+        logger
+      });
     }
   }
   // ─────────────────────────────────────────────────────────────────────────────
@@ -433,23 +447,29 @@ var RememberAccessor = class {
   /**
    * Store a value in memory.
    *
+   * Without a `ttl`, the plugin's `defaultTTL` applies, and the entry records the deadline either one sets.
+   *
    * @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)
+   * @returns The stored entry, with its `expiresAt` deadline
    */
   async set(key, value, options = {}) {
     const scope = options.scope ?? "session";
     const storageKey = this.buildStorageKey(key, scope);
+    const now = Date.now();
+    const ttlSeconds = options.ttl ?? this.config.defaultTTL;
     const entry = {
       value,
       brand: options.brand,
-      createdAt: Date.now(),
-      updatedAt: Date.now(),
-      expiresAt: options.ttl ? Date.now() + options.ttl * 1e3 : void 0,
+      createdAt: now,
+      updatedAt: now,
+      expiresAt: expiryAfter(ttlSeconds, now),
       metadata: options.metadata
     };
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    await this.store.setValue(storageKey, serialized, options.ttl);
+    await this.store.setValue(storageKey, serialized, ttlSeconds);
+    return entry;
   }
   /**
    * Retrieve a value from memory.
@@ -514,6 +534,7 @@ var RememberAccessor = class {
    *
    * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
    * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+   * An entry with no recorded expiry gets the plugin's `defaultTTL` from now, as the store would give it.
    *
    * @param key - The key to update
    * @param value - The new value
@@ -524,7 +545,7 @@ var RememberAccessor = class {
     const existing = await this.getEntry(key, { scope });
     if (!existing) return false;
     const now = Date.now();
-    const expiresAt = options.ttl ? now + options.ttl * 1e3 : existing.expiresAt;
+    const expiresAt = expiryAfter(options.ttl, now) ?? existing.expiresAt ?? expiryAfter(this.config.defaultTTL, now);
     const entry = {
       ...existing,
       value,
@@ -533,7 +554,9 @@ var RememberAccessor = class {
     };
     const storageKey = this.buildStorageKey(key, scope);
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    const storageTtl = options.ttl ?? (expiresAt !== void 0 ? remainingSeconds(expiresAt, now) : void 0);
+    const writtenAt = Date.now();
+    if (expiresAt !== void 0 && expiresAt <= writtenAt) return false;
+    const storageTtl = expiresAt !== void 0 ? remainingSeconds(expiresAt, writtenAt) : void 0;
     await this.store.setValue(storageKey, serialized, storageTtl);
     return true;
   }
@@ -654,8 +677,9 @@ var RememberAccessor = class {
   }
   /** The entry stored under `storageKey`, if readable and unexpired; an expired one is deleted. */
   async readEntry(storageKey, scope) {
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return void 0;
+    const stored = await this.store.getValue(storageKey);
+    if (!stored) return void 0;
+    const raw = typeof stored === "string" ? stored : JSON.stringify(stored);
     const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
     if (!entry) return void 0;
     if (entry.expiresAt && Date.now() > entry.expiresAt) {
@@ -690,12 +714,14 @@ function createRememberAccessor(store, ctx, config, logger) {
 import { Provider as Provider2, ProviderScope as ProviderScope2 } from "@frontmcp/sdk";
 var MAX_TIMEOUT_MS = 2 ** 31 - 1;
 var RememberMemoryProvider = class {
-  memory = /* @__PURE__ */ new Map();
-  sweeper;
-  constructor(sweepIntervalSeconds = 60) {
+  constructor(sweepIntervalSeconds = 60, defaultTTL) {
+    this.defaultTTL = defaultTTL;
     this.sweeper = setInterval(() => this.sweep(), sweepIntervalSeconds * 1e3);
     this.sweeper.unref?.();
   }
+  defaultTTL;
+  memory = /* @__PURE__ */ new Map();
+  sweeper;
   /**
    * Store a value with optional TTL.
    * Always JSON-serializes the value for consistent storage/retrieval.
@@ -705,8 +731,9 @@ var RememberMemoryProvider = class {
     const existing = this.memory.get(key);
     if (existing?.timeout) clearTimeout(existing.timeout);
     const entry = { value: strValue };
-    if (ttlSeconds && ttlSeconds > 0) {
-      const ttlMs = ttlSeconds * 1e3;
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    if (ttl && ttl > 0) {
+      const ttlMs = ttl * 1e3;
       entry.expiresAt = Date.now() + ttlMs;
       if (ttlMs <= MAX_TIMEOUT_MS) {
         entry.timeout = setTimeout(() => {
@@ -865,10 +892,13 @@ var RememberRedisProvider = class {
    * Include any separator (e.g., "myapp:" or "user:123:") as part of the prefix.
    */
   keyPrefix;
+  /** TTL in seconds for values stored without one. */
+  defaultTTL;
   /** True if this provider created the client (and should close it), false if externally provided */
   ownsClient;
   constructor(options) {
     this.keyPrefix = options.keyPrefix ?? "";
+    this.defaultTTL = options.defaultTTL;
     if (options.type === "redis-client") {
       this.client = options.client;
       this.ownsClient = false;
@@ -913,9 +943,10 @@ var RememberRedisProvider = class {
       }
     }
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
-    if (ttlSeconds !== void 0 && ttlSeconds > 0) {
-      await this.client.set(fullKey, strValue, "EX", ttlSeconds);
+    const strValue = JSON.stringify(value);
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    if (ttl !== void 0 && ttl > 0) {
+      await this.client.set(fullKey, strValue, "EX", ttl);
     } else {
       await this.client.set(fullKey, strValue);
     }
@@ -928,8 +959,9 @@ var RememberRedisProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
-    const result = ttlSeconds !== void 0 && ttlSeconds > 0 ? await this.client.set(fullKey, strValue, "EX", ttlSeconds, "NX") : await this.client.set(fullKey, strValue, "NX");
+    const strValue = JSON.stringify(value);
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    const result = ttl !== void 0 && ttl > 0 ? await this.client.set(fullKey, strValue, "EX", ttl, "NX") : await this.client.set(fullKey, strValue, "NX");
     return result === "OK";
   }
   /**
@@ -1005,8 +1037,11 @@ RememberRedisProvider = __decorateClass([
 
 // plugins/plugin-remember/src/providers/remember-vercel-kv.provider.ts
 import { Provider as Provider4, ProviderScope as ProviderScope4 } from "@frontmcp/sdk";
+import { getEnv } from "@frontmcp/utils";
 var RememberVercelKvProvider = class {
-  kv;
+  createClient;
+  connection;
+  client;
   keyPrefix;
   defaultTTL;
   constructor(options = {}) {
@@ -1018,17 +1053,23 @@ var RememberVercelKvProvider = class {
         `RememberVercelKvProvider: Both 'url' and 'token' must be provided together, or neither. Received: url=${hasUrl ? "provided" : "missing"}, token=${hasToken ? "provided" : "missing"}`
       );
     }
-    if (options.url && options.token) {
-      this.kv = vercelKv.createClient({
-        url: options.url,
-        token: options.token
-      });
-    } else {
-      this.kv = vercelKv.kv;
-    }
+    this.createClient = vercelKv.createClient;
+    this.connection = { url: options.url, token: options.token };
     this.keyPrefix = options.keyPrefix ?? "remember:";
     this.defaultTTL = options.defaultTTL;
   }
+  /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+  get kv() {
+    if (!this.client) {
+      const url = this.connection.url ?? getEnv("KV_REST_API_URL");
+      const token = this.connection.token ?? getEnv("KV_REST_API_TOKEN");
+      if (!url || !token) {
+        throw new Error("RememberVercelKvProvider: pass url and token, or set KV_REST_API_URL and KV_REST_API_TOKEN.");
+      }
+      this.client = this.createClient({ url, token, automaticDeserialization: false });
+    }
+    return this.client;
+  }
   prefixKey(key) {
     return `${this.keyPrefix}${key}`;
   }
@@ -1037,7 +1078,7 @@ var RememberVercelKvProvider = class {
    */
   async setValue(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     if (ttl && ttl > 0) {
       await this.kv.set(fullKey, strValue, { ex: ttl });
@@ -1053,7 +1094,7 @@ var RememberVercelKvProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     const result = ttl && ttl > 0 ? await this.kv.set(fullKey, strValue, { nx: true, ex: ttl }) : await this.kv.set(fullKey, strValue, { nx: true });
     return result === "OK";
@@ -1064,15 +1105,12 @@ var RememberVercelKvProvider = class {
   async getValue(key, defaultValue) {
     const fullKey = this.prefixKey(key);
     const raw = await this.kv.get(fullKey);
-    if (raw === null || raw === void 0) return defaultValue;
-    if (typeof raw === "string") {
-      try {
-        return JSON.parse(raw);
-      } catch {
-        return raw;
-      }
+    if (raw === null) return defaultValue;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
     }
-    return raw;
   }
   /**
    * Delete a key.
@@ -1106,7 +1144,7 @@ var RememberVercelKvProvider = class {
         for (const key of keys) {
           result.push(key.slice(this.keyPrefix.length));
         }
-      } while (cursor !== 0);
+      } while (String(cursor) !== "0");
     } catch {
       try {
         const keys = await this.kv.keys(searchPattern);
@@ -1329,7 +1367,7 @@ var rememberThisInputSchema = {
   key: z5.string().min(1).describe('What to call this memory (e.g., "user_preference", "last_action")'),
   value: z5.unknown().describe("The value to remember (any JSON-serializable data)"),
   scope: z5.enum(["session", "user", "tool", "global"]).optional().describe(REMEMBER_SCOPE_DESCRIPTION),
-  ttl: z5.number().positive().optional().describe("Forget after this many seconds"),
+  ttl: z5.number().int().positive().optional().describe("Forget after this many whole seconds"),
   brand: z5.enum(["preference", "cache", "state", "conversation", "custom"]).optional().describe("Type hint for the stored value")
 };
 var rememberThisOutputSchema = z5.object({
@@ -1359,17 +1397,16 @@ var RememberThisTool = class extends ToolContext4 {
     if (!allowedScopes.includes(scope)) {
       throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
     }
-    await remember.set(input.key, input.value, {
+    const entry = await remember.set(input.key, input.value, {
       scope,
       ttl: input.ttl,
       brand: input.brand
     });
-    const expiresAt = input.ttl ? Date.now() + input.ttl * 1e3 : void 0;
     return {
       success: true,
       key: input.key,
       scope,
-      expiresAt
+      expiresAt: entry.expiresAt
     };
   }
 };
@@ -1405,13 +1442,24 @@ function createRememberTools(prefix = "") {
 }
 
 // plugins/plugin-remember/src/remember.plugin.ts
+function withCheckedDefaultTTL(options) {
+  const { defaultTTL } = options;
+  if (defaultTTL === void 0) return options;
+  if (defaultTTL === 0) return { ...options, defaultTTL: void 0 };
+  if (!Number.isInteger(defaultTTL) || defaultTTL < 0) {
+    throw new RememberConfigurationError(
+      `RememberPlugin defaultTTL must be a whole number of seconds (0 for no default expiry), got ${defaultTTL}`
+    );
+  }
+  return options;
+}
 var RememberPlugin = class extends DynamicPlugin {
   options;
   constructor(options = {}) {
     super();
     this.options = {
       ...RememberPlugin.defaultOptions,
-      ...options
+      ...withCheckedDefaultTTL(options)
     };
   }
 };
@@ -1432,7 +1480,7 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
   const providers = [];
   const config = {
     ...RememberPlugin.defaultOptions,
-    ...options
+    ...withCheckedDefaultTTL(options)
   };
   switch (config.type) {
     case "global-store":
@@ -1511,7 +1559,7 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
         provide: RememberStoreToken,
         // Built per server: `init()` runs once, so a value here would be shared by every server using it.
         inject: () => [],
-        useFactory: () => new RememberMemoryProvider()
+        useFactory: () => new RememberMemoryProvider(void 0, config.defaultTTL)
       });
       break;
   }
@@ -1587,6 +1635,7 @@ export {
   RememberAccessor,
   RememberAccessorToken,
   RememberConfigToken,
+  RememberConfigurationError,
   RememberIdentityError,
   RememberMemoryProvider,
   RememberPlugin,

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-remember",
-  "version": "1.9.0",
+  "version": "1.9.1-rc.2",
   "description": "Remember plugin for FrontMCP - encrypted session memory with approval system for secure tool authorization",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,12 +49,12 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.9.0",
-    "@frontmcp/utils": "1.9.0",
+    "@frontmcp/sdk": "1.9.1-rc.2",
+    "@frontmcp/utils": "1.9.1-rc.2",
     "ioredis": "^5.8.0"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.9.0",
+    "@frontmcp/lazy-zod": "1.9.1-rc.2",
     "@vercel/kv": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {

package/index.d.ts

@@ -45,7 +45,7 @@ export type { RememberScope, RememberEntry, RememberPluginOptions, RememberPlugi
 export { brand } from './remember.types';
 export type { RememberStoreInterface } from './providers/remember-store.interface';
 export { RememberAccessor } from './providers/remember-accessor.provider';
-export { RememberIdentityError, RememberScopeNotAllowedError } from './remember.errors';
+export { RememberConfigurationError, RememberIdentityError, RememberScopeNotAllowedError } from './remember.errors';
 export { default as RememberMemoryProvider } from './providers/remember-memory.provider';
 export { default as RememberRedisProvider } from './providers/remember-redis.provider';
 export { default as RememberVercelKvProvider } from './providers/remember-vercel-kv.provider';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,YAAY,EACV,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAG9F,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGpG,YAAY,EACV,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACpH,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAG9F,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/index.js

@@ -46,6 +46,7 @@ __export(index_exports, {
   RememberAccessor: () => RememberAccessor,
   RememberAccessorToken: () => RememberAccessorToken,
   RememberConfigToken: () => RememberConfigToken,
+  RememberConfigurationError: () => RememberConfigurationError,
   RememberIdentityError: () => RememberIdentityError,
   RememberMemoryProvider: () => RememberMemoryProvider,
   RememberPlugin: () => RememberPlugin,
@@ -321,6 +322,12 @@ var RememberScopeNotAllowedError = class extends import_sdk.PublicMcpError {
     );
   }
 };
+var RememberConfigurationError = class extends import_sdk.InternalMcpError {
+  name = "RememberConfigurationError";
+  constructor(message) {
+    super(message, "REMEMBER_CONFIGURATION");
+  }
+};
 
 // plugins/plugin-remember/src/remember.legacy-purge.ts
 var LEGACY_SCOPES = ["session", "tool", "user"];
@@ -339,7 +346,7 @@ function parseFirstSeenAt(raw) {
     return void 0;
   }
 }
-async function readLayoutFirstSeenAt(store, keyPrefix, logger) {
+async function readLayoutFirstSeenAt(store, keyPrefix, logger, markerTtlSeconds) {
   const key = `${keyPrefix}${LAYOUT_MARKER_KEY}`;
   const standDown = (reason, extra = {}) => {
     logger?.debug?.(`remember: ${reason}, legacy purge stood down`, { key, ...extra });
@@ -353,10 +360,10 @@ async function readLayoutFirstSeenAt(store, keyPrefix, logger) {
     const marker = { version: LAYOUT_VERSION, firstSeenAt: Date.now() };
     const serialized = JSON.stringify(marker);
     if (!store.setIfAbsent) {
-      await store.setValue(key, serialized);
+      await store.setValue(key, serialized, markerTtlSeconds);
       return marker.firstSeenAt;
     }
-    if (await store.setIfAbsent(key, serialized)) {
+    if (await store.setIfAbsent(key, serialized, markerTtlSeconds)) {
       return marker.firstSeenAt;
     }
     const winner = await store.getValue(key);
@@ -400,6 +407,7 @@ function scheduleLegacyRememberPurge(store, keyPrefix, options = {}) {
   if (scheduled.has(store)) return;
   scheduled.add(store);
   const delayMs = options.delayMs ?? DEFAULT_LEGACY_PURGE_DELAY_MS;
+  const markerTtlSeconds = options.defaultTTL ? Math.max(options.defaultTTL, Math.ceil(2 * delayMs / 1e3)) : void 0;
   const arm = (waitMs) => {
     const timer = setTimeout(
       () => {
@@ -410,7 +418,7 @@ function scheduleLegacyRememberPurge(store, keyPrefix, options = {}) {
     timer.unref?.();
   };
   const attempt = async () => {
-    const firstSeenAt = await readLayoutFirstSeenAt(store, keyPrefix, options.logger);
+    const firstSeenAt = await readLayoutFirstSeenAt(store, keyPrefix, options.logger, markerTtlSeconds);
     if (firstSeenAt === void 0) return;
     const remainingMs = firstSeenAt + delayMs - Date.now();
     if (remainingMs > 0) {
@@ -430,6 +438,9 @@ function encodeKeyPart(value) {
 function remainingSeconds(expiresAt, now) {
   return Math.max(1, Math.ceil((expiresAt - now) / 1e3));
 }
+function expiryAfter(ttlSeconds, now) {
+  return ttlSeconds ? now + ttlSeconds * 1e3 : void 0;
+}
 var RememberAccessor = class {
   store;
   ctx;
@@ -443,7 +454,11 @@ var RememberAccessor = class {
     this.keyPrefix = config.keyPrefix ?? "remember:";
     this.encryptionEnabled = config.encryption?.enabled !== false;
     if (!config.skipLegacyPurge) {
-      scheduleLegacyRememberPurge(store, this.keyPrefix, { delayMs: config.legacyPurgeDelayMs, logger });
+      scheduleLegacyRememberPurge(store, this.keyPrefix, {
+        delayMs: config.legacyPurgeDelayMs,
+        defaultTTL: config.defaultTTL,
+        logger
+      });
     }
   }
   // ─────────────────────────────────────────────────────────────────────────────
@@ -452,23 +467,29 @@ var RememberAccessor = class {
   /**
    * Store a value in memory.
    *
+   * Without a `ttl`, the plugin's `defaultTTL` applies, and the entry records the deadline either one sets.
+   *
    * @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)
+   * @returns The stored entry, with its `expiresAt` deadline
    */
   async set(key, value, options = {}) {
     const scope = options.scope ?? "session";
     const storageKey = this.buildStorageKey(key, scope);
+    const now = Date.now();
+    const ttlSeconds = options.ttl ?? this.config.defaultTTL;
     const entry = {
       value,
       brand: options.brand,
-      createdAt: Date.now(),
-      updatedAt: Date.now(),
-      expiresAt: options.ttl ? Date.now() + options.ttl * 1e3 : void 0,
+      createdAt: now,
+      updatedAt: now,
+      expiresAt: expiryAfter(ttlSeconds, now),
       metadata: options.metadata
     };
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    await this.store.setValue(storageKey, serialized, options.ttl);
+    await this.store.setValue(storageKey, serialized, ttlSeconds);
+    return entry;
   }
   /**
    * Retrieve a value from memory.
@@ -533,6 +554,7 @@ var RememberAccessor = class {
    *
    * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
    * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+   * An entry with no recorded expiry gets the plugin's `defaultTTL` from now, as the store would give it.
    *
    * @param key - The key to update
    * @param value - The new value
@@ -543,7 +565,7 @@ var RememberAccessor = class {
     const existing = await this.getEntry(key, { scope });
     if (!existing) return false;
     const now = Date.now();
-    const expiresAt = options.ttl ? now + options.ttl * 1e3 : existing.expiresAt;
+    const expiresAt = expiryAfter(options.ttl, now) ?? existing.expiresAt ?? expiryAfter(this.config.defaultTTL, now);
     const entry = {
       ...existing,
       value,
@@ -552,7 +574,9 @@ var RememberAccessor = class {
     };
     const storageKey = this.buildStorageKey(key, scope);
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    const storageTtl = options.ttl ?? (expiresAt !== void 0 ? remainingSeconds(expiresAt, now) : void 0);
+    const writtenAt = Date.now();
+    if (expiresAt !== void 0 && expiresAt <= writtenAt) return false;
+    const storageTtl = expiresAt !== void 0 ? remainingSeconds(expiresAt, writtenAt) : void 0;
     await this.store.setValue(storageKey, serialized, storageTtl);
     return true;
   }
@@ -673,8 +697,9 @@ var RememberAccessor = class {
   }
   /** The entry stored under `storageKey`, if readable and unexpired; an expired one is deleted. */
   async readEntry(storageKey, scope) {
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return void 0;
+    const stored = await this.store.getValue(storageKey);
+    if (!stored) return void 0;
+    const raw = typeof stored === "string" ? stored : JSON.stringify(stored);
     const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
     if (!entry) return void 0;
     if (entry.expiresAt && Date.now() > entry.expiresAt) {
@@ -709,12 +734,14 @@ function createRememberAccessor(store, ctx, config, logger) {
 var import_sdk3 = require("@frontmcp/sdk");
 var MAX_TIMEOUT_MS = 2 ** 31 - 1;
 var RememberMemoryProvider = class {
-  memory = /* @__PURE__ */ new Map();
-  sweeper;
-  constructor(sweepIntervalSeconds = 60) {
+  constructor(sweepIntervalSeconds = 60, defaultTTL) {
+    this.defaultTTL = defaultTTL;
     this.sweeper = setInterval(() => this.sweep(), sweepIntervalSeconds * 1e3);
     this.sweeper.unref?.();
   }
+  defaultTTL;
+  memory = /* @__PURE__ */ new Map();
+  sweeper;
   /**
    * Store a value with optional TTL.
    * Always JSON-serializes the value for consistent storage/retrieval.
@@ -724,8 +751,9 @@ var RememberMemoryProvider = class {
     const existing = this.memory.get(key);
     if (existing?.timeout) clearTimeout(existing.timeout);
     const entry = { value: strValue };
-    if (ttlSeconds && ttlSeconds > 0) {
-      const ttlMs = ttlSeconds * 1e3;
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    if (ttl && ttl > 0) {
+      const ttlMs = ttl * 1e3;
       entry.expiresAt = Date.now() + ttlMs;
       if (ttlMs <= MAX_TIMEOUT_MS) {
         entry.timeout = setTimeout(() => {
@@ -884,10 +912,13 @@ var RememberRedisProvider = class {
    * Include any separator (e.g., "myapp:" or "user:123:") as part of the prefix.
    */
   keyPrefix;
+  /** TTL in seconds for values stored without one. */
+  defaultTTL;
   /** True if this provider created the client (and should close it), false if externally provided */
   ownsClient;
   constructor(options) {
     this.keyPrefix = options.keyPrefix ?? "";
+    this.defaultTTL = options.defaultTTL;
     if (options.type === "redis-client") {
       this.client = options.client;
       this.ownsClient = false;
@@ -932,9 +963,10 @@ var RememberRedisProvider = class {
       }
     }
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
-    if (ttlSeconds !== void 0 && ttlSeconds > 0) {
-      await this.client.set(fullKey, strValue, "EX", ttlSeconds);
+    const strValue = JSON.stringify(value);
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    if (ttl !== void 0 && ttl > 0) {
+      await this.client.set(fullKey, strValue, "EX", ttl);
     } else {
       await this.client.set(fullKey, strValue);
     }
@@ -947,8 +979,9 @@ var RememberRedisProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
-    const result = ttlSeconds !== void 0 && ttlSeconds > 0 ? await this.client.set(fullKey, strValue, "EX", ttlSeconds, "NX") : await this.client.set(fullKey, strValue, "NX");
+    const strValue = JSON.stringify(value);
+    const ttl = ttlSeconds ?? this.defaultTTL;
+    const result = ttl !== void 0 && ttl > 0 ? await this.client.set(fullKey, strValue, "EX", ttl, "NX") : await this.client.set(fullKey, strValue, "NX");
     return result === "OK";
   }
   /**
@@ -1024,8 +1057,11 @@ RememberRedisProvider = __decorateClass([
 
 // plugins/plugin-remember/src/providers/remember-vercel-kv.provider.ts
 var import_sdk5 = require("@frontmcp/sdk");
+var import_utils3 = require("@frontmcp/utils");
 var RememberVercelKvProvider = class {
-  kv;
+  createClient;
+  connection;
+  client;
   keyPrefix;
   defaultTTL;
   constructor(options = {}) {
@@ -1037,17 +1073,23 @@ var RememberVercelKvProvider = class {
         `RememberVercelKvProvider: Both 'url' and 'token' must be provided together, or neither. Received: url=${hasUrl ? "provided" : "missing"}, token=${hasToken ? "provided" : "missing"}`
       );
     }
-    if (options.url && options.token) {
-      this.kv = vercelKv.createClient({
-        url: options.url,
-        token: options.token
-      });
-    } else {
-      this.kv = vercelKv.kv;
-    }
+    this.createClient = vercelKv.createClient;
+    this.connection = { url: options.url, token: options.token };
     this.keyPrefix = options.keyPrefix ?? "remember:";
     this.defaultTTL = options.defaultTTL;
   }
+  /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+  get kv() {
+    if (!this.client) {
+      const url = this.connection.url ?? (0, import_utils3.getEnv)("KV_REST_API_URL");
+      const token = this.connection.token ?? (0, import_utils3.getEnv)("KV_REST_API_TOKEN");
+      if (!url || !token) {
+        throw new Error("RememberVercelKvProvider: pass url and token, or set KV_REST_API_URL and KV_REST_API_TOKEN.");
+      }
+      this.client = this.createClient({ url, token, automaticDeserialization: false });
+    }
+    return this.client;
+  }
   prefixKey(key) {
     return `${this.keyPrefix}${key}`;
   }
@@ -1056,7 +1098,7 @@ var RememberVercelKvProvider = class {
    */
   async setValue(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     if (ttl && ttl > 0) {
       await this.kv.set(fullKey, strValue, { ex: ttl });
@@ -1072,7 +1114,7 @@ var RememberVercelKvProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     const result = ttl && ttl > 0 ? await this.kv.set(fullKey, strValue, { nx: true, ex: ttl }) : await this.kv.set(fullKey, strValue, { nx: true });
     return result === "OK";
@@ -1083,15 +1125,12 @@ var RememberVercelKvProvider = class {
   async getValue(key, defaultValue) {
     const fullKey = this.prefixKey(key);
     const raw = await this.kv.get(fullKey);
-    if (raw === null || raw === void 0) return defaultValue;
-    if (typeof raw === "string") {
-      try {
-        return JSON.parse(raw);
-      } catch {
-        return raw;
-      }
+    if (raw === null) return defaultValue;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
     }
-    return raw;
   }
   /**
    * Delete a key.
@@ -1125,7 +1164,7 @@ var RememberVercelKvProvider = class {
         for (const key of keys) {
           result.push(key.slice(this.keyPrefix.length));
         }
-      } while (cursor !== 0);
+      } while (String(cursor) !== "0");
     } catch {
       try {
         const keys = await this.kv.keys(searchPattern);
@@ -1348,7 +1387,7 @@ var rememberThisInputSchema = {
   key: import_lazy_zod5.z.string().min(1).describe('What to call this memory (e.g., "user_preference", "last_action")'),
   value: import_lazy_zod5.z.unknown().describe("The value to remember (any JSON-serializable data)"),
   scope: import_lazy_zod5.z.enum(["session", "user", "tool", "global"]).optional().describe(REMEMBER_SCOPE_DESCRIPTION),
-  ttl: import_lazy_zod5.z.number().positive().optional().describe("Forget after this many seconds"),
+  ttl: import_lazy_zod5.z.number().int().positive().optional().describe("Forget after this many whole seconds"),
   brand: import_lazy_zod5.z.enum(["preference", "cache", "state", "conversation", "custom"]).optional().describe("Type hint for the stored value")
 };
 var rememberThisOutputSchema = import_lazy_zod5.z.object({
@@ -1378,17 +1417,16 @@ var RememberThisTool = class extends import_sdk9.ToolContext {
     if (!allowedScopes.includes(scope)) {
       throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
     }
-    await remember.set(input.key, input.value, {
+    const entry = await remember.set(input.key, input.value, {
       scope,
       ttl: input.ttl,
       brand: input.brand
     });
-    const expiresAt = input.ttl ? Date.now() + input.ttl * 1e3 : void 0;
     return {
       success: true,
       key: input.key,
       scope,
-      expiresAt
+      expiresAt: entry.expiresAt
     };
   }
 };
@@ -1424,13 +1462,24 @@ function createRememberTools(prefix = "") {
 }
 
 // plugins/plugin-remember/src/remember.plugin.ts
+function withCheckedDefaultTTL(options) {
+  const { defaultTTL } = options;
+  if (defaultTTL === void 0) return options;
+  if (defaultTTL === 0) return { ...options, defaultTTL: void 0 };
+  if (!Number.isInteger(defaultTTL) || defaultTTL < 0) {
+    throw new RememberConfigurationError(
+      `RememberPlugin defaultTTL must be a whole number of seconds (0 for no default expiry), got ${defaultTTL}`
+    );
+  }
+  return options;
+}
 var RememberPlugin = class extends import_sdk11.DynamicPlugin {
   options;
   constructor(options = {}) {
     super();
     this.options = {
       ...RememberPlugin.defaultOptions,
-      ...options
+      ...withCheckedDefaultTTL(options)
     };
   }
 };
@@ -1451,7 +1500,7 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
   const providers = [];
   const config = {
     ...RememberPlugin.defaultOptions,
-    ...options
+    ...withCheckedDefaultTTL(options)
   };
   switch (config.type) {
     case "global-store":
@@ -1530,7 +1579,7 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
         provide: RememberStoreToken,
         // Built per server: `init()` runs once, so a value here would be shared by every server using it.
         inject: () => [],
-        useFactory: () => new RememberMemoryProvider()
+        useFactory: () => new RememberMemoryProvider(void 0, config.defaultTTL)
       });
       break;
   }
@@ -1607,6 +1656,7 @@ function tryGetRemember(ctx) {
   RememberAccessor,
   RememberAccessorToken,
   RememberConfigToken,
+  RememberConfigurationError,
   RememberIdentityError,
   RememberMemoryProvider,
   RememberPlugin,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-remember",
-  "version": "1.9.0",
+  "version": "1.9.1-rc.2",
   "description": "Remember plugin for FrontMCP - encrypted session memory with approval system for secure tool authorization",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,12 +49,12 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.9.0",
-    "@frontmcp/utils": "1.9.0",
+    "@frontmcp/sdk": "1.9.1-rc.2",
+    "@frontmcp/utils": "1.9.1-rc.2",
     "ioredis": "^5.8.0"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.9.0",
+    "@frontmcp/lazy-zod": "1.9.1-rc.2",
     "@vercel/kv": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {

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

@@ -35,11 +35,14 @@ export declare class RememberAccessor {
     /**
      * Store a value in memory.
      *
+     * Without a `ttl`, the plugin's `defaultTTL` applies, and the entry records the deadline either one sets.
+     *
      * @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)
+     * @returns The stored entry, with its `expiresAt` deadline
      */
-    set<T>(key: string, value: T, options?: RememberSetOptions): Promise<void>;
+    set<T>(key: string, value: T, options?: RememberSetOptions): Promise<RememberEntry<T>>;
     /**
      * Retrieve a value from memory.
      *
@@ -85,6 +88,7 @@ export declare class RememberAccessor {
      *
      * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
      * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+     * An entry with no recorded expiry gets the plugin's `defaultTTL` from now, as the store would give it.
      *
      * @param key - The key to update
      * @param value - The new value

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

@@ -1 +1 @@
-{"version":3,"file":"remember-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-accessor.provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remember-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-accessor.provider.ts"],"names":[],"mappings":"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"}

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

@@ -4,9 +4,10 @@ import type { RememberStoreInterface } from './remember-store.interface';
  * Provides fast, local storage with automatic TTL expiration.
  */
 export default class RememberMemoryProvider implements RememberStoreInterface {
+    private readonly defaultTTL?;
     private readonly memory;
     private sweeper?;
-    constructor(sweepIntervalSeconds?: number);
+    constructor(sweepIntervalSeconds?: number, defaultTTL?: number | undefined);
     /**
      * Store a value with optional TTL.
      * Always JSON-serializes the value for consistent storage/retrieval.

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

@@ -1 +1 @@
-{"version":3,"file":"remember-memory.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-memory.provider.ts"],"names":[],"mappings":"AAEA,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;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrF;;;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"}
+{"version":3,"file":"remember-memory.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-memory.provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAgBzE;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,sBAAsB;IAMzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAL9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,OAAO,CAAC,CAAiB;gBAG/B,oBAAoB,SAAK,EACR,UAAU,CAAC,EAAE,MAAM,YAAA;IAOtC;;;OAGG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B/E;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrF;;;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

@@ -15,6 +15,8 @@ export default class RememberRedisProvider implements RememberStoreInterface {
      * Include any separator (e.g., "myapp:" or "user:123:") as part of the prefix.
      */
     private readonly keyPrefix;
+    /** TTL in seconds for values stored without one. */
+    private readonly defaultTTL?;
     /** True if this provider created the client (and should close it), false if externally provided */
     private readonly ownsClient;
     constructor(options: RedisRememberOptions);

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

@@ -1 +1 @@
-{"version":3,"file":"remember-redis.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-redis.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;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;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrF;;;;;;;;;;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"}
+{"version":3,"file":"remember-redis.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-redis.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;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,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,OAAO,EAAE,oBAAoB;IA8BzC;;;;;;;OAOG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/E;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarF;;;;;;;;;;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

@@ -1,4 +1,4 @@
-import { type RootStorage, type NamespacedStorage, type StorageConfig } from '@frontmcp/utils';
+import { type NamespacedStorage, type RootStorage, type StorageConfig } from '@frontmcp/utils';
 import type { RememberStoreInterface } from './remember-store.interface';
 /**
  * Configuration options for RememberStorageProvider.

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

@@ -1 +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"}
+{"version":3,"file":"remember-storage.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-storage.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9G,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,CAKzB"}

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

@@ -17,10 +17,14 @@ export interface RememberVercelKvProviderOptions {
  * Provides serverless-compatible, edge-ready storage.
  */
 export default class RememberVercelKvProvider implements RememberStoreInterface {
-    private kv;
+    private readonly createClient;
+    private readonly connection;
+    private client?;
     private readonly keyPrefix;
     private readonly defaultTTL?;
     constructor(options?: RememberVercelKvProviderOptions);
+    /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+    private get kv();
     private prefixKey;
     /**
      * Store a value with optional TTL.

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

@@ -1 +1 @@
-{"version":3,"file":"remember-vercel-kv.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-vercel-kv.provider.ts"],"names":[],"mappings":"AAGA,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;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarF;;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"}
+{"version":3,"file":"remember-vercel-kv.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-vercel-kv.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAmBzE;;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,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,+BAAoC;IAoBzD,kGAAkG;IAClG,OAAO,KAAK,EAAE,GAUb;IAED,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;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAalF;;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.errors.d.ts

@@ -1,4 +1,4 @@
-import { PublicMcpError } from '@frontmcp/sdk';
+import { InternalMcpError, PublicMcpError } from '@frontmcp/sdk';
 /**
  * Raised when Remember has no per-client identity to namespace storage with
  * (GHSA-225p-f8jh-f3rh).
@@ -20,4 +20,9 @@ export declare class RememberScopeNotAllowedError extends PublicMcpError {
     readonly name = "RememberScopeNotAllowedError";
     constructor(scope: string, allowedScopes: readonly string[]);
 }
+/** Raised at startup for a plugin option that cannot work, such as a fractional or negative `defaultTTL`. */
+export declare class RememberConfigurationError extends InternalMcpError {
+    readonly name = "RememberConfigurationError";
+    constructor(message: string);
+}
 //# sourceMappingURL=remember.errors.d.ts.map

package/remember.errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember.errors.d.ts","sourceRoot":"","sources":["../src/remember.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,SAAkB,IAAI,2BAA2B;gBAErC,OAAO,EAAE,MAAM;CAG5B;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,cAAc;IAC9D,SAAkB,IAAI,kCAAkC;gBAE5C,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE;CAO5D"}
+{"version":3,"file":"remember.errors.d.ts","sourceRoot":"","sources":["../src/remember.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEjE;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,SAAkB,IAAI,2BAA2B;gBAErC,OAAO,EAAE,MAAM;CAG5B;AAED;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,cAAc;IAC9D,SAAkB,IAAI,kCAAkC;gBAE5C,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,MAAM,EAAE;CAO5D;AAED,6GAA6G;AAC7G,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,SAAkB,IAAI,gCAAgC;gBAE1C,OAAO,EAAE,MAAM;CAG5B"}

package/remember.legacy-purge.d.ts

@@ -16,7 +16,7 @@ import type { RememberStoreInterface } from './providers/remember-store.interfac
  * `undefined` means the clock could not be established, and the caller must not delete anything
  * on it.
  */
-export declare function readLayoutFirstSeenAt(store: RememberStoreInterface, keyPrefix: string, logger?: Pick<FrontMcpLogger, 'warn' | 'debug'>): Promise<number | undefined>;
+export declare function readLayoutFirstSeenAt(store: RememberStoreInterface, keyPrefix: string, logger?: Pick<FrontMcpLogger, 'warn' | 'debug'>, markerTtlSeconds?: number): Promise<number | undefined>;
 /**
  * Delete entries that the key-derivation and namespace-encoding changes orphaned.
  *
@@ -38,6 +38,7 @@ export declare function purgeLegacyRememberEntries(store: RememberStoreInterface
  */
 export declare function scheduleLegacyRememberPurge(store: RememberStoreInterface, keyPrefix: string, options?: {
     delayMs?: number;
+    defaultTTL?: number;
     logger?: Pick<FrontMcpLogger, 'warn' | 'debug'>;
 }): void;
 /** Test seam: forget which stores have a sweep armed. */

package/remember.legacy-purge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember.legacy-purge.d.ts","sourceRoot":"","sources":["../src/remember.legacy-purge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAiEnF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAC9C,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiC7B;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;CAAO,GAClF,IAAI,CAsCN;AAED,yDAAyD;AACzD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAEjF"}
+{"version":3,"file":"remember.legacy-purge.d.ts","sourceRoot":"","sources":["../src/remember.legacy-purge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAiEnF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,EAC/C,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiC7B;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;CAAO,GACvG,IAAI,CA0CN;AAED,yDAAyD;AACzD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAEjF"}

package/remember.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember.plugin.d.ts","sourceRoot":"","sources":["../src/remember.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EASb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAwBH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAa,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;IAC1G,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAI1C;IAEF,OAAO,EAAE,qBAAqB,CAAC;gBAEnB,OAAO,GAAE,0BAA+B;IAQpD;;;OAGG;IACH,OAAgB,YAAY,GAAI,SAAS,0BAA0B,KAAG,SAAS,QAAQ,EAAE,CACf;IAE1E;;OAEG;IACH,OAAgB,gBAAgB,GAAI,SAAS,0BAA0B,KAAG,YAAY,EAAE,CA2HtF;CACH"}
+{"version":3,"file":"remember.plugin.d.ts","sourceRoot":"","sources":["../src/remember.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EASb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAgB1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAwBH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAa,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;IAC1G,MAAM,CAAC,cAAc,EAAE,qBAAqB,CAI1C;IAEF,OAAO,EAAE,qBAAqB,CAAC;gBAEnB,OAAO,GAAE,0BAA+B;IAQpD;;;OAGG;IACH,OAAgB,YAAY,GAAI,SAAS,0BAA0B,KAAG,SAAS,QAAQ,EAAE,CACf;IAE1E;;OAEG;IACH,OAAgB,gBAAgB,GAAI,SAAS,0BAA0B,KAAG,YAAY,EAAE,CA2HtF;CACH"}

package/tools/remember-this.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember-this.tool.d.ts","sourceRoot":"","sources":["../../src/tools/remember-this.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AACvC,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;CASnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;gCAKnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,iBAAuC,GAAG,MAAM,CAO9F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,iBAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtF;AAED;;;GAGG;AAEH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACjD,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2BrE"}
+{"version":3,"file":"remember-this.tool.d.ts","sourceRoot":"","sources":["../../src/tools/remember-this.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AACvC,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;CASnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;gCAKnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,iBAAuC,GAAG,MAAM,CAO9F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,iBAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtF;AAED;;;GAGG;AAEH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACjD,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyBrE"}