@frontmcp/plugin-remember 1.8.5 → 1.8.7

package/index.js

@@ -50,6 +50,7 @@ __export(index_exports, {
   RememberMemoryProvider: () => RememberMemoryProvider,
   RememberPlugin: () => RememberPlugin,
   RememberRedisProvider: () => RememberRedisProvider,
+  RememberScopeNotAllowedError: () => RememberScopeNotAllowedError,
   RememberStoreToken: () => RememberStoreToken,
   RememberThisTool: () => RememberThisTool,
   RememberVercelKvProvider: () => RememberVercelKvProvider,
@@ -61,10 +62,10 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // plugins/plugin-remember/src/remember.plugin.ts
-var import_sdk5 = require("@frontmcp/sdk");
+var import_sdk11 = require("@frontmcp/sdk");
 
 // plugins/plugin-remember/src/providers/remember-accessor.provider.ts
-var import_sdk = require("@frontmcp/sdk");
+var import_sdk2 = require("@frontmcp/sdk");
 
 // plugins/plugin-remember/src/remember.crypto.ts
 var import_utils2 = require("@frontmcp/utils");
@@ -303,10 +304,21 @@ async function deserializeAndDecrypt(str, keySource) {
 }
 
 // plugins/plugin-remember/src/remember.errors.ts
-var RememberIdentityError = class extends Error {
+var import_sdk = require("@frontmcp/sdk");
+var RememberIdentityError = class extends import_sdk.PublicMcpError {
   name = "RememberIdentityError";
   constructor(message) {
-    super(message);
+    super(message, "REMEMBER_IDENTITY_REQUIRED", 403);
+  }
+};
+var RememberScopeNotAllowedError = class extends import_sdk.PublicMcpError {
+  name = "RememberScopeNotAllowedError";
+  constructor(scope, allowedScopes) {
+    super(
+      `Scope '${scope}' is not allowed. Allowed scopes: ${allowedScopes.join(", ")}`,
+      "REMEMBER_SCOPE_NOT_ALLOWED",
+      400
+    );
   }
 };
 
@@ -593,7 +605,7 @@ var RememberAccessor = class {
   get verifiedSessionId() {
     const authInfo = this.ctx.authInfo;
     return [authInfo?.sessionId, authInfo?.extra?.["sessionId"]].find(
-      (candidate) => typeof candidate === "string" && candidate.length > 0 && candidate !== import_sdk.STATELESS_SESSION_ID
+      (candidate) => typeof candidate === "string" && candidate.length > 0 && candidate !== import_sdk2.STATELESS_SESSION_ID
     );
   }
   /**
@@ -614,11 +626,11 @@ var RememberAccessor = class {
       return sessionId;
     }
     const userId = this.userId;
-    if (userId && !(0, import_sdk.isAnonymousSubject)(userId)) {
+    if (userId && !(0, import_sdk2.isAnonymousSubject)(userId)) {
       return `stateless-user:${userId}`;
     }
     throw new RememberIdentityError(
-      `Remember cannot use session or tool scope for an unauthenticated request without a verified session: a stateless request shares the session id "${import_sdk.STATELESS_SESSION_ID}", and an mcp-session-id the server did not verify could belong to any caller, so the data would be shared across clients. Authenticate the request, use a stateful transport, or choose the 'global' scope if the data really is shared.`
+      `Remember cannot use session or tool scope for an unauthenticated request without a verified session: a stateless request shares the session id "${import_sdk2.STATELESS_SESSION_ID}", and an mcp-session-id the server did not verify could belong to any caller, so the data would be shared across clients. Authenticate the request, use a stateful transport, or choose the 'global' scope if the data really is shared.`
     );
   }
   /**
@@ -628,7 +640,7 @@ var RememberAccessor = class {
    * `'unknown'`.
    */
   get toolName() {
-    return (0, import_sdk.getRunningTool)()?.fullName ?? this.ctx.flow?.name ?? "unknown";
+    return (0, import_sdk2.getRunningTool)()?.fullName ?? this.ctx.flow?.name ?? "unknown";
   }
   /**
    * Build the scope-specific prefix.
@@ -644,7 +656,7 @@ var RememberAccessor = class {
         return `${this.keyPrefix}${STORAGE_LAYOUT_VERSION}:session:${encodeKeyPart(this.resolveSessionIdentity())}:`;
       case "user": {
         const userId = this.userId;
-        if (!userId) {
+        if (!userId || (0, import_sdk2.isAnonymousSubject)(userId)) {
           throw new RememberIdentityError(
             "Remember cannot use user scope without an authenticated user: all unauthenticated callers would share one namespace. Authenticate the request or use the 'global' scope."
           );
@@ -680,10 +692,10 @@ var RememberAccessor = class {
   }
 };
 RememberAccessor = __decorateClass([
-  (0, import_sdk.Provider)({
+  (0, import_sdk2.Provider)({
     name: "provider:remember:accessor",
     description: "Context-scoped accessor for RememberPlugin storage",
-    scope: import_sdk.ProviderScope.CONTEXT
+    scope: import_sdk2.ProviderScope.CONTEXT
   })
 ], RememberAccessor);
 function createRememberAccessor(store, ctx, config, logger) {
@@ -691,7 +703,7 @@ function createRememberAccessor(store, ctx, config, logger) {
 }
 
 // plugins/plugin-remember/src/providers/remember-memory.provider.ts
-var import_sdk2 = require("@frontmcp/sdk");
+var import_sdk3 = require("@frontmcp/sdk");
 var MAX_TIMEOUT_MS = 2 ** 31 - 1;
 var RememberMemoryProvider = class {
   memory = /* @__PURE__ */ new Map();
@@ -852,16 +864,16 @@ var RememberMemoryProvider = class {
 __publicField(RememberMemoryProvider, "MAX_PATTERN_LENGTH", 500);
 __publicField(RememberMemoryProvider, "MAX_WILDCARDS", 20);
 RememberMemoryProvider = __decorateClass([
-  (0, import_sdk2.Provider)({
+  (0, import_sdk3.Provider)({
     name: "provider:remember:memory",
     description: "In-memory storage provider for RememberPlugin",
-    scope: import_sdk2.ProviderScope.GLOBAL
+    scope: import_sdk3.ProviderScope.GLOBAL
   })
 ], RememberMemoryProvider);
 
 // plugins/plugin-remember/src/providers/remember-redis.provider.ts
 var import_ioredis = __toESM(require("ioredis"));
-var import_sdk3 = require("@frontmcp/sdk");
+var import_sdk4 = require("@frontmcp/sdk");
 var RememberRedisProvider = class {
   client;
   /**
@@ -1000,15 +1012,15 @@ var RememberRedisProvider = class {
   }
 };
 RememberRedisProvider = __decorateClass([
-  (0, import_sdk3.Provider)({
+  (0, import_sdk4.Provider)({
     name: "provider:remember:redis",
     description: "Redis-based storage provider for RememberPlugin",
-    scope: import_sdk3.ProviderScope.GLOBAL
+    scope: import_sdk4.ProviderScope.GLOBAL
   })
 ], RememberRedisProvider);
 
 // plugins/plugin-remember/src/providers/remember-vercel-kv.provider.ts
-var import_sdk4 = require("@frontmcp/sdk");
+var import_sdk5 = require("@frontmcp/sdk");
 var RememberVercelKvProvider = class {
   kv;
   keyPrefix;
@@ -1131,10 +1143,10 @@ var RememberVercelKvProvider = class {
   }
 };
 RememberVercelKvProvider = __decorateClass([
-  (0, import_sdk4.Provider)({
+  (0, import_sdk5.Provider)({
     name: "provider:remember:vercel-kv",
     description: "Vercel KV-based storage provider for RememberPlugin",
-    scope: import_sdk4.ProviderScope.GLOBAL
+    scope: import_sdk5.ProviderScope.GLOBAL
   })
 ], RememberVercelKvProvider);
 
@@ -1149,8 +1161,267 @@ var RememberAccessorToken = /* @__PURE__ */ Symbol(
   "plugin:remember:accessor"
 );
 
+// plugins/plugin-remember/src/tools/remember-tools.factory.ts
+var import_sdk10 = require("@frontmcp/sdk");
+
+// plugins/plugin-remember/src/tools/forget.tool.ts
+var import_lazy_zod2 = require("@frontmcp/lazy-zod");
+var import_sdk6 = require("@frontmcp/sdk");
+
+// plugins/plugin-remember/src/tools/remember-scope.description.ts
+var REMEMBER_SCOPE_DESCRIPTION = "Whose memory to use (default: session). session: this session; without one (stateless HTTP, MCP 2026-07-28), the signed-in caller across its requests. user: the signed-in caller, across all of its sessions. tool: the tool running the call, for the same caller as session; each memory tool has its own, so the other memory tools do not see what one of them stores in tool scope. global: shared by every caller. An anonymous caller cannot use user scope, nor session or tool scope without a session.";
+
+// plugins/plugin-remember/src/tools/remember-tool-names.ts
+function rememberToolNames(prefix = "") {
+  return {
+    rememberThis: `${prefix}remember_this`,
+    recall: `${prefix}recall`,
+    forget: `${prefix}forget`,
+    listMemories: `${prefix}list_memories`
+  };
+}
+
+// plugins/plugin-remember/src/tools/forget.tool.ts
+var forgetInputSchema = {
+  key: import_lazy_zod2.z.string().min(1).describe("What memory to forget"),
+  scope: import_lazy_zod2.z.enum(["session", "user", "tool", "global"]).optional().describe(REMEMBER_SCOPE_DESCRIPTION)
+};
+var forgetOutputSchema = import_lazy_zod2.z.object({
+  success: import_lazy_zod2.z.boolean(),
+  key: import_lazy_zod2.z.string(),
+  scope: import_lazy_zod2.z.string(),
+  existed: import_lazy_zod2.z.boolean()
+});
+function forgetDescription() {
+  return "Forget a previously remembered value. Use this when the user wants to delete stored preferences or information.";
+}
+function forgetToolMetadata(names = rememberToolNames()) {
+  return {
+    name: names.forget,
+    description: forgetDescription(),
+    inputSchema: forgetInputSchema,
+    outputSchema: forgetOutputSchema,
+    annotations: { readOnlyHint: false }
+  };
+}
+var ForgetTool = class extends import_sdk6.ToolContext {
+  async execute(input) {
+    const remember = this.get(RememberAccessorToken);
+    const config = this.get(RememberConfigToken);
+    const scope = input.scope ?? "session";
+    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
+    if (!allowedScopes.includes(scope)) {
+      throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
+    }
+    const existed = await remember.knows(input.key, { scope });
+    await remember.forget(input.key, { scope });
+    return {
+      success: true,
+      key: input.key,
+      scope,
+      existed
+    };
+  }
+};
+ForgetTool = __decorateClass([
+  (0, import_sdk6.Tool)(forgetToolMetadata())
+], ForgetTool);
+
+// plugins/plugin-remember/src/tools/list-memories.tool.ts
+var import_lazy_zod3 = require("@frontmcp/lazy-zod");
+var import_sdk7 = require("@frontmcp/sdk");
+var listMemoriesInputSchema = {
+  scope: import_lazy_zod3.z.enum(["session", "user", "tool", "global"]).optional().describe(REMEMBER_SCOPE_DESCRIPTION),
+  pattern: import_lazy_zod3.z.string().optional().describe('Pattern to filter keys (e.g., "user_*")'),
+  limit: import_lazy_zod3.z.number().positive().max(100).optional().describe("Maximum number of keys to return (default: 50)")
+};
+var listMemoriesOutputSchema = import_lazy_zod3.z.object({
+  keys: import_lazy_zod3.z.array(import_lazy_zod3.z.string()),
+  scope: import_lazy_zod3.z.string(),
+  count: import_lazy_zod3.z.number(),
+  truncated: import_lazy_zod3.z.boolean()
+});
+function listMemoriesDescription(names = rememberToolNames()) {
+  return `List the remembered keys in one scope (default: session). Use this to see what memories are stored before you ${names.recall} or ${names.forget} one.`;
+}
+function listMemoriesToolMetadata(names = rememberToolNames()) {
+  return {
+    name: names.listMemories,
+    description: listMemoriesDescription(names),
+    inputSchema: listMemoriesInputSchema,
+    outputSchema: listMemoriesOutputSchema,
+    annotations: { readOnlyHint: true }
+  };
+}
+var ListMemoriesTool = class extends import_sdk7.ToolContext {
+  async execute(input) {
+    const remember = this.get(RememberAccessorToken);
+    const config = this.get(RememberConfigToken);
+    const scope = input.scope ?? "session";
+    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
+    if (!allowedScopes.includes(scope)) {
+      throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
+    }
+    const limit = input.limit ?? 50;
+    let keys = await remember.list({ scope, pattern: input.pattern });
+    const truncated = keys.length > limit;
+    if (truncated) {
+      keys = keys.slice(0, limit);
+    }
+    return {
+      keys,
+      scope,
+      count: keys.length,
+      truncated
+    };
+  }
+};
+ListMemoriesTool = __decorateClass([
+  (0, import_sdk7.Tool)(listMemoriesToolMetadata())
+], ListMemoriesTool);
+
+// plugins/plugin-remember/src/tools/recall.tool.ts
+var import_lazy_zod4 = require("@frontmcp/lazy-zod");
+var import_sdk8 = require("@frontmcp/sdk");
+var recallInputSchema = {
+  key: import_lazy_zod4.z.string().min(1).describe("What memory to recall"),
+  scope: import_lazy_zod4.z.enum(["session", "user", "tool", "global"]).optional().describe(REMEMBER_SCOPE_DESCRIPTION)
+};
+var recallOutputSchema = import_lazy_zod4.z.object({
+  found: import_lazy_zod4.z.boolean(),
+  key: import_lazy_zod4.z.string(),
+  value: import_lazy_zod4.z.unknown().optional(),
+  scope: import_lazy_zod4.z.string(),
+  createdAt: import_lazy_zod4.z.number().optional(),
+  expiresAt: import_lazy_zod4.z.number().optional()
+});
+function recallDescription(names = rememberToolNames()) {
+  return `Recall something that was previously remembered. Use this to retrieve stored preferences, settings, or any information that was saved with ${names.rememberThis}.`;
+}
+function recallToolMetadata(names = rememberToolNames()) {
+  return {
+    name: names.recall,
+    description: recallDescription(names),
+    inputSchema: recallInputSchema,
+    outputSchema: recallOutputSchema,
+    annotations: { readOnlyHint: true }
+  };
+}
+var RecallTool = class extends import_sdk8.ToolContext {
+  async execute(input) {
+    const remember = this.get(RememberAccessorToken);
+    const config = this.get(RememberConfigToken);
+    const scope = input.scope ?? "session";
+    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
+    if (!allowedScopes.includes(scope)) {
+      throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
+    }
+    const entry = await remember.getEntry(input.key, { scope });
+    if (!entry) {
+      return {
+        found: false,
+        key: input.key,
+        scope
+      };
+    }
+    return {
+      found: true,
+      key: input.key,
+      value: entry.value,
+      scope,
+      createdAt: entry.createdAt,
+      expiresAt: entry.expiresAt
+    };
+  }
+};
+RecallTool = __decorateClass([
+  (0, import_sdk8.Tool)(recallToolMetadata())
+], RecallTool);
+
+// plugins/plugin-remember/src/tools/remember-this.tool.ts
+var import_lazy_zod5 = require("@frontmcp/lazy-zod");
+var import_sdk9 = require("@frontmcp/sdk");
+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"),
+  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({
+  success: import_lazy_zod5.z.boolean(),
+  key: import_lazy_zod5.z.string(),
+  scope: import_lazy_zod5.z.string(),
+  expiresAt: import_lazy_zod5.z.number().optional()
+});
+function rememberThisDescription(names = rememberToolNames()) {
+  return `Remember something for later: store a value under a key that ${names.recall} can read back, in the scope you choose (this session by default; user scope for the signed-in user across sessions). It lasts until it is forgotten or its ttl runs out. Use this when the user asks you to remember preferences, settings, or any information they want to persist.`;
+}
+function rememberThisToolMetadata(names = rememberToolNames()) {
+  return {
+    name: names.rememberThis,
+    description: rememberThisDescription(names),
+    inputSchema: rememberThisInputSchema,
+    outputSchema: rememberThisOutputSchema,
+    annotations: { readOnlyHint: false }
+  };
+}
+var RememberThisTool = class extends import_sdk9.ToolContext {
+  async execute(input) {
+    const remember = this.get(RememberAccessorToken);
+    const config = this.get(RememberConfigToken);
+    const scope = input.scope ?? "session";
+    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
+    if (!allowedScopes.includes(scope)) {
+      throw this.fail(new RememberScopeNotAllowedError(scope, allowedScopes));
+    }
+    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
+    };
+  }
+};
+RememberThisTool = __decorateClass([
+  (0, import_sdk9.Tool)(rememberThisToolMetadata())
+], RememberThisTool);
+
+// plugins/plugin-remember/src/tools/remember-tools.factory.ts
+function createRememberTools(prefix = "") {
+  if (!prefix) return [RememberThisTool, RecallTool, ForgetTool, ListMemoriesTool];
+  const names = rememberToolNames(prefix);
+  let PrefixedRememberThisTool = class extends RememberThisTool {
+  };
+  PrefixedRememberThisTool = __decorateClass([
+    (0, import_sdk10.Tool)(rememberThisToolMetadata(names))
+  ], PrefixedRememberThisTool);
+  let PrefixedRecallTool = class extends RecallTool {
+  };
+  PrefixedRecallTool = __decorateClass([
+    (0, import_sdk10.Tool)(recallToolMetadata(names))
+  ], PrefixedRecallTool);
+  let PrefixedForgetTool = class extends ForgetTool {
+  };
+  PrefixedForgetTool = __decorateClass([
+    (0, import_sdk10.Tool)(forgetToolMetadata(names))
+  ], PrefixedForgetTool);
+  let PrefixedListMemoriesTool = class extends ListMemoriesTool {
+  };
+  PrefixedListMemoriesTool = __decorateClass([
+    (0, import_sdk10.Tool)(listMemoriesToolMetadata(names))
+  ], PrefixedListMemoriesTool);
+  return [PrefixedRememberThisTool, PrefixedRecallTool, PrefixedForgetTool, PrefixedListMemoriesTool];
+}
+
 // plugins/plugin-remember/src/remember.plugin.ts
-var RememberPlugin = class extends import_sdk5.DynamicPlugin {
+var RememberPlugin = class extends import_sdk11.DynamicPlugin {
   options;
   constructor(options = {}) {
     super();
@@ -1165,6 +1436,11 @@ __publicField(RememberPlugin, "defaultOptions", {
   keyPrefix: "remember:",
   encryption: { enabled: true }
 });
+/**
+ * The memory tools, when `tools.enabled` is set: `remember_this`, `recall`, `forget` and
+ * `list_memories`, under `tools.prefix`.
+ */
+__publicField(RememberPlugin, "dynamicTools", (options) => options.tools?.enabled ? createRememberTools(options.tools.prefix) : []);
 /**
  * Dynamic providers based on plugin options.
  */
@@ -1179,10 +1455,10 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
       providers.push({
         name: "remember:store:global",
         provide: RememberStoreToken,
-        inject: () => [import_sdk5.FrontMcpConfig],
+        inject: () => [import_sdk11.FrontMcpConfig],
         useFactory: (frontmcpConfig) => {
-          const storeConfig = (0, import_sdk5.getGlobalStoreConfig)("RememberPlugin", frontmcpConfig);
-          if ((0, import_sdk5.isVercelKvProvider)(storeConfig)) {
+          const storeConfig = (0, import_sdk11.getGlobalStoreConfig)("RememberPlugin", frontmcpConfig);
+          if ((0, import_sdk11.isVercelKvProvider)(storeConfig)) {
             return new RememberVercelKvProvider({
               url: storeConfig.url,
               token: storeConfig.token,
@@ -1249,7 +1525,9 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
       providers.push({
         name: "remember:store:memory",
         provide: RememberStoreToken,
-        useValue: new RememberMemoryProvider()
+        // Built per server: `init()` runs once, so a value here would be shared by every server using it.
+        inject: () => [],
+        useFactory: () => new RememberMemoryProvider()
       });
       break;
   }
@@ -1261,22 +1539,24 @@ __publicField(RememberPlugin, "dynamicProviders", (options) => {
   providers.push({
     name: "remember:accessor",
     provide: RememberAccessorToken,
-    scope: import_sdk5.ProviderScope.CONTEXT,
-    inject: () => [RememberStoreToken, import_sdk5.FRONTMCP_CONTEXT, RememberConfigToken, import_sdk5.FrontMcpLogger],
+    scope: import_sdk11.ProviderScope.CONTEXT,
+    inject: () => [RememberStoreToken, import_sdk11.FRONTMCP_CONTEXT, RememberConfigToken, import_sdk11.FrontMcpLogger],
     useFactory: (store, ctx, cfg, logger) => createRememberAccessor(store, ctx, cfg, logger)
   });
   return providers;
 });
 RememberPlugin = __decorateClass([
-  (0, import_sdk5.Plugin)({
+  (0, import_sdk11.Plugin)({
     name: "remember",
     description: "Help your LLM remember things across sessions",
     providers: [
-      // Default in-memory provider (overridden by dynamicProviders if configured)
+      // Default in-memory provider (overridden by dynamicProviders if configured). A factory, so each
+      // server gets its own store: a value built here is one store for every server in the process.
       {
         name: "remember:store:memory",
         provide: RememberStoreToken,
-        useValue: new RememberMemoryProvider()
+        inject: () => [],
+        useFactory: () => new RememberMemoryProvider()
       }
     ],
     // Context extensions - SDK handles runtime installation
@@ -1292,219 +1572,19 @@ RememberPlugin = __decorateClass([
 ], RememberPlugin);
 
 // plugins/plugin-remember/src/remember.types.ts
-var import_lazy_zod2 = require("@frontmcp/lazy-zod");
-var rememberScopeSchema = import_lazy_zod2.z.enum(["session", "user", "tool", "global"]);
+var import_lazy_zod6 = require("@frontmcp/lazy-zod");
+var rememberScopeSchema = import_lazy_zod6.z.enum(["session", "user", "tool", "global"]);
 function brand(data, _brand) {
   return data;
 }
-var rememberEntrySchema = import_lazy_zod2.z.object({
-  value: import_lazy_zod2.z.unknown(),
-  brand: import_lazy_zod2.z.enum(["approval", "preference", "cache", "state", "conversation", "custom"]).optional(),
-  createdAt: import_lazy_zod2.z.number(),
-  updatedAt: import_lazy_zod2.z.number(),
-  expiresAt: import_lazy_zod2.z.number().optional(),
-  metadata: import_lazy_zod2.z.record(import_lazy_zod2.z.string(), import_lazy_zod2.z.unknown()).optional()
-});
-
-// plugins/plugin-remember/src/tools/remember-this.tool.ts
-var import_lazy_zod3 = require("@frontmcp/lazy-zod");
-var import_sdk6 = require("@frontmcp/sdk");
-var rememberThisInputSchema = {
-  key: import_lazy_zod3.z.string().min(1).describe('What to call this memory (e.g., "user_preference", "last_action")'),
-  value: import_lazy_zod3.z.unknown().describe("The value to remember (any JSON-serializable data)"),
-  scope: import_lazy_zod3.z.enum(["session", "user", "tool", "global"]).optional().describe(
-    "How long to remember: session (until disconnect), user (forever), tool (for this tool), global (shared)"
-  ),
-  ttl: import_lazy_zod3.z.number().positive().optional().describe("Forget after this many seconds"),
-  brand: import_lazy_zod3.z.enum(["preference", "cache", "state", "conversation", "custom"]).optional().describe("Type hint for the stored value")
-};
-var rememberThisOutputSchema = import_lazy_zod3.z.object({
-  success: import_lazy_zod3.z.boolean(),
-  key: import_lazy_zod3.z.string(),
-  scope: import_lazy_zod3.z.string(),
-  expiresAt: import_lazy_zod3.z.number().optional()
-});
-var RememberThisTool = class extends import_sdk6.ToolContext {
-  async execute(input) {
-    const remember = this.get(RememberAccessorToken);
-    const config = this.get(RememberConfigToken);
-    const scope = input.scope ?? "session";
-    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
-    if (!allowedScopes.includes(scope)) {
-      throw this.fail(new Error(`Scope '${scope}' is not allowed. Allowed scopes: ${allowedScopes.join(", ")}`));
-    }
-    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
-    };
-  }
-};
-RememberThisTool = __decorateClass([
-  (0, import_sdk6.Tool)({
-    name: "remember_this",
-    description: "Remember something for later. Store a value that can be recalled in future conversations. Use this when the user asks you to remember preferences, settings, or any information they want to persist.",
-    inputSchema: rememberThisInputSchema,
-    outputSchema: rememberThisOutputSchema,
-    annotations: {
-      readOnlyHint: false
-    }
-  })
-], RememberThisTool);
-
-// plugins/plugin-remember/src/tools/recall.tool.ts
-var import_lazy_zod4 = require("@frontmcp/lazy-zod");
-var import_sdk7 = require("@frontmcp/sdk");
-var recallInputSchema = {
-  key: import_lazy_zod4.z.string().min(1).describe("What memory to recall"),
-  scope: import_lazy_zod4.z.enum(["session", "user", "tool", "global"]).optional().describe("Which scope to look in (default: session)")
-};
-var recallOutputSchema = import_lazy_zod4.z.object({
-  found: import_lazy_zod4.z.boolean(),
-  key: import_lazy_zod4.z.string(),
-  value: import_lazy_zod4.z.unknown().optional(),
-  scope: import_lazy_zod4.z.string(),
-  createdAt: import_lazy_zod4.z.number().optional(),
-  expiresAt: import_lazy_zod4.z.number().optional()
-});
-var RecallTool = class extends import_sdk7.ToolContext {
-  async execute(input) {
-    const remember = this.get(RememberAccessorToken);
-    const config = this.get(RememberConfigToken);
-    const scope = input.scope ?? "session";
-    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
-    if (!allowedScopes.includes(scope)) {
-      this.fail(new Error(`Scope '${scope}' is not allowed. Allowed scopes: ${allowedScopes.join(", ")}`));
-    }
-    const entry = await remember.getEntry(input.key, { scope });
-    if (!entry) {
-      return {
-        found: false,
-        key: input.key,
-        scope
-      };
-    }
-    return {
-      found: true,
-      key: input.key,
-      value: entry.value,
-      scope,
-      createdAt: entry.createdAt,
-      expiresAt: entry.expiresAt
-    };
-  }
-};
-RecallTool = __decorateClass([
-  (0, import_sdk7.Tool)({
-    name: "recall",
-    description: "Recall something that was previously remembered. Use this to retrieve stored preferences, settings, or any information that was saved with remember_this.",
-    inputSchema: recallInputSchema,
-    outputSchema: recallOutputSchema,
-    annotations: {
-      readOnlyHint: true
-    }
-  })
-], RecallTool);
-
-// plugins/plugin-remember/src/tools/forget.tool.ts
-var import_lazy_zod5 = require("@frontmcp/lazy-zod");
-var import_sdk8 = require("@frontmcp/sdk");
-var forgetInputSchema = {
-  key: import_lazy_zod5.z.string().min(1).describe("What memory to forget"),
-  scope: import_lazy_zod5.z.enum(["session", "user", "tool", "global"]).optional().describe("Which scope to forget from (default: session)")
-};
-var forgetOutputSchema = import_lazy_zod5.z.object({
-  success: import_lazy_zod5.z.boolean(),
-  key: import_lazy_zod5.z.string(),
-  scope: import_lazy_zod5.z.string(),
-  existed: import_lazy_zod5.z.boolean()
-});
-var ForgetTool = class extends import_sdk8.ToolContext {
-  async execute(input) {
-    const remember = this.get(RememberAccessorToken);
-    const config = this.get(RememberConfigToken);
-    const scope = input.scope ?? "session";
-    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
-    if (!allowedScopes.includes(scope)) {
-      throw this.fail(new Error(`Scope '${scope}' is not allowed. Allowed scopes: ${allowedScopes.join(", ")}`));
-    }
-    const existed = await remember.knows(input.key, { scope });
-    await remember.forget(input.key, { scope });
-    return {
-      success: true,
-      key: input.key,
-      scope,
-      existed
-    };
-  }
-};
-ForgetTool = __decorateClass([
-  (0, import_sdk8.Tool)({
-    name: "forget",
-    description: "Forget a previously remembered value. Use this when the user wants to delete stored preferences or information.",
-    inputSchema: forgetInputSchema,
-    outputSchema: forgetOutputSchema,
-    annotations: {
-      readOnlyHint: false
-    }
-  })
-], ForgetTool);
-
-// plugins/plugin-remember/src/tools/list-memories.tool.ts
-var import_lazy_zod6 = require("@frontmcp/lazy-zod");
-var import_sdk9 = require("@frontmcp/sdk");
-var listMemoriesInputSchema = {
-  scope: import_lazy_zod6.z.enum(["session", "user", "tool", "global"]).optional().describe("Which scope to list from (default: session)"),
-  pattern: import_lazy_zod6.z.string().optional().describe('Pattern to filter keys (e.g., "user_*")'),
-  limit: import_lazy_zod6.z.number().positive().max(100).optional().describe("Maximum number of keys to return (default: 50)")
-};
-var listMemoriesOutputSchema = import_lazy_zod6.z.object({
-  keys: import_lazy_zod6.z.array(import_lazy_zod6.z.string()),
-  scope: import_lazy_zod6.z.string(),
-  count: import_lazy_zod6.z.number(),
-  truncated: import_lazy_zod6.z.boolean()
+var rememberEntrySchema = import_lazy_zod6.z.object({
+  value: import_lazy_zod6.z.unknown(),
+  brand: import_lazy_zod6.z.enum(["approval", "preference", "cache", "state", "conversation", "custom"]).optional(),
+  createdAt: import_lazy_zod6.z.number(),
+  updatedAt: import_lazy_zod6.z.number(),
+  expiresAt: import_lazy_zod6.z.number().optional(),
+  metadata: import_lazy_zod6.z.record(import_lazy_zod6.z.string(), import_lazy_zod6.z.unknown()).optional()
 });
-var ListMemoriesTool = class extends import_sdk9.ToolContext {
-  async execute(input) {
-    const remember = this.get(RememberAccessorToken);
-    const config = this.get(RememberConfigToken);
-    const scope = input.scope ?? "session";
-    const allowedScopes = config.tools?.allowedScopes ?? ["session", "user", "tool", "global"];
-    if (!allowedScopes.includes(scope)) {
-      throw this.fail(new Error(`Scope '${scope}' is not allowed. Allowed scopes: ${allowedScopes.join(", ")}`));
-    }
-    const limit = input.limit ?? 50;
-    let keys = await remember.list({ scope, pattern: input.pattern });
-    const truncated = keys.length > limit;
-    if (truncated) {
-      keys = keys.slice(0, limit);
-    }
-    return {
-      keys,
-      scope,
-      count: keys.length,
-      truncated
-    };
-  }
-};
-ListMemoriesTool = __decorateClass([
-  (0, import_sdk9.Tool)({
-    name: "list_memories",
-    description: "List all remembered keys in a scope. Use this to see what memories are stored for the current session or user.",
-    inputSchema: listMemoriesInputSchema,
-    outputSchema: listMemoriesOutputSchema,
-    annotations: {
-      readOnlyHint: true
-    }
-  })
-], ListMemoriesTool);
 
 // plugins/plugin-remember/src/remember.context-extension.ts
 function getRemember(ctx) {
@@ -1528,6 +1608,7 @@ function tryGetRemember(ctx) {
   RememberMemoryProvider,
   RememberPlugin,
   RememberRedisProvider,
+  RememberScopeNotAllowedError,
   RememberStoreToken,
   RememberThisTool,
   RememberVercelKvProvider,