@frontmcp/plugin-remember 0.0.1 → 0.7.1

package/remember.crypto.d.ts

@@ -0,0 +1,81 @@
+import type { EncBlob } from '@frontmcp/utils';
+import type { RememberScope } from './remember.types';
+/**
+ * Encrypted blob structure for storage.
+ * Re-exports EncBlob from @frontmcp/utils for consistency.
+ */
+export type EncryptedBlob = EncBlob;
+/**
+ * Key derivation source configuration.
+ */
+export type EncryptionKeySource = {
+    type: 'session';
+    sessionId: string;
+} | {
+    type: 'user';
+    userId: string;
+} | {
+    type: 'tool';
+    toolName: string;
+    sessionId: string;
+} | {
+    type: 'global';
+} | {
+    type: 'custom';
+    key: string;
+};
+/**
+ * Derive a 256-bit encryption key based on the source.
+ * Uses HKDF-SHA256 from @frontmcp/utils.
+ *
+ * Key derivation strategy (distributed-safe):
+ * - session: IKM = sessionId (unique per session, no external dependency)
+ * - tool: IKM = sessionId (same as session, tool name in context)
+ * - user: IKM = baseSecret + userId (requires persisted/env secret)
+ * - global: IKM = baseSecret (requires persisted/env secret)
+ * - custom: IKM = custom key
+ */
+export declare function deriveEncryptionKey(source: EncryptionKeySource): Promise<Uint8Array>;
+/**
+ * Get the encryption key source based on scope and context.
+ */
+export declare function getKeySourceForScope(scope: RememberScope, context: {
+    sessionId: string;
+    userId?: string;
+    toolName?: string;
+}): EncryptionKeySource;
+/**
+ * Encrypt a value using AES-256-GCM.
+ * Uses @frontmcp/utils crypto for cross-platform support.
+ *
+ * @param data - Value to encrypt (will be JSON serialized)
+ * @param keySource - Key derivation source
+ * @returns Encrypted blob
+ */
+export declare function encryptValue(data: unknown, keySource: EncryptionKeySource): Promise<EncryptedBlob>;
+/**
+ * Decrypt an encrypted blob.
+ * Uses @frontmcp/utils crypto for cross-platform support.
+ *
+ * @param blob - Encrypted blob to decrypt
+ * @param keySource - Key derivation source (must match encryption)
+ * @returns Decrypted and parsed value, or null if decryption fails
+ */
+export declare function decryptValue<T = unknown>(blob: EncryptedBlob, keySource: EncryptionKeySource): Promise<T | null>;
+/**
+ * Serialize encrypted blob to a string for storage.
+ */
+export declare function serializeBlob(blob: EncryptedBlob): string;
+/**
+ * Deserialize a string back to encrypted blob.
+ */
+export declare function deserializeBlob(str: string): EncryptedBlob | null;
+/**
+ * Convenience function to encrypt and serialize in one step.
+ */
+export declare function encryptAndSerialize(data: unknown, keySource: EncryptionKeySource): Promise<string>;
+/**
+ * Convenience function to deserialize and decrypt in one step.
+ */
+export declare function deserializeAndDecrypt<T = unknown>(str: string, keySource: EncryptionKeySource): Promise<T | null>;
+//# sourceMappingURL=remember.crypto.d.ts.map

package/remember.crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.crypto.d.ts","sourceRoot":"","sources":["../src/remember.crypto.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOtD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AA4BpC;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0C1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,mBAAmB,CAerB;AASD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAaxG;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAcnB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAiBjE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EACrD,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAInB"}

package/remember.plugin.d.ts

@@ -0,0 +1,41 @@
+import { DynamicPlugin, ProviderType } from '@frontmcp/sdk';
+import type { RememberPluginOptions, RememberPluginOptionsInput } from './remember.types';
+/**
+ * RememberPlugin - Stateful session memory for FrontMCP.
+ *
+ * Provides encrypted, session-scoped storage with human-friendly API.
+ * Enables LLMs and tools to "remember" things across sessions.
+ *
+ * @example
+ * ```typescript
+ * // Basic in-memory setup
+ * @FrontMcp({
+ *   plugins: [
+ *     RememberPlugin.init({ type: 'memory' }),
+ *   ],
+ * })
+ * class MyServer {}
+ *
+ * // With Redis and LLM tools
+ * @FrontMcp({
+ *   redis: { host: 'localhost', port: 6379 },
+ *   plugins: [
+ *     RememberPlugin.init({
+ *       type: 'global-store',
+ *       tools: { enabled: true },
+ *     }),
+ *   ],
+ * })
+ * class ProductionServer {}
+ * ```
+ */
+export default class RememberPlugin extends DynamicPlugin<RememberPluginOptions, RememberPluginOptionsInput> {
+    static defaultOptions: RememberPluginOptions;
+    options: RememberPluginOptions;
+    constructor(options?: RememberPluginOptionsInput);
+    /**
+     * Dynamic providers based on plugin options.
+     */
+    static dynamicProviders: (options: RememberPluginOptionsInput) => ProviderType[];
+}
+//# sourceMappingURL=remember.plugin.d.ts.map

package/remember.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.plugin.d.ts","sourceRoot":"","sources":["../src/remember.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,YAAY,EAOb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAO1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAsBH,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;;OAEG;IACH,OAAgB,gBAAgB,GAAI,SAAS,0BAA0B,KAAG,YAAY,EAAE,CAyHtF;CACH"}

package/remember.secret-persistence.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Data structure for persisted remember secret.
+ */
+export interface RememberSecretData {
+    /** Random secret, base64url encoded (32 bytes = 256 bits) */
+    secret: string;
+    /** Creation timestamp (ms) */
+    createdAt: number;
+    /** Version for future migrations */
+    version: 1;
+}
+/**
+ * Options for secret persistence.
+ */
+export interface SecretPersistenceOptions {
+    /**
+     * Path to store the secret.
+     * @default '.frontmcp/remember-secret.json'
+     */
+    secretPath?: string;
+    /**
+     * Enable persistence in production (NOT RECOMMENDED for multi-server).
+     * In production, use REMEMBER_SECRET env var instead.
+     * @default false
+     */
+    forceEnable?: boolean;
+}
+/**
+ * Check if secret persistence is enabled based on environment and options.
+ */
+export declare function isSecretPersistenceEnabled(options?: SecretPersistenceOptions): boolean;
+/**
+ * Resolve the secret file path.
+ */
+export declare function resolveSecretPath(options?: SecretPersistenceOptions): string;
+/**
+ * Load persisted secret from file.
+ *
+ * @param options - Persistence options
+ * @returns The loaded secret data or null if not found/invalid
+ */
+export declare function loadRememberSecret(options?: SecretPersistenceOptions): Promise<RememberSecretData | null>;
+/**
+ * Save secret to file.
+ *
+ * Uses atomic write (temp file + rename) to prevent corruption.
+ * Sets file permissions to 0o600 (owner read/write only) for security.
+ *
+ * @param secretData - Secret data to persist
+ * @param options - Persistence options
+ * @returns true if save succeeded, false otherwise
+ */
+export declare function saveRememberSecret(secretData: RememberSecretData, options?: SecretPersistenceOptions): Promise<boolean>;
+/**
+ * Delete persisted secret.
+ *
+ * @param options - Persistence options
+ */
+export declare function deleteRememberSecret(options?: SecretPersistenceOptions): Promise<void>;
+/**
+ * Get or create a persisted secret.
+ *
+ * This is the main entry point for getting the base secret.
+ * It will:
+ * 1. Return cached secret if available
+ * 2. Load from file if exists
+ * 3. Generate new secret and persist it
+ *
+ * @param options - Persistence options
+ * @returns The secret string
+ */
+export declare function getOrCreatePersistedSecret(options?: SecretPersistenceOptions): Promise<string>;
+/**
+ * Clear the cached secret (for testing).
+ */
+export declare function clearCachedSecret(): void;
+//# sourceMappingURL=remember.secret-persistence.d.ts.map

package/remember.secret-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.secret-persistence.d.ts","sourceRoot":"","sources":["../src/remember.secret-persistence.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuDD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAUtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAU5E;AAMD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA8B/G;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5F;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCpG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/remember.symbols.d.ts

@@ -0,0 +1,28 @@
+import { Reference } from '@frontmcp/sdk';
+import type { RememberStoreInterface } from './providers/remember-store.interface';
+import type { RememberAccessor } from './providers/remember-accessor.provider';
+import type { RememberPluginOptions } from './remember.types';
+/**
+ * DI token for the underlying storage provider.
+ */
+export declare const RememberStoreToken: Reference<RememberStoreInterface>;
+/**
+ * DI token for the plugin configuration.
+ */
+export declare const RememberConfigToken: Reference<RememberPluginOptions>;
+/**
+ * DI token for the context-scoped RememberAccessor.
+ * Use this to access remember functionality in tools and agents.
+ *
+ * @example
+ * ```typescript
+ * class MyTool extends ToolContext {
+ *   async execute(input) {
+ *     const remember = this.get(RememberAccessorToken);
+ *     await remember.set('key', 'value');
+ *   }
+ * }
+ * ```
+ */
+export declare const RememberAccessorToken: Reference<RememberAccessor>;
+//# sourceMappingURL=remember.symbols.d.ts.map

package/remember.symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.symbols.d.ts","sourceRoot":"","sources":["../src/remember.symbols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,sBAAsB,CAE3B,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,qBAAqB,CAE5B,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC,gBAAgB,CAE9B,CAAC"}

package/remember.types.d.ts

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+import { Redis as RedisClient } from 'ioredis';
+/**
+ * Memory scope determines the visibility and lifetime of stored data.
+ */
+export type RememberScope = 'session' | 'user' | 'tool' | 'global';
+/**
+ * Zod schema for RememberScope validation.
+ */
+export declare const rememberScopeSchema: z.ZodEnum<{
+    session: "session";
+    user: "user";
+    tool: "tool";
+    global: "global";
+}>;
+/**
+ * Brand symbol for compile-time type discrimination.
+ */
+declare const PayloadBrand: unique symbol;
+/**
+ * Branded type for memory payloads.
+ * Provides compile-time safety for different payload purposes.
+ */
+export type BrandedPayload<T, Brand extends string> = T & {
+    readonly [PayloadBrand]: Brand;
+};
+/** Approval payload - Tool approval state */
+export type ApprovalPayload<T = unknown> = BrandedPayload<T, 'approval'>;
+/** Preference payload - User preferences */
+export type PreferencePayload<T = unknown> = BrandedPayload<T, 'preference'>;
+/** Cache payload - Cached data */
+export type CachePayload<T = unknown> = BrandedPayload<T, 'cache'>;
+/** State payload - Application state */
+export type StatePayload<T = unknown> = BrandedPayload<T, 'state'>;
+/** Conversation payload - Conversation history/context */
+export type ConversationPayload<T = unknown> = BrandedPayload<T, 'conversation'>;
+/** Custom payload - Developer-defined data */
+export type CustomPayload<T = unknown> = BrandedPayload<T, 'custom'>;
+/**
+ * Helper to create a branded payload at runtime.
+ * The brand is stored in metadata, not on the value itself.
+ */
+export declare function brand<T, B extends string>(data: T, _brand: B): BrandedPayload<T, B>;
+/**
+ * All supported payload brands.
+ */
+export type PayloadBrandType = 'approval' | 'preference' | 'cache' | 'state' | 'conversation' | 'custom';
+/**
+ * Stored entry with metadata.
+ */
+export interface RememberEntry<T = unknown> {
+    /** The stored value */
+    value: T;
+    /** Payload brand for type discrimination */
+    brand?: PayloadBrandType;
+    /** When the entry was created */
+    createdAt: number;
+    /** When the entry was last updated */
+    updatedAt: number;
+    /** When the entry expires (timestamp) */
+    expiresAt?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Zod schema for RememberEntry validation.
+ */
+export declare const rememberEntrySchema: z.ZodObject<{
+    value: z.ZodUnknown;
+    brand: z.ZodOptional<z.ZodEnum<{
+        approval: "approval";
+        preference: "preference";
+        cache: "cache";
+        state: "state";
+        conversation: "conversation";
+        custom: "custom";
+    }>>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Base options for all plugin configurations.
+ */
+export interface BaseRememberPluginOptions {
+    /** Default TTL in seconds for entries without explicit TTL */
+    defaultTTL?: number;
+    /** Key prefix for all storage keys */
+    keyPrefix?: string;
+    /** Encryption configuration */
+    encryption?: {
+        /** Whether encryption is enabled (default: true) */
+        enabled?: boolean;
+        /** Custom encryption key (overrides derived keys) */
+        customKey?: string;
+    };
+    /** LLM tools configuration */
+    tools?: {
+        /** Whether to expose tools to LLM (default: false) */
+        enabled?: boolean;
+        /** Restrict which scopes tools can access */
+        allowedScopes?: RememberScope[];
+        /** Tool name prefix (default: none) */
+        prefix?: string;
+    };
+}
+/**
+ * In-memory storage options.
+ */
+export interface MemoryRememberPluginOptions extends BaseRememberPluginOptions {
+    type: 'memory';
+}
+/**
+ * Redis storage options with connection config.
+ */
+export interface RedisRememberPluginOptions extends BaseRememberPluginOptions {
+    type: 'redis';
+    config: {
+        host: string;
+        port: number;
+        password?: string;
+        db?: number;
+    };
+}
+/**
+ * Redis storage options with existing client.
+ */
+export interface RedisClientRememberPluginOptions extends BaseRememberPluginOptions {
+    type: 'redis-client';
+    client: RedisClient;
+}
+/**
+ * Vercel KV storage options.
+ */
+export interface VercelKvRememberPluginOptions extends BaseRememberPluginOptions {
+    type: 'vercel-kv';
+    /** 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;
+}
+/**
+ * Global store configuration from @FrontMcp decorator.
+ * Uses the redis/vercel-kv config from main FrontMcp options.
+ */
+export interface GlobalStoreRememberPluginOptions extends BaseRememberPluginOptions {
+    type: 'global-store';
+}
+/**
+ * Union of all plugin options types.
+ */
+export type RememberPluginOptions = MemoryRememberPluginOptions | RedisRememberPluginOptions | RedisClientRememberPluginOptions | VercelKvRememberPluginOptions | GlobalStoreRememberPluginOptions;
+/**
+ * Input type for plugin initialization (allows partial options).
+ */
+export type RememberPluginOptionsInput = Partial<RememberPluginOptions> & {
+    type?: RememberPluginOptions['type'];
+};
+/**
+ * Options for the set() method.
+ */
+export interface RememberSetOptions {
+    /** Memory scope (default: 'session') */
+    scope?: RememberScope;
+    /** Time-to-live in seconds */
+    ttl?: number;
+    /** Payload brand for type discrimination */
+    brand?: PayloadBrandType;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for the get() method.
+ */
+export interface RememberGetOptions<T = unknown> {
+    /** Memory scope (default: 'session') */
+    scope?: RememberScope;
+    /** Default value if key doesn't exist */
+    defaultValue?: T;
+}
+/**
+ * Options for the forget() method.
+ */
+export interface RememberForgetOptions {
+    /** Memory scope (default: 'session') */
+    scope?: RememberScope;
+}
+/**
+ * Options for the knows() method.
+ */
+export interface RememberKnowsOptions {
+    /** Memory scope (default: 'session') */
+    scope?: RememberScope;
+}
+/**
+ * Options for the list() method.
+ */
+export interface RememberListOptions {
+    /** Memory scope (default: 'session') */
+    scope?: RememberScope;
+    /** Pattern to filter keys (glob-style) */
+    pattern?: string;
+}
+export {};
+//# sourceMappingURL=remember.types.d.ts.map

package/remember.types.d.ts.map

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

package/tools/forget.tool.d.ts

@@ -0,0 +1,32 @@
+import { ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+/**
+ * Input schema for the forget tool.
+ */
+export declare const forgetInputSchema: z.ZodObject<{
+    key: z.ZodString;
+    scope: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        user: "user";
+        tool: "tool";
+        global: "global";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Output schema for the forget tool.
+ */
+export declare const forgetOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    key: z.ZodString;
+    scope: z.ZodString;
+    existed: z.ZodBoolean;
+}, z.core.$strip>;
+export type ForgetInput = z.infer<typeof forgetInputSchema>;
+export type ForgetOutput = z.infer<typeof forgetOutputSchema>;
+/**
+ * Tool to forget a previously remembered value.
+ */
+export default class ForgetTool extends ToolContext {
+    execute(input: ForgetInput): Promise<ForgetOutput>;
+}
+//# sourceMappingURL=forget.tool.d.ts.map

package/tools/forget.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.tool.d.ts","sourceRoot":"","sources":["../../src/tools/forget.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;iBAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AAYH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IAC3C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAyBzD"}

package/tools/index.d.ts

@@ -0,0 +1,9 @@
+export { default as RememberThisTool } from './remember-this.tool';
+export { default as RecallTool } from './recall.tool';
+export { default as ForgetTool } from './forget.tool';
+export { default as ListMemoriesTool } from './list-memories.tool';
+export type { RememberThisInput, RememberThisOutput } from './remember-this.tool';
+export type { RecallInput, RecallOutput } from './recall.tool';
+export type { ForgetInput, ForgetOutput } from './forget.tool';
+export type { ListMemoriesInput, ListMemoriesOutput } from './list-memories.tool';
+//# sourceMappingURL=index.d.ts.map

package/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/tools/list-memories.tool.d.ts

@@ -0,0 +1,33 @@
+import { ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+/**
+ * Input schema for the list_memories tool.
+ */
+export declare const listMemoriesInputSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        user: "user";
+        tool: "tool";
+        global: "global";
+    }>>;
+    pattern: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Output schema for the list_memories tool.
+ */
+export declare const listMemoriesOutputSchema: z.ZodObject<{
+    keys: z.ZodArray<z.ZodString>;
+    scope: z.ZodString;
+    count: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type ListMemoriesInput = z.infer<typeof listMemoriesInputSchema>;
+export type ListMemoriesOutput = z.infer<typeof listMemoriesOutputSchema>;
+/**
+ * Tool to list all remembered keys in a scope.
+ */
+export default class ListMemoriesTool extends ToolContext {
+    execute(input: ListMemoriesInput): Promise<ListMemoriesOutput>;
+}
+//# sourceMappingURL=list-memories.tool.d.ts.map

package/tools/list-memories.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-memories.tool.d.ts","sourceRoot":"","sources":["../../src/tools/list-memories.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAOlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AAYH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACjD,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA8BrE"}

package/tools/recall.tool.d.ts

@@ -0,0 +1,38 @@
+import { ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+import type { RememberScope } from '../remember.types';
+/**
+ * Input schema for the recall tool.
+ */
+export declare const recallInputSchema: {
+    key: z.ZodString;
+    scope: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        user: "user";
+        tool: "tool";
+        global: "global";
+    }>>;
+};
+/**
+ * Output schema for the recall tool.
+ */
+export declare const recallOutputSchema: z.ZodObject<{
+    found: z.ZodBoolean;
+    key: z.ZodString;
+    value: z.ZodOptional<z.ZodUnknown>;
+    scope: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodNumber>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RecallInput = {
+    key: string;
+    scope?: RememberScope;
+};
+export type RecallOutput = z.infer<typeof recallOutputSchema>;
+/**
+ * Tool to recall a previously remembered value.
+ */
+export default class RecallTool extends ToolContext {
+    execute(input: RecallInput): Promise<RecallOutput>;
+}
+//# sourceMappingURL=recall.tool.d.ts.map

package/tools/recall.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.tool.d.ts","sourceRoot":"","sources":["../../src/tools/recall.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAG7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AAYH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IAC3C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAgCzD"}

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

@@ -0,0 +1,42 @@
+import { ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+/**
+ * Input schema for the remember_this tool.
+ */
+export declare const rememberThisInputSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    scope: z.ZodOptional<z.ZodEnum<{
+        session: "session";
+        user: "user";
+        tool: "tool";
+        global: "global";
+    }>>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    brand: z.ZodOptional<z.ZodEnum<{
+        preference: "preference";
+        cache: "cache";
+        state: "state";
+        conversation: "conversation";
+        custom: "custom";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Output schema for the remember_this tool.
+ */
+export declare const rememberThisOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    key: z.ZodString;
+    scope: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RememberThisInput = z.infer<typeof rememberThisInputSchema>;
+export type RememberThisOutput = z.infer<typeof rememberThisOutputSchema>;
+/**
+ * Tool to store a value in memory.
+ * Enables LLM to remember things for later use.
+ */
+export default class RememberThisTool extends ToolContext {
+    execute(input: RememberThisInput): Promise<RememberThisOutput>;
+}
+//# sourceMappingURL=remember-this.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remember-this.tool.d.ts","sourceRoot":"","sources":["../../src/tools/remember-this.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;iBAclC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AAYH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACjD,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2BrE"}